本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `$member-match` HealthLake 的 操作
<a name="reference-fhir-operations-member-match"></a>

AWS HealthLake 現在支援 病患資源`$member-match`的操作，讓醫療保健組織能夠使用人口統計和涵蓋範圍資訊，在不同醫療保健系統中尋找成員的唯一識別符。此操作對於實現 CMS 合規和促進安全payer-to-payer資料交換，同時維護患者隱私至關重要。

當您需要：
+ 啟用組織之間的安全醫療保健資料交換
+ 維持不同系統的患者持續照護
+ 支援 CMS 合規要求
+ 促進跨醫療保健網路的準確成員識別

## Usage
<a name="member-match-usage"></a>

您可以使用 POST 方法，在病患資源上叫用 `$member-match`操作：

```
POST [base]/Patient/$member-match
```

## 支援的參數
<a name="member-match-parameters"></a>

HealthLake 支援下列 FHIR `$member-match` 參數：


| 參數 | Type | 必要 | 預設 | Description | 
| --- | --- | --- | --- | --- | 
| MemberPatient | 病患 | 是 | — | 包含要比對之成員人口統計資訊的患者資源 | 
| CoverageToMatch | 涵蓋範圍 | 是 | — | 將用於比對現有記錄的涵蓋資源 | 
| CoverageToLink | 涵蓋範圍 | 否 | — | 比對程序期間要連結的覆蓋資源 | 
| 同意 | 同意 | 否 | — | 授權用途的同意資源 | 

## 範例
<a name="member-match-examples"></a>

### 具有參數的 POST 請求
<a name="member-match-request-example"></a>

```
POST [base]/Patient/$member-match
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "MemberPatient",
      "resource": {
        "resourceType": "Patient",
        "name": [
          {
            "family": "Jones",
            "given": ["Sarah"]
          }
        ],
        "gender": "female",
        "birthDate": "1985-05-15"
      }
    },
    {
      "name": "CoverageToMatch",
      "resource": {
        "resourceType": "Coverage",
        "status": "active",
        "beneficiary": {
          "reference": "Patient/1"
        },
        "relationship": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/subscriber-relationship",
              "code": "self",
              "display": "Self"
            }
          ]
        },
        "payor": [
          {
            "reference": "Organization/payer456"
          }
        ]
      }
    },
    {
      "name": "Consent",
      "resource": {
        "resourceType": "Consent",
        "status": "active",
        "scope": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/consentscope",
              "code": "patient-privacy"
            }
          ]
        },
        "category": [
          {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
                "code": "IDSCL"
              }
            ]
          }
        ],
        "patient": {
          "reference": "Patient/1"
        },
        "performer": [
          {
            "reference": "Patient/patient123"
          }
        ],
        "sourceReference": {
          "reference": "Document/someconsent"
        },
        "policy": [
          {
            "uri": "http://hl7.org/fhir/us/davinci-hrex/StructureDefinition-hrex-consent.html#regular"
          }
        ]
      }
    }
  ]
}
```

### 回應範例
<a name="member-match-response-example"></a>

操作會傳回參數資源，其中包含相符的結果：

```
{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "MemberIdentifier",
      "valueIdentifier": {
        "system": "http://hospital.org/medical-record-number",
        "value": "MRN-123456"
      }
    },
    {
      "name": "MemberId",
      "valueReference": {
        "reference": "Patient/patient123"
      }
    },
    {
      "name": "matchAlgorithm",
      "valueString": "DEMOGRAPHIC_MATCH"
    },
    {
      "name": "matchDetails",
      "valueString": "Demographic match: DOB + Name"
    },
    {
      "name": "matchedFields",
      "valueString": "given,birthdate,gender,family"
    }
  ]
}
```

## 回應參數
<a name="member-match-response-parameters"></a>

找到相符項目時，回應會包含下列參數：


| 參數 | 類型 | 說明 | 
| --- | --- | --- | 
| MemberIdentifier | 識別符 | 相符成員的唯一識別符 | 
| MemberId | 參考資料 | 患者資源的參考 | 
| matchAlgorithm | String | 使用的比對演算法類型 (EXACT\$1MATCH、STRONG\$1MATCH 或 DEMOGRAPHIC\$1MATCH) | 
| matchDetails | String | 比對程序的詳細資訊 | 
| matchedFields | String | 已成功相符的特定欄位清單 | 

## 相符演算法
<a name="member-match-algorithms"></a>

`$member-match` API 採用多層比對方法，以確保準確的成員識別：

EXACT\$1MATCH  
使用與 Coverage SubscriberId 結合的患者識別符  
為成員比對提供最高的可信度層級

STRONG\$1MATCH  
使用具有最低涵蓋範圍資訊的患者識別符  
不符合完全相符條件時，提供高可信度

DEMOGRAPHIC\$1MATCH  
依賴基本人口統計資訊  
當無法進行識別符型比對時使用

## Behavior (行為)
<a name="member-match-behavior"></a>

`$member-match` 操作：
+ 接受患者人口統計特性、涵蓋範圍詳細資訊和選用的同意資訊做為輸入
+ 傳回可用於後續互動的唯一成員識別符
+ 實作多層比對 （確切、強大、人口統計），以確保在不同醫療保健系統中正確識別成員
+ 儲存任何提供的同意資訊以供未來授權之用
+ 支援安全payer-to-payer資料交換，同時維護患者隱私權
+ 符合醫療資料交換的 CMS 要求

## Authorization
<a name="member-match-authorization"></a>

API 在 FHIR 授權通訊協定上使用 SMART 搭配下列必要範圍：
+ `system/Patient.read`
+ `system/Coverage.read`
+ `system/Organization.read` （有條件）
+ `system/Practitioner.read` （有條件）
+ `system/PractitionerRole.read` （有條件）
+ `system/Consent.write` （有條件）

## 錯誤處理
<a name="member-match-error-handling"></a>

操作會處理下列錯誤條件：
+ `400 Bad Request`：無效的`$member-match`操作 （不符合的請求或缺少必要的參數）
+ `422 Unprocessable Entity`：找不到相符項目或多個相符項目