Módulo Estoque — Movimentações e Saldos

Este guia cobre o coração do estoque: como registrar entradas e saídas, transferir material entre localizações e acompanhar o saldo em tempo real.

Movimentações

Menu Estoque → Movimentações — o histórico completo do que entra e sai do estoque, com filtros por tipo, produto, localização e cliente.

Movimentações: tipo, produto, origem → destino, motivo e quantidade.

Registrar uma movimentação

1. Acesse Estoque → Movimentações e clique em "Nova Movimentação";
2. Tipo — escolha entre os 6 tipos (veja a tabela abaixo);
3. Produto — busque pelo nome; o formulário se adapta: produto com serial pede o item seriado, produto sem serial pede a quantidade;

4. Localizações — conforme o tipo, o formulário exibe origem e/ou destino:

   Tipo	Localização exibida
   Entrada	Destino
   Saída	Origem
   Transferência	Origem e destino (obrigatoriamente diferentes)
   Perda / Dano	Origem
   Ajuste	Origem (reduz) ou destino (aumenta) — pelo menos uma

5. Motivo — ex.: Compra, Uso em OS, Ajuste de inventário;

6. OS vinculada — opcional: liga a movimentação a uma ordem de serviço;
7. Observações — opcionais;
8. Clique em "Registrar".

Detalhamento completo

Todos os campos, as validações por tipo e as regras por controle do produto (serial × quantidade) estão na página Referência — Movimentação de Estoque.

Nova Movimentação: tipo, produto e localizações conforme o tipo escolhido.

Regras por tipo (negócio)

Tipo	Produto sem serial	Produto com serial
Entrada	Soma a quantidade no destino	Item passa a Disponível no destino
Saída	Subtrai da origem (saldo não fica negativo)	Item passa a Em uso
Transferência	Move quantidade entre localizações	Item muda de localização
Ajuste	Corrige saldo na localização indicada	Bloqueado para seriais
Perda	Subtrai da origem	Item vira Perdido
Dano	Subtrai da origem	Item vira Danificado

Trilha imutável

Movimentações de item seriado não podem ser excluídas — o histórico do equipamento é permanente. Excluir (apenas Super Administrador, em movimentações sem serial) também exige cuidado: o saldo é recalculado a partir do histórico.

Acompanhar o histórico

Recurso	O que mostra
Ícone de relógio por linha	Detalhe completo da movimentação: produto, serial, origem → destino, cliente, ordem de serviço e atalho para a trilha do serial
"Histórico por Serial" (botão no topo)	Trilha de vida de um equipamento: onde entrou, por onde passou, se está em comodato com um cliente ou usado em uma OS
Filtro por cliente	Mostra as movimentações de equipamentos emprestados àquele cliente (comodato ativo)

Detalhe da movimentação: tipo, quantidade, origem → destino, cliente e OS vinculada.

"Histórico por Serial": a vida do equipamento — por onde passou e onde está agora.

Saldo por Localização

Menu Estoque → Saldo por Localização — o saldo atual de cada produto em cada almoxarifado (ou veículo).

Saldo por Localização: produto, localização, controle (serial/quantidade) e saldo clicável.

Como ler a tela

Item	O que mostra
Produto e localização	Cada linha é a combinação produto × localização
Controle	Badge indica se o produto é por Serial ou por Quantidade
Saldo	Número em verde (positivo). Clique no saldo para abrir o extrato daquele produto naquela localização (todas as movimentações que formam o saldo + botão de gerar relatório)
Detalhe (seriais)	Para produtos com serial, o detalhamento por status: disponíveis, em uso, manutenção, danificados, perdidos e baixados
Filtros	Por produto, localização e cliente (este último mostra os equipamentos em comodato com o cliente)
Paginação	Visível com contagem ("Mostrando X a Y de Z registros") e seletor de itens por página

Por que o saldo é esse?

Um bloco explicativo no topo da tela resume o cálculo: produtos sem serial somam entradas/transferências/ajustes e subtraem saídas/perdas/danos por localização; produtos com serial contam os itens por status na localização atual. Para quem não é Super Administrador, o saldo considera apenas o escopo atribuído.