Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Descarga de Factura
Descargar Factura en PDF
Para acceder a las facturas en formato PDF utiliza el siguiente recurso, informando el ORDER_ID de la venta. También puedes buscar directo por el INVOICE_ID, reemplazando /order/$ORDER_ID por /invoice/$INVOICE_ID.
https://api.mercadolibre.com/invoices/io/documents/stream/order/$ORDER_ID/pdf
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/invoices/io/documents/stream/order/$ORDER_ID/pdf
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/invoices/io/documents/stream/order/2000065432198754/pdf
Respuesta:
Ejemplo de factura retornada. Los datos personales y fiscales han sido ofuscados — la imagen tiene como objetivo ilustrar el formato del documento.
Para las consultas con ORDER_ID puedes informar el transaction_type para obtener el documento fiscal correspondiente al tipo de operación. El tipo de documento generado depende del valor informado:
Cuando el transaction_type es sale, disposal_sale o loan, el documento emitido será una Factura — el campo document_type retornará factura.
Cuando el transaction_type es devolution o disposal_sale_return, el documento emitido será una Nota de Crédito — el campo document_type retornará nota_de_credito.
Ejemplo de llamada con transaction_type:
Puedes obtener el valor de transaction_type consultando la factura en formato JSON — el campo se encuentra dentro del objeto fiscal_data en la respuesta.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/invoices/io/documents/stream/order/2000065432198754/pdf?transaction_type=sale
Descargar Factura en XML
Para acceder a las facturas en formato XML utiliza el siguiente recurso. También puedes buscar directo por el INVOICE_ID, reemplazando /order/$ORDER_ID por /invoice/$INVOICE_ID.
https://api.mercadolibre.com/invoices/io/documents/stream/order/$ORDER_ID/xml
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/invoices/io/documents/stream/order/$ORDER_ID/xml
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/invoices/io/documents/stream/order/2000065432198754/xml
Respuesta:
<?xml version="1.0" encoding="UTF-8"?>
<cfdi:Comprobante xmlns:cfdi="http://www.sat.gob.mx/cfd/4" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Version="4.0" xsi:schemaLocation="http://www.sat.gob.mx/cfd/4 http://www.sat.gob.mx/sitio_internet/cfd/4/cfdv40.xsd" Serie="SMI" Folio="88776655" Fecha="2026-03-16T11:45:20" Sello="DATA_SELLO_FICTICIO_123" FormaPago="04" NoCertificado="00001000000599999999" Certificado="DATA_CERTIFICADO_FICTICIO_ABC" SubTotal="1000.00" Moneda="MXN" Total="1160.00" TipoDeComprobante="I" Exportacion="01" MetodoPago="PUE" LugarExpedicion="06000">
<cfdi:Emisor Rfc="VEM120815ABC" Nombre="VENTAS EN LINEA MEXICO S.A. DE C.V." RegimenFiscal="601"/>
<cfdi:Receptor Rfc="GOMA850312XYZ" Nombre="MARIO GOMEZ MARTINEZ" DomicilioFiscalReceptor="06000" RegimenFiscalReceptor="605" UsoCFDI="G03"/>
<cfdi:Conceptos>
<cfdi:Concepto ClaveProdServ="43211708" NoIdentificacion="7501000123456" ObjetoImp="02" Cantidad="1" ClaveUnidad="H87" Unidad="UN" Descripcion="Mouse Inalámbrico Ergonómico - Negro" ValorUnitario="400.00" Importe="400.00">
<cfdi:Impuestos>
<cfdi:Traslados>
<cfdi:Traslado Base="400.00" Impuesto="002" TipoFactor="Tasa" TasaOCuota="0.160000" Importe="64.00"/>
</cfdi:Traslados>
</cfdi:Impuestos>
</cfdi:Concepto>
<cfdi:Concepto ClaveProdServ="43212002" NoIdentificacion="7501000654321" ObjetoImp="02" Cantidad="1" ClaveUnidad="H87" Unidad="UN" Descripcion="Teclado Numérico USB Externo" ValorUnitario="600.00" Importe="600.00">
<cfdi:Impuestos>
<cfdi:Traslados>
<cfdi:Traslado Base="600.00" Impuesto="002" TipoFactor="Tasa" TasaOCuota="0.160000" Importe="96.00"/>
</cfdi:Traslados>
</cfdi:Impuestos>
</cfdi:Concepto>
</cfdi:Conceptos>
<cfdi:Impuestos TotalImpuestosTrasladados="160.00">
<cfdi:Traslados>
<cfdi:Traslado Base="1000.00" Impuesto="002" TipoFactor="Tasa" TasaOCuota="0.160000" Importe="160.00"/>
</cfdi:Traslados>
</cfdi:Impuestos>
<cfdi:Complemento>
<tfd:TimbreFiscalDigital xmlns:tfd="http://www.sat.gob.mx/TimbreFiscalDigital" FechaTimbrado="2026-03-16T11:46:05" UUID="D1E2F3A4-B5C6-4D7E-8F9A-0B1C2D3E4F5A" NoCertificadoSAT="00001000000704859748" SelloCFD="SELLO_CFD_FICTICIO" SelloSAT="SELLO_SAT_FICTICIO" Version="1.1" RfcProvCertif="TLE011122SC2" xsi:schemaLocation="http://www.sat.gob.mx/TimbreFiscalDigital http://www.sat.gob.mx/sitio_internet/cfd/TimbreFiscalDigital/TimbreFiscalDigitalv11.xsd"/>
</cfdi:Complemento>
</cfdi:Comprobante>