Developers

Documentación Mercado Libre

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

Última actualización 19/04/2024

Datos de facturación

Importante:

- Para obtener la respuesta con la nueva versión, envía el header 'x-version: 2'
- Este cambio para v2 impacta solamente a MLA, MLB, MLM, MLC, MCO y MEC, los otros sites (MLU, MPE, MLV) siguen con la primera version del recurso.
- En breve eliminaremos la versión anterior del recurso de /billing_info para los sitios mencionados anteriormente.
- Para MEC es la primera vez que publicamos este recurso, por lo tanto no es necesario reemplazar la versión anterior, sólo adoptar la nueva.

Para realizar la facturación de una venta es necesario tener los datos del comprador que se encuentran disponibles dentro del recurso de Orders, más específicamente /orders/order_id/billing_info.

Consultar los datos de facturación

Para obtener la información cargada en una orden respecto de los datos de facturación de un comprador deberás hacer la siguiente llamada. Llamada:

curl -X GET \
  -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'x-version:2' \
  https://api.mercadolibre.com/orders/$ORDER_ID/billing_info

Ejemplo:

curl -X GET \
  -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'x-version:2' \
  https://api.mercadolibre.com/orders/1691789796/billing_info

Respuesta con los ejemplos de persona física y jurídica MLA - Persona Física

{
    "site_id":"MLA",
    "buyer":{
        "cust_id": "123123123"
       "billing_info":{
          "name":"Juan Soares",
          "last_name":"Sanchez",
          "identification":{
             "type":"DNI" / "CUIL",
             "number":"307722738"
          },
          "taxes": {
            "taxpayer_type": {
                "id": "01",
                "description": "Consumidor Final"
            }
          },
          "address":{
             "street_name":"Aysen",
             "street_number":"30",
             "city_name":"Buenos Aires",
             "state":{
                "code": "01",
                "name": "Buenos Aires"
            },
             "zip_code":"5000",
             "country_id":"AR"
          },
          "attributes": {
            "vat_discriminated_billing": "true",
            "doc_type_number": "123123123",
            "is_normalized": true,
            "cust_type": "CO"
          }
       }
    },
    "seller":{
        "cust_id": 0,
    }

MLA - Persona Jurídica

{
    "site_id":"MLA",
    "buyer":{
        "cust_id": "123123123",
       "billing_info":{
          "name":"Apple Argentina"
          "identification":{
             "type":"CUIT",
             "number":"307722738"
          },
          "taxes": {
            "taxpayer_type": {
                "description": "IVA Responsable Inscripto"
            }
          },
          "address":{
             "street_name":"Aysen",
             "street_number":"30",
             "city_name":"Buenos Aires",
             "state":{
                "code": "01",
                "name": "Buenos Aires"
            },
             "zip_code":"5000",
             "country_id":"AR"
          },
          "attributes": {
            "vat_discriminated_billing": "true",
            "doc_type_number": "123123123",
            "is_normalized": true,
            "cust_type": "BU"
          }
       }
    },
    "seller":{
        "cust_id": 0,
    }

MLB - Persona Física

{
  "site_id": "MLB",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "María Lupita",
      "last_name": "Gomez Blanco",
      "identification": {
        "type": "CPF",
        "number": "32659430" 
      },
      "address": {
        "street_name": "Nicolau de Marcos",
        "street_number": "05",
        "city_name": "Bom Jardim",
        "comment": "7b",
        "neighborhood": "Jardim Ornelas",
        "state": {
          "name": "Rio de Janeiro"
        },
        "zip_code": "28660000",
        "country_id": "BR"
      },
      "attributes": {
          "is_normalized": true,
          "cust_type": "CO"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }}

MLB - Persona Jurídica

{
  "site_id": "MLB",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Apple Brasil",
   "identification": {
        "type": "CNPJ",
        "number": "326594309119203" 
      },
      "taxes": {
        "inscriptions": 
         {
            "state_registration": "30703088534",
         }
        , 
        "taxpayer_type": {
          "description": "Contribuinte" 
        }
      },
      "address": {
        "street_name": "Nicolau de Marcos",
        "street_number": "05",
        "city_name": "Bom Jardim",
        "comment": "7b",
        "neighborhood": "Jardim Ornelas",
        "state": {
          "name": "Rio de Janeiro"
        },
        "zip_code": "28660000",
        "country_id": "BR"
      },
      "attributes": {
          "is_normalized": true,
          "cust_type": "BU"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }}

MLM - Persona Física

{
  "site_id": "MLM",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Juan Soraes",
   "last_name": "Sanchez"	
      "identification": {
        "type": "RFC",
        "number": "CUPU800825569"
      },
      "taxes": {
        "contributor": "PERSONA FÍSICA",
        "taxpayer_type": {
          "id": "606",
          "description": "Arrendamiento"
        },
        "cfdi": {
          "id": "G03",
          "description": "Gastos en general"
        }
      },
      "address": {
        "street_name": "Calle 134A #18A",
        "street_number": "05",
        "city_name": "Alvaro Obregón",
        "state": {
          "code": "DIF",
          "name": "Distrito Federal"
        },
        "zip_code": "01040",
        "country_id": "MX"
      },
      "attributes": {
        "vat_discriminated_billing": "true",
        "birth_date": "2000/02/03",
        "is_normalized": true,
        "customer_type": "CO"
      }
    }
  },
  "seller": {
    "cust_id": 34345454  }}

