サブスクリプション型ECブランドが追跡APIで定期配送を追跡する方法
追跡APIで定期発送を追跡するには、物理的な各小包ごとに発送記録を作成し、それをその定期購入サイクルのフルフィルメント注文に紐付け、倉庫またはフルフィルメントパートナーから追跡番号が提供された時点で登録します。APIの追跡更新情報を使用して、その小包がどこにあるかを顧客に表示し、配送上の例外をチームに通知します。定期購入IDはサイクル間を結ぶリンクとして保持し、小包の識別子として使用しないでください。

定期購入ではなく小包を追跡する
定期購入は、顧客が時間の経過とともに何を受け取る予定かを示します。フルフィルメント注文は、1つのサイクルで何を発送する必要があるかを示します。追跡番号は、特定の小包に関する情報を示します。これらの記録を分けて管理することで、あるサイクルの遅延した発送が、次のサイクルの追跡ページに表示されるのを防げます。
たとえば、5月の定期購入ボックスが2つの小包に分かれ、5月分の小包の1つがまだ輸送中である間に6月分のボックスが発送されたとします。顧客には、5月の注文の下に2つの小包を、6月の注文の下に別の小包を表示する必要があります。5月分の遅延に関する更新は、5月の小包だけを変更する必要があります。交換品を発送する場合は、新しい発送記録を作成し、元の記録に紐付けて、サポート担当者が両方存在する理由を確認できるようにします。
- 定期購入: サポート担当者が顧客の発送履歴を検索できるよう、定期購入IDを保存します。
- サイクルと注文: サイクル識別子または予定フルフィルメント日、注文ID、および小包を正しい注文に紐付けるために必要なフルフィルメントIDを記録します。追跡イベントが到着した日付からサイクルを推測しないでください。
- 発送: 各小包に内部発送IDを付与します。配送業者と追跡番号、関連するフルフィルメント参照情報、プロバイダーから返される追跡登録IDを保存します。キャンセルされたラベルや置き換えられた追跡番号は、顧客向けのアクティブな表示から除外しますが、サポート用に履歴は保持します。
注文ページでは、注文概要とともに小包単位の進捗を表示します。1つの小包が配達済みで、別の小包が輸送中であれば、そのことを明示します。キャンセルされた発送と交換品を考慮したうえで、注文を完了するために必要なすべての小包が到着した場合にのみ、注文全体を配達済みと表示します。
フルフィルメントを追跡APIに接続する
- フルフィルメントイベントから登録する。 フルフィルメントシステム、倉庫、またはサードパーティの物流パートナーから配送業者と追跡番号が送信された時点で登録を開始します。更新支払いの時点では早すぎます。注文はまだ発送待ちで、追跡番号が存在しない可能性があるためです。
- APIを呼び出す前に発送を保存する。 内部発送記録を永続化し、登録リクエストをキューに入れます。同じフルフィルメントメッセージが2回届いた場合は、別の小包を作成せず、その記録を再利用します。API呼び出しがタイムアウトした場合、プロバイダーが確認手段を提供しているなら、再試行する前に元のリクエストが成功したか確認します。
- 更新情報を登録済みの小包に紐付ける。 更新情報にプロバイダーの登録識別子が返される場合は、それを使用します。それ以外の場合は、ドキュメントで指定されている識別子を使って照合し、発送記録と照合して結果を検証します。更新情報が複数の記録に該当する可能性がある場合は、最新の注文に適用せず、確認のために送ります。
- ラベルの作成と配送業者の移動を分ける。 追跡番号は、配送業者が荷物を保有したことを記録する前に存在する可能性があります。ラベルしかない場合は、「配送業者の集荷を準備中」などのメッセージを使用します。「輸送中」は、それを裏付ける配送業者の情報がある場合に限って使用します。
17TRACK Tracking APIは、この構成に利用できる選択肢の1つです。その開発者向けドキュメントは、追跡番号の登録と追跡更新情報の受信に関するリファレンスです。これらの更新情報を使用してシステム内の小包記録を維持し、サイクルの割り当て、注文完了、顧客通知のルールはECアプリケーション側で管理します。導入前には、配送業者のリストだけに頼らず、実際の配送業者の経路とフルフィルメントパートナーからの小包を使ってテストしてください。
更新情報を2回処理しても安全な仕組みにする
プロバイダーがwebhookを提供している場合は、それを使用して更新情報を受信し、すべての小包を継続的にポーリングするのを避けます。webhookとは、プロバイダーがアプリケーションに送信するHTTPリクエストです。プロバイダーの検証要件に従い、受け入れたペイロードを永続的に保存し、文書化されたレスポンスルールに従ってリクエストを確認します。注文表示の更新やメール送信などの時間のかかる処理は、リクエストハンドラーの外で実行します。
同じ更新情報が繰り返されても追加の影響が生じないよう、処理経路を構築します。プロバイダーが安定したイベントIDを提供する場合は、それを使って重複を認識します。個々のイベントではなく追跡スナップショットを送信する場合は、処理を実行する前に、受信した状態とスキャン履歴を既存の情報と比較します。顧客メッセージの重複排除は別途行います。同じ発送データが2回処理されたからといって、すでに送信済みの配達通知を再送してはいけません。
スキャンが発生した時刻と、アプリケーションがそれを受信した時刻を分けて保持します。遅れて到着した輸送中スキャンは、より新しい配達済みステータスを置き換えることなく、小包履歴に追加できる場合があります。ただし、正当な変更がすべて小包を前進させるとは限りません。配送業者による訂正や差出人への返送更新によって、表示内容を変更する必要が生じる場合があります。新しいデータが保存済みの状態と矛盾し、どちらが正しいか判断できない場合は、発送を確認待ちキューに入れます。
対応が必要な可能性のある未完了の発送について、定期的に確認します。登録がまだ保留中のもの、予定された引き渡し後も最初のスキャンがない小包、追跡情報の更新が途絶えた発送などが対象です。APIが検索または更新に対応している場合は、プロバイダーの制限内で選択的に使用します。エスカレーションする前に、配送業者や倉庫をまたいだパターンを確認します。多くの無関係な発送で同時に更新が停止した場合は、個別の配送案件を開く前に連携を調査します。
追跡データを役立つ顧客メッセージに変える
顧客がすべてのスキャンについてメールを必要とすることはほとんどありません。小包が配送業者のネットワークに入った、配達の試みに対応が必要、配送業者が配達を報告したなど、顧客が知る必要や行動する必要のある事柄に結び付いたメッセージから始めます。注文参照情報と関連するボックスまたはサイクルを表示し、定期購入者がどの発送についてのメッセージか分かるようにします。分割注文の場合は、小包を特定し、注文の残りがまだ輸送中かどうかを明確にします。
- ラベル作成済み、スキャンなし: 予定された引き渡しと倉庫記録を照合します。引き渡し期間を過ぎている場合は、顧客に輸送遅延を伝える前に、発送施設を出発したかどうかをフルフィルメント担当に確認します。
- 追跡情報の更新が止まっている: すべての小包に同じタイマーを使うのではなく、経路とサービスを反映した基準を使用します。国際発送では、顧客に連絡するかエスカレーションするかを決める前に、最後の配送業者イベントを確認します。
- 配達失敗または受け取りが必要: 配送業者が明確な指示を提供している場合は、必要な対応を顧客に伝えます。イベントが曖昧な場合は、再配達日や受取場所を推測せず、サポートに回します。
- 配達済みだが受け取っていない: 配送業者が報告したステータスを保持し、別のサポート案件を開きます。サポートワークフローでは、顧客からの申告と配送業者による訂正を区別する必要があります。
サポート担当者に、サイクル、注文、小包履歴、すでに送信したメッセージを1つの画面で確認できるようにします。各例外に担当者と次のステップを割り当てます。フルフィルメント担当は引き渡し不明を調査し、物流担当は配送業者の例外をフォローアップし、サポート担当は顧客とのコミュニケーションを処理できます。追跡ステータスは小包を説明するものであり、交換品や返金が必要かどうかを決めるものではありません。
導入前に重複ケースをテストする
まず1つのフルフィルメントパートナーと、そのパートナーが実際に注文を発送する方法を反映した発送セットから始めます。複数の小包があるサイクル、無効化されたラベル、交換品、次のサイクルが発送された時点でもまだ未完了の古い発送を含めます。次に、重複したwebhookを意図的に再送し、新しいイベントの後に古いイベントを配信します。小包記録、顧客の注文ページ、サポート画面、通知ログを確認します。APIレスポンスの成功だけを確認するテストでは、最も高くつく間違い、つまり誤った注文を更新したり、誤った顧客にメッセージを送ったりすることを見逃す可能性があります。
登録失敗、登録対象となる小包のうち正常に登録された割合、予想より遅い初回スキャン、紐付けできなかった更新情報を監視します。更新遅延を追跡する場合は、配送業者イベントの発生から受信までの時間と、自社システムが処理するのにかかる時間を区別します。これにより、配送業者のフィード、webhookエンドポイント、アプリケーション内部のキューのどれを調査すべきか判断できます。
任意の小包について、次の3つの質問に答えられるようになったら、さらに多くの経路へ拡大します。その小包はどのサイクルに属するか。配送業者が最後に報告した内容は何か。更新が欠落または誤っている場合、誰が対応するか。いずれかの答えが不明確なら、通知ルールを追加する前に、記録の紐付けまたは例外ワークフローを修正します。
FAQ
追跡APIで、次回の定期購入ボックスがいつ発送されるかを顧客に知らせることはできますか?
次回の予定発送日については、定期購入のスケジュールとフルフィルメントシステムを使用します。追跡APIは、追跡情報が存在する特定の小包を対象とします。予定発送日、配送業者による配達予定、配達確認済みは異なる事実であり、それぞれ別々に表示する必要があります。
メール送信後に倉庫が追跡番号を変更した場合はどうなりますか?
古いラベルを置き換え済みとしてマークし、新しい追跡番号を同じ注文に紐付けます。メールが注文単位の追跡ページを指している場合は、そのページを更新し、顧客が元の配送業者リンクを必要とせずに有効な小包を見つけられるようにします。変更が顧客の行動に必要な情報に影響する場合は、訂正を送信します。
フルフィルメントパートナーが配送業者コードなしで追跡番号を送信した場合はどうなりますか?
パートナーに一貫した配送業者フィールド、または配送サービスコードとのマッピングを依頼します。APIが配送業者の自動判定に対応している場合は、パートナーのラベルでの精度を確認してから利用します。追跡番号だけを基に配送業者を選択せず、曖昧な照合結果は確認に回します。
一時停止またはスキップされた定期購入にも追跡記録は必要ですか?
発送されないサイクルには小包記録は必要ありません。以前の発送がまだ未完了の場合は、定期購入が一時停止、スキップ、キャンセルされていても追跡を続けます。定期購入の状態は将来のフルフィルメントを制御するものであり、すでに倉庫を出た小包に何が起きたかを示すものではありません。
出典
- 17TRACK Tracking API — 業務システムに小包追跡を統合するための製品概要。
- 17TRACK Tracking API documentation — 追跡番号の登録と追跡データの受信に関する実装リファレンス。
- Stripe webhook documentation — 重複イベントの処理や配信順序を仮定しないことなど、一般的なwebhook運用のリファレンス。検証と確認応答については、利用する追跡プロバイダー独自のルールに従ってください。


