注文追跡情報の同期

Zonos との統合を構築しており、Zonos 以外で注文追跡情報を生成している場合、例えば独自の配送業者統合やサードパーティのラベルプロバイダーを使用している場合、Zonos APIを使用してZonos の注文に追跡情報を追加できます。Zonos の注文に追跡情報を追加すると、注文が出荷済みとしてマークされ、顧客に追跡情報が送信されます。

また、Zonos の注文の追跡更新をリッスンして、Zonos とあなたのシステムを同期させることもできます。これは、すべてのラベルをダッシュボードで生成し、追跡/ステータス情報を自分のシステムに同期させたい場合に便利です。このガイドでは、これらのシナリオの両方を詳細に説明します。

Zonos の注文に注文番号を追加する 

注文に追跡番号を追加するには、orderAddTrackingNumber ミューテーションを使用できます。このミューテーションには、追跡番号を追加したい注文の id と、注文に追加したい trackingNumbers が必要です。これにより、注文が出荷済みとしてマークされ、追跡情報が注文にリンクされます。

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

Zonos 注文の追跡更新をリッスンする 

新しい出荷が作成されるときに注文をリッスンするために、SHIPMENT_CREATED ウェブフックを使用できます。このウェブフックは、ダッシュボードでラベルが作成されたとき、または orderAddTrackingNumber ミューテーションを使用して注文が出荷済みとしてマークされたときにトリガーされます。

ウェブフックの設定方法についての詳細は、私たちの ウェブフックガイド をお読みください。また、SHIPMENT_CREATED ウェブフックペイロードに関する詳細は、私たちの ウェブフックリファレンス をご覧ください。