01. VISÃO GERAL
O cadastro de templates foi criado no intuito de flexibilizar os cálculos dos valores que contemplam uma aplicação ou um empréstimo, como por exemplo o CDI. Através desse novo cadastro o usuário poderá configurar seu próprio cálculo ou seguir o estabelecido no sistema.
02. EXEMPLO DE UTILIZAÇÃO
- Ao realizar o acesso ao Protheus, utilizando o ambiente Financeiro, deverá ser acessado o menu Atualizações → Aplicações e empréstimos
- Para acessar o cadastro de templates Botão Templates (localizado no canto superior direito)
O campo F7B_APLEMP irá determinar se aquele template é de APL (Aplicação) ou EMP (Empréstimo), se o usuário acessar o cadastro de template através da browse de aplicação o valor do campo será APL, se acessar através da browse de empréstimo o valor do campo será EMP.
Ao clicar no botão Incluir será exibido o formulário para que o usuário digite as informações necessárias para incluir o template.
No exemplo a seguir vamos incluir um template com cálculo de CDI, vale ressaltar que está sendo utilizado o cadastro de índices financeiros (FINA017, tabelas FIT/FIU).
- Inclusão do índice financeiro para o CDI
- Criar um template de CDI utilizando o índice previamente cadastrado.
Atualização automática dos índices
Para que a atualização das taxas do CDI ocorra de forma automática é necessário cadastrar o schedule do FINXTAXA. Mais informações: Job atualização de taxas BACEN - FINXTAXA
Clicar no botão ... que fica na última coluna à esquerda da tabela e selecionar a opção Editar.
Na edição é possível alterar a descrição, alterar as fórmulas, excluir e incluir uma nova fórmula no template.
Clicar no botão ... que fica na última coluna à esquerda da tabela e selecionar a opção Excluir.
Verifique se é o template que deseja excluir e clique em Confirmar.
Clicar no botão ... que fica na última coluna à esquerda da tabela e selecionar a opção Visualizar.
Clicar no botão ... que fica na última coluna à esquerda da tabela e selecionar a opção Copiar.
A cópia irá trazer as fórmulas existentes no template de partida e deverá conter um novo código ainda não utilizado.
03. FÓRMULAS
Os templates obrigatoriamente devem ter pelo menos uma fórmula amarrada ao seu cadastro para que o sistema realize o cálculo devido no momento do resgate de uma aplicação ou pagamento de um empréstimo.
As configurações de uma fórmula irão respeitar o campo Tipo (F7C_TIPO), para cada tipo escolhido haverá funções e campos específicos como demonstra a imagem a seguir.
Os campos que são mostrados na tela dinamicamente irão servir como parâmetro para os cálculos da fórmula em questão.
Importante
Após a gravação do template, as configurações para cada fórmula serão gravadas no campo F7C_CONFIG em formato JSON (JavaScript Object Notation). Com base nessas configurações esse template poderá ser vinculado nos contratos de aplicações e empréstimos.
04. FÓRMULAS PERSONALIZADAS
É possível que o usuário crie fórmulas personalizadas para que atenda sua necessidade específica de cálculo, para isso disponibilizamos um novo recurso no cadastro de template e algumas variáveis que podem ser acessadas durante o processamento.
VARIÁVEIS
Nome | Tipo | Descrição | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DIASCORRIDOS | Numérico | Quantidade de dias corridos dentro do período de cálculo (Diferença entre data de cálculo e data de vencimento) | ||||||||||||
DIASUTEIS | Numérico | Quantidade de dias úteis dentro do período de cálculo (Diferença entre data de cálculo e data de vencimento) | ||||||||||||
VLRCORRIGIDO | Numérico | Valor corrigido do contrato | ||||||||||||
VALORBASE | Numérico | Valor base que está sendo utilizado no cálculo da fórmula | ||||||||||||
RECNO | Numérico | R_E_C_N_O_ do registro na tabela de aplicações e empréstimos (SEH) | ||||||||||||
VLRACUMUSEI | Array | Valores acumulados dos movimentos SEI
| ||||||||||||
VLRACUMUSEH | Array | Valores acumulados no cadastro SEH
| ||||||||||||
DATACALCULO | Data | Data de cálculo | ||||||||||||
DATACONTRATO | Data | Data de inclusão do contrato (SEH) |
EXEMPLOS
Exemplo 1 - Juros personalizado
No exemplo a seguir vamos incluir um template com cálculo de personalizado de juros para empréstimo, utilizando uma expressão ADVPL (Verificar variáveis disponíveis)
- Criar um template de JUROS utilizando a configuração PERSONALIZADO.
- Neste exemplo vamos aplicar 1% ao mês de juros para as parcelas que serão geradas posteriormente
- Acessar a browse de Empréstimos e incluir um contrato utilizando o template previamente cadastrado
- Nesse cenário utilizaremos um empréstimo de R$100.000,00 utilizando a tabela PRICE e gerando 5 parcelas
Exemplo 2 - Juros com correção baseada em índice
Ao utilizar um índice financeiro para cálculo de juros no template, o valor calculado sobre o índice será aplicado no pagamento da parcela, e não na geração da parcela, tendo em vista que no momento da geração não é possível pré-determinar a taxa do índice em data futura. Vale ressaltar que para o correto funcionamento, é necessário o cadastro desses índices (diariamente) na tabela de Taxas dos Índices Financeiros (FIU).
Atualização automática dos índices
Para que a atualização do índice em questão ocorra de forma automática é necessário cadastrar o schedule do FINXTAXA. Mais informações: Job atualização de taxas BACEN - FINXTAXA
No exemplo a seguir vamos incluir um template com cálculo personalizado de juros para empréstimo, utilizando função de usuário (Verificar variáveis disponíveis)
- Criar um template de JUROS utilizando a configuração PERSONALIZADO.
- Neste exemplo vamos aplicar 1% ao mês de juros para as parcelas que serão geradas posteriormente
- Acessar a browse de Empréstimos e incluir um contrato utilizando o template previamente cadastrado
- Nesse cenário utilizaremos um empréstimo de R$100.000,00 utilizando a tabela PRICE e gerando 5 parcelas
05. SIMULAÇÃO
É possível durante o cadastro de um template, simular possíveis valores das fórmulas cadastradas. Para isso o usuário deverá selecionar um template, na opção "Simular", e na tela de simulação, preencher os dados necessários para os cálculos.
Para habilitar a opção de simular basta cadastrar ao menos uma fórmula ao template.
Ao clicar na opção "Simular" será exibido um tela para simulação de template contendo os seguintes campos:
- Valor: Este campo determina a base do cálculo para as fórmulas do template, o qual para os contratos seria equivalente ao valor de pagamento de um empréstimo ou ao valor de resgate de uma aplicação.
- Data Contrato: Este campo determina a data de início para os cálculos das fórmulas, sendo equivalente à data de cadastrado do contrato.
- Data Pagamento\Resgate: Este campo determina a data final para os cálculos das fórmulas, sendo equivalente à data de pagamento de um empréstimo ou data de resgate de uma aplicação.
Caso os campos estejam preenchidos, o sistema automaticamente realizará a simulação e exibirá em tela os valores calculados.
06. TABELAS UTILIZADAS
- F7B - Cadastro de templates
- F7C - Formulas
- FIT - Índices Financeiros
- FIU - Variação de Índices Financeiros