cruce-cuentas-glm-centralizado/IMPLEMENTACION_EL_SALVADOR.md

Cruce de Cuentas GLM · El Salvador (SV)

Estado

Integración preparada para producción con la misma arquitectura multinacional del portal.

Endpoints n8n

• Cruce principal: https://agenteit.digitalcompass.agency/webhook/nominasv-bamboo-test
• Históricos: https://agenteit.digitalcompass.agency/webhook/cruce-cuentas-sv-historicos
• Marcar resuelto: https://agenteit.digitalcompass.agency/webhook/cruce-cuentas-sv-marcar-resuelto
• Analizador de período compartido: https://agenteit.digitalcompass.agency/webhook/cruce-cuentas-analizar-nomina
• Corrección BambooHR compartida: https://agenteit.digitalcompass.agency/webhook/cruce-cuentas-bamboo-correccion

Archivos de nómina

El Salvador admite múltiples Excel por quincena. Se validaron los formatos GLM de:

• General
• Karla Elias / Trade Marketing
• Nestlé
• Motorola

Q1 puede contener únicamente los archivos aplicables a la primera quincena; Q2 puede incluir todos los archivos aplicables al cierre de mes. La app no impone una cantidad fija.

Banco

Admite múltiples CSV Consulta Detalle de Envío de planes 4503 y ABG3. El parser usa las columnas Cuenta Destino, Nombre en Archivo, Nombre del Cuentahabiente, Monto, Concepto y metadatos de plan/envío.

Períodos

Año, mes y quincena son dinámicos. El analizador compartido con Gemini reconoce nombres en español/inglés y calcula:

• Quincena 15: día 1 al 15.
• Quincena 30 / fin de mes: día 16 al último día real del mes (28, 29, 30 o 31).

Moneda y zona horaria

• Moneda: USD
• Locale: es-SV
• Zona horaria: America/El_Salvador

Bandera

https://dbit.digitalcompass.agency/storage/v1/object/public/public-assets/Flag_of_El_Salvador.svg.webp

Correcciones BambooHR

• El Salvador: Carlos Antonio Malta Méndez — cmalta@gomezleemarketing.com.
• Panamá queda corregido para enviar únicamente a Delarys Peñalba — dpenalba@gomezleemarketing.com.

Supabase

Ejecutar una sola vez SUPABASE_El_Salvador_READY.sql. Amplía los CHECK y RPC multi-país a SV sin borrar datos existentes.

Orden de implementación en producción

1. Ejecutar SUPABASE_El_Salvador_READY.sql una sola vez.
2. Importar y publicar Portal de Verificación de Nómina - El Salvador.json.
3. Importar y publicar Portal de Verificación de Nómina El Salvador - Históricos.json.
4. Importar y publicar Portal de Verificación de Nómina El Salvador - Envío de Reporte.json.
5. Actualizar el workflow compartido del analizador de nómina con Portal de Verificación de Nómina - Analizar Nómina con Gemini GT TT PA SV.json.
6. Actualizar el workflow compartido de correcciones con Portal de Verificación de Nómina - Reportar corrección BambooHR a RRHH - GT TT PA SV.json.
7. Desplegar el dist incluido en el ZIP de la aplicación.
8. Dar acceso a SV en Supabase a los usuarios que deban operar El Salvador, si su registro de acceso restringe países.
9. Hacer una ejecución controlada de Q15 y Q30 antes de entregar el país a usuarios finales.

Importante para los dos workflows compartidos

Los JSON usan los mismos paths de webhook que los workflows actuales. No deben quedar publicadas simultáneamente dos copias con el mismo path. Actualiza/reemplaza el workflow existente o desactiva el anterior antes de publicar el nuevo.

Los workflows entregados quedan active: false dentro del JSON para que la importación sea segura. Publícalos después de verificar que n8n haya conservado/asignado las credenciales correspondientes.