Da Vinci Payer Data Exchange
2.2.0 - STU 2.2 US

Da Vinci Payer Data Exchange, published by HL7 International / Financial Management. This guide is not an authorized publication; it is the continuous build for version 2.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/davinci-epdx/ and changes regularly. See the Directory of published versions

OperationDefinition: PDex Provider-Member-Match Operation (Experimental)

Official URL: http://hl7.org/fhir/us/davinci-pdex/OperationDefinition/ProviderMemberMatch Version: 2.2.0
Standards status: Informative Computable Name: ProviderMemberMatch

Copyright/Legal: Used by permission of HL7 International, all rights reserved Creative Commons License

Provider-Member-Match Operation enables providers to match patient demographics and coverage information against a payer's member records. The operation returns matched members as a Group resource that can be used with the $davinci-data-export operation for bulk data retrieval. This operation is functionally similar to the Payer-to-Payer Bulk Member Match operation but is designed for provider-initiated requests.

The matched members returned in the MatchedMembers Group can be used directly with the $davinci-data-export operation on the Group resource to retrieve bulk FHIR data for all matched members. The $davinci-data-export operation will return a manifest file referencing the bulk data files containing the member health information in ndjson format.

Input parameters SHALL conform to the Provider $multi-member-match Request profile. §pdex-400 Output parameters SHALL conform to the Provider $multi-member-match Response profile. §pdex-401

URL: [base]/Group/$provider-member-match

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INMemberBundle1..*Parameters

Contains one or more members with patient demographics and coverage information to be matched against the payer's member records. Each repetition SHALL conform to the MemberBundle slice defined in the Provider $multi-member-match Request profile.

OUTMatchedMembers1..1Group (Provider Member Match Group)

A Group resource containing members successfully matched in the payer's records, for whom the provider's treatment attestation has been verified, and who have not opted out of Provider Access API data sharing. The Group Id returned in this parameter is the input to the $davinci-data-export operation for bulk data retrieval. This Group is the response artifact and is distinct from the long-lived Member-Provider Treatment Relationship Group (pdex-treatment-relationship) the payer maintains for governance and audit purposes. Cardinality 1..1 — emitted even when Group.member[] is empty, so the matched-Group identifier is always available for the subsequent $davinci-data-export step.

OUTNonMatchedMembers0..1Group (Provider Member No Match Group)

A Group resource containing members for whom no match could be found in the payer's records OR for whom the provider's treatment attestation could not be verified or does not meet the payer's requirements. Both failure types are reported in this single Group; consumers can distinguish the specific reason via the Group's characteristic code or the per-member context if required by the payer.

OUTConsentConstrainedMembers0..1Group (Member Opt-Out Group)

A Group resource containing members who were successfully matched in the payer's records but who have opted out of data sharing via the Provider Access API. Returned via the Member Opt-Out Group profile. Privacy default — SHOULD suppress when opt-out status is sensitive. A member who opts out of data sharing has, by definition, indicated that they do not want their data disclosed to the requesting provider via this API; the fact of opting out is itself information about that member. Where the payer determines that disclosing opt-out status to the requesting provider — i.e., distinguishing 'opted out' from 'not matched' — would itself constitute a disclosure the member did not authorize (whether under applicable state privacy law, the member's stated preference, or the payer's privacy policy), the payer SHOULD suppress this ConsentConstrainedMembers parameter and instead include the affected members in the NonMatchedMembers Group. This makes the response indistinguishable to the requester between a true no-match and a matched-but-opted-out outcome, protecting opt-out status from disclosure. Payers that determine no such concern applies (for example, in jurisdictions where opt-out disclosure is permitted, or where the member has not requested suppression) MAY continue to return this Group, which preserves the type-level distinction between opt-out and no-match outcomes for operational use by the requester.

The complete output structure conforms to the Provider $multi-member-match Response Parameters profile, which defines slices for MatchedMembers, NonMatchedMembers, and ConsentConstrainedMembers.