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

# Genera un informe

> Genera un informe regulatorio mediante un asistente de cuatro pasos que te guía desde la selección de la plantilla hasta el resultado final compilado listo para su envío.

Usa esta página para generar un informe a partir de una plantilla existente. La generación es el momento en que Reporter aplica una plantilla a los datos y crea un archivo que puedes monitorear, ver y descargar.

## Objetivo

***

Crea un informe generado para una necesidad operativa, un período, una entidad, un estado o un envío específicos.

Por ejemplo, genera un CSV mensual para las transacciones de mayo, un archivo XML para una presentación regulatoria o un resumen en PDF filtrado a un segmento de clientes.

## Cuándo usarlo

***

Usa esta tarea cuando:

* la plantilla está lista.
* la fuente de datos que usa la plantilla está disponible. Puede ser una fuente interna ya configurada para el entorno o una fuente externa agregada desde **Data Sources**.
* un operador necesita producir un archivo de informe.
* el informe necesita filtros opcionales, como rango de fechas, estado, tipo o entidad.

No uses esta tarea para cambiar la estructura de la plantilla. Actualiza la plantilla primero y luego genera un nuevo informe.

## Antes de empezar

***

Confirma lo siguiente:

* la plantilla seleccionada es la correcta para la obligación.
* el formato de salida de la plantilla coincide con el archivo que debes entregar.
* la fuente de datos que usa la plantilla está disponible. Prueba la conexión cuando el informe dependa de una que pudo haber cambiado.
* sabes si el informe debe incluir todos los datos o un subconjunto filtrado.
* los valores de los filtros son lo bastante precisos para el período del informe.

<Note>
  Reporter genera los informes de forma asíncrona. Un informe nuevo empieza en `Processing` y solo está disponible para descargar 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 la plantilla">
    En el paso **Template**, elige la plantilla que define la estructura y el formato de salida. Haz clic en **Next**.
  </Step>

  <Step title="Agrega filtros cuando sea necesario">
    En el paso **Filters**, agrega uno o más filtros para acotar los datos. Este paso es opcional. Si el informe debe incluir todos los datos disponibles, haz clic en **Next**.
  </Step>

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

  <Step title="Genera el informe">
    Haz clic en **Generate Report**. El asistente pasa al paso **Generate** y muestra el progreso mientras Reporter crea el archivo.
  </Step>

  <Step title="Monitorea el estado">
    Cuando la generación tiene éxito, el asistente ofrece las acciones **Download** y **View in List**. Si cierras el asistente antes, el informe aparece en la lista con estado `Processing`. Espera hasta que llegue a `Finished` antes de descargarlo.
  </Step>
</Steps>

## Guía de campos

***

| Campo             | Qué ingresar                                                                                                                                                                         | Ejemplo                  |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------ |
| **Template**      | Plantilla obligatoria seleccionada en el paso **Template**. El valor técnico enviado a la API es `templateId`.                                                                       | `Monthly tax CSV`        |
| Buscar plantillas | Búsqueda opcional en la interfaz. Filtra la lista de plantillas cargadas 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 fuente de datos; el payload usa este valor como `database`.                                             | `production-postgres`    |
| **Table**         | Obligatorio solo cuando se usa una fila de filtro. Selecciona una tabla del esquema de la conexión.                                                                                  | `transactions`           |
| **Field**         | Obligatorio solo cuando se usa una fila de filtro. Selecciona el campo que se 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` necesita exactamente dos valores; `in` y `nin` aceptan valores separados por comas; los demás operadores usan un valor. | `2026-05-01, 2026-05-31` |

## Ejemplos de filtros

***

| Filtro                                            | Resultado                                           |
| ------------------------------------------------- | --------------------------------------------------- |
| `status` **Equal** `active`                       | Incluye solo los 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 un monto superior a 1000.     |

## Estado y próxima acción

***

| Estado       | Qué significa                                                                              | Acción del operador                                                                                                                             |
| ------------ | ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `Processing` | Reporter está generando el archivo.                                                        | Espera. La lista se actualiza automáticamente.                                                                                                  |
| `Finished`   | El archivo está listo.                                                                     | Ve, previsualiza o descarga el informe.                                                                                                         |
| `Partial`    | Algunas secciones de datos fallaron. El informe cubre solo las secciones que respondieron. | Revisa las secciones fallidas en los detalles del informe, verifica el estado de la fuente de datos y genera de nuevo después de la corrección. |
| `Error`      | Reporter encontró un error durante la generación.                                          | Revisa el mensaje y genera de nuevo después de la corrección.                                                                                   |

## Resultado esperado

***

Aparece un nuevo informe en la página **Reports**. Cuando llega a `Finished`, los operadores pueden previsualizarlo o descargar el archivo generado.

## Errores comunes y puntos de atención

***

<AccordionGroup>
  <Accordion title="Generar con la plantilla incorrecta">
    La plantilla controla el diseño y el formato de salida. Si seleccionaste la plantilla incorrecta, genera un nuevo informe con la plantilla correcta.
  </Accordion>

  <Accordion title="Usar una fuente de datos que no se probó">
    Las conexiones fallidas o desactualizadas pueden causar errores de generación. Prueba la fuente de datos antes de generar informes operativos cuando el estado de la conexión sea incierto, en especial para bases de datos externas o credenciales cambiadas recientemente.
  </Accordion>

  <Accordion title="Usar filtros demasiado amplios por error">
    Los filtros vacíos pueden incluir todos los datos disponibles. Confirma si el informe debe cubrir todos los registros o solo un período, estado o entidad específicos.
  </Accordion>

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

## Próximos pasos

***

* Usa [Descarga un informe](/es/products/reporter/console/downloading-a-report) cuando el estado sea `Finished`.
* Usa [Corrige un informe](/es/products/reporter/console/editing-a-report) si el archivo generado tiene datos, diseño o formato incorrectos.
* Usa [Probar una fuente de datos](/es/products/reporter/console/testing-a-data-source) si la generación falla por problemas de conexión o esquema.

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

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