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.
Cada convênio pode ter suas próprias Configurações, que ajustam o comportamento do sistema especificamente para aquele convênio, sem afetar os demais:
Câmbios — a cotação de cada moeda estrangeira usada nos lançamentos e aplicações de recursos deste convênio.
Financeiros — parâmetros que sobrepõem, só para este convênio, regras globais definidas pela Administração (como o intervalo de geração das Prestações de Contas e o percentual mínimo de execução exigido do parceiro).
Obs: permissão de consulta a Câmbios ou a Financeiros habilita a aba "Configurações" a aparecer no menu, e cada ação de inserir, editar ou excluir tem sua própria permissão. O convênio não pode estar "Encerrado" para que qualquer alteração em Câmbios ou Financeiros seja permitida — nesse status, essas telas ficam somente para consulta.
A partir da tela inicial, acesse o convênio desejado e clique na aba "Configurações", no menu lateral — ela fica logo abaixo de "Dados Gerais".
Este cenário cobre a configuração das moedas estrangeiras usadas nos lançamentos e aplicações de recursos deste convênio específico.
Na aba "Configurações", a sub-aba "Câmbios" é exibida por padrão, com a lista de moedas já configuradas para o convênio.
Para adicionar uma nova moeda, clique em "Inserir Câmbio".
Selecione o Câmbio (Campo Obrigatório) — a lista mostra as moedas ativas no catálogo global do sistema, que não estejam já cadastradas para este convênio.
Confira o Valor (Campo Obrigatório, até 10 casas decimais) — a cotação vem preenchida automaticamente com o valor padrão do catálogo global assim que a moeda é escolhida, mas pode ser ajustada para refletir a cotação específica negociada neste convênio.
Clique em "Salvar".
A nova moeda passa a aparecer na listagem, já com situação "ATIVO".
Obs: o sistema não permite cadastrar a mesma moeda duas vezes para o mesmo convênio — a tentativa é recusada com a mensagem "O câmbio informado já existe para esse convênio."
Obs: a cotação cadastrada aqui é usada para preencher automaticamente o câmbio ao lançar uma Contrapartida ou uma Aplicação de Recurso naquela moeda, recalculando os valores em Reais. Se a moeda estiver desativada (ver abaixo), esse preenchimento automático não encontra correspondência e o cálculo assume cotação 1:1 — informe o câmbio manualmente nesse caso.
Obs: alterar a cotação aqui não recalcula lançamentos já registrados — o valor de câmbio fica congelado no lançamento no momento em que ele foi feito. A mudança só vale para lançamentos novos, feitos a partir daquele momento.
Além de inserir, a listagem oferece, por linha, os seguintes ícones de ação:
Editar (lápis) — ajusta a cotação de um câmbio já cadastrado.
Ativar / Desativar (interruptor) — liga ou desliga a moeda para uso nos lançamentos deste convênio, sem excluí-la.
Excluir (lixeira) — remove o câmbio do convênio, mediante confirmação: "Tem certeza que deseja excluir o câmbio?".
A tela de Configurações também tem uma sub-aba "Financeiros", ao lado de "Câmbios", destinada a parâmetros que sobrepõem, só para este convênio, regras globais definidas pela Administração.
Na aba "Configurações", clique na sub-aba "Financeiros".
Quando ativa, essa aba lista os parâmetros financeiros do convênio com Código, Descrição e Valor, com os ícones de ação Editar e Excluir por linha. Os parâmetros previstos controlam:
O intervalo de meses entre uma Prestação de Contas e a próxima, gerada automaticamente pelo sistema.
O número mínimo de meses que a última Prestação de Contas do convênio precisa cobrir — se ficar abaixo desse mínimo, ela é unida com a anterior.
O percentual mínimo de execução exigido da entidade parceira, usado para sinalizar no relatório de Despesas de Execução se a contrapartida planejada já foi suficientemente lançada.
No momento, porém, essa aba está inativa: o botão para inserir um novo parâmetro não é exibido em nenhum convênio, então a listagem sempre aparece vazia — nenhum convênio tem parâmetros financeiros cadastrados por aqui, e todos seguem as regras globais definidas pela Administração até que a funcionalidade seja ativada.
Um convênio não pode ter dois vínculos de câmbio para a mesma moeda — validado tanto na inserção quanto na atualização.
RN20.2
Ao inserir um vínculo de câmbio, o Convênio e o Câmbio são obrigatórios, mas o Valor pode ser enviado zerado sem bloqueio pela API — a obrigatoriedade de preencher a cotação nesse momento é garantida só pela tela (a API não exige valor maior que zero porque esse mesmo comando é usado na criação do convênio). Quando há um Valor, ele precisa ter no máximo 10 casas decimais e não pode ser superior a 99.999,9999999999.
RN20.3
Ao editar um vínculo de câmbio, o Câmbio referenciado precisa existir de fato, e o Valor passa a ser obrigatório (diferente da inserção): deve ser maior que zero, ter no máximo 10 casas decimais e não pode ser superior a 99.999,9999999999.
RN20.6
Um convênio pode ter múltiplos câmbios vinculados (várias moedas) simultaneamente — a restrição de unicidade vale só por moeda.
RN20.7
As ações de gestão de câmbio do convênio (inserir, editar, excluir, ativar) ficam ocultas quando o convênio está "Encerrado".
RN20.8
Só os câmbios "Ativos" do catálogo global aparecem como opção ao vincular um novo câmbio ao convênio — a API retorna todos, ativos e inativos.
RN20.9
Ao inserir um novo vínculo de câmbio, o campo Valor é pré-preenchido com a cotação atual do câmbio selecionado — só no momento da inserção, não na edição.
RN20.10
Ao calcular o câmbio usado numa Contrapartida ou Aplicação de Recurso: só é considerado válido o vínculo ativo da moeda selecionada; sem vínculo ativo, o cálculo assume cotação 1:1; a moeda Real (BRL) sempre força câmbio igual a 1.
RN25.1
O intervalo entre Prestações de Contas e o limiar de incorporação do período residual são parametrizáveis por convênio (sub-aba "Financeiros"), com valor global como padrão quando o convênio não tem um valor específico.
RN25.3
O percentual mínimo de execução da contrapartida do parceiro também é parametrizável por convênio nessa mesma sub-aba, com valor global como padrão.
RN47.4
O campo "Ativo" de um parâmetro financeiro do convênio é gravado mas não tem efeito prático hoje — marcar um parâmetro como inativo não impede que seu valor continue sendo aplicado.
RN47.5
O campo Valor de um parâmetro financeiro é texto livre de até 255 caracteres; apesar do formulário sugerir JSON, não há validação de formato/schema no backend — qualquer texto é aceito.
RN47.6
Ao editar um parâmetro financeiro, os campos Código e Descrição ficam sempre desabilitados — só o Valor é realmente editável na prática.
RN47.7
A exclusão de um parâmetro financeiro do convênio é física, sem checar uso prévio — assim que excluído, quem consumia aquele parâmetro por Código passa a usar o valor global (catálogo da Administração).
Removida a seção "Vídeo Explicativo" (seção e card do Sumário).
Amanda Galvão
1.11
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.10
2026-10-08
Atualizadas a precisão do Valor do câmbio (até 10 casas decimais) e as regras RN20.2 e RN20.3, conforme a nova precisão de câmbio.
Amanda Galvão
1.9
2026-10-06
Página renomeada de "Configurações" para "Configurações de Câmbio"; adicionada a seção "Vídeo Explicativo" com o vídeo da funcionalidade.
Amanda Galvão
1.8
2026-10-05
Ajustes no Design de Interface e Experiência do Usuário.
Amanda Galvão
1.7
2026-09-25
Removido o disclaimer antigo de proveniência das Regras de Negócio (RN01–RN08 oficial vs. inferidas), obsoleto desde a decisão de 2026-09-22 de não distinguir a origem das regras na página publicada
Amanda Galvão
1.6
2026-09-25
Adicionadas referências às regras de negócio RN20.2, RN20.3, RN20.8 e RN20.10
Amanda Galvão
1.5
2026-09-25
Sincronizadas as Regras de Negócio Relacionadas com o catálogo (RN47.5, RN47.6, RN47.7 adicionadas)
Amanda Galvão
1.4
2026-09-24
Adicionada a seção "Regras de Negócio Relacionadas" ao Sumário (estava presente na página, mas não linkada no Sumário)
Amanda Galvão
1.3
2026-09-21
Removidas as citações de "Fonte" (arquivo:linha) das Regras de Negócio Relacionadas
Amanda Galvão
1.2
2026-09-21
Adicionadas referências às regras de negócio (RN20, RN25, RN47)
Amanda Galvão
1.1
2026-09-18
Reescrita da seção da aba "Financeiro"
Amanda Galvão
1.0
2026-09-18
Versão inicial da documentação, desmembrada da página "Dados Gerais e Configurações"
Harpia (Gestão 360) — Guia de Usuário: 
Sumário
Cenário: Gerenciar os Câmbios do Convênio
Vídeo Explicativo
Regras de Negócio Relacionadas
Veja Também
Informações do Documento
Histórico de Versões