Skip to main content
ホームブログガイド返品プラットフォームがShipment Tracking APIを使用して返品配送を追跡する方法

返品プラットフォームがShipment Tracking APIを使用して返品配送を追跡する方法

17TRACK

返品プラットフォームは配送追跡APIを使用して、承認済みの返品と実際の配送を紐付けます。プラットフォームは返品配送の配送業者と追跡識別子を記録し、追跡イベントを取得して、そのイベントを利用して進捗を表示したり、業務上の確認を促したりします。APIが提供するのは配送状況の可視化であり、返品プラットフォームが返品リクエスト、ポリシー上の判断、倉庫での検品、返金ワークフローを引き続き管理します。

返品プラットフォームが配送追跡APIを使用して追跡する方法

返品業務または製品チームにとって重要なのは、APIで追跡ステータスを表示できるかどうかだけではありません。統合によって適切な返品配送を確実に特定し、受信したイベントを解釈し、追跡更新が誤った顧客メッセージや返金処理を引き起こさないようにできるかどうかです。

返品における追跡の位置付け

返品は業務記録として始まります。顧客が商品を返送したいと申し出て、販売者が承認する内容を決定します。一方、追跡記録が示すのは別のもの、つまり荷物の移動です。この2つの記録を紐付けることで、返品プラットフォームは、顧客が荷物を配送業者に引き渡したと考えられるか、返品先に向けて移動しているか、配送イベントが報告されているかといった質問に答えられます。

この紐付けは明示的でなければなりません。1つの注文に複数の商品が含まれる場合があり、顧客が同じ注文に対して複数回返品する場合もあり、1件の返品に複数の荷物が関係することもあります。最初の出荷時の追跡番号を返品の追跡番号と取り違えてはなりません。実用的なデータモデルでは、注文、返品承認、返品荷物、配送業者、追跡記録について個別の識別子を保持し、それらの関係を保存します。

追跡にも明確な限界があります。配送業者の配送イベントは、荷物が住所や施設に到着したことを示す場合があります。しかし、それによって倉庫が想定された商品を受け取ったこと、商品が検品に合格したこと、返金が必要であることまで確定するわけではありません。これらの判断には、それぞれ独自の証拠とルールが必要です。

承認から受領までの統合フロー

1. 荷物を追跡する前に返品記録を作成する

返品プラットフォームはまず、リクエスト、対象商品、承認された宛先、許可された解決方法を記録します。返品に販売者発行のラベルを使用する場合、プラットフォームはラベルの追跡識別子を返品荷物に関連付けられます。顧客が独自に発送手配する場合、監視を開始する前に、配送業者と追跡番号を収集して検証する仕組みが必要になることがあります。

ここが、データ品質が可視性に影響する最初のポイントです。信頼できる荷物と返品の関連付けがない追跡番号は、誤った返品に対して正確な配送業者更新を生成する可能性があります。チームは、訂正された追跡番号、交換ラベル、同じ識別子を2回送信する顧客への対応方法も決めておく必要があります。

2. 配送を登録または検索する

プラットフォームは、選択した追跡プロバイダーが配送記録を作成または取得するために必要な情報を送信します。正確なリクエスト項目と順序は、プロバイダーのドキュメントによって異なります。最低限、プロバイダーの配送参照情報を自社の返品荷物記録に確実に関連付ける方法が必要です。配送業者の識別が必要な場合、追跡番号だけで十分だと想定せず、曖昧な配送業者情報や未対応の配送業者情報がどのように扱われるかを確認する必要があります。

プロバイダーのレスポンス、統合エラー、プラットフォームが監視を開始した日付を保持します。リクエストが受け付けられたことは、配送業者が荷物をスキャンした証明とは限りません。最初のスキャン前は、顧客向けの状態を返品が輸送中であるとするのではなく、追跡待ちと表示する必要がある場合があります。

3. 元のイベントを失わずに更新を取り込む

APIによっては、更新がWebhookで届く場合もあれば、ポーリングで取得する場合、その他の文書化された方法を使用する場合もあります。統合では、返品プラットフォームに表示する簡略化されたステータスとともに、プロバイダーの生のイベント情報を保持する必要があります。役立つ項目には、イベントの説明、イベント時刻、提供される場合の場所、配送業者の参照情報、プラットフォームが更新を受信した時刻などがあります。

