Clientes - Dependentes do Cliente

O que é

A área de Dependentes mantém o cadastro de familiares e acompanhantes vinculados ao titular: filhos, cônjuge, irmãos, netos, sobrinhos e outras relações. Cada dependente pode ter CPF, RG, data de nascimento, contatos, documentos anexados e ficha médica própria, sem precisar virar um cliente independente na base.

Você normalmente chega aqui pelo perfil do cliente (card "Dependentes"), quando o titular vai viajar com familiares e você quer pré-cadastrar todos para reaproveitar os dados em futuras reservas. O dependente fica disponível para ser selecionado rapidamente como passageiro no checkout e em novas inscrições de excursão.

Como usar

1. Vá em Cadastros > Clientes no menu lateral.
2. Abra o perfil do cliente clicando no nome do titular.
3. Localize o card Dependentes (ícone de pessoas roxo).
4. Clique em Adicionar (botão roxo com ícone de +, à direita do título do card).
5. Preencha o formulário Novo Dependente dividido em quatro blocos:
   • Dados Pessoais
     • Nome Completo - obrigatório, mínimo 3 caracteres.
     • CPF - máscara 000.000.000-00. Único por titular: o sistema bloqueia o mesmo CPF duas vezes na lista de dependentes do mesmo cliente.
     • RG - opcional.
     • Nacionalidade e Documento Estrangeiro - para dependentes não brasileiros, marcar e preencher o documento alternativo.
     • Data de Nascimento - obrigatória, anterior a hoje. Para parentescos diferentes de Cônjuge, deve ser menor de 18 anos.
     • Parentesco - obrigatório. Valores aceitos: Cônjuge, Filho(a), Neto(a), Sobrinho(a), Irmão(ã), Outro.
     • Faixa Etária - opcional. Se vazia, é calculada automaticamente pela data de nascimento (bebê, criança, jovem, adulto, idoso).
   • Contato - Telefone e E-mail do próprio dependente, usados quando ele precisa receber comunicação direta.
   • Contato de Emergência - Nome, Parentesco e Telefone de alguém para acionar durante a viagem.
   • Observações - Restrições alimentares, necessidades especiais e qualquer informação relevante.
6. Conclua escolhendo uma das opções no rodapé:
   • Cadastrar Dependente - salva e volta para o perfil do titular.
   • Cadastrar e continuar editando - salva e abre a tela de edição do mesmo dependente.
   • Cadastrar e adicionar outro - salva e abre um novo formulário em branco para o mesmo titular.

Na lista do card Dependentes (dentro do perfil), cada item mostra iniciais, nome, parentesco, data de nascimento, faixa etária e quantidade de documentos. Use os três ícones à direita para Adicionar documento (ícone ciano de documento), Editar (lápis azul) ou Remover (lixeira vermelha).

Casos especiais

Cônjuge maior de idade

A regra "dependente precisa ser menor de 18 anos" é ignorada quando o Parentesco é Cônjuge. Para esse parentesco, qualquer idade adulta é aceita. Se a viagem for de um casal, cadastre o cônjuge como dependente em vez de criar dois clientes separados.

Dependente estrangeiro sem CPF

Marque o bloco Nacionalidade e Documento Estrangeiro e preencha o documento alternativo (passaporte ou RNE). O CPF deixa de ser obrigatório nesse caso e o dependente passa a viajar identificado pelo documento estrangeiro.

Anexar documentos por dependente

Cada dependente tem documentos próprios (RG, CPF, CNH, passaporte, certidão de nascimento ou outro). Clique no ícone de Adicionar documento (ciano) na linha do dependente para enviar o arquivo. Aceita JPG, PNG ou PDF com até 5 MB. O documento fica aprovado automaticamente e é exibido na seção Documentos por Dependente, abaixo da lista.

Remover dependente

Clique no ícone de lixeira vermelha na linha do dependente. A remoção pede confirmação no modal Remover dependente. A exclusão é lógica (soft delete): o histórico de reservas anteriores continua acessível, mas o dependente não aparece mais nas seleções futuras.

Erros comuns e como resolver

• "Já existe um dependente com este CPF cadastrado para este cliente." - Causa: você está adicionando o mesmo CPF duas vezes para o mesmo titular. Solução: localize o dependente existente na lista e edite os dados em vez de criar outro.
• "Dependentes devem ser menores de 18 anos." - Causa: você selecionou um parentesco diferente de Cônjuge e informou uma data de nascimento de alguém adulto. Solução: troque o parentesco para Cônjuge se for o caso, ou cadastre essa pessoa como cliente próprio em vez de dependente.
• "A data de nascimento deve ser anterior a hoje." - Causa: data de nascimento futura ou igual ao dia de hoje. Solução: corrija a data.
• "Selecione o tipo de documento." ou "O arquivo deve ser JPG, PNG ou PDF." - Causa: tentativa de upload sem escolher tipo ou com formato não aceito. Solução: escolha um dos tipos disponíveis e envie arquivo em formato suportado, máximo 5 MB.
• "Parentesco inválido." - Causa: valor enviado fora da lista aceita pelo sistema. Solução: use somente as opções do select (Cônjuge, Filho(a), Neto(a), Sobrinho(a), Irmão(ã), Outro).

Onde encontrar

• URL: /admin/clientes/{cliente}/dependentes/create
• Caminho no menu: Cadastros > Clientes > [abrir perfil] > card Dependentes > Adicionar
• Permissão necessária: ver os clientes para visualizar, editar os clientes para criar, editar, remover e anexar documentos
• Módulo necessário: nenhum

Veja também

• Perfil do Cliente
• Listagem de Clientes
• Documentos do Cliente
• Editar Cliente