Excursões - Gerenciar Passageiros

O que é

A página de Passageiros é a lista central de quem está inscrito em uma excursão específica. Ela mostra os passageiros agrupados por transporte e, dentro de cada transporte, por ponto de embarque - replicando a ordem real da operação no dia da viagem. Para excursões do tipo Pacote de Viagem (sem transporte), os passageiros aparecem em um bloco único identificado como "Passageiros (Pacote de Viagem)".

O atendente normalmente chega aqui logo depois que a excursão é criada (para incluir manualmente as primeiras vendas) e volta diversas vezes durante o ciclo de vida: para confirmar inscrições, registrar pagamentos, aplicar descontos, transferir de excursão, cancelar reservas e gerar o cartão de embarque. No dia da viagem, o operador costuma migrar para a tela de Checklist - esta página continua sendo o "manifest" oficial da venda.

Como usar

1. No sidebar, abra Viagens (Excursões), clique na excursão desejada e, no menu Outras páginas logo abaixo do cabeçalho, escolha Passageiros. A URL é /admin/excursoes/{excursao}/passageiros.

2. Confira os cards de estatísticas no topo:

   • Total de Vagas - capacidade somada dos transportes ativos.
   • Ocupadas - passageiros confirmados/pendentes + guias.
   • Disponíveis - vagas livres no total e quantas estão liberadas para venda online (quando há vagas bloqueadas).
   • Ocupação - percentual com sinalização de cor (verde, amarelo ou vermelho).

3. Use o painel colapsável Resumo Financeiro (visível para quem tem ver o financeiro) para ver totais de Recebido, A Receber, Pendentes, Pagos e a barra de Progresso de Recebimento da excursão.

4. Abra o Mapa de Assentos (painel colapsável) para visualizar a ocupação por veículo. As cores indicam Disponível, Ocupado, Motorista, Guia e Reservado. Quando o veículo tem mais de um andar, surgem abas por andar. Clique em uma poltrona ocupada para abrir o popover com nome, telefone, embarque, categoria e status. Clique em uma poltrona livre para abrir Atribuir poltrona e vincular um passageiro sem assento (use o campo Buscar por nome ou CPF...). Use Exportar mapa em PDF ou Etiquetas nas ações do painel.

5. Refine a listagem com a barra de filtros logo abaixo:

   • Buscar por nome, CPF ou telefone... - texto livre, busca também pelos dados do cliente vinculado.
   • Status - Confirmado, Pendente, Cancelado (com badge da quantidade) ou Todos (exceto cancelados).
   • Embarque - restringe a um ponto de embarque.
   • Variação - só aparece em Pacote de Viagem com variações ativas.
   • Financeiro - Pago, Parcial ou Pendente.
   • Responsável - só aparece quando existem dependentes; filtra pelos compradores que carregam dependentes.
   • Filtrar por tags - múltipla seleção das tags de reserva.

6. Use Expandir Todos / Recolher Todos acima da lista para abrir ou fechar todos os transportes e embarques de uma vez. Cada cabeçalho azul de embarque também é clicável para colapsar individualmente.

7. Adicione um passageiro manualmente clicando em Adicionar Passageiro (botão verde no canto superior direito da barra de ações). Selecione o cliente (autocomplete por nome, CPF, telefone ou e-mail), escolha Embarque, Categoria e Transporte, defina o Status (Confirmado ou Pendente), informe Valor cobrado, opcional Vendedor, Forma de Pagamento e Assento. Confirme em Salvar. Quando o status é Confirmado e existe valor, o sistema já registra o pagamento automaticamente na conta padrão.

8. Em cada linha de passageiro, clique no botão de três pontos (Ações) à direita para abrir o menu com:

   • Editar - abre o modal de edição de embarque, categoria, transporte, assento, valor, vendedor e status.
   • Trocar Transporte - só aparece quando a excursão tem mais de um transporte e o passageiro não está cancelado/transferido.
   • Ver Reserva - abre a reserva completa (requer criar as reservas).
   • Cartão de Embarque - abre o voucher público em nova aba.
   • Enviar acesso ao portal - gera um link mágico de acesso.
   • Prorrogar convite (+48h) - só aparece para passageiros com convite pendente.
   • Registrar Pagamento, Ver Histórico, Aplicar Desconto, Aplicar Acréscimo, Reembolsar - disponíveis para quem tem ver o financeiro.
   • Transferir p/ outra Excursão - só aparece quando o passageiro pode ser transferido e ainda não fez check-in.
   • Cancelar - para passageiros ativos.
   • Excluir - só aparece para passageiros já cancelados e sem vínculo financeiro.

9. Para registrar um pagamento manual, clique em Registrar Pagamento, informe Valor (ou clique em Preencher total para usar o pendente), selecione Forma de Pagamento (PIX, Dinheiro, Cartão de Crédito, Cartão de Débito, Transferência, Boleto, Cheque), ajuste a Data e opcionalmente a Observação, e confirme em Registrar Pagamento.

