OMS ↔ WMS : stock, push, retour d’expédition et tracking
Dernière mise à jour 2026-10-13
Comment ils dialoguent : résolution du stock, push idempotent, callbacks et tracking.
En mode wms_sync, boucle fermée : OMS lit le stock, pousse les commandes, WMS exécute et renvoie des callbacks.
Résolution de la source de stock#
- La config définit la valeur tenant et les exceptions par entrepôt.
- En wms_sync, le livre OMS est en lecture seule ; l’ATP lit qty_available.
Push : commande → sortie WMS#
- Convertit les lignes en wms_order_lines sans mapping SKU.
- La sortie est créée en commit, verrouillant le stock ; la commande passe à released.
- Une commande peut se diviser en plusieurs sorties ; le détail les liste toutes.
Retour : WMS → OMS#
- À l’expédition WMS, le hook accumule fulfilled_qty et renseigne le tracking par ligne.
- Le statut de la commande dérive des lignes : tout expédié → fulfilled.
- Chaque expédition écrit un événement shipped alimentant la timeline et le tracking.
Tracking renvoyé aux canaux#
- À l’expédition, le tracking est synchronisé au canal ; un échec ne bloque pas.
- Le statut va dans tracking_sync_status ; nouvelle tentative possible.
- Seul shipped déclenche la synchro ; delivered non.
Le statut de ligne est dérivé, non stocké.