# Medzinárodný súhrn pacienta (IPS) vo FHIR

> Sekcie IPS a kódy LOINC, ako je zostavený FHIR dokument Bundle, reálny výňatok vygenerovaný platformou a jeden volanie na produkciu validovaného IPS.

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

**Medzinárodný súhrn pacienta (IPS) je štandardný, minimálny zdravotný súhrn — alergie, lieky, problémy a, ak sú k dispozícii, očkovania, výsledky a vitálne funkcie — zabalený ako FHIR dokument Bundle, aby ho bolo možné prečítať v ktorejkoľvek krajine.** Je definovaný [IPS implementačným sprievodcom](https://hl7.org/fhir/uv/ips/) HL7 FHIR a používa sa Európskym priestorom pre zdravotné údaje pre cezhraničnú starostlivosť. Anpheros generuje IPS pre akéhokoľvek pacienta z ich FHIR R4 záznamu jedným volaním, `Patient/{id}/$summary`, a výsledok sa validuje s 0 chybami v oficiálnom validátore HL7.

## Sekcie

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

## Ako je dokument zostavený

FHIR IPS je `Bundle` typu `document`, profilovaný `Bundle-uv-ips`. Jeho prvým záznamom je `Composition` (LOINC 60591-5 "Patient summary Document"), ktorého sekcie odkazujú na zdroje, ktoré nasledujú v Bundle: zdroje Patient, AllergyIntolerance, MedicationStatement, Condition, Immunization a Observation, ako aj autor a správca. Každá sekcia obsahuje vygenerovaný XHTML príbeh, takže dokument môže čítať aj osoba bez softvéru.

Tento úryvok pochádza zo skutočného dokumentu vygenerovaného platformou pre syntetického pacienta (ID skrátené):

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

## Generovanie jedného

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

- Požadované sekcie nie sú nikdy prázdne: keď nie je nič zaznamenané, uvádza sa to pomocou kódov IPS absent-or-unknown a aplikácia môže explicitne zapísať "no known allergies".
- Zdroje s neplatnými kódmi sú vynechané a hlásené v hlavičke odpovede, takže jeden chybný záznam nerozbije dokument.
- `?lang=en` alebo `?lang=ro` nastavuje jazyk textového popisu.
- Pacient mimo vášho prístupu vráti `404`.

## Často kladené otázky

### Čo je International Patient Summary (IPS)?
Minimálny, špecializáciou-agnostický súhrn zdravia osoby — alergie, lieky a problémy, plus očkovania, výsledky a vitálne funkcie, ak sú k dispozícii — štandardizovaný HL7 ako FHIR dokument, aby bolo možné ho zdieľať cez hranice.

### Ktoré sekcie sú v IPS povinné?
Alergie a intolerancie (LOINC 48765-2), súhrn liekov (10160-0) a zoznam problémov (11450-4). Očkovania, výsledky a vitálne funkcie sú odporúčané.

### Ako vygenerujem IPS z FHIR dát?
Zhromaždite zdroje pacienta, vytvorte Composition s IPS sekciami a naratívmi a všetko zabaľte ako dokument Bundle. S Anpheros je to jedna požiadavka: `GET /fhir/R4/Patient/{id}/$summary`.

### Je Anpheros IPS validovaný?
Áno. Vygenerovaný dokument sa validuje s 0 chybami v oficiálnom HL7 FHIR validátore voči implementačnému sprievodcovi IPS.

### Na čo sa IPS používa v Európe?
Európsky priestor pre zdravotné údaje uvádza súhrn pacienta medzi prioritné kategórie, ktoré musia byť vymeniteľné v európskom formáte.

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

## Súvisiace

- [Platforma FHIR](https://developers.anpheros.com/sk/guides/fhir): `$summary`, `$everything` a 26 typov zdrojov
- [Európsky priestor pre zdravotnícke údaje (EHDS) pre vývojárov](https://developers.anpheros.com/sk/guides/ehds-for-developers)
- [API pre longitudinálne údaje o pacientoch](https://developers.anpheros.com/sk/guides/longitudinal-patient-data-api)
- [Interoperabilita zdravotníckych údajov](https://developers.anpheros.com/sk/guides/interoperability)
- [Medzinárodný súhrn pacienta, pre pacientov](https://anpheros.com/guides/international-patient-summary)