Eventos - Ingressos do Evento

O que é

O modulo de Ingressos transforma cada evento em um produto vendavel com bilhete digital. Cada ingresso representa uma atracao, festa, show ou experiência turistica que pode ser comercializada de forma independente das excursões rodoviarias. Para empresas que usam a terminologia "Evento" (configurada em Configurações > Terminologia), e por aqui que você monta a estrutura de venda, faz a gestão de portaria e acompanha o faturamento de cada data.

O usuário normalmente chega aqui depois de ativar o módulo Ingressos e cadastrar a primeira atracao. A partir dai, cada categoria criada (Pista, VIP, Meia-entrada, Crianca, etc.) gera estoque proprio, e cada compra finalizada cria registros em ingresso_vendas com código único por beneficiario, usado para o check-in de portaria via QR Code no Portal do Guia.

Como usar

1. Va em Modulos > Ingressos no sidebar para abrir a listagem em /admin/ingressos.
2. Use o campo de busca no topo para localizar por nome do evento, ou aplique o filtro Status (Todos os status / Ativo / Inativo) para ver so o que esta no ar.
3. Clique em Novo Ingresso (botao destacado no canto superior direito) para iniciar o cadastro.
4. Preencha os dados do evento:
   • Nome - obrigatório, vira o titulo da página publica de venda.
   • Local / Atracao, Cidade, Estado - usados na vitrine do site.
   • Data do Evento e Hora do Evento - a data precisa ser igual ou posterior a hoje.
   • Quantidade Total - estoque global do evento (opcional; deixe em branco para venda ilimitada).
   • Limite de Venda - teto por canal online, util para reservar parte das vagas para vendas presenciais.
   • Website - obrigatório quando o Tipo de Venda for Afiliado (a compra acontece em outro site).
5. Em Tipo de Venda escolha:
   • Direta - você vende dentro do Viagilize, com PIX/cartao e voucher emitido na plataforma. Exige pelo menos uma categoria.
   • Afiliado - o card no site redireciona para a URL informada em Website. Sem categorias, sem estoque.
6. Para venda direta, adicione as Categorias de Ingresso: cada linha tem Nome, Descrição, Idade min e Idade max (0 a 120), Preco de Custo e Preco de Venda. A diferenca alimenta o KPI Lucro no dashboard.
7. Ajuste a exibicao publica em Banner Display Mode (Hero, Vitrine, Split, Minimal) e em Exibicao de Preco (A partir de / Ate / intervalo).
8. Conclua em Salvar, Salvar e continuar editando ou Salvar e criar novo - são tres botoes distintos no rodape do formulario.
9. Depois de publicar, acompanhe os pedidos em Ingressos > Vendas (/admin/ingressos/vendas) com filtros por status (Reservado, Confirmado, Usado, Cancelado), período, ingresso e busca por codigo_ingresso ou beneficiario.
10. No dia do evento, abra o Portal do Guia (app mobile) e escaneie o QR Code de cada participante para confirmar a entrada - a venda muda para o status Usado automaticamente.

Casos especiais

Ingresso de afiliado (sem categorias)

Quando o card no site so redireciona para o parceiro, troque Tipo de Venda para Afiliado. O sistema valida que Website esta preenchido com URL valida e ignora qualquer categoria existente - ao salvar, todas as categorias do ingresso são removidas.

Reserva sem pagamento (venda manual no balcao)

Em Vendas > Nova Venda Manual você pode registrar com status Reservado (sem cobrar ainda) ou Confirmado (ja recebido). O campo beneficiario_nome e obrigatório e o sistema gera codigo_ingresso único mesmo para vendas manuais - o código serve para entregar voucher impresso ao cliente.

Limite de venda online menor que o total

Use Quantidade Total = 500 e Limite de Venda = 300 quando você quer guardar 200 ingressos para venda presencial ou para parceiros. O carrinho do site para de aceitar pedidos ao atingir o Limite de Venda, mas o admin ainda registra vendas manuais ate o Quantidade Total.

WhatsApp dedicado a duvidas do ingresso

Em /admin/ingressos/configuracoes você informa um número de WhatsApp especifico para esse modulo (somente digitos). Esse número aparece no voucher e na página publica de venda, separado do WhatsApp geral da empresa.

Mudanca de Direta para Afiliado em ingresso ja com vendas

Ao alternar para Afiliado em um ingresso existente, as categorias são apagadas no commit. Vendas ja feitas continuam com a categoria gravada no histórico (snapshot em ingresso_vendas.categoria_id), mas novos pedidos passam a redirecionar para a URL externa.

Erros comuns e como resolver

• "Não e possível excluir um ingresso com vendas ativas." - Causa: existem registros em ingresso_vendas com status diferente de cancelado. Solucao: cancele todas as vendas ativas em Ingressos > Vendas antes de excluir, ou apenas desative o ingresso (toggle de status).
• "The data evento field must be a date after or equal to today." - Causa: a data informada em Data do Evento ja passou. Solucao: ajuste para hoje ou data futura; para registrar evento ja realizado, faca pelo modulo de Excursões.
• "The categorias field is required." - Causa: tentou salvar venda Direta sem nenhuma categoria preenchida (linha em branco não conta). Solucao: adicione ao menos uma categoria com Nome, Preco de Custo e Preco de Venda, ou troque o Tipo de Venda para Afiliado.
• "The website field is required." - Causa: ingresso configurado como Afiliado sem URL. Solucao: preencha Website com URL completa (com https://).
• "Selecione um ingresso." / "Informe o nome do beneficiario." - Causa: tentativa de registrar venda manual em /admin/ingressos/vendas sem campos obrigatorios. Solucao: preencha Ingresso, Quantidade (mínimo 1, máximo 100) e Nome do Beneficiario.
• "Erro ao cadastrar ingresso: ..." - Causa: falha na transacao (geralmente integridade de banco ou conflito de slug). Solucao: verifique se ja existe outro ingresso com o mesmo nome na sua empresa - o slug e gerado a partir do nome e precisa ser único (soft-deletes contam).

Onde encontrar

• URL: /admin/ingressos
• Caminho no menu: Modulos > Ingressos
• Submenus: Ingressos > Dashboard (/admin/ingressos/dashboard), Ingressos > Vendas (/admin/ingressos/vendas), Ingressos > Configurações (/admin/ingressos/configuracoes)
• Permissões necessarias: ver os ingressos para listar, criar os ingressos para cadastrar, editar os ingressos para editar/configurar, excluir os ingressos para excluir
• Módulo necessário: Ingressos (ativado em Configurações > Módulos)
• Check-in: feito pelo Portal do Guia (aplicativo mobile) escaneando o QR Code emitido em cada venda

Veja também

• Visao Geral dos Eventos - gestão do evento em si, antes de configurar a venda
• Cadastro de Ingresso - passo a passo detalhado para criar a primeira atracao
• Vendas de Ingressos - acompanhamento de pedidos, vendas manuais e cancelamentos