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
→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

name (nombre) – Nombre del método de envío.
Brasil Argentina México Colombia Chile Uruguay
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

Importante:
Mercado Envíos modo 1 solo está disponible para vendedores seleccionados en Argentina y Brasil que tienen un contrato comercial con Mercado Libre y están integrados.

¿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.

Importante:
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":[

         ]
      }
   }
]

Forma parte de nuestra comunidad