Começar de graça

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#

  1. Acesse Estoque no menu
  2. Na lista, encontre o produto (busque por nome, SKU ou código de barras)
  3. 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)#

  1. No produto, abra a seção Estoque e clique em Adicionar Estoque
  2. Se houver mais de um local ativo, selecione o Local
  3. Preencha:
    • Quantidade a Adicionar: 50
    • Motivo: Compra fornecedor ABC - NF 12345
  4. Clique em Adicionar Estoque

Resultado: Estoque anterior: 0 → Estoque atual: 50

Remover Estoque (Venda ou Perda)#

  1. No produto, abra a seção Estoque e clique em Remover Estoque
  2. Se houver mais de um local ativo, selecione o Local
  3. Preencha:
    • Quantidade a Remover: 5
    • Motivo: Venda - Pedido #123
  4. 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:

  1. No produto, abra a seção Estoque e clique em Definir Estoque
  2. Se houver mais de um local ativo, selecione o Local
  3. Preencha:
    • Nova Quantidade de Estoque: 43
    • Motivo: Inventário físico - ajuste de divergência
  4. 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:

  1. Selecione o Local
  2. Informe o Motivo do ajuste (compartilhado por todos os itens)
  3. Em Adicionar Produtos, busque e toque nos produtos desejados — cada um entra na lista Produtos selecionados
  4. Para cada produto, informe a Nova qtd (a coluna Anterior mostra a quantidade atual)
  5. 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#

  1. No produto, abra a seção Estoque e toque em Movimentações
  2. 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#

  1. Na seção Estoque do produto, clique em Adicionar Estoque
  2. Quantidade a Adicionar: (quantidade devolvida)
  3. Motivo: "Devolução cliente - Pedido #XXX"

Perda ou Avaria#

  1. Na seção Estoque do produto, clique em Remover Estoque
  2. Quantidade a Remover: (quantidade perdida)
  3. 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#

  1. No módulo Estoque, abra Localizações
  2. Clique em Novo Local
  3. 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)
  4. Clique em Criar Local

Transferir Estoque entre Locais#

  1. No módulo Estoque, abra Transferências
  2. Selecione o Local de origem e o Local de destino (é preciso ter ao menos dois locais ativos)
  3. Escolha o Produto e informe a Quantidade (o campo mostra o estoque disponível)
  4. Informe o Motivo da transferência (opcional)
  5. 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#

  1. No módulo Estoque, abra Lotes
  2. Clique em Novo Lote
  3. 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)
  4. 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#

  1. Sempre documente: Use o campo "Motivo" para rastrear movimentações
  2. Inventários regulares: Faça contagens físicas periódicas (mensal recomendado)
  3. Permissões controladas: Limite quem pode adicionar/remover estoque
  4. Audite o histórico: Revise movimentações para identificar perdas ou desvios
  5. Organize por locais: Use locais para separar estoque de diferentes pontos físicos
  6. Controle validades: Cadastre lotes para produtos perecíveis e monitore vencimentos