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

$bulk-member-match HealthLake에 대한 작업

AWS HealthLake 는 여러 멤버 일치 요청을 비동기적으로 처리하기 위한 $bulk-member-match 작업을 지원합니다. 이 작업을 통해 의료 기관은 단일 대량 요청에서 인구 통계 및 적용 범위 정보를 사용하여 여러 의료 시스템에서 수백 명의 멤버의 고유 식별자를 효율적으로 일치시킬 수 있습니다. 이 기능은 대규모 payer-to-payer 데이터 교환, 멤버 전환 및 CMS 규정 준수 요구 사항에 필수적이며 FHIR 사양을 따릅니다.

이 작업은 다음이 필요한 경우에 특히 유용합니다.

용도

$bulk-member-match 작업은 POST 메서드를 사용하여 그룹 리소스에서 호출되는 비동기 작업입니다.

POST [base]/Group/$bulk-member-match

대량 일치 요청을 제출한 후 다음을 사용하여 작업 상태를 폴링할 수 있습니다.

GET [base]/$bulk-member-match-status/{jobId}

지원되는 파라미터

HealthLake는 다음 FHIR $bulk-member-match 파라미터를 지원합니다.

대량 멤버 일치 작업 제출을 위한 POST 요청

다음 예제는 대량 멤버 일치 작업을 제출하기 위한 POST 요청을 보여줍니다. 각 멤버는 필수 MemberPatient, CoverageToMatch및 Consent 리소스를 포함하는 MemberBundle 파라미터와 선택적 로 래핑됩니다CoverageToLink.

POST [base]/Group/$bulk-member-match
Content-Type: application/fhir+json
{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "MemberBundle",
      "part": [
        {
          "name": "MemberPatient",
          "resource": {
            "resourceType": "Patient",
            "identifier": [
              {
                "system": "http://example.org/patient-id",
                "value": "patient-0"
              }
            ],
            "name": [
              {
                "family": "Smith",
                "given": ["James"]
              }
            ],
            "gender": "male",
            "birthDate": "1950-01-01"
          }
        },
        {
          "name": "CoverageToMatch",
          "resource": {
            "resourceType": "Coverage",
            "status": "active",
            "identifier": [
              {
                "system": "http://example.org/coverage-id",
                "value": "cov-0"
              }
            ],
            "subscriberId": "sub-0",
            "beneficiary": {
              "reference": "Patient/patient123"
            },
            "relationship": {
              "coding": [
                {
                  "system": "http://terminology.hl7.org/CodeSystem/subscriber-relationship",
                  "code": "self"
                }
              ]
            },
            "payor": [
              {
                "reference": "Organization/org123"
              }
            ]
          }
        },
        {
          "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/patient123"
            },
            "performer": [
              {
                "reference": "Patient/patient123"
              }
            ],
            "sourceReference": {
              "reference": "http://example.org/DocumentReference/consent-source"
            },
            "policy": [
              {
                "uri": "http://hl7.org/fhir/us/davinci-hrex/StructureDefinition-hrex-consent.html#regular"
              }
            ],
            "provision": {
              "type": "permit",
              "period": {
                "start": "2024-01-01",
                "end": "2025-12-31"
              },
              "actor": [
                {
                  "role": {
                    "coding": [
                      {
                        "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
                        "code": "performer"
                      }
                    ]
                  },
                  "reference": {
                    "identifier": {
                      "system": "http://hl7.org/fhir/sid/us-npi",
                      "value": "9876543210"
                    },
                    "display": "Old Health Plan"
                  }
                },
                {
                  "role": {
                    "coding": [
                      {
                        "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                        "code": "IRCP"
                      }
                    ]
                  },
                  "reference": {
                    "identifier": {
                      "system": "http://hl7.org/fhir/sid/us-npi",
                      "value": "0123456789"
                    },
                    "display": "New Health Plan"
                  }
                }
              ],
              "action": [
                {
                  "coding": [
                    {
                      "system": "http://terminology.hl7.org/CodeSystem/consentaction",
                      "code": "disclose"
                    }
                  ]
                }
              ]
            }
          }
        },
        {
          "name": "CoverageToLink",
          "resource": {
            "resourceType": "Coverage",
            "status": "active",
            "identifier": [
              {
                "system": "http://example.org/coverage-link-id",
                "value": "cov-link-0"
              }
            ],
            "subscriberId": "new-sub-0",
            "beneficiary": {
              "reference": "Patient/patient123"
            },
            "relationship": {
              "coding": [
                {
                  "system": "http://terminology.hl7.org/CodeSystem/subscriber-relationship",
                  "code": "self"
                }
              ]
            },
            "payor": [
              {
                "identifier": {
                  "system": "http://hl7.org/fhir/sid/us-npi",
                  "value": "0123456789"
                },
                "display": "New Health Plan"
              }
            ]
          }
        }
      ]
    }
  ]
}

