海外倉庫が追跡APIを利用して現地配送を監視する方法
海外の倉庫では、出荷する各荷物を配送業者と追跡番号に紐づけ、追跡イベントを倉庫管理システムや注文管理システムに取り込み、配送例外を担当タスクに変換することで、追跡APIを利用して現地配送を監視できます。最も有用な構成では、ラベル作成と配送業者による受領を区別し、配送履歴を保持するとともに、単に新しいステータスが付いた荷物ではなく、対応が必要な荷物を業務チームに知らせます。
このガイドでは、販売業者の本拠地市場外で在庫を保管し、その仕向け先市場の顧客へ注文を発送する倉庫を対象とします。こうしたチームにとって、海外追跡では、倉庫の発送記録と現地配送業者による配送過程を接続する必要があります。この接続により、倉庫管理者、輸送コーディネーター、販売業者のサポートチームが、同じ配送記録を基に業務を行えるようになります。
倉庫の可視性が終了し、配送業者の可視性が始まる地点を定義する
倉庫管理システムには、注文がピッキング、梱包、ラベル貼付され、発送エリアに置かれたことを記録できます。しかし、これらの記録だけでは、配送業者が荷物を受領したことを証明できません。追跡APIは配送業者が報告するイベントを追加できますが、倉庫の引き渡し記録に取って代わったり、実際には発生していない物理スキャンを作成したりすることはできません。
次の3つのマイルストーンを分けて管理します。集荷の準備ができた状態、倉庫の記録上で引き渡された状態、そして配送業者の追跡イベント上で受領された状態です。この分離により、社内では発送済みと表示されているものの、配送業者側の動きがない荷物を調査しやすくなります。
たとえば、荷物が集荷マニフェストに記載されているにもかかわらず受領イベントがない場合、次に行うべきことは積み込み記録を確認し、集荷配送業者に連絡することです。荷物を紛失と判断するのは時期尚早です。配送業者がすでに配送試行の失敗を報告している場合は、適切な対応が異なります。理由を調査し、販売業者または承認された受取人の連絡先と次の対応を調整します。
APIに接続する前に配送記録を構築する
基盤となるのは、顧客注文、物理的な荷物、配送業者の追跡識別子の間に信頼できる関連付けを構築することです。荷物識別子の代わりに注文番号を使用しないでください。1つの注文が複数の荷物に分かれて倉庫を出る場合があり、交換品の発送には独自の記録が必要です。
| 記録 | 推奨フィールド | 業務上の目的 |
|---|---|---|
| 配送識別情報 | 社内配送ID、注文ID、荷物ID、販売業者アカウント | 分割配送と異なる顧客を分けて管理する。 |
| 配送業者識別情報 | 配送業者識別子、追跡番号、判明している場合はサービス | 正しい追跡リクエストを送信し、調査を適切な経路に振り分ける。 |
| 倉庫での引き渡し | 倉庫、発送時刻、集荷照会番号、マニフェスト照会番号 | 物理的な発送証拠と配送業者イベントを比較する。 |
| 追跡履歴 | 元のイベント、マッピング後のステータス、イベント時刻、受信時刻、提供された場合は場所 | 証拠を保持し、イベント発生時刻と報告遅延を区別する。 |
| 例外ワークフロー | 問題の種類、担当者、次の対応、確認期限、解決内容 | 追跡情報を責任の所在が明確な業務に変換する。 |
追跡番号は書式を保持できるよう、テキストとして保存します。倉庫がラベル作成時点ですでに配送業者を把握している場合は、番号認識だけに頼らず、その識別情報を連携処理に渡します。また、元の荷物、交換品、返品、再配送の荷物の関係を保持し、それぞれの履歴を上書きしないようにします。
倉庫の配送業者構成に合った連携方法を選ぶ
倉庫は配送業者と直接連携することも、複数配送業者対応の追跡APIを利用することもできます。少数の配送業者を利用する安定した業務で、特に配送業者固有のデータが必要な場合は、直接連携が実用的です。複数の配送ネットワークにまたがる共通の追跡インターフェースが必要な場合は、複数配送業者対応APIを評価する価値があります。
17TRACKのTracking APIは、この連携モデルに適した選択肢です。公式APIドキュメントを使用して、配送登録、追跡情報の取得、追跡更新が自社システムにどのように適合するかを確認してください。一般的な配送業者の対応状況を、必要なすべてのイベントが返される証拠とみなすのではなく、各倉庫で実際に使用する配送業者とサービスの組み合わせを確認します。
実際の業務要件に照らして接続を評価します。
- 発送のピーク時に生成された荷物を、システムで確実に登録できますか?
- 実際に購入している現地配送サービスでは、どのイベントが返されますか?
- 失敗したリクエスト、重複登録、無効な配送業者識別子はどのように処理されますか?
- 更新はどのように配信または取得され、取りこぼした更新をどのように照合できますか?
- アカウントにはどのような利用制限、保持条件、セキュリティ管理、商用条件が適用されますか?
追跡接続に、ラベル購入、住所訂正、配送日時の変更、クレーム申請が含まれると想定してはいけません。関連する製品ドキュメントで明示的に確認されていない限り、これらは別のワークフローとして扱います。
発送、追跡更新、例外処理を接続する
1. 管理された発送マイルストーンで荷物を登録する
ラベル確認や発送確認など、一貫した登録トリガーを選択します。ラベル作成時に登録すると、集荷されていない荷物を把握できますが、キャンセルされたラベルへの対応も必要になります。発送後にのみ登録すると未使用の登録を減らせますが、ラベル作成から物理的な引き渡しまでの間を把握できなくなる可能性があります。
どのトリガーを選択する場合でも、登録結果を荷物に紐づけて保存します。登録に失敗した場合は、アプリケーションログに埋もれさせず、再試行または修正キューに入れます。安定した社内識別子を使用し、繰り返し処理によって重複した業務記録が作成されるのを防ぎます。
2. ダッシュボードを唯一の正確な情報源にせず、更新を受け取る
APIのドキュメントに記載されたオプションによっては、リクエストで更新を取得することも、Webhook通知で受け取ることもできます。Webhookとは、プロバイダーに更新があった際にシステムへ送信されるメッセージです。ポーリングとは、システムが情報をリクエストする方式です。
Webhookベースの実装では、プロバイダーが文書化した検証方法を使って受信メッセージを検証します。承認したメッセージを確認応答する前に永続的に保存し、その後非同期で処理します。重複メッセージや順序どおりに到着しないイベントを想定して設計します。すべてのプロバイダーが同じように動作すると仮定せず、文書化された応答要件と再試行要件に従います。
ポーリングでは、適用される利用制限を守りながら、配送中の荷物と未解決の例外を優先します。対応している場合は、更新履歴が不完全に見える荷物を確認するため、照合リクエストを使用します。取り込みの失敗と配送業者による配送例外は別々に記録します。接続障害は、荷物の移動が止まった証拠ではありません。
3. 元の証拠を保持しながらステータスを標準化する
受領待ち、配送中、配達中、配達試行、配達完了、返品輸送中など、少数の業務カテゴリーを作成します。これらは推奨される倉庫カテゴリーであり、すべての配送業者が一致するイベントを提供することを保証するものではありません。
マッピング後のカテゴリーとともに元の説明を保持します。「集荷可能」を黙って「配達完了」に変換したり、「返品開始」を「倉庫に返送済み」に変換したりしてはいけません。不明または未マッピングの状態を許可し、未知のイベントが確認のために表示され続けるようにします。
イベントのタイムスタンプと、システムがそれを受信した時刻の両方を保存します。提供されている場合は元のタイムゾーンまたはオフセットを保持し、社内では一貫した時刻基準を使用します。遅れて到着したイベントが最後に受信されたという理由だけで、配送を自動的に前の状態へ戻してはいけません。明示的な順序付けルールを適用し、履歴を保持します。
4. 例外に対応担当者を割り当てる
アラートは、誰かが対応できる場合にのみ役立ちます。受領スキャンの欠落は倉庫の発送チームへ、受取人の対応が必要な配達試行は販売業者のサポートチームへ、配送業者の移動に関する継続的な問題は輸送コーディネーターへ振り分けます。これは推奨される出発点であり、責任分担は倉庫の契約と運用モデルに合わせる必要があります。
各ケースに追跡履歴、引き渡し照会情報、最後のイベント、調査メモ、次回確認時刻を添付します。同じ未解決の問題に繰り返し発生するアラートをまとめ、停止した荷物が同期のたびに新しいタスクを生成しないようにします。
任意のタイマーではなく、サービス期待値を基準にアラートを設定する
新しいスキャンがない荷物が遅延または紛失になるまでの普遍的な時間間隔はありません。配送業者のサービス、集荷スケジュール、営業日、仕向け地、販売業者との約束を基準にアラートのしきい値を設定します。社内調査のしきい値と、顧客向けの配送約束は分けて管理します。
- 引き渡し後に受領がない:エスカレーションする前に集荷記録と配送業者の受領確認を確認します。
- 期待される期間を超えて移動がない:最後のイベント、サービスの期待値、既知の業務中断を確認します。
- 配達試行の失敗:次の対応が配送業者、販売業者、受取人のいずれに属するかを判断する前に理由を確認します。
- 返品輸送:返品ワークフローを準備しますが、物理的な受領と必要な検品が完了するまで販売可能在庫を増やしません。
- 配達済みだが異議がある:調査を開始し、利用可能な配達証拠を確認します。ステータスだけで申し立てが解決したとみなしてはいけません。
追跡が示すのは報告された配送イベントであり、荷物の継続的な位置情報ではありません。最終更新時刻を表示すると、ライブGPSの可視性を示唆することなく、スタッフが情報の新しさを理解できます。
各チームに使いやすい表示を提供する
倉庫の監督者には、発送から受領までの例外が必要です。輸送コーディネーターには、配送業者別のキューと経過時間の長いケースが必要です。販売業者のサポートチームには、明確な配送タイムラインと、次に合意された対応が必要です。共有データモデルにより、すべてのユーザーにすべての販売業者の配送情報へのアクセスを与えることなく、これらの表示をサポートできます。
複数顧客を扱う倉庫では、販売業者単位のアクセス制御をダッシュボードのフィルターだけでなく、サーバー側で適用します。API認証情報をブラウザーコードに置かず、受取人情報へのアクセスを制限し、保持と削除のルールを定義します。追跡参照や診断ログに不要な個人データを含めないでください。
有用な指標には、追跡登録に成功した発送済み荷物の割合、配送業者の受領イベントがある荷物の割合、発送から受領までの時間、未解決の例外の経過時間、連携処理の失敗などがあります。各分母と時間基準を定義します。定時配送を測定する場合は、一般的な配送所要時間ではなく、文書化された約束またはサービスコミットメントと比較します。
拡大する前にワークフローを試験導入する
明確に定義した倉庫、配送業者の組み合わせ、販売業者グループから始めます。通常の配送だけでなく、キャンセルされたラベル、分割注文、初回スキャンの欠落、配達試行の失敗、重複通知、順序外のイベント、返品などの難しい記録も含めます。適切な場合は承認済みのテストデータまたは履歴記録を使用し、本番環境で配送業者のイベントを作り出してはいけません。
開始前に受け入れ基準について合意します。発送されたすべての荷物には、登録成功記録または担当者が割り当てられた失敗ケースのいずれかが必要です。再生されたメッセージによって重複タスクが生成されてはいけません。追跡イベントは発生元まで追跡可能である必要があり、ユーザーが別の販売業者の記録を閲覧できないようにします。
業務スタッフが例外キューを確実に処理し、技術スタッフが失敗した更新を復旧できるようになってから拡大します。実務上の目標は、ステータスで埋め尽くされたダッシュボードではありません。倉庫の発送から配送業者の配達までを追跡可能な形で接続し、その過程に対応が必要な場合には責任の所在を明確にすることです。
FAQ
追跡APIは倉庫管理システムの代わりになりますか?
いいえ。追跡APIは配送の可視性を提供します。倉庫システムは、在庫管理、ピッキング、梱包、物理的な発送記録などの業務を引き続き担当します。荷物識別子を通じて両者を接続し、配送業者のイベントが倉庫の証拠に取って代わるのではなく、補足情報を加えるようにします。
追跡APIはリアルタイムのGPS位置情報を提供しますか?
そうとは限りません。荷物追跡は通常、報告されたイベントと位置情報で構成されます。更新のタイミングは配送業者と連携方法によって異なります。車両または荷物の継続的な位置情報には、別途確認された機能が必要です。
荷物の追跡更新がない場合、スタッフは何をすべきですか?
まず登録の成功、配送業者の識別情報、追跡番号の正確性を確認します。次に、最後のイベントを倉庫の引き渡し証拠と想定されるサービスのタイムラインと比較します。どのチームがエスカレーションすべきかを判断する前に、連携の失敗と配送業者側のスキャン欠落を別々に調査します。
追跡イベントによって返金や在庫更新を自動的に実行できますか?
ワークフローに情報を提供することはできますが、重要な処理には追加の管理が必要です。配送例外が必ずしも返金対象であることを証明するわけではなく、返品輸送が倉庫で物理的に受領されたことを証明するわけでもありません。金銭または在庫記録を変更する前に、販売業者のポリシー、権限確認、受け入れ手順を適用します。
分割注文は販売業者のサポートチームにどのように表示すべきですか?
親注文の下で、各荷物を個別に表示します。別の荷物が配送中であるにもかかわらず、1つの荷物が配達されたことで注文全体を完了扱いにしてはいけません。交換品と返品の配送は関連付けながら、区別できるようにします。
出典
- 17TRACK Tracking API — 追跡API連携オプションの公式製品リファレンス。
- 17TRACK API Documentation — 登録、追跡リクエスト、更新処理、実装要件を検証するための技術リファレンス。このガイドの業務ワークフローとアラートルールは推奨事項であり、プロバイダーまたは配送業者の動作を保証するものではありません。


