Informes de compilación

Los informes de Yuno proporcionan una manera práctica de adquirir información sobre diferentes etapas de los pagos. Puedes solicitar y descargar sin esfuerzo varios informes asociados con tus operaciones en Yuno. Yuno ofrece cuatro tipos de informes:

• Payment
• Transacción
• Conciliación de transacciones
• Liquidación

Puedes consultar la descripción detallada de cada uno de ellos accediendo a la documentación Campos de los Informes. Los informes Reconciliación de Transacciones y Liquidación proporcionan información relacionada con la reconciliación. Para examinar todos los campos disponibles en cada informe y su descripción, accede a la página Campos de los Informes.

Requisitos

Para solicitar un informe, deberá:

• Accede a tus Credenciales de API en el Yuno Dashboard, que consta de:
  • public-api-key
  • private-secrete-key

📘

Explora Postman Collections de Yuno

Yuno proporciona Postman Collections que puedes usar para replicar los casos de uso localmente.

Resumen de pasos

El proceso para recibir un informe al usar Yuno se compone de dos pasos:

1. Crear un Informe
2. Descargar un Informe

Acceder a un informe

Como se muestra en el resumen de los pasos, debe completar dos pasos antes de acceder a su informe.

Paso 1: Crear un informe

Para iniciar el proceso de generación de informes, pedido a Yuno que cree el informe utilizando la opción Crear un endpoint informe. En primer lugar, seleccione el tipo de informe deseado (type), que determinará el contenido del informe generado. En segundo lugar, defina el intervalo de fechas en el que desea incorporar datos al informe estableciendo los parámetros start_date y end_date.

Al crear el informe, puede filtrar los datos añadidos especificando los valores de algunos campos. Por ejemplo, es posible que desee recibir sólo los datos relativos a las transacciones realizadas en Argentina y Brasil. En este caso, proporcionaría el campo AR,BR contenido del parámetro country.

Tiene la opción de filtrar los siguientes campos al crear el informe:

• payment_status
• payment_sub_status
• payment_method
• currency
• country
• transaction_type
• transaction_status
• updated_at_start
• updated_at_end

📘

Formato de los valores de filtrado

Cuando defina los valores del filtro, proporciónelos en una lista de valores de cadena, como en el ejemplo siguiente: "payment_status": "CREATED,READY_TO_PAY,DECLINED"

Para los informes de pago o transacciones, también tiene la opción de seleccionar los campos incluidos en el informe final mediante el parámetro columns.

Cuando utiliza el Crear un endpoint informe para pedido la creación de un informe, en la respuesta, recibirá el informe id y status. Utilizará el id al solicitar la descarga del informe en Paso 3. La función status informa si está listo para descargar.

Paso 2: Verifique si el informe está listo

Tras solicitar la creación del informe, puede utilizar endpoints Recuperar un Informe o Listar Todos los Informes para comprobar si está listo para su descarga. Cuando utilice el Recuperar un endpoint informedebe proporcionar el informe id. Por otra parte, con la endpoint Listar todos los informesdebe informar a su account_id para recibir una lista de todos los informes existentes y su estado.

Cuando el informe tiene el estado SUCCEEDED, puede solicitar su descarga. Acceder al Página de estado del informe para comprobar todos los posibles estados del informe.

Paso 3: Descargar el informe

Use el endpoint Descargar un Informe para recibir su informe proporcionando su id. Recibirá el informe en un archivo .zip. Sin embargo, para los informes de Liquidación, la API devolverá un archivo .csv.