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

Importante:
Los valores disponibles de transaction_type pueden variar según el site. La lista anterior aplica a MLC (Chile). 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="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>