API ドキュメント

エラーコード表

最終更新 2026-10-13

すべての WMS エラーコードと HTTP ステータス、および OMS のエラー形式。

WMS エラー形式#

エラーレスポンス形式
HTTP 409
{ "code": "WMS_STOCK_001", "message": "库存可用量不足", "details": { "item_id": "…" } }
// body: { code, message, details? } — the HTTP status comes from the code table below.

コード表#

  • WMS_AUTH_001 · 401 —— 未ログインまたはセッション期限切れ。
  • WMS_PERM_001 · 403 —— WMS アプリへのアクセス権なし。
  • WMS_PERM_002 · 403 —— 機能権限ポイント不足。
  • WMS_PERM_003 · 403 —— データスコープ制限。
  • WMS_VALID_001 · 400 —— リクエストパラメータ不正。
  • WMS_STATE_001 · 409 —— 不正な状態遷移。
  • WMS_STOCK_001 · 409 —— 利用可能在庫不足。
  • WMS_NOT_FOUND_001 · 404 —— リソースが存在しません。
  • WMS_DUP_001 · 409 —— リソース既存(一意制約違反)。
  • WMS_SERVER_001 · 500 —— サーバー内部エラー。
  • BOL_TRUCKLOAD_ONLY · 409 —— BOL は LTL/FTL 出荷のみ対応。
  • LOCATION_LOCKED · 409 —— 棚卸タスクによりロケーションがロック中。
  • SERIAL_COUNT_MISMATCH · 400 —— シリアル番号数と商品数量が不一致。
  • UOM_IN_USE · 400 —— UOM はパレット設定に参照されているため削除不可。
  • RECEIPT_CLOSED · 400 —— 入庫伝票はクローズ済み、終端状態は変更不可。

OMS エラー形式#

OMS エラーレスポンス
HTTP 400
{ "ok": false, "error": "NOT_EDITABLE", "detail": { "status": "confirmed" } }
// OMS uses { ok: false, error, detail? } — different from the WMS envelope above.
// common codes: UNAUTHORIZED | FORBIDDEN_ORGANIZATION | FORBIDDEN_PERMISSION | NOT_WMS_SYNC | NOT_EDITABLE
連携側は code / error で分岐し、401/403 を優先処理してください。401 は JWT の再取得、403 は通常 x-organization-id の誤りか権限不足です。