# Міжнародний резюме пацієнта (IPS) у FHIR

> Розділи IPS та коди LOINC, як побудовано FHIR Bundle, реальний приклад, згенерований платформою, та один виклик для створення валідованого IPS.

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

**Міжнародний резюме пацієнта (IPS) — це стандартний, мінімальний медичний огляд — алергії, ліки, проблеми та, за наявності, щеплення, результати та життєві показники — упакований як FHIR Bundle, щоб його можна було читати в будь-якій країні.** Він визначений [керівництвом з реалізації IPS](https://hl7.org/fhir/uv/ips/) HL7 FHIR і використовується Європейським простором даних охорони здоров'я для транскордонної допомоги. Anpheros генерує IPS для будь-якого пацієнта з його запису FHIR R4 одним викликом, `Patient/{id}/$summary`, і результат валідується з 0 помилками в офіційному валідаторі HL7.

## Розділи

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

## Як побудовано документ

FHIR IPS — це `Bundle` типу `document`, що відповідає профілю `Bundle-uv-ips`. Його перший запис — це `Composition` (LOINC 60591-5 "Patient summary Document"), розділи якого посилаються на ресурси, що йдуть далі в Bundle: ресурси Patient, AllergyIntolerance, MedicationStatement, Condition, Immunization та Observation, а також автор і зберігач. Кожен розділ містить згенерований XHTML наратив, щоб людина могла прочитати документ без програмного забезпечення.

Цей фрагмент походить зі справжнього документа, згенерованого платформою для синтетичного пацієнта (ідентифікатори скорочено):

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

## Згенерувати один

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

- Обов'язкові розділи ніколи не бувають порожніми: коли нічого не записано, це вказується кодами IPS absent-or-unknown, і програма може записати явне "no known allergies".
- Ресурси з недійсними кодами виключаються та повідомляються в заголовку відповіді, тому один некоректний запис не зламає документ.
- `?lang=en` або `?lang=ro` встановлює мову наративу.
- Пацієнт поза межами вашого доступу повертає `404`.

## Часті запитання

### Що таке Міжнародний резюме пацієнта (International Patient Summary)?
Мінімальний, незалежний від спеціальності резюме стану здоров'я особи — алергії, ліки та проблеми, а також щеплення, результати та життєві показники, коли вони доступні — стандартизоване HL7 як документ FHIR, щоб його можна було обмінювати між країнами.

### Які розділи є обов'язковими в IPS?
Алергії та непереносимості (LOINC 48765-2), резюме медикаментів (10160-0) та список проблем (11450-4). Рекомендовано щеплення, результати та життєві показники.

### Як згенерувати IPS з даних FHIR?
Зберіть ресурси пацієнта, створіть Composition з розділами IPS та описами, і упакуйте все як документ Bundle. З Anpheros це один запит: `GET /fhir/R4/Patient/{id}/$summary`.

### Чи проходить IPS від Anpheros валідацію?
Так. Згенерований документ проходить валідацію з 0 помилками в офіційному валідаторі HL7 FHIR відповідно до керівництва з реалізації IPS.

### Для чого використовується IPS в Європі?
Європейський простір даних про здоров'я (European Health Data Space) перелічує резюме пацієнта серед пріоритетних категорій, які повинні бути доступні для обміну в європейському форматі.

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

## Пов'язане

- [Платформа FHIR](https://developers.anpheros.com/uk/guides/fhir): `$summary`, `$everything` та 26 типів ресурсів
- [Європейський простір даних охорони здоров'я (EHDS) для розробників](https://developers.anpheros.com/uk/guides/ehds-for-developers)
- [API для поздовжніх даних пацієнта](https://developers.anpheros.com/uk/guides/longitudinal-patient-data-api)
- [Інтероперабельність медичних даних](https://developers.anpheros.com/uk/guides/interoperability)
- [Міжнародний резюме пацієнта, для пацієнтів](https://anpheros.com/guides/international-patient-summary)