你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Azure API for FHIR 的 $member-match 操作

重要

Azure API for FHIR 将于 2026 年 9 月 30 日停用。 按照迁移策略在该日期之前转换到 Azure Health Data Services FHIR® 服务。 由于 Azure API for FHIR 停用,在 2025 年 4 月 1 日开始前不会允许新的部署。 Azure Health Data Services FHIR 服务是 Azure API for FHIR 的演化版本,可让客户管理 FHIR、DICOM 和医疗技术服务,并集成到其他 Azure 服务。

$member-match 是作为 Da Vinci Health Record Exchange (HRex) 的一部分定义的一个操作。 在本指南中,我们将了解什么是 $member-match 以及如何使用它。

$member-match 概述

创建 $member-match 操作是为了帮助进行付款人之间的数据交换,允许新付款人从患者的前一个付款人那里获得患者的唯一标识符。 $member-match 操作要求在请求正文中传递三项信息:

  • 患者人口统计信息

  • 旧的保险信息

  • 新的保险信息(根据我们的实现,不是必需的)

在数据传入后,Azure API for FHIR 会验证它是否可以找到与旧的保险信息一起传入的人口统计信息完全匹配的患者。 如果找到了一个结果,则响应将是一个捆绑包,其中包含原始患者数据、从旧付款人添加的新标识符以及旧的保险信息。

注意

该规范描述了传入和返回新的保险信息。 我们决定省略该数据,以使结果更小。

$member-match 示例

若要使用 $member-match,请使用以下调用:

POST {{fhirurl}}/Patient/$member-match

你需要在正文中包括参数资源,其中包括患者、旧保险和新保险。 若要查看 JSON 表示形式,请参阅 $member-match 示例请求

如果找到了单个匹配项,则将收到响应 200,并添加了另一个标识符:

响应代码 200。

如果 $member-match 找不到唯一匹配项,你将收到响应 422,其中包含错误代码。

后续步骤

在本指南中,你已了解了 $member-match 操作。 接下来,你可以了解如何在 Touchstone 中测试需要 $member-match 操作的 Da Vinci Payer Data Exchange IG。

FHIR® 是 HL7 的注册商标,经 HL7 许可使用。