# Interoperabilità dei dati sanitari

> I livelli tecnico, sintattico, semantico e organizzativo dell'interoperabilità, gli standard utilizzati da Anpheros (FHIR R4, IPS, SMART on FHIR, HL7 v2) e perché la provenienza rende affidabili i dati scambiati.

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

**L'interoperabilità dei dati sanitari è la capacità di sistemi diversi — app, cliniche, laboratori, ospedali, servizi di IA — di scambiare dati sanitari e utilizzarli senza doverli reinterpretare manualmente.** Anpheros la affronta memorizzando ogni record nei formati che gli altri sistemi già comprendono (HL7 FHIR R4 con sistemi di codifica standard), scambiandoli tramite protocolli standard (FHIR REST, SMART on FHIR, International Patient Summary, messaggi di laboratorio HL7 v2) e mantenendo il contesto che rende affidabili i dati scambiati: chi li ha scritti, quando e con quale consenso.

## Quattro livelli di interoperabilità

| Livello | Domanda a cui risponde | Come Anpheros lo affronta |
|---|---|---|
| Tecnico | I sistemi possono connettersi? | API HTTPS, OAuth 2.1, webhook firmati, SDK in Dart e TypeScript |
| Sintattico | Possono interpretare i dati l'uno dell'altro? | Risorse e bundle HL7 FHIR R4 (4.0.1); CSV, HL7 v2 ORU^R01 e JSON accettati per i risultati di laboratorio |
| Semantico | Hanno lo stesso significato? | LOINC per misurazioni e risultati, ICD-10 per condizioni, ATC per farmaci, UCUM per unità; testo originale mantenuto accanto a ogni codice |
| Organizzativo | Possono scambiarli e fidarsi di essi? | Consenso del paziente per applicazione, provenienza su ogni scrittura, log di accesso visibile al paziente |

La maggior parte dei progetti di integrazione fallisce a livello semantico e organizzativo, non tecnico. La codifica al momento della scrittura e la registrazione della provenienza per ogni valore rendono i dati da una fonte utilizzabili in un'altra.

## Standard Anpheros utilizza

- **HL7 FHIR R4.** Ogni record è composto da risorse FHIR — 26 tipi — ricercabili e versionate, con una CapabilityStatement a `/fhir/R4/metadata`. [Piattaforma FHIR](https://developers.anpheros.com/it/guides/fhir)
- **International Patient Summary (IPS).** `Patient/{id}/$summary` restituisce un bundle di documenti IPS, validato con il validatore ufficiale HL7 contro `hl7.fhir.uv.ips#1.1.0` con 0 errori. L'IPS è il formato di riepilogo destinato all'assistenza transfrontaliera in Europa.
- **Regole per i referti di laboratorio HL7 Europe.** I risultati di laboratorio vengono controllati in fase di scrittura; le lacune vengono segnalate nell'header di risposta `Anpheros-Conformance` (oggi consultivo). `Observation/$validate?profile=eu-lab` esegue il controllo su richiesta.
- **SMART on FHIR.** Le applicazioni di terze parti accedono a un record tramite OAuth 2.1 con PKCE e scope paziente SMART v2; discovery a `/fhir/R4/.well-known/smart-configuration`. Il gruppo di test di avvio standalone della suite Inferno SMART App Launch STU2 viene superato; l'avvio EHR non è ancora supportato.
- **HL7 v2.** I risultati di laboratorio arrivano come messaggi `ORU^R01` oltre a CSV o JSON, e diventano FHIR Observations. [Connettore di laboratorio](https://developers.anpheros.com/it/guides/lab-connector)
- **European Health Data Space.** FHIR R4 e l'IPS sono i formati su cui si basa l'EHDS per i riepiloghi dei pazienti e i risultati di laboratorio; Anpheros li segue. Questo è un allineamento con i formati, non una certificazione.

## Modelli di scambio

1.  **Accesso all'applicazione con consenso** — un'applicazione richiede al paziente gli ambiti (scopes), legge e scrive il record tramite FHIR o REST, e perde l'accesso quando il paziente lo revoca.
2.  **Scambio di documenti** — il record, o il suo riassunto, viene esportato come bundle FHIR (`$everything`, `$summary`).
3.  **Risultati in ingresso** — laboratori e cliniche scrivono nel record per conto della loro organizzazione; il paziente vede chi ha scritto cosa.
4.  **Eventi** — agli iscritti viene comunicato che qualcosa è cambiato (solo ID, mai contenuto clinico) e leggono ciò che è loro consentito.

## Provenance: interoperabilità di cui ci si può fidare

I dati che viaggiano tra sistemi perdono il loro contesto a meno che il contesto non viaggi con essi. In Anpheros ogni versione di ogni risorsa registra:

- il **tipo di autore** — paziente, professionista sanitario, dispositivo, importazione o IA;
- l'**organizzazione** per conto della quale è stata scritta e, quando nominato, il **professionista sanitario**;
- il **sistema sorgente** e il suo ID lì (`X-Anpheros-Source-System`, `X-Anpheros-Origin-Id`).

I valori prodotti dall'IA sono etichettati come tali e vengono tenuti separati dai fatti clinici quando viene costruito un contesto per un modello.

## Identità tra applicazioni

Ogni applicazione vede il proprio identificatore per la stessa persona (ID pairwise), quindi i record non possono essere correlati tra applicazioni a insaputa del paziente. I riferimenti a persone al di fuori dell'ambito di un'applicazione sono mascherati. L'interoperabilità avviene tramite consenso, non tramite identificatori condivisi.

## Correlati

- [Come normalizzare i dati medici](https://developers.anpheros.com/it/guides/normalize-medical-data): codici, unità, date, duplicati, validazione
- [Provenienza dei dati medici spiegata](https://developers.anpheros.com/it/guides/medical-data-provenance): chi ha scritto cosa e come registrarlo
- [Come integrare sistemi clinici con un backend FHIR](https://developers.anpheros.com/it/guides/integrate-clinic-systems-fhir): tutorial passo-passo per EMR clinici
- [Come importare risultati di laboratorio in un record FHIR](https://developers.anpheros.com/it/guides/import-lab-results-fhir): tutorial passo-passo con CSV e HL7 v2
- [Piattaforma FHIR](https://developers.anpheros.com/it/guides/fhir)
- [Integrazioni sanitarie](https://developers.anpheros.com/it/guides/healthcare-integrations)
- [Sistemi di codici FHIR](https://developers.anpheros.com/it/guides/fhir-code-systems)
- [API Sanitaria](https://developers.anpheros.com/it/guides/healthcare-api)
- [Infrastruttura dati medici](https://developers.anpheros.com/it/guides/medical-data-infrastructure)
- [DICOM vs FHIR](https://developers.anpheros.com/it/guides/dicom-vs-fhir): dati di imaging e dati clinici, e come si collegano
- [API risultati di laboratorio](https://developers.anpheros.com/it/guides/lab-results-api): HL7 v2 e FHIR per risultati di laboratorio
- [FHIR vs HL7 v2](https://developers.anpheros.com/it/guides/fhir-vs-hl7-v2): messaggi e risorse a confronto
- [Lo Spazio Europeo dei Dati Sanitari (EHDS) per sviluppatori](https://developers.anpheros.com/it/guides/ehds-for-developers)