Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.Documentación
Descarga de documento legal
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/legal_document/$FILE_ID
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/legal_document/1234_FE_MEPF00869625_pdf
Respuesta: descarga del archivo en formato PDF.
Descarga reporte de conciliación
Para descargar los reportes de conciliación de Mercado Libre, Mercado Envíos Flex, Insurtech y Mercado Pago en los formatos XLSX y CSV hay que seguir un proceso de generación del reporte. Ese mismo proceso se aplica al reporte de Fulfillment y al reporte de Pagos, que solo admiten el formato de descarga XLSX.
El proceso de generación del reporte consiste en tres pasos:
- Generación del reporte
- ML para reporte de ML
- MP para reporte de MP
- FLEX para reporte de Flex
- FULL para reporte de Fulfillment
- INSURTECH para reporte de Insurtech
- PAYMENT para reporte de pagos
- Estado de generación de reporte
- PROCESSING: el reporte se está generando.
- READY: el reporte se terminó de generar.
- ERROR: la generación del reporte falló, se debe volver a consultar.
- Descarga del reporte
Llamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...}
https://api.mercadolibre.com/billing/integration/periods/key/$KEY/reports
Ejemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
-d {
"group": "ML",
"document_type": "BILL",
"report_format": "CSV"
}
https://api.mercadolibre.com/billing/integration/periods/key/2021-08-01/reports
El parámetro group varía según el reporte que quieras generar:
Respuesta:
"fileId": "ML-report-BILL-2021-08-01-11119999-CSV-v2"
Los estados pueden ser:
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/reports/$FILE_ID/status
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/reports/ML-report-BILL-2021-08-04-11119999-CSV-v2/status?document_type=BILL
Respuesta:
{
"status": "PROCESSING"
}
Esta descarga podrá ser efectiva una vez que el estado de la generación sea Ready.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/reports/$FILE_ID
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/reports/ML-report-BILL-2021-08-04-11119999-CSV-v2?document_type=BILL
Siguiente: Percepciones.