Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 66

changes.mady.by.user Guilherme Augusto de Sordi Nogueira Guedes

Gravado em

comparado com

Nova versão 67

changes.mady.by.user Guilherme Augusto de Sordi Nogueira Guedes

Gravado em

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

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.

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

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.


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

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

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

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



06. TABELAS UTILIZADAS

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