航空貨物と越境小包追跡の比較:どのようなAPI機能が必要ですか?
アプリケーションで航空運送状、フライト区間、貨物取り扱いのマイルストーン、出荷数量を追跡する必要がある場合は、航空貨物追跡 APIを選択してください。運送業者をまたいだ荷物単位の更新、配送例外、ラストマイル配送状況が必要な場合は、越境小包追跡 APIを選択してください。出荷物に混載航空貨物と個別小包配送の両方が含まれる場合は、両方の可視化レイヤーと、それらの識別子を確実に紐付ける方法が必要です。
エンジニアリングチーム、物流事業者、Eコマース企業にとって、購入の判断基準は、どのAPIがより多くのイベントを返すかというよりも、そのイベントが自社で実際に管理する出荷単位を説明しているかどうかです。航空会社の到着イベントだけでは、買い物客の荷物がどこにあるのか、いつ自宅に届くのかを判断できません。
輸送モードではなく、出荷単位から始める
航空貨物と越境小包は、相互に排他的な配送カテゴリーではありません。小包は航空機で国際輸送される一方、航空会社はそれをより大きな混載出荷の一部として扱う場合があります。API選定における違いは、追跡対象となる業務上のオブジェクトです。
航空貨物の可視化は通常、航空運送状と、それに関連する輸送の動きを中心に行われます。情報源によっては、引き受け、出発、到着、貨物の引き渡し可能、引き渡しなどが記述されます。小包の可視化は、個々の荷物と、集荷、国際輸送、仕向地での処理、配送を通じた進捗を中心に行われます。
マスター航空運送状は、複数の基礎出荷を含む混載輸送を表すことがあります。ハウス航空運送状、小包ラベル、仕向地運送業者の追跡番号は、その輸送内の異なる階層を識別する場合があります。追跡プロバイダーがこれらすべての関係を自動的に発見または接続できるとは限りません。
| 判断領域 | 航空貨物追跡 | 越境小包追跡 |
|---|---|---|
| 主な対象 | 航空運送状、貨物、または輸送区間 | 個別の荷物とその運送業者識別子 |
| 業務上の疑問 | 貨物は引き受けられ、輸送され、到着し、または引き渡されたか | 荷物はどこにあり、何が妨げとなっており、配送されたか |
| 保持すべき関係 | マスターとハウスの参照情報、区間、個数、分割輸送 | 注文と荷物の紐付け、運送業者間の引き継ぎ、交換識別子、返品 |
| 通常の対応担当者 | フォワーディング、輸送、または貨物業務チーム | Eコマース業務、カスタマーサービス、または配送管理チーム |
| 主な解釈リスク | 1つの区間または一部の到着を、出荷全体の完了として扱うこと | 引き継ぎまたは曖昧な配送イベントを、購入者による受領として扱うこと |
航空貨物追跡APIに必要なサポート
航空運送状の識別と出荷関係
APIが受け付ける識別子と、各検索で返される内容を確認してください。マスター航空運送状への対応が、ハウスレベルの可視化への対応を自動的に意味するわけではありません。業務がハウス出荷に依存する場合は、自社の参照情報と認可されたデータソースを使ったデモを要求してください。
データモデルは、出荷、輸送区間、個別に移動する部分の間の関係を保持する必要があります。数量に依存するワークフローでは、個数と重量が出荷レベル、イベントレベル、またはその両方で利用できるかを確認してください。出荷全体の合計値は、特定の空港にどれだけの貨物が到着したかを把握する代わりにはなりません。
輸送区間と取り扱いの可視化
出発地からの出発と乗り継ぎでの出発、計画された移動と実際の移動を区別するのに十分なコンテキストを要求してください。有用なフィールドには、出発空港と到着空港、フライト参照情報、イベント場所、予定時刻と実績時刻などがあります。これらの利用可能性は情報源によって異なるため、想定せず確認する必要があります。
また、フライトの移動と貨物の移動も区別してください。航空機が到着したことだけでは、関連するすべての出荷物が搭載、荷下ろし、処理、または引き渡し可能になったことを証明できません。イベントが出荷固有のものか、フライトフィードから派生したものかを確認してください。
部分輸送とマイルストーンの意味
貨物出荷は部分的に移動することがあります。一部に対して到着イベントが存在するだけで、出荷全体を到着済みとしてマークしてはなりません。APIが複数のフライト、部分数量、経路変更、訂正をどのように表現するかをテストしてください。
マイルストーンの定義も同様に精査する必要があります。フォワーダーまたは別の物流関係者への引き渡しは、最終荷受人への配送とは限りません。完了イベントの業務上の意味をプロバイダーに説明してもらい、その意味を社内のステータスモデルに保持してください。
IATAのONE Recordイニシアチブは、貨物データ共有と標準化されたデータ構造に関する関連業界リファレンスを提供します。ただし、標準規格への対応を主張していることは、すべての航空会社、ハンドラー、出荷、マイルストーンにアクセスできる証明にはなりません。実際に利用可能な実装、データ関係、権限、業務上の情報源を確認してください。
越境小包追跡APIに必要なサポート
運送業者の識別と引き継ぎの継続性
国際小包の輸送には、出発地の事業者、越境物流プロバイダー、仕向地の配送業者が関与する場合があります。統合によって、識別子または担当運送業者が変わった場合でも継続性を維持できる必要があります。
APIが下流の追跡番号、運送業者の関係、または送信した識別子に対するイベントのみを返すか確認してください。これらの関係を利用できない場合は、自社の配送プラットフォーム、倉庫、または物流パートナーが提供できるか判断してください。テストなしに自動的なエンドツーエンドの紐付けを約束しないでください。
運送業者の検出にはフォールバックも必要です。似た追跡番号のパターンによって曖昧さが生じる可能性があるため、統合では、対応している場合に明示的な運送業者選択または文書化された別の曖昧性解消方法を使用できるようにしてください。
元の証拠を伴う正規化ステータス
共通のステータスモデルにより、運送業者をまたいだ通知を自動化しやすくなります。ただし、正規化によって元のイベントの説明、場所、タイムスタンプ、情報源の運送業者を失わせてはいけません。
たとえば、広範な例外ステータスは、住所の問題、税関関連の遅延、配送失敗を表す可能性があります。これらには異なる対応が必要です。元のメッセージを保持し、情報源が裏付けている場合にのみ具体的な例外カテゴリーを使用してください。
配送結果と対応可能な例外
小包担当チームは通常、配達中、配達試行、受け取り可能、配達完了、返品関連のイベントを分ける必要があります。APIがどの区別を公開しているか、また利用する運送業者間で一貫しているかを確認してください。
配送証明は別の要件として扱ってください。配達完了ステータスがあっても、署名、写真、受取人名、書類にアクセスできるとは限りません。関連サービスについて、利用可能性、アクセス権限、保持期間、プライバシー制限を確認してください。
税関情報にも限界があります。税関に言及する追跡イベントがあっても、申告記録、関税の説明、信頼できる通関見込みが提供されるとは限りません。推測された法的または税関上の結果ではなく、イベントが実際に述べている内容に基づいてエスカレーションルールを構築してください。
両方のAPIタイプに必要な機能
信頼性の高いイベント取り込みと復旧
イベント駆動型ワークフローでは、Webhook配信、認証、再試行、重複処理、障害後の復旧を評価してください。これらはすべてのプロバイダーが提供すると想定する機能ではなく、調達時に確認すべき要件です。
重複メッセージや順不同のメッセージを処理できるようコンシューマーを設計してください。イベント発生時刻は、システムが更新を受信した時刻とは別に保存します。安定したイベント識別子を利用できない場合は、利用可能なフィールドを使った、文書化された重複排除方法を定義してください。
通知を受け損ねた後に、出荷のイベント履歴を取得できるか確認してください。Webhookは処理を開始するのに便利ですが、そのトリガーを逃した場合の復旧に役立つのは、サポートされた取得または照合プロセスです。
鮮度、出所、タイムスタンプ処理
3つの時刻を分けてください。物理的なイベントが発生した時刻、情報源が公開した時刻、アプリケーションが受信した時刻です。すべての情報源が3つすべてを公開するわけではありませんが、利用可能なタイムスタンプを分けて保持すると、遅延の診断が容易になります。
同様に、新しいイベントがないことと検索失敗を区別してください。変化のない出荷履歴は、スキャン間の正当な空白、情報源の停止、認識されない識別子、統合の問題を反映している可能性があります。業務チームが適切な対応を選べるよう、十分な診断情報が必要です。
提供されている場合はタイムゾーン情報を保持してください。情報源のタイムスタンプにタイムゾーンがない場合は、見かけ上正確な世界時に黙って変換するのではなく、その制限を記録してください。
アクセス、コスト、業務上の制御
認証、アカウント分離、データ保持、削除手順、レート制限、本番サポート体制を確認してください。追跡ペイロードには個人情報が含まれる可能性があるため、ワークフローに必要な情報だけを収集・公開してください。
商用条件を実際の業務量と比較してください。何が課金単位になるのか、登録済み出荷、リクエスト、更新、その他の単位なのかを確認します。無効な番号、重複登録、再追跡、過去データの検索、超過分がどのように扱われるかを明確にしてください。これらの定義がなければ、表示価格は信頼できるコスト比較になりません。
1つのAPIを使う場合とデータソースを組み合わせる場合
貨物中心の可視化を選択するのは、チームが航空運送状のマイルストーン、空港での取り扱い、乗り継ぎ失敗、貨物の一部到着に対応する場合です。必要な貨物レベルの詳細が明示的に実証されない限り、小包追跡だけではこれらのワークフローを十分に代替できません。
小包中心の可視化を選択するのは、チームが荷物単位の配送更新、顧客通知、仕向地運送業者のイベント、配送例外管理を必要とする場合です。航空運送状のフィードだけでは、購入者向けの配送追跡には不十分です。
2つを組み合わせるのは、国際幹線輸送と個別小包配送を管理する場合です。混載出荷とその小包について別々の記録を保持し、自社の物流プロセスまたは検証済みのパートナーフィードから提供された参照情報を通じて接続してください。
たとえば、販売事業者は仕向地で小包ネットワークに投入する前に、混載バッチを航空輸送する場合があります。混載出荷の到着を貨物記録に記録します。各小包について関連する証拠がある場合にのみ更新し、バッチの空港到着をすべての注文の配達完了イベントに変換してはいけません。
17TRACKの位置付け
このアーキテクチャの小包側では、17TRACK's Tracking APIがマルチキャリア追跡統合の評価に関連します。公式APIドキュメントを使用して、必要な識別子、レスポンスフィールド、通知ワークフロー、業務上の制限に照らして統合を確認してください。
小包APIの評価を、航空貨物機能の確認として扱わないでください。マスターとハウスの関係、フライト区間の詳細、または個数の部分的な移動も必要な場合は、これらの要件について明示的な確認とサンプルレスポンスを求めてください。製品の適切な役割は、「追跡」という言葉の範囲ではなく、実証できるワークフローによって決まります。
導入を決定する前に概念実証を行う
実際に利用する運送業者、ルート、サービス種別から代表的な出荷を使用してください。既知の結果がある完了済み出荷と、進行中の出荷の両方を含めます。単純な1件の出荷で検索に成功しても、統合の検証には不十分です。
- 各イベントが支援すべき判断を定義する。例として、貨物の乗り継ぎ失敗の調査、住所の問題について購入者への連絡、配送通知の送信などがあります。
- 代表的なテストセットを構築する。関連する場合は、運送業者間の引き継ぎ、静止期間、配送試行、返品、貨物の分割輸送を含めます。
- オブジェクトレベルの正確性を確認する。各イベントがフライト、貨物、部分、個別の小包のいずれに適用されるかを確認します。
- 業務上の情報源と比較する。アクセス権限のある運送業者またはパートナーの記録と照合し、欠落したマイルストーン、タイムスタンプ、場所、元のメッセージ、訂正処理を確認します。
- 障害復旧を実行する。重複イベント、遅延イベント、無効な識別子、曖昧な運送業者、Webhook停止、照合をテストします。
- 経済性と責任範囲を検証する。業務量からコストを見積もり、ソースデータの問題、統合障害、顧客コミュニケーションの責任者を割り当てます。
結果を確認する前に受け入れ基準を設定してください。必要なフィールド、イベントの意味、復旧動作、各ワークフローで許容される更新遅延を含める必要があります。顧客通知と貨物への介入では、異なるしきい値が必要になる場合があります。
FAQ
1つの追跡APIで航空貨物と小包をカバーできますか?
可能性はありますが、両方についてデータモデルと情報源へのアクセスを確認してください。共有エンドポイントがあるからといって、貨物数量、フライト区間、ハウス関係、小包の引き継ぎに対応しているとは限りません。2つのワークフローについて別々のデモを要求してください。
航空運送状番号で個別の小包を追跡できますか?
必ずしもできるとは限りません。航空運送状は個別の荷物ではなく、より大きな貨物を識別する場合があります。その貨物と小包識別子の間に検証済みの関係が必要です。
「リアルタイム追跡」は継続的な物理的位置を意味しますか?
そうとは限りません。追跡は、継続的な位置テレメトリではなく、一定間隔で公開される業務イベントに基づく場合があります。更新のトリガー、公開されるタイムスタンプ、位置データが別のセンサー情報源から取得されるかを確認してください。
Webhookはポーリングより優れていますか?
Webhookは、繰り返しステータスリクエストを行わずにイベント通知を受信するのに便利です。ただし、ポーリングまたは別の取得メカニズムは、照合と復旧を引き続きサポートできます。プロバイダーの文書化された動作、制限、見逃しや遅延した更新に対する許容度に基づいて設計を選択してください。
配達完了イベントは購入者が出荷物を受け取ったことを証明しますか?
すべての状況で証明するわけではありません。貨物の完了は物流関係者への引き渡しを示す場合がある一方、小包の配送イベントは運送業者の配送プロセスに依存します。ワークフローで必要な場合は、イベント定義を確認し、別途配送証拠を取得してください。
出典
- IATA — ONE Record:標準化された貨物データ共有に関する業界リファレンスであり、特定のAPIの対応範囲を保証するものではありません。
- 17TRACK — Tracking API:小包追跡統合の評価に使用する公式製品リファレンス。
- 17TRACK — API documentation:実装要件を検証するための技術リファレンス。


