错误码表

全部 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 —— 数据范围受限（仓库 / Merchant 范围外，或 Merchant 用户仅可读）。
• WMS_VALID_001 · 400 —— 请求参数错误（含缺必填字段、JSON 体非法）。
• 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 仅支持整车/零担（ship_mode=ltl/ftl）出库单。
• LOCATION_LOCKED · 409 —— 库位被盘点任务锁定，暂不可操作。
• SERIAL_COUNT_MISMATCH · 400 —— 序列号数量与产品数量不一致。
• UOM_IN_USE · 400 —— 该 UOM 被托盘配置引用，无法删除。
• RECEIPT_CLOSED · 400 —— 入库单已关闭，终态不可变更。

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