Agregar Bono 14 Guatemala y actualizar dist

2026-08-12 09:13:40 -04:00
parent 65ab888c00
commit 6652877319
33 changed files with 3983 additions and 4833 deletions
@@ -0,0 +1,106 @@
+# 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`