OMS ↔ WMS: inventario, push, retorno de envío y tracking
Última actualización 2026-10-13
Cómo se comunican: resolución de inventario, push idempotente, callbacks y tracking.
En modo wms_sync forman un ciclo cerrado: OMS lee inventario, envía pedidos, WMS ejecuta y devuelve callbacks.
Resolución de la fuente de inventario#
- La configuración define el valor del tenant y excepciones por almacén.
- En wms_sync el libro OMS es de solo lectura; el ATP lee qty_available.
Push: pedido → salida WMS#
- Convierte líneas en wms_order_lines sin mapeo de SKU.
- La salida se crea en commit, bloqueando inventario; el pedido pasa a released.
- Un pedido puede dividirse en varias salidas; el detalle las lista todas.
Retorno: WMS → OMS#
- Al enviar WMS, el hook acumula fulfilled_qty y completa el tracking por línea.
- El estado del pedido se deriva de las líneas: todo enviado → fulfilled.
- Cada envío escribe un evento shipped que alimenta la timeline y el tracking.
Tracking devuelto a los canales#
- Al enviar, el tracking se sincroniza al canal; un fallo no bloquea la respuesta.
- El estado queda en tracking_sync_status; reintente disponible.
- Solo shipped dispara la sincronización; delivered no.
El estado de línea es derivado, no almacenado.