Generar reporte - Liberaciones - Mercado Pago Developers

¿Cómo generar tu reporte de Liberaciones?

Canales de generación

Puedes generar un reporte de Liberaciones desde tu cuenta de Mercado Pago:

CanalesDescripción
Panel de Mercado PagoPara generar manualmente un reporte desde tu panel de Mercado Pago, ve a Reportes y elige la opción de "Ver reportes creados".

Sigue el paso a paso para generar reportes desde el panel.
Integración vía APIPara generar manualmente un reporte o programar la frecuencia de uno según tus necesidades, utiliza nuestra integración vía API.

Lee la documentación para generar reportes por API.

Características técnicas del reporte

Ten en cuenta la siguiente información técnica cuando quieras generar tus reportes.

Estructura del reporte

Conoce las características de los elementos que conforman tu reporte.

Elemento o acciónCaracterísticas
Detalle de tablasEl detalle de las tablas comprende información generada en día 1 como mínimo.
Orden de columnasFijo
Período máximoReportes con datos de hasta 60 días.
MonedaLocal (basada en el país donde esté registrada la cuenta de Mercado Pago)
Zona horaria de las columnas con fechasGMT-4

Toma como referencia el lugar desde el que se descarga el reporte.
Selección de fechas vía webDebe basarse en el timezone de la cuenta.
Por ejemplo, a la cuenta registrada en Brasil le corresponde el timezone de São Paulo.

Exportación del reporte

Considera estas opciones a la hora de descargar tu reporte:

Elemento o acciónCaracterísticas
Formato del nombre del archivoCuando el reporte es programado o manual:
"prefijo-configurable-fecha-de-creación.csv"
Ejemplo: mitienda-28-05-2019.csv
Formatos de descarga.csv, .xlsx

Tip: descarga el reporte en .csv para importar los datos y usarlos en otras aplicaciones. Descárgalo en .xlsx para leer la información en las tablas de la hoja de cálculo.
ArchivoLos reportes generados quedan guardados en tu cuenta de Mercado Pago.

Notificaciones

Webhook

Webhook (también conocido como devolución de llamada web) es un método simple que facilita que una aplicación o sistema proporcione información en tiempo real cada vez que ocurre un evento, es decir, es una forma de recibir datos pasivamente entre dos sistemas a través de un HTTP POST. Para el caso de los reportes que se utilizan para conciliar se enviará una notificación al usuario que tenga configurado este servicio cuando sus archivos sean generados.

AtributoDescripción
transaction_idID de la transacción
request_dateFecha de la solicitud
generation_dateFecha de la generación
filesArchivos disponibles
typeFormato del archivo
urlEnlace de descarga
nameNombre del archivo
statusEstado del reporte
creation_typeCreación manual o programada
report_typeTipo de reporte
is_testDefine si es una prueba
signatureFirma de la notificación

Contraseña para cifrado

Para hacer seguro el proceso de notificación hacia el sistema se enviará en el cuerpo del mensaje (payload) un atributo llamado Signature, con el objetivo de validar que la notificación Webhook se haya originado desde Mercado Pago y no se trate de una suplantación.

El Signature se construye uniendo el transaction_id con la contraseña para cifrado configurada en la sección de Notificación por Webhook, más el generation_date del reporte. Una vez concatenados los valores se cifran haciendo uso del algoritmo BCrypt de la siguiente manera:

signature = BCrypt(transaction_id + '-' + password_for_encryption + '-' + generation_date)

Para validar que sea Mercado Pago quien emitió la notificación se debe usar la función de verificación que ofrece el algoritmo de BCrypt para el lenguaje deseado.

Ejemplo Java:

BCrypt.checkpw(transaction_id + '-' + password_for_encryption + '-' + generation_date, payload_signature)

Ten a mano el Glosario del reporte de Liberaciones para revisarlo cuando lo necesites o quieras consultar algún término técnico.
Próximamente verás los registros de tus movimientos en orden cronológico.
En los reportes que generes a partir de Diciembre vas a ver todos tus movimientos en el orden en que se realizaron para que puedas identificarlos más fácil y controlar mejor tus ventas.

Próximos pasos