Ingressos - Vendas de Ingressos

O que é

A página Vendas de Ingressos centraliza todas as vendas do módulo Ingressos da sua empresa, sejam elas geradas pelo site publico (vinculadas a um pedido) ou registradas manualmente pelo balcao. Cada venda guarda o ingresso, a categoria (quando aplicavel), a quantidade, o valor unitario e total, o beneficiario, o status atual e um código único de 8 caracteres usado como referência do ingresso emitido.

O operador chega aqui para acompanhar o volume de vendas do dia, encontrar uma venda especifica pelo nome do cliente ou pelo código do ingresso, mudar o status conforme o atendimento (confirmar uma reserva paga, marcar um ingresso como usado na entrada do evento, cancelar uma venda) e registrar vendas presenciais ou vendas feitas em sites externos (link de afiliado).

A página também mostra um painel com totais de vendas, receita acumulada dos status ativos (reservado e confirmado), quantidade por status e o número de vendas registradas no dia.

Como usar

1. Va em Modulos > Ingressos > Vendas de Ingressos no sidebar (URL /admin/ingressos/vendas).
2. Use a barra de filtros para localizar uma venda:
   • Buscar - pesquisa por nome do beneficiario, código do ingresso, documento do beneficiario ou nome do cliente vinculado.
   • Status - Reservado, Confirmado, Usado ou Cancelado.
   • Ingresso - limita a um ingresso especifico do catalogo.
   • Data início / Data fim - filtram pela data de criação da venda.
3. Para registrar uma venda manual, clique em Registrar Venda (botao roxo no topo direito) e preencha o formulario:
   • Ingresso - obrigatório. Ao selecionar, o sistema busca em /admin/ingressos/vendas/api/categorias/{ingresso} as categorias ativas e exibe ou o seletor de categoria ou os campos de venda externa.
   • Categoria - obrigatória quando o ingresso possui categorias. O valor unitario e preenchido automaticamente com preco_venda da categoria escolhida.
   • Produto / Tipo / Valor Unitario - aparecem apenas para ingressos sem categoria (venda externa/link). Valor e digitado com mascara monetaria e convertido para decimal no envio.
   • Quantidade - mínimo 1, máximo 100. O total e recalculado em tempo real (quantidade x valor unitario).
   • Nome do Beneficiario - obrigatório.
   • Documento (CPF/RG) - opcional, ate 20 caracteres.
   • Status - Confirmado (venda presencial, padrão) ou Reservado (aguardando pagamento). So estes dois são permitidos no cadastro.
   • Observações - texto livre ate 1000 caracteres.
4. Clique em Registrar Venda no rodape do modal. O sistema cria a venda, gera o codigo_ingresso (8 chars maiusculos) e ajusta o IngressoEstoque do dia: incrementa quantidade_vendida quando Confirmado ou quantidade_reservada quando Reservado.
5. Em cada linha da lista, use o dropdown de ações (icone de tres pontos a direita) para:
   • Ver detalhes - abre /admin/ingressos/vendas/{venda} com os dados completos (cliente, pedido, passageiro, criador).
   • Confirmar - disponível quando a venda esta Reservada.
   • Marcar como Usado - disponível para vendas Reservadas ou Confirmadas.
   • Cancelar - disponível para qualquer venda que não esteja Cancelada (ação destacada em vermelho).

Casos especiais

Ingresso de venda externa (sem categorias)

Ingressos cadastrados sem categorias são tratados como "venda externa por link". No modal de venda manual, em vez do seletor de categoria aparece um bloco informativo azul e tres campos extras (Produto, Tipo e Valor Unitario) que devem descrever o produto vendido fora do sistema e o valor cobrado. O valor digitado vai com mascara e e convertido para decimal antes da validação.

Transicao de status e estoque

Ao alterar o status de uma venda existente (ação via dropdown), o controlador reverte o efeito do status anterior no IngressoEstoque e aplica o efeito do novo:

• Reservado ocupa quantidade_reservada.
• Confirmado e Usado ocupam quantidade_vendida.
• Cancelado não incrementa nada (libera o estoque).

Se a venda for trocada para o mesmo status atual, o sistema retorna um aviso informativo sem alterar nada.

Edição limitada após a venda

Na página de detalhes (show) e possível editar apenas o campo Observações (ate 1000 caracteres) atraves da rota update-observacoes, que exige a permissão de editar os ingressos. Valor, categoria, beneficiario e demais dados ficam imutaveis para preservar a consistencia financeira com o pedido vinculado (order_id) e com o FinTransacao sincronizado pelo observer.

Venda vinculada a pedido do site

Quando a venda vem do checkout publico, ela carrega order_id preenchido e mostra na lista o badge "Pedido #código" alem do badge de status. Cancelar uma venda dispara o observer financeiro (IngressoVendaFinanceiroObserver) que atualiza a transacao no financeiro; o motivo do cancelamento e registrado no nivel da Order, não da venda.

Erros comuns e como resolver

• "Selecione um ingresso." - Causa: campo ingresso_id não foi preenchido no modal. Solucao: escolha um ingresso no seletor antes de enviar.
• "Informe a quantidade." / "Quantidade minima e 1." - Causa: quantidade vazia ou menor que 1. Solucao: informe um valor inteiro entre 1 e 100.
• "Informe o nome do beneficiario." - Causa: campo obrigatório vazio. Solucao: preencha o nome completo de quem vai usar o ingresso.
• "Erro ao registrar venda: ..." - Causa: exceção no banco (rollback automático da transacao). Solucao: verifique a mensagem detalhada exibida no toast e tente novamente; se persistir, valide se o ingresso existe e tem categoria ativa.
• "Status ja esta definido como X." - Causa: tentativa de mudar para o mesmo status atual via dropdown. Solucao: escolha um status diferente do atual.
• "Erro ao alterar status: ..." - Causa: falha na atualização do estoque associado. Solucao: confirmar que existe IngressoEstoque para a data do evento; o sistema cria automaticamente se ausente no cadastro, mas a transicao pode falhar se o registro foi removido manualmente.

Onde encontrar

• URL: /admin/ingressos/vendas
• Caminho no menu: Modulos > Ingressos > Vendas de Ingressos
• Permissão necessária: ver os ingressos (e editar os ingressos para atualizar observações em vendas existentes)
• Módulo necessário: Ingressos (uma trava de acesso)

Veja também

• Ingressos - Criar Ingresso
• Ingressos - Editar Ingresso