The Opala Solution
The Opala Patient Access API Resources and Interactions

SMART App Launch Framework Authorization Flows Access Tokens Scopes Endpoints Working with the FHIR Server

CARIN for Blue Button® Da Vinci Payer Data Exchange (PDex)
Mapping Adjudicated Claims and Encounter Information

The Patient Access API

© 2021-2023 Opala. All Rights Reserved.

Version 1.0.1.0


Contact Opala's
Documentation Team

Mapping Adjudicated Claims and Encounter Information

Health plans are required to map claims and clinical information for a member to US Core v3.1.1 FHIR Resources based on R4.

Mapping is also required when data is exchanged between systems. The Da Vinci Payer Data Exchange (PDex) exchanges are centered around Members/Patients. FHIR Platforms generate their own IDs when creating resources. Consequently, a Patient resource in one system can have a different FHIR Resource ID than a Patient in another system. When a bundle of resources is retrieved from a health plan’s FHIR API it will be necessary to map identifiers to determine whether a record in the target system needs to be updated or created.

Links to tables are provided in the following sections to assist implementers in mapping adjudicated claims data represented in the Consumer-Directed Payer Data Exchange IG (CARIN for Blue Button®) to clinical resources that may be exchanged as part of workflows identified in the Da Vinci Payer Data Exchange IG (PDex). These tables identify the source profile element and the associated Common Payer Consumer Data Set (CPCDS) mapping.

The column definitions for these mapping tables are provided below.

US Core Element MustSupport Cardinality CARIN-BB Element CPCDS Element Mapping or Implementer Note
The Element name in the target Profile. e.g. Coverage.meta.lastUpdated S indicates a Must Support Element Defines the cardinality of the target element The CARIN-BB source element name The Mapping Element ID from the CARIN-BB CPCDS mapping document and the associated mapping element name [{“163”:”Coverage Last Updated Date”}]

Note: Regardless of the way in which payers store their administrative and clinical information, they will need to map it appropriately to these profiles.

The following links open various tables that provide these mappings from CARIN for Blue Button® to fields in the respective clinical (US Core and PDex) profiles.

US Core CareTeam (4.3.3)

When a health plan has access to information about the CareTeam for a member, they need to make that information available using the United States Core Data for Interoperability (USCDI) CareTeam resource.

The CareTeam resource for the US Core identifies the care team members associated with a patient. It identifies which core elements, extensions, vocabularies, and value sets are present in the resource when using this profile.

This profile supports searches using the combination of the patient and status search parameters, including support for composite OR search on status:

status={system|}[code],{system|}[code],...

For example:

GET [baseurl]/CareTeam?patient=[reference]&status=active

US Core Condition (4.3.4)

This profile sets minimum expectations for the Condition resource to record, search, and fetch a list of conditions associated with a patient. It identifies which core elements, extensions, vocabularies, and value sets are present in the resource when using the US Core Condition profile.

This profile supports searches or all conditions including problems, health concerns, and encounter diagnosis for a patient using the patient search parameter. This search parameter is mandatory.

For example:

GET [baseurl]/Condition?patient=[reference]

For a list of optional search parameters, see StructureDefinition-us-core-condition .

US Core Encounter (4.3.10)

This profile sets minimum expectations for the Encounter resource to record, search, and fetch basic encounter information for an individual patient. It identifies which core elements, extensions, vocabularies, and value sets are present in the resource when using the US Core Encounter profile.

US Core Encounter mapping

The following search parameters and search parameter combinations are mandatory.

Searching an encounter using the _id parameter:

GET [baseurl]/Encounter[id]

Searching an encounter using the patient parameter:

GET [baseurl]/Encounter?patient=[reference]

Searching an encounter using the combination of the date and patient parameters, including support for these date comparators: gt, lt, ge, le. Optionally, the profile supports composite AND searches on date:

date=[date]&date=[date]]&...

GET [baseurl]/Encounter?date={gt|lt|ge|le}[date]{&date={gt|lt|ge|le}[date]&...}&patient=[reference]

