Excursões - Variações do Pacote

O que é

Variações são opcionais cadastrados dentro de um Pacote de Viagem que mudam o preço ou o produto entregue sem precisar duplicar o pacote inteiro. Use para oferecer escolhas como Hotel Panorama versus Hotel Barra Bonita, Triplo Solteiro versus Duplo Casal, Com almoço incluso versus Sem refeição, ou um upgrade de transporte. Cada variação entra automaticamente na matriz de preços e o cliente seleciona a opção que quiser durante o checkout.

O usuário chega aqui durante a edição da excursão, logo após criar um pacote de viagem e antes de configurar a tabela de preços. A aba Variações só aparece quando o tipo da excursão é Pacote de Viagem (em excursões com transporte rodoviário, a aba fica oculta porque o controle de produto é feito por embarques e categorias).

Como usar

1. Vá em Excursões no sidebar e abra o pacote de viagem desejado.
2. Na barra de abas do topo, clique em Variações (ícone de quadrados).
3. Clique no botão Adicionar (canto superior direito do card) ou, se for a primeira, no link Adicionar a primeira variação no centro.
4. No modal Nova Variação, preencha:
   • Nome (obrigatório, até 150 caracteres) - texto que o cliente vê. Ex: Hotel Panorama, Triplo Solteiro, Com Almoço.
   • Tipo (obrigatório) - categoriza a variação para exibição com ícone e cor. Opções fixas: Hospedagem, Acomodação, Refeição, Transporte ou Genérica.
   • Descrição (opcional, até 2000 caracteres) - detalhes que aparecem como linha secundária no card.
   • Código (opcional, até 50 caracteres) - identificador interno para integração ou referência rápida. Precisa ser único dentro da excursão.
   • Vagas máximas (opcional, entre 1 e 100000) - limite de passageiros que podem escolher essa variação. Deixe em branco para vagas ilimitadas.
   • Ativa (visível no checkout) - marque para a opção aparecer ao cliente; desmarque para esconder temporariamente sem perder o histórico.
5. Clique em Salvar. A variação aparece na lista com o tipo colorido, vagas e código, se houver.
6. Repita para cada opcional do pacote.
7. Em seguida, vá na aba Preços para definir quanto custa cada variação cruzada com as categorias (Adulto, Criança etc.).

Casos especiais

Pacote tem apenas variações de tipos diferentes

Você pode misturar livremente: cadastre uma Hospedagem (Hotel Panorama), uma Refeição (Café da manhã incluso) e um Transporte (Traslado aeroporto) no mesmo pacote. Cada uma vira uma escolha independente na tabela de preços.

Variação esgotada

Quando o número de passageiros confirmados + pendentes atinge vagas_maximas, o card mostra X/Y vagas (Esgotada) em vermelho e a opção fica indisponível para novas reservas, mesmo estando ativa. Para liberar mais vagas, edite a variação e aumente o valor (não é possível diminuir abaixo do que já foi vendido).

Esconder do site sem perder histórico

Para uma variação que não quer mais vender mas que já tem passageiros vinculados, desmarque Ativa (visível no checkout) e salve. A variação some do site público e do checkout, mas continua vinculada aos passageiros antigos e aparece como Inativa (badge vermelho) na lista administrativa.

Reordenar variações

A ordem de exibição é definida pelo campo ordem, incrementado a cada nova variação criada. A interface usa essa ordem para listar; reorganize salvando na sequência desejada ou removendo e recriando.

Erros comuns e como resolver

• "Variações só estão disponíveis para excursões do tipo Pacote de Viagem." - Causa: tentar criar variação em uma excursão com transporte rodoviário (tipo excursao). Solução: variações só existem em pacotes; para excursões tradicionais use categorias e embarques.
• "Já existe outra variação com o código '...' nesta excursão." - Causa: o campo Código precisa ser único dentro da mesma excursão. Solução: usar um código diferente ou deixar em branco.
• "Não é possível reduzir o limite para X: já há Y passageiros nesta variação." - Causa: tentativa de baixar vagas_maximas para um número menor do que já foi vendido. Solução: aumentar o limite ou cancelar passageiros antes de reduzir.
• "Esta variação tem passageiros vinculados e não pode ser removida. Desative em vez de excluir." - Causa: a variação já tem reservas. Solução: desmarcar Ativa para esconder do checkout mantendo o histórico.
• "O nome é obrigatório" - Causa: tentou salvar sem preencher o campo Nome no modal. Solução: digitar o nome antes de clicar em Salvar.

Onde encontrar

• URL: /admin/excursoes/{excursao}/variacoes
• Caminho no menu: Excursões > (abrir o pacote) > Aba Variações
• Permissão necessária: ver as viagens para abrir, editar as viagens para criar, editar, remover e reordenar
• Módulo necessário: nenhum (faz parte do core, mas a aba só aparece para pacotes de viagem)

Veja também

• Visão Geral das Excursões
• Criar Excursão
• Categorias e Preços
• Pontos de Embarque