Skip to main content
ホームブログガイド正規化ステータスと配送業者の元のステータス:システムではどちらを使用すべきか?

正規化ステータスと配送業者の元のステータス:システムではどちらを使用すべきか?

17TRACK

両方を使用しますが、それぞれに異なる役割を持たせてください。正規化されたステータスは、ワークフロー、ダッシュボード、アラート、顧客向けの案内を動かすために使用し、配送業者の元のステータスは、監査、トラブルシューティング、正確な運用コンテキストのためのソースイベントとして利用できる状態にしておきます。2つのうち一方だけを保持するシステムは、通常、自動化が難しくなるか、信頼することが難しくなります。

正規化されたステータスと配送業者の元のステータス どちらをシステムで使用すべきか

配送業者は、似たような配送イベントを異なる方法で表現します。ある業者は荷物を「輸送中」と報告し、別の業者は「配送中」と表現し、さらに別の業者は「施設を出発」のような、より具体的なスキャン情報を提供することがあります。これらのメッセージは、常に1つの共通したライフサイクルにきれいに対応するとは限りません。実務上の解決策は、元の表現を消去することではありません。管理された正規化レイヤーを作成し、その横に配送業者のイベントを保持することです。

正規化されたステータスと元のステータスの意味

配送業者の元のステータスとは、輸送業者から受信したイベントまたはステータスラベルです。コード、説明、場所、タイムスタンプ、その他のイベント属性が含まれる場合があります。これは配送業者独自の運用上の用語に近く、非常に具体的な場合があります。

正規化されたステータスとは、自社のシステムまたは追跡プロバイダーが作成するアプリケーションレベルのカテゴリです。さまざまな配送業者のメッセージを、次のような少数のビジネス状態にまとめます。

  • ラベル作成済み
  • 集荷済み
  • 輸送中
  • まもなく到着
  • 配達中
  • 配達完了
  • 例外
  • 受け取り可能
  • 返送済み

正規化は分類レイヤーであり、基盤となるイベントの代替ではありません。同じ正規化カテゴリに複数の元のステータスが含まれることがあり、同じ表現でも、配送業者、サービス、イベントコード、場所、イベントの順序によって解釈が異なる場合があります。

システムに正規化されたステータスが必要な理由

正規化されたステータスは、複数の配送業者にまたがってソフトウェアが一貫した判断を行う必要がある場合に最も役立ちます。正規化されたステータスがなければ、各ワークフローが配送業者ごとの用語を個別に理解しなければなりません。その結果、保守の負担が大きくなり、本来は単純なルールであっても管理が難しくなります。

一貫した自動化

運用チームは、荷物が「配達中」の状態になったら、常に配達通知を送信したいと考えるかもしれません。ワークフローが特定の配送業者の正確な表現に依存していると、別の業者が異なるラベルを使用した際に機能しない可能性があります。正規化された状態があれば、ルールに安定した入力を与えられます。

同じ原則は例外管理にも当てはまります。正規化された状態が配送上の問題を示した場合、元の理由が住所間違い、配達試行の失敗、通関処理、天候による混乱、配送業者による調査などであっても、企業は配送物を例外キューに振り分けることができます。

より明確なレポート

配送業者をまたいだレポートには、共通のカテゴリが必要です。配達済みの配送物数、輸送中の配送物数、例外のある配送物数などの指標は、各配送業者のイベント分類を解釈せずに表示すると比較が困難になります。

正規化は、配送業者が表現を変更するたびに変わることのないダッシュボードを、プロダクトチームやサポートチームが構築するのにも役立ちます。ユーザーが詳細を必要とする場合には元のイベントを表示できますが、メイン画面は一貫したまま維持できます。

より予測しやすい顧客コミュニケーション

顧客向けメッセージでは、通常、生の配送業者コードを表示するのではなく、人々が理解できる言葉を使用すべきです。正規化されたステータスを使えば「荷物は配送中です」のようなメッセージを表示でき、元のステータスは追跡タイムラインやサポート画面で引き続き確認できます。

この分離により、顧客が解釈できない過度に技術的なメッセージと、重要な配送上の問題を隠してしまう過度に大まかなメッセージという、相反する2つの問題を防ぐことができます。

元のステータスを破棄してはならない理由

正規化データが役立つのは、情報を簡略化するからこそです。しかし、その簡略化によって詳細も失われます。元のイベントを削除すると、システムは何が起きたのかを説明するために必要な情報を失う可能性があります。

運用上のトラブルシューティング

配送物が「例外」に分類されたとします。このカテゴリは振り分けには役立ちますが、次に何をすべきかは説明しません。元のイベントから、荷物が正しい住所の確認を待っているのか、通関書類のために保留されているのか、受け取りを待っているのかが分かる場合があります。サポートチームや物流チームが効率的に調査するには、この詳細が必要です。

監査可能性と紛争対応

顧客が配送更新に疑問を呈した場合、小売業者は配送業者から受信したイベント、受信時刻、システムがそれをどのように解釈したかを確認する必要があるかもしれません。元のペイロードまたはその構造化された表現を保持することで、判断の追跡可能な記録を作成できます。

