Passageiros
Cadastre os clientes que viajam ou recebem encomendas — o CPF é a chave de identificação usada em cada bilhete.
A tela de Passageiros centraliza o cadastro de todos os clientes da operação. Todo bilhete precisa de um passageiro vinculado; sem cadastro, não há reserva.
Passageiro ≠ Usuário do sistema. Usuários são os operadores que acessam a pulvo (ver Usuários e Perfis). 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 lápis somem. Sem
customers:delete, a lixeira não aparece.
A tela em um relance
Passageiros
Cadastro de clientes que viajam ou recebem encomendas pela sua frota.
Da esquerda para a direita, de cima para baixo:
- Cabeçalho com título, descrição e o botão Novo passageiro.
- Barra de filtros — busca livre + ordenação A→Z / Z→A.
- Tabela com avatar, nome, CPF, e-mail e ações.
- Paginação — 10 passageiros por página.
Buscar e filtrar
- Busca livre — filtra por nome, CPF (ignora a formatação — pode digitar só os números) e e-mail simultaneamente.
- A → Z / Z → A — ordena alfabeticamente pelo nome. Clica para inverter.
Ao mudar o termo da busca, a tabela volta automaticamente para a página 1.
Lendo uma linha
Quando o passageiro tem nome de exibição diferente do nome legal, o nome legal aparece em cinza abaixo. CPF é exibido no formato ###.###.###-##.
- Avatar — círculo colorido com as iniciais do nome de exibição (ou nome legal, se não houver apelido configurado).
- Nome — nome de exibição em destaque. Se o nome legal for diferente, aparece em cinza abaixo.
- CPF — exibido no formato
###.###.###-##. - E-mail — opcional. Se não cadastrado, aparece
—. - Ações — lápis para editar, lixeira para excluir.
Criar um passageiro
Abrir o diálogo
Clique em Novo passageiro no canto superior direito.
Preencher os campos
Novo Passageiro
Identificação
Contato
Identificação
| Campo | Obrigatório | Regra |
|---|---|---|
| CPF | Sim | Único no sistema. Não pode ser alterado após salvo. |
| Nome legal | Sim | Nome completo conforme documento — aparece no bilhete. |
| Nome de exibição | Não | Apelido ou nome curto. Usado em avatares e listas. Se vazio, o nome legal é usado. |
Contato
| Campo | Obrigatório | Regra |
|---|---|---|
| Não | Formato de e-mail válido. | |
| Telefone | Não | Texto livre. |
| Data de nascimento | Não | Necessária para identificar menores de colo. |
| Nome do responsável | Não | Para crianças — nome do adulto acompanhante. |
Endereço (todo opcional) — rua, número, complemento, bairro, cidade, estado, CEP e país.
O CPF não pode ser editado depois de salvo — ele é a chave permanente de identificação do passageiro. Se digitado errado, exclua e recadastre.
Salvar
Clique em Salvar. A notificação "Passageiro criado com sucesso" confirma e a linha aparece na tabela.
Editar um passageiro
Localizar
Use a busca por nome ou CPF para encontrar o passageiro. Clique no lápis.
Alterar e salvar
O mesmo diálogo abre com o título Editar Passageiro e os dados preenchidos. Todos os campos exceto CPF podem ser alterados. Clique em Salvar.
Excluir um passageiro
Abrir a confirmação
Clique na lixeira na linha do passageiro.
Excluir passageiro
Tem certeza que deseja excluir "Maria Silva"? Esta ação não pode ser desfeita.
Confirmar
Clique em Excluir. A operação é definitiva — o registro é removido permanentemente.
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.
Maria Silva
123.456.789-00
João Pereira
987.654.321-00
Ana Oliveira
456.123.789-00
- Digite o nome ou o CPF (só os dígitos funcionam).
- Se o passageiro ainda não existe, clique em Criar novo passageiro para cadastrá-lo sem sair do fluxo de reserva.
Passageiro colo
Poltrona 12A · Executivo
João Pereira
Criança sem poltrona própria. O nome aparece no bilhete do adulto.
Crianças que viajam no colo de um adulto não ocupam poltrona própria mas precisam estar identificadas no bilhete. Para cada poltrona, é possível informar um passageiro colo (opcional) — o nome da criança aparece impresso no bilhete do adulto.
O passageiro colo deve estar cadastrado como passageiro normal. Use o campo Nome do responsável no cadastro para facilitar a identificação de menores.
Responsável pela reserva
Todo grupo de bilhetes tem um responsável pela reserva — a pessoa (ou empresa) que efetua a compra. Pode ser diferente dos passageiros que efetivamente embarcam. O responsável aparece na listagem de reservas e no recibo, mas não precisa viajar.
Erros comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| "CPF já cadastrado" ao criar | Outro passageiro usa esse CPF | Busque pelo CPF e edite o cadastro existente |
| Botões Novo passageiro / lápis / lixeira ausentes | Falta de permissão customers:edit ou :delete | Solicite ajuste do seu cargo a um administrador |
| Falha ao excluir passageiro | Passageiro vinculado a reservas ativas | Cancele as reservas antes de excluir |
| Passageiro não aparece na busca da reserva | Nome digitado diferente do cadastro | Tente buscar pelo CPF (só dígitos) |
Próximos passos
Com passageiros cadastrados, você está pronto para criar Reservas — onde combina viagem, poltrona e passageiro para emitir o bilhete.