> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Generar un Report

> Genera un Report a través de un wizard de 4 pasos que te guía desde la selección del Template hasta la salida compilada final.

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.

<Note>
  Los Reports se generan de forma asíncrona. Un nuevo Report comienza en `Processing` y solo queda disponible para descarga cuando llega a `Finished`.
</Note>

## Paso a paso

***

<Steps>
  <Step title="Abre la página Reports">
    Ve a **Reports** y haz clic en **New Report**.
  </Step>

  <Step title="Selecciona el Template">
    En el paso **Template**, elige el Template que define la estructura y el formato de salida. Haz clic en **Next**.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="Revisa la configuración">
    En el paso **Review**, revisa el Template seleccionado y los filtros aplicados.
  </Step>

  <Step title="Genera el Report">
    Haz clic en **Generate Report**. El wizard muestra el progreso de la generación y se cierra tras enviarse la solicitud.
  </Step>

  <Step title="Monitorea el estado">
    El Report aparece en la lista con estado `Processing`. Espera a que llegue a `Finished` antes de descargarlo.
  </Step>
</Steps>

## 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.           |
| `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

***

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Esperar descarga inmediata">
    La descarga solo está disponible después de que el Report llegue a `Finished`.
  </Accordion>
</AccordionGroup>

## Pasos siguientes

***

* Usa [Descargar un Report](/es/lerian-console/reporter-console/downloading-a-report) cuando el estado sea `Finished`.
* Usa [Corregir un Report](/es/lerian-console/reporter-console/editing-a-report) si el archivo generado tiene datos, diseño o formato incorrectos.
* Usa [Probar una conexión de Data Source](/es/lerian-console/reporter-console/testing-a-data-source) si la generación falla por problemas de conexión o schema.

<CardGroup cols={2}>
  <Card title="Crear un Report" icon="code" href="/es/reference/reporter/create-report">
    Genera Reports de forma programática.
  </Card>

  <Card title="Consultar estado del Report" icon="code" href="/es/reference/reporter/check-report-status">
    Consulta el estado de la generación antes de la descarga.
  </Card>
</CardGroup>
