Experiências - Vendas

O que é

A página de Vendas de Experiências lista todas as reservas e vendas geradas para os passeios da sua empresa, sejam elas vindas do site público, importadas de meios de pagamento de pagamento ou criadas manualmente pelo atendente. Cada linha representa uma PasseioVenda (ou um grupo de vendas, quando o cliente comprou um pacote combinando várias experiências) com cliente, experiência, sessão, código do voucher, status e valor.

Você normalmente chega aqui depois de publicar uma experiência e começar a receber reservas, ou quando precisa registrar uma venda de balcão, lançar um pagamento manual recebido em dinheiro ou PIX, aplicar um desconto, cancelar uma reserva, fazer o check-in de um ingresso individual ou imprimir o voucher em PDF para o cliente. Para o repasse diário ao operador da atividade existe ainda o Relatório do Dia, que agrupa as vendas confirmadas por horário.

Como usar

1. Vá em Módulos > Passeios / Experiências no sidebar e acesse o submenu Vendas. A URL é /admin/passeios/vendas.
2. No topo, confira os três cartões de estatísticas: Total de Vendas, Vendas Ativas e Receita este Mês (soma de valor_total das vendas ativas no mês corrente).
3. Use a barra de filtros para localizar uma venda:
   • Buscar por nome, voucher... - busca livre por nome do beneficiário, código do voucher, nome do cliente, nome da experiência ou nome do pacote.
   • Status - Reservado, Confirmado, Usado ou Cancelado.
4. Cada card mostra avatar do cliente, nome do beneficiário, status, código do voucher, data da compra, link para a experiência, data e horário da sessão, categoria, quantidade de pessoas e valor total. Vendas de pacote aparecem como um único card "Pacote" listando as experiências incluídas.
5. Para abrir a ficha de uma venda, clique em Detalhes no rodapé do card. A ficha mostra dados do cliente, sessão, pagamentos manuais e do meio de pagamento, histórico de auditoria, itens de voucher e oferece os botões de pagamento, desconto, acréscimo, mudança de status e check-in por ingresso.
6. Para imprimir o voucher de uma venda Confirmada ou Usada, clique em Ver Voucher PDF no canto direito do card. O PDF traz o QR Code de cada PasseioVoucherItem.
7. Para cancelar uma venda Reservada ou Confirmada, clique em Cancelar no rodapé do card e confirme no modal Sim, cancelar venda.

Casos especiais

Registrar uma venda manual

1. No cabeçalho, clique em Nova Venda (botão teal no canto superior direito).
2. Em Cliente, clique em Selecionar ou cadastrar cliente... e use a busca por nome, CPF, telefone ou e-mail (mínimo 2 caracteres). Se o cliente ainda não existe, clique em + Cadastrar novo cliente no rodapé do modal e preencha Nome (obrigatório), Nacionalidade/documento estrangeiro, CPF, Celular / WhatsApp e E-mail - o sistema valida CPF e e-mail duplicados em tempo real e alerta se já existe cliente com o mesmo telefone.
3. Em Experiência, escolha o passeio. As listas de Sessão e Categoria carregam por AJAX só com sessões futuras de status aberta; a categoria mostra o preço unitário já formatado.
4. Ajuste Quantidade - o Total estimado atualiza automaticamente multiplicando preço unitário por quantidade.
5. Opcionalmente, preencha Nome do Beneficiário se a pessoa que vai usar for diferente do cliente comprador.
6. Clique em Registrar Venda. O serviço valida vagas (considerando conta_como da categoria), calcula preço com temporadas vigentes, gera os PasseioVoucherItem e redireciona com mensagem de sucesso.

Lançar pagamento manual

Na ficha de uma venda (botão Detalhes), use o bloco de pagamentos para registrar dinheiro, PIX, débito, crédito, transferência, boleto ou cheque, com valor, data de pagamento e observação (até 500 caracteres). Quando a venda está reservada e o pagamento zera o valor pendente, o sistema confirma automaticamente a venda - o toast mostra "Pagamento registrado e venda confirmada automaticamente." Pagamentos manuais cujo valor e data coincidem com algum pagamento do meio de pagamento são sinalizados visualmente como possível duplicidade para evitar lançamento dobrado.

