Envío de productos

El departamento de envíos de Mercado Libre maneja toda la información relativa a cómo pasa un producto de un usuario a otro.

Contenidos:

Modos de envío

En pocas palabras, las publicaciones en Mercado Libre cuentan con 4 modos de envío diferentes (por favor consulta los modos disponibles en tu país):
  • 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 Envios modo 1) Este método 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 Envios modo 2) Este método 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. ML elige la empresa de transporte.

Especificaciones de cada país

Brasil Argentina México Colombia Chile Uruguay
Modes

ME2, ME1, custom, not_specified ME2, ME1, custom, not_specified ME2, not_specified ME2, not_specified ME2, not_specified ME2, not_specified, custom
Envío gratis Si Si Si Si Si Si
Exclusión regional para Envío Gratis Sí, Norte y Nordeste No No No No No
Transportista Correios Oca - Correo Argentino - Motonorte - Andreani - Ocasa DHL - Fedex - UPS ServiEntrega Chilexpress Correo Uruguayo
Restricciones sobre las dimensiones (C) Mínimo 16cm Máximo 105cm - (L) Mínimo 11cm Máximo 105cm - (A) Mínimo 2cm Máximo 105 cm 70x70x70 250x250x250 130x60x30cm 80x80x120cm 1) Largo menor a un metro 2) Suma de los lados menor o igual a 1.5 mtrs.
Peso máximo 30kg 25kg 80kg 50kg 50kg 30kg
Notas:
  • Mercado Envios modo 1 solo se encuentra disponible para vendedores seleccionados de Argentina y Brasil que llegaron a un acuerdo comercial con Mercado Libre y están integrados.

¿Cómo averiguar los modos habilitados para un usuario?

Puedes consultar qué modos de envío tiene habilitado el usuario de la siguiente manera:
GET https://api.mercadolibre.com/users/:user_id?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 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 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 además 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:
api.mercadolibre.com/categories/${category_id}/attributes/
POST
https://api.mercadolibre.com/users/user_id/shipping_modes
{
	"category_id": "MLA121212",
	"item_currency": "ARS", 
	"dimensions": "20x20x20,4000",
	"catalog":{
			"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”
		}
		]

	}
}
Nota: En caso que el atributo no contenga value_id, será requerido enviar el value_name. Respuesta soportando 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"
  ],
  "free_configurations": [
    {
      "condition": {
        "value": null,
        "type": "all"
      },
      "rule": {
        "default": true,
        "free_shipping_flag": true,
        "free_mode": "country",
        "value": null
      }
    },
    {
      "condition": {
        "value": null,
        "type": "all"
      },
      "rule": {
        "default": false,
        "free_shipping_flag": true,
        "free_mode": "exclude_region",
        "value": [
          "BR-NO",
          "BR-NE"
        ]
      }
    }
  ],
  "trusted_user": false,
  "mandatory_settings": {},
  "custom_calculator": false,
  "picking_type": null,
  "thermal_printer": null,
  "option": "in",
  "site_id": "MLB",
  "tags": [
    "optional_me2_allowed"
  ],
  "carrier_pickup": false,
  "history": [
    {
      "option": "in",
      "date": "2017-11-13T16:24:30.000-04:00",
      "mode": "me1"
    }
  ],
  "items_combination": "forbidden",
  "logistics": [
    {
      "mode": "me1",
      "types": [
        {
          "type": "default",
          "carrier_pickup": [],
          "services": [
            21,
            23,
            22,
            11
          ],
          "default": true
        }
      ]
    },
    {
      "mode": "me2",
      "types": [
        {
          "type": "drop_off",
          "carrier_pickup": [],
          "services": [
            21,
            23,
            22
          ],
          "default": true
        }
      ]
    },
    {
      "mode": "custom",
      "types": [
        {
          "type": "custom",
          "carrier_pickup": [],
          "services": null,
          "default": true
        }
      ]
    },
    {
      "mode": "not_specified",
      "types": [
        {
          "type": "not_specified",
          "carrier_pickup": [],
          "services": null,
          "default": true
        }
      ]
    }
  ],
  "services": [
    11,
    21,
    22,
    23
  ],
  "conciliation": {
    "type": null
  }
}
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) – 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 (a convenir) El envío se acordará entre el vendedor y el comprador. pending (pendiente) Los envíos se crean con este estado. handling (en manejo) El pago para este envío fue recibido. ready_to_ship (listo para envío) Se recibió el código de autorización del transportista. shipped (enviado) El transportista informó el despacho del envío. delivered (entregado) El transportista informó la llegada del envío. not_delivered (no entregado) El transportista no pudo entregar el paquete. cancelled El envío fue cancelado.

Introducción a Mercado Envios

Mercado Envios 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 Envios 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 y MCO.
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. Nota: Si la categoría tiene ME2 se ignorarán las dimensiones enviadas ya que se tienen en cueta las dimesiones establecidas en la categoría. 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":[

     	]
  	}
   }
]

Retiro en el local

El atributo local_pick_up permite que los compradores tengan la opción de retirar el artículo de la tienda sin incurrir en costos de envío. Configura local_pick_up en true para los vendedores ofrezcan esta opción a los compradores.
Artículos relacionados
Siguiente: Sincroniza publicaciones.

Forma parte de nuestra comunidad