01.
...
VISIÓN GENERAL
El registro de templates se creó con el objetivo de flexibilizar los cálculos de los valores que consideran una inversión o un préstamo, como por ejemplo el CDI. Por medio de este nuevo registro el usuario podrá configurar su propio cálculo o seguir el establecido en el
...
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.
...
EJEMPLO DE
...
UTILIZACIÓN
- Ao realizar o acesso ao Al realizar el acceso al Protheus, utilizando o ambiente Financeiro, deverá ser acessado o menu Atualizações → Aplicações e empréstimosel entorno Financiero, debe accederse al menú Actualizaciones → Inversiones y préstamos
- Para acceder al registro de templates Opción Templates (ubicado en la parte superior derechaPara acessar o cadastro de templates Botão Templates (localizado no canto superior direito)
| Informações |
|---|
| title | Informações!Informaciones |
|---|
|
O El campo F7B_APLEMP irá determinar se aquele template é determinará si aquel template es de APL (AplicaçãoInversión) ou o EMP (EmpréstimoPréstamo), 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 si el usuario accediera al registro de template por medio de la browse de inversión, el valor del campo será APL, si accediera por medio de la browse de préstamo el valor del campo será EMP. |
Image Modified
| Totvs custom tabs box |
|---|
| tabs | Incluir, Editar, ExcluirBorrar, 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á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 (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
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
Al hacer clic en la opción Incluir se mostrará el formulario para que el usuario digite la información necesaria para incluir el template.
En el siguiente ejemplo vamos a incluir un template con cálculo de CDI, cabe resaltar que se está utilizando el registro de índices financieros (FINA017, tablas FIT/FIU). - Inclusión del índice financiero para el CDI
- Crear un template de CDI utilizando el índice previamente registrado.
Image Added
Image Added
| Dica |
|---|
| title | Actualización automática de los índices |
|---|
| Para que la actualización de las tasas del CDI ocurra de manera automática es necesario registrar el schedule del FINXTAXA. Más información: Job actualización de tasas BACEN - FINXTAXA |
|
| Totvs custom tabs box items |
|---|
| Clicar no botão Haga clic en la opción ... 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
queda en la última columna a la izquierda de la tabla y seleccione la opción Editar. En la edición es posible modificar la descripción, modificar las fórmulas, borrar e incluir una nueva fórmula en el template. |
| Totvs custom tabs box items |
|---|
| Clicar no botão Haga clic en la opción ... que fica na última coluna à esquerda da tabela e selecionar a opção Excluir.queda en la última columna a la izquierda de la tabla y seleccione la opción Borrar. Verifique si es el template que desea borrar y haga clic en Verifique se é o template que deseja excluir e clique em Confirmar. |
| Totvs custom tabs box items |
|---|
| Clicar no botão Haga clic en la opción ... que fica na última coluna à esquerda da tabela e selecionar a opção queda en la última columna a la izquierda de la tabla y seleccione la opción Visualizar. |
| Totvs custom tabs box items |
|---|
| Clicar no botão Haga clic en la opción ... 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
queda en la última columna a la izquierda de la tabla y seleccione la opción Copiar La copia traerá las fórmulas existentes en el template de partida y debe contener un nuevo código aún no 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.
Los templates obligatoriamente deben tener por lo menos una fórmula vinculada a su registro para que el sistema realice el debido cálculo en el momento del retiro de una inversión o pago de un préstamo.
Las configuraciones de una fórmula respetarán el As configurações de uma fórmula irão respeitar o campo Tipo (F7C_TIPO), para cada tipo escolhido haverá funções e seleccionado habrá funciones y campos específicos como demonstra a imagem a seguirmuestra la siguiente imagen.
Os Los 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
se muestran en la pantalla dinámicamente servirán como parámetro para los cálculos de la referida fórmula.
| Aviso |
|---|
|
Após a gravação do Después de la grabación del template, as configurações las configuraciones para cada fórmula serão gravadas no formula se grabarán en el campo F7C_CONFIG em en formato JSON (JavaScript Object Notation), com base nessas configurações esse template poderá ser vinculado nos contratos de aplicações e empréstimoscon base en estas configuraciones este template podrá vincularse a los contratos de inversiones y préstamos. |
04. FÓRMULAS PERSONALIZADAS
É possível que o usuário crie Es posible que el usuario cree fórmulas personalizadas para que atenda sua necessidade cumpla con su necesidad 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
ello pusimos a disposición un nuevo recurso en el registro de template y algunas variables a las que puede accederse durante el procesamiento.
VARIABLES
Nombre | Tipo | Descripción | Nome | Tipo | Descrição |
|---|
DIASCORRIDOS | Numérico | Quantidade Cantidad de dias corridos días consecutivos dentro do del período de cálculo ( Diferença Diferencia entre data fecha de cálculo e data y fecha de vencimentovencimiento) |
DIASUTEIS | Numérico | Quantidade Cantidad de dias úteis días hábiles dentro do del período de cálculo ( Diferença Diferencia entre data fecha de cálculo e data y fecha de vencimentovencimiento) |
VLRCORRIGIDO | Numérico | Valor corrigido do corregido del contrato |
VALORBASE | Numérico | Valor base que está sendo utilizado no cálculo da se está utilizando en el cálculo de la fórmula |
RECNO | Numérico | R_E_C_N_O_ do registro na tabela de aplicações e empréstimos del registro en la tabla de inversiones y préstamos (SEH) |
VLRACUMUSEI | Array | Valores acumulados dos movimentos de los movimientos SEI Posição do Descrição do juros na moeda corrente de intereses en la moneda actual (EI_TIPODOC = "JR" | e do Juros na moeda do Empréstimo de intereses en la moneda del préstamo (EI_TIPODOC == "JR" | e da Variação Cambial a Curto Prazo de la variación cambiaria a corto plazo (EI_TIPODOC == "V2") | 4 | Acumulado | da Variação Cambial a Longo Prazo de la variación cambiaria a largo plazo (EI_TIPODOC == "V1") | 5 | Acumulado | da Variação Cambial dos Juros de la variación cambiaria de los intereses (EI_TIPODOC == "V3") |
|
VLRACUMUSEH | Array | Valores acumulados no cadastro en el registro SEH Posição do Descrição do juros na moeda corrente de los intereses en la moneda actual (EH_ACUJUR2) | 2 | Acumulado | do Juros na moeda do Empréstimo de los intereses en la moneda del préstamo (EH_ACUJUR) | 3 | Acumulado | da Variação Cambial a Curto Prazo de la variación cambiaria a corto plazo (EH_ACUVCCP) | 4 | Acumulado | da Variação Cambial a Longo Prazo de la variación cambiaria a largo plazo (EH_ACUVCLP) | 5 | Acumulado | da Variação Cambial dos Juros de la variación cambiaria de los intereses (EH_ACUVCJR) |
|
DATACALCULO | Data Fecha | Data Fecha de cálculo |
DATACONTRATO | Data Fecha | Data Fecha de inclusão do inclusión del contrato (SEH) |
...
EJEMPLOS
| Totvs custom tabs box |
|---|
| tabs | Expressão Expresión ADVPL, Função Función de usuário usuario |
|---|
| ids | 06,07 |
|---|
|
| Totvs custom tabs box items |
|---|
| Ejemplo 1 - Intereses personalizadoEn el siguiente ejemplo vamos a incluir un template con cálculo personalizable de intereses para préstamo, utilizando una expresión ADVPL (Verificar variables disponibles) - Crear un template de INTERESES utilizando la configuración PERSONALIZABLE.
- En este ejemplo vamos a invertir el 1% al mes de intereses para las cuotas que se generarán posteriormente
Image Added
- Acceda al browse de Préstamos e incluya un contrato utilizando el template previamente registrado
- En este escenario utilizaremos un préstamo
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 Removed
- 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
- la tabla PRICE y generando 5 cuotas
Image Added
|
| Totvs custom tabs box items |
|---|
| Ejemplo 2 - Intereses basado en índiceAl utilizar un índice financiero para cálculo de intereses en el template, el valor calculado sobre el índice se aplicará en el pago de la cuota, y no en la generación de la cuota, teniendo en cuenta que en el momento de la generación de la cuota no es posible determinar previamente la tasa del índice en fecha futura. Resaltamos que para el correcto funcionamiento, es necesario el registro de estos índices (diariamente) en la tabla de Tasas de los Índices Financieros (FIU). | Dica |
|---|
| title | Actualización automática de los índices |
|---|
| Para que la actualización de las tasas del CDI ocurra de manera automática es necesario registrar el schedule del FINXTAXA. Más información: Job actualización de tasas BACEN - FINXTAXA |
| Totvs custom tabs box |
|---|
| tabs | 1 - Creación de índice y template,2 - Inclusión del préstaamo,3 - Pago de cuota corregida |
|---|
| ids | 1,2,3 |
|---|
| | Totvs custom tabs box items |
|---|
| Image Added
Image Added
|
| Totvs custom tabs box items |
|---|
|
|
| 07 | | Image Added
|
| Totvs custom tabs box items |
|---|
| Image Added
|
|
|
| Totvs custom tabs box items |
|---|
| En el siguiente ejemplo vamos a incluir un template con cálculo personalizable de intereses para préstamo, utilizando función de usuario (Verificar variables disponiblesNo 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 exemploFunción utilizada en el ejemplo |
|---|
| 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 Crear un template de JUROS utilizando a configuração PERSONALIZADO. INTERESES utilizando la configuración PERSONALIZABLE.
- En este ejemplo vamos a invertir el 1% al mes de intereses para las cuotas que se generarán Neste exemplo vamos aplicar 1% ao mês de juros para as parcelas que serão geradas posteriormente
Image Modified
- Acessar a Acceda al browse de Empréstimos Préstamos e incluir um incluya un contrato utilizando o el template previamente cadastradoregistrado
- En este escenario utilizaremos un préstamo Nesse cenário utilizaremos um empréstimo de R$100.000,00 utilizando a tabela PRICE e gerando 5 parcelasla tabla PRICE y generando 5 cuotas
Image Modified
|
|
05
...
. SIMULACIÓN
Durante el registro de un template, se pueden simular posibles valores de las fórmulas registradas. Para ello, el usuario debe seleccionar un template, en la opción "Simular", y en la pantalla de simulación, completar los datos necesarios para los cálculos.
Para habilitar la opción de simular, simplemente registre por lo menos una fórmula al template.
Al hacer clic en la opción "Simular" aparecerá una pantalla para simular el template que contiene los siguientes campos:
- Valor: Este campo determina la base de cálculo para las fórmulas del template, lo que para los contratos sería equivalente al valor de pago de un préstamo o al valor de retirada de una inversión.
- Fecha Contrato: Este campo determina la fecha inicial para calcular las fórmulas, es equivalente a la fecha de registro del contrato.
- Fecha Pago/Retirada: Este campo determina la fecha final para calcular las fórmulas, es equivalente a la fecha de pago de un préstamo o fecha de retirada de una inversión.
Si los campos están informados, el sistema automáticamente realizará la simulación y mostrará en la pantalla los valores calculados.
Image Added
06. TABLAS UTILIZADAS
- F7B - Cadastro Registro de templates
- F7C - Formulas- Fórmulas
- FIT - Índices financieros
- FIU - Variación de índices financieros