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
| 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
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | MemberBundle | 1..* | 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. | ||
| OUT | MatchedMembers | 1..1 | Group (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 | ||
| OUT | NonMatchedMembers | 0..1 | Group (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. | ||
| OUT | ConsentConstrainedMembers | 0..1 | Group (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 |
The complete output structure conforms to the Provider $multi-member-match Response Parameters profile, which defines slices for MatchedMembers, NonMatchedMembers, and ConsentConstrainedMembers.