This page is part of the Da Vinci Health Record Exchange (v0.2.0: STU1 Ballot 1) based on FHIR R4. The current version which supercedes this version is 1.0.0. For a full list of available versions, see the Directory of published versions
To access information about a member on a payer’s system, the requesting system needs to know the unique identifier of that member on the payer’s system. However, in many cases, neither the client system nor the patient will have this information. The $member-match operation supports identifying the target payer’s member and coverage information for a specified member so the client can use that information for subsequent queries and operations.
The operation works by passing in three sets of information:
The response returns:
Patient.identifier
repetitionsAn identifier is used rather than a member id as most payers do not (yet) expose RESTful ids for their member or coverage records. This identifier can be used in subsequent interactions with the target payer system.
OPERATION: MemberMatch
The official URL for this operation definition is:
http://hl7.org/fhir/us/davinci-hrex/OperationDefinition/member-match
The $member-match operation allows one health plan to retrieve a unique identifier for a member from another health plan using a member's demographic and coverage information. This identifier can then be used to perform subsequent queries and operations.
URL: [base]/Patient/$member-match
Parameters
Use | Name | Cardinality | Type | Binding | Documentation |
IN | MemberPatient | 1..1 | Resource | Parameter submitted by the new plan SHALL contain US Core Patient containing member demographics. | |
IN | OldCoverage | 1..1 | Resource | Parameter submitted by the new plan SHALL contain Coverage details of prior health plan coverage provided by the member, typically from their health plan coverage card. | |
IN | NewCoverage | 1..1 | Resource | Parameter submitted by the new plan SHALL contain Coverage details of new or prospective health plan coverage provided by the new health plan based upon the member's enrollment. | |
OUT | MemberPatient | 1..1 | Resource | Parameter returned by the old plan resource SHALL contain the MemberPatient resource received from new plan with the ADDITION of an identifier of type "UMB" representing the unique identifier identifying the member of the old health plan. | |
OUT | NewCoverage | 1..1 | Resource | Parameter returned by the old plan resource SHALL contain the NewCoverage record received from the new plan. |
The response from a failed $member-match is a “422 Unprocessable Entity Status Code”.
After a successful $member-match the new health plan SHALL then use the UMB provided by the old health plan in the Patient.identifier
field in any subsequent transactions related to payer-to-payer exchange.
For example, in the Da Vinci PDex IG, the new health plan will subsequently use the UMB identifier to request the member’s health records. This can be done by querying the US Core FHIR profile endpoints which will be constrained to the identified member. Alternatively, the new health plan can perform a $everything operation to the Patient/{ID}/$everything operation endpoint to receive a bundle of the member’s health records.
For PCDE, the new health plan will subsequently use the UMB identifier to send a Task message and request the PCDE coverage transition bundle.
This specification does not define the member matching logic that is used by a Payer that processes a $member-match operation.
The specification is:
An important objective of this specification is to ensure that a health plan operating a $member-match operation has sufficient data provided to enable a match operation to be performed. Therefore, the specification requires a health plan to provide demographic information (name, date of birth, gender) and identification details that would be present on a member’s health plan insurance card with a request.
An example request (as POSTed when invoking the operation) can be found here and an example response (as received in the HTTP response body after the operation processes) can be found here.