Ir para o conteúdo principal

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

  1. Acessar o Keycloak.
  2. Ir até a seção de usuários.
  3. 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:

  1. Nome completo

    • Conferir se está correto.
    • Corrigir nome incompleto ou com erro de digitação.
  2. E‑mail

    • Verificar se é o e‑mail atual da pessoa.
    • Atualizar se estiver errado ou desatualizado.
  3. 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.
  4. 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:

  1. Salvar as alterações no Keycloak.

  2. Confirmar se o usuário está:

    • Com nome e e‑mail atualizados;
    • Com role de acesso habilitada;
    • Com setor e cargo devidamente vinculados.
  3. 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”:

  1. Entender que não é para criar um novo usuário com esse CPF.
  2. 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.