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。

如需設定 webhook 的詳細資訊,請參閱我們的 webhook 指南;如需 SHIPMENT_CREATED webhook payload 的詳細資訊,請參閱我們的 webhook 參考文件。

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

這個頁面有幫助嗎?


獲取支持·法律文件·© 2026 Zonos