Catálogo de códigos de error
Última actualización 2026-10-13
Todos los códigos de error WMS, su estado HTTP y el formato de error de OMS.
Formato de error WMS#
HTTP 409
{ "code": "WMS_STOCK_001", "message": "库存可用量不足", "details": { "item_id": "…" } }
// body: { code, message, details? } — the HTTP status comes from the code table below.Tabla de códigos#
- WMS_AUTH_001 · 401 — Sin sesión o sesión expirada.
- WMS_PERM_001 · 403 — Sin acceso a la app WMS.
- WMS_PERM_002 · 403 — Falta punto de permiso de función.
- WMS_PERM_003 · 403 — Alcance de datos restringido.
- WMS_VALID_001 · 400 — Parámetros de solicitud inválidos.
- WMS_STATE_001 · 409 — Transición de estado ilegal.
- WMS_STOCK_001 · 409 — Stock disponible insuficiente.
- WMS_NOT_FOUND_001 · 404 — Recurso no encontrado.
- WMS_DUP_001 · 409 — El recurso ya existe (conflicto único).
- WMS_SERVER_001 · 500 — Error interno del servidor.
- BOL_TRUCKLOAD_ONLY · 409 — BOL solo admite envíos LTL/FTL.
- LOCATION_LOCKED · 409 — Ubicación bloqueada por tarea de conteo.
- SERIAL_COUNT_MISMATCH · 400 — El conteo de series no coincide con la cantidad.
- UOM_IN_USE · 400 — La UOM está referenciada y no se puede eliminar.
- RECEIPT_CLOSED · 400 — El albarán está cerrado; estado terminal inmutable.
Formato de error 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_EDITABLELas integraciones deben ramificar por code / error y tratar primero 401/403: 401 = renovar JWT; 403 = organización o permiso incorrecto.