この2つの時刻は異なる質問に答えます。イベントのタイムスタンプは、ある活動が発生したと報告された時刻を示します。受信タイムスタンプは、返品プラットフォームがその情報を知った時刻を示します。そうしなければ、遅延、再配達、順不同のメッセージによって、返品が後退したように見える可能性があります。プロバイダーがイベント識別子を提供している場合は、重複排除に使用します。提供していない場合は、慎重な重複排除方法を定義し、実際の統合サンプルでテストします。

4. 追跡イベントを返品状態に変換する

配送業者のイベント説明は返品ポリシーではありません。返品プラットフォームは通常、それらを引き渡し待ち、輸送中、配送報告済み、要確認など、より少数の業務状態にマッピングします。認識できない更新をすべて進捗として扱うのではなく、不明なイベントも考慮したマッピングにする必要があります。

たとえば、最初の配送業者スキャンがあれば、荷物が配送中であるようだと顧客に伝えるには十分かもしれません。しかし、返金日を約束するには不十分な場合があります。配送イベントは、倉庫が一致する荷物を優先処理するのに役立つ可能性がありますが、返金ルールでは実際の受領と検品が引き続き必要になる場合があります。チームは、ステータスを自動アクションに接続する前に、これらの違いをワークフローに明記しておく必要があります。

5. 倉庫の証拠で一連の処理を完了する

荷物が到着すると、倉庫または返品施設は、社内バーコードをスキャンし、荷物を返品承認と照合し、内容物を検品して、結果を記録する場合があります。これらは返品管理上のイベントであり、配送業者追跡のイベントではありません。両方のシステムが接続されている場合、プラットフォームは、配送の移動、配送業者による配送報告、施設による荷物の受領、処理完了という、より有用な一連の流れを表示できます。

この流れは例外の解決にも役立ちます。追跡では配送済みと報告されているのに倉庫の受領記録がない場合、顧客向けの主張を行う前に、担当者は配送先、配送業者イベント、施設の受け入れキュー、荷物識別子を調査できます。倉庫が使用可能な追跡履歴のない荷物を受け取った場合でも、実際の受領は記録できます。追跡データが欠落していても、独立した倉庫の証拠を消去してはなりません。

追跡APIがプラットフォームに伝えられることと伝えられないこと

配送追跡APIは、プロバイダーが文書化している対応範囲、イベントの利用可能性、統合動作を前提として、配送業者が報告した移動情報を別のアプリケーションで利用できるようにします。しかし、それだけで返品商品の内容を検証したり、販売者のポリシーが満たされたかどうかを判断したりすることはできません。また、最初の配送業者スキャン前には報告できる更新がない場合もあります。

この違いは自動化を設計する際に重要です。ステータスは相互に交換可能な証明ではなく、用途が定義されたシグナルとして扱う必要があります。配送業者への引き渡しイベントは進捗通知を開始するきっかけになるかもしれません。配送イベントは倉庫のフォローアップタスクを作成するきっかけになるかもしれません。倉庫での受領が確認されれば、返品を検品に進められる可能性があります。返金または交換の判断は、販売者の実際のルールと、そのルールが要求する証拠に従う必要があります。

顧客向けの表現も同じ境界を反映する必要があります。検品が行われていない場合、「返金を承認しました」よりも「配送業者が返品の配送完了を報告しています」の方が正確です。同様に、「最初の配送業者更新を待っています」は、説明のない空白の追跡ページよりも有益です。

避けられる返品追跡エラーを防ぐ設計確認

  • 荷物単位で照合する。分割返品、1件の承認に対する複数荷物、交換ラベル、1つの注文に対する繰り返し返品をテストします。各荷物は、固有の追跡記録と曖昧さなく関連付けられている必要があります。
  • ステータスの優先順位を定義する。配送済みイベントの後に、より古い輸送中イベントが届いた場合の処理を決めます。イベント履歴は保持しつつ、表示される返品状態を自動的に下げないようにします。
  • プロバイダーエラーと配送業者からの無応答を分ける。認証失敗、拒否されたリクエスト、Webhook処理の失敗は統合上の問題です。まだスキャンされていない状態は別の条件であり、異なる方法で伝える必要があります。
  • 重複と再試行に備える。配送更新は繰り返される可能性があります。イベント取り込みは安全に再試行できるようにし、同じ顧客通知を2回送信したり、同じタスクを2回作成したりしないようにします。
  • 顧客データと配送データを保護する。追跡認証情報へのアクセスを制限し、ワークフローに必要なデータだけを保持し、開始前にプロバイダーが文書化している認証およびセキュリティ要件を確認します。
  • 手動対応の経路を維持する。追跡情報が不完全、遅延、または不一致となる返品もあります。担当者が配送業者のイベントを捏造せずに返品記録を調査・修正できる手段が必要です。

