Ingressos - Editar Ingresso

O que é

A página Editar Ingresso permite atualizar todos os dados de um ingresso já cadastrado no módulo Ingressos: imagem de capa, modo de exibição do banner no site, dados gerais (nome, local, cidade/estado, data e hora do evento), quantidade total disponível e limite para parar vendas, status, destaque na home, override de exibição de preços e o tipo de venda (Venda Direta com categorias próprias ou Link de Afiliado).

O acesso exige a permissão de editar os ingressos e o módulo Ingressos ativo na sua empresa. Você normalmente cai aqui depois de clicar em editar na listagem (/admin/ingressos) ou logo após cadastrar um ingresso pela opção "Salvar e continuar editando".

Como usar

1. Vá em Modulos > Ingressos no sidebar para abrir a listagem.
2. Localize o ingresso desejado e clique em Editar (ícone de lápis na linha do ingresso).
3. Ajuste as seções do formulário conforme necessário:
   • Imagem de Capa - Faça upload ou substitua a imagem (tamanho mínimo recomendado: 1200px de largura, JPG/PNG/WebP). É armazenada na pasta ingressos/{id} da Media Library.
   • Modo de Exibição do Banner - Escolha entre Padrão do Site (herda da sua empresa), Hero (fundo completo), Vitrine (card centralizado), Split (lado a lado) ou Minimal (sem destaque).
   • Dados do Ingresso - Nome (obrigatório), Local/Atração, Estado e Cidade, Data e Hora do Evento, Quantidade Total (em branco = ilimitado), Parar Vendas em (limite opcional) e Descrição (editor TinyMCE com Blocos Prontos).
   • Configurações - Toggle Ingresso ativo para venda (controla se aparece no site) e toggle Exibir na página inicial (destaque na home).
   • Exibição de Preços - Override por ingresso da configuração global de Jornada do Cliente: modo (Padrão global / A partir de / Até) e exibição de intervalo de preços. Só afeta ingressos com mais de uma categoria.
   • Tipo de Venda - Selecione Venda Direta (com categorias internas) ou Link de Afiliado (redireciona para site externo).
4. No modo Venda Direta, gerencie as Categorias de Preço:
   • Clique em Adicionar para criar nova categoria.
   • Para cada categoria preencha Nome (obrigatório, ex.: Adulto, Criança), Idade Mín. e Idade Máx. (0 a 120, opcionais), Preço de Custo (obrigatório) e Preço de Venda (obrigatório). O sistema calcula Lucro e Margem automaticamente.
   • Remova uma categoria pelo X no canto superior direito do bloco (não é possível remover se for a única).
5. No modo Link de Afiliado, informe a URL do Site de Vendas (obrigatória, deve ser URL válida). Ao salvar, todas as categorias existentes são apagadas.
6. Clique em Salvar Alterações no rodapé. Use Salvar e continuar editando para permanecer na mesma página após salvar.

Casos especiais

Trocar de Venda Direta para Link de Afiliado

Ao mudar o tipo para Link de Afiliado e salvar, todas as categorias de preço cadastradas são apagadas ($ingresso->categorias()->delete()). O campo URL do Site de Vendas passa a ser obrigatório. Use esta opção quando o ingresso for revendido via link com código de afiliado.

Remover categoria já cadastrada

Categorias presentes no formulário são identificadas pelo id (campo hidden). Categorias removidas no front-end (clicando no X) somem do array enviado e são deletadas no update via whereNotIn('id', $categoriasEnviadas). Categorias com nome vazio são ignoradas silenciosamente.

Override de exibição de preços

Os campos Modo de exibição e Intervalo de preços sobrescrevem a configuração global de Jornada do Cliente apenas para este ingresso. Selecionar Usar padrão global (string vazia) envia null ao banco e o ingresso volta a herdar a config da sua empresa.

Quantidade Total x Parar Vendas em

• Quantidade Total - Estoque real máximo. Em branco = ilimitado.
• Parar Vendas em - Limite operacional para encerrar vendas antes de atingir a quantidade total (ex.: total 1000, parar em 950 para reservar 50 para venda física).

Slug regenerado ao mudar nome

Se o Nome do Ingresso for alterado e o slug não tiver sido editado manualmente, o sistema regenera o slug automaticamente (Ingresso::updating), garantindo unicidade dentro da sua empresa (inclui soft-deleted).

Erros comuns e como resolver

• "O campo nome é obrigatório." - Causa: o campo Nome ficou vazio. Solução: informe um nome para o ingresso.
• "O campo categorias é obrigatório." ou "deve conter ao menos 1 item" - Causa: no modo Venda Direta nenhuma categoria foi preenchida. Solução: adicione pelo menos uma categoria com Nome, Preço de Custo e Preço de Venda.
• "O campo website é obrigatório." ou "deve ser uma URL válida." - Causa: no modo Link de Afiliado a URL não foi preenchida ou está malformada. Solução: cole a URL completa começando por http:// ou https://.
• "A data do evento deve ser uma data após ou igual a hoje." - Causa: data do evento no passado. Solução: deixe em branco (sem data) ou informe data futura.
• "O campo hora do evento não confere com o formato H:i." - Causa: hora preenchida fora do padrão HH:MM. Solução: use o seletor de hora ou digite no formato 14:30.
• "Erro ao atualizar ingresso: ..." - Causa: falha na transação (DB). Solução: a transação faz rollback automático; revise os dados e tente novamente. Se persistir, verifique logs.

Onde encontrar

• URL: /admin/ingressos/{ingresso}/edit
• Caminho no menu: Modulos > Ingressos (clicar em Editar na linha do ingresso)
• Permissão necessária: ver os ingressos + editar os ingressos
• Módulo necessário: Ingressos

Veja também

• Ingressos - Listagem
• Ingressos - Criar
• Ingressos - Vendas