GF - Como Fazer - Importa Índices BACEN pelo Gerenciador de Processos

Como Fazer Finanças

Importa índices BACEN

Diariamente um cliente que trabalha com valores indexados, ou seja, moedas diferentes do real, precisa realizar o cadastro das cotações para cada uma das suas moedas. Isso pode ocorrer de duas formas:

1. Manualmente, indicando o índice para o dia;

2. Através da rotina de importação de índices.

Esta última já é figura como uma automação interessante, pois realiza o cadastramento de todos os índices utilizados simultaneamente, além de utilizar a fonte de dados mais confiável para tal (Banco Central do Brasil).

Com a ideia de agregar mais agilidade e hiperautomação a este processo, iremos adicionar a rotina Cadastro de Índices ao agendador de processos (Módulo BPM) para que esta seja executada automaticamente conforme agendamento sem que haja a necessidade de execução manual, e mantendo assim, o cadastro de índices sempre atualizado.

Configuração de Servidores - Importa índices BACEN

Deverão ser criados 2 servidores em BPM/Workflow/Parâmetros/Servidores conforme:

• Um servidor do tipo “Servidor de Tarefas” com as seguintes características:

• Nome sugestão: “MAQUINA LOCAL”
• Opção “padrão” desmarcada

• E por fim, precisa ser criado um servidor do tipo “Aplicação: CIGAM Magic Spaces (xpa/xpi)” com as seguintes característica:

• Nome sugestão: “BROKER (FINANC)”
• Endereço Servidor: "cigam-web8:13520/broker" para ambientes em SQL ou "cigam-web8:13530/broker" para ambientes Oracle.
• Tipo: MGRqISPI.dll

Inclusão no gerenciador de processos - Importa índices BACEN

Depois de criados os servidores, deve-se ir até BPM/Workflow/Movimentos/Gerenciador de processos para realizar o cadastro e parametrização do Importa Índices BACEN, conforme abaixo:

Clique em “Agendar Processo”:

• Insira em “Servidor de Tarefas” o código do servidor “Maquina Local”.
• Em “Servidor de Aplicação” informe o código do servidor “BROKER (FINANC).

No campo “Tarefa” tecle F5 e selecione a opção “IMPORTA ÍNDICES BACEN”:

Em seguida execute o F5 no campo “Parâmetros” para configurar a importação.

Detalhamento de campos Parâmetros - Importa índices BACEN

• Índices: informe aqui o(s) índice(s) previamente cadastrado(s) que deseja executar a importação BACEN, se mais de um índice for informado, utilize vírgula como separador. Exemplo: (USD,EUR).
• Dias defasagem: a execução desta rotina utiliza data inicial e final, deste modo, deve ser atendado o uso deste filtro em combinação com a recorrência dos agendamentos para que não haja lacunas de execução. O campo dias defasagem irá compor a geração do filtro de data inicial e final pelo sistema da seguinte forma:

• O filtro de data inicial será o resultado do cálculo de subtração do valor informado no campo "Dias Defasagem" em relação data em que é executado o agendamento.
• O filtro de data final para importação terá o valor fixo como a data de execução do agendamento;

Exemplo: um agendamento em que sua execução é no dia 05/06/2024 e possui Dias defasagem informado com 1, a rotina terá sua execução com o range de datas (data atual - Dias defasagem) a (data atual), resultando na importação das moedas no período entre 04/06/2024 a 05/06/2024.

• Sobrescrever cotações divergentes: esta opção marcada irá refletir na substituição do valor antigo (informado manualmente) pelo valor oficial do BACEN no cadastro de índices do CIGAM, conforme já ocorre hoje ao selecionar esta opção diretamente pela tela de cadastro de índices. Lançamentos já criados/liquidados com o valor antigo (manual) não serão atualizados no processo. Havendo necessidade desta atualização, ela deverá ser feita manualmente, inclusive, deve ser reconsiderada qualquer execução da rotina de variação cambial mensal que tenha sido rodada contemplando este período.

Recorrência - Importa índices BACEN

Após o preenchimento dos parâmetros informe o usuário de execução e programe a recorrência. Para programar a recorrência acesse a guia Recorrência, estarão presentes 5 opções de execução. De acordo com o formato informe o período que o agendamento deve ser executado e o início do intervalo de execução. Conforme os parâmetros de recorrência o sistema automaticamente definirá uma faixa de filtros de data inicial e final para cada execução.

Sugerimos que ao agendar esta tarefa seja levado em consideração o horário do fechamento das moedas utilizadas, estes horários variam entre 13h e 17h de cada dia útil. Para obter o valor do dia em que se está rodando a rotina, o seu agendamento deve ser feito um horário posterior ao fechamento do câmbio.

