Este guia mostra como gerenciar o estoque dos seus produtos, incluindo entradas de mercadoria, saídas e inventário físico.

Passo 1: Verificar Estoque Atual

  1. Acesse Estoque no menu
  2. Na lista, encontre o produto
  3. Veja a Quantidade Atual (será 0 se for produto novo)

Ou acesse a aba Estoque diretamente na página do produto.

Passo 2: Adicionar Estoque (Entrada de Mercadoria)

  1. No produto, clique em Adicionar Estoque
  2. Preencha:
    • Quantidade: 50
    • Motivo: Compra fornecedor ABC - NF 12345
  3. Clique em Confirmar

Resultado: Estoque anterior: 0 → Estoque atual: 50

Passo 3: Remover Estoque (Venda ou Perda)

  1. No produto, clique em Remover Estoque
  2. Preencha:
    • Quantidade: 5
    • Motivo: Venda - Pedido #123
  3. Clique em Confirmar

Resultado: Estoque anterior: 50 → Estoque atual: 45

Passo 4: Ajustar Estoque (Inventário Físico)

Quando a contagem física diverge do sistema:

  1. No produto, clique em Ajustar Estoque
  2. Preencha:
    • Quantidade Exata: 43
    • Motivo: Inventário físico - ajuste de divergência
  3. Clique em Confirmar

Resultado: Estoque anterior: 45 → Estoque atual: 43

Passo 5: Consultar Histórico

  1. No produto, clique em Histórico de Estoque
  2. Veja todas as movimentações:
DataTipoQtdAnteriorAtualUsuárioMotivo
03/02 10:00Add+50050JoãoCompra fornecedor ABC
03/02 14:30Remove-55045MariaVenda - Pedido #123
03/02 18:00Set434543JoãoInventário físico

Tipos de Movimentação

TipoQuando usarExemplo
AdicionarEntra mercadoriaCompra, devolução de cliente
RemoverSai mercadoriaVenda, perda, avaria
AjustarCorrigir quantidadeInventário físico, correção

Validações de Segurança

O sistema impede:

  • Remover mais do que tem em estoque (estoque não pode ficar negativo)
  • Adicionar quantidade zero ou negativa
  • Ajustar para quantidade negativa
  • Acessar estoque de outro tenant

Casos de Uso Comuns

Devolução de Cliente

  1. Clique em Adicionar Estoque
  2. Quantidade: (quantidade devolvida)
  3. Motivo: "Devolução cliente - Pedido #XXX"

Perda ou Avaria

  1. Clique em Remover Estoque
  2. Quantidade: (quantidade perdida)
  3. Motivo: "Avaria - produto danificado"

Transferência entre Lojas

  1. Loja A: Remova estoque (motivo: "Transferência para Loja B")
  2. Loja B: Adicione estoque (motivo: "Transferência da Loja A")

Transferência automática entre lojas está planejada para versões futuras.

Permissões

PermissãoDescrição
inventory:viewConsultar estoque
inventory:addAdicionar estoque
inventory:removeRemover estoque
inventory:adjustAjustar estoque
inventory:historyVer histórico de movimentações

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