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 as Pessoas do tipo Interna — o cadastro central reaproveitado sempre que uma pessoa física precisa ser referenciada em outro lugar do sistema (por exemplo, na Equipe Interna de um convênio). Pessoas do tipo Externa não são cadastradas aqui — elas nascem automaticamente a partir de um vínculo, como o de Pessoas de um Fornecedor.
- Acesse Administração no menu lateral e clique em "Pessoas".

1.1. Clique no ícone de lápis para editar, ou use o toggle para ativar/desativar a pessoa diretamente na listagem.
- Na listagem, clique em "Inserir Pessoa". Os campos Nome, E-mail e Telefone começam bloqueados.

-
Informe o CPF (Campo Obrigatório) e clique na lupa para pesquisar.
2.1. Se o CPF não estiver cadastrado, os campos Nome, E-mail e Telefone são liberados para preenchimento. Se já estiver, os dados existentes são carregados.

2.2. O CPF fica bloqueado depois da busca — para pesquisar outro, use o ícone de borracha para limpar o campo e reiniciar o formulário.
- Preencha Nome, E-mail e Telefone (todos Campo Obrigatório) e clique em "Salvar".
Obs: a chave que identifica uma Pessoa é o par CPF + Tipo — o mesmo CPF pode existir como um registro Interno e outro Externo, sem conflito entre eles.
- No ícone de lápis da listagem (ou pela tela de edição direta), altere Nome, E-mail ou Telefone.

Obs: o CPF não pode ser alterado depois que a Pessoa é criada.
Obs: não existe exclusão de Pessoa — a única forma de removê-la do uso é o toggle Ativo/Inativo na listagem, sem checar quantos vínculos (Fornecedores, Equipes, Participantes) apontam para ela.
| Regra | Descrição |
| RN48.1 | A chave de negócio que identifica uma Pessoa única é o par (CPF, Tipo) — o mesmo CPF pode existir como linha Interna e Externa independentes, sem conflito. |
| RN48.2 | E-mail também é único, mas escopado ao mesmo Tipo. |
| RN48.3 | Não existe exclusão física de Pessoa — só alternância Ativo/Inativo, sem checar quantos vínculos (Fornecedores, Equipes, Participantes) apontam para ela. |
| RN48.4 | A unicidade de (CPF, Tipo) e de e-mail é garantida só em nível de aplicação, sem índice único no banco. |
| RN48.5 | Ao criar um vínculo em outro lugar do sistema (por exemplo, Pessoas de um Fornecedor), o sistema sempre busca por (CPF, Tipo) e reaproveita a linha existente antes de criar uma nova — nunca duplica uma Pessoa já cadastrada. |
| RN48.6 | A busca por CPF que pré-preenche o formulário de cadastro filtra só por CPF, sem filtrar por Tipo — pesquisar um CPF já cadastrado como Externa pode pré-preencher o formulário com os dados daquele registro Externo, mesmo estando na tela de cadastro de Pessoa Interna. |
| RN48.7 | Nome, E-mail e Telefone só ficam editáveis depois de uma busca por CPF; o CPF fica bloqueado após a busca, só reabre via "Limpar CPF" (reinicia o formulário). |
| Campo | Descrição |
| Sistema | Harpia (Gestão 360) |
| Versão | 1.3 |
| Data de Atualização | 2026-10-15 |
| Responsável | Amanda Galvão |
| Público-alvo | usuários administradores responsáveis pelo cadastro central de pessoas |
| Objetivo | consultar, cadastrar e editar uma Pessoa Interna do cadastro central |
| Tipo | Documento de referência / treinamento |
| Versão | Data | Descrição da Alteração | Responsável pela Aprovação |
| 1.3 | 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.2 | 2026-10-05 | Ajustes no Design de Interface e Experiência do Usuário. | Amanda Galvão |
| 1.1 | 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.0 | 2026-09-23 | Versão inicial da documentação | Amanda Galvão |