Exportación Automática

El sistema puede generar exportaciones automáticas al inicio de cada mes para los clientes configurados. Esto asegura que los datos del mes anterior estén disponibles sin intervención manual.

¿Cómo Funciona?

Configuración

Habilitar Auto-Export para un Cliente

1. Ir a Exportaciones → pestaña "Exportaciones Automáticas"
2. Localizar el cliente en la lista
3. Activar el toggle para habilitar
4. El sistema ejecutará la exportación automáticamente el 1° de cada mes

:::info Solo Admin Solo los Administradores pueden habilitar/deshabilitar la exportación automática. Los Supervisores y Ejecutivos pueden ver la configuración pero no modificarla. :::

Visualizar Configuración Actual

Todos los roles pueden ver el estado de la configuración:

Columna	Descripción
Cliente	Nombre del cliente/cartera
Estado	Toggle ON/OFF (solo editable por Admin)
Última exportación	Fecha de la última exportación automática exitosa
Habilitado por	Admin que activó la configuración

Funcionamiento del Scheduler

El scheduler se ejecuta el primer día de cada mes y genera exportaciones del mes anterior completo.

Ejemplo

Si hoy es 1 de Julio 2026:

• Genera exportaciones de Junio 2026 (1 Jun 00:00:00 → 30 Jun 23:59:59)
• Solo para clientes con auto-export habilitado Y status activo

Detección de Duplicados

El scheduler verifica antes de crear cada job:

• Si ya existe un ExportJob con origin='scheduled' para el mismo cliente y mes
• Con status pending, processing, o completed
• → No crea otro (evita duplicados por re-ejecución del trigger)

Ruta de Almacenamiento

Los archivos se almacenan con una ruta predecible:

exports/scheduled/{customerId}/{YYYY-MM}.xlsx

Ejemplo: exports/scheduled/5/2026-06.xlsx

Descarga de Exportaciones Automáticas

Las exportaciones automáticas aparecen en el historial de exportaciones con un badge "Programada":

1. Ir a Exportaciones → Exportación Manual
2. En el historial, localizar el job con origen "Programada"
3. Hacer clic en "Descargar" (genera SAS URL válida por 60 minutos)

Retención de Archivos

• Los archivos se retienen por 90 días en Azure Blob Storage
• Después de 90 días, se eliminan automáticamente via lifecycle policy
• Si necesitas un archivo más antiguo, deberás re-exportar manualmente

Reintentos en Caso de Fallo

Si una exportación programada falla:

1. El scheduler reintenta hasta 3 veces con 5 minutos entre intentos
2. Después del tercer fallo, el job queda como failed
3. Se puede ver el error en el historial de exportaciones
4. Un Admin puede solicitar la exportación manualmente

Permisos

Acción	Permiso	Roles
Ver configuración	api:export-jobs:manage	Admin, Supervisor, Ejecutivo
Modificar configuración	api:export-config:manage	Solo Admin
Descargar archivos	api:export-jobs:manage	Admin, Supervisor, Ejecutivo (con enrollment)
Trigger del scheduler	Internal / Admin	Automático (CRON) o Admin