Generar un Report

Genera un Report con el wizard de 4 pasos de Reporter, que te guía desde la selección del Template hasta la salida compilada final lista para descargar.

Usa esta página para generar un Report a partir de un Template existente. La generación es el momento en que Reporter aplica un Template a los datos y crea un archivo que puede monitorearse, visualizarse y descargarse.

​

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.

No uses esta tarea para cambiar la estructura del Template. Actualiza primero el Template y luego genera un nuevo Report.

​

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

---

1. Abre la página Reports

   Ve a Reports y haz clic en New Report.

2. Selecciona el Template

   En el paso Template, elige el Template que define la estructura y el formato de salida. Haz clic en Next.

3. 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.

4. Revisa la configuración

   En el paso Review, revisa el Template seleccionado y los filtros aplicados.

5. Genera el Report

   Haz clic en Generate Report. El wizard pasa al paso Generate y sigue el progreso mientras Reporter crea el archivo.

6. Monitorea el estado

   Cuando la generación termina con éxito, el wizard ofrece las acciones Download y View in List. Si cierras el wizard antes, el Report aparece en la lista con estado Processing; espera a que llegue a Finished antes de descargarlo.

​

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
Search 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.
Partial	Algunas secciones de datos fallaron. El Report cubre solo las secciones que respondieron.	Revisa las secciones fallidas en los detalles del Report, comprueba la salud del Data Source y genera de nuevo tras la corrección.
Error	Reporter encontró un error durante la generación.	Revisa el mensaje y genera de nuevo tras la corrección.

​

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

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

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

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

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.