Overview
Once an order is shipped (order.status == "SHIPPED"), there are two ways to monitor its logistics events (trackings):
- Through the order’s unique Tracking Portal URL
- Through monitoring of the parcel’s trackings via API
Tracking Portal URL
The tracking portal URL is a public URL that renders a web application, a.k.a. Tracking Portal, to display trackings to the buyer. This URL is integrated from e-CROSS to the sales channel when the order enters theSHIPPED status, and then the sales channel, usually, sends the link to the buyer via the “Order dispatched” email.
You can find the tracking URL after the order is in SHIPPED status in:
order.statusHistory[status="SHIPPED"].eventData.trackingUrl
Parcel Trackings
After an order enters theREADY_TO_SHIP status, it means the parcel is ready to be physically dispatched. From this point on, you can track the individual statuses via the Get Parcel Details API.
Identifying the Parcel ID
You can identify theparcelId via:
order.statusHistory[status="READY_FOR_SHIP"].eventData.parcelId
Parcel Statuses
Theparcel.status attribute gives you the macro step of the logistic route:
SHIPMENT_CREATED- The parcel has been createdSHIPPED- The parcel has been shippedARRIVED_DESTINATION_COUNTRY- The parcel has arrived in the destination country and is waiting for customs clearanceCUSTOMS_CLEARANCE- Parcel is in customs clearance processLAST_MILE- Customs clearance completed and parcel was delivered to the last mile providerDELIVERED- Parcel was delivered to the recipientSHIPMENT_CANCELED- Parcel was cancelled and won’t be delivered
