Visão geral
O OMS do NexLog OS unifica pedido omnichannel, inventário distribuído, BOPIS, ship-from-store, exception engine, digital twin e simulação what-if.
A máquina de estados do pedido é canônica, tem NF-e, GNRE, DIFAL e ICMS nativos e se integra a WMS, TMS e Control Tower pelo mesmo MDM.
Máquina de estados do pedido
Nove estados canônicos do Pedido (orders), incluindo CANCELLED, com cada transição emitida ao ledger businessEvents.
| Code | Estado | Contexto |
|---|---|---|
DRAFT | Rascunho | Pedido criado em qualquer canal: DTC, marketplace, B2B, POS ou social commerce. |
APPROVED | Aprovado | Aprovação no OMS, antes da alocação. |
PICKING | Em picking | Alocado e em separação no WMS. |
PACKED | Embalado | Embalagem concluída no WMS. |
DISPATCHED | Expedido | Saída pelo TMS; a NF-e é emitida nesta transição. |
IN_TRANSIT | Em trânsito | Em rota, acompanhado pelo TMS. |
DELIVERED | Entregue | Entrega confirmada. |
COMPLETED | Concluído | Ciclo do pedido encerrado. |
CANCELLED | Cancelado | Transição válida a partir de qualquer estado anterior a DISPATCHED. |
A máquina de estados é imutável: cada transição, feita por POST /api/v1/orders/:id/transitions, gera um evento canônico com correlationId e causationId.
Entidades principais
O modelo canônico do OMS, compartilhado com WMS, TMS e ESG.
| Entidade | Code | Descrição |
|---|---|---|
| Pedido | orders | Entidade transacional canônica do OMS. Aceita múltiplos canais de origem (DTC, marketplace, B2B, POS) e propaga a máquina de estados. |
| Devolução | returns | Processo completo de logística reversa. Conecta o WMS (reentrada) e o TMS (coleta), com auditoria fiscal e financeira. |
| Ativo retornável | returnableAssets | Pallets, racks, containers e embalagens reutilizáveis, rastreados por SSCC/GTIN no fluxo de ESG e Reverse Chain Economics. |
Fluxos operacionais
Seis fluxos sobre o mesmo modelo de pedido.
Omnichannel
DTC, marketplaces, B2B, POS e social commerce no mesmo pipeline de pedido.
BOPIS
Buy Online, Pick-up In Store: a loja como ponto de retirada, com SLA dedicado.
Ship-from-store
Estoque de loja como CD distribuído, com roteamento inteligente de alocação.
Exception engine
Regras e playbooks para tratar rupturas, atrasos, divergências e sinistros.
Digital twin
Réplica digital do pedido para simulação what-if antes de alocar.
Logística reversa
Devoluções com malha reversa e ativos retornáveis rastreados de ponta a ponta.
Fiscal brasileiro nativo
Documentos e tributos emitidos e apurados automaticamente conforme as transições de estado.
| Sigla | Descrição |
|---|---|
NF-e | Emissão automática na transição DISPATCHED, anexada ao shipment. |
GNRE | Guia de recolhimento estadual para operações interestaduais. |
DIFAL | Diferencial de alíquota calculado pela UF de destino. |
ICMS | Apuração fiscal automática, com integração a sistemas tributários. |
Endpoints REST
Endpoints versionados em /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 |
Convenção: endpoints em kebab-case, versionados em /api/v1/, e collections em camelCase.
KPIs que o OMS entrega
Perfect Order Rate
Pedido completo, no prazo, sem danos e com nota fiscal correta.
Order cycle time
Tempo médio do pedido criado até entregue, com breakdown por canal e região.
Return rate
Percentual de devoluções, analisado por motivo, SKU e canal; impacta o Reverse Chain Economics.
O OMS como cérebro do supply chain operating system
O pedido como entidade canônica
No NexLog OS, o Pedido (orders) é a entidade que mais viaja entre módulos. Nasce em qualquer canal (DTC, marketplace, B2B, POS, social commerce), passa por aprovação (APPROVED), é alocado no WMS (PICKING, PACKED), entregue pelo TMS (DISPATCHED, IN_TRANSIT, DELIVERED) e concluído (COMPLETED).
Cada transição gera um evento canônico (businessEvents) com correlationId e causationId, o que permite rastreabilidade de ponta a ponta, auditoria, replay e treinamento de modelos preditivos.
Omnichannel real, não integração frágil
BOPIS, ship-from-store, drop-ship e same-day deixam de ser casos especiais e viram políticas de alocação sobre o mesmo modelo. Estoque de loja, CD regional e 3PL convivem no mesmo inventário distribuído.
Devolução (returns) e Ativo Retornável (returnableAssets) tratam a logística reversa como cidadã de primeira classe, indispensável para embalagens retornáveis e economia circular.
Digital twin e exception engine
Antes de alocar, o digital twin do pedido permite simular cenários: custo de alocar num CD ou numa loja, impacto em CO2e, janela de entrega esperada e risco de ruptura.
O exception engine aplica playbooks a desvios reais, como pagamento pendente, ruptura, atraso de doca e divergência fiscal, e escala para o Control Tower quando uma pessoa precisa decidir. WMS, TMS, Customs, ESG e Financeiro compartilham o mesmo MDM, sem integração frágil no meio.