CloudMES Docs

Movimentações

Registro e auditoria de todas as movimentações de estoque: entradas, saídas, transferências e estornos.

Rota

/dashboard/wms/movimentacoes

Objetivo

Controlar o fluxo de materiais entre endereços e armazéns. Cada movimentação gera ou consome saldo e pode ser associada a um lote.

Pré-requisitos

• Produtos, armazéns e endereços cadastrados
• Tipos de movimentação definidos (entrada, saída, transferência, etc.)

Como usar

1. Acesse /dashboard/wms/movimentacoes.
2. Clique em + para registrar uma nova movimentação.
3. Preencha:
   • Tipo de movimentação
   • Produto e quantidade
   • Origem e/ou Destino conforme o tipo (ex.: transferência exige ambos)
   • Lote (quando aplicável)
4. Salve.
5. Para estornar uma movimentação, clique no ícone de Desfazer na linha (quando permitido).
6. Use filtros de período, tipo e produto para auditar o histórico.

Dados e integrações

• GET/POST /wms/movements/
• POST /wms/movements/{id}/undo/: estorno
• GET /wms/movement-types/: tipos disponíveis
• GET /wms/lots/: referência de lotes
• Catálogos de armazém, produto e endereço

Erros comuns

• Tipo incompatível com campos: tipos de saída não exigem destino; tipos de transferência exigem origem e destino.
• Lote inválido: o lote deve existir e pertencer ao produto selecionado.
• Estorno bloqueado: algumas movimentações não permitem estorno por regra de negócio (ex.: já compensadas).
• Saldo insuficiente em saída: o endereço de origem não possui saldo suficiente.

Print

Ainda não há screenshot versionado. Salve em public/images/cloudmes/telas/movimentacoes.png e substitua este bloco pela imagem.