Vendas e PDV

Controle de estoque automático nas vendas

Como o PetShop Flow decrementa estoque, registra movimentação e bloqueia venda sem produto.

Atualizado em 17 de maio de 20262 min de leitura

Toda venda de produto mexe o estoque automaticamente. O PetShop Flow não deixa você vender mais do que tem, e cria uma trilha de movimentações pra auditoria.

Cadastrando um produto pra vender

  1. Vá em /produtos e clique em Novo produto.
  2. Nome: obrigatório.
  3. Categoria (opcional): ração, brinquedo, higiene…
  4. SKU e código de barras (opcional).
  5. Preço de venda: em reais. O PetShop Flow guarda em centavos internamente.
  6. Custo (opcional): pra cálculo de margem nos relatórios.
  7. Estoque atual (stockQty): unidade inteira.
  8. Estoque mínimo (stockMin): pra alerta de reposição.
  9. Fornecedor, lote, validade: opcionais.
  10. Ativo: se desativado, não aparece no PDV.
  11. Elegível a fidelidade (loyaltyEligible): se sim, conta pra campanhas.

[SCREENSHOT: Cadastro de produto]

O que acontece a cada venda

Pra cada item de tipo product na venda, o PetShop Flow:

  1. Valida estoque: se stockQty < quantidade, falha com Estoque insuficiente para "<nome>" (<n> disponível).
  2. Decrementa o stockQty.
  3. Registra movimentação em stock_movements com tipo venda, quantidade e nota tipo Venda <id>.

Tipos de movimentação

  • entrada: você recebeu mercadoria do fornecedor.
  • saida: ajuste manual de saída (perda, doação etc.).
  • ajuste: correção genérica de estoque.
  • venda: gerada automaticamente pelo PDV.

Pra ajustar manualmente, vá no produto e use Movimentar estoque — informe quantidade, tipo e nota.

Alertas de estoque mínimo

Quando o estoque chega no stockMin ou abaixo, o produto vira "estoque crítico" nos relatórios. Use isso pra disparar pedido de reposição.

[SCREENSHOT: Lista de produtos com alerta vermelho de estoque mínimo]

Permissões

Quem pode cadastrar/editar produto:

  • Administrador
  • Gestor

Quem pode vender (e portanto mexer estoque indiretamente):

  • Administrador, gestor, atendente, recepção.

Perguntas frequentes

Posso ter produto com estoque negativo?

Não. O sistema bloqueia a venda antes que isso aconteça. Pra registrar saída por outro motivo (perda), use Movimentar estoque com tipo saida.

Vendi e quero estornar — o estoque volta?

Hoje não automaticamente. Use Movimentar estoque com tipo entrada e a quantidade do estorno, anotando o motivo.

Posso vender lote/validade?

Lote e validade são campos do produto, não da movimentação. Pra controle por lote, cadastre o mesmo produto em SKUs separados por lote.

Artigos relacionados