将来的なマッピング改善

ステータス分類は変化します。チームは後になって、「施設で保留中」を一般的な例外とは異なる扱いにすべきだと判断したり、特定の通関イベントに独自のワークフローを割り当てることを決めたりするかもしれません。過去の元イベントがあれば、配送業者に古いデータの再送を依頼せずに、分類を再処理して改善できます。

配送業者固有の精度

一部の元イベントには、広い正規化カテゴリでは表現できない運用上の意味があります。配達済みの配送物、受け取り拠点で受け取り可能な荷物、差出人へ返送された配送物は、いずれも終端または終端に近い状態である可能性がありますが、顧客や企業が取るべき対応はそれぞれ異なります。元のステータスを保持することで、その違いを維持できます。

最も堅牢な設計は2層のステータスモデル

ほとんどの複数配送業者システムでは、実務的な推奨事項は「正規化か元のステータスか」の二者択一ではありません。正規化されたステータスを安定したビジネスインターフェースとし、元のステータスをその背後にある証拠とする2層モデルです。

データレイヤー主な目的主な利用者
正規化されたステータスワークフロー、ダッシュボード、アラート、レポート、顧客向けの概要アプリケーション、運用管理者、顧客
元のステータス調査、監査、配送業者固有の詳細、再マッピングサポート、物流担当者、エンジニア
マッピングメタデータ分類がどのように、いつ生成されたかを説明エンジニアリング、コンプライアンス、分析

有用なイベントレコードには、配送業者名、配送業者イベントコード、元の説明、正規化されたステータス、イベントタイムスタンプ、取り込みタイムスタンプ、イベント場所、ソースペイロードの参照、マッピングバージョン、信頼度またはレビュー用フラグなどを含めることができます。正確なスキーマはシステムによって異なりますが、原則は一貫しています。解釈と証拠を一緒に保存することです。

信頼性の高い正規化レイヤーの構築方法

まずビジネスライフサイクルを定義する

システムが行う必要のある判断から始めます。顧客向け追跡ページでは、ラベル作成から配達までの単純な流れが必要かもしれません。運用プラットフォームでは、通関、受け取り、配達失敗、返送の追加状態が必要になる場合があります。配送業者に特徴的な表現があるというだけで、正規化カテゴリを作成しないでください。そのカテゴリによってビジネス上の対応が変わるか、理解が向上する場合に作成します。

状態とイベントを分ける

イベントとは、ある時点で報告された出来事です。状態とは、配送の進捗についてシステムが現在解釈している状態です。たとえば「目的地の施設に到着」はイベントであり、「輸送中」は現在の正規化された状態である場合があります。両方を保持することで、後続のイベントが過去の履歴を上書きするのを防げます。

説明だけでなく、利用可能な場合はコードを使用する

テキストの説明は、言語、形式、配送業者の表示方法によって変化する可能性があります。配送業者のイベントコードは、利用可能で文書化されている場合、通常、表現の一致よりも安定したマッピング入力になります。テキストを代替手段として残すことはできますが、影響の大きいワークフローの唯一の根拠にすべきではありません。

未知のイベントや曖昧なイベントに対応する

新しい配送業者イベントや不明確なイベントを、確信を持ってカテゴリに分類してはいけません。証拠が不十分な場合は、「不明」、「分類待ち」、または同等のレビュー状態を使用します。システムは元のイベントを表示しながら、配送状況の監視を続けることができます。

これは、荷物を配達済み、配達中、または遅延と誤ってラベル付けするより安全です。誤った肯定的なステータスは、不正確な顧客メッセージや、元に戻すことがより難しい運用上の判断を引き起こす可能性があります。

マッピングルールをバージョン管理する

マッピングロジックは時間とともに変化します。各正規化ステータスを生成したバージョンを記録しておけば、チームは過去の判断を説明し、更新後の結果を比較できます。マッピングを一元管理する場合は、対応する各配送業者およびサービスの代表的なイベント履歴に対して変更をテストする必要があります。

個々のイベントだけでなく、シーケンスをテストする

単一のイベントは、それだけでは曖昧な場合があります。配送履歴における位置が重要なコンテキストを提供することがあります。通常のシーケンス、繰り返しスキャン、順序が逆のイベント、欠落イベント、返送、配達失敗、頻繁なスキャンなしに施設間を移動する配送物をテストしてください。

テストでは、Webhookの再試行と重複通知も対象にする必要があります。同じ配送業者イベントを複数回受信する可能性があるため、取り込み処理は冪等でなければならず、矛盾する顧客向け更新を作成してはいけません。

