Saldos de Estoque
Módulo: Estoque Caminho na aplicação: Menu > Estoque > Saldos (/estoque/saldos) Última atualização: 20/04/2026
Para que serve
Exibe a posição atual de estoque de cada produto por depósito (e, quando aplicável, por lote). Mostra quantidade física, quantidade reservada, quantidade disponível, custo médio e valor total do estoque. Funciona como painel de consulta em tempo real — não permite edição direta de saldos.
Quem pode usar
Todos os usuários com acesso ao módulo Estoque.
Como usar (passo a passo)
- Acesse Menu > Estoque > Saldos.
- A lista carrega automaticamente exibindo apenas itens com saldo (opção "Somente com saldo" ligada por padrão).
- Use os filtros disponíveis para refinar a consulta:
- Busca por produto — pesquisa por nome, SKU ou código.
- Depósito — restringe a um depósito específico.
- Somente com saldo — quando desativado, exibe também produtos com saldo zero.
- Role a página para baixo para carregar mais registros (carregamento infinito em lotes de 50).
- Clique em Limpar para redefinir todos os filtros.
Campos da tela
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Busca | Não | Nome, SKU ou código do produto | Filtragem instantânea ao digitar |
| Depósito | Não | Selecionar da lista | Exibe código e descrição do depósito |
| Somente com saldo | Não | Ligado/desligado | Padrão: ligado |
Colunas da tabela
| Coluna | Descrição |
|---|---|
| Produto | Nome e SKU do produto |
| Depósito | Código, descrição e filial do depósito; indica "(principal)" quando aplicável |
| Lote | Número do lote e data de validade com indicador de situação (quando o produto controla lote) |
| Qtd. física | Quantidade total em estoque (4 casas decimais) |
| Reservada | Quantidade comprometida por pedidos; exibida em laranja quando > 0 |
| Disponível | Qtd. física − Reservada; verde (positivo), cinza (zero), vermelho (negativo) |
| Unidade | Unidade padrão do produto (saldo é sempre expresso nesta unidade; as movimentações em unidades transacionais são convertidas via fator_estoque_snapshot) |
| Custo médio | Custo médio unitário em R$ |
| Valor total | Qtd. física × Custo médio em R$ |
Validações e regras
- O saldo é calculado pela soma das movimentações registradas — nunca editado diretamente nesta tela.
- Quantidade disponível negativa indica reservas superiores ao estoque físico (situação de alerta).
- Lotes são exibidos com indicador de validade: OK (verde), Atenção (azul), Crítico (laranja/amarelo) ou Vencido (vermelho)
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Erro ao carregar saldos" | Falha de comunicação com a API | Aguarde e clique em Limpar para recarregar |
Integrações e dependências
- Depende do cadastro de Depósitos para o filtro de depósito.
- Depende do cadastro de Lotes para exibir informações de validade.
- Saldos são atualizados por Movimentações de Estoque (entradas, saídas, ajustes).
Dúvidas frequentes
A tela não mostra um produto que eu sei que existe. Verifique se o filtro "Somente com saldo" está ligado — desative-o para ver produtos com saldo zero.
O disponível está negativo. O que fazer? Indica que há mais reservas registradas do que estoque físico. Verifique as movimentações e, se necessário, registre um ajuste manual em Movimentações.
Como alterar um saldo? Saldos não são editados diretamente. Use o ajuste manual em Movimentações de Estoque.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |