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 →Quitar envío gratis de la publicación
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
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": []
}
Quitar envío gratis de la publicación
Para eliminar el envío gratuito de la publicación, debe modificar el valor de "free_shipping" a "false" y enviar el array vacío a "free_methods", eliminando la configuración de envío que se aplica al artículo.
Ejemplo con ME2:
"shipping": {
"mode": "me2",
"local_pick_up": false,
"free_shipping": false,
"methods": []
}