Excursões - Status e Ciclo de Vida

O que é

Toda excursão tem um status que controla se ela aparece no site, se aceita reservas e como é exibida na listagem do admin. O Viagilize trabalha com quatro status reais: Rascunho, Publicada, Cancelada e Finalizada. O ciclo natural é Rascunho → Publicada → Finalizada, com Cancelada como saída alternativa quando a viagem não vai acontecer.

O usuário chega a este fluxo logo após criar a excursão (que nasce como Rascunho), quando precisa colocá-la à venda no site, quando precisa tirá-la do ar temporariamente, quando a viagem termina ou quando precisa cancelá-la. A mudança de status acontece na tela de edição da excursão (banner âmbar e cabeçalho) e no dropdown de Ações de cada card da listagem em Excursões.

Como usar

1. Vá em Excursões no sidebar (item fixo, sempre visível).
2. Localize a excursão na lista. O selo colorido no canto do card mostra o status atual: cinza = Rascunho, verde = Publicada, vermelho = Cancelada, azul = Finalizada.
3. Para mudar o status, escolha um dos caminhos:
   • Pela edição: clique no nome da excursão para abrir a tela de edição. O banner âmbar do topo (visível só em Rascunho) traz o botão verde Publicar Agora. Quando a excursão já está Publicada, o cabeçalho mostra o botão Despublicar.
   • Pelo dropdown da listagem: abra o menu de Ações (três pontos) do card e use Publicar, Despublicar ou Finalizar conforme o status atual.
4. Confirme a ação. O sistema valida pré-requisitos antes de publicar e atualiza o selo de status na hora.

Casos especiais

Pré-requisitos para publicar

Antes de mudar para Publicada, o sistema verifica se a excursão tem tudo configurado. Faltando qualquer item, a publicação é bloqueada com uma mensagem listando o que está pendente. Os itens exigidos são:

• Excursão tradicional: pelo menos um veículo ativo, um ponto de embarque ativo, uma categoria ativa e um preço configurado (valor maior que zero).
• Pacote de Viagem: dispensa veículo e embarque, mas exige Limite de Vagas maior que zero, categoria ativa e preço configurado.

Enquanto a excursão estiver em Rascunho, o banner âmbar do topo da edição lista exatamente o que falta em forma de pílulas (Veículo, Embarque, Categoria, Preço ou Limite de vagas). O botão Publicar Agora fica destravado em verde apenas quando todas as pendências são resolvidas.

Limite do plano

Cada plano tem um limite de excursões publicadas simultaneamente. Se você já atingiu o teto, a ação Publicar aparece com cadeado e o rótulo muda para Publicar (limite atingido). A solução é despublicar uma excursão antiga ou fazer upgrade do plano.

Despublicar (voltar para Rascunho)

Despublicar não é o mesmo que cancelar. O sistema apenas devolve a excursão para Rascunho: ela some do site, deixa de aceitar novas reservas, mas as reservas existentes continuam intactas. Use quando precisar editar muita coisa e não quer que o site mostre informações inconsistentes durante o ajuste.

Publicação e despublicação agendadas

Na edição da excursão, na aba Geral, existem os campos Publicar a partir de e Despublicar em. Quando preenchidos, o cron roda a cada minuto e muda o status automaticamente: ao chegar em Publicar a partir de, vira Publicada; ao chegar em Despublicar em, volta para Rascunho. Útil para lançamentos programados (ex: campanha que abre na meia-noite).

Finalizar uma excursão

A ação Finalizar só aparece no dropdown da listagem depois que a data de retorno (ou de saída, se não houver retorno) já passou. Ao confirmar:

• A excursão para de aparecer no site para venda.
• Novas reservas não podem mais ser feitas.
• Dados de passageiros, financeiro e check-ins continuam acessíveis.
• A excursão é movida para o final da lista.

A confirmação abre um modal listando esses efeitos antes de aplicar a mudança.

Excursão em andamento

Quando a data de saída já passou mas a data de retorno ainda não chegou, o sistema marca o card visualmente como em andamento (a borda colorida e o agrupamento na listagem refletem isso). Não é um status no banco - o cálculo é feito a partir das datas. Por isso, nesse intervalo, a opção Finalizar ainda não aparece: só fica disponível quando a viagem realmente terminou.

Cancelar uma excursão

O status Cancelada existe no sistema e dispara o webhook excursao.cancelada, mas no admin atual a transição direta para Cancelada acontece via fluxos específicos (ex: cancelamento em massa de reservas, ações administrativas). Para encerrar uma excursão que já aconteceu normalmente, use Finalizar. Para tirar do ar uma excursão que ainda não rodou e não vai mais acontecer, despublique e cancele individualmente as reservas pelo módulo de Passageiros.

Séries recorrentes (templates)

Excursões marcadas como série (template) não podem ser publicadas diretamente - elas servem só como molde para gerar ocorrências. Ao tentar publicar uma série, o sistema retorna o aviso "Esta é uma série recorrente e não pode ser publicada diretamente. Gere ocorrências em Séries Recorrentes." Acesse Séries Recorrentes pelo banner roxo no topo da edição.

Erros comuns e como resolver

• "Não é possível publicar. Falta configurar: veículo, ponto de embarque, categoria de passageiro, preço configurado." - Causa: a excursão está em Rascunho e não tem todos os itens obrigatórios ativos. Solução: abra a edição, vá nas abas Logística e Preços e cadastre/ative cada item listado na mensagem.
• "Você atingiu o limite de N excursões publicadas do seu plano. Faça upgrade para publicar mais excursões." - Causa: você já tem o número máximo de excursões com status Publicada. Solução: despublique uma excursão antiga ou abra Configurações > Plano para fazer upgrade.
• "Esta é uma série recorrente e não pode ser publicada diretamente. Gere ocorrências em Séries Recorrentes." - Causa: a excursão é um template de série e não aparece no site por design. Solução: clique em Gerenciar série no banner roxo e gere as ocorrências, que aí sim podem ser publicadas.
• "Status inválido." - Causa: tentativa de gravar um status fora dos quatro permitidos (rascunho, publicada, cancelada, finalizada). Solução: usar exclusivamente os botões da interface; não montar requisições manuais.

Onde encontrar

• URL: /admin/excursoes/{excursao}/edit
• URL alternativa (listagem): /admin/excursoes
• Endpoint da mudança: PATCH /admin/excursoes/{excursao}/status
• Caminho no menu: Excursões (item fixo)
• Permissão necessária: editar as viagens
• Módulo necessário: nenhum

Veja também

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