Árvore de páginas

Versões comparadas

Chave

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

...

  • 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
titleInformaçõ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 RemovedImage Added

Totvs custom tabs box
tabsIncluir, Editar, 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á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

clique aqui).
  • Inclusão do índice financeiro para o CDI

Image Removed

  • Configurar o job do FINXTAXA para que a atualização desse índice seja automática e para que exista registros de movimentos desse índice (FIU)
  • Criar um template de CDI utilizando o índice previamente cadastrado.

Image Removed

Mais informações: Job atualização de taxas BACEN - FINXTAXA

Totvs custom tabs box items
defaultno
referencia02

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.

Image Removed

Totvs custom tabs box items
defaultno
referencia03

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.

Totvs custom tabs box items
defaultno
referencia04

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

Totvs custom tabs box items
defaultno
referencia05

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.Image Removed


03. FÓRMULAS

...

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.Image Removed


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 . Com base nessas configurações esse template poderá ser vinculado nos contratos de aplicações e empréstimos.

...

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)

...

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 RemovedImage 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 Removed

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

  • 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

...

titleAtenção

...

É possível durante o cadastro de um template, simular possíveis valores das formulas 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.

Image Removed

Image Removed

Para habilitar a opção de simular basta cadastrar ao menos uma fórmula ao template:.

Image Removed

Image RemovedAo clicar na opção "Simular" será exibido um tela para simulação de template contendo os seguintes campos:

Image Removed

  • Valor: Este campo determina a base do cálculo para as formulas 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 inicio início para os cálculos das formulasfórmulas, sendo equivalente à data de cadastrado do contrato.
  • Data Pagamento\Resgate: Este campo determina a data final para os cálculos das formulasfó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 RemovedImage Added


06. TABELAS UTILIZADAS

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