DOCS

同步订单追踪

同步订单追踪信息

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

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

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

将订单号添加到Zonos订单 

要将追踪号码添加到订单,您可以使用orderAddTrackingNumber变更。此变更需要您要添加追踪号码的订单的id,以及您要添加到订单的trackingNumbers。这将标记该订单为已发货,并将追踪信息链接到该订单。

变更

1
2
3
4
5
6
7
8
mutation OrderAddTrackingNumber {
  orderAddTrackingNumber(
    input: { id: "order_XXXXXXXXXXXXXX", trackingNumbers: "123123123" }
  ) {
    status
    trackingNumbers
  }
}

监听 Zonos 订单的跟踪更新 

您可以使用 SHIPMENT_CREATED webhook 来监听新货件创建时的订单。此 webhook 会在 Dashboard 中创建标签时触发,或者在使用 orderAddTrackingNumber 变更时将订单标记为已发货时触发。

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

这个页面有帮助吗?