Antes de começar, veja a página "
Introdução" para os pré-requisitos gerais do sistema e o passo a passo de login. Em caso de dúvidas, consulte também o
FAQ.
Esta tela cadastra e mantém os Usuários internos do sistema (equipe APEX/Blue). Usuários externos — vinculados a um Fornecedor/convênio — são cadastrados por um fluxo separado, na tela de Fornecedores.
- Acesse Administração no menu lateral e clique em "Usuários".

1.1. A listagem traz todos os usuários internos cadastrados — usuários externos não aparecem aqui.
- Clique no ícone de detalhar de um usuário para ver seus dados completos e os Perfis de Acesso associados a ele.
-
Na listagem, clique em "Inserir Usuário".
-
Preencha CPF, Nome, E-mail e Telefone (todos Campo Obrigatório) e, opcionalmente, uma Observação. Clique em "Salvar".

Obs: o cadastro por esta tela sempre cria um usuário do tipo Interno, independentemente do que for informado — não é possível cadastrar um usuário Externo por aqui. E-mail e CPF só precisam ser únicos entre outros usuários do mesmo tipo (Interno/Externo), não globalmente.
Obs: ao salvar, o sistema dispara automaticamente um e-mail de boas-vindas para o endereço informado — não há como pular esse envio.
- No detalhe de um usuário, clique em "Editar".

Obs: o campo CPF não pode ser alterado depois que o usuário é criado.
- No detalhe do usuário, clique em "Desativar" (ou "Ativar", se ele já estiver Inativo) para alternar o status. A ação é aplicada imediatamente, sem uma tela de confirmação à parte.

Obs: não existe exclusão de usuário — o cadastro é permanente e a única forma de removê-lo do uso é desativá-lo. Um usuário em "Primeiro Acesso" (que ainda não fez seu primeiro login) não mostra nem o botão Ativar nem o Desativar; a próxima ação disponível para ele só aparece depois desse primeiro acesso.
- No detalhe do usuário, a seção "Perfis de Acesso" mostra, para o Módulo selecionado, os perfis já Associados e os Disponíveis para associação.

- Marque um ou mais perfis em Disponíveis e clique em "Associar Selecionados" — ou marque em Associados e clique em "Desassociar Selecionados" para remover.
Obs: um usuário pode existir sem nenhum Perfil de Acesso associado — a associação é opcional e feita à parte do cadastro, módulo por módulo.
| Regra | Descrição |
| RN66.1 | Unicidade de e-mail e CPF é escopada por tipo de usuário (Interno/Externo), não global. |
| RN66.2 | O cadastro de Usuário por esta tela só produz registros do tipo Interno, independentemente do valor informado. |
| RN66.3 | A listagem geral de Usuários exibe exclusivamente usuários Internos. |
| RN66.7 | Nome, e-mail e CPF/telefone são obrigatórios; a validação mais rígida de CPF (dígitos, dígito verificador) é feita só no front. |
| RN66.8 | Nome é sempre normalizado para maiúsculas e e-mail para minúsculas antes de persistir. |
| RN66.9 | Não existe exclusão física de usuário — só o toggle de ativar/desativar; o cadastro permanece indefinidamente no banco. |
| RN66.10 | A alternância de status é binária pelo estado atual: Ativo vira Inativo; Inativo ou Primeiro Acesso viram Ativo. |
| RN66.12 | Vínculo com Perfil de Acesso não é obrigatório no cadastro — a associação é feita à parte, por módulo. |
| RN66.13 | Toda inserção de usuário dispara e-mail de boas-vindas; se a configuração de template/URL não existir, a inserção falha mesmo com o usuário já persistido no banco. |
| RN66.14 | CPF não pode ser alterado após a criação — campo bloqueado na edição. |
| RN66.15 | Os botões Ativar/Desativar só aparecem para status Inativo/Ativo respectivamente; um usuário em "Primeiro Acesso" não exibe nenhum dos dois. |
| Campo | Descrição |
| Sistema | Harpia (Gestão 360) |
| Versão | 1.4 |
| Data de Atualização | 2026-10-15 |
| Responsável | Amanda Galvão |
| Público-alvo | usuários administradores responsáveis pela equipe interna do sistema |
| Objetivo | consultar, cadastrar, editar, ativar/desativar e associar Perfis de Acesso a um Usuário interno |
| Tipo | Documento de referência / treinamento |
| Versão | Data | Descrição da Alteração | Responsável pela Aprovação |
| 1.4 | 2026-10-15 | Adicionado o bloco "Veja Também" com links para os guias relacionados e o card correspondente no Sumário | Amanda Galvão |
| 1.3 | 2026-10-05 | Ajustes no Design de Interface e Experiência do Usuário. | Amanda Galvão |
| 1.2 | 2026-09-24 | Corrigido o link do Sumário para "Regras de Negócio Relacionadas" (o anchor não deveria ter o prefixo "h-", pois o heading não começa com dígito) | Amanda Galvão |
| 1.1 | 2026-09-22 | Alteração de texto. | Amanda Galvão |
| 1.0 | 2026-09-22 | Versão inicial da documentação | Amanda Galvão |