MLM - Persona Jurídica

{
  "site_id": "MLM",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "SALVADO HNOS S A",
      "identification": {
        "type": "RFC",
        "number": "CUPU800825569"
      },
      "taxes": {
        "contributor": "PERSONA MORAL",
        "taxpayer_type": {
          "id": "606",
          "description": "Arrendamiento"
        },
        "cfdi": {
          "id": "G03",
          "description": "Gastos en general"
        }
      },
      "address": {
        "street_name": "Calle 134A #18A",
        "street_number": "05",
        "city_name": "Alvaro Obregón",
        "state": {
          "code": "DIF",
          "name": "Distrito Federal"
        },
        "zip_code": "01040",
        "country_id": "MX"
      },
      "attributes": {
        "vat_discriminated_billing": "true",
        "birth_date": "2000/02/03",
        "is_normalized": true,
        "customer_type": "BU"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
 }
}

MLC - Persona Física

{
    "site_id": "MLC",
    "buyer": {
      "cust_id": 234343545,
      "billing_info": {
        "name": "Tamara nicolt",
        "last_name": "larenas reyes",
        "identification": {
          "type": "RUT",
          "number": "159321126"
        },
     "address": {
          "street_name": "Pasaje Beethoven",
          "street_number": "56",
          "city_name": "Maipú",
          "comment": "73",
          "neighborhood": "Maipú",
          "state": {
            "name": "RM (Metropolitana)"
          },
          "country_id": "CL"
        },
        "attributes": {
          "is_normalized": true,
           "cust_type": "CO"
       }
      }
    },
    "seller": {
      "cust_id": 34345454,
    }
  }

MLC - Persona Jurídica

{
    "site_id": "MLC",
    "buyer": {
      "cust_id": 234343545,
      "billing_info": {
        "name": "Apple",
        "identification": {
          "type": "RUT",
          "number": "159321126"
        },
        "taxes": {
           "economic_activity": "Vta.y arrdo artcls Electrónico",
        },
        "address": {
          "street_name": "Pasaje Beethoven",
          "street_number": "56",
          "city_name": "Maipú",
          "comment": "73",
          "neighborhood": "Maipú",
          "state": {
            "name": "RM (Metropolitana)"
          },
          "country_id": "CL"
        },
        "attributes": {
          "is_normalized": true,
      "cust_type": "BU" 
       }
      }
    },
    "seller": {
      "cust_id": 34345454,
    }
  }

MCO - Persona Física

{
  "site_id": "MCO",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Adrian",
      "last_name": "Garces",
      "identification": {
        "type": "CC",
        "number": "73160000"
      },
      "address": {
        "country_id": "CO"
      },
  },
  "seller": {
    "cust_id": 34345454,
  }
}

MCO - Persona Jurídica

