Venda no PDV (balcão)
O PDV usa a mesma engine de preços do site — o valor cobrado no balcão é idêntico ao da loja online, com o mesmo corte de preço antecipado.
Visão geral
1. AbrirMaquininha + caixa
2. MontarData, ingressos e produtos
3. ClienteBuscar ou criar contato
4. ReceberUm ou vários pagamentos
5. EntregarVoucher por WhatsApp, e-mail ou impressão
Passo a passo
-
Abra o PDV. Pelo menu lateral ou direto em
/pdv. Ele roda em tela cheia, fora do painel. - Selecione a maquininha e abra o caixa com o fundo de troco. São os dois portões obrigatórios: sem eles, a venda não libera.
- Escolha a data da visita. Datas futuras já mostram o preço antecipado, com selo.
- Adicione os ingressos e produtos. Só aparecem itens ativos, com preço calculável e — no caso dos produtos — marcados como vendidos no PDV.
- Identifique o cliente. Busque por nome, CPF ou telefone; se não existir, crie o contato na hora.
-
Aplique cupom ou desconto manual, se for o caso. O desconto manual exige a permissão
pos.discountou PIN de supervisor, e registra quem aplicou, o valor e o motivo. - Receba. Uma venda aceita vários pagamentos — por exemplo, parte em dinheiro e parte no cartão. Consulte a tabela de formas abaixo.
- Confirme. Quando a soma dos pagamentos aprovados alcança o total, o sistema gera os vouchers.
- Entregue o voucher por WhatsApp, e-mail ou impressão do QR.
-
Se o cliente entra agora, é possível dar o check-in direto pela tela de sucesso da venda
— isso exige também a permissão
checkin.operate.
Formas de recebimento
| Forma | O que exige | Comportamento |
|---|---|---|
| Dinheiro | Caixa aberto | Informe o valor recebido; o sistema calcula o troco. É a única forma que entra no caixa. |
| Cartão | Maquininha e identificador da transação | Distingue crédito de débito; só o crédito parcela. |
| Pix | Maquininha e identificador da transação | Processado pela maquininha. |
| Contingência manual | Identificador da transação (obrigatório) | Para quando a maquininha processou fora do sistema. Anote o comprovante. |
Pagamento digital sem identificador não é aprovado
É proposital: impede “aprovar” manualmente uma cobrança que não aconteceu e garante a conciliação depois. O sistema também barra o mesmo identificador em duas linhas diferentes.
Quando falta permissão: o PIN de supervisor
- O operador tenta a ação (desconto, cancelamento, estorno ou cortesia).
- Se ele tem a permissão, executa direto, sem PIN.
- Se não tem e a empresa habilitou a liberação por PIN, abre a janela de autorização.
- Um supervisor digita o PIN dele. Não é preciso trocar de sessão nem refazer o carrinho.
- A ação executa e fica registrada: operador, supervisor, ação, valor, motivo e horário. A autorização vale uma única vez.
Pagamento parcial ou com falha
Os valores já aprovados são preservados. O operador pode tentar de novo ou trocar de forma até cobrir o total. Os vouchers só saem quando a soma dos aprovados alcança o valor da venda.
Erros comuns
| Mensagem | Causa | Solução |
|---|---|---|
cash_session_required | Dinheiro sem caixa aberto | Abrir o caixa |
manual_requires_transaction_id | Contingência sem identificador | Informar o identificador |
digital_approved_requires_transaction_id | Cartão/Pix sem retorno da maquininha | Aguardar a confirmação do equipamento |
price_unavailable | Algum item sem preço calculável | Corrigir o preço no catálogo |
no_capacity | Vagas insuficientes na data | Reduzir a quantidade ou mudar a data |
| A tela de venda não abre | Falta maquininha ou caixa | Concluir os dois passos iniciais |
Boas práticas
- Confira as datas do pacote com o cliente: no fluxo do PDV o pacote aparece como um ingresso comum da data escolhida.
- Escreva motivos claros no desconto manual — eles serão lidos em auditoria.
- Use contingência manual só quando a maquininha realmente processou fora do sistema.
- Feche o caixa no fim do turno, com o time presente para conferir divergências.