Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Í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 calculo ou seguir o calculo 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
titleInformações!

O campo F7B_APLEMP ira 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.




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ária para incluir o template


No exemplo a seguir vamos incluir um template com calculo de CDI, vale ressaltar que esta sendo utilizado o cadastro de índices financeiros (FIT). (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

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

Totvs custom tabs box items
defaultno
referencia02

Clicar no botão ... que fica na ultima coluna a esquerda da tabela e selecionar a opção Editar

Na edição é possível alterar a descrição, alterar as formulas, excluir e incluir uma nova formula no template

Totvs custom tabs box items
defaultno
referencia03

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

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

Totvs custom tabs box items
defaultno
referencia04

Clicar no botão ... que fica na ultima 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 coluna a esquerda da tabela e selecionar a opção Copiar

A copia ira trazer as formulas existentes no template de partida e devera conter um novo código ainda não utilizado


03. FÓRMULAS

Os templates obrigatoriamente devem ter pelo menos uma formula amarrada ao seu cadastro para que o sistema realize o calculo devido no momento do resgate de uma aplicação ou pagamento de um empréstimo.

As configurações de uma formula 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 formula em questão.


Aviso
titleImportante

Após a gravação do template, as configurações para cada formula 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 formulas personalizadas para que atendam sua necessidade especifica de calculo, 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 calculo (Diferença entre data de calculo e data de vencimento)
DIASUTEISNuméricoQuantidade de dias uteis dentro do período de calculo (Diferença entre data de calculo e data de vencimento)
VLRCORRIGIDONuméricoValor corrigido do contrato
VALORBASENuméricoValor base que esta sendo utilizado no calculo da formula
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 calculo 
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

No exemplo a seguir vamos incluir um template com calculo 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

Totvs custom tabs box items
defaultno
referencia07

No exemplo a seguir vamos incluir um template com calculo de 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. TABELAS UTILIZADAS

  • F7B - Cadastro de templates
  • F7C - Formulas