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
→Calcula los costos de envío gratis antes de publicar un ítem
→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 25 de junio 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"
}
}
}
}

Calcula los costos de envío gratis antes de publicar un ítem

Utiliza este recurso para calcular los costos de envío gratis antes de la publicación. Para esto es necesario que informes algunos parámetros:

currency_id: moneda.
listing_type_id: tipo de la publicación.
condition: estado del producto.
category_id: ID de la categoría que se va publicar.
item_price: precio del producto.
dimensions: dimensiones del producto (altura x ancho x profundidad, peso). En caso de que no las tengas, puedes chequear la información de la categoría en el recurso /shipping_preferences.


Llamada:

curl -X GET https://api.mercadolibre.com/users/$USER_ID/shipping_options/free?currency_id=$CURRENCY_ID&listing_type_id=$LISTING_TYPE_ID&condition=$CONDITION&category_id=$CATEGORY_ID&item_price=$ITEM_PRICE&verbose=true&dimensions=$DIMENSIONS

Ejemplo:

curl -X GET https://api.mercadolibre.com/users/378277780/shipping_options/free?currency_id=BRL&listing_type_id=gold_pro&condition=new&category_id=MLB26426&item_price=80&verbose=true&dimensions=15x30x5,150

Respuesta:

{
    "coverage": {
        "all_country": {
            "list_cost": 30.9,
            "currency_id": "BRL",
            "billable_weight": 150,
            "discount": {
                "rate": 0,
                "type": "none",
                "promoted_amount": 0
            }
        }
    }
}

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": []
    }
o regístrate para recibir últimas novedades sobre nuestra API