Pacientes

Introdução

---

Informações demográficas e administrativas sobre um indivíduo que está recebendo cuidados ou outros serviços relacionados à saúde.

Principais informações:

• Nome do paciente;
• WhatsApp do paciente;
• Identificadores do paciente;

Contexto NiloCare

---

Esse endpoint permite aos clientes Nilo Saúde manipular o cadastro de pacientes na plataforma NiloCare, é uma alternativa a interface de usuário para integração e automatização.

Mapeamento de Campos

#	Campo	Expressão de caminho no payload
1	Nome paciente	name.where(use='official').last().text
2	Apelido ou Nome Social	name.where(use='usual').last().text
3	CPF	identifier.where(system='https://servicos.receita.fazenda.gov.br/servicos/cpf/').last().value Onde o system configurado para o cliente para identificar o cpf, por exemplo, seja 'https://servicos.receita.fazenda.gov.br/servicos/cpf/'
4	Data de Nascimento	birthDate
5	Sexo	gender
6	Identidade de gênero	extension.where(url='http://hl7.org/fhir/StructureDefinition/patient-genderIdentity').last().valueCodeableConcept.coding.first().code
7	Espiritualidade	extension.where(url='http://hl7.org/fhir/StructureDefinition/patient-religion').last().valueCodeableConcept.coding.first().code
8	Celular com Whatsapp	telecom.where(system='phone' and use='mobile').last().value
9	Email	telecom.where(system='email').last().value
10	CEP	address.last().postalCode
11	Bairro	address.last().district
12	Cidade	address.last().city
13	Estado	address.last().state
14	Logradouro	address.last().line[0]
15	Número	address.last().line[1]
16	Complemento	address.last().line[2]
17	Doador de órgãos	extension.where(url='http://hl7.org/fhir/StructureDefinition/patient-cadavericDonor').last().valueBoolean
18	Grupo de pacientes	extension.where(url='http://hl7.org/fhir/StructureDefinition/patient-cohort').last().valueString
19	Já aceitou os termos de uso para ser paciente?	extension.where(url='http://hl7.org/fhir/StructureDefinition/patient-isLead').last().valueBoolean
20	Enviar mensagem de boas vindas?	extension.where(url='http://hl7.org/fhir/StructureDefinition/patient-sendWelcomingMessage').last().valueBoolean
21	Liberar agendamento de onboarding?	extension.where(url='http://hl7.org/fhir/StructureDefinition/patient-createOnboardingScheduling').last().valueBoolean

* Demais atributos nos payloads são armazenados, mas não afetados pelo sistema.

Especificações de comportamento FHIR - NiloCare

---

Identificadores

Nossa API suporta o uso de múltiplos identificadores para cada paciente. Porém, apenas dois identificadores refletem na interface de usuário sistema, o CPF e identificador externo pré-definido. Os demais identificadores podem ser utilizados para fins analíticos e para recuperação futura de informações sobre o paciente.

A definição de quais identificadores da lista fornecida serão utilizados como CPF ou identificador externo depende de configurações do sistema atreladas a conta de cada cliente, ela ocorre através do atributo identifier.system. Exemplo: Configuração no sistema para identificar o CPF através do system: https://servicos.receita.fazenda.gov.br/servicos/cpf/

...
"identifier": [
  {
    "use": "usual",
    "system": "https://www.4devs.com.br/gerador_de_pessoas/",
    "value": "507823709"
  },
  { // Esse identificador será considerado CPF
    "use": "official",
    "system": "https://servicos.receita.fazenda.gov.br/servicos/cpf/",
    "value": "57978394824"
  }
],
...

cuidado

Os systems utilizados como identificadores primários podem ser definidos com o time de suporte. Ao menos um identificador primário deve ser fornecido para cada paciente.

cuidado

O envio de um registro de paciente com um mesmo identificador principal de um registro já existente na base provoca uma alteração ao invés de um novo cadastro.

dica

Consulte aqui mais exemplos de uso dos identificadores para um entendimento mais completo sobre o tema.

Campos de data

O FHIR trabalha com atributos de data de uma maneira mais flexível que o NiloCare, permitindo datas parciais, nesse caso complementamos a data ao inseri-la no sistema. Exemplo: se recebermos uma data 2022-12 via API, assumiremos para o sistema 2022-12-01

Status do paciente

O status do paciente é controlado via o atributo active: true | false, utilizado para habilitar ou desabilitar o paciente no sistema, conforme as regras definidas durante a implantação do sistema Nilo.

Funcionamento

Ação	Status
Habilita	Pré ativo, Ativo
Desabilita	Encerrado, Inativo

O atributo active = true define o paciente como Ativo, o status ativo padrão¹ é exibido no Hub do paciente:

¹ Definido nas regras de integração

O atributo active = false define o paciente como Encerrado, o status inativo padrão² é exibido no Hub do paciente:

² Definido nas regras de integração

Paciente e unidades de cuidado

No NiloCare é possível agrupar pacientes de diferentes maneiras:

• Unidade de cuidado (managingOrganization): uma subsidiária da organização principal;
• Grupo de pacientes (Cohort): Uma oferta de cuidado com parâmetros correlatos e características específicas para um grupo/população de pacientes;

Você pode obter uma lista de Unidade de cuidado e Grupo de pacientes configurados em seu ambiente para gerenciar esses agrupamentos solicitando ao suporte ou consultando as entidades Organization e Group respectivamente.

Valores padrões

Os seguintes atributos possuem uma configuração padrão customizada para cada cliente e assumido quando não informado:

• Considerar o paciente para captação;
• Enviar mensagem de boas vindas;
• Primeiro agendamento esta liberado para o paciente desde o cadastro;
• Unidade de cuidado;
• Cohort;