# International Patient Summary (IPS) в FHIR

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

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

**International Patient Summary (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 errors) в официальном валидаторе HL7 FHIR согласно руководству по реализации IPS.

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

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

## Связанные материалы

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