Envío gratis

Contenidos

→Modos de envío
→Usuarios y productos
→Calcula los costos de envío gratis por usuario y dimensiones del producto
→Calcula los costos de envío gratis por usuario e item_id
→Calcula los costos de envío gratis por artículo
→Productos con envío gratis
→Ofrece el modo free_shipping para todo el país
→Ofrece free shipping para envíos personalizados

Modos de envío

curl -X GET https://api.mercadolibre.com/users/{user_id}/shipping_modes?category_id={category_id}

Este recurso devolverá la configuración de envío disponible al vendedor para una categoría específica.

Respuesta:

{
"mode": "me2",
 "shipping_attributes": {
   "costs": "not_allowed",
   "dimensions": "clear",
   "free": {
      "methods": "optional",
  	"accepted_methods": [100009,182],
  	"rules": [{
         "free_mode":"exclude_region",
     	"value": [’BR-NO’, ’BR-NE’],
     	"default": true,
     	"free_shipping_flag": false
  	},{
     	"free_mode":"country",
     	"value": null,
     	"default": false,
     	"free_shipping_flag": true
  	}]
   }
}

Usuarios y productos

En México ofrecemos a los vendedores la opción de tarifa plana única. Cuando no se especifican las dimensiones del producto, el cálculo se realiza en base a las dimensiones estándares de la categoría. Conoce las dimensiones estándares para una categoría determinada.

Ejemplo:

curl -X GET https://api.mercadolibre.com/categories/MLM165702/shipping

Respuesta:

{
  "category_id": "MLM1055",
  "height": 10,
  "width": 10,
  "length": 15,
  "weight": 500
}

Calcula los costos de envío gratis por usuario y dimensiones del producto

Ejemplo:

curl -X GET https://api.mercadolibre.com/users/4422224/shipping_options/free?dimensions=10x10x10,500

Respuesta:

{
"coverage": {
"all_country": {
"list_cost": 97,
"currency_id": "MXN"
}
}
}

Calcula los costos de envío gratis por usuario e item_id

Ejemplo:

curl -X GET https://api.mercadolibre.com/users/4422224/shipping_options/free?item_id=MLM531425223
{
"coverage": {
"all_country": {
"list_cost": 97,
"currency_id": "MXN"
}
}
}

Calcula los costos de envío gratis por artículo

Ejemplo:

curl -X GET https://api.mercadolibre.com/items/MLB739217081/shipping_options/free

Respuesta:

{
"coverage": {
"all_country": {
"list_cost": 14.02,
"currency_id": "BRL"
}
}
}

Utiliza multiget para calcular el costo del envío gratis de hasta 50 productos en una sola llamada a la API:

Ejemplo:

curl -X GET curl -X GET https://api.mercadolibre.com/items/shipping_options/free?ids=MLM531425223,MLM537956425,MLM537955922

Respuesta:

{
"MLM537955922": {
"coverage": {
"all_country": {
"list_cost": 140,
"currency_id": "MXN"
}
}
},
"MLM531425223": {
"coverage": {
"all_country": {
"list_cost": 97,
"currency_id": "MXN"
}
}
},
"MLM537956425": {
"coverage": {
"all_country": {
"list_cost": 105,
"currency_id": "MXN"
}
}
}
}

Productos con envío gratis

curl https://api.mercadolibre.com/items/{item_id}

En el producto verás que reemplazamos los “métodos” de propiedad por “free_methods” cuando “free_shipping” es verdadero. De acuerdo con free_methods, tendrás el ID del método y la “regla”.
En la sección “reglas”, deberás especificar si deseas excluir o no regiones en “free_mode”. Si configuras “free_mode”:”exclude_region”, debes enviar los valores, que por ahora serán ‘BR-NO’ y ‘BR-NE’.

{
   "shipping":{
  	"mode":"me2",
  	"local_pick_up":true,
  	"free_shipping":true,
  	"free_methods":[
     	{
        	"id":182,
        	"rule":{
                "free_mode":"exclude_region",
                "value":[’BR-NO’, ’BR-NE’]
         	}
     	},
  	],
  	"dimensions":null
   }
}

Ofrece el modo free_shipping para todo el país

Ejemplo:

{
"title": "Titulo del item",
...
"shipping": {
	"mode": "me2",
	"local_pick_up": false,
	"free_methods": [
    	{
        	"id": 100009,
        	"rule": {
            	"free_mode": "country",
            	"value": null
        	}
    	}
	]
}
}

Ofrece free shipping para envíos personalizados

Para países donde Mercado Envíos se encuentra activo sólo podrás agregar envíos custom gratis en categorías que no acepten ME.

"shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": true,
        "methods": [],
        "costs": []
    }