Mercado Envios mode 2
Contents
→Opting in for using ME2 →Offering ME2 on your products →Free shipping →Shipping costs & handling time calculator →Print shipping labels →Zebra thermal printer (Only for Mercado Libre Colombia) →Considerations on label types by site →Shipping status
Opting in for using ME2
If you want to use Mercado Envios mode 2, you may opt-in. Please check these links:
Argentina: http://envios.mercadolibre.com.ar/
Brasil: http://envios.mercadolivre.com.br/
Colombia: http://envios.mercadolibre.com.co/
México: http://envios.mercadolibre.com.mx/
Chile: http://envios.mercadolibre.cl/
Uruguay: https://envios.mercadolibre.com.uy/
Offering ME2 on your products
Once you opt-in to work with ME you can add the option to your items. When a buyer buys your product he will need to introduce an address at checkout and pay for the product with the shipping costs included. We will follow the package and make sure it gets to the right place. The money for the payment will be available on your account two days after the delivery is successful. You will be able to add free shipping on your items and this will boost your listings on the search. Listing a product with ME2 is very simple, just list an item as usual, including me2 in the shipping array. Example:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d '{
"title": "Item de teste",
"category_id": "MLA91727",
"price": 1200,
"currency_id": "ARS",
"available_quantity": 2,
"buying_mode": "buy_it_now",
"listing_type_id": "bronze",
"condition": "new",
"description": "test",
"pictures": [
{
"source": "http://upload.wikimedia.org/wikipedia/commons/f/fd/Ray_Ban_Original_Wayfarer.jpg"
},
{
"source": "http://en.wikipedia.org/wiki/File:Teashades.gif"
}
],
"shipping": {
"mode": "me2",
"local_pick_up": false,
"free_shipping": false,
"free_methods": []
}
}' https://api.mercadolibre.com/items
Remember that to publish in categories marked as Fragile, the user should also be flagged as "fragile," and will need to have a business agreement. In the following API calls you must validate the fields that are shown below: "trusted_user": true (API users)
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": {
}
}
Example:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/categories/MCO7159/shipping_preferences
Response:
{
"category_id": "MCO7159",
"dimensions": {
"weight": 50000,
"height": 20,
"width": 60,
"length": 130
},
"logistics": [
{
"types": [
"default"
],
"mode": "me1"
},
{
"types": [
"drop_off",
"xd_drop_off",
"cross_docking",
"fulfillment"
],
"mode": "me2"
},
{
"types": [
"not_specified"
],
"mode": "not_specified"
},
{
"types": [
"custom"
],
"mode": "custom"
}
],
"restricted": true
}
Free shipping
Sellers can list their products offering one of the shipping methods for free and Mercadolibre charges the seller for the shipping cost. Know the details and learn how to list with free shipping.
Shipping costs & handling time calculator
On our Marketplace sellers will have a shipping calculator on the item description page so buyers will know the cost for the shipping and estimated handling time. You can use our resources to calculate this basing on the information you have .
Print shipping labels
A prepaid label is a PDF file that can be spent on the delivery of your product. It was already paid by the buyer, when he went through the checkout. Once you have an order paid by the buyer, you'll need to print the prepaid label. The shipments have to be in status ready_to_ship to be able to get a label (see later on how to check the shipment status). That means that the payment has been processed and the prepaid label is available for the seller. The API to obtain a label, or a set of labels, receives a list of shipment IDs and an access token and returns the labels on the format of your choice.
The options are PDF or ZPL. To get the shipping label on PDF format make the following call:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipment_labels?shipment_ids=20178600648,20182100995&response_type=pdf
The response will be a PDF file containing one or more prepaid shipping labels ready to print. If you want the shipping labels on ZPL format you need to change the response_type=pdf to response_type=zpl2 on the GET you make to the API. Example:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipment_labels?shipment_ids={shipping_id}&response_type=zpl2
This resource returns a ZIP file. This ZIP includes a PDF with the PLP and a TXT file. Now you can print the TXT file from your Zebra printer.
Zebra thermal printer (Only for Mercado Libre Colombia)
If you work on Mercadolibre Colombia (MCO), there is another print format available, the thermal for Zebra printers. You can perform that by the next call:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipment_labels?shipment_ids={shipping_id}&response_type=thermal_pdf
Paper configuration must be 100 x 213 millimeters.
Considerations on label types by site
Printing type | Printer | Availables sites | Response type | Output |
---|---|---|---|---|
Common printer | Argentina (MLA), México (MLM), Brasil (MLB), Colombia (MCO), Chile (MLC) and Uruguay (MLU) | response_type=pdf | PDF label | |
ZPL2 | Thermal printer | Argentina (MLA), México (MLM), Brasil (MLB), Chile (MLC), Uruguay (MLU), Colombia (MCO | response_type=pdf | Zip file with the tag in txt format and print summary in pdf format. |
Shipping status
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, the shipping status will be updated by us, while for other shipping modes, 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:
pending: Shipment is 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.