Excursões - Gerenciar Transportes

O que é

Esta página concentra a frota de uma excursão. A partir do bloco Veículos dentro da edição da excursão (ou do wizard de criação), você vincula ônibus, vans e micro-ônibus do cadastro central de Veículos, ou cria transportes genéricos sem veículo (útil quando a transportadora ainda não confirmou qual ônibus vai operar a viagem).

O fluxo é normalmente percorrido logo no início da montagem da excursão, antes de cadastrar pontos de embarque e escalar guias, pois a soma das capacidades define o total de vagas disponíveis para venda e alimenta o controle anti-overbooking. O mesmo bloco é reaproveitado no wizard de criação e na página de gestão do pacote de viagem.

Como usar

1. Abra a excursão em Viagens > [Excursão desejada] > Editar e role até o bloco Veículos (ícone de caminhão).
2. Clique em Adicionar (botão azul no topo do bloco, ao lado do contador). Se ainda não houver veículos vinculados, o mesmo efeito é obtido pelo link Adicionar veículo exibido no centro do bloco.
3. Escolha a forma de cadastro nas abas do modal Adicionar Transporte:
   • Selecionar Veículo - lista os veículos ativos cadastrados em Cadastros > Veículos que ainda não estão vinculados a esta excursão. Use o campo de busca por modelo, placa ou empresa quando houver mais de 3 opções. Veículos em conflito de datas com outra excursão aparecem em vermelho e ficam desabilitados.
   • Sem Veículo - preencha:
     • Nome (obrigatório) - texto livre, ex.: "Ônibus 1", "A Confirmar".
     • Tipo - Van, Micro-ônibus, Ônibus, Ônibus Leito, Ônibus Semi-leito, Ônibus Executivo, Ônibus Double Decker, Minivan ou Carro.
     • Vagas (obrigatório) - capacidade total. Os assentos dos guias são descontados automaticamente quando a flag de guias ocupar vaga estiver ativa.
4. Confirme em Adicionar (aba Sem Veículo) ou clique direto no cartão do veículo desejado (aba Selecionar Veículo). O transporte aparece na lista com foto, modelo, capacidade, placa e transportadora.
5. Acompanhe no rodapé do bloco o Total de vagas somado e o contador de Passageiros cadastrados (verde quando há folga, vermelho quando atinge ou ultrapassa a capacidade).

Casos especiais

Vincular motorista da transportadora

Se o veículo cadastrado pertence a uma transportadora, aparece uma linha de motorista abaixo do veículo:

• Com 1 motorista disponível, surge o link Vincular motorista: [Nome] para vínculo rápido.
• Com 2 ou mais disponíveis, aparece um select para escolher.
• Já vinculado, aparece o nome com botões Trocar e X (para remover o vínculo).
• Se todos os motoristas da transportadora já estão em uso por outros veículos da mesma excursão, aparece o aviso "Todos os motoristas desta transportadora já estão em uso em outros veículos".

O mesmo motorista não pode ser vinculado a dois veículos da mesma excursão. Para veículos genéricos (sem veículo cadastrado) ou veículos sem transportadora, a linha de motorista não aparece.

Trocar o veículo mantendo os passageiros

Use o ícone seta circular ao lado do veículo. No modal Trocar Veículo, escolha o novo veículo. O sistema mostra um aviso se há passageiros a transferir e:

• Mantém o mesmo número de assento sempre que possível.
• Se o novo veículo tem capacidade menor que algum assento atual, o sistema avisa antes (status HTTP 409 orphan_seats) e lista os passageiros afetados. Ao confirmar, esses passageiros ficam sem assento e precisam ser realocados manualmente no Mapa de Assentos.

A troca atualiza automaticamente o vagas_total para a capacidade do novo veículo.

Vincular veículo a um transporte criado sem veículo

Transportes adicionados pela aba Sem Veículo mostram o ícone de elo (em vez da seta circular). Ao clicar, o mesmo modal de troca é aberto e o veículo escolhido passa a ser vinculado ao transporte existente, preservando os passageiros já cadastrados.

Editar nome, tipo e vagas (apenas sem veículo)

O ícone de lápis aparece somente em transportes criados sem veículo cadastrado. O modal Editar Transporte permite alterar nome, tipo e quantidade de vagas. Para transportes com veículo vinculado, esses dados são herdados do cadastro central de Veículos e só podem ser alterados lá.

Conflito de datas entre excursões

Ao listar veículos disponíveis, o sistema cruza as datas da excursão atual com as datas das demais excursões ativas (exceto canceladas, finalizadas e arquivadas). Veículos vinculados a outra excursão com datas sobrepostas aparecem com fundo vermelho, o ícone X e o texto "Em uso: [Nome da Excursão]", e não podem ser selecionados.

Erros comuns e como resolver

• "Este veículo já está vinculado a esta excursão" - Causa: tentativa de adicionar o mesmo veículo duas vezes. Solução: use Trocar ou cadastre um veículo diferente.
• "Este veículo já está em uso na excursão '[Nome]' nas mesmas datas." - Causa: conflito de datas com outra excursão ativa. Solução: ajuste as datas, cancele a outra excursão ou cadastre outro veículo.
• "Informe o nome e a quantidade de vagas" - Causa: cadastro pela aba Sem Veículo sem preencher Nome ou Vagas. Solução: complete os dois campos antes de confirmar.
• "Não é possível remover este veículo pois há N passageiro(s) cadastrado(s). Use a opção 'Trocar' para transferir os passageiros para outro veículo." - Causa: há passageiros confirmados ou pendentes alocados nesse veículo. Solução: clique em Trocar veículo para transferir os passageiros, ou mova-os manualmente para outro veículo antes de remover.
• "Não é possível remover este veículo pois há N passageiro(s) vinculado(s) aos seus pontos de embarque exclusivos." - Causa: o veículo tem pontos de embarque exclusivos com passageiros já vinculados. Solução: realoque os passageiros para outro embarque antes de remover o veículo.
• "Este motorista já está vinculado ao [veículo] nesta excursão." - Causa: o mesmo motorista não pode operar dois veículos na mesma excursão. Solução: escolha outro motorista ou remova o vínculo do veículo anterior.
• "Veículo sem empresa de transporte vinculada." - Causa: tentativa de vincular motorista a um veículo cujo cadastro central não tem transportadora associada. Solução: edite o veículo em Cadastros > Veículos e associe a transportadora.
• "Nenhum veículo disponível" - Causa: todos os veículos ativos já estão vinculados a esta excursão (ou em conflito de datas), ou não há veículos cadastrados. Solução: cadastre um novo veículo pelo link Cadastrar novo veículo dentro do modal.

Onde encontrar

• URL: /admin/excursoes/{excursao}/transportes
  • bloco Veículos dentro da edição da excursão (também acessível por /admin/excursoes/{excursao}/edit#veiculos e pelo wizard de criação).
• Caminho no menu: Viagens > [Excursão desejada] > Editar > Veículos.
• Permissão necessária: editar as viagens.
• Módulo necessário: nenhum (faz parte do módulo core de Excursões).

Veja também

• Visão Geral das Excursões
• Atribuir Guias
• Pontos de Embarque
• Gerenciar Passageiros
• Wizard de Criação de Excursão