Integração HL7 e FHIR na saúde: guia para gestores

O laboratório comprou um analisador novo, mais rápido. O equipamento chegou, foi instalado, e os resultados continuam sendo digitados à mão no sistema, porque "a interface ainda não está pronta". Na clínica ao lado, o médico pede um exame no prontuário eletrônico, a recepção imprime o pedido, o laboratório redigita, e o laudo volta como PDF anexado por e-mail. Cada passagem manual é uma chance de trocar paciente, exame ou valor de referência.

Quem pede orçamento para resolver isso costuma ouvir duas siglas: HL7 e FHIR. O fornecedor do equipamento diz que "fala HL7", o novo prontuário anuncia "API FHIR", e o gestor fica sem saber se isso significa que a integração já está pronta ou que ainda falta um projeto inteiro.

Quase sempre falta um projeto. Os padrões HL7 e FHIR definem o formato da troca de dados entre sistemas de saúde, mas o mapeamento de códigos, a identificação do paciente e a homologação com cada fornecedor continuam por conta de quem integra. Este texto explica, sem jargão desnecessário, o que são esses padrões, onde eles aparecem na rotina de clínicas, laboratórios e hospitais e o que decidir antes de contratar uma integração.

A resposta curta: o que é integração HL7 e FHIR

HL7 é o nome de uma organização internacional e de uma família de padrões para troca de dados clínicos e administrativos entre sistemas de saúde. Quando alguém diz "integração HL7", quase sempre está falando do HL7 versão 2, um formato de mensagens de texto usado há décadas por equipamentos, sistemas de laboratório e sistemas hospitalares.

FHIR (pronuncia-se "fáier") é o padrão mais recente da mesma organização. Ele organiza os dados em recursos com nomes legíveis, como Paciente, Pedido de serviço, Observação e Relatório diagnóstico, e os expõe por APIs web, no mesmo estilo dos sistemas modernos de outros setores.

Integrar usando esses padrões significa que dois sistemas concordam sobre o formato da conversa. Não significa que concordem sobre o conteúdo: que código representa "hemograma completo", qual campo carrega o número do convênio, o que acontece quando um resultado é corrigido. Essa parte é sempre negociada caso a caso, e é ela que define o tamanho do projeto.

Por que integrar sistemas de saúde é diferente

Integrar ERP com loja virtual e integrar prontuário com laboratório usam técnicas parecidas. O que muda é o custo do erro e a quantidade de regras implícitas.

• Identidade do paciente é crítica. Um pedido vinculado ao paciente errado não é um transtorno comercial, é um risco clínico. Nome com grafia diferente, homônimos, CPF ausente em recém-nascidos e cadastros duplicados precisam de regra explícita.
• Resultado tem ciclo de vida. Um exame pode sair como parcial, final, corrigido ou cancelado. A integração precisa respeitar cada estado, e um laudo corrigido não pode simplesmente sobrescrever o anterior sem rastro.
• Vocabulário importa. "Glicose", "glicemia de jejum" e "GLI" podem ser o mesmo exame em três sistemas. Sem uma tabela de equivalência mantida por alguém, a integração entrega dado no lugar errado.
• Muitos fornecedores na mesma cadeia. Equipamento, sistema do laboratório, prontuário, faturamento de convênios: cada um tem um dono diferente e uma agenda diferente.
• Dados sensíveis por definição. Tudo o que trafega é dado de saúde, com proteção reforçada pela LGPD.

Se a sua clínica ainda está escolhendo o sistema principal, vale ler antes quando um sistema para clínica sob medida faz sentido: a facilidade de integrar deveria ser critério de escolha, não descoberta depois da compra.

HL7 v2 e FHIR em linguagem simples

HL7 v2: mensagens de texto com segmentos

Uma mensagem HL7 v2 é um bloco de texto dividido em linhas chamadas segmentos, cada uma com campos separados por barras verticais. Os segmentos mais comuns têm siglas de três letras: MSH é o cabeçalho (quem envia, quem recebe, tipo da mensagem), PID traz os dados do paciente, OBR descreve o pedido do exame e OBX carrega cada resultado.

As mensagens também têm tipos. Os que mais aparecem são de admissão e movimentação de pacientes (ADT), pedidos (ORM ou OML) e resultados (ORU). Em geral, a mensagem trafega por uma conexão de rede direta entre os sistemas, e quem recebe devolve uma confirmação.

O ponto fraco do HL7 v2 é a flexibilidade. O padrão permite tanta variação que cada fornecedor implementa à sua maneira, e "falar HL7" quase sempre vem acompanhado de um documento de especificação próprio, com os campos que aquele sistema realmente usa.

FHIR: recursos e APIs web

No FHIR, cada conceito é um recurso com estrutura definida, normalmente trocado em JSON por meio de APIs REST. Para buscar os resultados de um paciente, um sistema consulta os recursos de observação daquele paciente; para enviar um pedido, cria um recurso de pedido de serviço.

