Mudanças entre as edições de "Cadastro de Moedas"

(→‎Índices)
Linha 1: Linha 1:
−
Cadastro das moedas e índices.
+
==='''Conceito'''===
  
−
===Campos===
+
Cadastro das moedas e índices utilizados pelo sistema, especialmente pelo módulo de '''Contratos''' para aplicar o reajuste/correção dos itens contratuais.
−
*'''Nome:''' Identificação da Moeda.
 
−
*'''Sigla:''' Sigla da Moeda.
 
  
−
===Índices===
+
==='''Cadastro de Moedas'''===
−
*'''Data:''' Data de início da validade do índice.
 
−
*'''Valor:''' Percentual do índice do indicador ou valor da moeda.
 
  
−
{| class="wikitable" style="width: 100%"
+
*'''Nome:''' Identificação da moeda ou índice.
−
|'''Exemplo de uso'''  
+
*'''Sigla:''' Sigla da moeda ou índice.
−
No módulo de contratos, as moedas são utilizadas para definir o indice de correção dos itens dos contratos, e no processo de reajuste o sistema utiliza os índices cadastrados junto a moeda para aplicar a correção.
+
*'''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.

Edição das 17h07min de 1 de setembro de 2026

Conceito

Cadastro das moedas e índices utilizados pelo sistema, especialmente pelo módulo de Contratos para aplicar o reajuste/correção dos itens contratuais.

Cadastro de Moedas

  • 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.

Disponível em "http://wiki.phsys.com.br/index.php?title=Cadastro_de_Moedas&oldid=7222"