Visión general
El OMS de NexLog OS unifica el pedido omnicanal, el inventario distribuido, BOPIS, ship-from-store, exception engine, digital twin y simulación what-if.
La máquina de estados del pedido es canónica, tiene NF-e, GNRE, DIFAL e ICMS nativos y se integra con WMS, TMS y Control Tower a través del mismo MDM.
Máquina de estados del pedido
Nueve estados canónicos del Pedido (orders), incluido CANCELLED, con cada transición emitida al ledger businessEvents.
| Código | Estado | Contexto |
|---|---|---|
DRAFT | Borrador | Pedido creado en cualquier canal: DTC, marketplace, B2B, POS o social commerce. |
APPROVED | Aprobado | Aprobación en el OMS, antes de la asignación. |
PICKING | En picking | Asignado y en preparación en el WMS. |
PACKED | Embalado | Embalaje concluido en el WMS. |
DISPATCHED | Expedido | Salida por el TMS; la NF-e se emite en esta transición. |
IN_TRANSIT | En tránsito | En ruta, con seguimiento del TMS. |
DELIVERED | Entregado | Entrega confirmada. |
COMPLETED | Concluido | Ciclo del pedido cerrado. |
CANCELLED | Cancelado | Transición válida desde cualquier estado anterior a DISPATCHED. |
La máquina de estados es inmutable: cada transición, realizada mediante POST /api/v1/orders/:id/transitions, genera un evento canónico con correlationId y causationId.
Entidades principales
El modelo canónico del OMS, compartido con WMS, TMS y ESG.
| Entidad | Código | Descripción |
|---|---|---|
| Pedido | orders | Entidad transaccional canónica del OMS. Acepta múltiples canales de origen (DTC, marketplace, B2B, POS) y propaga la máquina de estados. |
| Devolución | returns | Proceso completo de logística inversa. Conecta el WMS (reingreso) y el TMS (recolección), con auditoría fiscal y financiera. |
| Activo retornable | returnableAssets | Pallets, racks, contenedores y embalajes reutilizables, rastreados por SSCC/GTIN en el flujo de ESG y Reverse Chain Economics. |
Flujos operativos
Seis flujos sobre el mismo modelo de pedido.
Omnicanal
DTC, marketplaces, B2B, POS y social commerce en el mismo pipeline de pedidos.
BOPIS
Buy Online, Pick-up In Store: la tienda como punto de retiro, con SLA dedicado.
Ship-from-store
Inventario de tienda como CD distribuido, con enrutamiento inteligente de la asignación.
Exception engine
Reglas y playbooks para tratar quiebres de stock, retrasos, discrepancias y siniestros.
Digital twin
Réplica digital del pedido para simulación what-if antes de asignar.
Logística inversa
Devoluciones con red inversa y activos retornables rastreados de punta a punta.
Fiscal brasileño nativo
Documentos y tributos emitidos y calculados automáticamente según las transiciones de estado.
| Sigla | Descripción |
|---|---|
NF-e | Emisión automática en la transición DISPATCHED, adjunta al envío. |
GNRE | Guía de recaudación estatal para operaciones interestatales. |
DIFAL | Diferencial de alícuota calculado según el estado de destino. |
ICMS | Cálculo fiscal automático, con integración a sistemas tributarios. |
Endpoints REST
Endpoints versionados en /api/v1/.
| Endpoint | Métodos |
|---|---|
/api/v1/orders | GET, POST |
/api/v1/orders/:id/transitions | POST |
/api/v1/returns | GET, POST |
/api/v1/returnable-assets | GET |
Convención: endpoints en kebab-case, versionados en /api/v1/, y colecciones en camelCase.
KPIs que entrega el OMS
Perfect Order Rate
Pedido completo, a tiempo, sin daños y con la factura correcta.
Order cycle time
Tiempo promedio desde que se crea el pedido hasta que se entrega, con desglose por canal y región.
Return rate
Porcentaje de devoluciones, analizado por motivo, SKU y canal; impacta el Reverse Chain Economics.
El OMS como cerebro del supply chain operating system
El pedido como entidad canónica
En NexLog OS, el Pedido (orders) es la entidad que más viaja entre módulos. Nace en cualquier canal (DTC, marketplace, B2B, POS, social commerce), pasa por aprobación (APPROVED), se asigna en el WMS (PICKING, PACKED), lo entrega el TMS (DISPATCHED, IN_TRANSIT, DELIVERED) y se concluye (COMPLETED).
Cada transición genera un evento canónico (businessEvents) con correlationId y causationId, lo que permite trazabilidad de punta a punta, auditoría, replay y entrenamiento de modelos predictivos.
Omnicanalidad real, no integración frágil
BOPIS, ship-from-store, drop-ship y same-day dejan de ser casos especiales y pasan a ser políticas de asignación sobre el mismo modelo. Inventario de tienda, CD regional y 3PL conviven en el mismo inventario distribuido.
Devolución (returns) y Activo retornable (returnableAssets) tratan la logística inversa como ciudadana de primera clase, indispensable para embalajes retornables y economía circular.
Digital twin y exception engine
Antes de asignar, el digital twin del pedido permite simular escenarios: costo de asignar a un CD o a una tienda, impacto en CO2e, ventana de entrega esperada y riesgo de quiebre de stock.
El exception engine aplica playbooks a desvíos reales, como pago pendiente, quiebre de stock, retraso en muelle y discrepancia fiscal, y escala al Control Tower cuando una persona debe decidir. WMS, TMS, Customs, ESG y Finanzas comparten el mismo MDM, sin integraciones frágiles de por medio.