Isso facilita muito a vida de quem desenvolve: as ferramentas são as mesmas usadas em qualquer integração moderna, há exemplos públicos e o formato é legível. O FHIR também permite perfis, que são restrições e extensões adaptadas a um país ou a um uso específico. No Brasil, a Rede Nacional de Dados em Saúde do Ministério da Saúde adota FHIR, com perfis próprios.

Lado a lado

Na prática, um mesmo projeto costuma ter os dois: HL7 v2 na conversa com o sistema legado do laboratório e FHIR na ponta que conversa com o aplicativo do paciente ou com uma rede externa.

Onde esses padrões aparecem na rotina

Equipamentos de laboratório e interfaceamento

O interfaceamento é a conexão entre o analisador e o sistema do laboratório. O sistema envia a lista de trabalho (quais amostras, quais exames), o equipamento processa e devolve os resultados, sem digitação.

Muitos equipamentos usam o protocolo ASTM, mais antigo e às vezes ainda por porta serial; outros usam HL7 v2 por rede. Em comum, todos exigem:

• Identificação da amostra por código de barras, gerado no sistema e lido pelo equipamento.
• Tabela de equivalência entre os códigos de exame do equipamento e os do laboratório.
• Regras de liberação: resultado que vai direto para o laudo, resultado que precisa de revisão do bioquímico, resultado fora de faixa que gera alerta.
• Tratamento de repetição: quando a amostra é reprocessada, qual valor vale.

Pedidos, resultados e laudos entre sistemas

O segundo grande fluxo liga o prontuário ou o sistema da clínica ao laboratório ou à clínica de imagem:

1. O pedido nasce no prontuário, com paciente, exames, médico solicitante e dados do convênio.
2. O laboratório recebe o pedido já cadastrado, sem redigitação, e associa as amostras coletadas.
3. Os resultados voltam estruturados, campo a campo, e não só como PDF. Assim o médico consegue ver a evolução de um valor ao longo do tempo.
4. Correções e cancelamentos também voltam, com a versão anterior preservada.

Exames de imagem acrescentam outro padrão, o DICOM, que trata das imagens em si. O pedido e o laudo costumam trafegar em HL7 ou FHIR; as imagens, em DICOM.

Convênios e faturamento

A troca com operadoras de planos de saúde segue o padrão TISS, definido pela ANS. Ele não é HL7 nem FHIR, mas faz parte do mesmo desenho: o pedido que entra pela integração precisa carregar o que o faturamento vai precisar depois, como número da carteirinha, guia e autorização. Quando esses dados se perdem no caminho, a glosa aparece semanas depois. As versões e regras do TISS mudam ao longo do tempo, então vale validar o que se aplica com quem cuida do faturamento.

Dados sensíveis: cuidados de segurança e LGPD

A LGPD (Lei 13.709/2018) classifica dados referentes à saúde como dados pessoais sensíveis, com hipóteses de tratamento mais restritas. Para a integração, isso se traduz em requisitos concretos:

• Criptografia em trânsito. Mensagens HL7 v2 trafegando sem proteção por uma rede compartilhada não deveriam existir; o canal precisa ser protegido, por túnel seguro ou conexão criptografada.
• Logs sem excesso. É comum o log de integração guardar a mensagem inteira, com nome, diagnóstico e resultado. Guarde o necessário para investigar falhas, com acesso restrito e prazo de retenção definido.
• Mínimo necessário. O sistema de faturamento não precisa do resultado do exame; o equipamento não precisa do endereço do paciente.
• Controle de acesso e rastro. Quem consultou, quem reprocessou, quem alterou uma tabela de equivalência.
• Contratos com cada fornecedor da cadeia, definindo responsabilidades sobre os dados.

Os princípios gerais estão em LGPD no desenvolvimento de sistemas. As bases legais e as obrigações específicas do seu caso devem ser validadas com o jurídico e com o encarregado de dados.

Testes e homologação com o outro fornecedor

Na saúde, a integração quase nunca é só sua: do outro lado há um fornecedor com fila de atendimento, ambiente de testes próprio e documentação que pode estar desatualizada. É aqui que os prazos costumam escapar.

Um roteiro de homologação que funciona:

1. Peça a especificação de interface por escrito: versão do padrão, tipos de mensagem, campos obrigatórios, tabelas de códigos.
2. Confirme se existe ambiente de testes separado da produção. Testar com pacientes reais não é aceitável.
3. Monte os casos difíceis antes de começar: homônimos, paciente sem CPF, exame com vários resultados, resultado corrigido, pedido cancelado depois da coleta, convênio e particular no mesmo atendimento.
4. Combine quem valida o conteúdo clínico. O desenvolvedor confirma que a mensagem chegou; o bioquímico ou o médico confirma que o valor, a unidade e a referência estão certos.
5. Rode em paralelo com o processo atual por um período, comparando cada resultado integrado com o digitado.
6. Defina o plano de contingência: se a interface parar, como o laboratório continua trabalhando e como os resultados pendentes entram depois, sem duplicar.

