
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 sistema.
02. EJEMPLO DE UTILIZACIÓN
- Al realizar el acceso al Protheus, utilizando el 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 derecha)
El campo F7B_APLEMP determinará si aquel template es de APL (Inversión) o EMP (Préstamo), 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. |

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). (Para que la actualización de las tasas de CDI ocurra de forma automática, es necesario registrar el schedule de FINXTAXA haga clic aquí). - Inclusión del índice financiero para el CDI
- Crear un template de CDI utilizando el índice previamente registrado.

- Configurar el job de FINXTAXA para que la actualización de este índice sea automática y para que exista registros de movimientos de este índice (FIU)
- Crear un template de CDI utilizando el índice previamente registrado.

|
Haga clic en la opción ... que 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. 
|
Haga clic en la opción ... que 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 Confirmar. |
Haga clic en la opción ... que queda en la última columna a la izquierda de la tabla y seleccione la opción Visualizar. |
Haga clic en la opción ... que 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
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 campo Tipo (F7C_TIPO), para cada tipo seleccionado habrá funciones y campos específicos como muestra la siguiente imagen.
Los campos que se muestran en la pantalla dinámicamente servirán como parámetro para los cálculos de la referida fórmula.

Después de la grabación del template, las configuraciones para cada formula se grabarán en el campo F7C_CONFIG en formato JSON (JavaScript Object Notation), con base en estas configuraciones este template podrá vincularse a los contratos de inversiones y préstamos. |
04. FÓRMULAS PERSONALIZABLES
Es posible que el usuario cree fórmulas personalizables para que atienda su necesidad específica de cálculo, para 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 |
|---|
DIASCORRIDOS | Numérico | Cantidad de días consecutivos dentro del período de cálculo (Diferencia entre fecha de cálculo y fecha de vencimiento) |
DIASUTEIS | Numérico | Cantidad de días hábiles dentro del período de cálculo (Diferencia entre fecha de cálculo y fecha de vencimiento) |
VLRCORRIGIDO | Numérico | Valor corregido del contrato |
VALORBASE | Numérico | Valor base que se está utilizando en el cálculo de la fórmula |
RECNO | Numérico | R_E_C_N_O_ del registro en la tabla de inversiones y préstamos (SEH) |
VLRACUMUSEI | Array | Valores acumulados de los movimientos SEI Situación del array | Descripción | 1 | Acumulado de intereses en la moneda actual (EI_TIPODOC = "JR" y EI_VALOR) | 2 | Acumulado de intereses en la moneda del préstamo (EI_TIPODOC == "JR" y EI_VLMOED2) | 3 | Acumulado de la variación cambiaria a corto plazo (EI_TIPODOC == "V2") | 4 | Acumulado de la variación cambiaria a largo plazo (EI_TIPODOC == "V1") | 5 | Acumulado de la variación cambiaria de los intereses (EI_TIPODOC == "V3") |
|
VLRACUMUSEH | Array | Valores acumulados en el registro SEH Situación del array | Descripción | 1 | Acumulado de los intereses en la moneda actual (EH_ACUJUR2) | 2 | Acumulado de los intereses en la moneda del préstamo (EH_ACUJUR) | 3 | Acumulado de la variación cambiaria a corto plazo (EH_ACUVCCP) | 4 | Acumulado de la variación cambiaria a largo plazo (EH_ACUVCLP) | 5 | Acumulado de la variación cambiaria de los intereses (EH_ACUVCJR) |
|
DATACALCULO | Fecha | Fecha de cálculo |
DATACONTRATO | Fecha | Fecha de inclusión del contrato (SEH) |
EJEMPLOS
En 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

- Acceda al browse de Préstamos e incluya un contrato utilizando el template previamente registrado
- En este escenario utilizaremos un préstamo de R$100.000,00 utilizando la tabla PRICE y generando 5 cuotas

|
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 disponibles)
#include "rwmake.ch"
#include "protheus.ch"
#INCLUDE "TBICONN.CH"
USER FUNCTION MYJUROS()
Local nJuros As Numeric
nJuros := VALORBASE * 0.01
RETURN nJuros |
- 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

- Acceda al browse de Préstamos e incluya un contrato utilizando el template previamente registrado
- En este escenario utilizaremos un préstamo de R$100.000,00 utilizando la tabla PRICE y generando 5 cuotas

|
|
05. SIMULACIÓN
Durante el registro de un template, es posible 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 para simular basta registrar al menos una fórmula en el template:

Al hacer clic en la opción "Simular" se muestra una pantalla para simulación de template con los siguientes campos:

- Valor: Este campo determina la base del 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 retiro de una inversión.
- Fecha de contrato: Este campo determina la fecha inicial para los cálculos de las fórmulas, siendo equivalente a la fecha de registro del contrato.
- Fecha de Pago\Retiro: Este campo determina la fecha final para los cálculos de las fórmulas, siendo equivalente a la fecha de pago de un préstamo o fecha de retiro de una inversión.
Si los campos estuvieran cumplimentados, el sistema realizará automáticamente la simulación y mostrará en pantalla los valores calculados:

06. TABLAS UTILIZADAS
- F7B - Registro de templates
- F7C - Fórmulas