{
  "site_id": "MCO",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Apple",
      "identification": {
        "type": "CC",
        "number": "73160000"
      },
      "address": {
        "country_id": "CO"
      },
      "attributes": {
        "is_normalized": true
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }

MEC - Persona Física

{
  "site_id": "MEC",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Adrian",
      "last_name": "Garces",
      "identification": {
        "type": "RUC" / "CI",
        "number": "1711168979001"
      },
      "address": {
        "country_id": "EC"
      },
      "attributes": {
        "is_normalized": true
    "email":"test_user_937841642@testuser.com"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }
}

MEC - Persona Jurídica

{
  "site_id": "MEC",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Apple",
      "identification": {
        "type": "RUC",
        "number": "1711168979001"
      },
      "address": {
        "country_id": "EC"
      },
      "attributes": {
        "is_normalized": true
    	 "email":"test_user_937841642@testuser.com"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }
}

Tipos y valores

site_id : Id del site

buyer:

cust_id: Id del comprador

billing_info:

name: nombre del comprador
last_name: apellido del comprador
identification:
- type: tipo de documento
- number: número del documento

taxes:

Inscriptions:

state_registration: registro estatal

economic_activity: actividad económica
contributor: tipo de contribuyente
taxpayer_type

id:
description: situación fiscal del comprador

address:

street_name: nombre de la calle del comprador
street_number: dirección del comprador
city_name: nombre de la ciudad del comprador
neighbhood: nombre del barrio del comprador
zip_code: código postal del comprador
comment: comentario adicional sobre la dirección del comprador
country_id: ID del país
state:

code: código del estado
name: nombre del estado

attirbutes:

birth_date: cumpleaños del comprador
doc_type_number: número del documento
cust_type: tipo de persona (persona jurídica o física)

seller:

birth_date: cust_id: Id del vendedor

Los valores CO o BU del campo cust_type significan:
- CO : Customer
- BU : Business

Consultar los datos de facturación para MLU, MPE y MLV

Para consultar los datos de facturacion en MLU, MPE y MLV deberan seguir utilizando la primera version del recurso, sin agregar ningun header. Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$ORDER_ID/billing_info

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/1691789796/billing_info

Respuesta: Persona Física
Order Id: 1691789796
User id: 316440831

{
  "billing_info": {
    "additional_info": [
      {
        "type": "STREET_NAME",
        "value": "Arias"
      },
      {
        "type": "ZIP_CODE",
        "value": "1430"
      },
      {
        "type": "STREET_NUMBER",
        "value": "3571"
      },
      {
        "type": "CITY_NAME",
        "value": "Saavedra"
      },
      {
        "type": "LAST_NAME",
        "value": "Gomez Blanco"
      },
      {
        "type": "SITE_ID",
        "value": "MLA"
      },
      {
        "type": "COMMENT",
        "value": "7b"
      },
      {
        "type": "DOC_NUMBER",
        "value": "32659430"
      },
      {
        "type": "DOC_TYPE",
        "value": "DNI"
      },
      {
        "type": "STATE_NAME",
        "value": "Capital Federal"
      },
      {
        "type": "FIRST_NAME",
        "value": "María Lupita"
      },
      {
        "type": "NEIGHBORHOOD",
        "value": "Divino"
      }
    ],
    "doc_number": "32659430",
    "doc_type": "DNI"
  }
}

Persona Jurídica
Order Id: 1691801481
User id: 316440831

{
  "billing_info": {
    "additional_info": [
      {
        "type": "DOC_NUMBER",
        "value": "30703088534"
      },
      {
        "type": "ZIP_CODE",
        "value": "1430"
      },
      {
        "type": "STATE_REGISTRATION",
        "value": "30703088534"
      },
      {
        "type": "TAXPAYER_TYPE_ID",
        "value": "IVA Responsable Inscripto"
      },
      {
        "type": "BUSINESS_NAME",
        "value": "Mercado Libre S.R.L"
      },
      {
        "type": "CITY_NAME",
        "value": "Saavedra"
      },
      {
        "type": "STREET_NAME",
        "value": "Arias"
      },
      {
        "type": "STREET_NUMBER",
        "value": "SN"
      },
      {
        "type": "COMMENT",
        "value": "7b"
      },
      {
        "type": "DOC_TYPE",
        "value": "CUIT"
      },
      {
        "type": "STATE_NAME",
        "value": "Capital Federal"
      },
      {
        "type": "SITE_ID",
        "value": "MLA"
      },
      {
        "type": "NEIGHBORHOOD",
        "value": "Divino"
      },   
 ],
    "doc_number": "30703088534",
    "doc_type": "CUIT"
  }
}

Tipos y valores para additional_info

Estos son los tipos/valores (type/value en additional_info) posibles para distintos actores:

Persona física

first_name: el/los nombre del comprador
last_name: el apellido del comprador
doc_type: el tipo de documento
doc_number: el número de documento
zip_code: el código postal del comprador
street_name: el nombre de la calle del domicilio de facturación del comprador
street_number: la altura de la calle del domicilio de facturación del comprador

Posibles valores: cualquier string, "SN" para casos de calle sin número

comment: piso del domicilio de facturación del comprador
state_name: estado del domicilio de facturación del comprador
city_name: ciudad del domicilio de facturación del comprador
secondary_doc_type : el tipo de documento adicional (solo para MLA)
secondary_doc_number: el número de documento adicional (solo para MLA)

Persona jurídica

business_name: nombre de la entidad jurídica que compra

taxpayer_type_id: posición de la entidad jurídica ante el IVA

Para MLA:
-Monotributo
-IVA Responsable Inscripto
-IVA Exento

Para MLB:
-Contribuinte
-Não contribuinte

state_registration

doc_type: el tipo de documento

doc_number: el número de documento

zip_code: el código postal del comprador

street_name: el nombre de la calle del domicilio de facturación del comprador

street_number: la altura de la calle del domicilio de facturación del comprador

Posibles valores: cualquier string, "SN" para casos de calle sin número

comment: piso del domicilio de facturación del comprador

state_name: estado del domicilio de facturación del comprador

city_name: ciudad del domicilio de facturación del comprador

DOC_TYPE's

Venezuela (MLV): CI, RIF, Pasaporte.

Uruguay (MLU): CI, RUT.

Perú (MPE): DNI, CE.

Nota:

Recomendamos que revise los detalles de todos los descuentos aplicados en una venta. Es posible obtener estos detalles con el recurso /discounts