Nos artigos anteriores desta série falamos sobre formatos de serialização e sobre como o FHIR declara vocabulário através de CodeSystem. Mas ainda não respondemos a uma pergunta mais básica, que costuma ser a primeira dúvida de quem chega à especificação: quantos recursos existem, e como alguém se orienta nesse catálogo sem se perder? Este artigo é o mapa mental para isso — e a base para reconhecer os recursos mais comuns de qualquer integração FHIR do dia a dia.
Visão geral: quantos recursos existem e como estão organizados em camadas
A especificação FHIR define mais de 140 tipos de recurso — o número exato varia de versão para versão, à medida que a HL7 adiciona, amadurece ou reorganiza recursos a cada release. Para evitar que esse catálogo vire uma lista solta e difícil de navegar, o Resource Guide e a página de arquitetura geral organizam os recursos em camadas, cada uma construída sobre a anterior:
- Foundation — recursos de infraestrutura da própria especificação (conformidade, terminologia, segurança). Raramente referenciados diretamente por quem consome dados clínicos.
- Base — recursos frequentemente referenciados por outros, mas que raramente referenciam algo fora da própria camada. É aqui que vivem
Patient,PractitionereOrganization. - Clinical — recursos que representam o conteúdo clínico do dia a dia (observações, condições, medicações, procedimentos), construídos sobre a camada base.
- Financial — recursos de faturamento, que referenciam eventos clínicos e recursos base.
- Specialized — recursos para casos de uso menos comuns, que tipicamente referenciam camadas inferiores.
Neste artigo, o foco são os recursos administrativos centrais — Patient, Practitioner, Organization — o Encounter como o elo que conecta um atendimento aos recursos clínicos, e os recursos clínicos mais comuns do dia a dia de qualquer integração.
Patient
Patient representa a pessoa que recebe cuidado — o recurso mais referenciado de toda a especificação, já que praticamente todo recurso clínico aponta de volta para um paciente. Carrega dados demográficos (nome, data de nascimento, gênero, contatos, endereço) e identificadores (identifier), campo que carrega os números de prontuário ou documentos oficiais usados para identificar aquela pessoa em diferentes sistemas.
{
"resourceType": "Patient",
"id": "exemplo-paciente",
"identifier": [
{ "system": "http://rnds.saude.gov.br/fhir/r4/NamingSystem/cpf", "value": "12345678900" }
],
"name": [{ "use": "official", "text": "Maria da Silva" }],
"gender": "female",
"birthDate": "1985-03-12"
}Practitioner
Practitioner representa uma pessoa envolvida na prestação de cuidado — médico, enfermeiro, farmacêutico ou qualquer outro profissional de saúde. Ele descreve a pessoa em si (nome, identificadores profissionais como registro no conselho de classe); o vínculo dessa pessoa com uma organização e sua função específica é modelado por um recurso relacionado, PractitionerRole, que não abordaremos aqui.
{
"resourceType": "Practitioner",
"id": "exemplo-medico",
"identifier": [
{ "system": "http://rnds.saude.gov.br/fhir/r4/NamingSystem/crm", "value": "123456-SP" }
],
"name": [{ "use": "official", "text": "Dr. João Pereira" }]
}Organization
Organization representa uma entidade formalmente reconhecida — um hospital, uma clínica, uma operadora de plano de saúde, um laboratório ou até um departamento dentro de uma instituição maior. É o recurso que dá contexto institucional a um atendimento: quem prestou o serviço, quem é responsável por um Practitioner, ou quem emitiu um determinado documento.
{
"resourceType": "Organization",
"id": "exemplo-hospital",
"identifier": [
{ "system": "http://rnds.saude.gov.br/fhir/r4/NamingSystem/cnes", "value": "1234567" }
],
"name": "Hospital Exemplo",
"active": true
}Encounter: o elo do atendimento
Se Patient, Practitioner e Organization respondem “quem”, o Encounter responde “quando e em que contexto”. Ele representa um episódio de interação entre um paciente e o sistema de saúde — uma consulta ambulatorial, uma internação, um atendimento de emergência — e funciona como o elo que conecta esses recursos administrativos a tudo o que acontece clinicamente durante aquele atendimento.
Na prática, é raro um recurso clínico existir sem uma referência (direta ou indireta) a um Encounter: uma Observation registrada durante uma consulta, uma Condition diagnosticada numa internação, uma MedicationRequest prescrita num atendimento de emergência — todos eles carregam, no campo encounter, a referência ao episódio de atendimento em que aquilo aconteceu. É essa referência que permite reconstruir, a partir de um Encounter, tudo o que foi observado, diagnosticado ou prescrito naquele episódio específico.
{
"resourceType": "Encounter",
"id": "exemplo-consulta",
"status": "finished",
"class": { "code": "AMB", "display": "ambulatory" },
"subject": { "reference": "Patient/exemplo-paciente" },
"participant": [{ "individual": { "reference": "Practitioner/exemplo-medico" } }],
"serviceProvider": { "reference": "Organization/exemplo-hospital" }
}Os recursos clínicos mais comuns
A partir de um Encounter, os recursos abaixo são os que aparecem com mais frequência — cada um cobrindo um tipo distinto de informação clínica gerada durante o atendimento.
Observation — registra uma medição ou achado pontual: um sinal vital, o resultado de um exame laboratorial, uma observação social. É provavelmente o recurso clínico mais usado da especificação, por cobrir qualquer coisa que possa ser expressa como “uma métrica ou achado, com valor e data”. Exemplo: o resultado de uma glicemia de jejum, com valor numérico e unidade.
Condition — registra um diagnóstico, problema de saúde ou queixa que o paciente apresenta, com informações como status clínico (ativo, resolvido) e severidade. Exemplo: o diagnóstico de hipertensão arterial identificado numa consulta.
MedicationRequest — representa a prescrição de um medicamento: o que foi prescrito, dosagem, via de administração e quem prescreveu. Não confundir com o ato de efetivamente administrar o medicamento, coberto por outro recurso (MedicationAdministration) fora do escopo deste artigo. Exemplo: a prescrição de um anti-hipertensivo de uso contínuo.
AllergyIntolerance — registra uma alergia ou intolerância do paciente a uma substância (medicamento, alimento, agente ambiental), incluindo a reação observada e sua severidade. Exemplo: alergia a penicilina, registrada para alertar qualquer prescrição futura.
Immunization — registra a administração de uma vacina: qual vacina, quando, lote e via de administração. Exemplo: o registro de uma dose de vacina contra influenza aplicada numa campanha de vacinação.
Procedure — registra um procedimento realizado no paciente, seja diagnóstico, terapêutico ou cirúrgico. Exemplo: uma endoscopia realizada durante uma internação, com data e status de conclusão.
Esses principais recursos estão presentes em grande parte dos casos integração em FHIR e são um excelente ponto de partida para o aprofundamento na especificação.
