Envío gratis

Los vendedores que utilizan el módulo de envío Mercado Enví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.

Contenidos

→Modos de envío
→Dimensiones y tipos de envíos
→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
  	}]
   }
}

Dimensiones y tipos de envíos

Importante:
Recuerda actualizar tu integración con el recurso /shipping_preferences antes del 30 de mayo de 2020. Luego de esta fecha, el recurso /categories/id/shipping será dado de baja.

Puedes conocer, a través de una llamada GET, las dimensiones estándares de la categoría de los envíos (peso, alto, ancho y profundidad) y logísticas admitidas en dicha categoría. Cuando las dimensiones del producto no sean especificadas, debes realizar el cálculo en base a las dimensiones estándares.

Llamada:

curl -X GET https://api.mercadolibre.com/categories/$CATEGORY_ID/shipping_preferences

Ejemplo:

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

Respuesta:

{
  "dimensions": {
    "height": 10,
    "width": 10,
    "length": 15,
    "weight": 500
  },
  "logistics": [
    {
      "types": [
        "default"
      ],
      "mode": "me1"
    },
    {
      "types": [
        "drop_off",
        "xd_drop_off",
        "self_service",
        "cross_docking",
        "fulfillment"
      ],
      "mode": "me2"
    },
    {
      "types": [
        "not_specified"
      ],
      "mode": "not_specified"
    },
    {
      "types": [
        "custom"
      ],
      "mode": "custom"
    }
  ],
  "restricted": false,
  "source": {
    "origin": "categories",
    "identifier": "MLM165702"
  },
  "date_created": null,
  "last_modified": null,
  "category_id": "MLM165702"
}

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

En el producto, verá que los "métodos" de propiedad se reemplazaron por "free_methods", cuando "free_shipping" es verdadero. Para Mercado Livre Brasil, excluiremos automáticamente las áreas norte, nordeste y de riesgo al seleccionar la opción "free_mode": "country".


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