Envío de productos
Contenidos
→Modos de envío →Especificaciones de cada país →Averiguar los modos habilitados para un usuario →Modos habilitados según la categoría de la publicación →Preferencias de envío →Métodos de envío →Estado del envío →Introducción a Mercado Envíos →Diferencias entre ME1 y ME2 →No especificado →Configurar Mercado Colecta para usuarios de prueba
Modos de envío
Cada site cuenta con un conjunto de métodos de envío disponibles. Presentan diferentes tiempos y costos de envío. Los vendedores pueden ofrecer envío gratis en uno o ambos métodos. Existe un recurso especial para ver los métodos disponibles por site. URL para Brasil
- not_specified (no especificado): significa que el vendedor no especificó ningún precio de envío para sus artículos y el comprador debe ponerse en contacto con el vendedor para acordar una opción de envío y el precio de la compra.
- custom: (personalizado): los vendedores pueden incluir una tabla con hasta 10 costos de envío en un artículo y el comprador debe entregar ese número al terminar y salir [checkout] del proceso.
- me1(Mercado Envíos modo 1): ofrece un calculador de envíos para calcular el costo de envío de cada pedido y permitir que el vendedor seleccione el servicio de envío de su preferencia, pero eligiendo un transportista. El vendedor se encarga de administrar el número de seguimiento.
- me2(Mercado Envíos modo 2): ofrece al vendedor una etiqueta prepaga y un código numérico de seguimiento con un transportista local predefinido en cada país. El vendedor no tiene que preocuparse de elegir un transportista ni de manejar el número de seguimiento. Es el modo más recomendado porque ofrece una experiencia excelente tanto para compradores como para vendedores. Mercado Libre elige la empresa de transporte.
Especificaciones de cada país
Brasil | Argentina | México | Colombia | Chile | Uruguay | name (nombre) – Nombre del método de envío.|
---|---|---|---|---|---|---|
Modos | ME2, ME1, custom, not_specified | El ID del método de envío se utiliza al publicar un artículo con envío. , ME1, custom, not_specified | ME2, not_specified | ME2, not_specified, custom | ME2, not_specified, custom | ME2, not_specified, custom |
Envío gratis | Si | Si | Si | Si | Si | Si |
Exclusión regional para Envío gratis | Sí, Norte e Nordeste | No | No | No | No | No |
Transportista | Correios | Oca - Correo Argentino - Motonorte - Andreani - Ocasa | DHL - Fedex - UPS | ServiEntrega | Chilexpress | Correo Uruguayo - UES - Mirtrans |
Restricciones sobre las dimensiones | (C) Mínimo 16 cm. Máximo 105 cm. (L) Mínimo 11 cm. Máximo 105 cm. v(A) Mínimo 2 cm. Máximo 105 cm. |
70x70x70 | 250x250x250 | 130x60x30cm | 80x80x120cm | Correo Uruguayo: 1) Largo menor a um metro 2) Suma dos lados menor ou igual a 1.5 mtrs. UES: Largo menor a un metro 2) Lados menor a 0,60m. Mirtrans: 1) Largo menor a un metro 2) Suma de los lados menor o igual a 1.5 mtrs. |
Peso máximo | 30 kg. | 25 kg. | 80 kg. | 50 kg. | 50 kg. | 30 kg. |
*(C) Comprimento
(L) Largo
(A) Alto
Averiguar los modos habilitados para un usuario
Al momento de hacer una publicación bajo una modalidad de envío, existen algunas restricciones en ciertas categorías.
Utiliza el recurso de shipping_modes antes mencionado para verificar si un vendedor puede publicar un artículo con Mercado Envíos para una categoría determinada.
La respuesta indica si se encuentra disponible el modo ME2 y los métodos de envío que se pueden utilizar.
Se deberá hacer un GET incluyendo los atributos de la publicación, sin necesidad de enviar access token.
La información sobre los atributos de la categoría se encuentra en:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID
Esto devolverá gran cantidad de información sobre el usuario autenticado, incluido el atributo shipping_modes.
Respuesta:
"shipping_modes":[
"custom",
"not_specified",
"me1",
"me2"
]
Modos habilitados según la categoría de la publicación
Además, existen algunas restricciones en ciertas categorías. Utiliza el recurso shipping_modes para verificar si un vendedor puede publicar un producto en modo de envío ME2 para una determinada categoría. La respuesta indicará si el modo ME2 está disponible y qué métodos de envío pueden ser utilizados. Conoce los atributos de las categorías.
Llamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/shipping_modes
Ejemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/shipping_modes
{
"category_id": "MLA121212",
"item_currency": "ARS",
"dimensions": "20x20x20,4000",
"catalog":{
"product_id": "MLB2323232",
"domain_id": "MLB-TELEVISIONS",
"attributes":[
{
"id": "SCREEN_TYPE",
"value_name": "LED",
"value_id":"81830"
},
{
"id": "SCREEN_SIZE",
"value_name": "43 cm"
"value_id": null
},
{
"id": "BRAND",
"value_name": "LG",
"value_id":"215"
}
]
}
}
Respuesta con ME2:
{
"mode":"me2",
"logistic_types":[
{
"type":"cross_docking",
"default":true,
"attributes":{
"dimensions":"clear",
"costs":"not_allowed",
"free":{
"methods":"optional",
"accepted_methods":[
73328
],
"rules":[
{
"default":true,
"free_mode":"country",
"value":null,
"free_shipping_flag":true
}
],
"flat":true
},
"local_pick_up":"optional"
}
}
],
"shipping_attributes":{
"dimensions":"clear",
"costs":"not_allowed",
"free":{
"methods":"optional",
"accepted_methods":[
73328
],
"rules":[
{
"default":true,
"free_mode":"country",
"value":null,
"free_shipping_flag":true
}
],
"flat":true
},
"local_pick_up":"optional"
}
}
En el caso que un ítem esté publicado en una categoría que tenga habilitado me2 y el vendedor no haya realizado optin a Mercado Envíos, en la respuesta verás solo “mode”: “me2” y además el atributo “adoption”: “required” de la siguiente manera:
{
"mode": "me2",
"logistic_types": [
{
"type": "drop_off",
"default": true,
"attributes": {
"dimensions": "clear",
"costs": "not_allowed",
"adoption": "required",
"free": {
"methods": "mandatory",
"accepted_methods": [
73328
],
"rules": [
{
"default": true,
"free_mode": "country",
"value": null,
"free_shipping_flag": true
}
],
"flat": true
},
"local_pick_up": "optional",
"tags": []
}
}
]
}
En este caso, comunícale al vendedor que debe ingresar a Mercado Libre, Mi cuenta, Ventas, Preferencias de venta y realizar la adopción a Mercado Envíos:

