共用方式為

適用於 Azure API for FHIR 的 $member-match 作業

  • 發行項

重要

Azure API for FHIR 將於 2026 年 9 月 30 日淘汰。 請依照移轉策略，在該日期前轉換至 Azure 健康資料服務 FHIR® 服務。 由於 Azure API for FHIR 已淘汰，因此從 2025 年 4 月 1 日開始，將不允許新的部署。 Azure 健康資料服務 FHIR 服務是 Azure API for FHIR 的進化版本，可讓客戶透過與其他 Azure 服務整合來管理 FHIR、DICOM 和醫療技術服務。

$member-match 是達文西健康記錄交換 (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 OK 回應碼。

如果 $member-match 無法找到唯一相符項目，您會收到 422 回應與錯誤碼。

下一步

在本指南中，您已瞭解 $member-match 作業。 接下來，您可進一步瞭解如何利用 $member-match 作業，在 Touchstone 中測試達文西付款人資料交換 IG。

DaVinci PDex

(FHIR®) 是 HL7 的註冊商標，可與 HL7 的權限搭配使用。