Passageiros - Visão Geral

O que é

A página de Passageiros é o painel operacional de uma excursão específica. Ela lista todas as pessoas vinculadas àquela viagem - confirmadas, pendentes, canceladas, transferidas e no show - agrupadas por transporte e, dentro de cada transporte, por embarque. É aqui que a equipe de atendimento, operação e financeiro coordena o dia a dia da reserva: cadastrar quem vai viajar, conferir saldo, mudar status, enviar voucher e preparar o embarque.

O usuário costuma chegar aqui logo após criar uma excursão (para começar a vender), no dia anterior à viagem (para conferir lista e enviar cartões de embarque) e ao longo do tempo para registrar pagamentos, aplicar descontos ou cancelar reservas. A página também aceita o parâmetro ?converter_le={id} para converter um inscrito da lista de espera em passageiro real, pré-preenchendo o modal de cadastro.

Como usar

1. Vá em Excursões no sidebar e abra a excursão desejada.
2. Use o menu de navegação da excursão (componente x-excursao-nav) e selecione a aba Passageiros - você cai em "/admin/excursoes/{excursao}/passageiros".
3. Confira o bloco de estatísticas no topo: Total de Vagas, Ocupadas (passageiros + guias), Disponíveis (com aviso de vagas bloqueadas para venda online, quando houver) e percentual de Ocupação.
4. Expanda o Resumo Financeiro (visível para quem tem permissão de ver o financeiro) para ver Total Esperado, Recebido, A Receber, Pagos, Pendentes e a barra de progresso de recebimento.
5. Aplique filtros na barra de filtros para refinar a lista:
   • Buscar: nome, CPF ou telefone do passageiro (também busca pelo cliente vinculado).
   • Status: confirmado, pendente, lista de espera, cancelado, transferido ou no show. Por padrão, cancelados ficam ocultos.
   • Embarque: filtra pelo ponto de embarque escolhido.
   • Variação: aparece somente quando a excursão é do tipo Pacote de Viagem.
   • Financeiro: pago, parcial ou pendente.
   • Responsável: lista compradores que possuem dependentes nesta excursão.
   • Filtrar por tags: tags do tipo Reserva.
6. Para cadastrar uma nova reserva, clique em Adicionar Passageiro (botão verde no canto direito).
7. Em cada linha da lista, use o dropdown de ações para operar o passageiro (Cartão de Embarque, Enviar acesso ao portal, Registrar Pagamento, Aplicar Desconto, Aplicar Acréscimo, Reembolsar, Transferir, Cancelar).

Como usar - fluxos detalhados

Cada bloco abaixo aprofunda uma das ações disponíveis no painel:

• Cadastrar passageiro: ver Passageiros - Cadastrar ([passageiros-criar]).
• Cancelar ou transferir reserva: ver Cancelamento e Transferência ([passageiros-ação-cancelar-transferir]).
• Check-in e cartão de embarque: ver Check-in e Embarque ([passageiros-ação-checkin-embarque]).
• Convites e link mágico do portal: ver Convites e Links de Confirmação ([passageiros-ação-convites]).
• Mapa de assentos e acomodações: ver Assentos e Acomodações ([passageiros-ação-assentos]).
• Documentos obrigatórios: ver Documentos e Requisitos ([passageiros-sub-documentos]).
• Saldo, descontos e pagamentos: ver Financeiro do Passageiro ([passageiros-sub-financeiro]).
• Status do passageiro: ver Status do Passageiro ([passageiros-sub-status]).
• Voucher e QR Code: ver Voucher e QR Code ([passageiros-ação-voucher]).

Casos especiais

Excursão tipo Pacote de Viagem

Pacotes de Viagem não têm transporte associado. O painel cria um "transporte virtual" chamado Passageiros (Pacote de Viagem) para agrupar a lista, e o filtro Variação passa a aparecer para segmentar por variação ativa do pacote.

Passageiros sem transporte em excursão com transporte

Quando uma excursão tem transportes mas um passageiro está sem transporte atribuído (caso órfão), ele é listado em um bloco virtual chamado Passageiros sem transporte, com os mesmos filtros aplicados.

Conversão da Lista de Espera

Ao acessar a URL com ?converter_le={id} (vinda do módulo Lista de Espera), o modal de cadastro abre pré-preenchido com os dados do inscrito. Se houver cliente com o mesmo e-mail, ele já é vinculado automaticamente.

Vagas bloqueadas para venda online

Se a excursão tem vagas reservadas (vagas_reservadas > 0), aparece um aviso âmbar logo abaixo das estatísticas informando quantas vagas estão bloqueadas para o site público e quantas restam para venda online. O administrador continua podendo usar essas vagas bloqueadas para cadastrar manualmente.

Cancelados ocultos

Sem filtro de status aplicado, passageiros cancelados não aparecem. O contador canceladosCount fica disponível para sinalizar quantos existem; para visualizá-los, selecione Cancelado no filtro de Status.

Dependentes e Responsáveis

Passageiros com dependente_id preenchido são considerados dependentes de um comprador. O botão Responsáveis abre um relatório de quem é responsável por quem nesta excursão; o filtro Responsável mostra apenas os dependentes daquele comprador.

Erros comuns e como resolver

• "Excursão lotada" - Causa: tentou adicionar passageiro acima da capacidade. Solução: libere uma vaga (cancelar/transferir outro passageiro) ou aumente a capacidade do transporte; como admin, vagas bloqueadas para venda online podem ser usadas manualmente.
• Resumo Financeiro não aparece - Causa: usuário não tem a permissão de ver o financeiro. Solução: ajuste o papel no RBAC.
• Botão "Transferir p/ outra Excursão" sumiu - Causa: o passageiro já fez check-in ou não atende a podeTransferir(). Solução: a transferência só é possível antes do embarque; cancele a reserva e crie uma nova na excursão destino, se necessário.
• Botão "Responsáveis" não aparece - Causa: a excursão não tem dependentes cadastrados. Solução: o botão só renderiza quando existem compradores com dependentes nesta excursão.
• Filtro de Variação ausente - Causa: a excursão não é do tipo Pacote de Viagem. Solução: o filtro só existe em excursões com tipo_excursao = pacote_viagem.

Onde encontrar

• URL: /admin/excursoes/{excursao}/passageiros
• Caminho no menu: Excursões > {Excursão} > Passageiros (aba do menu interno da excursão)
• Permissão necessária: ver as viagens (ações financeiras exigem ver o financeiro; cadastro exige criar as reservas)
• Módulo necessário: nenhum (módulo core)

Veja também

• Cadastrar Passageiro
• Cancelamento e Transferência
• Check-in e Embarque
• Convites e Links de Confirmação
• Assentos e Acomodações
• Documentos e Requisitos
• Financeiro do Passageiro
• Status do Passageiro
• Voucher e QR Code