Árvore de páginas

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

  1. Inclusão do índice financeiro para o CDI
  2. 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 TipoDescrição
DIASCORRIDOSNuméricoQuantidade de dias corridos dentro do período de cálculo (Diferença entre data de cálculo e data de vencimento)
DIASUTEISNuméricoQuantidade de dias úteis dentro do período de cálculo (Diferença entre data de cálculo e data de vencimento)
VLRCORRIGIDONuméricoValor corrigido do contrato
VALORBASENuméricoValor base que está sendo utilizado no cálculo da fórmula
RECNONuméricoR_E_C_N_O_ do registro na tabela de aplicações e empréstimos (SEH)
VLRACUMUSEIArray

Valores acumulados dos movimentos SEI

Posição do arrayDescrição
1Acumulado do juros na moeda corrente (EI_TIPODOC = "JR" e EI_VALOR)
2Acumulado do Juros na moeda do Empréstimo (EI_TIPODOC == "JR" e EI_VLMOED2)
3Acumulado da Variação Cambial a Curto Prazo (EI_TIPODOC == "V2")
4

Acumulado da Variação Cambial a Longo Prazo (EI_TIPODOC == "V1")

5Acumulado da Variação Cambial dos Juros (EI_TIPODOC == "V3")
VLRACUMUSEHArray 

Valores acumulados no cadastro SEH

Posição do arrayDescrição
1

Acumulado do juros na moeda corrente  (EH_ACUJUR2)

2Acumulado do Juros na moeda do Empréstimo (EH_ACUJUR
3Acumulado da Variação Cambial a Curto Prazo (EH_ACUVCCP)
4Acumulado da Variação Cambial a Longo Prazo (EH_ACUVCLP)
5Acumulado da Variação Cambial dos Juros (EH_ACUVCJR)
DATACALCULODataData de cálculo 
DATACONTRATODataData 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)


Função utilizada no exemplo
#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