# International Patient Summary (IPS) ve FHIR

> Sekce IPS a kódy LOINC, jak je sestaven FHIR document Bundle, skutečný výňatek vygenerovaný platformou a jeden volání pro vytvoření validovaného IPS.

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

**International Patient Summary (IPS) je standardní, minimální zdravotní souhrn — alergie, léky, problémy a, pokud jsou k dispozici, imunizace, výsledky a vitální funkce — zabalený jako FHIR document Bundle, aby jej bylo možné číst v jakékoli zemi.** Je definován [IPS implementation guide](https://hl7.org/fhir/uv/ips/) od HL7 FHIR a používá se v European Health Data Space pro přeshraniční péči. Anpheros generuje IPS pro jakéhokoli pacienta z jeho FHIR R4 záznamu jedním voláním, `Patient/{id}/$summary`, a výsledek je validován s 0 chybami v oficiálním HL7 validátoru.

## Sekce

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

## Jak je dokument sestaven

FHIR IPS je `Bundle` typu `document`, profilovaný `Bundle-uv-ips`. Jeho první položkou je `Composition` (LOINC 60591-5 "Patient summary Document"), jehož sekce odkazují na zdroje, které následují v Bundle: zdroje Patient, AllergyIntolerance, MedicationStatement, Condition, Immunization a Observation, a také autor a správce. Každá sekce nese vygenerovaný XHTML narativ, takže dokument může číst i člověk bez softwaru.

Tento výňatek pochází ze skutečného dokumentu vygenerovaného platformou pro syntetického pacienta (ID zkrácena):

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

## Generování jednoho záznamu

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

- Povinné sekce nejsou nikdy prázdné: pokud není nic zaznamenáno, uvádí se to pomocí kódů IPS absent-or-unknown a aplikace může zapsat explicitní "no known allergies".
- Zdroje s neplatnými kódy jsou vynechány a nahlášeny v hlavičce odpovědi, takže jeden chybný záznam nerozbije dokument.
- `?lang=en` nebo `?lang=ro` nastavuje jazyk vyprávění.
- Pacient mimo váš přístup vrací `404`.

## Často kladené dotazy

### Co je International Patient Summary (IPS)?
Minimální, oborově nezávislý souhrn zdravotního stavu osoby — alergie, léky a problémy, plus očkování, výsledky a vitální funkce, pokud jsou k dispozici — standardizovaný organizací HL7 jako dokument FHIR, aby jej bylo možné sdílet přes hranice.

### Které sekce jsou v IPS povinné?
Alergie a intolerance (LOINC 48765-2), souhrn léků (10160-0) a seznam problémů (11450-4). Očkování, výsledky a vitální funkce jsou doporučené.

### Jak vygeneruji IPS z dat FHIR?
Shromážděte zdroje pacienta, sestavte Composition s částmi a popisy IPS a vše zabalte jako dokument Bundle. S Anpheros je to jeden požadavek: `GET /fhir/R4/Patient/{id}/$summary`.

### Je IPS od Anpheros validován?
Ano. Vygenerovaný dokument je validován s 0 chybami v oficiálním validátoru HL7 FHIR proti implementačnímu průvodci IPS.

### K čemu se IPS používá v Evropě?
Evropský prostor pro zdravotní údaje uvádí souhrn pacienta mezi prioritní kategorie, které musí být směnitelnné v evropském formátu.

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

## Související

- [Platforma FHIR](https://developers.anpheros.com/cs/guides/fhir): `$summary`, `$everything` a 26 typů zdrojů
- [Evropský prostor pro zdravotnická data (EHDS) pro vývojáře](https://developers.anpheros.com/cs/guides/ehds-for-developers)
- [API pro longitudinální data pacienta](https://developers.anpheros.com/cs/guides/longitudinal-patient-data-api)
- [Interoperabilita zdravotnických dat](https://developers.anpheros.com/cs/guides/interoperability)
- [Mezinárodní souhrn pacienta, pro pacienty](https://anpheros.com/guides/international-patient-summary)