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

# Ruta de configuración

> Sigue la ruta de configuración mínima para operar Reporter desde Lerian Console: fuentes de datos, plantillas, la primera generación de informes y la verificación de la descarga.

Usa esta ruta cuando necesites que Reporter esté disponible desde la Console por primera vez. La secuencia depende de tu modelo de fuente de datos. Empieza por Templates si ya existen fuentes de datos internas del producto configuradas. Si necesitas una base de datos externa, agrega y prueba primero la fuente de datos.

## Antes de empezar

***

Lee el [mapa de conceptos de Reporter](/es/products/reporter/console/reporter-concepts-map) si no has usado Reporter antes. Explica la cadena operativa:

* **Data Sources** definen desde dónde lee datos Reporter.
* **Templates** definen la estructura y el formato de salida del archivo.
* **Reports** son los archivos que Reporter genera a partir de una plantilla. Puedes monitorearlos, verlos y descargarlos.

Antes de abrir las pantallas de configuración, decide qué informe quieres producir primero. Por ejemplo: "informe fiscal mensual en CSV", "informe operativo diario en PDF" o "archivo XML regulatorio filtrado por rango de fechas". Esa decisión te indica si la fuente de datos necesaria ya existe. También te indica qué plantilla, formato de salida y filtros necesitas.

## Requisitos previos

***

| Requisito                                   | Qué debe estar listo                                                                                                                                                       | Dónde se usa                     |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| Acceso a Reporter                           | Tu organización puede acceder a Reporter en la Console.                                                                                                                    | Todas las páginas de Reporter    |
| Permisos de la Console                      | Tu usuario puede gestionar Data Sources, Templates y Reports para la organización.                                                                                         | Data Sources, Templates, Reports |
| Modelo de fuente de datos                   | Si el informe usa una fuente de datos interna ya configurada para productos como Midaz o CRM, o una base de datos externa que debe agregarse manualmente.                  | Ruta de configuración            |
| Detalles de conexión de la base de datos    | Host, puerto, nombre de la base de datos, usuario, contraseña y cualquier información de red o SSL requerida. Obligatorio solo cuando agregas una fuente de datos externa. | Data Sources                     |
| Contexto de los datos de origen             | La base de datos, la tabla, los campos y los filtros que se recomienda que alimenten el primer informe.                                                                    | Data Sources, Reports            |
| Insumo de la plantilla                      | Un archivo `.tpl` existente o suficiente estructura del informe para crear una en Template Builder.                                                                        | Templates, Template Builder      |
| Expectativa de salida                       | El formato de archivo requerido, como CSV, XML, HTML, TXT o PDF.                                                                                                           | Templates, Reports               |
| Necesidad de automatización mediante la API | Una decisión sobre si la configuración seguirá siendo manual en la Console o se automatizará mediante la API.                                                              | Referencia de API                |

Si falta alguno de estos elementos, detente ahí primero. Reporter solo puede generar archivos útiles cuando conoces la plantilla, el resultado esperado y la conexión de datos correspondiente.

## Elige la ruta de configuración

***

Usa esta decisión antes de seguir los pasos:

| Escenario                                                               | Empieza por      | Por qué                                                                                                                                             |
| ----------------------------------------------------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| El informe usa datos internos del producto ya configurados en Reporter. | **Templates**    | Es posible que ya existan fuentes de datos internas para productos como Midaz o CRM, por lo que el operador no necesita crear una conexión primero. |
| El informe usa una base de datos externa o nueva.                       | **Data Sources** | Reporter necesita una conexión configurada y probada manualmente antes de que las plantillas o los filtros puedan usar sus campos.                  |
| El informe falla porque faltan datos o son inaccesibles.                | **Data Sources** | Prueba la conexión y confirma los esquemas, las tablas y los campos antes de volver a generar.                                                      |

## Secuencia mínima de configuración

***

