"HL7 vs FHIR" é uma pergunta ligeiramente incorreta, e a resposta ainda é útil. HL7 é uma organização, Health Level Seven International, e a família de normas que publica. FHIR é o membro mais recente dessa família. A comparação real é entre as três normas HL7 que encontrará na prática: mensagens HL7 versão 2, documentos CDA e recursos FHIR. Este guia diz o que cada um é, onde se encontra em 2026 e qual deles precisa.
Versão técnica para programadores: FHIR vs HL7 v2 · Mapeamento HL7 v2 para FHIR em developers.anpheros.com, com pedidos, respostas e limites. Esta página é a versão em linguagem simples.
HL7 v2: mensagens entre sistemas hospitalares
A versão 2 do HL7 data do final dos anos 80 e continua a ser a norma de dados de saúde mais amplamente implementada no mundo. Move mensagens entre sistemas dentro e em torno de hospitais: um paciente é admitido (ADT), um teste é encomendado (ORM), um resultado regressa (ORU). Uma mensagem é um texto delimitado por barras verticais com segmentos:
MSH|^~\&|LAB|CityLab|EHR|Clinic|20260901081000+0300||ORU^R01|MSG0001|P|2.5.1
PID|1||12345^^^Clinic^MR||Ionescu^Elena||19850903|F
OBR|1|||CBC^Complete blood count|||20260901081000+0300
OBX|1|NM|718-7^Hemoglobin^LN||13.2|g/dL|12.0-16.0|N|||F|||20260901081000+0300
Funciona, está em todo o lado e é difícil para uma aplicação moderna consumir: o formato é posicional, cada local tem o seu próprio dialeto e não há o conceito de "obter o registo deste paciente via HTTP".
CDA: documentos clínicos
A Clinical Document Architecture, dos anos 2000, é XML para documentos: um resumo de alta, uma carta de referência, um resumo do paciente. Um documento CDA é legível por humanos e assinado na totalidade. É aquilo em que muitas trocas nacionais e a primeira geração de resumos de pacientes foram construídas. É um bom formato para um documento e um mau formato para uma pergunta como "qual foi a última pressão arterial desta pessoa".
FHIR: recursos na web
Fast Healthcare Interoperability Resources, publicado pela primeira vez em 2014 e estável em R4 desde 2019, descreve dados de saúde como recursos com uma estrutura conhecida, em JSON ou XML, acessíveis via HTTP exatamente como páginas web. Um resultado de laboratório é uma Observation, um diagnóstico uma Condition, uma prescrição uma MedicationRequest, cada um com códigos padrão (LOINC, ICD-10 ou SNOMED CT, ATC). Obtém, pesquisa e escreve-os com as ferramentas que todos os programadores já conhecem:
GET /fhir/R4/Observation?patient=123&code=http://loinc.org|718-7&_sort=-date
FHIR é o que a regulamentação da UE e dos EUA exige agora para o acesso do paciente, o que as aplicações SMART on FHIR executam e no que se baseia o Espaço Europeu de Dados de Saúde. Uma explicação em linguagem simples encontra-se em O que é FHIR e porque é importante.
Lado a lado
| HL7 v2 | CDA | FHIR | |
|---|---|---|---|
| Unidade | mensagem | documento | recurso |
| Formato | texto delimitado | XML | JSON ou XML |
| Transporte | MLLP, ficheiros | ficheiros, trocas | HTTP REST |
| Melhor em | integração de sistemas hospitalares | documentos assinados | aplicações, APIs, acesso do paciente |
| Era | 1989 em diante | 2005 em diante | 2014 em diante, R4 2019 |
| Ainda comum em | laboratórios, feeds ADT, dispositivos | trocas nacionais | tudo o que é novo |
Qual precisa
- A construir uma aplicação, uma API ou um assistente de IA: FHIR, sem hesitação.
- A receber resultados de um laboratório ou de um hospital: provavelmente HL7 v2, porque é isso que eles enviam. Converta na borda.
- A trocar documentos formais com um sistema nacional: documentos CDA ou FHIR, dependendo do país.
O padrão prático é "HL7 v2 para dentro, FHIR para todo o resto". A Plataforma Anpheros faz exatamente isso para relatórios de laboratório: um laboratório publica uma mensagem ORU^R01 tal como enviada, e cada OBX torna-se uma Observation FHIR com um código LOINC, uma unidade, um intervalo de referência e o laboratório nomeado como executante. O registo do paciente é FHIR; o laboratório nunca tem de mudar.
curl -X POST "$BASE/v1/patients/$PID/labs/import" \
-H "Authorization: Bearer $KEY" -H "Content-Type: x-application/hl7-v2+er7" \
--data-binary @report.hl7
Os detalhes encontram-se em Conector de Laboratório: HL7 v2 e CSV para FHIR.
Perguntas frequentes
O FHIR está a substituir o HL7 v2?
Para trabalhos novos, sim. Os feeds v2 existentes funcionarão durante anos porque funcionam e substituí-los custa dinheiro. A maioria dos sistemas reais converte v2 para FHIR na fronteira em vez de substituir o feed.
O FHIR faz parte do HL7?
Sim. O FHIR é publicado pela HL7 International, a mesma organização por trás do v2 e do CDA. "HL7 FHIR" é o seu nome completo.
Qual a versão FHIR que devo usar?
R4 (4.0.1). É o que a regulamentação referencia e o que a maioria dos sistemas implementa. Existe R5 mas a adoção é limitada; a Plataforma Anpheros implementa R4.
O FHIR pode transportar documentos também?
Sim: um DocumentReference aponta para um PDF ou qualquer ficheiro, e um FHIR Document Bundle pode transportar um documento composto com as suas secções, que é como o Resumo Internacional do Paciente é entregue.
Preciso de aprender HL7 v2 para usar uma API FHIR?
Não. Se se integrar com um laboratório ou hospital, encontrará o v2 do lado deles; uma plataforma que o converte para si significa que o seu próprio código só vê FHIR.
Tenha o seu registo de saúde consigo
Anpheros Daily reúne sintomas, resultados de exames, medicamentos e documentos num só local, num formato standard, sob o seu controlo. O plano Basic é gratuito.