- Payment
- Transaction
- Payouts
- Settlements & Fees
- Reconciliation Overview
- Communications
- Settlement Payouts
Requisitos
Para solicitar un reporte, necesitas:- Acceder a tus credenciales de API en el Yuno Dashboard, que constan de:
public-api-keyprivate-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: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_statuspayment_sub_statuspayment_methodcurrencycountrytransaction_typetransaction_statusupdated_at_startupdated_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"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 elid 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 suid. Recibirás el reporte en un archivo .zip. Sin embargo, en los reportes de liquidaciones (Settlement), la API devolverá un archivo .csv.