Primeiros Passos - Criar a Primeira Excursão

O que é

A excursão (ou pacote de viagem) é o produto central do Viagilize: é o que você vende, o que os clientes reservam e a base de todos os outros módulos (financeiro, check-in, contratos, fidelidade, CRM). Criar a primeira é o marco de onboarding mais importante depois de configurar os dados da empresa e cadastrar o transporte.

Este artigo é uma versão enxuta voltada a quem está começando. Ele cobre só os passos mínimos para sair do zero e ter uma excursão em Rascunho no sistema. A configuração completa (categorias avançadas, preços por embarque, conteúdo do site, contratos, guias) está nos artigos do módulo Excursões.

Como usar

1. Vá em Excursões no menu lateral e clique em Nova Excursão (botão azul flutuante no canto superior direito da listagem). Você cai na URL /admin/excursoes/create.
2. Na seção Tipo de Produto, escolha um dos dois cards:
   • Excursão (card azul, padrão) - viagem com transporte rodoviário próprio, com embarques e mapa de assentos. Use se você opera ônibus, vans ou micro-ônibus.
   • Pacote de Viagem (card roxo) - produto sem transporte rodoviário fixo (aéreo, marítimo, hospedagem, cruzeiro). Ao escolher este tipo aparece o campo extra Limite de Vagas, que define a capacidade total (em vez do veículo).
3. Preencha Dados Básicos:
   • Nome - obrigatório. Use um nome descritivo com mês/ano (ex: "Aparecida do Norte - Março 2026"). É autofoco do formulário.
   • Data de Saída - obrigatória. Não aceita datas no passado.
   • Data de Retorno - opcional. Deixe em branco para excursões de um dia. Quando preenchida, fica travada para ser igual ou posterior à data de saída.
4. Preencha Destino:
   • Local / Atração - opcional, é o nome do ponto principal (ex: "Basílica de Nossa Senhora Aparecida"). Aparece nos cards do site.
   • Estado e Cidade - selecione no combo (a cidade é carregada após escolher o estado).
5. Se a empresa tem Segmentos cadastrados (ex: Religioso, Praia, Compras), marque os que se aplicam para agrupamento no site. Esta seção só aparece se houver segmentos ativos.
6. Confira o painel azul "Como funciona a criação de excursões" no rodapé do formulário - ele lista o que precisa ser configurado depois (Transporte, Embarques, Categorias automáticas e Preços para excursão; Categorias automáticas e Preços para pacote de viagem).
7. Finalize em Criar Excursão (botão azul no rodapé). Recomendado para o onboarding: use Criar e continuar editando, que abre direto a tela de edição com as abas Logística, Preços, Conteúdo, etc.

Ao salvar, a excursão é criada com status Rascunho, as categorias de passageiros padrão (Adulto, Criança, Melhor Idade) são geradas automaticamente e, se o módulo Contratos Digitais estiver ativo, o template padrão da sua empresa é aplicado. Você é redirecionado para a tela de edição para continuar.

Casos especiais

Pacote de Viagem (sem transporte rodoviário)

Ao trocar o tipo para Pacote de Viagem, o card de Tipo de Produto muda para a cor roxa e aparece o campo Limite de Vagas logo abaixo. Esse número é obrigatório porque, sem veículo, é ele que define a capacidade vendável. Use para viagens aéreas, marítimas, cruzeiros ou qualquer produto em que o cliente vai por conta. O painel azul de orientação também muda e pula as etapas de transporte e embarques.

Excursão sem data de retorno (bate-volta)

Para excursões de um dia (ex: city tour, romaria), deixe Data de Retorno em branco. O sistema entende como excursão de um dia só e usa o campo data_inicio em todos os relatórios.

Campos personalizados da sua empresa

Se você cadastrou campos personalizados para excursões (em Configurações > Cadastros Personalizados), eles aparecem inline na seção Dados Básicos ou em blocos próprios depois de Destino. As regras de obrigatoriedade são definidas em cada campo.

Erros comuns e como resolver

• "O campo nome é obrigatório" - Causa: o nome ficou em branco. Solução: preencha um nome curto e descritivo (mês/ano ajuda a diferenciar viagens repetidas).
• "O campo data de saída é obrigatório" - Causa: o datepicker ficou vazio. Solução: clique no campo Data de Saída e selecione uma data igual ou posterior a hoje.
• "O campo data de retorno deve ser uma data igual ou posterior a data de saída" - Causa: você preencheu uma data de retorno anterior à data de saída. Solução: ajuste a data de retorno ou apague o campo para excursão de um dia.
• "O campo limite de vagas é obrigatório" (Pacote de Viagem) - Causa: você escolheu Pacote de Viagem mas não informou a capacidade. Solução: preencha um número inteiro em Limite de Vagas (ex: 30).

Onde encontrar

• URL: /admin/excursoes/create
• Caminho no menu: Excursões > Nova Excursão
• Permissão necessária: ver as viagens e criar as viagens
• Módulo necessário: nenhum (recurso nativo). O módulo Contratos Digitais é opcional e só ativa o vínculo automático de template de contrato.

Veja também

• Bem-vindo ao Viagilize
• Cadastrar Empresa de Transporte e Veículo
• Excursões - Criar Excursão (versão completa)
• Excursões - Visão Geral
• Excursões - Pontos de Embarque
• Excursões - Categorias e Preços