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 boleta 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 o disposal_sale, el documento emitido podrá ser una Factura o una Boleta, según el perfil fiscal del comprador — el campo document_type retornará factura o boleta.
Cuando el transaction_type es service, el documento emitido será una Boleta de Honorarios — el campo document_type retornará boleta_honorario.
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_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="ISO-8859-1"?>
<EnvioBOLETA xmlns="http://www.sii.cl/SiiDte" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.0" xsi:schemaLocation="http://www.sii.cl/SiiDte EnvioBOLETA_v11.xsd">
<SetDTE ID="SetDoc">
<Caratula version="1.0">
<RutEmisor>88888888-8</RutEmisor>
<RutEnvia>12345678-9</RutEnvia>
<RutReceptor>60803000-K</RutReceptor>
<FchResol>2020-05-20</FchResol>
<NroResol>150</NroResol>
<TmstFirmaEnv>2026-03-16T10:30:45</TmstFirmaEnv>
<SubTotDTE>
<TpoDTE>39</TpoDTE>
<NroDTE>1</NroDTE>
</SubTotDTE>
</Caratula>
<DTE version="1.0">
<Documento ID="DTE_Ficticio_39_55443322">
<Encabezado>
<IdDoc>
<TipoDTE>39</TipoDTE>
<Folio>55443322</Folio>
<FchEmis>2026-03-16</FchEmis>
<IndServicio>3</IndServicio>
<IndMntNeto>2</IndMntNeto>
</IdDoc>
<Emisor>
<RUTEmisor>88888888-8</RUTEmisor>
<RznSocEmisor>Distribuidora de Tecnologia S.A.</RznSocEmisor>
<GiroEmisor>VENTA AL POR MENOR DE ARTICULOS ELECTRONICOS E INFORMATICA</GiroEmisor>
<DirOrigen>Avenida Providencia 2500, Oficina 401</DirOrigen>
<CmnaOrigen>Providencia</CmnaOrigen>
<CiudadOrigen>Santiago</CiudadOrigen>
</Emisor>
<Receptor>
<RUTRecep>15555666-4</RUTRecep>
<RznSocRecep>Carlos Alberto Silva</RznSocRecep>
<DirRecep>Calle Los Alamos 456</DirRecep>
<CmnaRecep>Concepcion</CmnaRecep>
<CiudadRecep>Concepcion</CiudadRecep>
</Receptor>
<Totales>
<MntNeto>100000</MntNeto>
<IVA>19000</IVA>
<MntTotal>119000</MntTotal>
<MontoNF>0</MontoNF>
<TotalPeriodo>119000</TotalPeriodo>
</Totales>
</Encabezado>
<Detalle>
<NroLinDet>1</NroLinDet>
<NmbItem>Monitor Gamer UltraWide 34 Pulgadas</NmbItem>
<QtyItem>1</QtyItem>
<UnmdItem>UN</UnmdItem>
<PrcItem>100000</PrcItem>
<MontoItem>100000</MontoItem>
</Detalle>
<TED version="1.0">
<DD>
<RE>88888888-8</RE>
<TD>39</TD>
<F>55443322</F>
<FE>2026-03-16</FE>
<RR>15555666-4</RR>
<RSR>Carlos Alberto Silva</RSR>
<MNT>119000</MNT>
<IT1>Monitor Gamer UltraWide 34 Pulgadas</IT1>
<CAF version="1.0">
<DA>
<RE>88888888-8</RE>
<RS>DISTRIBUIDORA DE TECNOLOGIA S.A.</RS>
<TD>39</TD>
<RNG>
<D>55000000</D>
<H>56000000</H>
</RNG>
<FA>2026-01-10</FA>
<RSAPK>
<M>v8KjA...[VALOR_FICTICIO]...w9Z==</M>
<E>Aw==</E>
</RSAPK>
<IDK>500</IDK>
</DA>
<FRMA algoritmo="SHA1withRSA">abc123DEF456...[ASSINATURA_SIMULADA]...==</FRMA>
</CAF>
<TSTED>2026-03-16T10:30:45</TSTED>
</DD>
<FRMT algoritmo="SHA1withRSA">xyz789GHI012...[ASSINATURA_SIMULADA]...==</FRMT>
</TED>
<TmstFirma>2026-03-16T10:30:45</TmstFirma>
</Documento>
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
<SignedInfo>
<CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
<SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/>
<Reference URI="#DTE_Ficticio_39_55443322">
<Transforms>
<Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
</Transforms>
<DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
<DigestValue>dGhpcyBpcyBhIGZha2UgZGlnZXN0dmFsdWU=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>YmFzZTY0X2Zha2Vfc2lnbmF0dXJlX3ZhbHVlX2Zvcl90ZXN0aW5nX3B1cnBvc2VzX29ubHk=</SignatureValue>
<KeyInfo>
<KeyValue>
<RSAKeyValue>
<Modulus>random_modulus_data_here_1234567890abcdefghijklmnopqrstuvwxyz</Modulus>
<Exponent>AQAB</Exponent>
</RSAKeyValue>
</KeyValue>
<X509Data>
<X509Certificate>MII...[CERTIFICADO_FICTICIO]...==</X509Certificate>
</X509Data>
</KeyInfo>
</Signature>
</DTE>
</SetDTE>
</EnvioBOLETA>