Catálogo de códigos de erro
Última atualização 2026-10-13
Todos os códigos de erro WMS, seu status HTTP e o formato de erro do OMS.
Formato de erro WMS#
HTTP 409
{ "code": "WMS_STOCK_001", "message": "库存可用量不足", "details": { "item_id": "…" } }
// body: { code, message, details? } — the HTTP status comes from the code table below.Tabela de códigos#
- WMS_AUTH_001 · 401 — Não autenticado ou sessão expirada.
- WMS_PERM_001 · 403 — Sem acesso ao app WMS.
- WMS_PERM_002 · 403 — Ponto de permissão ausente.
- WMS_PERM_003 · 403 — Escopo de dados restrito.
- WMS_VALID_001 · 400 — Parâmetros de solicitação inválidos.
- WMS_STATE_001 · 409 — Transição de estado ilegal.
- WMS_STOCK_001 · 409 — Estoque disponível insuficiente.
- WMS_NOT_FOUND_001 · 404 — Recurso não encontrado.
- WMS_DUP_001 · 409 — Recurso já existe (conflito único).
- WMS_SERVER_001 · 500 — Erro interno do servidor.
- BOL_TRUCKLOAD_ONLY · 409 — BOL só admite remessas LTL/FTL.
- LOCATION_LOCKED · 409 — Localização bloqueada por tarefa de contagem.
- SERIAL_COUNT_MISMATCH · 400 — Contagem de seriais não confere com a quantidade.
- UOM_IN_USE · 400 — A UOM está referenciada e não pode ser excluída.
- RECEIPT_CLOSED · 400 — O recibo está fechado; estado terminal imutável.
Formato de erro 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_EDITABLEIntegrações devem ramificar por code / error e tratar 401/403 primeiro: 401 = renovar JWT; 403 = organização ou permissão incorreta.