Recursos Cross

Explora los recursos principales de nuestras APIs
circulos azuis em degrade

Documentación

Puedes usar esta documentación para las siguientes unidades de negocio:

Última actualización 11/01/2024

Envío Gratis

Importante:
Actualmente la funcionalidad está disponible para los sites MLB, MLA, MLM, MLC, MCO, MPE, MLU y MEC.

La funcionalidad de Envíos Gratis es una herramienta poderosa para mejorar las ventas en línea. Con esta característica, se puede ofrecer productos a compradores sin costo de envío y recibir subsidios como vendedor de acuerdo al precio del producto. Esto no solo atrae a más compradores, sino que también brinda información detallada sobre cada producto.

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
Notas:
  • En ciertas situaciones, Mercado Libre requiere que los vendedores ofrezcan envío gratuito para ciertos artículos. Cuando MELI impone esta condición, la plataforma subsidia una parte de los costos de envío.
  • Asegúrate de comprender los requisitos y las políticas de MELI relacionadas con el envío gratuito para poder implementar esta funcionalidad de manera efectiva en tu plataforma de venta.
  • En caso de tener el "mandatory_free_shipping" el requisito es obligatorio. Cuando la API arroja este parámetro, es vital acogerse a él para garantizar un funcionamiento sin problemas en nuestras aplicaciones.

Consultar costos de envíos

Este endpoint permite conocer el precio que el vendedor pagará por el envío de un determinado í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
mmode string Modo del envío (me2, me1, custom y not specified). me2
logistic_type string Tipo de logística (Flex, Drop Shipping, Cross Docking o Fulfillment). flex
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
Nota:
Dentro de todos los parámetros de consulta para utilizar este endpoint, es importante destacar que los obligatorios son ITEM_ID o DIMENSIONS. Esto significa que al hacer uso de este recurso, es esencial proporcionar al menos uno de estos dos parámetros en la solicitud para que la API pueda procesarse correctamente.

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.
Nota:
  • Es importante destacar que el array 'discount' solo estará presente en la respuesta si se ofrece algún descuento. En caso contrario, es posible que este array no esté incluido en la respuesta.
  • Este endpoint tiene un propósito específico y está diseñado para operar únicamente con artículos que se encuentran disponibles en el Marketplace de nuestra plataforma.

En relación a Mshops, es importante destacar que actualmente no contamos con una API específica para consultar los costos de envío. Sin embargo, queremos proporcionarte valiosa informació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 CCostos 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).