Excursões - Atribuir Guias

O que é

Esta página concentra a escala da equipe de uma excursão. A partir do bloco Guias / Equipe dentro da edição da excursão (ou do wizard de criação), você vincula um ou mais guias já cadastrados, define a função de cada um, o veículo em que vai viajar, o ponto de embarque e, opcionalmente, a poltrona reservada.

O fluxo é normalmente percorrido logo depois de cadastrar os transportes e os pontos de embarque da excursão. A mesma seção é reutilizada nas excursões com transporte e nos pacotes de viagem (sem transporte), mudando apenas a obrigatoriedade do campo de veículo.

Como usar

1. Abra a excursão em Viagens > [Excursão desejada] > Editar e role até o bloco Guias / Equipe (ícone de grupo de pessoas).
2. Clique em Adicionar (botão azul no topo do bloco, ao lado do contador). Se ainda não houver guias vinculados, o mesmo efeito é obtido pelo link Adicionar guia que aparece no centro do bloco.
3. Em Selecione o Guia, escolha um dos cartões da lista. Só aparecem guias ativos e que ainda não estão vinculados a esta excursão.
4. Preencha os campos:
   • Veículo/Transporte - obrigatório nas excursões com transporte. A lista mostra modelo e placa de cada transporte cadastrado na excursão. Em pacotes de viagem este campo fica oculto.
   • Ponto de Embarque - opcional. A lista é filtrada pelo veículo escolhido (apenas embarques sem transporte vinculado ou do mesmo transporte aparecem).
   • Poltrona - opcional. Clique em Selecionar para abrir o Mapa de Assentos e escolher visualmente. A poltrona escolhida fica bloqueada para os passageiros.
   • Função na excursão - escolha um cargo cadastrado em Configurações > Cargos (ex.: Guia Principal, Guia Auxiliar, Monitor).
   • Observação - texto livre de até 500 caracteres para anotações internas.
5. Clique em Adicionar (ou Salvar, em modo edição) no rodapé do modal. O guia passa a aparecer na lista com avatar, nome, função, veículo, embarque e poltrona.

Casos especiais

Guia ocupa (ou não) uma vaga do transporte

Na edição da excursão, o bloco Guias Ocupam Vagas controla a flag guias_contam_vaga. Quando o toggle está ativado (padrão), cada guia vinculado a um transporte ocupa 1 vaga desse transporte e entra na conta de vagas ocupadas exibida na excursão, no carrinho e no trigger anti-overbooking do banco. Desative apenas se os guias viajam em pé ou junto ao motorista - caso contrário a venda pode ser bloqueada por estouro de capacidade. O bloco fica oculto em pacotes de viagem.

Selecionar poltrona pelo mapa visual

Ao clicar em Selecionar na linha Poltrona, abre o modal Selecionar Poltrona do Guia. A legenda diferencia assentos Disponível (azul), Ocupado (vermelho), Guia (âmbar) e Selecionado (verde). Veículos com layout configurado mostram o desenho do ônibus com tabs por andar; veículos sem layout caem para um grid simples numerado. O botão Sem assento zera o campo e fecha o modal.

Editar um vínculo existente

Clique no ícone lápis ao lado do guia. O modal abre como Editar Guia e o seletor de guia some - só é possível alterar veículo, embarque, poltrona, função e observação. Para trocar de pessoa, remova e adicione novamente.

Remover um guia da excursão

Clique no ícone lixeira ao lado do guia e confirme. O guia é apenas desvinculado desta excursão, sem ser excluído do cadastro central de Guias.

Pacote de viagem (sem transporte)

Em excursões com tipo pacote_viagem o campo Veículo/Transporte desaparece e deixa de ser obrigatório, pois não há ônibus. A flag guias_contam_vaga também não se aplica.

Erros comuns e como resolver

• "Este guia já está vinculado a esta excursão" - Causa: tentativa de adicionar o mesmo guia duas vezes. Solução: use Editar no vínculo existente em vez de criar outro.
• "Este assento já está ocupado" - Causa: a poltrona escolhida já foi reservada por um passageiro ou por outro guia. Solução: abra o mapa novamente e escolha um assento azul (Disponível).
• "Transporte não pertence a esta excursão" - Causa: o transporte selecionado foi removido da excursão antes de salvar. Solução: feche o modal, recarregue a página e refaça a vinculação.
• "Nenhum transporte cadastrado na excursão. Cadastre um transporte primeiro." - Causa: a excursão não tem nenhum veículo cadastrado. Solução: cadastre o transporte no bloco Transportes antes de vincular o guia.
• "Nenhum guia disponível" - Causa: todos os guias ativos já estão vinculados a esta excursão, ou não há guias cadastrados. Solução: cadastre um novo guia pelo link Cadastrar novo guia ou ative guias existentes em Cadastros > Guias.

Onde encontrar

• URL: /admin/excursoes/{excursao}/edit - bloco Guias / Equipe dentro da página de edição da excursão (ou no wizard de criação).
• Caminho no menu: Viagens > [Excursão desejada] > Editar > Guias / Equipe.
• 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
• Gerenciar Transportes
• Pontos de Embarque
• Wizard de Criação de Excursão