Funcionamento da rotina - Importa índices BACEN

Ao executar o agendamento as cotações para os índices serão importadas para o período conforme configuração dos parâmetros e recorrência. Podemos nos deparar com dois cenários de importação, a importação de índices comuns e a importação de índices PTAX, podemos informar ambos tipos de índice no mesmo agendamento porém para melhor entendimento iremos exemplificar as duas funcionalidades separadamente.

Importação de Índices

Nesse cenário nosso agendamento está com os seguintes parâmetros:

• Índices: USD,EUR;
• Dias defasagem: 1;
• Sobrescrever cotações divergentes: desmarcado.

Executaremos o agendamento após o horário de fechamento das moedas (entre 13h a 17h), o resultado será a importação das cotações USD e EUR para os dias de hoje e ontem, conforme o fechamento de cotações do BACEN.

Cotações USD importadas

Cotações EUR importadas

Importação de Índices PTAX

Nesse cenário nosso agendamento utilizará dois índices PTAX com os seguintes parâmetros:

• Índices: DLR_P,EUR_P;
• Dias defasagem: 1;
• Sobrescrever cotações divergentes: desmarcado.

O parâmetro que irá definir se o índice é PTAX é o checkbox "Índice PTAX" do cadastro de índices marcado.

O resultado da execução do agendamento será a importação dos índices PTAX "DLR_P" e "EUR_P" para os dias de hoje e ontem, porém com os valores das cotações anteriores. Exemplo: a cotação PTAX USD do dia 25/09/2024 utilizará os valores da cotação do dia 24/09/2024, enquanto a cotação do dia 24/09/2024 utilizará as cotações do dia 23/09/2024.

Observação: o PTAX sempre utilizará a cotação D-1, então se for realizada a importação em uma segunda-feira, o índice será importado com a cotação do último dia útil (sexta-feira).

Cotações DLR_P importadas

Cotações EUR_P importadas

Para mais informações sobre o processo de agendamento de índices PTAX, acesse a FAQ: Como incluir a importação de índice com cotação PTAX D-1 na importação automatizada do agendador de processos?.

Conferindo execuções do processo agendado - Importa índices BACEN

Podemos visualizar as execuções de processos de importação de índices de duas formas, a primeira é selecionando a guia "Histórico":

A segunda forma se trata de entrar no gerenciador de processos e clicar em “Logs de execução/ocorrencia”:

Sempre haverão dois registros de execução, um de início e um registro com o resultado da execução, ambos com chance de sucesso, erros ou advertências.

Possíveis erros e advertências - Importa índices BACEN

Advertências:

1. Algumas datas não possuem cotação disponível no site do Banco Central.

Resultado de execução:

Esta advertência é válida somente para índices comuns (campo "Índice PTAX" desmarcado), surge quando dentro do período de importação existem uma ou mais datas sem cotação liberada pelo Banco Central.

• Somente dias úteis terão cotação para a importação, avalie se dentro do período está sendo realizada a tentativa de consulta de sábados, domingos ou feriados.
• Quando o aviso é referente a data atual revise se o agendamento está sendo executado após o horário de fechamento da(s) moeda(s), variando entre 13h a 17h.

2. Alguns índices não possuem cotação disponível no site do Banco Central.

Resultado de execução:

Esta advertência surge quando um ou mais índices informados nos parâmetros não possuem código válido BACEN informado em seu cadastro, revise se o campo "Código" está informado corretamente.

3. Alguns índices não estão cadastrados no CIGAM.

Resultado de execução:

Esta advertência surge quando no campo "Índices" dos parâmetros do agendamento for informado com pelo menos um índice que não foi encontrado no CIGAM, revise o campo índice ou cadastre a moeda conforme Cadastro Índices e Cotações.

4. Com cotações divergentes e mantidas.

Resultado de execução:

Esta advertência surge quando o sistema encontra cotações cadastradas para os índices no período de execução que sejam divergentes das cotações do BACEN e o parâmetro "Sobrescrever cotações divergentes" dos parâmetros do agendamento estiver desmarcado, assim não sobrescrevendo cotações com os valores do Banco Central e mantendo os valores cadastrados manualmente.

Erros:

1. Nenhum índice foi informado no parâmetro de Lista de Índices.

Resultado da execução:

Revise o cadastro dos parâmetros do agendamento e informe pelo menos um índice no campo "Índices".

Documentos Relacionados

• GF - Como Fazer - Cadastro Índices e Cotações
• Como incluir a importação de índice com cotação PTAX D-1 na importação automatizada do agendador de processos?
• WF Gerenciador de Processos