Movimentações

Registro manual de entradas, saídas, transferências e ajustes de estoque entre endereços WMS.

Objetivo

Movimentar quantidade de um produto entre endereços (ou do “vazio” para entrada), com tipo de movimentação e rastreio por lote quando a regra de lote está ativa.

Pré-requisitos

Armazéns e Endereços cadastrados
Produtos no catálogo
Tipos de movimentação no backend (ex.: entrada, saída, transferência)
Geração de lote no reporte ativa em Preferências de produção (ambiente atual) — lotes criados no Cockpit aparecem na busca do modal

Como usar

Acesse Logística > Operação > Movimentações (acessar diretamente).
Use os filtros (armazém, produto, período, etc.) e Atualizar para consultar o histórico.
Clique em Nova movimentação para registrar uma movimentação manual permitida pelo tipo.
Preencha produto, tipo, origem/destino, quantidade e salve.
Movimentações elegíveis exibem Desfazer na lista (estorno vinculado ao tipo).

Histórico de movimentações

Campos do modal Nova movimentação

Modal de movimentação

Campo	Obrigatório	Descrição
Produto	Sim *	Produtos. Combobox com busca.
Lote	Condicional	Com Geração de lote ativa: combobox busca `GET /wms/lots/` por código (inclui lotes gerados no reporte). Criar abre cadastro manual. Ao selecionar lote+endereço com saldo, origem e quantidade máxima podem ser preenchidos automaticamente.
Tipo de movimentação	Sim *	Define se é entrada, saída, transferência, ajuste, etc. (catálogo `movement-types`).
Armazém / endereço origem	Condicional	Obrigatório em saída/transferência; vazio em entrada pura. Endereços do armazém selecionado.
Armazém / endereço destino	Condicional	Obrigatório em entrada/transferência.
Quantidade	Sim *	Decimal; formato BR na interface.
Data/hora	Não	Quando o tipo permite informar ocorrência.
Referência / observação	Não	Texto livre para auditoria.

Tipos manuais (allow_manual) aparecem no modal; movimentações automáticas vêm do Cockpit (reporte) ou integrações.

Filtros da lista

Filtro	Cadastro relacionado
Armazém / endereço	Armazéns, Endereços
Produto	Produtos
Tipo	Tipos de movimentação (sistema)
Período	Data da movimentação

Dados e integrações

GET/POST — /wms/movements/
POST — estorno (undo) quando can_undo
GET — /wms/warehouses/, /wms/locations/, /products/, /wms/lots/

Perguntas frequentes

Por que não consigo criar movimentação manual?
O tipo selecionado pode não permitir lançamento manual — escolha outro tipo ou use reporte no Cockpit.

O que é Desfazer?
Cria movimento de estorno ligado ao original, quando o tipo de movimento tem id_mov_undo configurado.

Lote não encontrado?
Confira se houve reporte com Lança estoque (lote automático) ou crie com Criar. Código segue o template em Preferências de produção.

Diferença do lote do Cockpit?
Reporte gera lote pelo template; movimentação manual associa lote existente ou cria um novo avulso.

Saldo não bate com estoque?
Confira Estoque (saldos agregados) vs. movimentos pontuais; pode haver delay ou filtros diferentes.

Erros comuns

Saldo insuficiente: quantidade maior que disponível na origem.
Endereço inativo: reative em Endereços.
Produto sem unidade coerente: cadastro em Produtos.

Relacionado

Estoque — consulta de saldos
Endereços — posições
Cockpit — movimentação por reporte
Preferências de produção — lote