これらの確認は、1件の配送成功例ではなく、具体的なシナリオに対してテストすると最も有用です。小規模なテストセットには、最初のスキャンがないケース、誤った追跡番号、重複イベント、順不同のイベント、倉庫の受領がない配送報告、配送報告と一致しない倉庫受領を含める必要があります。それぞれのケースで想定される顧客メッセージと担当者のアクションを指定します。

APIを選び、業務分担を定義する

まず、事業で実際に利用している返品経路と配送業者から始めます。次に、プロバイダーの最新ドキュメントで、配送登録の仕組み、必要な識別子、更新の配信方法、公開されるイベントデータ、エラーと再試行の処理方法を確認します。配送業者の対応範囲に関する一般的な説明から推測するのではなく、対象となる配送業者と返品経路を直接確認します。マッピングされたステータスを顧客への連絡や自動化に利用する前に、代表的な配送でテストします。

17TRACKはTracking API overviewとAPI documentationを公開しており、17RETURNS product pageではワークフローの返品管理側を扱っています。返品プロセスと追跡の可視性を併せて評価するチームにとって、これらは関連する出発点です。ただし、両方の製品領域が存在することは、特定の統合、配送業者、イベント、または自動返金ルールが利用可能である証拠とはみなさないでください。最新のドキュメントで正確なワークフローを確認し、必要に応じてプロバイダーにも確認してください。

調達または概念実証では、返品ポリシーと倉庫業務を担当するチームに、エンジニアリングとともにステータスマッピングを確認してもらいます。エンジニアリングはAPIが利用可能なイベントを提供するか確認でき、業務チームはそのイベントが提案されたアクションを正当化できるか確認できます。成功する統合とは、承認、受領、検品、解決を別々の段階として維持しながら、担当者と顧客が荷物を追跡できるよう支援するものです。

FAQ

返品には元の注文とは異なる追跡番号が必要ですか?

プラットフォームは、出荷と返品の配送記録を別々に保持する必要があります。返品は通常、別の配送として移動するため、その追跡識別子は返品荷物に関連付ける必要があり、元の注文の出荷時識別子だと想定してはなりません。利用できる正確な識別子は、返品の発送方法によって異なります。

追跡APIで返金すべきことを確認できますか?

追跡イベントだけで、返品商品が販売者の返金条件を満たしていることを確認することはできません。プラットフォームは配送業者イベントをワークフローへの入力として利用できますが、返金対象となるかどうかは、承認、実際の受領、検品、販売者のポリシーにも左右される場合があります。

追跡では配送済みなのに、倉庫が荷物を見つけられない場合はどうすればよいですか?

配送業者が報告した配送イベントと、倉庫の受領記録を別々に保持します。報告された配送先とイベントの詳細を確認し、その後、施設の受け入れおよび照合プロセスを調査します。配送業者による配送を、倉庫での受領確認に黙って変換してはいけません。

返品配送の追跡にはWebhookが必須ですか?

必ずしもそうではありません。更新方法は、選択したプロバイダーと、そのプロバイダーが文書化している選択肢によって決まります。Webhookを利用できる場合は、認証、再試行、重複配信、処理失敗に備えます。ポーリングを使用する場合は、返品ワークフローとプロバイダーの要件に適した間隔と停止ルールを選択します。

顧客に最初の追跡更新を表示するのはいつですか?

それは、配送業者がイベントを報告する時期と、統合がそれを受信する時期によって異なります。ラベルの作成や配送の登録は、配送業者によるスキャンより前に行われる場合があります。顧客が最初の更新待ちを配送の確定と解釈しないよう、この違いを明確に表示します。

出典