次の方法で共有

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 サービスへの統合を使用して、FHIR、DICOM、および MedTech サービスを管理できるようにする、進化したバージョンの Azure API for FHIR です。

$member-match は、Da Vinci Health Record Exchange (HRex) の一部として定義されている操作です。 このガイドでは、$member-match の概要と使用方法について説明します。

$member-match の概要

$member-match 操作は、支払者間データ交換で役立つように作成されたものであり、新しい支払者が患者の以前の支払者から患者の一意の識別子を取得できるようにします。 $member-match 操作では、要求の本文で 3 つの情報を渡す必要があります。

  • 患者属性情報

  • 古いカバレッジ情報

  • 新しいカバレッジ情報 (この実装に基づく場合は不要)

データが渡された後、Azure API for FHIR は、渡された古いカバレッジ情報の属性情報と正確に一致する患者が見つかることを検証します。 結果が見つかった場合、応答は、元の患者データに加えて、以前の支払者から追加された新しい識別子と古いカバレッジ情報を含むバンドルです。

Note

この仕様では、新しいカバレッジ情報を渡したり戻したりすることが記述されています。 結果を小さく保つため、そのデータは省略することが決定されています。

$member-match の例

$member-match を使うには、次の呼び出しを使います。

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

患者、古いカバレッジ、新しいカバレッジを含むパラメーター リソースを本文に含める必要があります。 JSON 表現を確認するには、「$member-match の要求の例」を参照してください。

一致が 1 つ見つかった場合は、別の識別子が追加された 200 応答を受け取ります。

200 応答コード。

$member-match で一意の一致が見つからない場合は、エラー コードを含む 422 応答を受け取ります。

次のステップ

このガイドでは、$member-match 操作について説明しました。 次に、$member-match 操作を必要とする DaVinx Payer Data Exchange IG の Touchstone でのテストについて学習できます。

DaVinci PDex

FHIR® は HL7 の登録商標であり、HL7 の許可を得て使用しています。