Excursões - Criar Excursão

O que é

A página de criação é o ponto de partida para cadastrar uma nova viagem no Viagilize. Em um único formulário curto, você define o tipo de produto (Excursão com transporte rodoviário ou Pacote de Viagem), o nome, as datas e o destino. Ao salvar, o sistema cria o registro como rascunho e gera automaticamente as três categorias padrão de passageiros (Adulto, Criança e Melhor Idade).

O usuário normalmente chega aqui pelo botão Nova Excursão na lista de excursões ou ao iniciar um novo cadastro pelo wizard guiado. Depois de criada, a excursão segue para a tela de edição, onde recebem transporte, embarques, preços, guias, conteúdo do site e demais configurações.

Como usar

1. Vá em Excursões no sidebar (item fixo, sempre visível).
2. Clique em Nova Excursão no canto superior direito da listagem.
3. Em Tipo de Produto, escolha um dos dois cards:
   • Excursão - transporte rodoviário com embarques e assentos.
   • Pacote de Viagem - aéreo, marítimo, rodoviário ou combinado (hotel, roteiro, voos, cruzeiro), sem controle de assento.
4. Se escolher Pacote de Viagem, aparece o campo Limite de Vagas (obrigatório, valor inteiro a partir de 1; representa a capacidade máxima de passageiros do pacote, como vagas no hotel).
5. No bloco Dados Básicos preencha:
   • Nome da Excursão ou Nome do Pacote - obrigatório, até 255 caracteres. Aparece no site e nos relatórios.
   • Data de Saída - obrigatória para excursão; opcional para pacote de viagem (cliente decide quando sair). Não pode ser anterior a hoje.
   • Data de Retorno - opcional. Se preenchida, precisa ser igual ou posterior à data de saída. Deixe em branco para viagens de um dia.
6. No bloco Destino preencha:
   • Local / Atração - texto livre (ex: nome da basílica, parque temático, hotel).
   • Estado e Cidade - selecione no combo de cidades por UF.
7. Em Segmentos (aparece se houver segmentos cadastrados na Vitrine), marque uma ou mais categorias para agrupamento no site público.
8. Confirme em Criar Excursão (rodapé) ou abra o dropdown ao lado e escolha Criar e continuar editando ou Criar e adicionar outra.

Após salvar, você é redirecionado para a tela de edição da excursão, onde encontra as abas Logística (transporte e embarques), Preços (categorias e valores), Conteúdo, Site e demais configurações.

Casos especiais

Pacote de Viagem (sem transporte rodoviário)

Quando o tipo é Pacote de Viagem, a página oculta a lógica de embarques e assentos. As regras de validação ficam mais flexíveis: Limite de Vagas vira o controle principal de capacidade, Data de Saída passa a ser opcional e o guia de próximos passos resume o fluxo a apenas Categorias (automáticas) e Preços. Use este modo quando o cliente vai por conta própria ao destino (avião, navio, carro) e o sistema controla apenas reserva, pagamento e voucher.

Campos personalizados

Se você tem campos personalizados configurados para a entidade Excursão, eles aparecem em duas regiões:

1. Inline no bloco Dados Básicos (campos da seção dados_gerais).
2. Em blocos próprios abaixo do Destino (demais seções).

A validação dos campos personalizados é aplicada automaticamente pelo CustomFieldService no momento do salvamento.

Defaults de Contrato Digital (módulo)

Se o módulo contratos-digitais está ativo, ao criar a excursão o sistema aplica os defaults da sua empresa: marca Exigir contrato conforme a configuração padrão e vincula o Template de contrato padrão. Você pode alterar isso depois na aba de configurações da excursão.

Multi-destinos (pacote internacional)

Para pacotes com vários destinos (ex: roteiro Europa com 3 cidades), o formulário aceita o array destinos[] (preenchido em telas posteriores do wizard). Cada destino registra país, estado, cidade, nome do local, data de chegada e saída, hospedagem e observação.

Erros comuns e como resolver

• "O nome da excursão é obrigatório." - Causa: campo Nome vazio. Solução: digitar o título da viagem antes de salvar.
• "A data de início é obrigatória." - Causa: criando uma Excursão (não pacote) sem informar Data de Saída. Solução: selecionar a data no calendário.
• "A data de início não pode ser anterior a hoje." - Causa: data de saída no passado. Solução: escolher uma data igual ou posterior a hoje. Datas passadas só são aceitas em edição.
• "A data de fim deve ser igual ou posterior à data de início." - Causa: Data de Retorno antes da Data de Saída. Solução: ajustar para a mesma data ou posterior, ou deixar em branco para viagem de um dia.
• Botão de salvar não aparece no rodapé - Causa: navegador com zoom alto ou viewport muito estreito esconde o sticky. Solução: rolar até o final do formulário; os botões reaparecem em layout estático.

Onde encontrar

• URL: /admin/excursoes/create
• Wizard alternativo: /admin/excursoes/wizard
• Caminho no menu: Excursões > Nova Excursão
• Permissão necessária: criar as viagens
• Módulo necessário: nenhum (criação faz parte do core)

Veja também

• Visão Geral das Excursões
• Wizard de Criação de Excursão
• Gerenciar Transportes
• Pontos de Embarque
• Categorias e Preços