Recursos Cross

Confira os principais recursos das nossas APIs
circulos azuis em degrade

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

Importante:
  • Para obter a resposta com a nova versão, envie o header 'x-version: 2'.
  • Informamos que a V2 do recurso já está disponível para todos os sites, com exceção de Venezuela.

Para realizar o faturamento de uma venda, são necessários os dados do comprador que estão disponíveis através do recurso Orders, mas especificamente /orders/order_id/billing_info.

Nota:
Os vendedores do Brasil podem criar cupons de desconto para vendas diretas e/ou de carrinho dentro do canal de Marketplace, saiba como faturar essas vendas.

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,
 }
}

Nota:
  • Quando os dados de faturação do comprador indicarem o RFC genérico XAXX010101000, isso significa que o comprador não solicitou uma fatura nominal. Nesse caso, o vendedor terá a liberdade de decidir se vai emitir uma fatura genérica ou uma fatura global.

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