# 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`