Envío de productos
Contenidos
→Modos de envío →Especificaciones de cada país →¿Cómo averiguar los modos habilitados para un usuario? →Modos habilitados segundo a categoria do anúncio →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
Modos de envio
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
¿Cómo 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 POST 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:
GET https://api.mercadolibre.com/users/$USER_ID?access_token=$ACCESS_TOKEN
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
Além disso, existem algumas restrições em certas categorias. Utilize o recurso shipping_modes para verificar se um vendedor pode publicar um produto no modo de envio ME2 para uma determinada categoria. A resposta indicará se o modo me2 é disponibilizado e quais métodos de envio podem ser utilizados.
Você deverá fazer um POST incluindo os atributos do anúncio sem a necessidade de enviar o access token.
A informação sobre os atributos da categoria poderá ser vista em:
ttp://api.mercadolibre.com/categories/$CATEGORY_ID/attributes/
POST
ttps://api.mercadolibre.com/users/$USER_ID/shipping_modes
url -X POST -H "Content-Type: application/json" -d'{
"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”
}
]
}
}
' https://api.mercadolibre.com/users/$USER_ID/shipping_modes
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"
}
}
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 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.
https://api.mercadolibre.com/sites/MLB/shipping_methods
Respuesta JSON:
{
"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 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":[
]
}
}
]