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

> Integração HL7 e FHIR explicada para gestores de clínicas, laboratórios e hospitais: onde os padrões aparecem, o que testar e como evitar retrabalho.

Fonte: https://pervian.tech/blog/integracao-hl7-fhir-na-saude · Pervian Tech · publicado em 2026-10-01

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](https://pervian.tech/blog/sincronizacao-de-cadastros-entre-sistemas) 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](https://pervian.tech/blog/sistema-para-clinica-sob-medida): 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

| Aspecto | HL7 v2 | FHIR |
|---|---|---|
| Formato | Texto em segmentos com separadores | Recursos em JSON ou XML |
| Transporte típico | Conexão de rede direta entre sistemas | API web (HTTPS) |
| Onde predomina | Equipamentos, sistemas de laboratório e hospitalares mais antigos | Sistemas novos, aplicativos, portais e redes públicas |
| Ponto forte | Muito difundido, maduro, suportado por quase todo fornecedor do setor | Fácil de desenvolver, consultar e evoluir |
| Ponto de atenção | Cada implementação tem suas variações | Adoção ainda desigual entre fornecedores |

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](https://pervian.tech/blog/integrar-balancas-e-equipamentos-ao-sistema). 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](https://pervian.tech/blog/retencao-e-descarte-de-dados-pessoais) 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](https://pervian.tech/blog/controle-de-acesso-e-trilha-de-auditoria).** 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](https://pervian.tech/blog/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](https://pervian.tech/blog/integrar-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](https://pervian.tech/servicos/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](https://pervian.tech/solucoes/integracao-de-sistemas) e outros textos da [categoria de integrações](https://pervian.tech/blog/categoria/integracoes).

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](https://pervian.tech/#contato).