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

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Crear reportes

> Explica cómo solicitar, consultar y descargar reportes de pagos, transacciones y liquidaciones mediante la API.

Los reportes de Yuno ofrecen una forma práctica de obtener información sobre las distintas etapas de los pagos. Puedes solicitar y descargar fácilmente diversos reportes asociados a tus operaciones con Yuno. Yuno ofrece los siguientes tipos de reporte mediante el endpoint [Create a Report](https://docs.y.uno/reference/reports/create-a-report.md):

* Payment
* Transaction
* Payouts
* Settlements & Fees
* Reconciliation Overview
* Communications
* Settlement Payouts

Puedes consultar la descripción detallada de cada uno en la documentación de [Reports Fields](https://docs.y.uno/reference/reports/reports-fields.md). Los reportes Reconciliation Overview, Settlements & Fees y Settlement Payouts ofrecen información relacionada con la conciliación. Para revisar todos los campos disponibles en cada reporte y su descripción, consulta la [página Reports Fields](https://docs.y.uno/reference/reports/reports-fields.md).

## Requisitos

Para solicitar un reporte, necesitas:

* Acceder a tus [credenciales de API](https://docs.y.uno/es/docs/using-yuno/settings/developers-credentials.md) en el Yuno Dashboard, que constan de:
  * `public-api-key`
  * `private-secret-key`

> [!NOTE]
>
> **Explora las colecciones de Postman de Yuno**
>
> Yuno ofrece [colecciones de Postman](https://docs.y.uno/reference/getting-started/postman-collections.md) que puedes usar para replicar los casos de uso de forma local.

## Resumen de los pasos

El proceso para recibir un reporte con Yuno se compone de tres pasos:

1. [Create a Report](https://docs.y.uno/reference/reports/create-a-report.md)
2. [Verificar si el reporte está listo](https://docs.y.uno/reference/reports/retrieve-a-report.md)
3. [Download a Report](https://docs.y.uno/reference/reports/download-a-report.md)

## Acceder a un reporte

Como se muestra en el resumen de los pasos, debes completar tres pasos antes de acceder a tu reporte.

### Paso 1: crear un reporte

Para iniciar el proceso de generación del reporte, solicita a Yuno que cree el reporte con el [endpoint Create a Report](https://docs.y.uno/reference/reports/create-a-report.md). Primero, selecciona el tipo de reporte deseado (`type`), que determinará el contenido del reporte generado. Luego, define el rango de fechas de los datos que quieres incluir en el reporte con los parámetros `start_date` y `end_date`.

Al crear el reporte, puedes filtrar los datos incluidos especificando los valores de algunos campos. Por ejemplo, puedes recibir solo los datos de las transacciones realizadas en Argentina y Brasil. En ese caso, enviarías el contenido `AR,BR` en el parámetro `country`.

Tienes la opción de filtrar los siguientes campos al crear el reporte:

* `payment_status`
* `payment_sub_status`
* `payment_method`
* `currency`
* `country`
* `transaction_type`
* `transaction_status`
* `updated_at_start`
* `updated_at_end`

> [!NOTE]
>
> **Formato de los valores de filtro**
>
> Al definir los valores de filtro, envíalos como una lista de valores en una cadena de texto, como en el siguiente ejemplo:
> `"payment_status": "CREATED,READY_TO_PAY,DECLINED"`

En los reportes Payment, Transaction o Settlement Payouts, también puedes seleccionar los campos que se incluyen en el reporte final con el parámetro `columns`. En el reporte Settlement Payouts, `columns` reemplaza la selección de columnas predeterminada en lugar de ampliarla.

Cuando usas el [endpoint Create a Report](https://docs.y.uno/reference/reports/create-a-report.md) para solicitar la creación de un reporte, en la respuesta recibirás el `id` y el `status` del reporte. Usarás el `id` al solicitar la descarga del reporte en el [Paso 3](https://docs.y.uno/es/docs/direct-integration-use-cases/build-reports.md#step-3-download-your-report). El `status` indica si está listo para descargar.

### Paso 2: verificar si el reporte está listo

Después de solicitar la creación del reporte, puedes usar los endpoints [Retrieve a Report](https://docs.y.uno/reference/reports/retrieve-a-report.md) o [List All Reports](https://docs.y.uno/reference/reports/list-all-reports.md) para verificar si está listo para descargar. Al usar el [endpoint Retrieve a Report](https://docs.y.uno/reference/reports/retrieve-a-report.md), debes enviar el `id` del reporte. En cambio, con el [endpoint List All Reports](https://docs.y.uno/reference/reports/list-all-reports.md), debes indicar tu `account_id` para recibir una lista de todos los reportes existentes y su estado.

Cuando el reporte tenga el estado `SUCCEEDED`, puedes solicitar su descarga. Consulta la [página Report status](https://docs.y.uno/reference/reports/report-status.md) para ver todos los estados posibles de un reporte.

### Paso 3: descargar tu reporte

Usa [Download a Report](https://docs.y.uno/reference/reports/download-a-report.md) para recibir tu reporte enviando su `id`. Recibirás el reporte en un archivo .zip. Sin embargo, en los reportes de liquidaciones (Settlement), la API devolverá un archivo .csv.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.