Passageiros - Cadastrar Passageiro

O que é

Esta é a tela usada para incluir manualmente um passageiro em uma excursão pelo painel administrativo. É o caminho mais comum quando a venda acontece no balcão, por telefone ou por WhatsApp, e o atendente precisa registrar a reserva sem passar pelo checkout público.

Ao salvar, o sistema cria automaticamente o pedido (Order), o registro do passageiro, o registro financeiro com plano de pagamento e, se a forma de pagamento for informada e o status for Confirmado, também registra o pagamento de uma vez. O usuário normalmente chega aqui depois de criar a excursão, configurar embarques, categorias, transportes e preços.

Como usar

1. Vá em Viagens > Excursões no menu lateral e abra a excursão desejada.
2. Clique na aba Passageiros (ou acesse direto /admin/excursoes/{excursao}/passageiros).
3. Clique em Adicionar Passageiro (botão verde no canto superior direito).
4. Selecione o cliente em Clique para selecionar um cliente:
   • Use o campo de busca para procurar por nome, CPF, telefone ou e-mail.
   • Se o cliente não existir, clique em Cadastrar novo cliente e preencha o formulário Cadastro Rápido de Cliente, depois confirme em Cadastrar e selecionar. Os campos exibidos seguem a configuração de Cadastros Personalizados (apenas campos marcados como visíveis no cadastro rápido aparecem).
5. Preencha os campos da reserva:
   • Embarque - local/horário de embarque. Obrigatório em excursões com transporte; opcional em Pacote de Viagem se não houver embarques configurados.
   • Categoria - define o preço aplicado. Habilita após escolher o embarque, quando houver.
   • Transporte - veículo onde o passageiro vai viajar. Habilita após escolher a categoria; opções esgotadas aparecem marcadas como ESGOTADO e ficam desabilitadas.
   • Assento - opcional. Clique em Clique para selecionar assento para abrir o mapa de assentos.
   • Valor - preenchido automaticamente a partir do preço cadastrado. Pode ser editado; se ficar diferente do esperado, um aviso amarelo é exibido com o valor configurado e a parcela.
   • Status - Pendente (sem cobrança imediata) ou Confirmado (registra o pagamento automaticamente ao salvar, se houver valor).
   • Vendedor - opcional. Atribui a venda a um vendedor/parceiro (só aparece se houver vendedores cadastrados ou se já houver um atribuído).
   • Observação - texto livre, até 500 caracteres.
6. Confirme em Adicionar. O botão de seta ao lado abre opções alternativas:
   • Adicionar e continuar - salva e mantém a modal aberta para revisar o mesmo passageiro.
   • Adicionar e criar novo - salva e limpa o formulário para cadastrar o próximo.
   • Adicionar e ir para reserva - salva e redireciona para a página de detalhes da reserva.

Casos especiais

Pacote de Viagem (sem transporte próprio)

Quando a excursão está marcada como Pacote de Viagem e não tem embarques nem transportes cadastrados, os campos Embarque, Transporte e Assento somem do formulário. A capacidade passa a ser controlada por Vagas Máximas da excursão (passageiros marcados como "não ocupa vaga", como bebês de colo, são desconsiderados).

Cliente já cadastrado na excursão

Se o cliente selecionado já tem reserva ativa nesta excursão, o sistema retorna um aviso vermelho "Este cliente já está cadastrado nesta excursão" e impede o salvamento.

Se a jornada do cliente da excursão permitir múltiplos assentos (configuração em Jornada do Cliente), aparece o botão Desbloquear e adicionar mesmo assim no topo da modal. Confirmando, o novo passageiro é adicionado como poltrona extra vinculada ao pedido existente do titular, consolidando o valor no financeiro da reserva atual.

Conversão da Lista de Espera

Quando o cadastro vem da Lista de Espera, um banner azul aparece no topo da modal: "Convertendo da Lista de Espera. Ao salvar, a entrada será marcada como convertida." A entrada original é fechada com status Convertido automaticamente após o salvamento.

Configuração incompleta

Se faltar Embarques, Transportes, Categorias ou Preços configurados (conforme o tipo da excursão), a modal mostra um bloco amarelo "Configuração incompleta" com links para cada item pendente e impede o cadastro até a configuração ser completada.

Vagas bloqueadas para venda online

Se a excursão tem vagas reservadas para uso administrativo, um aviso amarelo informa quantas estão bloqueadas e quantas estão livres para venda no site. Como administrador, o cadastro manual consome essas vagas bloqueadas normalmente.

Pagamento na hora do cadastro

Com Status = Confirmado e Valor > 0, o campo Forma de pagamento (avista, pix, cartao, boleto, dinheiro, transferência, cheque) é aplicado e o pagamento é registrado imediatamente no financeiro do passageiro e na Order. Com Status = Pendente, o sistema gera o plano de pagamento automático conforme as parcelas configuradas na excursão.

Erros comuns e como resolver

• "Este cliente já está cadastrado nesta excursão" - Causa: o cliente já tem reserva ativa (status diferente de cancelado/transferido) nessa excursão. Solução: edite a reserva existente; ou, se a jornada do cliente permitir múltiplos assentos, use Desbloquear e adicionar mesmo assim para criar poltrona extra.
• "Não existe preço configurado para a combinação de embarque e categoria selecionada. Configure o preço antes de adicionar passageiros." - Causa: a matriz de preços não cobre o par embarque+categoria escolhido. Solução: vá em Editar Excursão > Preços e cadastre o preço da combinação.
• "O assento {n} já está ocupado neste veículo. Selecione outro assento." - Causa: outro passageiro foi inserido naquele assento entre a abertura da modal e o clique em Adicionar. Solução: escolha outro assento no mapa.
• "Veículo '{nome}' esgotado! Capacidade de {n} passageiros atingida. Selecione outro veículo ou use 'Lista de Espera'." - Causa: o transporte selecionado bateu a capacidade. Solução: escolha outro veículo, aumente a capacidade do transporte, ou cadastre o cliente na Lista de Espera.
• "O veículo '{nome}' está lotado. Aumente a capacidade ou escolha outro transporte." - Causa: trava extra de capacidade aplicada dentro da transação (evita corrida entre duas inclusões simultâneas). Solução: igual à anterior.
• "Pacote esgotado! Capacidade de {n} vagas atingida." - Causa: em Pacote de Viagem, o total de vagas máximas foi atingido. Solução: ajuste Vagas Máximas na edição da excursão ou cancele alguma reserva.
• "Já existe um cliente cadastrado com este CPF." / "Já existe um cliente cadastrado com este e-mail." - Causa: o Cadastro Rápido detectou duplicidade. Solução: cancele o cadastro rápido, volte à busca e selecione o cliente existente.
• "Já existe(m) cliente(s) com este telefone: {nomes}" - Aviso amarelo (não bloqueia). Confirme se realmente é um cliente novo antes de prosseguir.

Onde encontrar

• URL: /admin/excursoes/{excursao}/passageiros
• Caminho no menu: Viagens > Excursões > (abrir excursão) > Passageiros
• Permissão necessária: ver as viagens (visualizar a aba) e editar as viagens (incluir passageiros)
• Módulo necessário: nenhum

Veja também

• Visão Geral dos Passageiros
• Status do Passageiro
• Assentos e Acomodações
• Financeiro do Passageiro
• Convites e Links de Confirmação