O PDV é a tela principal de quem vende. Desenhado pra ser usado de teclado (busca rápida, tab entre campos) — sem mouse você fecha uma venda em ~10 segundos.

Antes de começar

Você precisa de caixa aberto. Se não tem, o PDV mostra aviso “Abra o caixa antes de registrar vendas” com atalho pra tela de caixa.

Buscar e adicionar produto

• Digite nome, SKU ou escaneie código de barras no campo de busca.
• Enter adiciona o primeiro produto da lista ao carrinho com quantidade 1.
• Se quiser qtd > 1, aumente no carrinho (botão + ou digite direto).
• Se quiser quantidade grande pro atacado, digite a quantidade no campo e Enter.

Preço aplicado

O sistema escolhe automaticamente o menor preço válido entre:

1. Preço varejo (cadastro da loja).
2. Promoção ativa (se houver).
3. Faixa de atacado (10+, 50+, 100+ — conforme cadastro).
4. Tabela de preço do cliente (se o cliente tiver uma).

Exceção: quando a tabela do cliente tem um preço específico pro produto, esse valor é estrito (vence tudo, mesmo promo mais barata). É o preço de contrato negociado.

Cliente

• Sem cliente → venda anônima (consumidor final).
• Com cliente → pode ser vinculado antes ou depois do pagamento. Serve pra:
  • Emitir NFC-e com destinatário.
  • Usar a tabela de preço negociada dele.
  • Registrar fiado (vira conta a receber no nome do cliente).
  • Aparecer no histórico de compras e curva ABC.

Formas de pagamento

Na tela de pagamento:

• Dinheiro — mostra troco se pagou mais que o total.
• Cartão crédito / débito — só registra (não integra com maquininha ainda).
• PIX — registra como recebido (integração com Asaas prevista).
• Fiado — gera uma conta a receber. Exige cliente identificado.

Você pode dividir em N métodos clicando em ”+ Dividir pagamento”. Ex.: R$ 150 em dinheiro + R$ 200 em cartão.

Após a venda

O dialog pós-venda mostra a venda criada e permite:

• Emitir NFC-e (requer certificado A1 configurado e loja registrada).
• Emitir NF-e modelo 55 (requer cliente PJ com CNPJ + IE + endereço completo).
• Cancelar (devolve estoque, reverte receivables, zera comissão).

Modo offline

Se a internet cair durante a venda, o PDV salva na fila local (IndexedDB) e mostra “Sem conexão — venda salva localmente”. Assim que reconectar, a fila sincroniza automaticamente.

Limite: enquanto offline, você não consegue emitir NFC-e (exige SEFAZ online). A venda fica registrada; a nota sai depois de reconectar.