Skip to main content
ホームブログガイド3Plおよびフルフィルメントプロバイダーがクライアントアカウント間でShipment Tracking APIを使用する方法

3Plおよびフルフィルメントプロバイダーがクライアントアカウント間でShipment Tracking APIを使用する方法

17TRACK

3PLおよびフルフィルメントプロバイダーは、出荷追跡APIを使用して、複数のクライアントに属する出荷の配送業者の更新情報を収集し、その後、各更新情報を適切なクライアントアカウント、注文、サポートチーム、レポートビューに振り分けます。APIは追跡データを提供しますが、クライアントの所有権の維持、アクセス制御、例外処理、各クライアントと購入者に表示する情報の決定は、プロバイダー自身のシステムが担う必要があります。

3PLおよびフルフィルメントプロバイダーによる出荷追跡APIの利用方法

1つの倉庫業務で多数のマーチャントに対応する場合、この区別が重要になります。追跡番号だけではクライアントアカウントの識別子にはなりません。アカウントをまたいで信頼できる可視性を提供するには、フルフィルメントプロバイダーは各出荷の所有者を記録し、配送業者の更新情報をクライアント固有の情報に変換する再現可能なプロセスを整備する必要があります。

基本的なワークフロー:登録、受信、振り分け、対応

通常、アクションの担当者は3PLの運用チームまたはエンジニアリングチームです。追跡サービスを一度統合し、その後、倉庫管理システム、注文管理システム、または統合レイヤーを使用して、追跡記録を個々のクライアントに関連付けます。実用的なワークフローには4つの段階があります。

  1. 出荷を登録する。ラベルが作成されたとき、または荷物が配送業者に引き渡されたとき、プロバイダーは追跡番号、利用可能な場合は配送業者情報、クライアントアカウントID、注文参照番号、社内出荷IDを保存します。プロバイダーが文書化した方法で、追跡情報を追跡統合システムに送信します。
  2. 更新情報を受信する。統合システムは、APIが実際にサポートしている方法で新しい追跡情報を取得します。サービスと設定によっては、現在のステータスのリクエスト、変更通知、またはその両方が必要になる場合があります。
  3. 振り分けて解釈する。プロバイダーは、返された追跡記録を社内出荷IDおよびクライアントアカウントと照合します。配送業者のメッセージを保存し、有用な詳細を失わずに、限られた運用状態のセットにマッピングします。
  4. 対応する。適切なクライアントは進捗を確認でき、カスタマーサービスは問い合わせに回答でき、運用チームは例外を調査できます。購入者向けの更新情報では、そのクライアントが承認したチャネルとメッセージルールを使用する必要があります。

最初のAPIリクエストを行う前に、重要な設計上の判断を行う必要があります。各出荷には、3PLの記録上で明確な所有者を設定しなければなりません。この関連付けがなければ、追跡レスポンスは技術的には正しくても利用できなかったり、誤ったマーチャントに表示されたりする可能性があります。

クライアントの所有権と追跡IDを分離する

複数クライアントに対応するデータモデルでは、クライアントアカウント、注文、社内出荷、配送業者、追跡識別子を区別する必要があります。これらは関連していますが、互換的に扱えるものではありません。1つの注文から複数の荷物が発送されることがあります。配送業者による意味のあるスキャンが表示される前に、荷物に追跡番号が付与されることもあります。また、1つのクライアントが注文ごとに異なる配送業者を使用する場合もあります。

たとえば、倉庫がマーチャントの注文について2つの荷物を発送した場合、注文ページには2つの別々の出荷タイムラインを表示する必要があるかもしれません。1つの荷物で配送例外が発生した場合、3PLは注文全体を配達不能とするのではなく、影響を受けた荷物を特定する必要があります。顧客向けの注文参照番号がクライアント間で一意でない場合でも、社内出荷IDはこれらの記録を結び付ける安定した接続点になります。

出荷記録にクライアントアカウントIDを保存し、記録の作成、取得、エクスポート、または別のシステムへの送信時にアクセス確認を行います。追跡番号だけを認証キーとして使用しないでください。追跡番号は運用上の識別子であり、認証情報ではありません。共有ダッシュボードでは、ユーザーが番号を知っているだけで、あるマーチャントの注文が別のマーチャントに公開されてはなりません。

