新增訂單編號至 Zonos 訂單
如要為訂單新增追蹤編號,您可以使用 orderAddTrackingNumber mutation。此 mutation 需要您想新增追蹤編號的訂單的 id,以及您想新增至訂單的 trackingNumbers。這樣會將訂單標記為已出貨,並將追蹤資訊連結至該訂單。
1
mutation OrderAddTrackingNumber {2
orderAddTrackingNumber(3
input: { id: "order_XXXXXXXXXXXXXX", trackingNumbers: "123123123" }4
) {5
status6
trackingNumbers7
}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
MUTATIONS
同步訂單追蹤資訊
了解如何在 Zonos 與您的系統之間同步訂單追蹤資訊。
如果您正在建立與 Zonos 的整合,並在 Zonos 以外產生訂單追蹤資訊(例如透過您自己的速遞公司整合,或使用第三方標籤供應商),您可以使用 Zonos API 將追蹤資訊新增至訂單。新增追蹤資訊後,訂單會被標記為已出貨,並會將追蹤資訊傳送給客戶。
您亦可以監聽 Zonos 訂單的追蹤更新,以保持您的系統同步。如果您在 Dashboard 中產生所有標籤,並希望將追蹤/狀態資訊同步回您自己的系統,這項功能會十分實用。本指南將詳細說明以上兩種情況。