Documentation API
Centre d'aide/Documentation API/Catalogue des codes d’erreur

Catalogue des codes d’erreur

Dernière mise à jour 2026-10-13

Tous les codes d’erreur WMS, leur statut HTTP et le format d’erreur OMS.

Format d’erreur WMS#

Format de réponse d’erreur
HTTP 409
{ "code": "WMS_STOCK_001", "message": "库存可用量不足", "details": { "item_id": "…" } }
// body: { code, message, details? } — the HTTP status comes from the code table below.

Table des codes#

  • WMS_AUTH_001 · 401 — Non connecté ou session expirée.
  • WMS_PERM_001 · 403 — Pas d’accès à l’app WMS.
  • WMS_PERM_002 · 403 — Point de permission manquant.
  • WMS_PERM_003 · 403 — Portée de données restreinte.
  • WMS_VALID_001 · 400 — Paramètres de requête invalides.
  • WMS_STATE_001 · 409 — Transition d’état illégale.
  • WMS_STOCK_001 · 409 — Stock disponible insuffisant.
  • WMS_NOT_FOUND_001 · 404 — Ressource introuvable.
  • WMS_DUP_001 · 409 — La ressource existe déjà (conflit d’unicité).
  • WMS_SERVER_001 · 500 — Erreur interne du serveur.
  • BOL_TRUCKLOAD_ONLY · 409 — BOL réservé aux expéditions LTL/FTL.
  • LOCATION_LOCKED · 409 — Emplacement verrouillé par une tâche de comptage.
  • SERIAL_COUNT_MISMATCH · 400 — Le nombre de numéros de série ne correspond pas.
  • UOM_IN_USE · 400 — L’UOM est référencée et ne peut pas être supprimée.
  • RECEIPT_CLOSED · 400 — Le bon est fermé ; état terminal immuable.

Format d’erreur OMS#

Réponse d’erreur 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
Les intégrations doivent brancher sur code / error et traiter d’abord 401/403 : 401 = renouveler le JWT ; 403 = mauvaise organisation ou permission manquante.