Antes de começar, veja a página "
Introdução" para os pré-requisitos gerais do sistema e o passo a passo de login. Em caso de dúvidas, consulte também o
FAQ.
Um Câmbio é a taxa de conversão de uma moeda estrangeira para Real, cadastrada uma única vez por moeda — não existe histórico por período, só um valor "corrente". É esse catálogo que um convênio em moeda estrangeira usa como origem ao vincular um câmbio a si (fora do escopo desta página; veja Configurações de Câmbio).
- Acesse Administração no menu lateral e clique em "Câmbios".

-
Na listagem, clique em "Inserir câmbio".
-
Preencha Moeda, Valor (até 10 casas decimais) e Descrição (todos Campo Obrigatório) e, opcionalmente, o Identificador Integração. O campo Ativo já vem marcado. Clique em "Salvar".

Obs: não pode existir mais de um câmbio cadastrado para a mesma moeda — nesse momento a checagem considera até câmbios já Inativos daquela moeda.
Obs: o Valor do câmbio deve ser maior que zero, ter no máximo 10 casas decimais e não pode ser superior a 99.999,9999999999. Valores fora desses limites são recusados (não são arredondados), com as mensagens "O câmbio deve ser maior que zero.", "O câmbio deve ter no máximo 10 casas decimais." ou "O câmbio não pode ser superior a 99.999,9999999999." A listagem exibe o valor de 2 a 10 casas decimais, conforme o que foi cadastrado.
- Na listagem, clique no ícone de lápis para editar Moeda, Valor, Descrição, Identificador Integração ou Ativo.

Obs: ao editar, a checagem de moeda duplicada considera só outros câmbios Ativos — diferente da inserção, que considera todos.
- Use o toggle da listagem para ativar/desativar o câmbio, ou o ícone de lixeira para excluí-lo.

Obs: um câmbio não pode ser excluído se estiver vinculado a algum convênio.
| Regra | Descrição |
| RN19.1 | Não pode existir mais de um câmbio cadastrado para a mesma moeda — a checagem de inserção ignora o campo Ativo (mesmo um câmbio inativo daquela moeda bloqueia um novo). |
| RN19.2 | Ao atualizar um câmbio, a checagem de moeda duplicada só considera outros câmbios ativos — diferente da inserção. |
| RN19.3 | Um câmbio não pode ser excluído se estiver vinculado a algum convênio. |
| RN19.4 | O valor do câmbio deve ser maior que zero, ter no máximo 10 casas decimais e não pode ser superior a 99.999,9999999999. A tela e o backend aplicam os mesmos limites: valor fora deles é recusado, não arredondado. A listagem e os formulários exibem de 2 a 10 casas decimais. |
| Campo | Descrição |
| Sistema | Harpia (Gestão 360) |
| Versão | 1.5 |
| Data de Atualização | 2026-10-15 |
| Responsável | Amanda Galvão |
| Público-alvo | usuários administradores responsáveis pela configuração técnica do sistema |
| Objetivo | consultar, cadastrar, editar, ativar/desativar e excluir um Câmbio do catálogo global de taxas |
| Tipo | Documento de referência / treinamento |
| Versão | Data | Descrição da Alteração | Responsável pela Aprovação |
| 1.5 | 2026-10-15 | Adicionado o bloco "Veja Também" com links para os guias relacionados e o card correspondente no Sumário | Amanda Galvão |
| 1.4 | 2026-10-08 | Atualizado o limite do valor do câmbio (até 10 casas decimais, maior que zero e máximo de 99.999,9999999999) e a RN19.4, conforme a nova precisão de câmbio. | Amanda Galvão |
| 1.3 | 2026-10-05 | Ajustes no Design de Interface e Experiência do Usuário. | Amanda Galvão |
| 1.2 | 2026-09-24 | Corrigido o link do Sumário para "Regras de Negócio Relacionadas" (o anchor não deveria ter o prefixo "h-", pois o heading não começa com dígito) | Amanda Galvão |
| 1.1 | 2026-09-24 | Repetido o screenshot da listagem (cenário 1.1) no tópico 2 do cenário 1.3 | Amanda Galvão |
| 1.0 | 2026-09-23 | Versão inicial da documentação | Amanda Galvão |