Excursões - Visão Geral

O que é

O módulo de Excursões é o núcleo operacional do Viagilize. É aqui que cada viagem é cadastrada, configurada, publicada no site e acompanhada até o encerramento. A página inicial /admin/excursoes reúne, em uma única lista, todas as excursões e pacotes de viagem da sua empresa, com indicadores rápidos de status, ocupação, configuração pendente e financeiro consolidado por viagem.

O usuário normalmente chega aqui ao iniciar o dia para revisar o que está em rascunho, o que precisa ser publicado, o que está vendendo bem e o que já passou e precisa ser finalizado. A página também é o ponto de partida para qualquer fluxo: cadastro novo, edição de uma excursão existente, gestão de passageiros, envio de comunicados, exportações e duplicação para reaproveitar uma viagem.

Como usar

1. Vá em Viagens (Excursões) no sidebar (ou acesse diretamente /admin/excursoes).
2. Use a barra de filtros logo abaixo do cabeçalho para localizar uma viagem específica:
   • Buscar - pesquisa por nome, local ou cidade da excursão.
   • Status - filtra entre Rascunho, Publicada, Cancelada ou Finalizada.
   • Filtrar por tags - combina uma ou mais tags cadastradas na sua empresa.
3. Para criar uma nova viagem, clique em Nova Excursão (botão primário no canto superior direito). Se o serviço de IA estiver habilitado, use Criar com IA para gerar a partir de imagem ou texto.
4. Para configurar viagens que se repetem (toda terça, toda quinta, etc.), entre em Séries Recorrentes no cabeçalho.
5. Em cada cartão da lista, clique no nome da excursão para abrir a tela de edição completa, ou use o ícone de olho ao lado do nome para abrir o modal de Dados rápidos.
6. No dropdown de Ações de cada linha estão os atalhos operacionais: Visualizar, Gerar Folder, Exportar Passageiros, Enviar Comunicado, Compartilhar, Publicar/Despublicar, Finalizar, Clonar e Excluir.

Casos especiais

Limite de excursões do plano

O plano contratado define quantas excursões podem ficar publicadas ao mesmo tempo. A barra de uso aparece no cabeçalho com três variações:

• Ilimitado - selo verde quando o plano não tem teto.
• Indicador de uso - barrinha com X/Y publicadas. Fica amarela quando o uso ultrapassa 80%.
• Limite atingido - banner amarelo no topo orientando despublicar uma viagem existente ou fazer upgrade do plano. Enquanto o limite estiver no teto, o botão Clonar fica desabilitado para excursões em rascunho.

Quando o billing está com pagamento pendente, o limite é reduzido temporariamente e um alerta vermelho aparece no topo com o atalho Regularizar Pagamento.

Excursão x Pacote de Viagem

A lista mistura os dois tipos de produto. O selo roxo Pacote identifica registros do tipo pacote de viagem (sem transporte próprio - o cliente vai por conta). Excursões com transporte aparecem sem esse selo. As pendências de configuração ignoram veículo e embarque quando se trata de pacote.

Badge Incompleta

Quando uma excursão em rascunho ou publicada está sem veículo, embarque, categoria ou preço configurado, aparece um selo âmbar Incompleta com a lista de itens pendentes no tooltip. Use isso para identificar rapidamente o que falta para a viagem ficar vendável.

Badges temporais

Excursões próximas ganham destaque automático no cabeçalho do cartão:

• HOJE - verde pulsante quando a data de início é hoje.
• Em andamento - azul pulsante quando a viagem começou e ainda não terminou.
• Amanha - ciano quando falta 1 dia.
• Em N dias - azul-claro entre 2 e 7 dias.
• Realizada - cinza quando a data já passou e o status ainda é Publicada.

Ordenação da lista

A ordenação é fixa e segue a lógica operacional do dia a dia: primeiro vêm as ativas (rascunho e publicada, por data crescente), depois as finalizadas/arquivadas e por último as canceladas (por data decrescente). Não há opção de reordenar manualmente.

Erros comuns e como resolver

• "Limite de excursões atingido" - Causa: o número de excursões publicadas chegou ao teto do plano. Solução: despublique uma viagem existente pelo dropdown de Ações (Despublicar) ou faça upgrade do plano em Fazer Upgrade.
• "Pagamento Pendente - Limite Reduzido" - Causa: há cobrança em aberto no billing da sua empresa. Solução: clicar em Regularizar Pagamento e quitar a fatura para voltar ao limite normal do plano.
• Selo Incompleta no cartão - Causa: a excursão está sem veículo, embarque, categoria ou preço. Solução: abrir a excursão pelo nome e completar os itens listados no tooltip do selo antes de publicar.
• Botão Clonar desabilitado - Causa: você atingiu o limite de excursões publicadas do plano. Solução: liberar uma vaga despublicando outra excursão ou contratar plano com limite maior.

Onde encontrar

• URL: /admin/excursoes
• Caminho no menu: Viagens (Excursões)
• Permissão necessária: ver as viagens (visualização). Ações específicas exigem criar as viagens, editar as viagens ou excluir as viagens.
• Módulo necessário: nenhum (módulo core do Viagilize).

Veja também

• Criar Excursão - cadastrar uma nova excursão ou pacote de viagem.
• Status e Ciclo de Vida - entender rascunho, publicada, cancelada, finalizada e arquivada.
• Gerenciar Transportes - cadastrar veículos da viagem.
• Pontos de Embarque - definir locais e horários de embarque.
• Categorias e Preços - configurar valores por categoria de passageiro.
• Gerenciar Passageiros - lista por transporte e embarque com filtros e ações.
• Financeiro da Excursão - consolidado de recebimentos e pendências.
• Conteúdo da Excursão - descrição, fotos e informações exibidas no site.
• Comunicados da Excursão - envio de avisos aos passageiros.
• Mapa de Check-ins - visão geral dos check-ins por veículo.
• Relatórios Consolidados - relatórios cruzados entre excursões.
• Check-in de Passageiros - fluxo de check-in no dia da viagem.
• Checklist de Embarque - tela operacional usada no embarque.
• Atribuir Guias - vincular guias responsáveis pela excursão.