# Interoperabilidade de dados de saúde

> Os níveis técnico, sintático, semântico e organizacional de interoperabilidade, os padrões que o Anpheros utiliza (FHIR R4, IPS, SMART on FHIR, HL7 v2) e por que a proveniência torna os dados trocados confiáveis.

Source: https://developers.anpheros.com/pt/guides/interoperability

**A interoperabilidade de dados de saúde é a capacidade de diferentes sistemas — aplicações, clínicas, laboratórios, hospitais, serviços de IA — trocarem dados de saúde e utilizá-los sem os reinterpretar manualmente.** O Anpheros aborda-a armazenando cada registo nos formatos que outros sistemas já compreendem (HL7 FHIR R4 com sistemas de codificação padrão), trocando-o através de protocolos padrão (FHIR REST, SMART on FHIR, o International Patient Summary, mensagens de laboratório HL7 v2) e mantendo o contexto que torna os dados trocados confiáveis: quem os escreveu, quando e com o consentimento de quem.

## Quatro níveis de interoperabilidade

| Nível | Pergunta que responde | Como o Anpheros o aborda |
|---|---|---|
| Técnico | Os sistemas conseguem conectar-se? | APIs HTTPS, OAuth 2.1, webhooks assinados, SDKs em Dart e TypeScript |
| Sintático | Conseguem analisar os dados um do outro? | Recursos e bundles HL7 FHIR R4 (4.0.1); CSV, HL7 v2 ORU^R01 e JSON aceites para resultados de laboratório |
| Semântico | Significam a mesma coisa? | LOINC para medições e resultados, ICD-10 para condições, ATC para medicamentos, UCUM para unidades; texto original mantido ao lado de cada código |
| Organizacional | Podem trocá-lo e podem confiar nele? | consentimento do paciente por aplicação, proveniência em cada escrita, um registo de acesso visível para o paciente |

A maioria dos projetos de integração falha nos níveis semântico e organizacional, não no técnico. Codificar no momento da escrita e registar a proveniência para cada valor são o que tornam os dados de uma fonte utilizáveis noutra.

## Normas utilizadas pelo Anpheros

- **HL7 FHIR R4.** Cada registo é composto por recursos FHIR — 26 tipos — pesquisáveis e com controlo de versão, com uma CapabilityStatement em `/fhir/R4/metadata`. [Plataforma FHIR](https://developers.anpheros.com/pt/guides/fhir)
- **International Patient Summary (IPS).** `Patient/{id}/$summary` devolve um bundle de documento IPS, validado com o validador oficial HL7 contra `hl7.fhir.uv.ips#1.1.0` com 0 erros. O IPS é o formato de resumo destinado a cuidados transfronteiriços na Europa.
- **Regras de relatórios laboratoriais HL7 Europe.** Os resultados laboratoriais são verificados na escrita; lacunas são reportadas no cabeçalho de resposta `Anpheros-Conformance` (consultivo hoje). `Observation/$validate?profile=eu-lab` executa a verificação a pedido.
- **SMART on FHIR.** Aplicações de terceiros acedem a um registo através de OAuth 2.1 com PKCE e scopes de paciente SMART v2; descoberta em `/fhir/R4/.well-known/smart-configuration`. O grupo de teste de lançamento standalone do conjunto Inferno SMART App Launch STU2 é aprovado; o lançamento EHR não é suportado ainda.
- **HL7 v2.** Os resultados laboratoriais chegam como mensagens `ORU^R01`, bem como CSV ou JSON, e tornam-se Observações FHIR. [Conector de laboratório](https://developers.anpheros.com/pt/guides/lab-connector)
- **Espaço Europeu de Dados de Saúde.** FHIR R4 e o IPS são os formatos em que o EHDS se baseia para resumos de pacientes e resultados laboratoriais; o Anpheros segue-os. Isto é alinhamento com os formatos, não uma certificação.

## Padrões de troca

1. **Acesso de aplicação consentido** — uma aplicação pede ao paciente as permissões (scopes), lê e escreve no registo através de FHIR ou REST, e perde o acesso quando o paciente o revoga.
2. **Troca de documentos** — o registo, ou o seu resumo, sai como um pacote FHIR (`$everything`, `$summary`).
3. **Resultados de entrada** — laboratórios e clínicas escrevem no registo em nome da sua organização; o paciente vê quem escreveu o quê.
4. **Eventos** — os subscritores são informados de que algo mudou (apenas IDs, nunca conteúdo clínico) e leem o que lhes é permitido.

## Proveniência: interoperabilidade em que pode confiar

Os dados que viajam entre sistemas perdem o seu contexto, a menos que o contexto viaje com eles. No Anpheros, cada versão de cada recurso regista:

- o **tipo de autor** — paciente, profissional de saúde, dispositivo, importação ou IA;
- a **organização** em nome de quem foi escrito e, quando nomeado, o **profissional de saúde**;
- o **sistema de origem** e o seu ID de registo (`X-Anpheros-Source-System`, `X-Anpheros-Origin-Id`).

Os valores produzidos por IA são rotulados como tal e mantidos separados dos factos clínicos quando um contexto é construído para um modelo.

## Identidade entre aplicações

Cada aplicação vê o seu próprio identificador para a mesma pessoa (IDs par a par), pelo que os registos não podem ser correlacionados entre aplicações sem o conhecimento do paciente. As referências a pessoas fora do âmbito de uma aplicação são mascaradas. A interoperabilidade acontece através de consentimento, não através de identificadores partilhados.

## Relacionado

- [Como normalizar dados médicos](https://developers.anpheros.com/pt/guides/normalize-medical-data): códigos, unidades, datas, duplicados, validação
- [Proveniência de dados médicos explicada](https://developers.anpheros.com/pt/guides/medical-data-provenance): quem escreveu o quê e como registar
- [Como integrar sistemas de clínica com um backend FHIR](https://developers.anpheros.com/pt/guides/integrate-clinic-systems-fhir): tutorial passo a passo para EMRs de clínica
- [Como importar resultados de laboratório para um registo FHIR](https://developers.anpheros.com/pt/guides/import-lab-results-fhir): tutorial passo a passo com CSV e HL7 v2
- [Plataforma FHIR](https://developers.anpheros.com/pt/guides/fhir)
- [Integrações de saúde](https://developers.anpheros.com/pt/guides/healthcare-integrations)
- [Sistemas de código FHIR](https://developers.anpheros.com/pt/guides/fhir-code-systems)
- [API de saúde](https://developers.anpheros.com/pt/guides/healthcare-api)
- [Infraestrutura de dados médicos](https://developers.anpheros.com/pt/guides/medical-data-infrastructure)
- [DICOM vs FHIR](https://developers.anpheros.com/pt/guides/dicom-vs-fhir): dados de imagem e dados clínicos, e como se conectam
- [API de resultados de laboratório](https://developers.anpheros.com/pt/guides/lab-results-api): HL7 v2 e FHIR para resultados de laboratório
- [FHIR vs HL7 v2](https://developers.anpheros.com/pt/guides/fhir-vs-hl7-v2): mensagens e recursos comparados
- [O Espaço Europeu de Dados de Saúde (EHDS) para programadores](https://developers.anpheros.com/pt/guides/ehds-for-developers)