Overview
The NexLog OS OMS unifies the omnichannel order, distributed inventory, BOPIS, ship-from-store, exception engine, digital twin and what-if simulation.
The order state machine is canonical, has native NF-e, GNRE, DIFAL and ICMS and integrates with WMS, TMS and Control Tower through the same MDM.
Order state machine
Nine canonical states of the Order (orders), including CANCELLED, with every transition emitted to the businessEvents ledger.
| Code | State | Context |
|---|---|---|
DRAFT | Draft | Order created in any channel: DTC, marketplace, B2B, POS or social commerce. |
APPROVED | Approved | Approval in the OMS, before allocation. |
PICKING | Picking | Allocated and being picked in the WMS. |
PACKED | Packed | Packing completed in the WMS. |
DISPATCHED | Dispatched | Departure through the TMS; the NF-e is issued at this transition. |
IN_TRANSIT | In transit | On the road, tracked by the TMS. |
DELIVERED | Delivered | Delivery confirmed. |
COMPLETED | Completed | Order cycle closed. |
CANCELLED | Cancelled | Valid transition from any state prior to DISPATCHED. |
The state machine is immutable: each transition, made through POST /api/v1/orders/:id/transitions, generates a canonical event with correlationId and causationId.
Core entities
The canonical OMS model, shared with WMS, TMS and ESG.
| Entity | Code | Description |
|---|---|---|
| Order | orders | Canonical transactional entity of the OMS. Accepts multiple source channels (DTC, marketplace, B2B, POS) and propagates the state machine. |
| Return | returns | Complete reverse logistics process. Connects the WMS (re-entry) and the TMS (pickup), with tax and financial auditing. |
| Returnable asset | returnableAssets | Pallets, racks, containers and reusable packaging, tracked by SSCC/GTIN in the ESG and Reverse Chain Economics flow. |
Operational flows
Six flows on the same order model.
Omnichannel
DTC, marketplaces, B2B, POS and social commerce in the same order pipeline.
BOPIS
Buy Online, Pick-up In Store: the store as a pickup point, with a dedicated SLA.
Ship-from-store
Store inventory as a distributed DC, with intelligent allocation routing.
Exception engine
Rules and playbooks to handle stockouts, delays, discrepancies and claims.
Digital twin
Digital replica of the order for what-if simulation before allocation.
Reverse logistics
Returns with a reverse network and returnable assets tracked end to end.
Native Brazilian tax compliance
Documents and taxes issued and calculated automatically as state transitions occur.
| Acronym | Description |
|---|---|
NF-e | Automatic issuance on the DISPATCHED transition, attached to the shipment. |
GNRE | State tax payment form for interstate operations. |
DIFAL | Tax rate differential calculated by the destination state. |
ICMS | Automatic tax calculation, integrated with tax systems. |
REST endpoints
Endpoints versioned under /api/v1/.
| Endpoint | Methods |
|---|---|
/api/v1/orders | GET, POST |
/api/v1/orders/:id/transitions | POST |
/api/v1/returns | GET, POST |
/api/v1/returnable-assets | GET |
Convention: kebab-case endpoints, versioned under /api/v1/, and camelCase collections.
KPIs the OMS delivers
Perfect Order Rate
Order complete, on time, undamaged and with a correct invoice.
Order cycle time
Average time from order created to delivered, with a breakdown by channel and region.
Return rate
Percentage of returns, analyzed by reason, SKU and channel; it affects Reverse Chain Economics.
The OMS as the brain of the supply chain operating system
The order as a canonical entity
In NexLog OS, the Order (orders) is the entity that travels most between modules. It starts in any channel (DTC, marketplace, B2B, POS, social commerce), goes through approval (APPROVED), is allocated in the WMS (PICKING, PACKED), delivered by the TMS (DISPATCHED, IN_TRANSIT, DELIVERED) and completed (COMPLETED).
Each transition generates a canonical event (businessEvents) with correlationId and causationId, which enables end-to-end traceability, auditing, replay and training of predictive models.
Real omnichannel, not fragile integration
BOPIS, ship-from-store, drop-ship and same-day stop being special cases and become allocation policies on the same model. Store inventory, regional DC and 3PL coexist in the same distributed inventory.
Return (returns) and Returnable Asset (returnableAssets) treat reverse logistics as a first-class citizen, essential for returnable packaging and the circular economy.
Digital twin and exception engine
Before allocation, the order's digital twin lets you simulate scenarios: the cost of allocating to a DC or a store, the CO2e impact, the expected delivery window and the stockout risk.
The exception engine applies playbooks to real deviations, such as pending payment, stockout, dock delay and tax discrepancy, and escalates to Control Tower when a person needs to decide. WMS, TMS, Customs, ESG and Finance share the same MDM, with no fragile integration in between.