Envío gratis

Los vendedores que utilizan el módulo de envío MercadoEnvíos, modo 1 o modo 2, pueden publicar artículos y ofrecer uno de los métodos de envío gratis.
Este tipo de envío tiene algunos beneficios: es una experiencia de compras superior para el comprador, aparece resaltada en los resultados de búsqueda y los compradores pueden filtrar publicaciones que ofrecen envío gratis.
Recientemente implementamos algunos cambios en la API y en la estructura JSON de los artículos al incorporar la posibilidad de configurar reglas para la opción free_shipping. Ahora, los vendedores brasileños con ME pueden excluir las regiones norte y noreste cuando incluyen free_shipping en sus artículos, si así lo desean. Esto es posible gracias a la regla ‘exclude_regions’. Otros sites solo pueden utilizar la regla ‘país’, es decir que si incluyen envío gratis en sus artículos, se aplica a todo el país.

Contenidos:

Modos de envío

curl 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:

http://developers.mercadolibre.com/free-shipping/
{
"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
  	}]
   }
}

Calcula los costos de envío gratis

Sites

Calcula los costos de envío gratis por site y dimensión del producto

Ejemplo:

curl -X GET https://api.mercadolibre.com/sites/MLM/shipping_options/free?dimensions=2x11x25,500

Respuesta:

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

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 excluyendo regiones

Ejemplo:

{
	"shipping": {
    	"free_methods": [
        	{
            	"id": 182,
            	"rule": {
                	"free_mode": "exclude_region",
                	"value": [
                        "BR-NO",
                    	"BR-NE"
                	]
            	}
        	}
    	}
	],
	
}

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": []
    }

Por favor califica del 1 al 5