# International Patient Summary (IPS) in FHIR

> Le sezioni IPS e i codici LOINC, come viene costruito il Bundle del documento FHIR, un estratto reale generato dalla piattaforma e una chiamata per produrre un IPS validato.

Source: https://developers.anpheros.com/it/guides/international-patient-summary-fhir

**L'International Patient Summary (IPS) è un riassunto sanitario standard e minimo — allergie, farmaci, problemi e, quando disponibili, vaccinazioni, risultati e parametri vitali — impacchettato come un Bundle di documenti FHIR in modo che possa essere letto in qualsiasi paese.** È definito dalla [guida all'implementazione IPS](https://hl7.org/fhir/uv/ips/) di HL7 FHIR e utilizzato dall'European Health Data Space per l'assistenza transfrontaliera. Anpheros genera un IPS per qualsiasi paziente dal suo record FHIR R4 con una singola chiamata, `Patient/{id}/$summary`, e il risultato viene validato con 0 errori nel validatore ufficiale HL7.

## Le sezioni

<!-- visual:ips-sections -->

## Come è costruito il documento

Un FHIR IPS è un `Bundle` di tipo `document`, profilato `Bundle-uv-ips`. La sua prima voce è un `Composition` (LOINC 60591-5 "Patient summary Document"), le cui sezioni fanno riferimento alle risorse che seguono nel Bundle: le risorse Patient, AllergyIntolerance, MedicationStatement, Condition, Immunization e Observation, e l'autore e il custode. Ogni sezione contiene una narrazione XHTML generata, in modo che una persona possa leggere il documento senza software.

Questo estratto proviene da un documento reale generato dalla piattaforma per un paziente sintetico (id abbreviati):

```json
{
  "resourceType": "Bundle",
  "type": "document",
  "meta": {"profile": ["http://hl7.org/fhir/uv/ips/StructureDefinition/Bundle-uv-ips"]},
  "entry": [
    {"resource": {
      "resourceType": "Composition",
      "status": "final",
      "type": {"coding": [{"system": "http://loinc.org", "code": "60591-5", "display": "Patient summary Document"}]},
      "title": "International Patient Summary",
      "author": [{"reference": "Device/…", "display": "Anpheros Platform"}],
      "custodian": {"reference": "Organization/…", "display": "Anpheros"},
      "section": [
        {"title": "Allergies", "code": {"coding": [{"system": "http://loinc.org", "code": "48765-2"}]},
         "entry": [{"reference": "AllergyIntolerance/…"}]},
        {"title": "Medications", "code": {"coding": [{"system": "http://loinc.org", "code": "10160-0"}]},
         "entry": [{"reference": "MedicationStatement/…"}]}
      ]
    }},
    {"resource": {"resourceType": "Patient"}},
    {"resource": {"resourceType": "AllergyIntolerance"}},
    {"resource": {"resourceType": "MedicationStatement"}}
  ]
}
```

## Genera uno

```bash
curl "https://platform.anpheros.com/fhir/R4/Patient/$PID/\$summary?lang=en" \
  -H "Authorization: Bearer $KEY" -o ips.json
```

- Le sezioni obbligatorie non sono mai vuote: quando non viene registrato nulla, lo indicano con i codici IPS assente-o-sconosciuto, e un'applicazione può scrivere un esplicito "nessuna allergia nota".
- Le risorse con codici non validi vengono omesse e segnalate in un header di risposta, in modo che un record errato non interrompa il documento.
- `?lang=en` o `?lang=ro` impostano la lingua della narrazione.
- Un paziente al di fuori del tuo accesso restituisce `404`.

## Domande frequenti

### Cos'è un International Patient Summary?
Un riassunto minimo e agnostico rispetto alla specializzazione della salute di una persona — allergie, farmaci e problemi, più vaccinazioni, risultati e parametri vitali quando disponibili — standardizzato da HL7 come documento FHIR in modo che possa essere condiviso oltre i confini.

### Quali sezioni sono richieste in un IPS?
Allergie e intolleranze (LOINC 48765-2), riassunto dei farmaci (10160-0) e elenco dei problemi (11450-4). Vaccinazioni, risultati e parametri vitali sono raccomandati.

### Come genero un IPS dai dati FHIR?
Raccogli le risorse del paziente, crea una Composition con le sezioni e le narrative dell'IPS, e impacchetta tutto come un Bundle di documenti. Con Anpheros questa è una richiesta: `GET /fhir/R4/Patient/{id}/$summary`.

### L'IPS di Anpheros è validato?
Sì. Il documento generato viene validato con 0 errori nel validatore ufficiale HL7 FHIR rispetto alla guida di implementazione dell'IPS.

### A cosa serve l'IPS in Europa?
Lo Spazio Europeo dei Dati Sanitari elenca il riassunto del paziente tra le categorie prioritarie che devono essere scambiabili nel formato europeo.

<!-- visual:cta-ips -->

## Correlati

- [Piattaforma FHIR](https://developers.anpheros.com/it/guides/fhir): `$summary`, `$everything` e i 26 tipi di risorse
- [European Health Data Space (EHDS) per sviluppatori](https://developers.anpheros.com/it/guides/ehds-for-developers)
- [API per dati longitudinali del paziente](https://developers.anpheros.com/it/guides/longitudinal-patient-data-api)
- [Interoperabilità dei dati sanitari](https://developers.anpheros.com/it/guides/interoperability)
- [International Patient Summary, per i pazienti](https://anpheros.com/guides/international-patient-summary)