출력이 포함된 완료된 작업 응답

작업이 완료되면 응답에는 작업 메타데이터와 일치 결과를 분류하는 세 개의 그룹 리소스가 포함된 FHIR 파라미터 리소스가 포함됩니다.

{
  "datastoreId": "datastoreId",
  "jobId": "jobId",
  "status": "COMPLETED",
  "submittedTime": "2026-03-20T18:45:26.321Z",
  "numberOfMembers": 3,
  "numberOfMembersProcessedSuccessfully": 3,
  "numberOfMembersWithCustomerError": 0,
  "numberOfMembersWithServerError": 0,
  "output": {
    "resourceType": "Parameters",
    "meta": {
      "profile": [
        "http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/pdex-parameters-multi-member-match-bundle-out"
      ]
    },
    "parameter": [
      {
        "name": "MatchedMembers",
        "resource": {
          "resourceType": "Group",
          "id": "group1",
          "text": {
            "status": "generated",
            "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Matched members group</div>"
          },
          "contained": [
            {
              "resourceType": "Patient",
              "id": "1",
              "identifier": [
                {
                  "system": "http://example.org/patient-id",
                  "value": "patient-0"
                }
              ],
              "name": [
                {
                  "family": "Smith",
                  "given": ["James"]
                }
              ],
              "gender": "male",
              "birthDate": "1950-01-01"
            }
          ],
          "type": "person",
          "actual": true,
          "code": {
            "coding": [
              {
                "system": "http://hl7.org/fhir/us/davinci-pdex/CodeSystem/PdexMultiMemberMatchResultCS",
                "code": "match",
                "display": "Matched"
              }
            ]
          },
          "quantity": 1,
          "member": [
            {
              "entity": {
                "extension": [
                  {
                    "url": "http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/base-ext-match-parameters",
                    "valueReference": {
                      "reference": "#1"
                    }
                  }
                ],
                "reference": "Patient/patient123"
              }
            }
          ]
        }
      },
      {
        "name": "NonMatchedMembers",
        "resource": {
          "resourceType": "Group",
          "id": "Group2",
          "text": {
            "status": "generated",
            "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Non-matched members group</div>"
          },
          "contained": [
            {
              "resourceType": "Patient",
              "id": "1",
              "identifier": [
                {
                  "system": "http://example.org/patient-id",
                  "value": "patient-501"
                }
              ],
              "name": [
                {
                  "family": "Carter",
                  "given": ["Emily"]
                }
              ],
              "gender": "female",
              "birthDate": "1985-06-15"
            }
          ],
          "type": "person",
          "actual": true,
          "code": {
            "coding": [
              {
                "system": "http://hl7.org/fhir/us/davinci-pdex/CodeSystem/PdexMultiMemberMatchResultCS",
                "code": "nomatch",
                "display": "Not Matched"
              }
            ]
          },
          "quantity": 1,
          "member": [
            {
              "entity": {
                "extension": [
                  {
                    "url": "http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/base-ext-match-parameters",
                    "valueReference": {
                      "reference": "#1"
                    }
                  }
                ],
                "reference": "Patient/patient123"
              }
            }
          ]
        }
      },
      {
        "name": "ConsentConstrainedMembers",
        "resource": {
          "resourceType": "Group",
          "id": "group3",
          "text": {
            "status": "generated",
            "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Consent constrained members group</div>"
          },
          "contained": [
            {
              "resourceType": "Patient",
              "id": "1",
              "identifier": [
                {
                  "system": "http://example.org/patient-id",
                  "value": "patient-502"
                }
              ],
              "name": [
                {
                  "family": "Nguyen",
                  "given": ["David"]
                }
              ],
              "gender": "male",
              "birthDate": "1972-11-22"
            }
          ],
          "type": "person",
          "actual": true,
          "code": {
            "coding": [
              {
                "system": "http://hl7.org/fhir/us/davinci-pdex/CodeSystem/PdexMultiMemberMatchResultCS",
                "code": "consentconstraint",
                "display": "Consent Constraint"
              }
            ]
          },
          "quantity": 1,
          "member": [
            {
              "entity": {
                "extension": [
                  {
                    "url": "http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/base-ext-match-parameters",
                    "valueReference": {
                      "reference": "#1"
                    }
                  }
                ],
                "reference": "Patient/123"
              }
            }
          ]
        }
      }
    ]
  }
}

