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.
|
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.
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 | Posição do array | Descrição |
|---|
| 1 | Acumulado do juros na moeda corrente (EI_TIPODOC = "JR" e EI_VALOR) | | 2 | Acumulado do Juros na moeda do Empréstimo (EI_TIPODOC == "JR" e EI_VLMOED2) | | 3 | Acumulado da Variação Cambial a Curto Prazo (EI_TIPODOC == "V2") | | 4 | Acumulado da Variação Cambial a Longo Prazo (EI_TIPODOC == "V1") | | 5 | Acumulado da Variação Cambial dos Juros (EI_TIPODOC == "V3") |
|
| VLRACUMUSEH | Array | Valores acumulados no cadastro SEH | Posição do array | Descrição |
|---|
| 1 | Acumulado do juros na moeda corrente (EH_ACUJUR2) | | 2 | Acumulado do Juros na moeda do Empréstimo (EH_ACUJUR) | | 3 | Acumulado da Variação Cambial a Curto Prazo (EH_ACUVCCP) | | 4 | Acumulado da Variação Cambial a Longo Prazo (EH_ACUVCLP) | | 5 | Acumulado da Variação Cambial dos Juros (EH_ACUVCJR) |
|
| DATACALCULO | Data | Data de cálculo |
| DATACONTRATO | Data | Data de inclusão do contrato (SEH) |
EXEMPLOS
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
|
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)
#include "rwmake.ch"
#include "protheus.ch"
#INCLUDE "TBICONN.CH"
USER FUNCTION MYJUROS()
Local nJuros As Numeric
nJuros := VALORBASE * 0.01
RETURN nJuros |
- 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