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 |
---|
|
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. |
![](/download/attachments/684987121/image2022-7-5_8-36-11.png?version=1&modificationDate=1657020971717&api=v2)
Totvs custom tabs box |
---|
tabs | Incluir, Editar, Excluir, Visualizar, Copiar |
---|
ids | 01,02,03,04,05 |
---|
|
Totvs custom tabs box items |
---|
| 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
![](/download/attachments/684987121/image2022-7-5_9-14-42.png?version=1&modificationDate=1657023283357&api=v2)
- 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.
![](/download/attachments/684987121/Gravar-_60.gif?version=1&modificationDate=1657023611240&api=v2)
|
Totvs custom tabs box items |
---|
| 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 ![](/download/attachments/684987121/Gravar-_61.gif?version=1&modificationDate=1657671448800&api=v2)
|
Totvs custom tabs box items |
---|
| 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 |
---|
| Clicar no botão ... que fica na ultima coluna a esquerda da tabela e selecionar a opção Visualizar |
Totvs custom tabs box items |
---|
| 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 ![](/download/attachments/684987121/Gravar-_62.gif?version=1&modificationDate=1657671744880&api=v2)
|
|
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.
![](/download/attachments/684987121/Gravar-_59.gif?version=1&modificationDate=1657022228770&api=v2)
Aviso |
---|
|
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 | Tipo | Descrição |
---|
DIASCORRIDOS | Numérico | Quantidade de dias corridos dentro do período de calculo (Diferença entre data de calculo e data de vencimento) |
DIASUTEIS | Numérico | Quantidade de dias uteis dentro do período de calculo (Diferença entre data de calculo e data de vencimento) |
VLRCORRIGIDO | Numérico | Valor corrigido do contrato |
VALORBASE | Numérico | Valor base que esta sendo utilizado no calculo da formula |
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 calculo |
DATACONTRATO | Data | Data de inclusão do contrato (SEH) |
EXEMPLOS
Totvs custom tabs box |
---|
tabs | Expressão ADVPL, Função de usuário |
---|
ids | 06,07 |
---|
|
Totvs custom tabs box items |
---|
| 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
![](/download/attachments/684987121/Gravar-_70.gif?version=1&modificationDate=1659726364087&api=v2)
- 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
![](/download/attachments/684987121/Gravar-_71.gif?version=1&modificationDate=1659726998770&api=v2)
|
Totvs custom tabs box items |
---|
| 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 |
---|
language | java |
---|
theme | Midnight |
---|
title | Função utilizada no exemplo |
---|
linenumbers | true |
---|
collapse | true |
---|
| #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
![](/download/attachments/684987121/Gravar-_72.gif?version=1&modificationDate=1659727323810&api=v2)
- 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
![](/download/attachments/684987121/Gravar-_71.gif?version=1&modificationDate=1659726998770&api=v2)
|
|
05. TABELAS UTILIZADAS
- F7B - Cadastro de templates
- F7C - Formulas