기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# `$member-match` HealthLake에 대한 작업
<a name="reference-fhir-operations-member-match"></a>

AWS HealthLake 는 이제 환자 리소스에 대한 `$member-match` 작업을 지원하므로 의료 기관은 인구 통계 및 적용 범위 정보를 사용하여 다양한 의료 시스템에서 멤버의 고유 식별자를 찾을 수 있습니다. 이 작업은 환자의 개인 정보를 유지하면서 CMS 규정 준수를 달성하고 안전한 payer-to-payer 데이터 교환을 용이하게 하는 데 필수적입니다.

이 작업은 다음이 필요한 경우에 특히 유용합니다.
+ 조직 간의 안전한 의료 데이터 교환 활성화
+ 다양한 시스템에서 환자의 치료 연속성 유지
+ CMS 규정 준수 요구 사항 지원
+ 의료 네트워크에서 정확한 구성원 식별 촉진

## 사용법
<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 | 필수 | 기본값 | 설명 | 
| --- | --- | --- | --- | --- | 
| 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 | 문자열 | 사용된 일치 알고리즘 유형(EXACT\_MATCH, STRONG\_MATCH 또는 DEMOGRAPHIC\_MATCH) | 
| matchDetails | 문자열 | 매칭 프로세스에 대한 세부 정보 | 
| matchedFields | 문자열 | 성공적으로 일치하는 특정 필드 목록 | 

## 일치 알고리즘
<a name="member-match-algorithms"></a>

`$member-match` API는 다계층 매칭 접근 방식을 사용하여 정확한 멤버 식별을 보장합니다.

EXACT\_MATCH  
Coverage SubscriberId와 결합된 환자 식별자 사용  
멤버 일치에 대한 가장 높은 신뢰도 수준을 제공합니다.

STRONG\_MATCH  
최소 적용 범위 정보와 함께 환자 식별자를 사용합니다.  
정확한 일치 기준이 충족되지 않을 때 높은 신뢰도를 제공합니다.

데모그래픽\_일치  
기본 인구 통계 정보에 의존합니다.  
식별자 기반 일치가 불가능한 경우에 사용됩니다.

## 동작
<a name="member-match-behavior"></a>

`$member-match` 작업:
+ 환자 인구 통계, 적용 범위 세부 정보 및 선택적 동의 정보를 입력으로 수락합니다.
+ 후속 상호 작용에 사용할 수 있는 고유한 멤버 식별자를 반환합니다.
+ 여러 의료 시스템에서 정확한 구성원 식별을 보장하기 위해 다계층 일치(정확, 강력, 인구 통계)를 구현합니다.
+ 향후 권한 부여를 위해 제공된 동의 정보를 저장합니다.
+ 환자 개인 정보를 유지하면서 안전한 payer-to-payer 데이터 교환 지원
+ 의료 데이터 교환에 대한 CMS 요구 사항 준수

## 권한 부여
<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`: 일치하는 항목 또는 여러 항목을 찾을 수 없음