Lapachos Lending : Archivo de Configuación de Notificaciones

Archivo de ejemplo

Formato del Archivo

Para que el sistema procese la información correctamente, el archivo debe cumplir con las siguientes especificaciones:

Tipo de Archivo: CSV (Valores Separados por Comas).
Codificación: UTF-8. Es importante guardar el archivo con esta codificación para evitar problemas con caracteres especiales (acentos, ñ, etc.).
Separador de Columnas: Coma (,).
Cabecera: La primera fila del archivo debe contener obligatoriamente los nombres de las columnas que se describen en este documento. El orden de las columnas debe ser respetado.

Descripción de las Columnas

Nombre de la Columna	Formato de Datos	Obligatorio	Descripción	Ejemplo
Tipo	Texto	Si	Entidad que va arecibir la Notificación	`Lender`
id_notificacion	Alfanumérico	Sí	Identificador único y técnico para la notificación. No debe repetirse. El sistema lo usa internamente para referenciar la notificación.	`recordatorio_pago_1`
nombre_plantilla	Texto	Sí	Un nombre descriptivo y legible para la notificación que permita identificarla fácilmente por un humano.	`Recordatorio de Próximo Pago`
canal	Texto (Valores Fijos)	Sí	El canal a través del cual se enviará la comunicación. Los valores permitidos son: `EMAIL`, `SMS`, `PUSH`.	`EMAIL`
trigger_event	Texto (Valores Fijos)	Sí	El evento específico dentro del ciclo de vida del préstamo que dispara el envío de esta notificación.	`proximo_vencimiento`
dias_relativos	Número Entero	Sí	Define el momento exacto del envío en relación al `trigger_event`. <br> • Valores positivos (+): Días después del evento. Valores negativos (-): Días antes del evento. Cero (0): El mismo día del evento.	`-3` (tres días antes del vencimiento)
asunto	Texto	Condicional	El asunto o título de la notificación. Es obligatorio si el `canal` es `EMAIL` o `PUSH`. Para `SMS`, se ignora este campo.	`Tu pago está próximo a vencer`
cuerpo_mensaje	Texto	Sí	El contenido principal de la notificación. Puede contener variables (placeholders) que el sistema reemplazará con datos reales (ej: `${nombre_cliente}`, `${monto_pago}`).	`Hola ${nombre_cliente}, te recordamos que tu pago de ${monto_pago} vence en 3 días.`
estado	Texto (Valores Fijos)	Sí	Indica si la notificación está activa y lista para ser enviada o si está desactivada. Los valores permitidos son: `activo`, `inactivo`.	`activo`
descripcion	Texto	No	Un campo opcional para añadir notas internas o una descripción más detallada sobre el propósito de la notificación, su lógica de negocio, etc.	`Primer recordatorio enviado 3 días antes de la fecha de pago.`

Nota Importante: Si el contenido de un campo de texto (como cuerpo_mensaje o nombre_plantilla) incluye una coma (,), todo el contenido de esa celda debe estar encerrado entre comillas dobles (") para asegurar que el archivo sea interpretado correctamente.

Variables Disponibles para el `cuerpo_mensaje`

Para personalizar las comunicaciones y proporcionar información relevante al cliente, el campo cuerpo_mensaje puede incluir variables. Estas variables son marcadores de posición (placeholders) que el sistema reemplaza automáticamente con los datos reales correspondientes a cada cliente y préstamo en el momento de enviar la notificación.

El formato para usar una variable es el siguiente: ${nombre_de_la_variable}.

A continuación se presenta una lista de las variables más comunes disponibles en el sistema, agrupadas por contexto.

Variables

Variable	Descripción	Ejemplo de Valor
{{date}}	12-05-2025
{{invoice_number}}	Número de Factura
{{loan_type}}	Tipo de Préstamo
{{supplier}}	Nombre del Proveedor
{{buyer}}	Nombre del Comprador
{{lender}}	Nombre del Lender
{{email}}	Correo electronico
{{password}}	Contraseña provisional