Quando o e‑CIGA informa que o CPF “já está cadastrado” 👤🧩

Situação típica: Um usuário com perfil  habilitado para cadastrar outros usuários  tenta criar um novo cadastro no e‑CIGA, digita o CPF e o sistema responde: 

 

 “Este CPF já está cadastrado.” 

 

 Nessa situação, o usuário  não consegue seguir com o cadastro , porque esse CPF já existe na base. Ajustes nesse usuário  não são feitos pela área comum , e sim por quem administra usuários via  Keycloak . 

 Aqui está o passo a passo de como tratar esse caso. 

 

 1. Entender o que está acontecendo 

 Quando o e‑CIGA diz que o CPF já está cadastrado: 

 

 O sistema está informando que  já existe um usuário  com esse CPF na base. 

 Mesmo que o usuário não apareça para quem está tentando cadastrar, ele está registrado “por trás” (no Keycloak e/ou no e‑CIGA). 

 

 Isso significa: 

 

 O usuário  não deve ser cadastrado de novo ; 

 O que precisa é  verificar e ajustar o cadastro já existente . 

 

 

 2. O que precisamos fazer 🛠️ 

 Quando recebemos a informação de que um CPF “já está cadastrado” e o usuário não aparece corretamente no e‑CIGA, o procedimento é: 

 2.1. Localizar o usuário pelo CPF 

 

 Acessar o  Keycloak . 

 Ir até a seção de usuários. 

 Buscar pelo  CPF  informado. 

 

 Se o usuário aparecer: 

 

 Confirmar que é a pessoa correta (nome e e‑mail ajudam a identificar). 

 

 

 2.2. Conferir se os dados cadastrais estão atualizados 

 No registro do usuário, verificar: 

 

 

 Nome completo 

 

 Conferir se está correto. 

 Corrigir nome incompleto ou com erro de digitação. 

 

 

 

 E‑mail 

 

 Verificar se é o e‑mail atual da pessoa. 

 Atualizar se estiver errado ou desatualizado. 

 

 

 

 Role de acesso (perfil/role) 

 

 Checar se o usuário está com a  role de acesso habilitada  para o e‑CIGA. 

 Se não estiver:

 

 Adicionar a role adequada de acesso ao sistema. 

 

 

 

 

 

 Vínculo de setor e cargo 

 

 Ver se o usuário tem:

 

 Setor  vinculado (unidade de lotação); 

 Cargo/função  vinculado. 

 

 

 

 Se estiver faltando: 

 

 Vincular o setor correto (ex.: Contabilidade, RH, Protocolo). 

 Vincular o cargo/função (ex.: Analista, Técnico, Gestor). 

 

 

 

 Esses vínculos são fundamentais para: 

 

 Aparecer nas listas de usuários do e‑CIGA; 

 Receber permissões e perfis compatíveis com suas funções. 

 

 

 3. Ajustes e validações finais 

 Após corrigir o cadastro: 

 

 

 Salvar as alterações no Keycloak . 

 

 

 Confirmar se o usuário está: 

 

 Com  nome  e  e‑mail  atualizados; 

 Com  role de acesso habilitada ; 

 Com  setor  e  cargo  devidamente vinculados. 

 

 

 

 Em seguida, o usuário passa a: 

 

 Acessar normalmente o e‑CIGA com seu CPF/login; 

 Aparecer nas telas de seleção (responsável, carga, assinante etc.), conforme perfil. 

 

 

 

 

 4. Fluxo resumido 🧭 

 Quando o sistema informa “CPF já está cadastrado”: 

 

 Entender que  não é para criar um novo usuário  com esse CPF. 

 A equipe com acesso ao  Keycloak  deve:

 

 Buscar o usuário pelo CPF; 

 Atualizar:

 

 nome, 

 e‑mail, 

 role de acesso, 

 setor, 

 cargo; 

 

 

 Salvar e liberar o uso normal no e‑CIGA. 

 

 

 

 

 5. Boa prática 

 

 Evitar cadastros duplicados para o mesmo CPF. 

 Sempre tratar esses casos via  ajuste do usuário existente  no Keycloak. 

 Garantir que cada usuário tenha:

 

 dados corretos, 

 role de acesso ativa, 

 setor e cargo vinculados. 

 

 

 

 Assim, o CPF permanece como chave única confiável para o acesso ao e‑CIGA.