Controlando o Estoque
Este guia mostra como gerenciar o estoque dos seus produtos, incluindo movimentações, locais de armazenamento, lotes com validade e inventário físico.
Movimentações de Estoque
Verificar Estoque Atual#
- Acesse Estoque no menu
- Na lista, encontre o produto (busque por nome, SKU ou código de barras)
- Cada item mostra o status (Normal, Baixo ou Zerado) e a Quantidade
Para ver o estoque de um produto específico, toque nele para abrir a página do produto e acesse a seção Estoque, onde você vê o Estoque Atual, o Estoque Mínimo (quando definido) e o Estoque por Local.
As movimentações de entrada, saída e ajuste são feitas a partir da seção Estoque da página do produto.
Adicionar Estoque (Entrada de Mercadoria)#
- No produto, abra a seção Estoque e clique em Adicionar Estoque
- Se houver mais de um local ativo, selecione o Local
- Preencha:
- Quantidade a Adicionar: 50
- Motivo: Compra fornecedor ABC - NF 12345
- Clique em Adicionar Estoque
Resultado: Estoque anterior: 0 → Estoque atual: 50
Remover Estoque (Venda ou Perda)#
- No produto, abra a seção Estoque e clique em Remover Estoque
- Se houver mais de um local ativo, selecione o Local
- Preencha:
- Quantidade a Remover: 5
- Motivo: Venda - Pedido #123
- Clique em Remover Estoque
Resultado: Estoque anterior: 50 → Estoque atual: 45
Definir Estoque (Inventário Físico)#
Quando a contagem física diverge do sistema:
- No produto, abra a seção Estoque e clique em Definir Estoque
- Se houver mais de um local ativo, selecione o Local
- Preencha:
- Nova Quantidade de Estoque: 43
- Motivo: Inventário físico - ajuste de divergência
- Clique em Definir Estoque
Resultado: Estoque anterior: 45 → Estoque atual: 43
Atenção: o Motivo é obrigatório em todas as movimentações. É necessário ter ao menos um local de estoque ativo antes de movimentar — caso contrário, cadastre um local primeiro (veja Locais de Estoque).
Ajuste em Lote#
Para corrigir o estoque de vários produtos de uma só vez, use a página Ajuste em Lote:
- Selecione o Local
- Informe o Motivo do ajuste (compartilhado por todos os itens)
- Em Adicionar Produtos, busque e toque nos produtos desejados — cada um entra na lista Produtos selecionados
- Para cada produto, informe a Nova qtd (a coluna Anterior mostra a quantidade atual)
- Clique em Confirmar Ajuste
O sistema processa todos os itens de uma vez, registrando uma movimentação para cada produto ajustado, e exibe um resumo com a transição de quantidade de cada produto.
Consultar Histórico#
- No produto, abra a seção Estoque e toque em Movimentações
- Veja todas as movimentações, com filtros por Tipo e Local e busca por texto:
| Data | Tipo | Variação | Estoque resultante | Motivo |
|---|---|---|---|---|
| 03/02/2026 10:00 | Adição | +50 | 50 | Compra fornecedor ABC |
| 03/02/2026 14:30 | Remoção | -5 | 45 | Venda - Pedido #123 |
| 03/02/2026 18:00 | Ajuste | 43 | 43 | Inventário físico |
Toque em uma movimentação para ver os detalhes (tipo, quantidade movimentada, estoque anterior e resultante, motivo e data).
Tipos de Movimentação#
| Tipo | Quando ocorre |
|---|---|
| Adição | Entrada de mercadoria (compra, devolução de cliente) |
| Remoção | Saída de mercadoria (venda, perda, avaria) |
| Ajuste | Correção de quantidade (inventário físico, contagem) |
| Transferência | Movimentação entre locais |
| Reversão | Estorno automático de uma movimentação |
Validações de Segurança#
O sistema impede:
- Remover mais do que tem em estoque (a quantidade a remover não pode exceder o estoque atual)
- Adicionar ou remover quantidade zero ou negativa
- Definir uma quantidade negativa
- Informar quantidades fracionárias para unidades que só aceitam números inteiros
- Acessar estoque de outra empresa (isolamento por empresa)
Casos de Uso Comuns#
Devolução de Cliente#
- Na seção Estoque do produto, clique em Adicionar Estoque
- Quantidade a Adicionar: (quantidade devolvida)
- Motivo: "Devolução cliente - Pedido #XXX"
Perda ou Avaria#
- Na seção Estoque do produto, clique em Remover Estoque
- Quantidade a Remover: (quantidade perdida)
- Motivo: "Avaria - produto danificado"
Locais de Estoque
Os locais de estoque permitem organizar seu inventário em diferentes pontos físicos, como lojas, depósitos ou prateleiras.
Criar um Local#
- No módulo Estoque, abra Localizações
- Clique em Novo Local
- Preencha:
- Tipo de Local: Loja, Depósito ou Trânsito
- Nome do Local: nome do local (ex: "Depósito Principal", "Loja Shopping")
- Endereço: CEP, rua, número, complemento, bairro, estado e cidade (opcional)
- Clique em Criar Local
Transferir Estoque entre Locais#
- No módulo Estoque, abra Transferências
- Selecione o Local de origem e o Local de destino (é preciso ter ao menos dois locais ativos)
- Escolha o Produto e informe a Quantidade (o campo mostra o estoque disponível)
- Informe o Motivo da transferência (opcional)
- Clique em Transferir Estoque
O sistema automaticamente remove do local de origem e adiciona no local de destino, registrando a movimentação em ambos.
Gerenciar Locais#
Na lista de locais, cada item mostra o tipo, o status (Ativo/Inativo) e a quantidade de lotes associados. Toque em um local para ver os detalhes:
- Informações do local: nome, tipo e status
- Endereço cadastrado (quando informado)
- Lotes associados ao local (atalho para a lista de lotes)
- Editar Local: alterar nome, tipo e endereço
Dica: Crie locais que reflitam sua estrutura física real e use nomes padronizados para facilitar a identificação.
Lotes e Validades
O controle de lotes permite rastrear produtos por lote de fabricação, com data de validade, facilitando a gestão de perecíveis e o cumprimento de normas sanitárias.
Criar um Lote#
- No módulo Estoque, abra Lotes
- Clique em Novo Lote
- Preencha:
- Número do Lote: identificador do lote (ex: "LOT-2026-001")
- Quantidade: quantidade de itens no lote
- Produto: selecione o produto do catálogo
- Local: selecione o local de estoque do lote
- Data de Fabricação: quando o lote foi produzido (opcional)
- Data de Validade: quando o lote expira (obrigatória; sugerida em 90 dias por padrão)
- Clique em Criar Lote
Gerenciar Lotes#
Na lista de lotes, cada item exibe o status (Ativo, Vencido ou Quarentena) e, para lotes ativos próximos do vencimento, um indicador de validade. Toque em um lote para ver os detalhes: número, produto, local, quantidade, datas de fabricação e validade.
Na página de detalhes você pode alterar o status do lote:
- Colocar em Quarentena: isola um lote Ativo (por exemplo, quando há suspeita de problema)
- Reativar Lote: devolve um lote em Quarentena para o status Ativo
Alertas de Vencimento#
Para lotes Ativos, o sistema sinaliza a proximidade do vencimento diretamente na lista e na página de detalhes:
- Lotes que vencem nos próximos 30 dias recebem um indicador de validade
- Lotes que vencem nos próximos 7 dias (ou já vencidos) são destacados como críticos
Dica: Priorize a venda de lotes com validade mais próxima (método FEFO - First Expired, First Out) para evitar perdas.
Permissões#
| Permissão | Descrição |
|---|---|
inventory:stock:read |
Consultar estoque por produto |
inventory:stock:add |
Registrar entradas de estoque |
inventory:stock:remove |
Registrar saídas de estoque |
inventory:stock:set |
Definir quantidade (inventário físico) |
inventory:stock:transfer |
Transferir estoque entre locais |
inventory:movement:history |
Ver histórico de movimentações |
inventory:movement:reverse |
Reverter movimentações |
inventory:location:create |
Criar locais |
inventory:location:update |
Editar locais |
inventory:batch:create |
Criar e gerenciar lotes |
inventory:batch:update |
Atualizar lotes |
inventory:report:read |
Consultar relatórios de estoque |
Boas Práticas#
- Sempre documente: Use o campo "Motivo" para rastrear movimentações
- Inventários regulares: Faça contagens físicas periódicas (mensal recomendado)
- Permissões controladas: Limite quem pode adicionar/remover estoque
- Audite o histórico: Revise movimentações para identificar perdas ou desvios
- Organize por locais: Use locais para separar estoque de diferentes pontos físicos
- Controle validades: Cadastre lotes para produtos perecíveis e monitore vencimentos