Ship products

The Mercado Libre's shipping department handles all the information about how a product goes from one user to another.

Contents

→Shipping modes
→Country specifications
→How do I know a user’s mode?
→Modes enabled as per listing category
→Shipping preferences
→Shipping methods
→Shipping status summary
→Mercado Envios introduction
→Differences between ME1 & ME2
→Not specified
→Local Pick Up


Shipping modes

Each site has a set of shipping methods available. They have different shipping times and costs. Sellers may offer free shipping in one or both methods. There is a special resource to view the methods available per site.

  • not_specified It means the seller did not specify any shipping price for their items and the buyer has to get in contact with the seller to agree on a shipping option and price for the purchase.
  • custom: Sellers can include a table of up to 10 shipping costs on an item, and the buyer must provide that number on the checkout process.
  • me1 (Mercado Envios mode 1) This method offers a shipping calculator to calculate the shipping cost for every order allowing the seller to choose the shipping service of his choice, but choosing a carrier and tracking number managment is handled by the seller.
  • me2 (Mercado Envios mode 2) This method provides the seller a prepaid label and tracking numbercode with a local predefined carrier in each country. Seller does not have to worry with choosing a carrier and handling the tracking number. This is the most recommended mode to use since it brings an excellent experience for buyers and sellers. the shipping company chosen by Mercado Libre.

Country specifications

name: Name of the shipping method.
Brasil Argentina México Colombia Chile Uruguay
Modes ME2, ME1, custom, not_specified The shipping method ID is used when posting a shipping item, ME1, custom, not_specified ME2, not_specified ME2, not_specified, custom ME2, not_specified, custom ME2, not_specified, custom
Free shipping Yes Yes Yes Yes Yes Yes
Regional exclusion for Free Shipping Yes, North and Northeast No No No No No
Carrier Correios Oca - Correo Argentino - Motonorte - Andreani - Ocasa DHL - Fedex - UPS ServiEntrega Chilexpress Correo Uruguayo - UES - Mirtrans
Restrictions on dimensions (C) Minimum 16 cm. Maximum 105 cm.
(L) Minimum 11 cm. Maximum 105 cm.
v(H) Minimum 2 cm. Maximum 105 cm.
70x70x70 250x250x250 130x60x30cm 80x80x120cm Correo Uruguayo: 1) Length less than a meter 2) Add two sides less than or equal to 1.5 mtrs.
UES: Length less than one meter 2) Sides less than 0.60m.
Mirtrans: 1) Length less than one meter 2) Sum of the sides less than or equal to 1.5 mtrs.
Maximum weight 30 kg. 25 kg. 80 kg. 50 kg. 50 kg. 30 kg.

*(C) Comprimento
(L) Long
(H) High

Important:
Mercado Envios mode 1 is only available for selected sellers from Argentina and Brazil who’ve reached a commercial agreement with Mercado Libre and are integrated.

How do I know a user’s mode?

When making a publication under a shipping method, there are some restrictions in certain categories. Use the aforementioned shipping_modes resource to verify if a seller can post an item with Mercado Envíos for a particular category.
The response indicates whether ME2 mode is available and the shipping methods that can be used.
You must make a POST including the attributes of the publication, without the need to send an access token. Information on the attributes of the category can be found at:

curl -X GET https://api.mercadolibre.com/users/$USER_ID?access_token=$ACCESS_TOKEN

This will return a large amount of information about the authenticated user, including the shipping_modes attribute.

Response:

"shipping_modes":[
    "custom",
    "not_specified",
    "me1",
    "me2"

]

Modes enabled as per listing category

Important:
From July 29, 2020, sellers with publications in categories or domains that allow Mercado Envíos 2 will be required to optin.

Also there are some restrictions on certain categories. Use the shipping_modes resource to verify if a seller can list an item with ME2 shipping for a given category. The response indicates if ME2 mode is available and the shipping methods that can be used.
Learn more the categories attributes.

Request:

curl -X POST https://api.mercadolibre.com/users/$USER_ID/shipping_modes

Example:

curl -X POST 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"
    }
    ]

  }
}

Response with 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"
   }
}

In the event that an item is published in a category that has me2 enabled and the seller has not opted to Mercado Envíos, in the response you will see only “mode”: “me2” and the “adoption”: “required” attribute like:

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

