107 lines
2.3 KiB
Markdown
107 lines
2.3 KiB
Markdown
# 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`
|