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 Added
Image Removed
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 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). - Inclusão do índice financeiro para o CDI
- Criar um template de CDI utilizando o índice previamente cadastrado.
Image Added
Image Added
Dica |
---|
title | 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 |
|
Totvs custom tabs box items |
---|
| 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 |
---|
| 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 |
---|
| 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 |
---|
| Clicar no botão ... que fica na ultima última coluna a à 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.
...
Aviso |
---|
|
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 | Tipo | Descrição |
---|
DIASCORRIDOS | Numérico | Quantidade de dias corridos dentro do período de cálculo (Diferença entre data de cálculo e data de vencimento) |
DIASUTEIS | Numérico | Quantidade de dias úteis dentro do período de cálculo (Diferença entre data de cálculo e data de vencimento) |
VLRCORRIGIDO | Numérico | Valor corrigido do contrato |
VALORBASE | Numérico | Valor base que está sendo utilizado no cálculo da fórmula |
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 cálculo |
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 |
---|
| Exemplo 1 - Juros personalizadoNo 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 índiceAo 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 |
---|
tabs | 1 - Criação de índice e template,2 - Inclusão do empréstimo,3 - Pagamento de parcela corrigida |
---|
ids | 1,2,3 |
---|
| Totvs custom tabs box items |
---|
| Image Added
Image Added
|
Totvs custom tabs box items |
---|
| Image Added
|
Totvs custom tabs box items |
---|
| Image Added
|
|
|
Totvs custom tabs box items |
---|
| 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 |
---|
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
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
Image Removed
04. TABELAS UTILIZADAS
- Cadastro de templates - F7B
- Formulas - F7C