Files
cruce-cuentas-glm-centralizado/IMPLEMENTACION_HONDURAS.md

5.8 KiB
Raw Permalink Blame History

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 USD dentro 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

  1. 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.
  2. Portal de Verificación de Nómina Honduras - Históricos.json

    • Webhook: /webhook/cruce-cuentas-hn-historicos
    • Consulta únicamente históricos country = HN.
  3. 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.

Actualizaciones compartidas

  1. 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.xlsx y Nomina 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.
  2. 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.

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 HN a los constraints de aliases BambooHR, correcciones e históricos.
  • Agrega HN al constraint paises de cruce_cuentas_usuarios_autorizados.
  • Agrega HN a todos los usuarios actuales, preservando los demás permisos.
  • Actualiza cruce_cuentas_bamboo_aliases_activos para cinco países.
  • Actualiza cruce_cuentas_get_historicos para cinco países.
  • Actualiza cruce_cuentas_get_banco_sin_bamboo_reporte para 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

  1. Ejecutar SUPABASE_Honduras_READY.sql y verificar que todos los usuarios tengan HN en paises.
  2. Importar el workflow nuevo Portal de Verificación de Nómina - Honduras y revisar credenciales.
  3. Importar Honduras - Históricos.
  4. Importar Honduras - Envío de Reporte / Marcar Resuelto.
  5. Reemplazar/actualizar el workflow compartido de Gemini; no dejar activa la versión anterior con el mismo webhook.
  6. Reemplazar/actualizar el workflow compartido de correcciones BambooHR; no dejar activa la versión anterior con el mismo webhook.
  7. Publicar/activar los cinco workflows una vez revisadas las credenciales.
  8. Desplegar exactamente el contenido de dist del ZIP de aplicación bajo /cruce-cuentas/.
  9. Hacer una prueba controlada de una Q15 y una Q30 desde la aplicación.
  10. 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.