同步订单追踪信息

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

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

将订单号添加到Zonos订单 

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

mutation OrderAddTrackingNumber {
  orderAddTrackingNumber(
    input: { id: "order_XXXXXXXXXXXXXX", trackingNumbers: "123123123" }
  ) {
    status
    trackingNumbers
  }
}

监听 Zonos 订单的跟踪更新 

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

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