Aplicar desconto

Use o botão de desconto na ficha. O sistema valida que o valor seja menor que o total + acréscimo da venda (margem de R$ 0,01). É obrigatório informar o motivo (até 255 caracteres) - ele fica registrado em desconto_motivo para auditoria. Para remover, basta zerar pelo botão de remoção (removerDesconto).

Aplicar acréscimo

Mesmo fluxo do desconto, sem teto de valor. Útil para taxas extras de última hora ou serviços adicionais combinados com o cliente. Também exige motivo.

Check-in de um ingresso individual

Cada venda gera N PasseioVoucherItem (um por pessoa × quantidade). Na ficha, o atendente clica no botão Check-in do ingresso específico - só funciona se a venda estiver Confirmada. O sistema marca o item como usado, registra o usuário responsável e o horário, e mostra o contador "X/Y ingressos usados". Ingressos já usados ou cancelados bloqueiam novo check-in com mensagem explícita.

Pacote de experiências

Quando uma venda faz parte de um PacoteVenda, a listagem agrupa todas as experiências do mesmo pacote em um único card teal com a tag "Pacote", listando cada experiência com status individual, voucher e horário. As ações de Detalhes e Cancelar pacote levam para /admin/pacote-vendas/{id}, que gerencia o grupo inteiro. Clicar em uma venda individual de pacote redireciona automaticamente para a ficha do pacote.

Relatório do Dia

Clique em Relatório do Dia no cabeçalho para abrir /admin/passeios/vendas/relatorio-diario. Filtre por data (default: hoje) e opcionalmente por passeio. O relatório lista todas as vendas ativas da data, agrupadas por passeio e por slot de horário (HH:MM – HH:MM), com totais de pessoas, ingressos, valor a cobrar, valor pago e pendente. Tem versão PDF (rota relatorio-diario.pdf, renderizada via Gotenberg em A4 inline) ideal para enviar ao operador por WhatsApp.

Alterar status manualmente

Pela ação de mudança de status (updateStatus), você pode mover uma venda para Confirmado (só funciona se estava reservada), Cancelado (com motivo opcional de até 500 caracteres) ou Usado (executa o marcarComoUsado global da venda). Transições inválidas - por exemplo, tentar confirmar uma venda já cancelada - retornam erro "Transição de status não permitida.".

Erros comuns e como resolver

• "Este ingresso já foi utilizado em DD/MM/AAAA HH:MM." - Causa: tentativa de check-in em um PasseioVoucherItem já marcado como usado. Solução: confirmar no histórico de auditoria quem fez o primeiro check-in; se foi engano, cancelar o item e gerar outro pelo suporte (não há reabertura pela UI).
• "Este ingresso está cancelado." - Causa: o item específico foi cancelado (mesmo com a venda confirmada). Solução: emitir nova venda ou usar outro ingresso da mesma venda.
• "Venda com status 'X' não pode fazer check-in." - Causa: a venda não está Confirmada (está reservada, cancelada ou usada). Solução: registrar o pagamento pendente para confirmar, ou orientar o cliente que a reserva precisa ser quitada antes.
• "O desconto não pode ser maior que o valor da venda (R$ X,XX)." - Causa: tentativa de aplicar desconto igual ou superior ao total + acréscimo. Solução: ajustar para um valor menor que o teto exibido na mensagem.
• "Já existe um cliente cadastrado com este CPF." / "...com este e-mail." - Causa: o cadastro rápido detectou duplicidade. Solução: fechar o cadastro rápido e usar a busca para selecionar o cliente existente.
• "Transição de status não permitida." - Causa: combinação inválida (ex: tentar confirmar venda cancelada). Solução: revisar o status atual no card e usar a ação apropriada (cancelar ou check-in via QR/ingresso).

Onde encontrar

• URL: /admin/passeios/vendas
• Caminho no menu: Módulos > Passeios / Experiências > Vendas
• Permissão necessária: passeios.vendas
• Módulo necessário: Passeios e Experiências (passeios-experiencias)

Veja também

• Experiências - Visão Geral
• Dashboard Experiências
• Criar Experiência
• Pacotes de Experiências
• Gift Cards