Recursos Cross
Confira os principais recursos das nossas APIs
Documentação do
Você pode usar esta documentação para as seguintes unidades de negócio:
Última atualização em 08/04/2025
Dados para emissão de Nota Fiscal
Consultar os dados para faturamento
Para obter as informações do comprador para emissão da nota fiscal. Chamada:
curl -X GET \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-H 'x-version:2' \
https://api.mercadolibre.com/orders/$ORDER_ID/billing_info
Exemplo:
curl -X GET \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-H 'x-version:2' \
https://api.mercadolibre.com/orders/1691789796/billing_info
Resposta com os exemplos de pessoa física e pessoa jurídica.
MLB - Pessoa 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 - Pessoa 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,
}}
MLA - Pessoa 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 - Pessoa 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,
}
MLM - Pessoa 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 - Pessoa 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 - Pessoa 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 - Pessoa 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 - Pessoa Física
{
"site_id": "MCO",
"buyer": {
"cust_id": 234343545,
"billing_info": {
"name": "Adrian",
"last_name": "Garces",
"identification": {
"type": "CC",
"number": "73160000"
},
"address": {
"street_name": "Pasaje Beethoven",
"street_number": "#10-11",
"city_name": "La Candelaria",
"comment": "73",
"neighborhood": "Candelaria",
"state": {
"name": "RM (Metropolitana)",
"code": "CO-DC"
},
"country_id": "CO"
},
},
"seller": {
"cust_id": 34345454,
}
}
MCO - Pessoa Jurídica
{
"site_id": "MCO",
"buyer": {
"cust_id": 234343545,
"billing_info": {
"name": "Apple",
"identification": {
"type": "CC",
"number": "73160000"
},
"address": {
"street_name": "Pasaje Beethoven",
"street_number": "#10-11",
"city_name": "La Candelaria",
"comment": "73",
"neighborhood": "Candelaria",
"state": {
"name": "RM (Metropolitana)",
"code": "CO-DC"
},
"country_id": "CO"
},
"attributes": {
"is_normalized": true
}
}
},
"seller": {
"cust_id": 34345454,
}
MEC - Pessoa 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 - Pessoa 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,
}
}
MPE - Pessoa Física e Pessoa Jurídica
{
"buyer": {
"cust_id": "325999999",
"billing_info": {
"identification": {
"type": "DNI",
"number": "70999999"
},
"attributes": {
"normalized": "false",
"is_vat_discriminated_billing": false,
"is_new_billing_info": false
}
}
},
"seller": {
"cust_id": "1469999999"
},
"buyer_id": 325999999,
"seller_id": 1469999999,
"is_order_origin": false
}
MLU - Pessoa Física
{
"buyer": {
"cust_id": "1921961891",
"billing_info": {
"identification": {
"type": "CI",
"number": "64856596"
},
"attributes": {
"normalized": "false",
"is_vat_discriminated_billing": false,
"is_new_billing_info": false
}
}
},
"seller": {
"cust_id": "293733309"
},
"buyer_id": 1921961891,
"seller_id": 293733309,
"is_order_origin": false
}
MLU - Pessoa Jurídica
{
"buyer": {
"cust_id": "1934756972",
"billing_info": {
"identification": {
"type": "RUT",
"number": "215191230015"
},
"attributes": {
"normalized": "false",
"is_vat_discriminated_billing": false,
"is_new_billing_info": false
}
}
},
"seller": {
"cust_id": "293733309"
},
"buyer_id": 1934756972,
"seller_id": 293733309,
"is_order_origin": false
}
Descrição dos campos da API
Pessoa física
- site_id: ID do site
- buyer:
- cust_id: ID do comprador
- billing_info:
- name: nome do comprador
- last_name: sobrenome do comprador
- identification:
- type: tipo de documento
- number: número do documento
- taxes:
- inscriptions:
- state_registration: registro estadual
- economic_activity: atividade econômica
- contributor: tipo de contribuinte
- taxpayer_type:
- id: identificador da entidade
- description: situação fiscal do comprador
- inscriptions:
- address:
- street_name: nome da rua do comprador
- street_number: número do endereço do comprador
- city_name: nome da cidade do comprador
- neighborhood: nome do bairro do comprador
- zip_code: código postal do comprador
- comment: informação adicional sobre o endereço do comprador
- country_id: ID do país
- state:
- code: código do estado
- name: nome do estado
- secondary_doc_type: tipo de documento adicional (somente para MLA)
- secondary_doc_number: número do documento adicional (somente para MLA)
- attributes:
- birth_date: data de nascimento do comprador
- doc_type_number: número do documento do comprador
- cust_type: pessoa jurídica ou física
- seller:
- cust_id: ID do vendedor
Os valores CO ou BU, quando estão presentes no campo cust_type
, significam:
CO: Cliente
BU: Empresa
Pessoa jurídica
- business_name: nome da entidade jurídica compradora
- taxpayer_type_id: posição da entidade jurídica em relação ao IVA
Para MLA:
- Monotributo
- IVA Responsável Inscrito
- IVA Isento
Para MLB:
- Contribuinte
- Não contribuinte
- state_registration: registro estadual
- doc_type: tipo de documento
- doc_number: número do documento
- zip_code: código postal do comprador
- street_name: nome da rua do endereço de faturamento do comprador
- street_number: número da rua do endereço de faturamento do comprador
Valores possíveis: cadeia, "SN" para casos de endereço sem número
- comment: informação adicional do endereço de faturamento do comprador
- state_name: estado do endereço de faturamento do comprador
- city_name: cidade do endereço de faturamento do comprador
DOC_TYPE's:
- Brasil (MLB):
- Pessoa física: CPF, RG
- Pessoa jurídica: CNPJ
- Argentina (MLA):
- Pessoa física: DNI, CUIL
- Pessoa jurídica: CUIT
- Chile (MLC):
- Pessoa física: RUT
- Pessoa jurídica: RUT
- Colômbia (MCO):
- Pessoa física: CC, CE
- Pessoa jurídica: NIT
- México (MLM):
- Pessoa física: RFC, CURP
- Pessoa jurídica: RFC
- Equador (MEC):
- Pessoa física: CI
- Pessoa jurídica: RUC
- Uruguai (MLU):
- Pessoa física: CI
- Pessoa jurídica: RUT
- Peru (MPE):
- Pessoa física: DNI
- Pessoa jurídica: CE