Preferencias de envío
También existe un recurso público que te permitirá conocer las preferencias de envío de cualquier usuario si lo necesitas. Simplemente, realiza la siguiente llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/:user_id/shipping_preferences
{
"local_pick_up": false,
"modes": [
"custom",
"not_specified",
"me1",
"me2"
],
"trusted_user": true,
"custom_calculator": false,
"picking_type": "cross_docking",
"thermal_printer": null,
"option": "in",
"tags": [
],
"carrier_pickup": false,
"items_combination": "enabled",
"services": [
311,
591,
671,
801,
881,
1181,
1191,
136261
],
"logistics": [
{
"mode": "me1",
"types": [
{
"type": "default",
"carrier_pickup": [],
"services": [
21,
23,
22,
11
],
"default": true
}
]
},
{"mode": "me2",
"types": [
{
"type": "cross_docking",
"carrier_pickup": [
17501840
],
"services": [
311,
591,
671,
801,
881,
1181,
1191
],
"default": false
},
{
"type": "self_service",
"carrier_pickup": [
],
"services": [
136261
],
"default": false
}
]
},
{
"mode": "custom",
"types": [
{
"type": "custom",
"carrier_pickup": [
],
"services": null,
"default": true
}
]
},
{
"mode": "not_specified",
"types": [
{
"type": "not_specified",
"carrier_pickup": [
],
"services": null,
"default": true
}
]
}
],
"content_declaration_disabled": false,
"conciliation": {
"type": null
},
"mandatory_invoice_data": false,
"site_id": "MLA",
"free_configurations": [
{
"condition": {
"value": null,
"type": "all"
},
"rule": {
"default": true,
"free_mode": "country",
"value": null
}
}
],
"mandatory_settings": {
}
}
Podrás consultar la configuración del envío gratis (más adelante presentaremos mayor información), modos, etc.
Métodos de envío
Cada site cuenta con un conjunto de métodos de envío disponibles. Presentan diferentes tiempos y costos de envío. Los vendedores pueden ofrecer envío gratis en uno o ambos métodos. Existe un recurso especial para ver los métodos disponibles por site. URL para Brasil.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLB/shipping_methods
Respuesta:
{
"id": 500645,
"name": "Expresso",
"status": "active",
"site_id": "MLB",
"free_options": [
"country"
]
},
{
"id": 501548,
"name": "CBT MLB",
"status": "active",
"site_id": "MLB",
"free_options": [
"country"
]
},
{
"id": 100009,
"name": "Normal",
"status": "active",
"site_id": "MLB",
"free_options": [
"country"
]
},
{
"id": 182,
"name": "Expresso",
"status": "active",
"site_id": "MLB",
"free_options": [
"country"
]
}
Respuesta:
- id – el ID del método de envío se utiliza al publicar un artículo con envío.
- name – nombre del método de envío.
- site_id – el ID del sitio al que pertenece el método de envío.
- free_options– opciones gratis.
Estado del envío
El estado del envío puede variar en el pedido dependiendo del modo de envío seleccionado para el producto. Para modos que soportan seguimiento automático y monitoreo de los números de seguimiento, como con Mercado Envios modo 2 y modo 1 en ciertas configuraciones, nosotros actualizaremos el estado del envío, mientras que para el modo de envío personalizado y otras configuraciones de Mercado Envios modo 1, tú serás responsable de enviar un número de seguimiento y actualizar el estado del envío. Si bien no es obligatorio, te sugerimos que lo hagas para mejorar tus posibilidades de recibir mejor feedback de los compradores.
Estado:
to_be_agreed: el envío se acordará entre el vendedor y el comprador.
pending: los envíos se crean con este estado
handling: el pago para este envío fue recibido.
ready_to_ship: se recibió el código de autorización del transportista.
shipped: el transportista informó el despacho del envío.
delivered: el transportista informó la llegada del envío.
not_delivered: el transportista no pudo entregar el paquete.
cancelled: el envío fue cancelado.
Introducción a Mercado Envíos
Mercado Envíos es nuestra unidad de negocios que ayuda a los vendedores con numerosas facilidades para enviar sus productos; actualmente se encuentra activo en MLA, MLB, MLM, MLC y MCO. Como especificamos más arriba, existen dos opciones de Mercado Envíos que puedes elegir: modo 1 y modo 2.
Diferencias entre ME1 y ME2
ME1 | ME2 |
---|---|
Ideal para grandes vendedores que ya trabajan con un transportista de preferencia y tienen un proceso que se encarga de calcular costos de envío, cobrar los pagos e imprimir las etiquetas de envío con la información de venta y envío. | La mejor opción para vendedores medianos y grandes que necesitan un intermediario para tratar con el transportista; ayuda al vendedor y al comprador a realizar el seguimiento del producto, calcula los costos de envío y se encarga de todo el proceso de envío, cobranza de pagos e impresión de etiquetas de envío con toda la información de venta y envío. |
Solo en MLA, MLC y MLB. | Solo en MLA, MLB, MLM, MLC, MCO y MLU. |
Los vendedores seleccionan el transportista. | Tenemos acuerdos con los transportistas más confiables de cada país y ofrecemos a los vendedores etiquetas de envío prepagas. |
Los vendedores entregan las dimensiones del paquete o utilizan las dimensiones estándares de la categoría. | Los vendedores trabajan con las dimensiones estándares de cada categoría. |
Calculamos y fijamos los costos de envío en base al origen, destino y dimensiones del paquete. | Calculamos y fijamos los costos de envío en base al origen, destino, precio del artículo y dimensiones del paquete. |
El vendedor recibe el pago cobrado por el envío de inmediato y se encarga del pago de la etiqueta y del transportista. | Nos encargamos de cobrar el dinero y pagar por el envío. |
Soporta envío gratis. El vendedor se encarga del envío del producto. | Soporta envío gratis. Te enviamos la factura para pagar los costos de envío del producto. |
Los vendedores se encargan de realizar el seguimiento del producto e informar el estado del envío a los compradores. | Realizamos el seguimiento del producto y actualizamos automáticamente el estado del envío para los vendedores y compradores. |
No especificado
Al hacer un POST enviando Mercado Envío cuando la categoría no lo acepta y el usuario no lo tiene activo pero así mismo se agrega esta esta opción por defecto se publica el ítem como shipping modes “not_specified”. Por otro lado, si no mandas información sobre el envío para el artículo se marcará como "not_specified" por defecto. Además, si no existen modos que soporten las dimensiones de tu artículo, debes publicar bajo este modo. Puedes realizar una llamada a nuestra API con tu user_id en la categoría donde deseas publicar y las dimensiones de tu artículo para conocer los modos de envío disponibles; si no se soportan las dimensiones, solo tendrás el modo "not_specified" en la respuesta.
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/:user_id/shipping_modes?category_id=MLB74723&dimensions=10x50x100,30001
Respuesta:
[
{
"mode":"not_specified",
"shipping_attributes":{
"dimensions":"optional",
"costs":"not_allowed",
"accepted_methods":[
]
}
}
]
Configurar Mercado Colecta para usuarios de prueba
Para comenzar a usar Mercado Colecta con un usuario de prueba, envía los datos de tu usuario de prueba en este formulario.
Siguiente: Gestionar envíos.