Ship products

The Mercadolibre’s shipping department handles all the information about how a product goes from one user to another.

Contents:

Shipping modes

As a quick summary, listings in MercadoLibre has 4 different shipping modes (please check what modes are available in your country):

  • 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 ML.

Country specifications

Brasil Argentina México Colombia Chile
Modes

ME2, ME1, custom, not_specified ME2, ME1, custom, not_specified ME2, custom, not_specified ME2, custom, not_specified ME2, custom, not_specified
Free Shipping Yes Yes Yes Yes Yes
Free Shipping region exclusion Yes, Norte and Nordeste No No No No
Carrier Correios Oca DHL ServiEntrega Chilexpress
Dimensions restrictions (C) Minimum 16cm Máximum 105cm – (L) Minimum 11cm Máximum 105cm – (A) Minimum 2cm Máximum 105 cm No restrictions 120cm 40x40x40cm 80x80x120cm
Maximum weight 30kg 25kg 70kg 30kg 50kg

Notes:

  • Mercado Envios mode 2 is available for sellers from Argentina, Brazil, Colombia and Mexico who want to opt-in to participate in the program.
  • Mercado Envios mode 1 is only available for selected sellers from Argentina and Brazil who’ve reached a commercial agreement with MercadoLibre and are integrated.

How do I know a user’s mode?

You can check if the user is already allowed to list with ME1 or ME2 shipping mode with a GET to the users API.

GET https://api.mercadolibre.com/users/:user_id?access_token=



This will return a lot of information about the authenticated user, one of which is the shipping_modes attribute.
Response:

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



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.

URL

https://api.mercadolibre.com/users/:user_id/shipping_modes?category_id=MLB39373

Response:

[
  {
    "mode": "custom",
    "shipping_attributes": {
      "dimensions": "optional",
      "costs": "required",
      "free": {
        "methods": "not_allowed",
        "accepted_methods": [
        ],
        "rules": [
        ]
      },
      "local_pick_up": "optional"
    }
  },
  {
    "mode": "not_specified",
    "shipping_attributes": {
      "dimensions": "optional",
      "costs": "not_allowed",
      "free": {
        "methods": "not_allowed",
        "accepted_methods": [
        ],
        "rules": [
        ]
      },
      "local_pick_up": "optional"
    }
  },
  {
    "mode": "me2",
    "shipping_attributes": {
      "dimensions": "optional",
      "costs": "not_allowed",
      "free": {
        "methods": "optional",
        "accepted_methods": [
          73328,
          73330
        ],
        "rules": [
          {
            "free_mode": "country",
            "value": null,
            "default": true,
            "free_shipping_flag": true
          }
        ]
      },
      "local_pick_up": "optional"
    }
  }
]



By default all users are allowed to list “not specified” and “custom” shipping. If a user is marked with either me1 or me2 you can see it as an option in shipping modes.

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 call:
Call:

 curl -X GET https://api.mercadolibre.com/users/:user_id/shipping_preferences
{
    "custom_calculator": false, 
    "free_configurations": [
        {
            "condition": {
                "type": "all", 
                "value": null
            }, 
            "rule": {
                "default": true, 
                "free_mode": "country", 
                "value": null
            }
        }, 
        {
            "condition": {
                "type": "all", 
                "value": null
            }, 
            "rule": {
                "default": false, 
                "free_mode": "exclude_region", 
                "value": [
                    "BR-NO", 
                    "BR-NE"
                ]
            }
        }
    ], 
    "local_pick_up": false, 
    "mandatory_mode_for_user": [], 
    "modes": [
        "custom", 
        "not_specified", 
        "me2"
    ], 
    "option": "in", 
    "picking_type": null, 
    "services": [
        21, 
        22, 
        23
    ], 
    "site_id": "MLB", 
    "thermal_printer": null, 
    "trusted_user": false
}



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
JSON 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 –

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.

Check full tables of shipping status and it’s substatus.

Mercado Envios overview

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

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

         ]
      }
   }
]


Local Pick Up

The local_pick_up attribute enables the option for buyers to choose to pick up the item from the store and not incur shipping costs. Set local_pick_up to true for sellers that offer this option to buyers.


Next topic: Sync listings


Related article

Please rate this