Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 21/03/2024

Te compartimos un paso a paso para descargar las facturas legales de Mercado Libre y Mercado Pago en formato PDF. Debes obtener el file_id consultando el endpoint de /documents. En algunos casos, puedes recibir dos file_id. Solo en estos casos hay que tener en cuenta debes utilizar el file_id correspondiente al PDF.
Si el endpoint devuelve un único file_id, entonces debes utilizar ese dato para la descarga del 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: primero se genera el reporte de conciliación, luego hay que consultar el estado de generación del mismo hasta que se encuentre generado y finalmente se procede a la descarga.



  1. Generación del reporte
  2. Llamada para MLM:

    curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...}
      https://api.mercadolibre.com/billing/integration/periods/$EXPIRATION_DATE/reports

    Llamada para MLA, MLB, MCO, MLC, MLU, MPE, MLV y MCR:

    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 para MLA, MLB, MCO, MLC, MLU, MPE, MLV y MCR:

    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:

    • 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

    Respuesta:

    "fileId": "ML-report-BILL-2021-08-01-11119999-CSV-v2"
  3. Estado de generación de reporte
  4. Los estados pueden ser:

    • 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.

    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-repo rt-BILL-2021-08-04-11119999-CSV-v2/status?document_type=BILL
    

    Respuesta:

    {
    "status": "PROCESSING"
    }
    
  5. Descarga del reporte: esta descarga podrá ser efectiva una vez que el estado de la generación sea ready.

  6. 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-repo rt-BILL-2021-08-04-11119999-CSV-v2?document_type=BILL
    

    Siguiente: Percepciones.