---
title: "HL7 FHIR explicado: troca de dados de saúde por APIs | Quantlix"
description: "O HL7 FHIR é o padrão para trocar dados de saúde por APIs web. Saiba quais versões importam, o que o FHIR cobre e como ele molda projetos de software em saúde."
canonical: "https://quantlix.com/pt-br/normas/hl7-fhir/"
last-updated: 2026-11-16
---

Source: https://quantlix.com/pt-br/normas/hl7-fhir/
Language: pt-BR
Description: O HL7 FHIR é o padrão para trocar dados de saúde por APIs web. Saiba quais versões importam, o que o FHIR cobre e como ele molda projetos de software em saúde.

**HL7 FHIR** [Dados clínicos e de saúde](https://quantlix.com/pt-br/normas/#health)

# HL7 FHIR: o padrão de APIs web para dados de saúde

O HL7 FHIR é o padrão da HL7 International para trocar dados de saúde como recursos pequenos e interligados por APIs web, usado por prontuários eletrônicos, aplicativos para pacientes, operadoras de planos de saúde e plataformas de pesquisa.

[Converse sobre seu projeto](https://quantlix.com/pt-br/contato/) [Leia os pontos principais](https://quantlix.com/pt-br/normas/hl7-fhir/#standard-overview)

## Visão geral

**Nome completo**

Fast Healthcare Interoperability Resources (FHIR)

**Publicado por**

HL7 International

**Tipo**

Padrão de interoperabilidade (modelo de dados e especificação de API REST)

**Versão atual**

A Release 5 (5.0.0, março de 2023) é a versão publicada atual; a R4 (4.0.1) é a versão exigida pelas regras de certificação dos EUA; a R6 estava em votação normativa em 2026

**Aplica-se a**

Prestadores de serviços de saúde, operadoras de planos de saúde, fornecedores de TI em saúde e sistemas de saúde pública e de pesquisa que trocam dados clínicos e administrativos

**Última revisão**

16 de novembro de 2026 (2026-11-16)

## Em linguagem simples

### Pontos principais

- O FHIR modela os dados de saúde como recursos, como Patient, Observation e Encounter, que os sistemas leem e gravam por meio de uma API RESTful.
- A R4 trouxe o primeiro conteúdo normativo: a API REST, os formatos JSON e XML, os tipos de dados básicos, a terminologia, a conformidade e os recursos Patient e Observation.
- A R5 (5.0.0, março de 2023) é a versão publicada atual. A R6 ainda estava em votação normativa quando verificamos, em novembro de 2026.
- Os projetos reais funcionam com guias de implementação, como o US Core e o SMART App Launch, que criam perfis dos recursos básicos para um país ou caso de uso.

### O que é o HL7 FHIR?

O HL7 FHIR (Fast Healthcare Interoperability Resources) é **um padrão para trocar dados de saúde por meio de APIs web**, publicado pela HL7 International. Ele divide as informações clínicas e administrativas em recursos pequenos e bem definidos, como um paciente, uma observação, uma prescrição de medicamento ou um agendamento, e permite que os sistemas os leiam, pesquisem e atualizem por HTTP usando JSON ou XML.

Ele existe porque os padrões mais antigos de dados de saúde eram difíceis de usar fora dos motores de integração dos hospitais. O FHIR adota convenções conhecidas da web, então quem já construiu uma API REST consegue buscar um resultado de exame com ferramentas que já domina, enquanto o significado clínico se mantém o mesmo de um sistema para outro.

### O que o FHIR cobre

- **Recursos.** Blocos de construção definidos para dados clínicos, administrativos, financeiros e de fluxo de trabalho, cada um com elementos, tipos de dados e referências a outros recursos.
- **A API RESTful.** Interações padronizadas para criar, ler, atualizar, excluir, pesquisar e consultar o histórico, além de operações nomeadas para tarefas que vão além de leituras e gravações simples.
- **Formatos e bundles.** Representações em JSON e XML de cada recurso, com Bundles que agrupam recursos em documentos, mensagens, transações e resultados de pesquisa.
- **Terminologia.** Os recursos CodeSystem e ValueSet, que vinculam elementos a sistemas de códigos como SNOMED CT, LOINC e RxNorm.
- **Conformidade.** Os recursos StructureDefinition e CapabilityStatement, para que os guias de implementação criem perfis de recursos para um caso de uso e os servidores publiquem exatamente o que suportam.

### Versões e guias de implementação

As versões do FHIR são numeradas, e o número importa. **A R4 (4.0.1) foi a primeira versão com conteúdo normativo**: a API REST, os formatos JSON e XML, os tipos de dados básicos, as camadas de terminologia e conformidade e os recursos Patient e Observation, que a HL7 se compromete a manter compatíveis com versões anteriores. A R5 (5.0.0), publicada em março de 2023 como versão de uso experimental (trial use), é a versão atual no hl7.org, mas boa parte da base instalada ainda roda a R4. A R6 está em votação como um padrão totalmente normativo; a HL7 realizou sua segunda votação completa da R6 em 2026, e a R6 ainda não tinha sido publicada quando verificamos, em novembro de 2026.

A especificação básica é ampla de propósito, por isso o trabalho em produção depende de guias de implementação. Nos Estados Unidos, o US Core (hoje na STU 9, construído sobre a R4) define os perfis mínimos para dados de pacientes, e o SMART App Launch define como aplicativos e serviços de backend são autorizados. A TI em saúde certificada nos EUA precisa expor uma API FHIR R4 que siga esses guias, e outros países publicam seus próprios perfis nacionais.

### Como ele aparece em projetos de software

- **Escolha de versão e de perfil.** Cada interface indica a versão do FHIR e as versões dos guias que segue, porque “uma API FHIR” diz pouco sem elas.
- **Mapeamento e terminologia.** Registros de prontuários eletrônicos, laboratórios ou fluxos HL7 v2 são mapeados para recursos, e os códigos locais são traduzidos para os conjuntos de valores que cada perfil exige.
- **Autorização.** Os aplicativos são registrados e recebem escopos pelo SMART App Launch, com escopos de paciente, de usuário e de sistema, prazos de validade dos tokens e revogação tratados como qualquer outro direito de acesso.
- **Validação no pipeline.** Os recursos são verificados contra os perfis com o FHIR validator a cada build, e os servidores são testados contra o capability statement que publicam.
- **Privacidade e auditoria.** O acesso é registrado, por exemplo com os recursos AuditEvent e Provenance, e o projeto segue a lei de privacidade aplicável, como a HIPAA nos EUA.

### Como trabalhamos com o HL7 FHIR

Projetamos e construímos integrações FHIR para equipes de [saúde](https://quantlix.com/pt-br/setores/saude/) e de [ciências da vida](https://quantlix.com/pt-br/setores/ciencias-da-vida/): APIs FHIR sobre bancos de dados existentes, mapeamentos a partir do HL7 v2 e de formatos proprietários, aplicativos compatíveis com SMART e pipelines que transformam recursos em análises. As imagens costumam chegar pelo [DICOM](https://quantlix.com/pt-br/normas/dicom/) junto com o prontuário, e planejamos os controles de privacidade em torno da [HIPAA](https://quantlix.com/pt-br/normas/hipaa/) desde o primeiro sprint. Nossa equipe de [aplicações empresariais](https://quantlix.com/pt-br/servicos/aplicacoes-empresariais/) lidera esse trabalho de integração.

Somos precisos no que afirmamos. Podemos construir de acordo com um perfil definido e rodar seus validadores e kits de teste, enquanto a certificação em um programa nacional e a conformidade com a lei de privacidade em saúde cabem a você, ao seu organismo certificador e aos seus auditores. Se você está definindo o escopo de um projeto FHIR, [fale com a gente](https://quantlix.com/pt-br/contato/).

## Onde se aplica

Setores em que esta norma costuma influenciar o trabalho.

- ### [Saúde](https://quantlix.com/pt-br/setores/saude/)

  Fluxos de trabalho de hospitais e clínicas, saúde digital e tecnologia médica

## Normas relacionadas

[Todas as normas](https://quantlix.com/pt-br/normas/)

- DICOM

  ### [Dados e comunicação de imagens médicas](https://quantlix.com/pt-br/normas/dicom/)

  O DICOM é o padrão internacional de imagens médicas que define como imagens e dados relacionados são codificados, armazenados, trocados e exibidos, para que equipamentos, repositórios e visualizadores de fornecedores diferentes funcionem juntos.
- HIPAA

  ### [Privacidade e segurança de informações de saúde nos EUA](https://quantlix.com/pt-br/normas/hipaa/)

  A HIPAA é a lei federal dos EUA cujas regras de privacidade, segurança e notificação de violações determinam como planos de saúde, prestadores e os seus parceiros comerciais usam, divulgam e protegem as informações de saúde dos pacientes.
- CDISC

  ### [Padrões de dados de estudos clínicos](https://quantlix.com/pt-br/normas/cdisc/)

  O CDISC é uma organização global sem fins lucrativos cujos padrões de dados para pesquisa clínica, como SDTM, ADaM e Define-XML, são exigidos pela FDA e pela PMDA do Japão para os dados de estudos em pedidos de registro de medicamentos.

## Serviços que apoiam este trabalho

Os serviços que costumamos levar a projetos que envolvem esta norma.

[Ver todos os serviços](https://quantlix.com/pt-br/servicos/)

### [Aplicações empresariais](https://quantlix.com/pt-br/servicos/aplicacoes-empresariais/)

A Quantlix projeta e desenvolve aplicações empresariais para processos internos, regras de negócio e integração, com controles de acesso e arquitetura sustentável.

### [Desenvolvimento de aplicações web](https://quantlix.com/pt-br/servicos/desenvolvimento-de-aplicacoes-web/)

A Quantlix projeta aplicações web com interfaces responsivas, regras de negócio e integrações, considerando acessibilidade, desempenho e manutenção.

### [Análise de dados](https://quantlix.com/pt-br/servicos/analise-de-dados/)

A Quantlix desenvolve pipelines de dados e ferramentas de inteligência de negócios que transformam dados operacionais em métricas definidas e apoio à decisão.

## Perguntas e respostas

O que as equipes costumam nos perguntar sobre esta norma.

**Em qual versão do FHIR devemos construir?**

Para a maior parte do trabalho em produção hoje, a R4 (4.0.1). As regras de certificação de TI em saúde dos EUA e o guia US Core se baseiam nela, e o seu núcleo é normativo. A R5 é a versão publicada atual e a R6 estava em votação normativa em 2026, então mantenha a versão atrás de uma camada de mapeamento em vez de espalhá-la pelo código.

**O FHIR é obrigatório?**

O FHIR em si é um padrão voluntário, mas alguns regulamentos o exigem. Nos Estados Unidos, a TI em saúde certificada precisa oferecer uma API padronizada construída sobre o FHIR R4, o US Core e o SMART App Launch, conforme o critério de certificação 170.315(g)(10). Outros países definem seus próprios perfis e regras nacionais.

**Qual é a diferença entre o FHIR e o HL7 versão 2?**

O HL7 v2 é um padrão de mensagens mais antigo, formado por segmentos separados por barras verticais, ainda comum nas integrações hospitalares, como admissões e resultados de exames. O FHIR usa recursos, JSON ou XML e APIs web. Muitas organizações usam os dois, com interfaces que fazem o mapeamento entre eles.

**O que é SMART on FHIR?**

O SMART App Launch é um guia de implementação da HL7 que usa OAuth 2.0 para que aplicativos possam ser autorizados a acessar dados FHIR, seja quando iniciados por um usuário, seja rodando como serviço de backend sem um usuário presente. A versão 2.2.0 é a versão publicada atual.

**Um software pode ser certificado para FHIR?**

A HL7 não certifica produtos com base na especificação básica. A conformidade é demonstrada com testes contra perfis específicos, por exemplo com o FHIR validator e os kits de teste dos guias de implementação, e programas nacionais, como a certificação de TI em saúde dos EUA, testam os produtos contra requisitos FHIR definidos.

## Fontes oficiais

Consulte o texto oficial antes de se apoiar em qualquer detalhe. O que se aplica a você depende do seu papel, da sua localização e da versão em vigor.

- [Especificação HL7 FHIR (versão atual)](https://hl7.org/fhir/)
- [Histórico de publicações do FHIR](https://hl7.org/fhir/history.html)
- [FHIR R4 (4.0.1)](https://hl7.org/fhir/R4/)
- [Critério de certificação de API padronizada 170.315(g)(10)](https://www.healthit.gov/test-method/standardized-api-patient-and-population-services)

Estes guias explicam cada norma em linguagem simples. Eles não são aconselhamento jurídico e não afirmam que algum produto ou organização esteja em conformidade com uma norma.

## Planejando um software em torno desta norma?

Conte quais sistemas estão envolvidos e o que você precisa demonstrar. Ajudamos a incorporar os requisitos desde o início.

[Converse sobre seu projeto](https://quantlix.com/pt-br/contato/)
