How to notify shipments and provide tracking information

VIA WEB (Merchant Portal):

1. Go to Merchant Portal (http://cbt.mercadolibre.com/) and login

2. Select "orders" from the menu on the left

3. Find the order and click on "view details" on the right

4. Scroll down to the bottom and find the "Shipment Information" section, click on either "Mark Shipped" or "Add Shipment"

5. A dialog pops up, there you can select a carrier from the dropdown menu (or "other" and supply the name) Here you also have to complete the "tracking id" and "tracking url" fields with the info supplied by your carrier, like so:

6. You're all done!

Now the buyer can see and click on the tracking url for the shipment.

VIA API:

1. Once you get an order notification, you obtain the data pertaining to it as usual, for example through one of the following API calls (here exemplified using "curl"):

   1. Specific order:

      curl -X GET https://api-cbt.mercadolibre.com/api/orders/DMX1858967748?access_token=XXXXXX

   2. Last x day's orders (in this example x = 20):

      curl -X GET https://api-cbt.mercadolibre.com/api/orders/search/?days=20&status=confirmed&page=1&access_token=XXXXXX

      You will get your order details in the response (this is a reduced version of the response):

      {
         "orders": [
             {
                 ...
                 "order_id": "DMX1858967748",
                 "payment_status": "confirmed",
                 "product": [
                    {
                       "SKU": "Example_sku",
                       "mpid": 9011490570,
                       "quantity": 1,
                       ...
                    }
                 ],
                 ...
                 "shipment_label_location": null,
                 "status": "confirmed"
             }
         ]
      }

2. With data from this response you can complete the request to create the shipment and send the tracking information.

   curl -X POST -H "Content-type:application/json" -d '{
      "order_id": "DMX1858967748",
      "shipment_details": {
         "product": [{
            "mpid": "9011490570",
            "quantity": 1
         }],
         "tracking_id": "example-tracking-number",
         "tracking_url": "https://www.example-tracking-page.com/example-tracking-number",
         "carrier": "Example-Carrier"
     }
   }' https://api-cbt.mercadolibre.com/api/shipments?access_token=XXXXX

   Here the order_id, mpid and quantity can be found in the response from step 1. The "tracking_id", "tracking_url" and "carrier" is the data you have to supply in order to create the shipment. It is important that the tracking_url is fully functional- i.e., it must link directly to the tracking page of the carrier for the package. you will obtain a response confirming the creation of the shipment:

   {
      "shipment_details": {
          "carrier": "Example-Carrier",
          "international_tracking_url": "cbt.mercadolibre.com/trk/DMX1858967748",
          "product": [
             {
                "SKU": "Example-sku",
                "mpid": 9011490570,
                "product_title_english": "Example-product",
                "quantity": 1
             }
          ],
          "shipment_id": 702495,
          "shipment_status": "shipped_to_warehouse",
          "tracking_id": "example-tracking-number",
          "tracking_url": "https://www.example-tracking-page.com/example-tracking-number"
      }
   }

More info on this API calls is available in our CBT API Documentation.

VIA FLAT-FILE:

1. First, you should create a “comma separated values” file, similar to the one you might have used to add you skus to the CBT platform. The form this file should take is like this:

   order_id,tracking_id,tracking_url,carrier,mpid,quantity
   DMX50113966238402,123456788,https://www.carrierpage.com/tracking/123456788, Singapore Pos,9000001025,1

   It is important to note that the url you provide must link directly to the tracking page for that specific package

   (This example is for a single dispatch, but you should add a row for every dispatch you are making)

2. Once you have the file ready, follow the steps below:

   1. Log into your MercadoLibre CBT account,

   2. Go to Flat File > Upload Files,

   3. Select "Add Shipment",

   4. Select the file from your computer,

   5. Click "Upload".