Objetivo
Crear un Report generado para una necesidad operativa específica, período, entidad, estado o envío. Por ejemplo, genera un CSV mensual de transacciones de mayo, un archivo XML para envío regulatorio o un resumen PDF filtrado por un segmento de clientes.
Cuándo usarlo
Usa esta tarea cuando:
- el Template está listo;
- el Data Source usado por el Template está disponible. Puede ser una fuente interna ya configurada para el entorno o una externa añadida desde Data Sources;
- un operador necesita producir un archivo de Report;
- el Report necesita filtros opcionales, como rango de fechas, estado, tipo o entidad.
Antes de empezar
Confirma:
- el Template seleccionado es el correcto para la obligación;
- el formato de salida del Template coincide con el archivo que necesitas entregar;
- el Data Source usado por el Template está disponible y probado cuando el informe depende de una conexión que puede haber cambiado;
- sabes si el Report debe incluir todos los datos o un subconjunto filtrado;
- los valores de filtro son lo bastante precisos para el período de reporting.
Los Reports se generan de forma asíncrona. Un nuevo Report comienza en
Processing y solo queda disponible para descarga cuando llega a Finished.Paso a paso
Selecciona el Template
En el paso Template, elige el Template que define la estructura y el formato de salida. Haz clic en Next.
Añade filtros cuando sea necesario
En el paso Filters, añade uno o más filtros para acotar los datos. Este paso es opcional. Si el Report debe incluir todos los datos disponibles, haz clic en Next.
Genera el Report
Haz clic en Generate Report. El wizard muestra el progreso de la generación y se cierra tras enviarse la solicitud.
Guía de campos
| Campo | Qué introducir | Ejemplo |
|---|---|---|
| Template | Template obligatorio seleccionado en el paso Template. El valor técnico enviado a la API es templateId. | Monthly tax CSV |
| Buscar templates | Búsqueda opcional en la UI. Filtra la lista cargada de Templates por nombre o nombre de archivo y no se envía en el payload de generación. | tax |
| Database | Obligatorio solo cuando se usa una fila de filtro. Selecciona la conexión de Data Source; el payload usa este valor como database. | production-postgres |
| Table | Obligatorio solo cuando se usa una fila de filtro. Selecciona una tabla del schema de la conexión. | transactions |
| Field | Obligatorio solo cuando se usa una fila de filtro. Selecciona el campo a comparar. | created_at |
| Operator | Obligatorio solo cuando se usa una fila de filtro. Usa eq, gt, gte, lt, lte, between, in o nin. | Between / between |
| Values | Obligatorio solo cuando se usa una fila de filtro. between requiere exactamente dos valores; in y nin aceptan valores separados por coma; los demás operadores usan un valor. | 2026-05-01, 2026-05-31 |
Ejemplos de filtros
| Filtro | Resultado |
|---|---|
status Equal active | Incluye solo registros activos. |
created_at Between 2026-05-01, 2026-05-31 | Incluye registros de mayo de 2026. |
type In credit,debit | Incluye cualquiera de los dos tipos de transacción. |
amount Greater Than 1000 | Incluye registros con monto superior a 1000. |
Estado y siguiente acción
| Estado | Qué significa | Acción del operador |
|---|---|---|
Processing | Reporter está generando el archivo. | Espera. La lista se refresca automáticamente. |
Finished | El archivo está listo. | Visualiza, previsualiza o descarga el Report. |
Error | Reporter encontró un error durante la generación. | Revisa el mensaje y genera de nuevo tras la corrección. |
PendingExtraction | Reporter está esperando la extracción de datos antes del procesamiento final. | Espera o revisa la salud del Data Source si no avanza. |
Resultado esperado
Un nuevo Report aparece en la página Reports. Cuando llega a
Finished, los operadores pueden previsualizar o descargar el archivo generado.
Errores comunes y puntos de atención
Generar con el Template incorrecto
Generar con el Template incorrecto
El Template controla el diseño y el formato de salida. Si se selecciona el Template incorrecto, genera un nuevo Report con el Template correcto.
Usar un Data Source que no fue probado
Usar un Data Source que no fue probado
Conexiones fallidas o desactualizadas pueden causar errores de generación. Prueba el Data Source antes de generar Reports operativos cuando la salud de la conexión sea incierta, especialmente para bases de datos externas o credenciales recientemente cambiadas.
Usar filtros amplios por error
Usar filtros amplios por error
Filtros vacíos pueden incluir todos los datos disponibles. Confirma si el Report debe cubrir todos los registros o solo un período, estado o entidad específicos.
Esperar descarga inmediata
Esperar descarga inmediata
La descarga solo está disponible después de que el Report llegue a
Finished.Pasos siguientes
- Usa Descargar un Report cuando el estado sea
Finished. - Usa Corregir un Report si el archivo generado tiene datos, diseño o formato incorrectos.
- Usa Probar una conexión de Data Source si la generación falla por problemas de conexión o schema.
Crear un Report
Genera Reports de forma programática.
Consultar estado del Report
Consulta el estado de la generación antes de la descarga.