Documentación de API
Centro de ayuda/Documentación de API/Catálogo de códigos de error

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#

Formato de respuesta de error
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#

Respuesta 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_EDITABLE
Las integraciones deben ramificar por code / error y tratar primero 401/403: 401 = renovar JWT; 403 = organización o permiso incorrecto.