クライアントが配送業者を管理したり、自身の認証情報を提供したりする場合は、それらの認証情報をどこに保存し、どのアカウントが使用できるかを決定します。1つの追跡統合を使用しているからといって、すべてのクライアントが同じ配送業者契約、データ権限、顧客コミュニケーション設定を共有することにはなりません。これらの境界を設定に反映し、テストする必要があります。

配送業者のメッセージを利用可能なクライアント向けステータスに変換する

配送業者のイベント説明はさまざまです。3PLは、ダッシュボードや例外キュー用に、ラベル作成済み、輸送中、配達中、配達完了、例外などの共通ラベルを必要とする場合があります。このマッピングはアプリケーション上の判断であり、元のイベントの代替ではありません。サポート担当者が実際に何が起きたのかを理解できるよう、ソースステータス、提供されている場合はイベント時刻、配送業者の識別情報、場所を保存してください。

新しいメッセージをすべて前進として扱わないでください。更新情報は遅れて届いたり、以前のスキャンを説明したり、すでに受信したイベントを繰り返したりする場合があります。受信した更新ごとに、既知の出荷に属するか、重複しているか、イベント時刻によってタイムラインが変わるかを確認する必要があります。最後に受信したメッセージが、必ずしも最後に発生したイベントとは限りません。

同様に、配達完了を、意図された受取人本人が荷物を受け取ったという主張にまで誇張してはいけません。配達スキャンの意味は、配送業者のイベント詳細と、その出荷について利用可能な配達証明情報によって異なります。クライアント向けインターフェースには、データが裏付ける以上のことを推測せず、保有している証拠を表示する必要があります。

有用な方法は、フィルタリング用の正規化されたステータスと、調査用の基になる配送業者イベントの両方を保持することです。共通ステータスにより、3PLは多数のクライアントアカウントの中から対応が必要な出荷を見つけられます。元の詳細により、スタッフは広範なカテゴリを誤った結論に変えることなく、個々の出荷について説明できます。

問題を解決できる担当者を中心に例外処理を設計する

追跡が運用上価値を持つのは、チームが次に行うことを変える場合です。配送例外には、クライアントへの通知、配送業者への問い合わせ、住所確認、または後続スキャンを待つ間の即時対応なしが必要になる場合があります。適切な対応は、イベントと、3PLとクライアントの間で割り当てられた責任によって異なります。

アラートを構築する前に、一般的なケースの所有権ルールを設定します。たとえば、引き渡し前に荷物が停止したように見える場合の調査は3PLが担当し、購入者からの配送先住所変更依頼にはマーチャントが対応する、という分担が考えられます。これらは可能な取り決めの例であり、普遍的なルールではありません。各プロバイダーは、自社のサービス範囲とエスカレーション経路を文書化する必要があります。

通知ルールにも安全策が必要です。すべてのスキャンについてメッセージを送信すると、スタッフや購入者を圧倒する可能性があります。一方で、繰り返されたステータスをすべて抑制すると、場所の重要な変化や新しい例外が隠れてしまう可能性があります。どのイベントを運用キューに入れるか、どれをダッシュボードだけに表示するか、どれがクライアントまたは購入者への通知を引き起こすかを定義します。ルールを確認する必要がある場合に、スタッフが基になる追跡タイムラインにアクセスできるようにしてください。

APIを選定または実装する際に確認すべきこと

3PLが各配送業者を個別に確認するのではなく、自社システム内で出荷更新情報を必要とする場合、追跡APIは適しています。調達時の論点は、APIがステータスを返すかどうかだけではありません。文書化された動作が、プロバイダーの実際の出荷構成とアカウントワークフローをサポートしているかどうかです。

  • 配送業者と出荷への適合性:クライアントが使用する具体的な配送業者と配送サービスを確認します。APIが配送業者をどのように識別するか、追跡番号があいまいな場合やまだイベントがない場合にどうなるかを確認してください。
  • 更新情報の配信:変更情報を取得するための文書化されたオプション、想定されるリクエストおよびレスポンス形式、失敗や再試行の処理方法を確認します。イベント通知が利用できる場合は、それによって後続リクエストがすべて不要になると想定せず、認証と再試行の動作を検証してください。
  • アカウントマッピング:プロバイダーが追跡記録に独自の参照情報を付加できるかを確認します。APIの機能に関係なく、追跡記録からクライアントアカウントおよび出荷IDへの社内マッピングを保持してください。
  • データの詳細度:運用およびサポートに必要なイベント、タイムスタンプ、配送業者の説明、場所、配達情報について、サンプルレスポンスを確認します。欠落する可能性があるフィールドを確認してください。
  • 運用上の制限:文書化された認証、使用制限、エラーレスポンス、想定される出荷量に関係する商用条件を確認します。想定するリクエストパターンをテストせず、目立つ価格表示だけからコストを見積もらないでください。
  • セキュリティと保持:誰が追跡履歴にアクセスできるか、認証情報をどのように保護するか、記録をどのくらい保持するか、クライアントが自身のデータをどのように受け取るか、またはエクスポートするかを決定します。

