Visão geral
O WMS do NexLog OS controla o armazém de ponta a ponta: recebimento (GR), put-away, picking por ondas, packing intelligence, expedição, cross-docking, slotting, quality gate e labor management.
Cada movimento gera um evento canônico no ledger e alimenta control tower, ESG e financeiro em tempo real.
Entidades principais
O modelo canônico do WMS usa nomes em português e code em inglês (a collection no MongoDB), que trafegam em toda a plataforma: WMS, TMS, OMS, Control Tower, ESG e Financeiro.
| Entidade | Code | Descrição |
|---|---|---|
| Armazém | warehouses | CD, filial ou hub. Contém zonas, endereços, equipamentos e equipe. Cada unidade operacional tem seu próprio espaço de movimentos, docas e contagens. |
| Endereço de estoque | storageLocations | Posição física dentro de um armazém, organizada por rua, coluna, nível e vão. Suporta zonas (DRY, REFRIGERATED, FROZEN, FLAMMABLE, HIGH_TURNOVER, QUARANTINE). |
| Movimentação | movements | Evento transacional sobre estoque: INBOUND, OUTBOUND, TRANSFER, ADJUSTMENT ou RETURN. Imutável, emitido ao event ledger com correlationId e causationId. |
| Contagem de estoque | inventoryCounts | Inventário cíclico ou geral. Produz divergências auditáveis, gera movements do tipo ADJUSTMENT e alimenta o score de acurácia por zona. |
Fluxos operacionais
Os oito fluxos que levam a mercadoria do portão à expedição.
Recebimento (GR)
Agendamento, descarga, conferência cega, etiquetagem SSCC e divergências auditáveis.
Put-away inteligente
Regras de slotting por giro (HIGH_TURNOVER), peso, temperatura e compatibilidade química.
Pick-path e wave picking
Ondas otimizadas por rota, cluster ou batch; voice picking e pick-by-light opcionais.
Cross-docking
Redirecionamento de SKU recebido para a doca de saída sem endereçar estoque.
Packing intelligence
Cubagem, balanceamento e seleção de embalagem (AI-Pack), com impacto direto em CO2e.
Quality gate
Inspeção por lote, quarentena automática na zona QUARANTINE e bloqueio de expedição.
Labor management
Operadores com metas, produtividade por tarefa e OEE acumulado por zona e turno.
Slotting dinâmico
Reposicionamento contínuo dos SKUs de maior giro nas posições mais acessíveis.
Tipos de movimentação
Valores do enum movements.
| Code | Nome | Descrição | Origem típica |
|---|---|---|---|
INBOUND | Entrada | Recebimento de fornecedor ou transferência entre CDs. | NF-e + GR |
OUTBOUND | Saída | Expedição para cliente, filial ou retorno ao fornecedor. | Pedido OMS |
TRANSFER | Transferência | Movimento entre endereços dentro do mesmo armazém. | Slotting ou put-away |
ADJUSTMENT | Ajuste | Correção contábil após contagem ou perda reconhecida. | inventoryCounts |
RETURN | Devolução | Retorno de cliente (B2C ou B2B) com reentrada auditada. | returns OMS |
Zonas de estoque
Valores do enum storageLocations.zone.
| Code | Zona | Descrição |
|---|---|---|
DRY | Seco | Temperatura ambiente, uso geral. |
REFRIGERATED | Refrigerado | Geralmente 2–8 °C; cadeia fria leve. |
FROZEN | Congelado | Abaixo de −18 °C; cadeia fria profunda. |
FLAMMABLE | Inflamável | Produtos perigosos; segregação obrigatória. |
HIGH_TURNOVER | Alto giro | Área premium perto da expedição. |
QUARANTINE | Quarentena | Bloqueio de uso até liberação de qualidade. |
Endpoints REST
Endpoints versionados em /api/v1/.
| Endpoint | Métodos |
|---|---|
/api/v1/warehouses | GET, POST |
/api/v1/locations | GET, POST |
/api/v1/movements | GET, POST |
/api/v1/inventory-counts | GET, POST |
Convenção: endpoints em kebab-case, versionados em /api/v1/, e collections em camelCase.
KPIs que o WMS entrega
Acurácia de estoque
Percentual de posições conferidas sem divergência.
OTIF (On Time In Full)
Percentual de pedidos expedidos completos e no prazo combinado.
Produtividade por operador
Peças por hora, tarefas por turno e OEE acumulado, com breakdown por zona e tipo de movimento.
O WMS como espinha dorsal do supply chain OS
Um WMS é mais que um inventário
Por muito tempo, o WMS foi encarado como um sistema de registro: quanto tem, onde está, quando saiu. Essa visão explica pouco do que um armazém moderno precisa.
O WMS do NexLog OS trata cada ponto do fluxo (recebimento, put-away, picking, packing, expedição, cross-docking, slotting, contagem, quality gate e labor) como evento canônico emitido ao event ledger (businessEvents). Todo movimento físico em Armazém (warehouses) e Endereço de estoque (storageLocations) gera uma Movimentação (movements) com correlationId e causationId, o que habilita auditoria, replay e analytics sem ETL.
Zonas, regras e compliance
As zonas (DRY, REFRIGERATED, FROZEN, FLAMMABLE, HIGH_TURNOVER, QUARANTINE) deixam de ser rótulos e viram invariantes de negócio. O motor de put-away respeita compatibilidade química, temperatura e giro: produtos inflamáveis nunca são endereçados em FROZEN, itens em QUARANTINE ficam bloqueados para expedição e a estratégia de HIGH_TURNOVER se reorganiza continuamente com base na frequência de picking.
Essa camada de regras reduz retrabalho e risco operacional e, ao mesmo tempo, documenta decisões de compliance para auditorias externas.
Do WMS para o supply chain OS
Como o WMS compartilha o mesmo MDM com TMS (shipments), OMS (orders), YMS (dockSchedules) e Customs (tradeDeclarations), a visão muda. Um pedido omnichannel recebido pelo OMS aciona a alocação no WMS, que gera uma onda de picking e packing e libera o carregamento numa doca agendada pelo YMS. O embarque sai com CT-e emitido pelo TMS e, no caso de exportação, com a declaração aduaneira plugada em Customs.
Cada passo emite um evento canônico, e o Control Tower vê tudo isso em tempo real. É o que diferencia um WMS dentro de um supply chain operating system de um WMS standalone.