DOCS

同步订单跟踪

同步订单跟踪信息

了解如何在 Zonos 和您的系统之间同步订单跟踪。

如果您正在与 Zonos 构建集成,并在 Zonos 外部生成订单跟踪信息(例如使用您自己的运输承运人集成或第三方标签提供商),您可以使用 Zonos API 向订单添加跟踪信息。添加跟踪信息将标记订单为已发货并向客户发送跟踪信息。

您也可以监听 Zonos 订单上的跟踪更新以保持您的系统同步。如果您在 Dashboard 中生成所有标签并希望将跟踪/状态信息同步回您自己的系统,这将非常有用。本指南将详细介绍这两种情况。

向 Zonos 订单添加订单号 

要向订单添加追踪号码,您可以使用 orderAddTrackingNumber 变更。此变更需要您要向其添加追踪号码的订单的 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 变更标记订单为已发货时,将触发此 webhook。

阅读我们的 webhooks 指南 了解有关如何设置 webhook 的更多信息,并查看我们的 webhook 参考 了解有关 SHIPMENT_CREATED webhook 有效负载的更多信息。

GraphQL API ReferenceTypes, inputs, and operations used in this guide
预约演示

这个页面有帮助吗?