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