Documentação da API
Central de ajuda/Documentação da API/Catálogo de códigos de erro

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#

Formato de resposta de erro
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#

Resposta 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_EDITABLE
Integrações devem ramificar por code / error e tratar 401/403 primeiro: 401 = renovar JWT; 403 = organização ou permissão incorreta.