Mercado Envíos

Es nuestra unidad de negocio que ayuda a los vendedores con muchas facilidades para enviar sus productos. Actualmente se encuentra activo en MLA, MLB, MLM, MLC y MCO. Ahora veamos las diferencias entre Mercado Envíos 1 y 2, y detalles de cada uno. Conoce más sobre envíos para vendedores y mira nuestro webinar para integrarte:





Contenidos

→Modos de envío por país
→Modos habilitados para un usuario
→Modos habilitados según la categoría de la publicación
→Preferencias de envío
→Estados del envío



Modos de envíos por país

Cada sitio cuenta con un conjunto de métodos de envío disponibles y estos presentan diferentes tiempos y costos de envío. Además de Mercado Envíos 1 y 2, los vendedores pueden ofrecer Retiro en sucursal o Envío personalizado. Con la siguiente llamada puedes consultar los modos de envío disponibles en cada país: 

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/shipping_methods

Respuesta:

[
  {
    "id": 502845,
    "name": "Retiro en sucursal OCA Prioritario",
    "type": "express",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": null,
    "company_id": null,
    "company_name": null,
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 501045,
    "name": "Retiro en OCA",
    "type": "standard",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17500240,
    "company_name": "OCA",
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 501145,
    "name": "Estándar",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me1"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 505545,
    "name": "Envío internacional",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me1"
    ],
    "company_id": 17502940,
    "company_name": "CBT Argentina",
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 505045,
    "name": "Retiro en Andreani",
    "type": "standard",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17502540,
    "company_name": "Andreani",
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 504845,
    "name": "Seller local",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me1"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 506245,
    "name": "Rápido a domicilio",
    "type": "super_express",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 0,
    "max_time": 24,
    "currency_id": "ARS"
  },
  {
    "id": 501146,
    "name": "Prioritario",
    "type": "express",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me1"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 73330,
    "name": "Prioritario a domicilio",
    "type": "express",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17500240,
    "company_name": "OCA",
    "min_time": 0,
    "max_time": 72,
    "currency_id": "ARS"
  },
  {
    "id": 73328,
    "name": "Normal a domicilio",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17500240,
    "company_name": "OCA",
    "min_time": 72,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 504245,
    "name": "Normal a domicilio",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17500940,
    "company_name": "Reprocesos Carrito",
    "min_time": 72,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 510445,
    "name": "Prioritario a domicilio",
    "type": "next_day",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 24,
    "max_time": 24,
    "currency_id": "ARS"
  },
  {
    "id": 511545,
    "name": "Estándar a domicilio",
    "type": "four_days",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 96,
    "max_time": 96,
    "currency_id": "ARS"
  },
  {
    "id": 510245,
    "name": "Devolución Estándar",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17501440,
    "company_name": "Correo Argentino",
    "min_time": 24,
    "max_time": 96,
    "currency_id": "ARS"
  },
  {
    "id": 510545,
    "name": "Express a domicilio",
    "type": "two_days",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 48,
    "max_time": 48,
    "currency_id": "ARS"
  },
  {
    "id": 510945,
    "name": "Estándar a sucursal de correo",
    "type": "three_days",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 72,
    "max_time": 72,
    "currency_id": "ARS"
  },
  {
    "id": 506345,
    "name": "Rápido a domicilio",
    "type": "super_express",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 0,
    "max_time": 48,
    "currency_id": "ARS"
  },
  {
    "id": 507045,
    "name": "Test Flex [NO USAR]",
    "type": "super_express",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 2160,
    "max_time": 2400,
    "currency_id": "ARS"
  },
  {
    "id": 506445,
    "name": "Rápido a domicilio",
    "type": "super_express",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 24,
    "max_time": 48,
    "currency_id": "ARS"
  },
  {
    "id": 513146,
    "name": "Proximity Express",
    "type": "proximity_express",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 0,
    "max_time": 99,
    "currency_id": "ARS"
  },
  {
    "id": 503045,
    "name": "Retiro en Correo Argentino",
    "type": "standard",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17501440,
    "company_name": "Correo Argentino",
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 512747,
    "name": "Prioritario a domicilio",
    "type": "same_day",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 1,
    "max_time": 1,
    "currency_id": "ARS"
  },
  {
    "id": 511546,
    "name": "Estándar a sucursal de correo",
    "type": "four_days",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 96,
    "max_time": 96,
    "currency_id": "ARS"
  },
  {
    "id": 510845,
    "name": "Express a sucursal de correo",
    "type": "two_days",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 48,
    "max_time": 48,
    "currency_id": "ARS"
  },
  {
    "id": 510645,
    "name": "Estándar a domicilio",
    "type": "three_days",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 72,
    "max_time": 72,
    "currency_id": "ARS"
  },
  {
    "id": 510745,
    "name": "Prioritario a sucursal de correo",
    "type": "next_day",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 24,
    "max_time": 24,
    "currency_id": "ARS"
  },
  {
    "id": 504945,
    "name": "Normal a domicilio",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17502540,
    "company_name": "Andreani",
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 505645,
    "name": "Envío internacional",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me1"
    ],
    "company_id": 17502940,
    "company_name": "CBT Argentina",
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 504345,
    "name": "Retiro en una sucursal",
    "type": "standard",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": null,
    "company_id": 17500940,
    "company_name": "Reprocesos Carrito",
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  }
]

Campos de la respuesta:

id: 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: ID del sitio al que pertenece el método de envío.
free_options: opciones gratis.
shipping_modes: modos de envíos.

  • me1: Mercado Envíos 1 ofrece un calculador de envíos para obtener el costo de envío de cada pedido y el vendedor selecciona el servicio de envío de su preferencia eligiendo un transportista. También, se encargará de administrar el número de seguimiento (tracking number).
  • me2: Mercado Envíos 2 es el modo más recomendado porque ofrece una mejor experiencia para vendedores y compradores. Mercado Libre genera una etiqueta que el vendedor debe imprimir y un código de seguimiento con un transportista local predefinido, es decir, el vendedor no debe ocuparse en elegir un transportista ni gestionar el número de seguimiento.
  • 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.
  • 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. Si no envías 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. Si la categoría no soporta las dimensiones de tu producto, solo tendrás "not_specified" en la respuesta. Por último, si la categoría tiene ME2 se ignorarán las dimensiones enviadas, ya que se tienen en cuenta las dimensiones establecidas en la categoría.

Consultar modos habilitados para un usuario

Con el recurso shipping_modes para verificar si un vendedor puede publicar un ítem con Mercado Envíos para una categoría determinada. La respuesta indicará si tiene disponible Mercado Envíos 2 y los métodos que pueda utilizar.
Luego, deberá realizar un POST incluyendo los atributos de la publicación. 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

Recuerda que existen algunas restricciones en ciertas categorías, por eso te recomendamos consultar los modos habilitados según la categoría de los productos. 

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/categories/$CATEGORY_ID/attributes

Realiza un POST incluyendo los atributos de la publicación.

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -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 puedes conocer las preferencias de envío de cualquier usuario.

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":{
      
   }
}

Estados del envío

Para determinados modos de envíos, desde Mercado Libre realizamos un seguimiento automático y monitoreo de los números de seguimiento. Los estados son internos y alterados por Mercado Libre.


Pueden ser:

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.


Para Envío personalizado y otras configuraciones de Mercado Envíos 1, serás responsable de enviar un número de seguimiento y actualizar el estado del envío.


Conoce más sobre Mercado Envíos.


Siguiente: Mercado Envíos 1.

o regístrate para recibir las últimas novedades sobre nuestra API