Agregar El Salvador y actualizar dist validado

2026-09-07 15:14:41 -04:00
parent 043a442639
commit 2495256856
22 changed files with 3387 additions and 301 deletions
@@ -0,0 +1,61 @@
+# 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.