Recursos Cross
Explora los recursos principales de nuestras APIsDocumentación
Puedes usar esta documentación para las siguientes unidades de negocio:
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:
País | Marketplace |
---|---|
Brasil | Costos de venta |
Argentina | Costos de venta |
México | Costos de venta |
Chile | Costos de venta |
Colombia | Costos de venta |
Perú | Costos de venta |
Uruguay | Costos de venta |
Ecuador | Costos de venta |
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:
Nombre | Tipo | Descripción | Ejemplo |
---|---|---|---|
item_id | string | ID del ítem. | MLB23332 |
dimensions | string | Dimensiones del ítem (altura x ancho x largo, peso). | 60x364x63,661 |
item_price | number | Precio unitario del ítem. | 123 |
verbose | bool | El verbose determina si el descuento para el envío se incluye o no en la respuesta. | TRUE |
condition | string | Condición del ítem, puede ser usado o nuevo. | new |
currency_id | string | Tipo de moneda ofrecido para el ítem. | ARS |
category_id | string | Categoría del ítem. | MLB23332 |
listing_type_id | string | Nivel de publicación del ítem, determina nivel de exposición y determinados beneficios. | gold_special |
variation_id | Number | Variación del ítem. | 123213 |
seller_status | string | Indica el nivel de las tiendas Líderes (Platinum, Gold, Silver). | gold |
seller_type | string | Indica si se trata de una tienda oficial o no. | normal |
reputation | string | Indica la reputación del vendedor (red, Orange, Yellow, Light_green, Green). | green |
mode | string | Modo de envío (me2, me1, custom y not specified). | me2 |
logistic_type | string | Tipo de logística: CrossDocking = “cross_docking” DropShipping = “drop_off” Fulfillment = “fulfillment” XdDropOff = “xd_drop_off” Flex = “self_service” |
self_service |
tags | string | Etiquetas de información general del ítem. Permite determinar si el ítem tiene Flex como logística. | self_service |
state_id | string | ID del estado desde donde se origina el envío. | BRL |
city_id | string | Ciudad desde donde se origina el envío. | TUxDQ1BVRWRiYjBh |
zipe_code | number | El zip code de origen del envío. | 35519000 |
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:
Código | Mensaje | Descripción | Recomendación |
---|---|---|---|
200 - OK | - | Se obtuvo correctamente la consulta. | - |
400 - Bad Request | seller_id must have a value! | No existe el usuario. | Validar el valor del seller_id. |
404 - Not Found | Item with ID {itemID} not found | Ítem no encontrado. | Validar el valor del item_id. |
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.
País | Mshops |
---|---|
Brasil | Costos por ofrecer Envío Gratis. |
Argentina | Costos por ofrecer Envíos Gratis. |
México | Costos por ofrecer Envíos Gratis. |
Chile | Costos por ofrecer Envíos Gratis. |
Colombia | Costos por ofrecer Envíos Gratis. |
Perú | - |
Ururguay | - |
Ecuador | - |
Siguiente: Places (xd_drop_off).