配送ラベルなしでTracking APIは機能しますか?3PLおよびマーケットプレイスの注文を追跡できますか?
はい。配送ラベルを自社で作成していなくても、運送業者または配送パートナーが追跡可能な出荷を作成し、利用可能な追跡番号またはAPIが対応する別の識別子を取得できる限り、追跡APIは機能します。これは、サードパーティ・ロジスティクスプロバイダー(3PL)またはマーケットプレイスがフルフィルメントを担当する場合によくあります。重要なのは、自社でラベルを購入していないことと、出荷識別子がまったく存在しないことを区別することです。前者は通常問題なく対応できますが、後者ではAPIに追跡対象がなくなる可能性があります。

販売者、マーケットプレイス運営者、または統合チームにとって実務上の作業は、各注文を実際に発送する当事者が作成した出荷に紐付けることです。そのために必要なのは適切なデータへのアクセスであり、ラベル作成を管理することでは必ずしもありません。
ラベルを作成しない場合に追跡APIが必要とするもの
配送ラベルは出荷識別子を生成する方法の一つですが、通常、追跡APIが読み取る入力そのものではありません。追跡連携は一般に、ラベルが別の場所で作成された後に提供される出荷データを使用して機能します。連携を設計する前に、しばしば同じものとして扱われる次の3つの記録を区別してください。
- 注文ID:ストア、マーケットプレイスアカウント、または注文管理システム内の購入を識別します。複数の商品や複数の出荷を含む場合があります。
- フルフィルメントIDまたは荷物ID:3PLまたはマーケットプレイスのシステム内で、フルフィルメント処理または小包を識別します。形式と意味はシステムによって異なります。
- 運送業者の追跡番号:運送業者および追跡サービスが受け付けることを条件に、追跡目的で出荷を識別します。
社内注文IDは、適切な顧客注文を見つけるのに役立ちますが、自動的に運送業者の追跡番号として機能するわけではありません。通常の連携パターンは、3PLまたはマーケットプレイスから追跡番号を取得し、その番号を追跡APIに登録または照会し、返された出荷情報を関連する注文または荷物に紐付けて保存することです。
運送業者名またはコードも必要になる場合があります。サービスによっては運送業者の自動判定を試みることができますが、特に識別子が複数の運送業者間で重複する場合や、注文が複数の配送ネットワークをまたぐ場合は、想定せずにテストしてください。実装を決定する前に、APIのドキュメントで対応する識別子、運送業者の選択規則、登録要件、ステータス項目を確認してください。
3PLが発送する注文を追跡する
3PLが注文を梱包し、ラベルを購入して小包を運送業者に引き渡す場合、自社がラベルそのものを見ることはないかもしれません。それでも、その処理によって生成される出荷詳細は必要です。フルフィルメントを依頼した際に提供した追跡番号、運送業者情報、荷物識別子、注文参照番号を、どのシステムまたはデータフィードで取得できるかを3PLに確認してください。
実用的な3PLフローは通常、次のようになります。
- 既存のフルフィルメントプロセスを通じて、注文と安定した参照番号を3PLに送信する。
- 荷物単位の追跡番号と、利用可能な場合は運送業者を含むフルフィルメント確認を受け取る。
- その荷物を正しい顧客注文および商品に紐付ける。
- 対応する出荷識別子を追跡APIに送信するか、APIが指定する照会方法を使用する。
- 荷物単位で追跡更新を記録し、運用チームまたは顧客に注文単位の表示を提供する。
紐付けの工程には特に注意が必要です。1つの注文が2つの箱に分かれて倉庫を出る場合や、1つの商品だけが他の商品より後に発送される場合があります。いずれの場合も、注文全体を正確に表す単一の荷物ステータスは存在しません。荷物単位の記録を保持し、それらから注文単位のメッセージを作成してください。たとえば、最初の小包が配達されたという理由だけで注文を配達済みにしないでください。
訂正情報をどのように提供するかを3PLと合意してください。ラベルが無効化されたり、小包が再梱包されたり、最初の追跡番号が置き換えられたりすることがあります。連携システムは、置き換え後の番号を同じ注文に関連付け、両方の番号を無期限に有効な出荷として表示しないようにする必要があります。
マーケットプレイスが配送を管理する注文を追跡する
マーケットプレイスのフルフィルメントでは、同様の技術的な問題が発生しますが、アクセスに関する問題は異なります。マーケットプレイスまたはそのフルフィルメントパートナーがラベルを作成しても、販売者が受け取れるのは、アカウント、注文フロー、または認証済み連携で公開される配送詳細だけかもしれません。マーケットプレイスが利用可能にしていない追跡番号を、追跡APIで補うことはできません。
まず、各注文のフルフィルメントモデルを特定してください。販売者発送の注文では、自社の配送フローまたは3PLが荷物データの情報源になる場合があります。マーケットプレイス発送の注文では、マーケットプレイスが出荷情報の情報源となり、販売者が利用できる項目が異なる場合があります。注文ページに配送ステータスが表示されていても、別のAPIへの登録に適した運送業者の追跡番号が提供されるとは限りません。
マーケットプレイスが追跡可能な番号を提供する場合は、意図するシステムでその番号を取得・使用する権限があることを確認してください。次に、追跡APIがその識別子を受け付けるか、また結果として得られるイベントがマーケットプレイスのステータスを超える有用な情報を提供するかをテストします。マーケットプレイスが独自の注文参照番号または配送参照番号しか公開していない場合は、明示的に対応している照会方法があるか確認してください。内部マーケットプレイス注文IDを運送業者番号のように送信し、信頼できる結果を期待してはいけません。
マーケットプレイスの注文状態と追跡APIの出荷状態は分けて管理してください。マーケットプレイスはフルフィルメントが確認されると注文を発送済みと表示する一方、運送業者の追跡ではまだ受付スキャンが表示されないことがあります。これらの記録は異なる質問に答えるものであり、異なるタイミングで更新される場合があります。
ラベルなしの追跡では解決できない場合
「自社でラベルを作成していない」こと自体は障害ではありません。次の状況は問題になる可能性があります。
- 出荷が作成されていない:フルフィルメントによって利用可能な識別子が生成される前は、照会できる運送業者の出荷が存在しない場合があります。注文確認だけでは、小包が輸送中である証拠にはなりません。
- 識別子を利用できない:3PLまたはマーケットプレイスが番号を保持していても、認証済みのフローを通じて公開していない場合があります。このデータアクセスの問題を情報源側で解決してください。
- 識別子に対応していない:参照番号、マーケットプレイス専用コード、または未対応の運送業者形式は、選択したAPIで機能しない可能性があります。ドキュメントとテスト出荷で受け付けられる入力を確認してください。
- 小包にまだ新しいスキャンがない:運送業者が受付イベントを記録する前に番号が作成されることがあります。空の結果や変化のない結果は、番号が無効だと自動的に判断せず、調査すべき状態として扱ってください。
- 追跡が制限されている、または不完全である:運送業者、サービス、または出荷フローが、顧客向けの用途に必要なイベントを提供しない場合があります。代表的な出荷を使用して、実際のイベント品質を確認してください。
これらの制限が重要なのは、APIが存在しない物理的なイベントを作成したり、他者の注文データへのアクセス権を付与したりできないためです。必要な識別子と権限が存在して初めて、対応する追跡情報を取得・整理できることにAPIの価値があります。
このワークフロー向けAPIの評価方法
チームがラベル購入用のツールではなく、自社システム内で出荷追跡データを必要とする場合、17TRACKのTracking APIは検討に値する選択肢です。開発者向けドキュメントで、登録時に受け付けられる項目、対応する運送業者、レスポンス構造、認証、用途に利用可能な更新配信方法を確認してください。一般的な追跡APIが存在することだけを根拠に、特定の3PL、マーケットプレイス、または独自識別子への対応を推測しないでください。
プロバイダーを選択または導入する前に、小規模なテストセットを作成してください。運送業者番号を持つ3PL注文、アカウントに番号が公開されているマーケットプレイス注文、複数の小包に分かれた注文、最初のスキャン前に作成された番号、後から配達イベントが発生する出荷を含めます。番号の置き換えや国際的な引き渡しが日常的に発生する場合は、それらも含めてください。テストでは、リクエストが成功したHTTPレスポンスを返すかどうかだけでなく、運用上の問題に答えられるようにします。
- 実際に受け取る識別子を手作業で書き換えずに渡せますか。
- 各追跡記録を正しい注文と荷物に確実に紐付けられますか。
- イベントの説明、タイムスタンプ、運送業者情報は、顧客向けメッセージやサポート業務に十分ですか。
- 重複更新、欠落イベント、番号変更、リクエスト失敗をシステムでどのように処理しますか。
- マーケットプレイスおよび顧客データの意図した利用は、そのデータに適用されるアクセス条件に準拠していますか。
連携自体では、元の情報源の記録と追跡APIの記録の両方を保持してください。注文参照番号、荷物参照番号、送信した追跡番号、利用可能な場合は運送業者情報、各更新を受信した時刻を保存します。これにより、APIイベントを完全なフルフィルメント履歴であるかのように表示せず、照合不一致を調査しやすくなります。APIが定期的な確認と、対応する配信メカニズムによる更新受信のいずれかを提供している場合は、文書化された動作と更新の即時性に対する要件に基づいて選択してください。どちらの方法でもエラー処理は必要です。
実務上の判断
他者が小包を発送し、使用権限のある対応済みの出荷識別子を提供してくれる場合は、ラベルを作成せずに追跡APIを使用できます。まず、3PLまたはマーケットプレイスから信頼できる荷物データフィードを確保します。次に、識別子と追跡イベントをAPIおよび注文照合ロジックに対してテストします。注文IDまたはマーケットプレイスのステータスしかない場合は、運送業者追跡連携に投資する前に、情報源のデータ不足を解決してください。
FAQ
ストアの注文番号だけで注文を追跡できますか。
通常、運送業者追跡APIではできません。ストアの注文番号は、システム内の購入を識別するものです。特定のサービスが注文参照番号の種類による照会に明示的に対応していない限り、通常は対応する出荷識別子が必要です。
3PLの追跡番号を使用するには、3PLの許可が必要ですか。
出荷データへの契約上および技術上のアクセス権を確認してください。3PLはフルフィルメントフィードの一部として追跡番号を返している場合がありますが、連携では認証済みの経路を使用し、顧客データを適切に扱う必要があります。
3PLから番号を受け取った後もAPIに動きが表示されないのはなぜですか。
運送業者の最初の記録済みスキャンより前に番号が作成された可能性があります。識別子と運送業者が正しいか、元のラベルが置き換えられていないか、後の照会でイベントが表示されるかを確認してください。フルフィルメント記録を確認せずに「まだスキャンされていない」を「発送されていない」と同一視しないでください。
1つのマーケットプレイス注文が複数の小包に分かれて発送された場合はどうしますか。
利用可能な各荷物識別子を個別に追跡し、すべての荷物を同じ注文に関連付けてください。顧客向けの注文ステータスと個々の小包ステータスを分けて管理し、1つの小包が配達済みになっただけで注文全体が完了したように表示されないようにします。
出典
- 17TRACK Tracking API — 出荷追跡連携を評価するための製品情報。
- 17TRACK API Documentation — 受け付けられる入力と連携動作を確認するための技術リファレンス。


