OMS ↔ WMS:在庫ソース・連携・出荷反映・追跡連携
最終更新 2026-10-13
2 システムの連携:在庫ソース解決、冪等連携、出荷コールバック、追跡連携。
wms_sync では閉ループ:OMS が在庫参照→出庫指示、WMS が実行→出荷コールバック。
在庫ソースの解決#
- 設定でテナント既定と倉庫別上書きを保持。受注ごとに解決。
- wms_sync では OMS 在庫台帳は参照のみ。ATP は WMS の qty_available を参照。
下推:受注 → WMS 出庫指示#
- 明細を wms_order_lines に変換。SKU マッピング不要。
- 出庫指示は commit で作成し在庫を引当て。成功で受注は released へ。
- 1 受注を複数出庫指示に分割可能。詳細ページに全て表示。
反映:WMS → OMS#
- WMS 出荷時、hook が OMS 明細の fulfilled_qty を累加し、追跡番号を反映。
- 受注ステータスは全明細から判定:全部出荷で fulfilled。
- 出荷ごとに shipped イベントを記録。タイムラインと追跡連携に利用。
販売チャネルへの追跡連携#
- 出荷時にチャネルへ追跡を連携。失敗しても出荷応答はブロックしない。
- 連携状態は tracking_sync_status に記録。再試行 API あり。
- 連携を発火するのは shipped のみ。delivered では発火しない。
明細ステータスは派生値(保存されない)。