Vouchers
O voucher é o ingresso. Ele controla acesso ou retirada; a venda controla o pagamento. Cada unidade de passaporte vendida gera um voucher, sempre após o pagamento ser aprovado.
Quem pode acessar
vouchers.view— ver e reenviar.vouchers.print— imprimir.vouchers.reschedulesensível — remarcar.
Como acessar
Menu lateral → Vouchers. O cabeçalho descreve o módulo como “Gestão de ingressos: status, validação e histórico”.
Tipos de voucher
| Tipo | Origem | Consome capacidade? | Validação |
|---|---|---|---|
| Acesso | Passaporte | Sim, quando o passaporte consome | Só no dia da ocorrência |
| Produto | Produto | Não | Por retirada; vale por status, independentemente da data |
Código e QR Code
- O código tem 8 caracteres maiúsculos, sem letras e números que se confundam visualmente.
- É único em toda a plataforma.
- O QR é gerado a partir do código e aponta para o endereço público
/v/<código>, onde o cliente vê o ingresso.
Ciclo de status
| Transição | Quem faz | Observação |
|---|---|---|
| Ativo → Usado | Portão (check-in) | Terminal. Não volta atrás. |
| Ativo/Pendente → Cancelado | Operador, ou cancelamento da venda | Libera a capacidade. |
| Cancelado → Ativo | Somente administrador | Reativação. |
| Ativo → Expirado | Rotina diária | Ocorrências passadas sem uso. |
Um voucher usado não pode ser cancelado, reativado nem expirado — e impede o cancelamento e o estorno da venda inteira.
Colunas e filtros da listagem
| Coluna | Conteúdo |
|---|---|
| Código | Os 8 caracteres do ingresso. |
| Item | Atração ou produto. |
| Passaporte / Tipo | Categoria do ingresso. |
| Ingressante | Quem vai entrar (preenchido no pré-check-in ou no portão). |
| Comprador | Quem pagou. |
| Data | Data da ocorrência. |
| Valor | Valor pago pela unidade. |
| Status | Situação atual. |
| Criado em | Data de emissão. |
Os filtros avançados cobrem código, status, tipo, nome e CPF do ingressante, nome e CPF do comprador, atração, produto, data da ocorrência e data de criação.
O voucher guarda os dois vínculos separadamente. Quem paga (comprador) permanece intacto mesmo quando outra pessoa preenche o pré-check-in e passa a constar como ingressante.
Ações disponíveis
Reenviar
Reenvia o ingresso ao cliente. O código continua o mesmo — reenviar não invalida nada. Só vouchers ativos ou usados podem ser reenviados. O envio usa a engine de notificações e respeita os canais configurados pela empresa (e-mail e/ou WhatsApp). O próprio comprador também pode pedir o reenvio pela área “Minha conta” da loja.
Remarcar
- Só para vouchers ativos.
- O sistema revalida a capacidade da nova data e recusa se não houver vaga.
- Se a nova data for mais cara que o valor pago, é exigida autorização de supervisor por PIN.
- A atração e a ocorrência do voucher são atualizadas.
Marcar como usado (uso administrativo)
Existe a ação de marcar um voucher como usado direto no painel, registrada com origem administrativa. O caminho normal de validação é sempre a tela do portão.
Histórico de eventos
Cada voucher tem um histórico interno, somente de acréscimo, com eventos como: gerado, enviado, dados do ingressante preenchidos, validado, cancelado, reativado, expirado, editado e remarcado. Esse histórico é interno — nunca é exposto ao cliente.
Regras de negócio
- Vouchers só nascem após o pagamento aprovado.
- Um voucher por unidade de passaporte — três adultos geram três vouchers.
- Pacote gera um voucher por data incluída.
- Cada voucher preserva empresa, venda, contato, atração, ocorrência, passaporte, valor pago, código e status.
- Passaporte com “gera voucher” desligado vende sem emitir ingresso; o mesmo vale para produto.
- Validação é atômica: em uma leitura simultânea, apenas a primeira efetiva.
- A geração e a validação acontecem no servidor — a tela nunca decide sozinha.
Erros e dúvidas comuns
| Situação | Motivo | Solução |
|---|---|---|
| Voucher não encontrado pelo código | Código digitado errado ou de outra empresa | Conferir os 8 caracteres; letras e números ambíguos não são usados |
| Não consigo remarcar | Voucher não está ativo, ou não há vaga na nova data | Verificar status e capacidade |
| Remarcação pede autorização | A nova data é mais cara que o valor pago | Chamar um supervisor para liberar por PIN |
| Não consigo reenviar | Voucher cancelado ou expirado | Só ativos e usados são reenviáveis |
| Voucher expirou sozinho | Rotina diária marcou a data passada | Comportamento esperado |
Boas práticas
- Oriente o cliente a apresentar o QR; digitar o código é o plano B.
- Ao remarcar, confirme a nova data com o cliente antes de gravar — o voucher antigo deixa de valer para a data original.
- Use o histórico do voucher para esclarecer reclamações (“quando foi validado e por quem”).
- Conceda a permissão de remarcação a supervisores, não a todo o balcão.