DOCS

同步訂單追蹤

同步訂單追蹤資訊

了解如何在 Zonos 與您的系統之間同步訂單追蹤資訊。

如果您正在建置與 Zonos 的整合,並且在 Zonos 之外自行產生訂單追蹤資訊,例如透過您自己的運送商整合或第三方標籤供應商,您可以使用 Zonos API 將追蹤資訊新增至訂單。新增追蹤資訊會將訂單標記為已出貨,並將追蹤資訊傳送給客戶。

您也可以監聽 Zonos 訂單上的追蹤更新,以保持您的系統同步。如果您是在 Dashboard 中產生所有標籤,並想將追蹤/狀態資訊同步回您自己的系統,這項功能會很有幫助。本指南將詳細說明這兩種情境。

為 Zonos 訂單新增訂單號碼 

若要為訂單新增追蹤號碼,您可以使用 orderAddTrackingNumber mutation。此 mutation 需要您要新增追蹤號碼的訂單 id,以及您想新增至該訂單的 trackingNumbers。這會將 訂單標記為已出貨,並將追蹤資訊連結至該訂單。

1mutation OrderAddTrackingNumber {
2 orderAddTrackingNumber(
3 input: { id: "order_XXXXXXXXXXXXXX", trackingNumbers: "123123123" }
4 ) {
5 status
6 trackingNumbers
7 }
8}

監聽 Zonos 訂單的追蹤更新 

您可以使用 SHIPMENT_CREATED webhook 來監聽新出貨建立時的訂單事件。當在 Dashboard 中建立標籤時,或當使用 orderAddTrackingNumber mutation 將訂單標記為已出貨時,都會觸發此 webhook。

如需更多有關如何設定 webhooks 的資訊,請參閱我們的 webhooks 指南,並 查看我們的 webhook 參考文件,以取得更多有關 SHIPMENT_CREATED webhook 內容的資訊。

GraphQL API ReferenceTypes, inputs, and operations used in this guide
預約演示

這個頁面有幫助嗎?