# Nemzetközi Betegösszefoglaló (IPS) FHIR-ben

> Az IPS szekciók és LOINC kódok, hogyan épül fel a FHIR dokumentum Bundle, egy valós, a platform által generált kivonat, és egyetlen hívás egy validált IPS előállításához.

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

**A Nemzetközi Betegösszefoglaló (IPS) egy standard, minimális egészségügyi összefoglaló — allergiák, gyógyszerek, problémák, és ha elérhető, oltások, eredmények és vitális adatok — FHIR dokumentum Bundle-ként csomagolva, hogy bármely országban olvasható legyen.** Az HL7 FHIR [IPS implementációs útmutatója](https://hl7.org/fhir/uv/ips/) határozza meg, és az Európai Egészségügyi Adattér használja határon átnyúló ellátás céljából. Az Anpheros egyetlen hívással, `Patient/{id}/$summary`, generál egy IPS-t bármely beteg FHIR R4 rekordjából, és az eredmény 0 hibával érvényes az hivatalos HL7 validátorban.

## A szakaszok

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

## A dokumentum felépítése

A FHIR IPS egy `Bundle` típusú `document`, amely `Bundle-uv-ips` profilozott. Az első bejegyzése egy `Composition` (LOINC 60591-5 "Patient summary Document"), amelynek szekciói a Bundle-ban következő erőforrásokra hivatkoznak: a Patient, az AllergyIntolerance, a MedicationStatement, a Condition, az Immunization és az Observation erőforrások, valamint a szerző és a gondozó. Minden szekció tartalmaz egy generált XHTML narratívát, így egy személy szoftver nélkül is el tudja olvasni a dokumentumot.

Ez a kivonat egy valós dokumentumból származik, amelyet a platform generált egy szintetikus páciens számára (az azonosítók rövidítve):

```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"}}
  ]
}
```

## Generálás

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

- A kötelező szekciók soha nem üresek: ha nincs feljegyezve semmi, akkor az IPS hiányzó-vagy-ismeretlen kódokkal jelzik, és egy alkalmazás írhat egy explicit "nincsenek ismert allergiák" bejegyzést.
- Érvénytelen kódokkal rendelkező erőforrások kimaradnak, és egy válasz fejlécben kerülnek jelentésre, így egy rossz rekord nem teszi tönkre a dokumentumot.
- A `?lang=en` vagy `?lang=ro` beállítja a narratíva nyelvét.
- Az Ön hozzáférésén kívül eső páciens `404`-et ad vissza.

## Gyakran ismételt kérdések

### Mi az a Nemzetközi Betegösszefoglaló (International Patient Summary)?
Egy minimális, szakterülettől független összefoglaló egy személy egészségi állapotáról – allergiák, gyógyszerek és problémák, valamint elérhető immunitások, eredmények és életjelek – amelyet az HL7 szabványosított FHIR dokumentumként, hogy országhatárokon át is megosztható legyen.

### Mely szakaszok kötelezőek az IPS-ben?
Allergiák és intoleranciák (LOINC 48765-2), gyógyszerösszefoglaló (10160-0) és problémalista (11450-4). Az immunitások, eredmények és életjelek ajánlottak.

### Hogyan generálhatok IPS-t FHIR adatokból?
Gyűjtse össze a beteg erőforrásait, építsen egy Composition-t az IPS szakaszokkal és leírásokkal, majd csomagoljon mindent egy dokumentum Bundle-ként. Az Anpheros-szal ez egyetlen kérés: `GET /fhir/R4/Patient/{id}/$summary`.

### Az Anpheros IPS érvényesítve van?
Igen. A generált dokumentum az IPS implementációs útmutató ellenében az hivatalos HL7 FHIR validátorban 0 hibával érvényesíthető.

### Mire használják az IPS-t Európában?
Az Európai Egészségügyi Adattér az európai formátumban cserélendő prioritási kategóriák között sorolja fel a betegösszefoglalót.

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

## Kapcsolódó

- [FHIR platform](https://developers.anpheros.com/hu/guides/fhir): `$summary`, `$everything` és a 26 erőforrás típus
- [Európai Egészségügyi Adattér (EHDS) fejlesztőknek](https://developers.anpheros.com/hu/guides/ehds-for-developers)
- [Longitudinális betegadat API](https://developers.anpheros.com/hu/guides/longitudinal-patient-data-api)
- [Egészségügyi adatintegráció](https://developers.anpheros.com/hu/guides/interoperability)
- [Nemzetközi Betegösszefoglaló, betegeknek](https://anpheros.com/guides/international-patient-summary)