Passageiros
Cadastre os clientes que viajam ou enviam encomendas, com a lista de documentos usada nas passagens e nos comprovantes.
A tela de Passageiros centraliza o cadastro dos clientes da operação. Toda passagem precisa de um passageiro vinculado: sem cadastro, não há reserva.
Passageiro não é usuário do sistema. Os usuários são os operadores que acessam a pulvo. (consulte Usuários e Perfis). Os passageiros são os clientes que embarcam nas viagens: eles não têm senha nem acesso à plataforma.
Onde encontrar
Menu lateral → Operação → Passageiros. URL direta: /management/customers.
Permissões necessárias
| Ação | Permissão exigida |
|---|---|
| Visualizar a tela | customers.read |
| Criar / editar | customers.edit |
| Excluir | customers.delete |
Sem customers.edit, o botão Novo passageiro e o ícone de edição deixam de
ser exibidos. Sem customers.delete, o ícone de exclusão não é exibido.
A tela em um relance
Passageiros
AjudaCadastro de clientes que viajam ou recebem encomendas pela sua frota.
Da esquerda para a direita, de cima para baixo:
- Cabeçalho com título, botão Ajuda, descrição e o botão Novo passageiro.
- Busca, com o total de resultados ao lado.
- Tabela com avatar, nome, documento principal, contato e ações.
- Rodapé com a contagem, no formato "Mostrando N de TOTAL passageiros".
Buscar
A busca é feita no servidor e considera nome, documento, telefone e e-mail, sem diferenciar acentos. Ela é aplicada a partir de 3 caracteres; com menos, a lista completa é apresentada. A formatação do documento é indiferente: digite apenas os números.
A lista carrega mais passageiros conforme a rolagem, o que substitui a paginação numerada. Por isso não há ordenação alfabética geral: as linhas seguem a ordem do servidor, e a busca é o caminho para localizar um cadastro.
Lendo uma linha
Quando o passageiro tem nome de exibição diferente do nome completo, o nome completo aparece em cinza abaixo. Um CPF é exibido no formato ###.###.###-##.
- Avatar: círculo com as iniciais do nome de exibição, ou do nome completo quando não há nome de exibição.
- Nome: o nome de exibição em destaque. Quando o nome completo é diferente, ele aparece abaixo.
- Documento: o número do documento principal. Um CPF é apresentado no
formato
###.###.###-##; os demais documentos aparecem sem formatação. Sem documento cadastrado, a linha apresenta "Sem documento". - Contato: e-mail e, abaixo, telefone. Ambos são opcionais.
- Ações: editar e excluir.
Clique na linha do passageiro para abrir Reservas do passageiro, com as
reservas em que ele é o cliente responsável. Reservas em que ele consta apenas
como passageiro de uma passagem não são listadas. Cada reserva abre o painel da
viagem correspondente. A ação exige a permissão reservations.read.
Criar um passageiro
Abrir o diálogo
Clique em Novo passageiro no canto superior direito.
Preencher os campos
Novo Passageiro
A estrela define o documento principal, utilizado nas listas de passageiros e nos comprovantes.
Adicionar documentoDeixe em branco para usar o nome completo.
Identificação
| Campo | Obrigatório | Regra |
|---|---|---|
| Documentos | Sim | Pelo menos um. Cada documento tem um tipo (CPF / CNPJ, RG, CNH, Passaporte ou CRNM / RNE) e um número. A estrela marca o principal, que é o utilizado nas listas de passageiros e nos comprovantes. |
| Nome completo | Sim | Nome conforme o documento. É o nome impresso na passagem. |
| Nome de exibição | Não | Apelido ou nome curto. Usado em avatares e listas. Se vazio, o nome completo é usado. |
Contato e informações complementares
| Campo | Obrigatório | Regra |
|---|---|---|
| Não | Formato de e-mail válido. | |
| Telefone | Não | Preenchido no formato (00) 00000-0000. Números com menos de 10 dígitos são recusados. |
| Data de nascimento | Não | Informada por digitação (DD/MM/AAAA) ou pelo calendário. O formulário apresenta a idade calculada e a utiliza somente para a verificação de menores durante o cadastro. A data não é armazenada. |
| Acompanhante responsável | Condicional | Exibido apenas quando a idade informada é inferior a 16 anos, junto com o aviso "Menor de 16 anos". Nesse caso, o preenchimento é obrigatório. O nome não é armazenado. |
| Observação | Não | Anotação interna sobre o passageiro, com até 1000 caracteres. |
Um passageiro pode ter vários documentos. Use Adicionar documento para registrar, por exemplo, o RG além do CPF. O tipo é sugerido pelo formato do número e pode ser alterado. CPF e CNPJ são conferidos pelo dígito verificador; os demais tipos são conferidos apenas quanto à quantidade de caracteres. Os documentos podem ser corrigidos, ter o tipo alterado ou ser removidos a qualquer momento, desde que permaneça pelo menos um.
Quando o documento principal do passageiro é um passaporte ou um CRNM / RNE, o detalhe da reserva apresenta o selo Estrangeiro ao lado do nome do passageiro.
Salvar
Clique em Salvar. A notificação "Passageiro criado com sucesso" confirma o cadastro, e a linha aparece na tabela.
Editar um passageiro
Localizar
Use a busca por nome ou documento para localizar o passageiro e clique no ícone de edição.
Alterar e salvar
O mesmo formulário abre com o título Editar Passageiro e os dados preenchidos, exceto a data de nascimento, que não é armazenada. Todos os campos podem ser alterados, inclusive os documentos: adicione, corrija, altere o tipo, mova a estrela do documento principal ou remova um documento, desde que permaneça pelo menos um. Clique em Salvar. A notificação "Passageiro atualizado com sucesso" confirma a alteração.
Excluir um passageiro
Abrir a confirmação
Clique no ícone de exclusão na linha do passageiro.
Excluir Passageiro
Tem certeza que deseja excluir o passageiro “Maria Silva”? Esta ação não pode ser desfeita.
Confirmar
Clique em Excluir. A operação é definitiva: o registro é removido permanentemente, e a notificação "Passageiro excluído com sucesso" confirma a exclusão.
Se o passageiro estiver vinculado a reservas ativas, o sistema pode rejeitar a exclusão. Cancele ou conclua as reservas antes de tentar novamente.
Passageiro no assistente de reserva
Na hora de criar uma reserva, o passageiro é selecionado por poltrona. O sistema oferece uma busca rápida dentro do próprio assistente.
- Digite o nome, o documento ou o telefone, com pelo menos 3 caracteres.
- Se o passageiro ainda não estiver cadastrado, clique em Criar novo passageiro (ou em Criar passageiro, quando a busca não encontra resultados) para cadastrá-lo sem sair do fluxo de reserva.
A venda exige um documento cadastrado para o passageiro. Quando o cadastro está sem documento, o assistente informa a pendência e oferece Atualizar dados para registrá-lo na hora.
Criança de colo
Criança transportada no colo do passageiro, sem ocupar assento.
Crianças que viajam no colo de um adulto não ocupam poltrona própria, mas precisam estar identificadas na passagem. Para cada poltrona é possível informar uma Criança de colo, de forma opcional: o nome da criança é impresso na passagem do adulto.
A criança de colo precisa estar cadastrada como passageiro. Caso ainda não esteja, o próprio campo oferece a opção de criar o passageiro.
Responsável pela reserva
Toda reserva tem um responsável, que é a pessoa ou a empresa que efetua a compra. Ele pode ser diferente dos passageiros que embarcam. O responsável aparece na reserva e no comprovante, e não precisa viajar.
Erros comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Documento já cadastrado ao criar | Outro passageiro utiliza esse documento | Busque pelo documento e edite o cadastro existente |
| Documento recusado ao salvar | CPF ou CNPJ com dígito verificador inválido, ou número com quantidade de caracteres fora do limite do tipo | Confira o número e o tipo informados |
| Botões de criar, editar e excluir ausentes | Falta a permissão customers.edit ou customers.delete | Solicite o ajuste do cargo a um administrador |
| Falha ao excluir o passageiro | Passageiro vinculado a reservas ativas | Cancele as reservas antes de excluir |
| Passageiro não aparece na busca da reserva | Termo com menos de 3 caracteres, ou nome diferente do cadastro | Digite pelo menos 3 caracteres ou busque pelo número do documento |
Próximos passos
Com os passageiros cadastrados, o próximo passo é a venda em Reservas, que combina viagem, poltrona e passageiro para emitir a passagem.
Dashboard
Indicadores da operação por período, situação das reservas e da frota, próximas viagens e o cartão Meu caixa, no qual cada usuário abre e fecha o próprio caixa.
Viagens
Programe as viagens da frota, defina veículo, paradas, horários e preços por trecho, e venda reservas e encomendas a partir do painel da viagem.