Excursões - Séries Recorrentes

O que é

Séries Recorrentes é onde ficam as viagens marcadas como "se repete". Em vez de você cadastrar a mesma viagem toda semana à mão, com o mesmo ônibus, os mesmos pontos de embarque e os mesmos preços, você configura uma vez e o sistema passa a criar as próximas saídas sozinho, seguindo os dias da semana que você escolheu.

Você chega aqui de dois jeitos: pelo link Voltar para Viagens que aparece no topo desta própria tela, ou clicando em uma série específica a partir desta lista. A série em si é só o molde: ela não vende, não aparece no seu site e não recebe passageiro. Quem vende são as saídas geradas a partir dela, cada uma uma viagem completa e independente.

Como usar

1. No menu lateral, abra uma viagem existente em Viagens e edite a viagem que vai virar o molde da série.
2. No formulário de edição, ative o cartão Recorrência (Série) e marque Sim, é uma série.
3. Escolha os dias da semana em que a viagem sai (pode marcar mais de um, como terça e quinta), o intervalo (toda semana, a cada 2, 3 ou 4 semanas), quantas saídas manter à frente no calendário e se cada saída nasce como Rascunho ou já Publicada.
4. Salve. A partir daí, essa viagem some da listagem normal de Viagens e passa a aparecer em Séries Recorrentes.
5. Volte para Séries Recorrentes para acompanhar: cada linha mostra o nome da série, se está Ativa ou Pausada, os dias configurados, a data da próxima saída e quantas saídas já foram geradas no total.
6. Clique na série para abrir o detalhe. Lá você pode:
   • Pausar série ou Reativar série, para ligar e desligar a geração automática sem perder nada do que já foi configurado.
   • Gerar próxima agora, se não quiser esperar a próxima execução automática do sistema.
   • Editar configuração, que leva de volta à tela de edição da viagem molde, para trocar dias, preços, embarques ou qualquer outro dado.
   • Ver a lista de Ocorrências geradas, com o status de cada saída, e clicar em Abrir para entrar em qualquer uma delas.

O que você precisa saber antes

• Viagem com passageiro não vira série. Se a viagem já tem alguém confirmado ou pendente, o cartão de recorrência mostra um aviso em vez do formulário, com o botão Clonar Viagem. O clone nasce sem nenhum passageiro e é nele que você ativa a recorrência. Essa regra é reforçada no servidor: mesmo forçando o envio do formulário, o sistema recusa e devolve a mesma mensagem.
• A geração automática roda uma vez por dia, de madrugada. Se você acabou de configurar a série e quer ver uma saída aparecendo agora, use Gerar próxima agora em vez de esperar.
• A saída nasce com tudo que a viagem molde tinha na hora da geração: ônibus, pontos de embarque, categorias de passageiro, preços, guias, conteúdo (como rascunho, para revisar) e fotos. Depois de gerada, a saída é uma viagem independente - editar a série depois não muda saídas já criadas, só afeta as próximas a serem geradas.
• Se a saída deveria ser Publicada mas você já atingiu o limite de viagens publicadas do seu plano, ela nasce como Rascunho mesmo assim, e a tela avisa isso. Ninguém compra uma viagem em rascunho, então vale conferir a lista de ocorrências de vez em quando se você está perto do limite do plano.
• Pausar a série não apaga nem cancela nada. As saídas já geradas continuam exatamente como estavam, com seus passageiros e pagamentos intactos. Pausar só impede que novas saídas sejam criadas até você reativar.
• Antes de aparecer o formulário de recorrência, a viagem precisa estar minimamente pronta: veículo, ponto de embarque, categoria de passageiro e preço cadastrados (pacote de viagem, que não tem transporte próprio, pede limite de vagas no lugar de veículo e embarque). Sem isso, a tela mostra o que ainda falta em vez do formulário, para nenhuma saída nascer incompleta.
• Pacote de viagem não vira série. A opção de recorrência não fica disponível para viagens do tipo pacote (aquelas em que o cliente vai por conta própria, sem transporte contratado por você).

Casos especiais

Série sem nenhuma saída gerada ainda

Se você acabou de criar a série e a geração automática ainda não rodou, a lista de Ocorrências geradas aparece vazia, com a instrução de usar Gerar próxima agora ou aguardar o horário automático do sistema.

Nenhuma série cadastrada

Quando você ainda não transformou nenhuma viagem em série, a tela mostra uma mensagem explicando o caminho: edite uma viagem existente e ative o cartão Recorrência.

Configuração incompleta

Se a série foi salva sem os dias da semana marcados, a página de detalhe avisa que a configuração está incompleta e nenhuma saída nova será gerada até você voltar em Editar configuração e marcar pelo menos um dia.

Erros comuns

• "Esta série está pausada. Reative para gerar ocorrências." - Causa: você tentou usar Gerar próxima agora com a série pausada. Solução: clique em Reativar série primeiro.
• "Configuração de recorrência incompleta." - Causa: a série não tem dias da semana definidos. Solução: entre em Editar configuração e marque ao menos um dia.
• "Esta excursão já possui passageiros cadastrados. Para criar uma série recorrente, primeiro clone esta excursão e ative a recorrência no clone."
  • Causa: você tentou ativar a recorrência numa viagem que já tem gente inscrita. Solução: use o botão Clonar Viagem, disponível na própria tela de edição, e configure a série a partir do clone.

Onde encontrar

• URL da lista: /admin/excursoes/series
• URL do detalhe de uma série: /admin/excursoes/series/{numero-da-serie}
• Caminho: menu Viagens, depois link Séries Recorrentes dentro da tela de edição de uma viagem, ou pelo card informativo da listagem de viagens
• Permissão necessária: ver, editar e criar viagens
• Nenhum módulo adicional é necessário

Veja também

• Visão geral de Excursões
• Editar a viagem
• Criar uma viagem
• Publicar e encerrar a viagem