Envíos gratis

Consultar productos con envío gratis

Este endpoint permite consultar qué productos son ofrecidos con envíos gratis.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/items/$ITEM_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/items/MLA1122334488

Respuesta con free shipping optional:

"shipping": {
	"mode": "me2",
	"methods": [],
	"tags": [
		"self_service_in"
	],
	"dimensions": null,
	"local_pick_up": false,
	"free_shipping": true,
	"logistic_type": "cross_docking",
	"store_pick_up": false
}

Respuesta con free shipping mandatory:

"shipping": {
	"mode": "me2",
	"methods": [],
	"tags": [
		"mandatory_free_shipping"
	],
	"dimensions": null,
	"local_pick_up": true,
	"free_shipping": true,
	"logistic_type": "xd_drop_off",
	"store_pick_up": false
}

Respuesta con free shipping fuera de me2:

"shipping": {
	"mode": "not_specified",
	"methods": [],
	"tags": [],
	"dimensions": null,
	"local_pick_up": true,
	"free_shipping": true,
	"logistic_type": "not_specified",
	"store_pick_up": false
}

"shipping": {
	"mode": "me1",
	"methods": [],
	"tags": [
		"optional_me1_chosen"
	],
	"dimensions": "56x190x140,59250",
	"local_pick_up": false,
	"free_shipping": true,
	"logistic_type": "default",
	"store_pick_up": false
}

Parámetros de respuesta:

• shipping.mode: Modalidad de envío configurado para el ítem.
• shipping.tags: Etiquetas de envío del ítem.

• Si indica "mandatory_free_shipping" es porque el ítem superó el límite establecido por Mercado Libre. Para estos productos, el envío gratuito es una obligación. Los vendedores deben ofrecer envíos gratis o importantes descuentos en el envío.
• En cambio, para productos con un precio por debajo de ese límite, el envío gratuito es opcional.

• shipping.dimensions: Dimensiones del producto, en el formato: altura x ancho x largo, peso.
• shipping.local_pick_up: Indicador booleano que muestra si está disponible la opción de retiro en persona.
• shipping.free_shipping: Indicador booleano que muestra si el envío es gratuito.
• shipping.logistic_type: Tipo de logística del envío.
• shipping.store_pick_up: Indicador booleano que muestra si está disponible la opción de recogida en tienda.

Para obtener una visión más detallada sobre los precios para envíos gratis, te invitamos a consultar las siguientes páginas:

Consultar costos de envíos

Este endpoint permite conocer el precio que el vendedor pagará por el envío de un determinado ítem.
Se puede utilizar también para simular costos de envíos al momento de publicar o editar un ítem

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/users/$USER_ID/shipping_options/free?dimensions=$DIMENSIONES&verbose=$VERBOSE&item_price=$ITEM_PRICE&listing_type_id=$LISTING_TYPE&mode=$MODE&condition=$CONDITION&logistic_type=$LOGISTIC_TYPE

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/users/244878077/shipping_options/free?dimensions=9x17x22,462&verbose=true&item_price=300&listing_type_id=gold_pro&mode=me2&condition=new&logistic_type=drop_off

Parámetros de consulta aceptables:

Respuesta:

"{
    "coverage": {
        "all_country": {
            "list_cost": 2369.99,
            "currency_id": "ARS",
            "billable_weight": 462,
            "discount": {
                "rate": 0,
                "type": "none",
                "promoted_amount": 0
            }
        }
    }
}

Parámetros de respuesta:

• coverage: Representa la cobertura de envío y contiene información sobre los costos y la moneda utilizada para el envío.
• coverage.all_country: Dentro de "coverage", "all_country" especifica que la información se aplica a envíos a todo el país.
• coverage.all_country.list_cost: Costo de envío ofrecido al vendedor.
• coverage.all_country.currency_id: Moneda utilizada para el costo de envío.
• coverage.all_country.billable_weight: Peso facturable del envío.
• coverage.discount: Información sobre descuentos aplicados al envío.
• coverage.discount.rate: Tasa de descuento aplicada.
• coverage.discount.type: Describe el tipo de descuento.
• coverage.discount.promoted_amount: Monto o valor base sobre el cual se aplicará un cierto porcentaje de descuento. Por ejemplo, si tenemos un costo de envío de $200 y se aplica un descuento del 40%, en la respuesta final obtendríamos: list_cost = 120, rate: 0.4 y promoted_amount = 200.

Códigos de estado de respuesta:

En relación a Mshops, es importante destacar que actualmente no contamos con una API específica para consultar los costos de envíos. Sin embargo, queremos proporcionar valiosa informaación relacionada con las reglas de negocio que se aplican, así como los montos o umbrales establecidos para ofrecer envíos gratuitos.

Siguiente: Places (xd_drop_off).