Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Datos de facturación
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' 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
Las órdenes de Mercado Libre Argentina y Brasil devuelven datos de facturación bajo las siguientes condiciones:
- Productos con Fullfillment o CrossDocking
- Productos de Tiendas Oficiales, Mercado Lideres.
- Productos con Global Selling.
- Compras con Garex.
Respuesta (los ejemplos son de personas: Física/Jurídica de MLA) MLA - 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"
}
}
MLA - 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
Para MLA:
-Monotributo
-IVA Responsable Inscripto
-IVA Exento
Para MLB:
-Contribuinte
-Não contribuinte
Posibles valores: cualquier string, "SN" para casos de calle sin 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.