了解如何在 Zonos 與您的系統之間同步訂單追蹤資訊。
如果您正在建置與 Zonos 的整合,並在 Zonos 之外產生訂單追蹤資訊,例如透過您自己的貨運業者整合或第三方標籤供應商,您可以使用 Zonos API 將追蹤資訊新增至訂單。新增追蹤資訊會將訂單標記為已出貨,並將追蹤資訊傳送給客戶。
您也可以監聽 Zonos 訂單的追蹤更新,讓您的系統保持同步。如果您在 Dashboard 中產生所有標籤,並希望將追蹤/狀態資訊同步回您自己的系統,這項功能會很有幫助。本指南將詳細說明這兩種情境。
若要為訂單新增追蹤號碼,您可以使用 orderAddTrackingNumber mutation。此 mutation 需要您要新增追蹤號碼之訂單的 id,以及您要新增至該訂單的 trackingNumbers。這會將訂單標記為已出貨,並將追蹤資訊連結至該訂單。
orderAddTrackingNumber
id
trackingNumbers
mutation OrderAddTrackingNumber {
orderAddTrackingNumber(
input: { id: "order_XXXXXXXXXXXXXX", trackingNumbers: "123123123" }
) {
status
}
您可以使用 SHIPMENT_CREATED webhook,在訂單建立新貨件時接收通知。當在 Dashboard 中建立標籤時,或當使用 orderAddTrackingNumber mutation 將訂單標記為已出貨時,都會觸發此 webhook。
SHIPMENT_CREATED
如需設定 webhook 的詳細資訊,請參閱我們的 webhook 指南;如需 SHIPMENT_CREATED webhook payload 的詳細資訊,請參閱我們的 webhook 參考文件。
同步訂單追蹤
同步訂單追蹤資訊
了解如何在 Zonos 與您的系統之間同步訂單追蹤資訊。
如果您正在建置與 Zonos 的整合,並在 Zonos 之外產生訂單追蹤資訊,例如透過您自己的貨運業者整合或第三方標籤供應商,您可以使用 Zonos API 將追蹤資訊新增至訂單。新增追蹤資訊會將訂單標記為已出貨,並將追蹤資訊傳送給客戶。
您也可以監聽 Zonos 訂單的追蹤更新,讓您的系統保持同步。如果您在 Dashboard 中產生所有標籤,並希望將追蹤/狀態資訊同步回您自己的系統,這項功能會很有幫助。本指南將詳細說明這兩種情境。
為 Zonos 訂單新增追蹤號碼
若要為訂單新增追蹤號碼,您可以使用
orderAddTrackingNumbermutation。此 mutation 需要您要新增追蹤號碼之訂單的id,以及您要新增至該訂單的trackingNumbers。這會將訂單標記為已出貨,並將追蹤資訊連結至該訂單。mutation OrderAddTrackingNumber {orderAddTrackingNumber(input: { id: "order_XXXXXXXXXXXXXX", trackingNumbers: "123123123" }) {statustrackingNumbers}}監聽 Zonos 訂單的追蹤更新
您可以使用
SHIPMENT_CREATEDwebhook,在訂單建立新貨件時接收通知。當在 Dashboard 中建立標籤時,或當使用orderAddTrackingNumbermutation 將訂單標記為已出貨時,都會觸發此 webhook。如需設定 webhook 的詳細資訊,請參閱我們的 webhook 指南;如需
SHIPMENT_CREATEDwebhook payload 的詳細資訊,請參閱我們的 webhook 參考文件。orderAddTrackingNumber
這個頁面有幫助嗎?