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 18/06/2026

Descarga de Factura

El recurso permite obtener las facturas de ventas facturadas por Mercado Libre a través del sistema propio de facturación. Puedes descargarlas en dos formatos: PDF o XML.

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.

Importante:
Los valores disponibles de transaction_type pueden variar según el site. La lista anterior aplica a MLM (México). Consulta la documentación específica de tu site para conocer los tipos disponibles.

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>