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

62 lines
3.4 KiB
Markdown

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