Exportación Manual
Permite exportar gestiones realizadas en formato Excel bajo demanda. La exportación se procesa en background y el archivo queda disponible para descarga cuando esté listo.
Flujo de Exportación
Paso a Paso
1. Configurar Parámetros
- Ir a Exportaciones → Exportación Manual
- Seleccionar el Cliente del dropdown (o "Todos" si eres Admin)
- Seleccionar Fecha de Inicio del rango
- Seleccionar Fecha de Fin del rango
:::warning Rango Máximo El rango de fechas no puede exceder 31 días. Si necesitas un período mayor, divide en múltiples exportaciones. :::
2. Iniciar Exportación
- Verificar que los parámetros sean correctos
- Hacer clic en "Exportar a Excel"
- Se muestra una barra de progreso con el porcentaje procesado
- El archivo se genera en background — puedes navegar a otras secciones
3. Descargar Archivo
- Cuando el estado cambie a "Completado" ✅, aparece el botón de descarga
- Hacer clic en "Descargar"
- Se genera un enlace temporal (válido por 60 minutos)
- El navegador descarga el archivo Excel automáticamente
Historial de Exportaciones
En la parte inferior de la página se muestra una tabla con todas las exportaciones realizadas:
| Columna | Descripción |
|---|---|
| Estado | Badge con el status (pending, processing, completed, failed) |
| Fecha | Cuándo se solicitó la exportación |
| Cliente | Cartera exportada |
| Rango | Período de fechas |
| Tamaño | Tamaño del archivo generado |
| Acción | Botón de descarga (solo si completed) |
Formato del Archivo Excel
El archivo exportado contiene 21 columnas con la información de cada gestión:
| Columna | Contenido |
|---|---|
| Fecha | Fecha de la gestión |
| Ejecutivo | Usuario que registró |
| Acción | Tipo de acción |
| Resultado | Resultado obtenido |
| Integrante | ID del integrante |
| Nombre | Nombre del deudor |
| Comentarios | Notas del ejecutivo |
| ... | (campos adicionales del integrante) |
Acceso y Permisos
| Propiedad | Valor |
|---|---|
| Ruta | /gestiones/export |
| Permiso de página | page:gestiones:export |
| Permiso de API | api:gestiones:export, api:export-jobs:manage |
| Roles para página | Solo Admin |
| Roles para API | Admin, Supervisor, Ejecutivo (filtrado por enrollment) |
:::note Nota sobre Permisos La página de exportación solo es visible para Admin. Sin embargo, el API de exportación está disponible para todos los roles — esto permite que futuros desarrollos expongan la funcionalidad a Supervisores/Ejecutivos con filtrado por enrollment. :::
Retención de Archivos
- Los archivos exportados se almacenan en Azure Blob Storage
- Retención: 90 días
- Después de 90 días, el archivo se elimina automáticamente
- Si intentas descargar un archivo expirado, recibirás un error HTTP 410
Errores Comunes
| Error | Causa | Solución |
|---|---|---|
| "Date range exceeds 31 days" | Rango mayor a 31 días | Reducir el rango |
| "Access denied for this customer" | No inscrito al cliente | Contactar Admin para enrollment |
| "Export not ready" | Job aún procesándose | Esperar a que complete |
| "Export file has expired" | Pasaron >90 días | Re-ejecutar la exportación |