Saltar al contenido principal
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:
  • 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. 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.

Requisitos

Para solicitar un reporte, necesitas:
  • Acceder a tus credenciales de API en el Yuno Dashboard, que constan de:
    • public-api-key
    • private-secret-key
Explora las colecciones de Postman de YunoYuno ofrece colecciones de Postman 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
  2. Verificar si el reporte está listo
  3. Download a Report

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. 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
Formato de los valores de filtroAl 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 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. 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 o List All Reports para verificar si está listo para descargar. Al usar el endpoint Retrieve a Report, debes enviar el id del reporte. En cambio, con el endpoint List All Reports, 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 para ver todos los estados posibles de un reporte.

Paso 3: descargar tu reporte

Usa Download a Report 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.