In this case, tell the seller to enter Mercado Libre, Mi cuenta, Ventas, Preferencias de venta and make the adoption to Mercado Envíos:




Shipping preferences

There’s also a public resource that will allow you to know any user shipping preferences in case you need. Just make the following request:

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

You'll be able to check the free shipping configuration (more information later on), modes and other stuff.


Shipping methods

Each site has a set of shipping methods available. They have different shipping times and costs. Sellers can offer free shipping in one or both of these methods. To see the available methods by site there is a special resource. URL for Brazil

https://api.mercadolibre.com/sites/MLB/shipping_methods

Response:

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

Response:

  • id – Shipping method ID is used when listing an item with shipping.
  • name – Name of the shipping method.
  • site_id – The site ID, the shipping method that it belongs to.
  • free_options– free options.

Shipping status summary

Shipping status may vary on the order depending the shipping mode selected for the product. For modes that support automatic tracking and tracking numbers are monitored, like with Mercado Envios mode 2, and mode 1 under some configurations, shipping status will be updated by us, while for custom shipping mode and other configurations of Mercado Envios mode 1, you’ll be responsible for sending a tracking number and update the shipping status. This is not mandatory but we suggest you to do it so you improve your chances of getting better feedback from the buyers.


Status:


to_be_agreed: Shipment will be agreed between the seller and the buyer..
pending: Shipments are created with this state
handling: Payment has been received for this shipment.
ready_to_ship: Authorization code has been received from carrier.
shipped: Carrier has informed shipment departure.
delivered: Carrier has informed shipment arrival.
not_delivered: Carrier was unable to deliver package.
cancelled:Shipment has been cancelled.


Mercado Envios introduction

Mercado Envios is our business unit that help sellers with lot of facilities to ship their products, actually active on MLA, MLB, MLM, MLC and MCO. As we specified before, there are two Mercado Envios options you can choose: mode 1 and mode 2.


Differences between ME1 & ME2

ME1 ME2
Good for big sellers that already deal with a carrier of their choice and have a process that takes care of calculating shipping costs, collect the payment, and printing shipping labels with the sale & shipping information. Best choice for medium & big sellers that need an intermediate to deal the carrier, helps both seller & buyer to keep track of the product, calculates shipping costs and takes care the whole shipping process, collecting the payment and printing shipping labels with all the sale & shipping information.
Only on MLA, MLC and MLB. Only on MLA, MLB, MLM, MLC, MLU & MCO.
Sellers choose the carrier. We have an agreement with the most trusted carriers of each country and offer sellers pre-paid shipping labels.
Sellers provide custom package dimensions or use default category standard dimensions. Sellers work with the standard dimensions of each category.
We calculate and fix shipping costs basing on origin, destination and package dimensions. We calculate and fix shipping costs basing on the origin, destination, price of the item, and package dimensions.
The seller gets the payment collected for the shipping immediately and takes care of paying the label and the carrier. We take care of collecting the money and paying for the shipping.
Supports free shipping. Seller takes care of charges for shipping the product. Supports free shipping. We send you a bill to pay charges for shipping the product.
Sellers are in charge of tracking the product and informing the shipping status to buyers. We keep track of the product and update the shipping status automatically for sellers and buyers.

Not specified

If, when you make a POST through Mercado Envíos, the category rejects it and it is added to this choice by default -although the user has not enabled it-, it is posted as item with shipping modes “not_specified”. If you don’t send any shipping information for the item, the default will be “not_specified”. Also, if there are no modes that support the given dimensions for your item, you should list under this mode. You can make a call to our API with your user_id, the category where you want to list, and your item dimensions to know what shipping modes you have available, if the dimensions are not supported, you’ll only get “not_specified” mode on the response. Note: If the category has ME2 they are ignored the dimensions sent.

Important:
If the category has ME2, the dimensions sent will be ignored since the dimensions established in the category are taken into account.

Example:

curl -X GET https://api.mercadolibre.com/users/:user_id/shipping_modes?category_id=MLB74723&dimensions=10x50x100,30001

Response:

[
   {
      "mode":"not_specified",
      "shipping_attributes":{
         "dimensions":"optional",
         "costs":"not_allowed",
         "accepted_methods":[

         ]
      }
   }
]
or register to recieve the latest news about our API