Cadastro de Moedas

Conceito

Cadastro responsável por manter as moedas e índices de correção utilizados nos processos do sistema, permitindo o registro e o histórico de suas respectivas cotações e valores.

Essas informações são utilizadas principalmente no módulo de Contratos, servindo como base para o cálculo de reajustes e correções dos valores dos itens contratuais.

Cadastro de Moeda

• Nome: Identificação da moeda ou índice.
• Sigla: Sigla da moeda ou índice.
• Tipo: Classifica a moeda/índice, definindo a fonte e a rotina de consulta automática que será utilizada. Valores possíveis:
  • Dólar: Cotação obtida via PTAX/Banco Central (BCB).
  • IGPM: Índice obtido via API do Banco Central.
  • INPC: Índice obtido via API do Banco Central.

Índices

Para cada moeda/índice é mantido um histórico de valores:

• Data: Data de início de vigência do índice.
• Valor: Percentual do índice ou cotação da moeda naquela data.

Opções

• Consultar: Realiza a consulta dos valores das moedas e índices conforme o Tipo configurado em cada cadastro. O sistema identifica a rotina de consulta correspondente, realiza a busca na fonte configurada e grava os valores encontrados automaticamente no histórico de índices da respectiva moeda.
  • Para moedas do tipo Dólar, é realizada a consulta da cotação PTAX disponibilizada pelo Banco Central.
  • Para os tipos IGPM e INPC, os índices são consultados através da API do Banco Central.

• Agendamento de Consulta: Permite criar um agendamento para que a consulta das moedas e índices seja realizada automaticamente pelo sistema.
  • Ao utilizar a opção, é criado um registro do tipo Script na rotina de Agendamentos do sistema.
  • O agendamento é configurado para execução diária às 16h.
  • Durante a execução, o sistema realiza a consulta de todas as moedas cadastradas de acordo com o respectivo Tipo.
  • Para moedas do tipo Dólar, é realizada a consulta da cotação PTAX disponibilizada pelo Banco Central.
  • Para os tipos IGPM e INPC, os índices são consultados através da API do Banco Central.
  • Os valores retornados são gravados automaticamente no histórico de índices da moeda correspondente.
  • Não é permitida a criação de agendamentos duplicados. Caso já exista um agendamento ativo para a consulta dos índices de moedas, o sistema informa essa condição e impede a criação de um novo.

Exemplo

No módulo de Contratos, as moedas são utilizadas para definir o índice de correção dos itens dos contratos. No processo de reajuste, o sistema utiliza os índices cadastrados junto à moeda — inseridos manualmente ou obtidos através das opções de consulta — para aplicar a correção.

Conclusão

O cadastro de Moedas permite centralizar e manter o histórico das cotações e índices utilizados pelo sistema, possibilitando sua utilização em processos como o reajuste dos itens de contratos.

As informações podem ser cadastradas manualmente, consultadas diretamente através da opção Consultar ou atualizadas automaticamente através do Agendamento de Consulta, mantendo os índices necessários para os processos de correção e reajuste atualizados no sistema.