# FHIR 中的国际患者摘要 (IPS)

> IPS 部分和 LOINC 代码、FHIR 文档 Bundle 的构建方式、平台生成的真实摘录以及生成已验证 IPS 的一个调用。

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

**国际患者摘要 (IPS) 是一个标准的、最小化的健康摘要 — 包括过敏、用药、问题，以及在可用时包括免疫接种、检查结果和生命体征 — 它被打包成一个 FHIR 文档 Bundle，以便在任何国家都能读取。** 它由 HL7 FHIR [IPS 实现指南](https://hl7.org/fhir/uv/ips/) 定义，并被欧洲健康数据空间用于跨境医疗。Anpheros 通过一个调用 `Patient/{id}/$summary`，即可为任何患者从其 FHIR R4 记录生成 IPS，并且结果在官方 HL7 验证器中验证时显示 0 个错误。

## 各个部分

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

## 文档构建方式

FHIR IPS 是一个类型为 `document` 的 `Bundle`，经过 `Bundle-uv-ips` 剖析。它的第一个条目是 `Composition`（LOINC 60591-5 "Patient summary Document"），其各个部分引用 Bundle 中后续的资源：Patient、AllergyIntolerance、MedicationStatement、Condition、Immunization 和 Observation 资源，以及作者和保管者。每个部分都包含一个生成的 XHTML 叙述，以便用户无需软件即可阅读文档。

此摘录来自平台为合成患者生成的真实文档（ID 已缩短）：

```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 缺失或未知代码来表示，应用程序可以明确写入“无已知过敏”。
- 包含无效代码的资源将被省略，并在响应头中报告，因此一个错误的记录不会破坏整个文档。
- `?lang=en` 或 `?lang=ro` 设置叙述的语言。
- 超出您访问权限的患者将返回 `404`。

## 常见问题解答

### 什么是国际患者摘要 (International Patient Summary)？
一种最小化的、与专业无关的个人健康摘要 — 包括过敏、药物和病史，以及在可用时提供的免疫接种、检查结果和生命体征 — 由 HL7 标准化为 FHIR 文档，以便跨国共享。

### IPS 中需要包含哪些部分？
过敏和不耐受 (LOINC 48765-2)、药物摘要 (10160-0) 和病史列表 (11450-4)。建议包含免疫接种、检查结果和生命体征。

### 如何从 FHIR 数据生成 IPS？
收集患者的资源，构建包含 IPS 部分和叙述的 Composition，并将所有内容打包成一个文档 Bundle。使用 Anpheros，这只需要一个请求：`GET /fhir/R4/Patient/{id}/$summary`。

### Anpheros 生成的 IPS 是否经过验证？
是的。生成的文档在官方 HL7 FHIR 验证器上，针对 IPS 实现指南，验证时显示 0 个错误。

### IPS 在欧洲的用途是什么？
欧洲健康数据空间 (European Health Data Space) 将患者摘要列为必须以欧洲格式进行交换的优先类别之一。

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

## 相关资源

- [FHIR 平台](https://developers.anpheros.com/zh/guides/fhir)：`$summary`、`$everything` 及 26 种资源类型
- [面向开发者的欧洲健康数据空间 (EHDS)](https://developers.anpheros.com/zh/guides/ehds-for-developers)
- [纵向患者数据 API](https://developers.anpheros.com/zh/guides/longitudinal-patient-data-api)
- [医疗数据互操作性](https://developers.anpheros.com/zh/guides/interoperability)
- [国际患者摘要，面向患者](https://anpheros.com/guides/international-patient-summary)