seguimiento-impuestos/n8n/CONFIGURACION.md

Configuración de n8n — Seguimiento de Impuestos GLM

Este proyecto incluye tres workflows independientes para facilitar pruebas y mantenimiento.

1. Recordatorios por Gmail y Google Chat

Archivo:

Seguimiento-de-Impuestos-GLM-Recordatorios-Actualizado.json

• Se ejecuta diariamente a las 8:00 a. m. en America/Santo_Domingo.
• Consulta tax_due_reminders en Supabase.
• Envía correos HTML con identidad visual GLM.
• Envía mensajes por Google Chat.
• Registra cada envío para evitar duplicados.

Después de importar:

1. Seleccionar la credencial correcta en Gmail - Enviar recordatorio.
2. Confirmar la URL y API key del nodo de Google Chat.
3. Desactivar el workflow anterior antes de activar este, para evitar duplicados.
4. Ejecutar una prueba manual con una fecha controlada.

2. Búsqueda de contactos en BambooHR

Archivo:

Seguimiento-de-Impuestos-GLM-BambooHR-Contactos.json

Production URL esperada:

https://agenteit.digitalcompass.agency/webhook/seguimiento-impuestos-bamboohr-contacto

Después de importar:

1. Abrir Generar reporte completo BambooHR.
2. Confirmar la credencial BambooHR GLM Full Access.
3. Activar el workflow.
4. Probar con:

{
  "action": "search_contact",
  "full_name": "Nombre Apellido"
}

El workflow normaliza nombres, tolera tildes y diferencias menores, prioriza coincidencias exactas y devuelve hasta ocho candidatos con país, teléfono, área, cargo, correo y estado.

3. Sincronización con Google Calendar

Archivo:

Seguimiento-de-Impuestos-GLM-Google-Calendar.json

Production URL esperada:

https://agenteit.digitalcompass.agency/webhook/seguimiento-impuestos-google-calendar

Antes de activarlo, ejecutar en Supabase:

../supabase/actualizacion_bamboohr_google_calendar.sql

Después de importar:

1. Crear o seleccionar una credencial OAuth2 de Google Calendar.
2. Asignarla en estos nodos:
   • Google Calendar - Crear evento
   • Google Calendar - Actualizar evento
   • Google Calendar - Eliminar evento
3. Verificar que la cuenta conectada sea la cuenta organizadora de los eventos.
4. Activar el workflow.

Cada obligación crea un evento de 8:00 a. m. a 9:00 a. m., hora de República Dominicana, e invita a los contactos aplicables. Las modificaciones y eliminaciones realizadas antes del primer aviso también se sincronizan.

Orden recomendado de despliegue

1. Ejecutar el parche SQL.
2. Importar y activar BambooHR.
3. Importar y activar Google Calendar.
4. Reemplazar el workflow de recordatorios.
5. Desplegar el frontend actualizado.
6. Probar un contacto y una obligación futura de prueba.

Google Chat — mensajes directos

El workflow de recordatorios usa una credencial Google Chat OAuth2 API con los scopes incluidos por n8n (chat.spaces, chat.messages y chat.memberships). Después de importar:

1. Habilita Google Chat API en el proyecto de Google Cloud.
2. Crea o selecciona una credencial Google Chat OAuth2 API en n8n.
3. Asígnala a Google Chat - Abrir DM y Google Chat - Enviar recordatorio.
4. Autentica con la cuenta corporativa que enviará los mensajes.
5. Ejecuta una prueba manual antes de activar el Schedule Trigger.

El flujo crea o reutiliza un mensaje directo con el correo corporativo del contacto, envía el aviso y registra el resultado en tax_notification_log con canal google_chat.