Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Mercado Envíos
Modos de envíos por país
Cada sitio cuenta con un conjunto de métodos de envío disponibles y estos presentan diferentes tiempos y costos de envío. Además de Mercado Envíos 1 y 2, los vendedores pueden ofrecer Envío personalizado. Con la siguiente llamada puedes consultar los modos de envío disponibles en cada país:
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/shipping_methods
Respuesta:
[
{
"id": 502845,
"name": "Retiro en sucursal OCA Prioritario",
"type": "express",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": null,
"company_id": null,
"company_name": null,
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 501045,
"name": "Retiro en OCA",
"type": "standard",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17500240,
"company_name": "OCA",
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 501145,
"name": "Estándar",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me1"
],
"company_id": null,
"company_name": null,
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 505545,
"name": "Envío internacional",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me1"
],
"company_id": 17502940,
"company_name": "CBT Argentina",
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 505045,
"name": "Retiro en Andreani",
"type": "standard",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17502540,
"company_name": "Andreani",
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 504845,
"name": "Seller local",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me1"
],
"company_id": null,
"company_name": null,
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 506245,
"name": "Rápido a domicilio",
"type": "super_express",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 0,
"max_time": 24,
"currency_id": "ARS"
},
{
"id": 501146,
"name": "Prioritario",
"type": "express",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me1"
],
"company_id": null,
"company_name": null,
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 73330,
"name": "Prioritario a domicilio",
"type": "express",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17500240,
"company_name": "OCA",
"min_time": 0,
"max_time": 72,
"currency_id": "ARS"
},
{
"id": 73328,
"name": "Normal a domicilio",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17500240,
"company_name": "OCA",
"min_time": 72,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 504245,
"name": "Normal a domicilio",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17500940,
"company_name": "Reprocesos Carrito",
"min_time": 72,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 510445,
"name": "Prioritario a domicilio",
"type": "next_day",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 24,
"max_time": 24,
"currency_id": "ARS"
},
{
"id": 511545,
"name": "Estándar a domicilio",
"type": "four_days",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 96,
"max_time": 96,
"currency_id": "ARS"
},
{
"id": 510245,
"name": "Devolución Estándar",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17501440,
"company_name": "Correo Argentino",
"min_time": 24,
"max_time": 96,
"currency_id": "ARS"
},
{
"id": 510545,
"name": "Express a domicilio",
"type": "two_days",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 48,
"max_time": 48,
"currency_id": "ARS"
},
{
"id": 510945,
"name": "Estándar a sucursal de correo",
"type": "three_days",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 72,
"max_time": 72,
"currency_id": "ARS"
},
{
"id": 506345,
"name": "Rápido a domicilio",
"type": "super_express",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 0,
"max_time": 48,
"currency_id": "ARS"
},
{
"id": 507045,
"name": "Test Flex [NO USAR]",
"type": "super_express",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 2160,
"max_time": 2400,
"currency_id": "ARS"
},
{
"id": 506445,
"name": "Rápido a domicilio",
"type": "super_express",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 24,
"max_time": 48,
"currency_id": "ARS"
},
{
"id": 513146,
"name": "Proximity Express",
"type": "proximity_express",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 0,
"max_time": 99,
"currency_id": "ARS"
},
{
"id": 503045,
"name": "Retiro en Correo Argentino",
"type": "standard",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17501440,
"company_name": "Correo Argentino",
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 512747,
"name": "Prioritario a domicilio",
"type": "same_day",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 1,
"max_time": 1,
"currency_id": "ARS"
},
{
"id": 511546,
"name": "Estándar a sucursal de correo",
"type": "four_days",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 96,
"max_time": 96,
"currency_id": "ARS"
},
{
"id": 510845,
"name": "Express a sucursal de correo",
"type": "two_days",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 48,
"max_time": 48,
"currency_id": "ARS"
},
{
"id": 510645,
"name": "Estándar a domicilio",
"type": "three_days",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 72,
"max_time": 72,
"currency_id": "ARS"
},
{
"id": 510745,
"name": "Prioritario a sucursal de correo",
"type": "next_day",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 24,
"max_time": 24,
"currency_id": "ARS"
},
{
"id": 504945,
"name": "Normal a domicilio",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17502540,
"company_name": "Andreani",
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 505645,
"name": "Envío internacional",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me1"
],
"company_id": 17502940,
"company_name": "CBT Argentina",
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 504345,
"name": "Retiro en una sucursal",
"type": "standard",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": null,
"company_id": 17500940,
"company_name": "Reprocesos Carrito",
"min_time": null,
"max_time": null,
"currency_id": "ARS"
}
]
Campos de la respuesta:
id: ID del método de envío se utiliza al publicar un artículo con envío.
name: nombre del método de envío.
site_id: ID del sitio al que pertenece el método de envío.
free_options: opciones gratis.
shipping_modes: modos de envíos.
- me1: Mercado Envíos 1 ofrece un calculador de envíos para obtener el costo de envío de cada pedido y el vendedor selecciona el servicio de envío de su preferencia eligiendo un transportista. También, se encargará de administrar el número de seguimiento (tracking number).
- me2: Mercado Envíos 2 es el modo más recomendado porque ofrece una mejor experiencia para vendedores y compradores. Mercado Libre genera una etiqueta que el vendedor debe imprimir y un código de seguimiento con un transportista local predefinido, es decir, el vendedor no debe ocuparse en elegir un transportista ni gestionar el número de seguimiento.
- custom (personalizado): los vendedores pueden incluir una tabla con hasta 10 costos de envío en un artículo y el comprador debe entregar ese número al terminar y salir [checkout] del proceso.
- not_specified (no especificado): significa que el vendedor no especificó ningún precio de envío para sus artículos y el comprador debe ponerse en contacto con el vendedor para acordar una opción de envío y el precio de la compra. Si no envías información sobre el envío para el artículo se marcará como "not_specified" por defecto. Además, si no existen modos que soporten las dimensiones de tu artículo, debes publicar bajo este modo. Si la categoría no soporta las dimensiones de tu producto, solo tendrás "not_specified" en la respuesta. Por último, si la categoría tiene ME2 se ignorarán las dimensiones enviadas, ya que se tienen en cuenta las dimensiones establecidas en la categoría.
Modos habilitados según la categoría de la publicación
Recuerda que existen algunas restricciones en ciertas categorías, por eso te recomendamos consultar los modos habilitados según la categoría de los productos.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/categories/$CATEGORY_ID/attributes
Realiza un POST incluyendo los atributos de la publicación.
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' 'x-multichannel: true' 'X-Format-New: true' -H "Content-Type: application/json" -d
{
"buying_mode": "buy_it_now",
"category_id": "MLB437616",
"channels": [
{
"id": "marketplace"
}
],
"condition": "new",
"dimensions": null,
"is_internal": true,
"is_new_listing": false,
"item_currency": "ARS",
"item_id": null,
"item_price": 3500,
"listing_type_id": "gold_special",
"new_format": true,
"sale_terms": [],
"seller_id": 419059118,
"site_id": "MLB",
"source": "",
"title": "Titulo de teste",
"local_pick_up": false,
"to_catalog_internal": false,
"to_modes_internal": false,
"traced": false,
"verbose": false
}
https://api.mercadolibre.com/users/$USER_ID/shipping_modes
Respuesta:
{
"channels": {
"marketplace": {
"available_modes": [
{
"mode": "me1",
"logistic_types": [
{
"type": "default",
"default": true,
"attributes": {
"dimensions": "optional",
"costs": "not_allowed",
"adoption": "not_required",
"free_shipping": "optional",
"local_pick_up": "optional",
"tags": []
}
}
],
"shipping_attributes": {
"dimensions": "optional",
"costs": "not_allowed",
"adoption": "not_required",
"free_shipping": "optional",
"local_pick_up": "optional",
"tags": []
}
},
{
"mode": "me2",
"logistic_types": [
{
"type": "cross_docking",
"default": true,
"attributes": {
"dimensions": "clear",
"costs": "not_allowed",
"adoption": "not_required",
"free_shipping": "mandatory",
"local_pick_up": "optional",
"tags": []
}
}
],
"shipping_attributes": {
"dimensions": "clear",
"costs": "not_allowed",
"adoption": "not_required",
"free_shipping": "mandatory",
"local_pick_up": "optional",
"tags": []
}
}
],
"warnings": null,
"channel_id": "marketplace"
}
}
}
Preferencias de envío de un usuario
Conoce las preferencias de envío de cualquier usuario.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/shipping_preferences
Respuesta:
{
"local_pick_up":false,
"modes":[
"custom",
"not_specified",
"me1",
"me2"
],
"trusted_user":true,
"custom_calculator":false,
"picking_type":"cross_docking",
"thermal_printer":null,
"option":"in",
"tags":[
],
"carrier_pickup":false,
"items_combination":"enabled",
"services":[
311,
591,
671,
801,
881,
1181,
1191,
136261
],
"logistics":[
{
"mode":"me1",
"types":[
{
"type":"default",
"carrier_pickup":[
],
"services":[
21,
23,
22,
11
],
"default":true
}
]
},
{
"mode":"me2",
"types":[
{
"type":"cross_docking",
"carrier_pickup":[
17501840
],
"services":[
311,
591,
671,
801,
881,
1181,
1191
],
"default":false
},
{
"type":"self_service",
"carrier_pickup":[
],
"services":[
136261
],
"default":false
}
]
},
{
"mode":"custom",
"types":[
{
"type":"custom",
"carrier_pickup":[
],
"services":null,
"default":true
}
]
},
{
"mode":"not_specified",
"types":[
{
"type":"not_specified",
"carrier_pickup":[
],
"services":null,
"default":true
}
]
}
],
"content_declaration_disabled":false,
"conciliation":{
"type":null
},
"mandatory_invoice_data":false,
"site_id":"MLA",
"free_configurations":[
{
"condition":{
"value":null,
"type":"all"
},
"rule":{
"default":true,
"free_mode":"country",
"value":null
}
}
],
"mandatory_settings":{
}
}
Estados del envío
Para determinados modos de envíos, desde Mercado Libre realizamos un seguimiento automático y monitoreo de los números de seguimiento. Los estados son internos y alterados por Mercado Libre.
Pueden ser:
pending: los envíos se crean con este estado
handling: el pago para este envío fue recibido.
ready_to_ship: se recibió el código de autorización del transportista.
shipped: el transportista informó el despacho del envío.
delivered: el transportista informó la llegada del envío.
not_delivered: el transportista no pudo entregar el paquete.
cancelled: el envío fue cancelado.
Para Envío personalizado y otras configuraciones de Mercado Envíos 1, serás responsable de enviar un número de seguimiento y actualizar el estado del envío.
Para los casos sin Mercado Envíos (o Envíos Not_Specified) no se cuenta con un shipment_id, por lo que se deberá contar con el feedback de la venta para cerrarla.
Conoce más sobre Mercado Envíos.
Siguiente: Mercado Envíos 1.