<Steps>
  <Step title="Confirma el acceso y elige el primer informe">
    Empieza desde la Overview de Reporter. Confirma que el equipo sabe qué informe crear primero. Usa la Overview cuando necesites explicar para qué sirve cada área de Reporter.

    Ve a [módulo Reporter](/es/products/reporter/console/reporter-module) y [mapa de conceptos de Reporter](/es/products/reporter/console/reporter-concepts-map).
  </Step>

  <Step title="Confirma la ruta de la fuente de datos">
    Verifica si la fuente de datos necesaria ya existe. Es posible que ya existan fuentes de datos internas del producto configuradas para el entorno. Si el informe depende de una base de datos externa o de una conexión faltante, agrega esa fuente de datos. Pruébala antes de crear informes.

    En la página **Data Sources**, usa las conexiones existentes cuando ya estén disponibles. Agrega una conexión nueva solo cuando la fuente requerida no esté disponible. Luego, ejecuta **Test Connection** antes de usarla en un informe.

    Usa [Agrega una fuente de datos](/es/products/reporter/console/adding-a-data-source) y [Prueba la conexión de una fuente de datos](/es/products/reporter/console/testing-a-data-source).
  </Step>

  <Step title="Agrega o crea una plantilla">
    La plantilla define la estructura y el formato de salida del informe. Puedes subir un archivo `.tpl` existente o crear la plantilla de forma visual en la Console.

    En la página **Templates**, usa [Agrega una plantilla](/es/products/reporter/console/adding-template). Si el operador necesita armar el diseño a partir de bloques, usa [Template Builder](/es/products/reporter/console/template-builder).
  </Step>

  <Step title="Genera un informe">
    En la página **Reports**, crea un informe a partir de la plantilla. Selecciona la plantilla, aplica filtros cuando sea necesario, revisa la configuración y luego genera el archivo.

    Usa [Genera un informe](/es/products/reporter/console/generating-a-report). Este es el momento en que una plantilla se convierte en un informe. Antes de la generación, es solo una definición reutilizable.
  </Step>

  <Step title="Monitorea la finalización y descarga el archivo">
    Los informes generados empiezan en `Processing`. Espera hasta que el estado llegue a `Finished` y luego visualiza o descarga el archivo de salida.

    Si el informe termina en `Error`, revisa los detalles y vuelve a ejecutarlo después de corregir la fuente de datos, la plantilla o las entradas de filtro. Usa [Descarga un informe](/es/products/reporter/console/downloading-a-report) cuando el archivo esté listo.
  </Step>

  <Step title="Rastrea las fechas de entrega recurrentes cuando sea necesario">
    Si el informe tiene un plazo recurrente, usa la página **Overview** para agregar el recordatorio de entrega. Esto mantiene visibles las entregas próximas y vencidas. No cambia la forma en que Reporter genera los informes.

    Usa el recordatorio solo para el seguimiento operativo. No crea ni programa informes automáticamente.
  </Step>
</Steps>

## Cuándo usar la referencia de la API

***

Usa la Console para la primera configuración operativa:

* confirma o crea la fuente de datos.
* prueba las conexiones cuando sea necesario.
* agrega o crea la plantilla.
* genera el primer informe.
* descarga el archivo.

Usa la [referencia de la API de Reporter](/es/reference/products/reporter/reporter-developer-quick-start) cuando necesites automatizar o integrar el mismo workflow, por ejemplo:

* crear o listar plantillas desde otro sistema.
* crear informes de forma programática.
* verificar el estado de un informe sin abrir la Console.
* descargar archivos generados mediante una integración.
* validar o gestionar conexiones fuera del workflow del operador.

La configuración manual en la Console no requiere la referencia de la API. La referencia de la API es para trabajo de implementación, automatización y solución de problemas con equipos de ingeniería.

## Qué sucede después

***

Al final de la ruta de configuración, se recomienda que tengas:

* una fuente de datos relevante disponible para el informe, ya sea preconfigurada internamente o agregada y probada manualmente.
* una plantilla que coincida con el formato de salida requerido.
* un informe generado con estado `Finished`.
* un archivo descargado listo para entrega o validación.
* recordatorios de entrega opcionales en la página Overview cuando el informe tenga plazos recurrentes.

Después de eso, el ciclo operativo habitual es:

* mantén en buen estado la fuente de datos relevante cuando el informe dependa de una.
* actualiza la plantilla cuando cambie la estructura del archivo.
* genera informes cuando sea necesario.
* descarga el resultado final.

## Errores comunes de secuenciación

***

<AccordionGroup>
  <Accordion title="Crear una fuente de datos cuando ya existe una">
    Algunos entornos ya incluyen fuentes de datos internas para productos Lerian como Midaz o CRM. Revisa la lista existente antes de agregar una conexión externa duplicada.
  </Accordion>

  <Accordion title="Usar una fuente de datos que nunca se probó">
    Es posible que la conexión exista, pero las credenciales, el acceso de red y los esquemas todavía necesitan validación cuando el informe depende de esa fuente. Ejecuta **Test Connection** antes de confiar en ella.
  </Accordion>

  <Accordion title="Subir una plantilla sin conocer el formato de salida">
    Se recomienda que la plantilla coincida con el formato de archivo requerido. Confirma si la operación necesita CSV, XML, HTML, TXT o PDF antes de usarla para generar informes.
  </Accordion>

  <Accordion title="Esperar que la referencia de la API reemplace la configuración en la Console">
    Los operadores pueden completar la primera configuración en la Console. Usa la referencia de la API cuando debas automatizar, integrar o depurar el mismo workflow con soporte de ingeniería.
  </Accordion>
</AccordionGroup>

## Enlaces relacionados

***

<Card title="Referencia de la API de Reporter" icon="code" href="/es/reference/products/reporter/reporter-developer-quick-start" horizontal>
  Usa esta opción cuando debas automatizar o integrar el workflow de Reporter mediante API.
</Card>
