5.8 KiB
Implementación — Cruce de Cuentas GLM · Honduras (HN)
Alcance
Esta entrega agrega Honduras al portal centralizado sin retirar Guatemala (GT), Trinidad y Tobago (TT), Panamá (PA), El Salvador (SV) ni Bono 14 Guatemala.
Honduras queda configurado con:
- Código:
HN - Nombre:
Honduras - Moneda principal:
HNL - Soporte de pagos en
USDdentro del mismo archivo de nómina - Locale:
es-HN - Bandera:
https://dbit.digitalcompass.agency/storage/v1/object/public/public-assets/Bandera%20de%20Honduras.webp - Responsable de correcciones BambooHR: Melody Chang Blandin —
mchang@gomezleemarketing.com
Archivos n8n
Nuevos
-
Portal de Verificación de Nómina - Honduras.json- Webhook de producción:
/webhook/nominahn-bamboo-test - Recibe un Excel de nómina y uno o varios CSV bancarios.
- Procesa planes BAC AR94 (HNL) y AR95US (USD).
- Genera/reutiliza el Google Sheet del período, registra el histórico en Supabase y envía el reporte.
- Webhook de producción:
-
Portal de Verificación de Nómina Honduras - Históricos.json- Webhook:
/webhook/cruce-cuentas-hn-historicos - Consulta únicamente históricos
country = HN.
- Webhook:
-
Portal de Verificación de Nómina Honduras - Envío de Reporte.json- Webhook:
/webhook/cruce-cuentas-hn-marcar-resuelto - Marca únicamente reportes HN como resueltos y envía la notificación correspondiente.
- Webhook:
Actualizaciones compartidas
-
Portal de Verificación de Nómina - Analizar Nómina con Gemini GT TT PA SV HN.json- Conserva el webhook existente
/webhook/cruce-cuentas-analizar-nomina. - Agrega HN al validador, esquema, prompt y normalizador.
- Reconoce nombres compactos de Honduras como
Nomina 7.1 2026 GLM HN.xlsxyNomina 7.2 2026 GLM HN.xlsx. - Calcula dinámicamente 1–15 y 16–último día real del mes, incluyendo febrero y años bisiestos.
- Conserva el webhook existente
-
Portal de Verificación de Nómina - Reportar corrección BambooHR a RRHH - GT TT PA SV HN.json- Conserva el webhook existente
/webhook/cruce-cuentas-bamboo-correccion. - Agrega HN y envía las correcciones de Honduras exclusivamente a
mchang@gomezleemarketing.com.
- Conserva el webhook existente
Los dos workflows compartidos usan los mismos paths que los workflows actuales. No deben quedar dos versiones activas con el mismo webhook. Actualiza/reemplaza la versión existente o desactiva la anterior antes de publicar la nueva.
Destinatarios de reportes generados de Honduras
El workflow principal usa estos seis destinatarios:
const to = [
'iaracena@gomezleemarketing.com',
'jgomez@gomezleemarketing.com',
'mgomez@gomezleemarketing.com',
'vparamo@gomezleemarketing.com',
'ymadera@gomezleemarketing.com',
'adminregional@gomezleemarketing.com',
].join(',');
Nómina Honduras soportada
El workflow procesa las hojas reales observadas en junio/julio de 2026, con tolerancia a hojas opcionales ausentes:
- Colgate Base
- Colgate Combustible
- POP Helper Base
- POP Helper Combustible
- Motorola Base
- Motorola Temporales
- Motorola KAM Dolares
- Nestle Base
- Nestle Combustible
- Whirlpool Base
- Whirlpool Combustible
- FF Regional WH Base
- FF Regional WH Combustible
- GLM Base Lempiras
- GLM Combustible Lempiras
- GLM Dolares Base
- GLM Dolares Combustible
Las cuentas se preservan como texto y los montos se separan por moneda HNL/USD.
Regla de redondeo
Para Honduras, una diferencia absoluta de hasta 0.05 entre nómina y banco se considera redondeo operativo y no una discrepancia. Los archivos reales mostraron diferencias de 0.01 y un caso USD de 0.03. Diferencias superiores continúan reportándose.
Supabase
Ejecuta SUPABASE_Honduras_READY.sql antes de activar los workflows.
El script:
- Agrega
HNa los constraints de aliases BambooHR, correcciones e históricos. - Agrega
HNal constraintpaisesdecruce_cuentas_usuarios_autorizados. - Agrega HN a todos los usuarios actuales, preservando los demás permisos.
- Actualiza
cruce_cuentas_bamboo_aliases_activospara cinco países. - Actualiza
cruce_cuentas_get_historicospara cinco países. - Actualiza
cruce_cuentas_get_banco_sin_bamboo_reportepara cinco países. - Conserva la tabla histórica compartida
cruces_cuentas_gt_reportes; el nombre es legado, la tabla es multi-país.
App
Variables Honduras incorporadas:
VITE_N8N_HONDURAS_WEBHOOK_URL="https://agenteit.digitalcompass.agency/webhook/nominahn-bamboo-test"
VITE_HISTORICOS_HN_URL="https://agenteit.digitalcompass.agency/webhook/cruce-cuentas-hn-historicos"
VITE_MARCAR_RESUELTO_HN_URL="https://agenteit.digitalcompass.agency/webhook/cruce-cuentas-hn-marcar-resuelto"
El selector de país incluye Honduras y el dist entregado ya contiene la configuración HN, los tres endpoints, la bandera y el destinatario de correcciones.
Orden de implementación recomendado
- Ejecutar
SUPABASE_Honduras_READY.sqly verificar que todos los usuarios tenganHNenpaises. - Importar el workflow nuevo Portal de Verificación de Nómina - Honduras y revisar credenciales.
- Importar Honduras - Históricos.
- Importar Honduras - Envío de Reporte / Marcar Resuelto.
- Reemplazar/actualizar el workflow compartido de Gemini; no dejar activa la versión anterior con el mismo webhook.
- Reemplazar/actualizar el workflow compartido de correcciones BambooHR; no dejar activa la versión anterior con el mismo webhook.
- Publicar/activar los cinco workflows una vez revisadas las credenciales.
- Desplegar exactamente el contenido de
distdel ZIP de aplicación bajo/cruce-cuentas/. - Hacer una prueba controlada de una Q15 y una Q30 desde la aplicación.
- Verificar Históricos, “Marcar resuelto” y un caso de “Reportar a RRHH”.
Estado de activación de los JSON
Los cinco JSON entregados tienen active: false intencionalmente para una importación segura. Actívalos únicamente después de confirmar credenciales y de evitar duplicidad de webhooks compartidos.