/
Guia para Sistemas Não-Homologados

Guia para Sistemas Não-Homologados

Owned by anderson.sielecki
Last updated: jun. 13, 2025

Este guia tem como objetivo orientar laboratórios ou clínicas que não utilizam sistemas homologados e desejam realizar a integração direta com o servidor HL7 FHIR da Unimed Central RS, utilizando suas próprias soluções ou fornecedores técnicos.

 

Etapas da Integração para Sistemas Não-Homologados

Solicitação de credenciais

Entre em contato com a equipe técnica da Unimed Central RS para solicitar suas credenciais de integração.

Informe os dados abaixo:

  • Nome da empresa/unidade

  • CNPJ

  • Nome do sistema utilizado (interno ou terceiro)

  • Nome, e-mail e telefone do responsável técnico

Após análise e validação, você receberá por e-mail os seguintes dados de acesso:

  • client_id

  • client_secret

  • username

  • password

  • Endpoint para autenticação no Keycloak

 

Autenticação via Keycloak

Você deverá autenticar seu sistema utilizando os dados recebidos por e-mail. O endpoint de autenticação é:

🔗 https://hml02-keycloak.pepunimed.com.br/auth/realms/fhir/protocol/openid-connect/token

Exemplo de requisição:

curl --location 'https://hml02-keycloak.pepunimed.com.br/auth/realms/fhir/protocol/openid-connect/token' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'client_id=SEU_CLIENT_ID' \ --data-urlencode 'client_secret=SEU_CLIENT_SECRET' \ --data-urlencode 'grant_type=password' \ --data-urlencode 'scope=openid offline_access' \ --data-urlencode 'username=SEU_USUARIO' \ --data-urlencode 'password=SUA_SENHA'

3. 📘 Leitura técnica do Guia de Implementação

Com as credenciais em mãos, acesse o Guia de Implementação para consultar a documentação técnica dos recursos disponíveis e os formatos corretos para envio de dados:

🔗 https://hml02-interop.pepunimed.com.br/
📄 Guia Técnico de Integração FHIR Unimed Central RS

O guia traz detalhes sobre os recursos Patient, Observation, DiagnosticReport, ImagingStudy e Binary, bem como exemplos práticos, parâmetros obrigatórios e boas práticas.

4. 📘 Desenvolvimento e integração técnica

Desenvolva ou adapte seu sistema conforme os recursos descritos no guia técnico. As chamadas deverão ser feitas para o endpoint principal FHIR:

🔗 Servidor FHIR: https://hml02-fhir.pepunimed.com.br/

Recursos principais:

  • /Patient – Dados demográficos do paciente

  • /Observation – Resultados laboratoriais

  • /DiagnosticReport – Relatórios de exames

  • /ImagingStudy – Estudos de imagem médica

  • /Binary – Laudos ou arquivos associados (PDF, imagens etc.)

⚠️ As URIs são case-sensitive. Utilize, por exemplo, Patient com "P" maiúsculo, conforme padrão FHIR.

 

5. Solicitação de revisão e testes de integração

Após concluir a implementação, entre em contato com a Unimed para agendar as revisões de integração e os testes no ambiente de homologação. O processo pode incluir:

  • Validação dos dados enviados

  • Verificação da integridade dos relacionamentos entre recursos (Patient → Observation → DiagnosticReport)

  • Teste de exibição no portal final (goCare)

 

6. Visualização dos dados – GoCare

Os dados enviados via FHIR poderão ser consultados visualmente pela ferramenta goCare, onde os resultados dos exames estarão disponíveis em interface gráfica.

🔗 https://hml02-gocare.pepunimed.com.br/
🧑‍⚕️ Visualizador de resultados de exames