まず結論から。配送ラベルAPIで注文が紛失したトラブルシューティングの事例では、運送会社があなたの注文を紛失したことはほとんどありません。実際に起きているのは、チェーンのどこか一か所が注文を次へ渡し損ねたということです。注文は入り、出庫注文が作成され、それなのにラベルが出てこない。荷物は梱包台の上に置き去りにされ、カスタマーサービスの電話が鳴り始めます。私はこの故障を正確に3回見てきましたが、根本原因は毎回違いました。ただ、見つけ方は常に同じチェーンです。OMSからWMSへ、WMSから運送会社APIへ、そしてプリンターへ。1区間ずつたどるのです。まず特定し、それから直す。
紛失したラベルの一番つらいところは、紛失そのものではありません。どこを探せばいいのか分からないことです。梱包担当は「システムがラベルを印刷しなかった」と言い、カスタマーサービスは「注文は確定済み」と言い、ITは「APIはエラーを返していない」と言います。3人とも正しいのです。注文はその間の隙間に挟まっているからです。以下のチェーンは、その隙間を見つける方法です。
まず特定する:配送ラベルAPIのどの区間が注文を紛失したのか
サービスを再起動したり、注文を再送信したりすることから始めないでください。5分かけて故障箇所を特定します。注文は4つの区間のいずれかに引っかかっており、その後の手順はすべて、どの区間かによって決まります。
OMSで注文ステータスを確認します。確定済みで出荷待ちなのか、それともすでにWMSへ送られているのか。OMSが一度も送っていないなら、問題はラベルAPIではなくOMSの送信ルールにあります。次に、WMSにその出庫タスクがあるか、タスクがピッキング待ちか、ピッキング済みか、梱包済みかを確認します。タスクがなければ、注文はOMSとWMSの間で消えています。タスクはあり、ラベル要求は送られ、運送会社からの返信がないなら、問題はAPI区間にあります。返信は届き、ラベルファイルも届き、プリンターが沈黙しているなら、問題は印刷区間にあります。
特定するとは、何かに触る前に4つの質問をして答えを書き留めることです。OMSは送ったか。WMSは受け取ったか。運送会社は返信したか。プリンターは印刷したか。答えが「いいえ」に変わる区間こそ、問題が潜んでいる場所です。
配送ラベルAPI紛失注文のトラブルシューティング:注文からドックまでの4区間ウォーク
区間1、OMSからWMSへ。ここで最も多い故障は、ある注文タイプをカバーしていない送信ルールです。ピークシーズン中にチームが新しいギフト注文タイプを追加し、送信ルールがそれを一度もカバーせず、注文はOMSに残ったまま、WMSはその存在を一切知りません。確認方法:紛失した注文番号でOMSの送信ログを検索します。送信記録はあるか、結果は何だったか。記録がなければルールの問題です。失敗の記録があればネットワークか項目の問題です。安全策:OMSの送信にリトライとアラートを追加します。送信が3回失敗したら、当番の担当者を呼び出します。注文を黙って放置してはいけません。
区間2、WMSの内部。タスクはあり、ピッキングは終わり、ラベル印刷のステップで止まっています。私はこの落とし穴を3回見ましたが、根本原因は毎回同じでした。WMSがラベル要求を送る前に、住所と重量と運送会社のサービス商品を検証するのです。3つのうち1つでも検証に失敗すると、要求は送られず、エラーも出ず、タスクの備考に小さな1行が残るだけです。確認方法:タスク詳細を開き、検証パネルを見ます。安全策:検証の失敗は目に見えるプロンプトを出し、ログに記録しなければなりません。サイレントな失敗こそ、紛失ラベルの最大の共犯者です。
区間3、運送会社API。要求は出たのに、返信が戻ってきません。ここには2つのパターンがあります。1つは運送会社APIのタイムアウトです。もう1つは、返信は戻ってきたのにWMSがそれを認識しなかった場合です。タイムアウトの場合は、まずタイムアウトが何秒に設定されているかを確認し、次にピーク時間帯のキューイングかどうかを確認します。認識されなかった返信の場合、運送会社のステータスコードが自社システムにマッピングされているステータスコードと一致していないことがほとんどです。確認方法:要求のトレースIDをAPIログに持ち込み、運送会社が実際に何を返したかを確認します。安全策:タイムアウト時は自動で1回だけリトライしますが、リトライする前にラベル番号がすでに発行されていないか確認します。1つの注文にラベル番号を2つ作ってはいけません。
区間4、プリンターとラベルファイル。ラベルファイルは届いたのにプリンターが何もしないか、印刷したのにシステムが注文を未出荷のまま表示している。まずプリンターのキューを確認し、次にラベルファイルの形式が正しいかを確認し、次に書き戻しを確認します。印刷成功はWMSに書き戻されたか。書き戻しの失敗は、4つの中で最も厄介です。荷物はすでに出発しているのに、システムは出荷待ちのままで、在庫も注文ステータスも両方間違っています。確認方法:プリンターのログとシステムの出荷記録を突き合わせます。件数が合わなければ、書き戻しが失われています。安全策:印刷成功が書き戻しで確認されるまで、荷物を出してはいけません。梱包台での余分な10秒は、現実と食い違うシステムよりずっとましです。
| 区間 | 典型的な症状 | まず確認すること | 安全策 |
|---|---|---|---|
| OMSからWMSへ | WMSにタスクがない | 送信ログ、注文タイプのルール | 3回リトライし、それからアラート |
| WMSの内部 | ラベル印刷でタスクが止まる | 住所と重量の検証パネル | 検証の失敗はプロンプトを出し、ログに記録する |
| 運送会社API | 要求は送られたが返信がない | APIログ、ステータスコードのマッピング | リトライ前にラベル番号の有無を確認する |
| プリンター | 印刷したが未出荷のまま | 印刷キュー、書き戻しの記録 | 出す前に書き戻しを確認する |
ここが直感に反する部分です。ラベルを紛失したとき、最も恐れるべきは紛失ではありません。重複です。ラベルがないのを見た途端、人はリトライを押し、注文を再送信し、ラベルはついに出てきます。2回も。ラベル番号が2つ、注文は1つ。1つの荷物が出荷され、もう1つのラベル番号はシステムの中を漂います。良くても在庫が間違います。最悪の場合、顧客は商品を手にしているのにシステムは未出荷のままで、カスタマーサービスは2度目のパニックに陥ります。リトライする前に、ラベル番号がすでに存在しないか確認してください。これが鉄則です。特定にかけるゆっくりした10分は、再送信する速い3秒に勝ります。
私のクライアントの1社が、ピークシーズンの前夜に新しい運送会社APIへ切り替え、初日に200枚以上のラベルを紛失しました。根本原因は恥ずかしいほど単純でした。新しいAPIの締め切り時刻が、古いAPIより1時間早かったのです。締め切り後に受けた注文はその場で却下され、システムは一度もアラートを出しませんでした。結局チームは午前3時まで、1枚ずつ手でラベルを印刷しました。その夜のあと、私はルールを作りました。ピークシーズンの前夜にインターフェースを切り替えてはいけない。
ゴーライブ当夜のチェックリスト:寝る前にこれを通す
ゴーライブの夜は、ビジョンを語る時間ではありません。このリストを上からたどり、すべての項目にチェックを入れます。
1つ目、送信ルール。すべての注文タイプがカバーされているか。テスト注文だけでなく、実際の注文を最初から最後まで通します。2つ目、検証ルール。住所、重量、サービス商品。検証が失敗したとき、誰かがプロンプトを見ることができるか。3つ目、タイムアウトとリトライ。タイムアウトは何秒か。リトライは何回か。リトライはまず既存のラベル番号を確認するか。4つ目、ステータスコードのマッピング。運送会社が返すすべてのステータスコードを、自社システムは認識しているか。5つ目、印刷の書き戻し。プリンターがオフライン、紙切れ、紙詰まり、それぞれの場合にシステムはどうするか。6つ目、アラート。紛失したラベルが何枚、あるいは何分止まったら、誰かに電話がかかるか。7つ目、代替手段。APIが完全に落ちた場合、誰が手でラベルを印刷し、ラベル番号はどこから来るのか。
寝る前に7つすべてにチェックを入れます。1つでもチェックを漏らせば、真夜中の電話はあなたのものです。
配送ラベルAPIの紛失注文のトラブルシューティングは、初めてやるときは難しくありません。難しいのは、毎回同じやり方でやることです。勘に頼らず、チェーンに沿って進めるのです。この手順書を梱包台の横に貼ってください。次にラベルが出てこなかったら、4つの区間をたどれば、10分で特定できます。場所さえ正しければ、修正は速い。
Lin Xiao(WMS導入コンサルタント)著 英語版からの翻訳。内容に相違がある場合は英語版を優先します。







