Recursos Cross
Confira os principais recursos das nossas APIs
Documentação
Você pode usar esta documentação para as seguintes unidades de negócio:
Dados para emissão de Nota Fiscal
Consultar os dados para faturamento
Para obter as informações do comprador (endereço, documento) para emissão da nota fiscal. Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$ORDER_ID/billing_info
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/1691789796/billing_info
As orders do Mercado Libre Argentina e Brasil retornam dados de faturamento nas seguintes condições:
- Produtos com Fullfillment ou CrossDocking
- Produtos de Lojas Oficiais, Mercado Lideres.
- Produtos com Global Selling.
- Compras com Garex.
Resposta (os exemplos são de pessoa física e pessoa jurídica) MLB - Pessoa Física
Order Id: 1691812163
User id: 316452397
{
"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"
}
}
MLB - Pessoa Jurídica
Order Id: 1691816147
User id: 316452397
{
"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 e valores para additional_info
Esses são os tipos e valores (type/value) possível para additional_info.
Pessoa física
- first_name: nome do comprados
- last_name: sobrenome do comprador
- doc_type: tipo do documento
- doc_number: numero do documento
- zip_code: código postal do comprador
- street_name: endereço do comprador
- street_number: numero endereço do comprador
Pode ser "SN" para casos de rua sem numero
- comment: comentário extra sobre endereço do comprador
- state_name: estado do comprador
- city_name: cidade do comprador
- secondary_doc_type : tipo do documento adicional (solo para MLA)
- secondary_doc_number: numero de documento adicional (solo para MLA)
Pessoa jurídica
Para MLA:
-Monotributo
-IVA Responsable Inscripto
-IVA Exento
Para MLB:
-Contribuinte
-Não contribuinte
Pode ser "SN" para casos de rua sem número
DOC_TYPE's
Argentina (MLA): DNI, CUIT.
Brasil (MLB): CPF, CNPJ.
Chile (MLC): RUT.
Colombia (MCO): CC, CE, NIT.
Venezuela (MLV): CI, RIF, Pasaporte.
Uruguay (MLU): CI, RUT.
Perú (MPE): DNI, CE.