各システムコンポーネントはどのレイヤーを使用すべきか

  • 顧客向け追跡ページ:正規化されたステータスを主要な進行表示として使用し、役立つ詳細を追加できる場合は元の説明も表示します。
  • 通知ルール:正規化されたステータスを使用しますが、配達済み、返送済み、例外など、影響の大きい遷移には安全策を適用します。
  • 運用ダッシュボード:フィルタリングと優先順位付けには正規化カテゴリを使用し、調査のために元のイベントを表示します。
  • 分析:配送業者間の比較には正規化されたステータスを使用し、詳細分析やデータ品質分析のために元のフィールドを保持します。
  • サポートツール:両方のレイヤーを表示します。サポート担当者には、読みやすい概要と、具体的な質問に答えるための十分な配送業者の詳細が必要です。
  • 配送業者との照合:元のイベントとタイムスタンプを保持します。正規化された値だけでは、照合の十分な証拠になりません。
  • API利用者:可能な場合は両方を返します。安定した正規化フィールドは統合を支え、元のフィールドは情報の損失を防ぎます。

追跡APIの役割

企業が複数の輸送業者から追跡イベントを収集する場合、追跡APIは、配送データを取得し、一貫したアプリケーションロジックを構築するための統合レイヤーを提供できます。17TRACKの公式APIドキュメントでは、APIベースで追跡情報を統合する方法が説明されています。これは、単一配送業者のステータスフィードではなく、複数配送業者の可視性を必要とするシステムに関連します。特定のフィールドや動作を前提に設計する前に、ドキュメントを確認してください。

APIを、配送業者レベルのデータを破棄する理由として扱ってはいけません。実装前に、対象となる配送業者やサービスについて、どの正規化フィールド、元のフィールド、イベントコード、タイムスタンプ、更新メカニズムが実際に公開されているかを確認してください。概念実証では、配達成功例だけでなく、例外や返送を含む実際の配送履歴をテストする必要があります。

1社の配送業者を使用し、手動で確認する小規模な運用では、最初は元のステータスを保存するだけで十分な場合があります。マーケットプレイス、小売業者、物流プラットフォーム、または複数の配送業者を統合するカスタマーサポートシステムでは、ワークフローやレポートが拡大するにつれて、正規化レイヤーの価値が通常ますます高まります。

避けるべき一般的な間違い

  • 元の値を置き換える:コンテキストが失われ、後の調査が難しくなります。
  • 正規化を普遍的な標準として扱う:正規化分類は実装上の選択であり、すべての配送業者がイベントを同じように定義していることの証明ではありません。
  • すべての例外に1つのラベルを使用する:可能な限り、例外処理には理由、重大度、次のアクションに関するコンテキストが必要です。
  • 最新のイベントが常に最終的な真実だと考える:重複、遅延、訂正、または順序が逆のイベントが発生する可能性があります。
  • 内部コードを顧客に公開する:配送業者コードは専門家には意味があっても、購入者には分かりにくいことがよくあります。
  • マッピングされていないイベントを監視しない:マッピング品質は、未知のイベントキュー、分類レビュー、ワークフローのエラーチェックを通じて測定する必要があります。

実務的な判断ルール

システムが配送業者をまたいでビジネス上のアクションを自動化する必要がある場合は、正規化されたステータスを使用します。誰かがそのアクションを説明、異議申し立て、監査、または再解釈する必要がある場合は、配送業者の元のステータスを保持します。両方の条件に当てはまる場合は、別々のフィールドで両方を公開し、その関係を明確にしてください。

したがって、最も長く利用できるアーキテクチャは、単純さと詳細のどちらかを選ぶものではありません。元の配送業者イベントをシステムに取り込み、正規化されたステータスで一貫した判断を支え、説明責任のために元の証拠を利用できる状態にする、管理された変換レイヤーです。このアプローチにより、プロダクトチームには安定したインターフェースを提供しながら、運用チームやサポートチームが実際に何が起きたのかを確認できるようになります。

よくある質問

正規化されたステータスは、配送業者の元のステータスを置き換えるべきですか?

いいえ。通常は元のステータスと並べて保持すべきです。正規化によって一貫性は向上しますが、元のイベントは配送業者固有の詳細を保持し、トラブルシューティング、監査、将来の再マッピングを支えます。

1つの元のステータスを複数の正規化ステータスにマッピングできますか?

コンテキストによっては可能です。同じ説明でも、配送業者、イベントコード、配送履歴、サービスタイプ、場所によって扱いが異なる場合があります。マッピングルールは、テキストだけに依存せず、関連するすべてのフィールドを使用すべきです。

配送業者が未知のステータスを送信した場合、どうすべきですか?

元のイベントを保持し、正規化された値を不明または分類待ちとしてマークします。重要なワークフローに影響する場合は、レビューに回してください。曖昧なイベントを配達済みまたは遅延として自動的に分類してはいけません。

顧客向け追跡ページには、どのステータスを表示すべきですか?

主要な進行ラベルとして、明確な正規化ステータスを使用します。遅延、施設間の移動、受け取り案内、その他の具体的なイベントを説明するのに役立つ場合は、配送業者の元の説明を追加します。

単一配送業者のシステムに正規化は必要ですか?

必ずしも必要ではありません。ワークフローが単純な小規模の単一配送業者実装では、特に最初は元のイベントから始めることができます。企業が配送業者、 自動化、レポート、顧客通知、または複数地域の運用を追加すると、正規化レイヤーはより有用になります。

出典