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)


Informaciones

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

  1. Inclusión del índice financiero para el CDI
  2. Crear un template de CDI utilizando el índice previamente registrado.


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

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.


Importante

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 PERSONALIZADAS

Es posible que el usuario cree fórmulas personalizadas para que cumpla con 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

Ejemplo 1 - Intereses personalizado

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

Ejemplo 2 - Intereses basado en índice

Al 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 vista que en el momento de la generación de la cuota no es posible determinar previamente la tasa del índice en fecha futura.



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)


Función utilizada en el ejemplo
#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, 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.


06. TABLAS UTILIZADAS

  • F7B - Registro de templates
  • F7C - Fórmulas
  • FIT - Índices financieros
  • FIU - Variación de índices financieros