Opcionais - Novo Opcional

O que é

A página Novo Opcional é onde você cadastra um item extra para vender junto das suas viagens: transfer, seguro viagem, kit lanche, upgrade de poltrona, ingresso avulso ou qualquer outro complemento cobrado à parte. Você define o preço, como ele é cobrado, os textos que o cliente vê e em quais excursões (e experiências turísticas, quando esse módulo está ativo) o item fica disponível.

Você chega aqui pelo menu Módulos > Opcionais, clicando em Novo Opcional no canto superior direito do catálogo. Depois de salvo, o item passa a aparecer para o cliente na hora da compra das viagens em que você o vinculou, e a página de edição libera o envio de fotos para a galeria.

Como usar

O formulário é dividido em três abas: Dados Gerais, Mídia e Localização.

1. Vá em Módulos > Opcionais no menu lateral e clique em Novo Opcional (botão azul no topo da lista). A URL é /admin/opcionais/create.
2. Na aba Dados Gerais, preencha:
   • Nome (obrigatório) - Ex.: "Transfer aeroporto", "Seguro viagem".
   • Descrição Curta - Resumo de até 500 caracteres, exibido no momento da compra.
   • Preço (obrigatório) - Valor cobrado pelo item.
   • Base de cobrança (obrigatório) - Por pessoa, Por reserva ou Por unidade. Define como o valor é calculado na venda (veja em "O que você precisa saber antes").
   • Quantidade máxima por venda - Teto de unidades que o cliente pode levar de uma vez (deixe vazio para não limitar).
   • Descrição Completa - Texto mais longo, para quem quer saber mais antes de comprar.
   • Duração (minutos) e Ordem de exibição - Opcionais.
   • O que inclui / O que não inclui - Um item por linha; ajudam a evitar dúvidas do cliente depois da compra.
3. Em Excursões onde aparece, selecione uma ou mais excursões. O opcional só aparece na compra e na reserva das viagens marcadas aqui.
4. Se o módulo de Experiências Turísticas estiver ativo, a seção Experiências onde aparece funciona da mesma forma para suas experiências.
5. Ajuste as chaves de comportamento:
   • Controlar estoque - Quando ligada, libera o campo Estoque total e bloqueia a venda ao esgotar as unidades.
   • Obrigatório (auto-incluído) - Adiciona o item automaticamente em toda reserva das viagens vinculadas, sem o cliente poder recusar.
   • Aceita cupom de desconto - Permite usar cupom neste item.
   • Destaque - Dá mais evidência ao item na listagem de compra.
   • Ativo - Precisa estar ligado para o item ficar disponível para venda.
6. Na aba Mídia, envie a Imagem de Capa (a foto principal vista pelo cliente) e, se quiser, um link de Vídeo do YouTube. A Galeria de Fotos (até 10 imagens) só é liberada depois que você salvar o cadastro pela primeira vez.
7. Na aba Localização, preencha Local/Destino, Endereço, País (que muda os campos de estado e cidade ao lado) e o Ponto de Encontro - a orientação que o cliente lê para te achar no dia. Use o campo de busca e o botão Buscar para localizar o endereço no mapa, ou clique diretamente sobre o mapa e arraste o marcador para ajustar a posição exata.
8. Confirme em Criar Opcional. Se preferir, use a ação secundária Criar e continuar editando (abre a tela de edição do item recém-criado, útil para já subir as fotos da galeria).

O que você precisa saber antes

• A base de cobrança muda como o valor é aplicado na venda. "Por pessoa" multiplica o preço pelo número de passageiros da reserva; "por reserva" cobra o valor uma única vez, não importa quantos passageiros; "por unidade" deixa o cliente escolher a quantidade livremente (até o limite de Quantidade máxima por venda, se você definir um).
• A galeria de fotos só funciona depois de salvar. Antes disso, a aba Mídia mostra apenas a Imagem de Capa e o campo de vídeo; para adicionar mais fotos, salve o cadastro primeiro e volte à tela de edição.
• Obrigatório entra sozinho em toda reserva vinculada. Use essa opção só para itens que realmente devem ser cobrados de todo mundo que compra a excursão (viagem) ou experiência - o cliente não tem como recusar esse item na compra.
• Vincular a uma excursão ou experiência é o que faz o item aparecer para o cliente. Cadastrar o opcional sozinho, sem marcar nenhuma viagem em "Excursões onde aparece" (ou "Experiências onde aparece"), não é suficiente para ele entrar no checkout.
• A seção Experiências onde aparece só existe se você tiver o módulo de Experiências Turísticas ativo. Sem esse módulo, o cadastro fica só com o vínculo de excursões.

Casos especiais

Opcional sem controle de estoque

Deixe Controlar estoque desligado quando não houver limite físico para o item (ex.: um seguro viagem digital). Nesse caso o campo Estoque total fica oculto e o item vende sem restrição de quantidade, enquanto estiver Ativo.

Opcional com ponto de encontro próprio

Preencha a aba Localização quando o opcional tiver um local e horário de encontro diferentes da viagem principal - por exemplo, um passeio avulso com ponto de embarque específico. Se o item não precisa dessa informação (como um seguro viagem), a aba pode ficar em branco.

Cadastrar e continuar editando

Use Criar e continuar editando em vez de Criar Opcional quando já tiver fotos prontas para subir na galeria: a ação salva o cadastro e leva direto para a tela de edição, onde o envio de imagens fica liberado.

Erros comuns e como resolver

• "O campo nome é obrigatório." - Causa: o campo Nome ficou vazio. Solução: informe um nome antes de salvar.
• "O campo preço é obrigatório." / "O campo preço deve ser um número."
  • Causa: o campo Preço ficou vazio ou recebeu um valor inválido. Solução: informe um valor numérico maior ou igual a zero.
• "O campo tipo cobrança selecionado é inválido." - Causa: a Base de cobrança não foi escolhida. Solução: selecione Por pessoa, Por reserva ou Por unidade.
• "Erro ao cadastrar opcional: ..." - Causa: erro inesperado durante a gravação no banco (a operação é atômica; se falhar, nada é salvo). Solução: revise os dados informados e tente novamente; se persistir, abra um chamado no Suporte com a mensagem completa.

Onde encontrar

• URL: /admin/opcionais/create
• Caminho no menu: Módulos > Opcionais > Novo Opcional
• Permissão necessária: criar opcionais (além de ver os opcionais)
• Módulo necessário: Opcionais

Veja também

• Opcionais - Catálogo de Opcionais
• Opcionais - Editar Opcional