Gu铆a de F贸rmulas Avanzadas para Layouts Bancarios
Esta gu铆a describe las funciones (m茅todos) avanzadas disponibles para construir el c贸digo JSON de tu Layout Bancario. Estas funciones te permiten manipular textos, fechas y n煤meros para cumplir con los requisitos espec铆ficos de cada banco.
Las funciones se dividen por el tipo de dato que manipulan: String (texto), Date (fechas) y Numeric (n煤meros).
Funciones de Manipulaci贸n de Texto (StringFormula)
Utilizadas para dar formato, extraer o modificar cadenas de texto (strings).
| Funci贸n | Implementaci贸n | Descripci贸n |
| SPLIT_PART | SPLIT_PART(value, sep, part) | Divide un texto (value) usando un separador (sep) y devuelve la parte especificada por el 铆ndice (part). |
| MERGE_STR | MERGE_STR(sep, arg1, arg2, ...) | Une varios textos (arg1, arg2, etc.) utilizando un separador (sep). |
| SUBSTR | SUBSTR(value, from, to) | Extrae una porci贸n de un texto (value) desde una posici贸n inicial (from) hasta una posici贸n final (to). |
| REPLACE | REPLACE(value, pivot, to) | Reemplaza todas las ocurrencias de un patr贸n (pivot) dentro de un texto (value) por un nuevo texto (to). |
| REPLACE_CHAR | REPLACE_CHAR(value, pos, char) | Reemplaza el car谩cter en una posici贸n espec铆fica (pos) de un texto (value) por un nuevo car谩cter (char). |
| UPPERCASE | UPPERCASE(value) | Convierte el texto (value) completamente a MAY脷SCULAS. |
| LOWERCASE | LOWERCASE(value) | Convierte el texto (value) completamente a min煤sculas. |
| UNACCENT | UNACCENT(value) | Elimina acentos y caracteres especiales del texto, dejando solo caracteres ASCII. |
| CLEAN_TEXT | CLEAN_TEXT(value) | Realiza una limpieza completa: elimina acentos, caracteres especiales y normaliza espacios en blanco. |
Funciones de Manipulaci贸n de Fechas (DateFormula)
Utilizadas para obtener, formatear y calcular informaci贸n relacionada con el tiempo.
| Funci贸n | Implementaci贸n | Descripci贸n |
| CURRENT_DATE | CURRENT_DATE(format) | Retorna la fecha actual. Se puede especificar el formato de salida (por defecto es '%d-%m-%Y'). |
| FORMAT_DATE | FORMAT_DATE(value, format) | Formatea una fecha (value) seg煤n el formato especificado (format). |
| PERIODICITY | PERIODICITY(value) | Convierte la periodicidad de pago de ingl茅s ('monthly', 'weekly', etc.) a su equivalente en espa帽ol. |
| PERIODICITY_MONTH | PERIODICITY_MONTH(periodicity, date) | Calcula el n煤mero de per铆odo (semana, quincena, etc.) dentro del mes seg煤n la periodicidad y fecha. |
| PERIODICITY_YEAR | PERIODICITY_YEAR(periodicity, date) | Calcula el n煤mero de per铆odo (semana, quincena, etc.) dentro del a帽o seg煤n la periodicidad y fecha. |
| DAY | DAY(num) | Retorna el nombre del d铆a de la semana en espa帽ol a partir de un n煤mero (1=lunes, 7=domingo). |
| MONTH | MONTH(num) | Retorna el nombre del mes en espa帽ol a partir de un n煤mero (1=enero, 12=diciembre). |
Funciones de Manipulaci贸n Num茅rica (NumericFormula)
Utilizadas para realizar c谩lculos y aplicar l贸gica a valores num茅ricos.
| Funci贸n | Implementaci贸n | Descripci贸n |
| INTERVAL | INTERVAL(value, inc) | Multiplica un valor base (value) por un incremento (inc). |
| ABS | ABS(number) | Retorna el valor absoluto de un n煤mero. |
| ROUND | ROUND(value, num) | Redondea un n煤mero (value) a la cantidad de decimales (num) especificada (por defecto 0). |
| DECIMAL | DECIMAL(value, num) | Formatea un n煤mero (value) para que tenga una cantidad espec铆fica de decimales (num). |
| VALUE | VALUE(column_type, type, value, char) | Compara el tipo de columna actual con un tipo esperado. Si coinciden, retorna el value; si no, retorna char. |
| VALUE_ABS | VALUE_ABS(column_type, type, value, char) | Similar a VALUE, pero retorna el valor absoluto del value si los tipos coinciden. |
| VALUE_ROTATE | VALUE_ROTATE(column_type, type, value, char) | Funci贸n avanzada que maneja el retorno de valores o caracteres bas谩ndose en la coincidencia de tipos y el signo del value. |
Ejemplos Pr谩cticos: 驴C贸mo uso una F贸rmula?
Para que las f贸rmulas (como SUBSTR, REPLACE o CURRENT_DATE) funcionen, deben ser usadas en el campo value dentro de la configuraci贸n JSON, combinadas con sus par谩metros.
1. Ejemplos de F贸rmulas de Texto (String)
Objetivo: Obtener solo el d铆gito verificador del RUT (煤ltimo car谩cter).
En lugar de usar la variable simple employee_identifier, usar谩s la f贸rmula SUBSTR.
{ "value": "SUBSTR(employee_identifier, -1, -1)" }
// Extrae el 煤ltimo car谩cter de la variable 'employee_identifier'
Objetivo: Unir el RUT de la empresa con su nombre, separados por un guion.
{ "value": "MERGE_STR('-', company_identifier, company_name)" }
// Resultado esperado: 76123456-5-Mi Empresa S.A.
Objetivo: Asegurar que el nombre de la empresa est茅 en may煤sculas.
{ "value": "UPPERCASE(company_name)" }
// Resultado esperado: MI EMPRESA S.A.
2. Ejemplos de F贸rmulas de Fecha (Date)
Objetivo: Obtener la fecha de creaci贸n del archivo en formato YYYYMMDD.
Opci贸n 1: Usando la f贸rmula CURRENT_DATE
{ "value": "CURRENT_DATE('%Y%m%d')" }
// Resultado esperado (ejemplo): 20251114
Opci贸n 2: Usando el par谩metro format (m谩s com煤n para variables existentes)
Esto aplica el formato a una variable que ya contiene una fecha (como file_creation_date).
{ "value": "file_creation_date", "format": "%Y%m%d" }
3. Ejemplos de F贸rmulas Num茅ricas
Objetivo: Obtener el valor absoluto del monto a pagar (煤til si el monto employee_amount puede ser negativo, pero el banco solo acepta positivos).
{ "value": "ABS(employee_amount)" }
Objetivo: Redondear el monto total a pagar sin decimales.
{ "value": "ROUND(total_records_amount, 0)" }