Depois de entrar no ar, a integração precisa de monitoramento: fila de mensagens com erro, com motivo legível e opção de reprocessar, e alerta quando nada chega por tempo demais. Interface parada em silêncio é o pior cenário.

Quando não existe padrão: alternativas

Nem todo sistema de saúde fala HL7 ou FHIR. Sistema de clínica desenvolvido internamente, versão antiga sem atualização, fornecedor que não existe mais: tudo isso aparece com frequência. As alternativas, da mais robusta para a menos:

• API própria do fornecedor, mesmo fora do padrão, desde que documentada e estável.
• Troca de arquivos em pasta compartilhada ou servidor de arquivos, com formato combinado e conferência de recebimento.
• Leitura direta do banco de dados, só para consulta e com autorização do fornecedor, porque uma atualização do sistema pode mudar a estrutura sem aviso.
• Automação de tela, como último recurso, quando não há outra porta de entrada.

O caminho mais sustentável costuma ser um motor de integração no meio: uma camada que recebe de cada sistema no formato que ele consegue falar e entrega para o outro no formato que ele espera. Assim, trocar o equipamento ou o prontuário no futuro afeta só uma ponta. Os detalhes desse cenário estão em como integrar um sistema legado sem API.

Checklist antes de contratar a integração

• Quais sistemas participam e quem é o fornecedor de cada um?
• Cada sistema suporta HL7 v2, FHIR, ASTM, API própria ou nada?
• Existe especificação de interface por escrito e ambiente de testes?
• Quem é a fonte da verdade do cadastro de pacientes e como os duplicados são tratados?
• Quem mantém a tabela de equivalência de exames quando um novo for incluído?
• Como resultados corrigidos e cancelados devem aparecer no destino?
• Quais dados realmente precisam trafegar e por qual canal protegido?
• Quem valida o conteúdo clínico na homologação?
• O que acontece quando a interface para, e quem é avisado?

Se metade dessas perguntas ainda não tem resposta, o primeiro passo é um levantamento, não o desenvolvimento. Essa organização de fluxos, responsabilidades e pontos de falha é trabalho de arquitetura de software, antes de ser trabalho de código.

Perguntas frequentes

Qual a diferença entre HL7 e FHIR?

HL7 é a organização e a família de padrões; na prática, integração HL7 costuma significar HL7 versão 2, mensagens de texto em segmentos usadas por equipamentos e sistemas de laboratório. FHIR é o padrão mais recente da mesma organização, com recursos em JSON trocados por APIs web, mais fácil de desenvolver e consultar.

Se o equipamento já fala HL7, a integração está pronta?

Não. Um equipamento que fala HL7 oferece um formato de troca de dados, não uma integração pronta. Ainda falta mapear os códigos de exame, definir a identificação do paciente e da amostra, tratar resultados corrigidos e homologar com o fornecedor do sistema de laboratório, e é essa parte que define o tamanho do projeto.

O que é interfaceamento de equipamentos de laboratório?

Interfaceamento é a conexão entre o analisador e o sistema do laboratório. O sistema envia a lista de trabalho com amostras e exames, e o equipamento processa e devolve os resultados sem digitação. Muitos equipamentos usam o protocolo ASTM ou HL7 v2, e todos exigem código de barras na amostra e tabela de equivalência de exames.

A LGPD se aplica à integração entre sistemas de saúde?

Sim. A LGPD classifica dados referentes à saúde como dados pessoais sensíveis, e quase tudo o que trafega numa integração entre prontuário, laboratório e faturamento entra nessa categoria. Na prática, isso pede canal criptografado, logs sem excesso de dados, envio só do necessário, controle de acesso e contratos com cada fornecedor da cadeia.

Quanto tempo leva uma integração HL7 ou FHIR?

Depende do número de sistemas e equipamentos e, principalmente, da disponibilidade dos outros fornecedores na homologação, que é onde os prazos costumam escapar. Ter especificação de interface por escrito e ambiente de testes também pesa. Um cronograma confiável para a integração HL7 ou FHIR só sai depois de um levantamento dos fluxos.

Como a Pervian Tech trabalha integrações na saúde

Na Pervian Tech, começamos pelo diagnóstico inicial gratuito: mapeamos os sistemas envolvidos, o que cada um consegue expor, onde hoje existe digitação manual e quais casos a equipe resolve na mão. Com isso, desenhamos a integração sob medida, usando o padrão que cada ponta suporta e uma camada intermediária com fila, reprocessamento, monitoramento e os cuidados de LGPD desde o início. Veja também nossa página de integração de sistemas e outros textos da categoria de integrações.

O cronograma é definido depois do diagnóstico e depende muito da disponibilidade dos outros fornecedores na homologação. O investimento é sob consulta, porque varia com o número de sistemas, equipamentos e fluxos. Se o seu laboratório ou clínica ainda digita resultado que já existe em outro sistema, conte como funciona hoje.