WMS–ERP 連携：インターフェース設計の 8 つの罠

導入：「接続した」と「統合した」は別物

あるメーカーは 6 ヶ月計画で WMS を導入したが、7 ヶ月目になっても結合テストの最中だった。振り返りの結論：WMS 本体の調整は 3 ヶ月で終わり、残りの 4 ヶ月は ERP とのインターフェースに費やされた。私の経験則：WMS の本番稼働が遅れる場合、原因の 70% はインターフェースにある。インターフェース設計は「つなぐだけ」ではない——細部にこそ悪魔が潜む。以下の 8 つの罠のうち 3 つを踏めば、プロジェクトは遅延する。

8 つの罠

罠 1：マスタデータの所有者を決めていなかった

品目・顧客・仕入先マスタは ERP のもの、WMS は読み取るだけ。ロケーション、ロットルール、戦略パラメータは WMS のもの。悪夢は双方向書き込みだ——両方が品目マスタを編集すれば、遅かれ早かれ乖離する。原則：マスタレコードには所有者が 1 人だけ。

罠 2：伝票ステータスの状態遷移を合わせていなかった

ERP の「承認」は WMS の「実行可能」に対応するが、その間に「引当済み」「リリース済み」など複数の状態が挟まる場合がある。状態のずれは伝票を凍結させる：ERP は送ったつもり、WMS は届いていないと言う。コーディング前に両方の状態対応表を描き、すべての状態を確認せよ。

罠 3：インターフェースに冪等性がなかった

ネットワークの揺らぎでリトライが発生し、同じ入荷伝票が 2 回実行されると幽霊在庫が生まれる。書き込み系インターフェースは業務キー（入荷番号＋行番号）で重複排除し、再呼び出しでは最初の結果を返すこと。鉄則、例外なし。

罠 4：ロット・シリアル番号の項目を完全にマッピングしていなかった

ERP はロット番号があれば満足するが、WMS はロット属性を管理しなければならない：有効期限、検査ステータス、保留理由。項目マッピング表は 1 行ずつ確認する——特に、ERP にあって WMS にない項目、WMS が必要で ERP が提供しない項目は要注意。デフォルト値や手動補完フローを先に定義せよ。

罠 5：在庫同期のタイミングを誤った

リアルタイム同期は美しく聞こえるが、1 日 100,000 件以上の在庫異動は ERP を破壊する。実績ある組み合わせは「差分プッシュ＋定期照合」だ：WMS が差分をリアルタイムでプッシュし、ERP が 4 時間ごとに照合し、閾値超過はアラートを上げる。

罠 6：標準の例外コールバックがなかった

WMS 側の不足入荷・破損・却下には標準の戻りコードが必要で、ERP 側にも対応プロセス（再発注、クレーム、廃棄）が必要だ。これがないと、差異伝票が WMS に溜まる一方で経理は月次締めができず、2 つの部門が互いを責め合う。

罠 7：インターフェースの監視がなかった

すべてのインターフェースにはリトライロジック、デッドレターキュー、アラート閾値が必要だ。初週は毎日照合し、その後は週次に落とす。監視されていないインターフェースでは、IT より先に現場が障害を発見する——最も高くつく発見方法だ。

罠 8：カットオーバー時に並行稼働しなかった

旧システムと新 WMS を 1～2 週間並行稼働させ、日次締めで照合する。在庫差異が 0.5% 以下に収まってからカットオーバーすること。直接カットオーバーには勇気がいるが、その代償はライン停止かもしれない。

対策表

現場事例：安定するまでに 3 回作り直した

あるメーカーは WMS–SAP 連携を 3 回作り直した。1 回目は状態遷移のずれで伝票が凍結し、2 回目はロット項目の不足で有効期限管理が破綻し、3 回目でようやく冪等性と監視を追加した。根本原因：結合テスト環境の到着が 2 ヶ月遅れ、インターフェース設計はドキュメントと想像だけで作られた。教訓：テスト環境とマスタデータマッピング表こそプロジェクトの最優先事項であり、付随業務ではない。

避けるべき落とし穴

• コードより先に仕様書。項目マッピング表・状態対応表・例外コード表は開発開始前に両者で署名する。
• プロジェクト時間の少なくとも 30% をインターフェースに充てる。健全な配分：WMS 本体 40%、インターフェースと結合テスト 30%、カットオーバーと安定化 30%。
• ERP ベンダーの協力を契約に盛り込む。遅延の多くは ERP 側のスケジュールに起因する——口約束は約束にならない。

第 1 週：インターフェース台帳を作る

WMS プロジェクトの第 1 週はコードを書かず、インターフェース台帳を作る：

量 × 複雑さで順位付けし、難しいものから取り組む。原則：中核伝票インターフェース（入荷・出荷・在庫）が報告・照会インターフェースより先。すべてのインターフェースに業務＋IT の 2 人の責任者を付け、常に連絡先があるようにする。

この表はプロジェクトの早期警戒レーダーだ。業務責任者がいないインターフェースは、将来の遅延そのものだ。

結合テスト環境：構築が遅れれば遅延は確定

結合テストが死ぬ最も一般的な原因：環境が準備できていなかった。譲れない 4 要素：

1. ERP テスト環境： データは本番のマスク済みコピーでなければならず、空のデータベースは決して使わない。空でテストすることはテストではない。
2. WMS テスト環境： 本番と同じバージョンで、完全な基本マスタデータを備える。
3. テストデータ： 正常フロー＋例外フロー（不足入荷、破損、却下、ロット保留）、それぞれ少なくとも 20 トランザクション。
4. ベンダー時間の確保： ERP ベンダーのコンサルタントを 4 週間前に押さえる——口約束は予約にならない。

準備完了ゲート：運用スタッフを招く前に、両方の IT チームがテスト環境で完全な業務トランザクションを独立に 1 回ずつ実行する。現場の人々の時間は最も高価だ——環境待ちで燃やすな。

まとめ

WMS–ERP 連携の 8 つの罠は、実はすべて「思い込み」だ。マスタは一致するはず、状態は揃うはず、ネットワークは揺らがないはず。署名済みの 3 つの表（項目マッピング、状態対応、例外コード）に加え、冪等性・監視・並行稼働があれば、遅延リスクの 70% を始まる前に消せる。

英語版からの翻訳。内容に相違がある場合は英語版を優先します。