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 指南 以了解更多關於如何設定 webhook 的資訊,並查看我們的 webhook 參考 以了解更多關於 SHIPMENT_CREATED webhook 承載內容的資訊。

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

這個頁面有幫助嗎?