10. Para cancelar um passageiro, escolha Cancelar no menu Ações e informe o motivo obrigatório (até 500 caracteres). O sistema libera o quarto de hospedagem vinculado (se houver), recalcula o valor total do pedido e invalida o contrato do grupo do comprador.

Casos especiais

Cliente já cadastrado na excursão

Ao tentar adicionar um passageiro cuja venda já existe na excursão, aparece Este cliente já está cadastrado nesta excursão. Quando o empresa ativa o modo Múltiplos assentos por cliente na Jornada do Cliente, o admin pode confirmar e o sistema adiciona uma poltrona extra ao mesmo pedido (assento adicional, financeiro consolidado no titular).

Pacote de Viagem (sem transporte)

Quando tipo_excursao = pacote_viagem, o bloco principal vira Passageiros (Pacote de Viagem) e os campos de embarque, transporte e assento ficam opcionais. A capacidade é controlada por vagas_maximas global, não por veículo.

Vagas bloqueadas para venda online

Se existem vagas reservadas, aparece um aviso âmbar com X vaga(s) bloqueada(s) para venda online logo abaixo das estatísticas. O admin continua podendo adicionar passageiros usando essas vagas - o bloqueio só afeta o site público.

Conversão direto da Lista de Espera

Quando o link Lista de Espera envia o admin com ?converter_le={id}, o modal de novo passageiro abre pré-preenchido com os dados da pessoa que estava aguardando. Após salvar, a entrada da lista de espera é marcada como convertido.

Bebê de colo e dependentes

Passageiros marcados como Bebê de colo mostram o badge rosa e não ocupam vaga no cálculo de capacidade. Dependentes aparecem com badge roxo e linha extra "Responsável: {nome do comprador}". Convidados trazidos por outro comprador exibem "Convidado por: {nome}".

Origem da reserva

Cada linha mostra a origem da venda em um badge: Site (vendas pelo checkout ou convite por link), Admin (cadastro manual no painel) ou Link Pendente (convite enviado mas ainda não preenchido). O código do Pedido # e do Embarque # ficam logo abaixo do nome.

Excluir definitivamente

A opção Excluir só aparece para passageiros já cancelados E sem financeiro vinculado. Para os demais, use Cancelar - a operação preserva o histórico contábil.

Passageiros sem transporte em excursão com transporte

Passageiros órfãos (sem transporte_id) aparecem em um bloco virtual roxo identificado como Passageiros sem transporte, com os mesmos filtros aplicados. Use o botão Trocar Transporte ou edite o passageiro para vinculá-lo a um veículo.

Erros comuns e como resolver

• "Este cliente já está cadastrado nesta excursão" - Causa: o cliente já tem um passageiro ativo na excursão. Solução: edite o passageiro existente; se realmente precisa de outra poltrona, ative Múltiplos assentos por cliente em Configurações > Jornada do Cliente e confirme a duplicação.

• "Pacote esgotado! Capacidade de {N} vagas atingida." - Causa: Pacote de Viagem atingiu o limite global de vagas_maximas. Solução: ajuste vagas_maximas na edição da excursão ou cancele uma reserva para liberar vaga.

• "Veículo '{nome}' esgotado! Capacidade de {N} passageiros atingida." - Causa: o transporte selecionado está cheio. Solução: escolha outro transporte, aumente a capacidade do veículo ou use Lista de Espera.

• "O assento {N} já está ocupado neste veículo." - Causa: outro passageiro já está no mesmo assento. Solução: escolha outra poltrona no Mapa de Assentos.

• "Não existe preço configurado para a combinação de embarque e categoria selecionada." - Causa: a tabela de preços não cobre a combinação. Solução: cadastre o preço em Categorias e Preços antes de adicionar o passageiro.

• "Passageiro não pertence a esta excursão" - Causa: tentativa de agir sobre um passageiro de outra excursão (link antigo, recarga manual de URL). Solução: volte à listagem da excursão correta.

• "Apenas passageiros cancelados podem ser excluídos. Cancele primeiro." - Causa: tentou excluir um passageiro ativo. Solução: cancele primeiro e depois exclua.

• "Não é possível excluir passageiro com financeiro vinculado." - Causa: existem pagamentos/registros financeiros ligados. Solução: mantenha cancelado (preserva o histórico) ou ajuste o financeiro antes de excluir.

Onde encontrar

• URL: /admin/excursoes/{excursao}/passageiros
• Caminho no menu: Viagens (Excursões) > abrir a excursão > Outras páginas > Passageiros
• Permissão necessária: ver as viagens (ações financeiras exigem ver o financeiro; adicionar passageiro consome criar as reservas no autocomplete de clientes)
• Módulo necessário: nenhum (núcleo do produto)

Veja também

• Excursões - Check-in de Passageiros
• Checklist de Embarque
• Financeiro da Excursão
• Gerenciar Transportes
• Pontos de Embarque