Integração Servidor HL7 FHIR
- anderson.sielecki
Este artigo tem como objetivo orientar sobre como realizar a integração com o servidor HL7 FHIR da Unimed, seja por meio de sistemas já homologados com as empresas Shift e Genesis, ou via integração de laboratórios com software próprio utilizando a documentação técnica da API.
Através desse artigo você terá condições de
1️⃣ escolher o fluxo de integração adequado para o seu negócio
2️⃣ obter as credenciais de acesso,
3️⃣ integrar e consumir os dados via FHIR.
Também mantemos aqui o histórico de versões do Guia Técnico HL7 FHIR como referência.
Instruções
O que é o HL7 FHIR?
O HL7 FHIR (Fast Healthcare Interoperability Resources) é um padrão internacional utilizado para troca de dados clínicos entre sistemas de saúde de forma segura, padronizada e moderna. Baseado em tecnologias como RESTful APIs e JSON, o FHIR facilita a integração entre laboratórios, hospitais, clínicas, operadoras de saúde e sistemas públicos.
Endpoints e Portais Úteis
Ambientes | Descrição |
|---|---|
📘 Guia de Implementação – Documentação técnica, práticas recomendadas e recursos utilizados | |
(Homologação) https://hml02-fhir.pepunimed.com.br/ (Produção) | 🧪 Servidor Happi FHIR – Onde as requisições REST são enviadas e os recursos FHIR são consultados |
(Homologação) https://hml02-keycloak.pepunimed.com.br/auth/realms/fhir/protocol/openid-connect/token (Produção) https://keycloak.pepunimed.com.br/auth/realms/fhir/protocol/openid-connect/token
| 🔐 Token Keycloak – Endpoint de autenticação (OAuth2) para gerar access_token e refresh_token |
📂 Recursos FHIR utilizados na integração
A integração utiliza principalmente os seguintes recursos FHIR:
Atendimento | |
Bundle Transacional | |
Documento digitalizado | |
Estabelecimento | |
Laudo de Exame | |
Laudo de Exame de Imagem | |
Operadora | |
Paciente | |
Papel do Profissional | |
Profissional | |
Resultado de exame | |
Solicitação |
🔗 Detalhes de cada recurso podem ser obtidos através do guia de implementação:
https://hml02-interop.pepunimed.com.br/
Agora identifique seu cenário:
Se usa Shift ou Genesis, vá direto para o Guia de Integração com Sistemas Homologados.
Se utiliza outro software de laboratório, siga o Guia para Sistemas Não-Homologados