ME1 Order status

Contents

→Shipping states and substates
→Update the status of a ME1 shipment
       ↳Inform tracking number
       ↳Mark order as dispatched
       ↳Mark as undelivered
       ↳Mark order as delivered

Shipping states and substates

The merging of the information from the status field and the shipping substate determines what will be notified to the buyers. Now it is possible to send the information of the dispatched order (shipped) or the failed delivery (not_delivered):

Status	Substatus	Description
shipped	null	Dispatched
not_delivered	returning_to_sender	Not delivered - Returned to seller
delivered	null	Delivered to buyer

Update the status of a ME1 shipment

To update the shipment status, you need to know the shipment_id of the order. To get it, make a request to the order resource.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$ORDER_ID/shipments

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/2339711980/shipments

Response:

{
    "id": 28264263908,
    "mode": "me1",
    "created_by": "receiver",
    "order_id": 2339711980,
    "order_cost": 99.9,
    "base_cost": 22.07,
    "site_id": "MLB",
    "status": "pending",
    "substatus": null,
    ...
}

Inform tracking number

The tracking number must be informed before sending the modifications in the status of the order, for that it is necessary to make a PUT to the /shipments resource:

Request:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_ID

Example:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/shipments/28264263908 -d '{"service_id": 11,"tracking_number": "OP123456789BR"}'

Response:

{
[ ]
    "date_created": "2020-08-19T16:18:57.000-04:00",
    "last_updated": "2020-08-19T16:19:57.899-04:00",
    "tracking_number": "OP123456789BR",
    "tracking_method": "Otros",
    "service_id": 11,
    "carrier_info": null,
    "sender_id": 419059118,
[ ]
}

Mark order as dispatched

To mark the dispatched order it is necessary to report the status as "shipped" and the substate as "null".

Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_ID/seller_notifications

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/shipments/28264263908/seller_notifications  \
{
   "payload":{
      "comment":"despachado",
      "date":"2020-02-28T16:03:51.175-04:00"
   },
   "status":"shipped",
   "substatus":"null"
}

Response:

{
    "status": "OK"
}

Mark as undelivered<

The status "not_delivered" is a final and irreversible status. It should only be used when there are no more delivery attempts. In this way, the seller has to align the flow so that the return of the buyer's money is made.
To mark the order as undelivered, you must report the status as "not_delivered" and the substate as "returning_to_sender".

Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_ID/seller_notifications

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/shipments/28264263908/seller_notifications  \
{
   "payload":{
      "comment":"Não entregue",
      "date":"2020-03-05T16:17:51.175-04:00"
   },
   "status":"not_delivered",
   "substatus":"returning_to_sender"
}

Response:

{
    "status": "OK"
}

Mark order as delivered

Upon receiving the information that a product was delivered to the buyer, you must make a change in the status of the order for delivery. For that, it uses the "delivered" state with the "null" substate. This status is also finalizing and irreversible.

Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_ID/seller_notifications

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/shipments/28264263908/seller_notifications  \
 {
   "payload":{
      "comment":"Pedido entregue",
      "date":"2020-03-06T16:17:51.175-04:00"
   },
   "status":"delivered",
   "substatus":"null"
}

Response:

{
    "status": "OK"
}