HealthLake가 멤버를 출력 그룹으로 분류하는 방법

$bulk-member-match 요청에 제출된 모든 멤버는 순차적 파이프라인을 통해 평가됩니다. 각 단계의 결과에 따라 멤버가 배치되는 출력 그룹이 결정됩니다.

주요 원칙: 멤버는 하나의 대상에만 나타날 수 있습니다. 첫 번째 실패 단계는 배치를 결정합니다. 2단계 또는 3단계에 실패한 멤버는 ConsentConstrainedMembers에 배치되지 않습니다.이 그룹은 성공적으로 일치했지만 동의를 받을 수 없는 멤버만 사용할 수 있습니다.

동의 평가 세부 정보(4단계):

모든 검사는 멤버가 MatchedMembers에 배치되고 동의가 저장되려면 통과해야 합니다.

적용 범위 일치 동작

멤버 매칭 중에 CoverageToMatch는 응답 지급인의 데이터 스토어에 대해서만 검증됩니다.는 새/요청 지급인의 CoverageToLink 소유이며 이전 지급인의 데이터 스토어에 대해서는 검증되지 않습니다. 요청에 CoverageToLink를 포함해도 일치하는 결과에는 영향을 주지 않습니다.

요청의 각 환자 + 담당 범위 조합은 독립적으로 처리됩니다. 동일한 환자를 서로 다른 적용 범위 플랜으로 여러 번 제출할 수 있으며, 각 항목은 특정 적용 범위에 따라 자체 결과를 수신합니다.

동의 수행자 참조 처리

새 지급인은에서 임시 또는 로컬 환자 참조를 보낼 수 있습니다Consent.performer(예:에 사용된 것과 동일한 참조Consent.patient). HealthLake는 이러한 참조를 자동으로 확인합니다.

출력 그룹 리소스

완료된 작업은 세 개의 그룹 리소스가 포함된 파라미터 리소스를 반환합니다.

Group.quantity 필드에는 각 그룹의 총 멤버 수가 포함됩니다.

그룹 멤버 참조:

동의 환자 연결

저장된 동의를 일치하는 환자와 연결하려면 작업 출력을 사용합니다. MatchedMembers 그룹의 각 멤버는 일치하는 환자를 member.entity.reference 가리키고 member.entity.extension (base-ext-match-parameters)는 포함된 입력 환자를 가리킵니다. 이를 동의의 환자 필드와 상호 참조하여 애플리케이션 계층에서 매핑을 빌드합니다.

저장되는 항목과 일시적인 항목 비교

다음 표에는 $bulk-member-match 처리 중에 HealthLake가 데이터 스토어에 유지하는 내용과 작업 응답에만 존재하는 내용이 나와 있습니다.

$davinci-data-export와 통합

에서 반환한 MatchedMembers 그룹 리소스를 $davinci-data-export 작업과 함께 직접 사용하여 대량 멤버 데이터를 검색할 $bulk-member-match 수 있습니다.

POST [base]/Group/{matched-group-id}/$davinci-data-export
GET [base]/Group/{matched-group-id}

이 통합을 통해 먼저 일치하는 구성원을 대량으로 식별한 다음 결과 그룹 리소스를 사용하여 전체 상태 레코드를 내보내는 효율적인 워크플로를 사용할 수 있습니다.

내보내기 전에 $member-remove 사용

일치 후 특정 멤버를 내보내기에서 제외해야 하는 경우(예: 멤버가 일치 및 내보내기에 대한 동의를 취소하는 경우) MatchedMembers 그룹에서 $member-remove를 사용합니다.

워크플로:

성능 특성

이 $bulk-member-match 작업은 대용량 처리를 위해 설계되었으며 비동기적으로 실행됩니다.

권한 부여

API는 다음 필수 범위와 함께 FHIR 인증 프로토콜에서 SMART를 사용합니다.

또한이 작업은 프로그래밍 방식 액세스를 위한 AWS IAM 서명 버전 4(SigV4) 권한 부여를 지원합니다.

검증 규칙

다음 검증 규칙은 1단계에서 각 MemberBundle에 적용됩니다. 검증에 실패한 멤버는 오류로 보고되며 출력 그룹에 표시되지 않습니다.

MemberPatient

CoverageToMatch / CoverageToLink

동의

일치하는 동작

오류 처리

작업은 다음 오류 조건을 처리합니다.

오류 세부 정보는 상태 폴링 엔드포인트를 통해 사용할 수 있으며 다음을 포함합니다.

관련 작업