For a list of optional search parameters, see StructureDefinition-us-core-encounter .

US Core Patient (4.3.20)

The US Core Patient profile is used to express a member’s demographic information.

This profile sets minimum expectations for the Patient resource to record, search, and fetch basic demographics and other administrative information about an individual patient. It identifies which core elements, extensions, vocabularies, and value sets are present in the resource when using the US Core Patient profile.

US Core Patient mapping

The following search parameters and search parameter combinations are mandatory.

Searching a patient using the _id parameter:

GET [baseurl]/Patient[id]

Searching a patient by an identifier such as a MPI using the identifier parameter:

GET [baseurl]/Patient?identifier={system|}[code]

Searching for a patient by a string match of any part of name using the name parameter:

GET [baseurl]/Patient?name=[string]

Searching using the combination of the birthdate and name parameters:

GET [baseurl]/Patient?birthdate=[date]&name=[string]

Searching using the combination of the gender and name search parameters:

GET [baseurl]/Patient?gender={system|}[code]&name=[string]

For a list of optional search parameters, see StructureDefinition-us-core-patient .

US Core Procedure (4.3.26)

This profile sets minimum expectations for the Procedure resource to record, search, and fetch procedures associated with a patient. It identifies which core elements, extensions, vocabularies, and value sets are present in the resource when using the US Core Procedure profile.

US Core Procedure

The following search parameters and search parameter combinations are mandatory.

Searching for all procedures for a patient using the patient parameter:

GET [baseurl]/Procedure?patient=[reference]

Searching using the combination of the patient and date parameters, including support for these date comparators: gt, lt, ge, le. Optionally, the profile supports composite AND searches on date:

date=[date]&date=[date]]&...

GET [base]/Procedure?patient=[reference]&date={gt|lt|ge|le}[date]{&date={gt|lt|ge|le}[date]&...}

For a list of optional search parameters, see StructureDefinition-us-core-procedure .

US Core Laboratory Result Observation (4.3.14)

This profile sets minimum expectations for the Observation resource to record, search, and fetch laboratory test results associated with a patient/member. It identifies which core elements, extensions, vocabularies, and value sets are present in the resource when using the US Core Laboratory Result Observation profile.

US Core Laboratory Result Observation

The following search parameters and search parameter combinations are mandatory.

Searching using the combination of the patient and category search parameters:

GET [baseurl]/Observation?patient=[reference]&category=http://terminology.hl7.org/CodeSystem/observation-category|laboratory

Searching using the combination of the patient and code parameters, including optional support for composite OR search on code:

code={system|}[code],{system|}[code],...

GET [baseurl]/Observation?patient=[reference]&code={system|}[code]{,{system|}[code],...}

Searching using the combination of the patient and category and date search parameters, including support for these date comparators: gt, lt, ge, le. Optionally, the profile supports composite AND searches on date:

date=[date]&date=[date]]&...

GET [baseurl]/Observation?patient=[reference]&category=http://terminology.hl7.org/CodeSystem/observation-category|laboratory&date={gt|lt|ge|le}[date]{&date={gt|lt|ge|le}[date]&...}

Coverage (4.3.5)/HRexCoverage (9.15.1)

The Coverage resource is profiled in the Da Vinci Health Record Exchange (HRex) IG.

The HRexCoverage Profile defines the constraints for representing a member’s healthcare insurance information to the payer. Coverage instances complying with this profile, sometimes together with the Patient which this profile references via beneficiary, allows a payer to identify a member in their system.

US Core Coverage

The HRexCoverage structure is derived from the FHIR R4 Coverage resource.

Note: If the member identifier (using Coverage.identifier) is known, it should be sent, since this uniquely identifies a covered individual. If not known, the Coverage.subscriberId can be used together with demographic information found by resolving Coverage.beneficiary to identify the member.

PDex MedicationDispense (4.3.17)

The Da Vinci PDex MedicationDispense profile is used to record a member’s prescription drug claims.

PDex MedicationDispense
Top