Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: DSTFC-8998

Índice

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)
Informações

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.

Image AddedImage Removed

Totvs custom tabs box
tabsIncluir, AlterarEditar, Excluir, Visualizar, Copiar
ids01,02,03,04,05
Totvs custom tabs box items
defaultyes
referencia01

Ao clicar no botão Incluir será exibido o formulário para que o usuário digite as informações necessária para incluir o templatenecessá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.

Image Added

Image Added

Dica
titleAtualizaçã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

Totvs custom tabs box items
defaultno
referencia02

Clicar no botão ... que fica na ultima última coluna a à 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.

Totvs custom tabs box items
defaultno
referencia03

Clicar no botão ... que fica na ultima última coluna a à esquerda da tabela e selecionar a opção Excluir.

Verifique se é o template que deseja excluir e clique em Confirmar.

Totvs custom tabs box items
defaultno
referencia04

Clicar no botão ... que fica na ultima última coluna a à esquerda da tabela e selecionar a opção Visualizar.

Totvs custom tabs box items
defaultno
referencia05

Clicar no botão ... que fica na ultima última coluna a à esquerda da tabela e selecionar a opção Copiar.

03. TELA XXXXX

Outras Ações / Ações relacionadas

...

04. TELA XXXXX

Principais Campos e Parâmetros

...

05. TABELAS UTILIZADAS

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.


Aviso
titleImportante

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

Totvs custom tabs box
tabsExpressão ADVPL, Função de usuário
ids06,07
Totvs custom tabs box items
defaultyes
referencia06

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

Image Added

  • 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

Image Added

Exemplo 2 - Juros baseado 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 da parcela não é possível pré-determinar a taxa do índice em data futura.

Totvs custom tabs box
tabs1 - Criação de índice e template,2 - Inclusão do empréstimo,3 - Pagamento de parcela corrigida
ids1,2,3
Totvs custom tabs box items
defaultyes
referencia1

Image Added


Image Added

Totvs custom tabs box items
defaultno
referencia2

Image Added

Totvs custom tabs box items
defaultno
referencia3

Image Added

Totvs custom tabs box items
defaultno
referencia07

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)


Bloco de código
languagejava
themeMidnight
titleFunção utilizada no exemplo
linenumberstrue
collapsetrue
#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

Image Added

  • 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

Image Added


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.

Image Added


06. TABELAS UTILIZADAS

  • F7B - Cadastro de templates
  • F7C - Formulas
  • FIT - Índices Financeiros
  • FIU - Variação de Índices Financeiros
  • Cadastro de templates - F7B
  • Formulas - F7C