Pessoa e paciente
O cadastro de paciente é organizado em dois níveis: a pessoa e o paciente.
PESSOA PACIENTE
escopo: empresa (grupo de clínicas) escopo: clínica
identificada pelo CPF identificado por um id, por clínica
───────────────────────────── ─────────────────────────────
nome, nome social status ativo/inativo
sexo, gênero número de controle
data de nascimento origem do cadastro
contato (telefones, e-mail) convênios vinculados
endereço
Cada CPF corresponde a uma única pessoa em todo o grupo, que pode ter um registro de paciente em cada clínica em que é atendida.
Criação com CPF já cadastrado no grupo
Quando o POST /paciente/novo recebe um cpfcnpj já cadastrado em uma clínica do grupo, o
sistema reaproveita a pessoa existente e cria apenas o registro de paciente na clínica informada.
Nesse caso, os dados pessoais enviados não substituem os já cadastrados:
Dados enviados Dados gravados
────────────────── ──────────────────
nome: "João S. Santos" → nome: "João da Silva" (cadastro existente)
contato: { ... } → contato: (cadastro existente)
endereco: { ... } → endereco: (cadastro existente)
numeroControle: "1024" → numeroControle: "1024" ✓ aplicado
idOrigem: 5 → idOrigem: 5 ✓ aplicado
A resposta é 200, com o cadastro existente. A comparação entre o nome enviado e o nome
retornado indica se houve reaproveitamento da pessoa.
Alteração de contato e endereço
Contato e endereço pertencem à pessoa, e não ao paciente. Por isso, as alterações nesses
blocos feitas com PUT /paciente/{id} se aplicam a todas as clínicas do grupo.
O PUT /paciente/{id} substitui o cadastro completo, portanto os blocos contato e endereco não
enviados são removidos:
PUT /paciente/3
{ "nome": "João da Silva", "dataNascimento": "2005-07-27" }
│
▼
contato → removido (telefones, ramais, e-mail)
endereco → removido (CEP, rua, número, complemento, bairro, cidade)
│
▼
em todas as clínicas do grupo
Para evitar a perda desses dados, consulte o cadastro antes da alteração e envie o corpo da requisição completo. Ver Manter o cadastro.
Identificador do paciente por clínica
O id do paciente é por clínica. A mesma pessoa atendida em duas clínicas do grupo tem dois
identificadores distintos, e cada um é válido com o token da respectiva clínica.
Em integrações com mais de uma clínica, o paciente é identificado pelo clinicaId e pelo id do paciente.
Criação do mesmo CPF em sequência
A criação recusa o mesmo CPF enviado duas vezes em um intervalo de 2 segundos, com a mensagem "Cpf/Cnpj foi usado recentemente". Esse controle evita cadastros duplicados por duplo clique ou retentativa automática.
A regra não se aplica às operações de alteração. Em importações em lote, a chamada recusada pode ser repetida após esse intervalo.
Resumo
| Operação | Resultado |
|---|---|
| Criar com CPF novo | Pessoa e paciente criados com os dados enviados |
| Criar com CPF já cadastrado no grupo | Pessoa reaproveitada, dados pessoais enviados não aplicados, 200 com o cadastro existente |
| Criar o mesmo CPF duas vezes em 2 segundos | Segunda chamada recusada |
| Alterar nome, contato ou endereço | Alteração aplicada em todas as clínicas do grupo |
Omitir contato ou endereco no PUT | Dados removidos, em todas as clínicas do grupo |