17TRACKのTracking APIページと開発者向けドキュメントは、マルチキャリア追跡統合を評価するプロバイダーにとって有用な出発点です。これらが存在することによって、サービスが3PLのクライアント権限やアカウント構造を管理することが保証されるわけではありません。ドキュメントとテスト統合で現在のAPI動作を確認し、特定のサポートされた取り決めが確認されていない限り、3PL自身のアプリケーションでテナント所有権とアクセス制御を実装してください。

小規模なパイロットは機能チェックリスト以上のことを明らかにする

すべてのクライアントアカウントを接続する前に、意図的にさまざまな出荷を含むグループでパイロットを実施します。複数のクライアント、実際にそれらのクライアントが使用する配送業者、複数個口の注文、初回スキャンがない追跡番号、通常の配達状態と例外状態の両方に達する出荷を含めてください。テストによって誤って購入者向けメッセージが送信されないよう、パイロットデータを本番のコミュニケーションから分離します。

各出荷を倉庫記録から追跡登録、クライアントビューまで追跡します。具体的な質問を行います。正しいアカウントが記録を所有しているか。別のアカウントがダッシュボード、検索、エクスポート、通知を通じてそれを確認できないか。古いスキャンがイベントタイムラインの正しい位置に配置されているか。追跡サービスが一時的にリクエストを拒否した場合、または新しい情報を返さない場合にどうなるか。サポート担当者は配送業者の元の表現を特定できるか。

回答は印象ではなく、受け入れ基準として記録します。成功したパイロットは、3PLが各出荷の所有者を特定し、有用なイベントを表示し、通常の統合障害から復旧し、例外を適切なチームに振り分けられることを示します。これらの条件が満たされない場合、クライアントアカウントを増やすと問題を解決するどころか拡大させることになります。

最も持続性の高いアーキテクチャでは、追跡を共有データ入力として扱い、その周囲にクライアント固有の制御を配置します。APIは出荷情報の取得を支援しますが、その情報を注文に関連付け、アカウントの境界を保護し、実行可能なものにする責任は3PLにあります。

FAQ

3PLは複数のクライアントに1つの追跡API統合を使用できますか?

APIの利用規約と技術モデルが意図した利用方法をサポートしていれば、可能です。ただし3PLは、すべての出荷を所有するクライアントを特定し、その境界をシステム全体で適用する必要があります。1つの統合ですべての取り決めが許可されると想定せず、アカウント、認証情報、商用上の要件をAPIプロバイダーに確認してください。

クライアントアカウントは同じ追跡ダッシュボードを共有すべきですか?

同じ基盤アプリケーションを共有することはできますが、各クライアントにはアクセス権限のある出荷と情報のみを表示する必要があります。メインのダッシュボードページだけでなく、検索、エクスポート、通知、サポートツール、APIレスポンス全体で分離をテストしてください。

追跡番号からすぐに更新情報が返らない場合はどうすればよいですか?

出荷を注文およびクライアントアカウントに関連付けたまま、正確な保留状態を表示し、APIの文書化された指示に従って再確認します。配送業者の活動が表示される前にラベルが存在することがあります。スキャンがないことを自動的に荷物の紛失として表示してはいけません。

追跡APIだけでブランド付きの配達更新を送信できますか?

いいえ。追跡データは更新のきっかけとなるイベントを提供できますが、誰が送信するか、どのクライアントのブランドを適用するか、どの受信者が許可されるか、メッセージに何を書くかは、3PLまたはマーチャントが決定する必要があります。これらのコミュニケーションとアカウントのルールは、追跡イベント自体の外側にあります。

複数クライアントへの展開で最初に構築すべき制御は何ですか?

すべての社内出荷IDと、それを所有するクライアントアカウントとの関連付けを構築し、テストしてください。追跡データを表示または配布できるすべての場所で、その所有権確認を適用します。これは、信頼できるレポート、サポートワークフロー、アカウント分離の基盤です。

Sources