Files
cruce-cuentas-glm-centralizado/IMPLEMENTACION_BONO14_GUATEMALA.md
T

2.3 KiB

Bono 14 Guatemala — Implementación final

Esta versión incorpora Bono 14 como un reporte anual independiente dentro del módulo de Guatemala, sin mezclar sus importes con la nómina ordinaria.

Disponibilidad en la app

La sección aparece únicamente con:

  • País: Guatemala
  • Mes: Julio
  • Tipo de cruce: Quincena 15

La ejecución normal de la Quincena 15 permanece independiente.

Archivos

Bono 14 recibe:

  1. Un Excel anual de Bono 14.
  2. Uno o varios CSV bancarios.

El webhook independiente es:

bono14gt-bamboo-test

Variable frontend:

VITE_N8N_GUATEMALA_BONO14_WEBHOOK_URL

Identidad del reporte

El histórico utiliza:

GT-AAAA-07-bono14

Ejemplo 2026:

GT-2026-07-bono14

Si se procesa nuevamente el mismo año, se reutiliza el mismo Google Sheet y el mismo histórico; las resoluciones que sigan correspondiendo a casos presentes se conservan.

Período anual

Para Bono 14 del año AAAA:

  • inicio: AAAA-1-07-01
  • fin: AAAA-06-30

Ejemplo 2026: 2025-07-01 a 2026-06-30.

Lectura del Excel

El workflow detecta dinámicamente las columnas principales de las siete hojas canónicas y conserva índices de respaldo por compatibilidad.

También identifica el total oficial de cada hoja y cierra la tabla en esa fila. Esto evita incorporar filas auxiliares o de ajustes colocadas debajo del total oficial.

Antes de continuar, el workflow valida que la suma de empleados leída coincida con el total oficial de cada hoja. Si no coincide, se detiene para evitar generar un reporte incorrecto.

Hojas canónicas:

  • P&G
  • B14 MOTO
  • B14 WP
  • PMI
  • B14 Nestle
  • B14 GLM Q
  • B14 GLM $

El flujo trabaja con QTZ y USD de forma separada.

Google Sheet

El reporte genera:

  1. 01 Bono 14 vs Banco
  2. 02 Banco sin Bono 14
  3. 03 Banco sin Bamboo
  4. 04 Diferencias nombre banco
  5. 05 Cuenta Mal Digitada (cuando aplica)
  6. 06 Resumen

Conserva las mismas condiciones finales de Guatemala: protección de datos, Resolución editable, reutilización del mismo reporte, limpieza de formatos residuales y orden automático de pestañas.

Supabase

No se crea una segunda tabla de históricos. Se reutiliza cruces_cuentas_gt_reportes y Bono 14 se diferencia mediante:

  • country = GT
  • month = 7
  • period_type = bono14
  • report_identity = GT-AAAA-07-bono14

Ejecutar:

SUPABASE_Cruce_Cuentas_Bono14_Guatemala_READY.sql