This page is part of the Da Vinci Risk Adjustment FHIR Implementation Guide (v2.1.0: STU 2) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions
Contents:
This page provides a list of the FHIR artifacts defined as part of this implementation guide.
The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.
Risk Adjustment Data Submission Client Capability Statement |
This profile defines the expected capabilities of a Da Vinci Risk Adjustment Data Submission Client when conforming to the Da Vinci Risk Adjustment Implementation Guide for interactions between Data Submission Clients and Data Submission Servers. Clients are the actors creating and submitting the Risk Adjustment Data Exchange Measure Reports using the $submit-data operation to the Server. |
Risk Adjustment Data Submission Server Capability Statement |
This profile defines the expected capabilities of a Da Vinci Risk Adjustment Data Submission Server when conforming to the Da Vinci Risk Adjustment Implementation Guide for interactions between Clients and Servers. Servers are the actors receiving and processing the Risk Adjustment Data Exchange MeasureReports submitted by the Client. |
Risk Adjustment Reporting Client Capability Statement |
This profile defines the expected capabilities of a Da Vinci Risk Adjustment Reporting Client when conforming to the Da Vinci Risk Adjustment Implementation Guide for interactions between Reporting Clients and Reporting Servers. Clients are the actors making the request for Risk Adjustment Coding Gap Reports for patient(s) and for Risk Adjustmenet Models that are available on the Server. This CapabilityStatement resource includes the complete list of the recommended Da Vinci Risk Adjustment profiles and RESTful operations that a Risk Adjustment Reporting Client could support. Clients have the option of choosing from this list based on their local use cases and other contextual requirements. |
Risk Adjustment Reporting Server Capability Statement |
This profile defines the expected capabilities of a Da Vinci Risk Adjustment Reporting Server when conforming to the Da Vinci Risk Adjustment Implementation Guide for interactions between Reporting Clients and Reporting Servers. Servers are the actors receiving the request for Risk Adjustment Coding Gap Reports for patient(s) and for Risk Adjustmenet Models that are available on the Server. This CapabilityStatement resource includes the complete list of the recommended Da Vinci Risk Adjustment profiles and RESTful operations that a Risk Adjustment Reporting Server could support. Servers have the option of choosing from this list based on their local use cases and other contextual requirements. |
These are custom operations that can be supported by and/or invoked by systems conforming to this implementation guide.
Evaluate Measure |
The ra.evaluate-measure operation is used to evaluate Digital Condition Category and obtain the results. |
These define the properties by which a RESTful server can be searched. They can also be used for sorting and including related resources.
MeasureReportCategory |
Search based on the measurereport-category extension |
These define constraints on FHIR resources for systems conforming to this implementation guide.
Patient Group |
The Patient Group Profile describes a group consisting of one or more patients. It can be used a) when generating risk adjustment gap reports using Bulk FHIR or b) for the evaluated-approach for generating reports as defined on the dCC page. |
RA Parameters ccRemark Patch Profile |
A Parameters profile that defines structures of multi-part Parameters to be used for sending Condition Category Remarks to a Risk Adjustment Coding Gap Report using the PATCH operation. |
Risk Adjustment Coding Gap MeasureReport |
This profile is based on the MeasureReport to represent a risk adjustment coding gap report. Payer runs risk adjustment engine and uses this profile to represent the risk adjustment Condition Category (CC) coding gaps and their detailed information for a patient. |
Risk Adjustment Coding Gap Report Bundle |
The Risk Adjustment Coding Gap Report Bundle Profile describes a collection bundle returned by the $ra.evaluate-measure operation. This bundle is a collection of Risk Adjustment Coding Gap Reports. |
Risk Adjustment Data Exchange MeasureReport |
This profile is based on the MeasureReport. It is used for Provider to submit data such as clinical evaluation evidence to Payer. |
Risk Adjustment Model Measure |
This risk adjustment model measure profile is based on the Measure resource to represent a risk adjustment model and its version, such as CMS-HCC version 24, CMS-HCC version 28. |
These define constraints on FHIR data types for systems conforming to this implementation guide.
Clinical Data Collection Deadline Extension |
Indicates the deadline for collecting data to close Condition Category (CC) coding gaps for a risk adjustment model of a measurement period. |
Condition Category Remark Extension |
The Condition Category Remark extension allows a coded and/or narrative remark be added to a Condition Category (CC) coding gap that is on a Payer generated risk adjustment coding gap report by a provider, an organization, or a software. |
Condition Category Type Extension |
Indicates whether the Condition Category (CC) gap is historic or suspected. This extension is also used to indicate if a Condition Category (CC) is net-new. |
Confidence Scale Extension |
A coded confidence scale, the degree of certainty, for a Condition Category (CC) coding gap presented in a Payer generated risk adjustment coding gap report. |
Diagnosis Code Extension |
Diganosis code(s) of the condition, such as ICD-10 codes. |
Evidence Status Date Extension |
Risk adjustment evidence status date |
Evidence Status Extension |
Indicates whether a Condition Category (CC) coding gap is closed-gap, open-gap, invalid-gap, or pending based on the clinical evidence available for risk adjustment. |
Group Reference Extension |
This extension identifies which Condition Category (CC) the supporting evidence (represented by |
Hierarchical Status Extension |
Indicates how hiearchies were applied to a Condition Category (CC), and if applied, whether the Condition Category (CC) is superseded. |
Payer Coding Gap Report Id Extension |
Unique id of the original payer generated coding gap report. This is the MeasureReport.id from the Risk Adjustment Coding Gap Report profile. |
Reporting Vendor Extension |
A reference to the vendor who generated the report. The ‘reporting vendor’ is intended to represent the submitting entity when it is not the same as the reporting entity. This extension is used when the Receiver is interested in getting vendor information in the report. |
These define sets of codes used by systems conforming to this implementation guide.
Coding Gap Remark |
Coded remark for a coding gap. |
Condition Category Type |
Type of value-based performance reporting performance metric. |
Evidence Status |
Codes that indicate whether a coding gap is an open-gap, invalid-gap, closed-gap, or pending. |
Hierarchical Status |
Codes that indicate how hierarchies were applied to a Condition Category (CC), and if applied, whether the Condition Category (CC) is superseded. |
RA Confidence Scale |
Codes that describe the confidence scale of a risk adjustment Condition Category (CC). |
Remark Reason |
Reason for the remark |
Sample CMS Hierarchical Condition Category |
This is a sample of the concepts that can be found in the CMS Hierarchical Condition Categories (CMS-HCC) code system version 24. The source of the codes included in this example was published at https://www.cms.gov/Medicare/Health-Plans/MedicareAdvtgSpecRateStats/Downloads/Announcement2020.pdf. The CMS-HCC model uses more than 9,000 ICD-10-CM codes, which are mapped to condition categories (CCs) that predict costs well. The condition categories (CCs) are based on diagnoses clinically related to one another and with similar predicted cost implications. Hierarchies are imposed on the Condition Categories (CCs) to capture the most costly diagnoses. Hierarchy logic is imposed on certain Condition Categories (CCs) to account for different hierarchical costs, thus, the term Hierarchical Condition Category, or HCC. |
These define new code systems used by systems conforming to this implementation guide.
Coding Gap Remark Codes |
Code sytstem that indicates coded remark for a coding gap. |
Remark Reason Codes |
Reason codes for remark |
Risk Adjustment Condition Category Type Codes |
Code sytstem that indicates whether it is a suspected Condition Category (CC) gap, a historic Condition Category (CC) gap, or a net-new Condition Category (CC). Historic, suspected, and net-new are mutually exclusive. |
Risk Adjustment Evidence Status Codes |
Code System that indicates whether a coding gap is an open-gap, invalid-gap, closed-gap or pending |
Risk Adjustment Hierarchical Status Codes |
Code system that indicates how hierarchies were applied to a Condition Category (CC), and if applied, whether the Condition Category (CC) is superseded. |
These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.
Condition01Pat03: Other artificial openings of gastrointestinal tract status |
This is a Condition example with code Z93.4: Other artificial openings of gastrointestinal tract status. |
Condition02Pat02: Diabetes mellitus due to underlying condition with other diabetic kidney complication |
This is a Condition example with code E08.29: Diabetes mellitus due to underlying condition with other diabetic kidney complication. |
Condition03Pat01: Chronic obstructive pulmonary disease with (acute) exacerbation |
This is a Condition example with code J44.1: Chronic obstructive pulmonary disease with (acute) exacerbation. |
Condition04Pat03: Chronic obstructive pulmonary disease with (acute) exacerbation |
This is a Condition example with code J44.1: Chronic obstructive pulmonary disease with (acute) exacerbation. |
Condition05Pat03: Unspecified protein-calorie malnutrition |
This is a Condition example with code E46: Unspecified protein-calorie malnutrition. |
Condition06Pat03: Crohn’s disease of large intestine with unspecified complications |
This is a Condition example with code K50.119: Crohn’s disease of large intestine with unspecified complications. |
Condition07Pat03: Other persistent atrial fibrillation |
This is a Condition example with code I48.19: Other persistent atrial fibrillation. |
Condition08Pat01: Bipolar disorder, current episode mixed, mild |
This is a Condition example with code F31.61: Bipolar disorder, current episode mixed, mild. |
Condition09Pat01: Allergic bronchopulmonary aspergillosis |
This is a Condition example with code B44.81: Allergic bronchopulmonary aspergillosis. |
Condition10Pat01: Long term (current) use of insulin |
This is a Condition example with code Z79.4: Long term (current) use of insulin. |
Condition11Pat01: Acute pulmonary edema |
This is a Condition example with code J81.0: Acute pulmonary edema. |
Condition12Pat01: Manic episode, unspecified |
This is a Condition example with code F30.9: Manic episode, unspecified. |
Condition15Pat03: Diabetes mellitus due to underlying condition with diabetic chronic kidney disease |
This is a Condition example with code E08.22: Diabetes mellitus due to underlying condition with diabetic chronic kidney disease. |
Condition16Pat03: Dependence on renal dialysis |
This is a Condition example with code Z99.2: Dependence on renal dialysis. |
Condition17Pat01: Body mass index (BMI) 45.0-49.9, adult |
This is a Condition example with code Z68.42: Body mass index [BMI] 45.0-49.9, adult. |
Condition18Pat01: Longstanding persistent atrial fibrillation |
This is a Condition example with code I48.11: Longstanding persistent atrial fibrillation. |
Condition21Pat03: Type 2 diabetes mellitus without complications |
This is a Condition example with code E11.9: Type 2 diabetes mellitus without complications. |
Condition22Pat03: Other acute kidney failure |
This is a Condition example with code N17.8: Other acute kidney failure. |
Condition23Pat03: Chronic kidney disease, stage 5 |
This is a Condition example with code N18.5: Chronic kidney disease, stage 5. |
Condition31Pat02: Typical atrial flutter |
This is a Condition example with code I48.3: Typical atrial flutter. |
Condition32Pat03: Chronic pulmonary embolism |
This is a Condition example with code I27.82: Chronic pulmonary embolism. |
Condition33Pat01: Respiratory arrest |
This is a Condition example with code R09.2: Respiratory arrest. |
Condition35Pat03: Type 2 diabetes mellitus with diabetic peripheral angiopathy without gangrene |
This is a Condition example with code E11.51: Type 2 diabetes mellitus with diabetic peripheral angiopathy without gangrene. |
Condition42Pat03: Other artificial openings of gastrointestinal tract status |
This is a Condition example with code Z93.4: Other artificial openings of gastrointestinal tract status. |
Condition43Pat01: Diabetes mellitus due to underlying condition with other diabetic kidney |
This is a Condition example with code E08.29: Diabetes mellitus due to underlying condition with other diabetic kidney complication. |
Condition44Pat01: Allergic bronchopulmonary aspergillosis |
This is a Condition example with code B44.81: Allergic bronchopulmonary aspergillosis. |
ConditionR01Pat01: Cystic fibrosis with other intestinal manifestations |
This is a Condition example with code E84.19: Cystic fibrosis with other intestinal manifestations. |
Data Exchange MeasureReport Example01 |
This is an example for the Risk Adjustment Data Exchange MeasureReport profile. It evaluatedResource references an example C-CDA document that is being submitted. |
Encounter with Dr Hippocrates on 2017-01-18 for Patient 01 |
This is an Encounter example for encounter with Dr Hippocrates on 2017-01-18 for Patient 01. |
Encounter with Dr Hippocrates on 2017-02-03 for Patient 03 |
This is an Encounter example for encounter with Dr Hippocrates on 2017-02-03 for Patient 03. |
Encounter with Dr Hippocrates on 2018-07-21 for Patient 01 |
This is an Encounter example for encounter with Dr Hippocrates on 2018-07-21 for Patient 01. |
Encounter with Dr Hippocrates on 2019-02-10 for Patient 01 |
This is an Encounter example for encounter with Dr Hippocrates on 2019-02-10 for Patient 01. |
Encounter with Dr Hippocrates on 2020-11-02 for Patient 03 |
This is an Encounter example for encounter with Dr Hippocrates on 2020-11-02 for Patient 03. |
Encounter with Dr Hippocrates on 2021-01-31 for Patient 03 |
This is an Encounter example for encounter with Dr Hippocrates on 2021-01-31 for Patient 03. |
Encounter with Dr Hippocrates on 2021-03-27 for Patient 03 |
This is an Encounter example for encounter with Dr Hippocrates on 2021-03-27 for Patient 03. |
Encounter with Dr Hippocrates on 2021-09-26 for Patient 03 |
This is an Encounter example for encounter with Dr Hippocrates on 2021-09-26 for Patient 03. |
Encounter with Dr Hippocrates on 2021-10-15 for Patient 01 |
This is an Encounter example for encounter with Dr Hippocrates on 2021-10-15 for Patient 01. |
Encounter with Dr Osler on 2019-02-07 for Patient 03 |
This is an Encounter example for encounter with Dr Osler on 2019-02-07 for Patient 03. |
Encounter with Dr Osler on 2019-08-23 for Patient 03 |
This is an Encounter example for encounter with Dr Osler on 2019-08-23 for Patient 03. |
Encounter with Dr Osler on 2020-02-10 for Patient 03 |
This is an Encounter example for encounter with Dr Osler on 2020-02-10 for Patient 03. |
Encounter with Dr Osler on 2020-03-03 for Patient 03 |
This is an Encounter example for encounter with Dr Osler on 2020-03-03 for Patient 03. |
Encounter with Dr Osler on 2020-09-17 for Patient 03 |
This is an Encounter example for encounter with Dr Osler on 2020-09-17 for Patient 03. |
Encounter with Dr Osler on 2020-12-18 for Patient 03 |
This is an Encounter example for encounter with Dr Osler on 2020-12-18 for Patient 03. |
Encounter with Dr Osler on 2021-01-30 for Patient 03 |
This is an Encounter example for encounter with Dr Osler on 2021-01-30 for Patient 03. |
Encounter with Dr Osler on 2021-02-12 for Patient 03 |
This is an Encounter example for encounter with Dr Osler on 2021-02-12 for Patient 03. |
Encounter with Dr Osler on 2021-07-01 for Patient 03 |
This is an Encounter example for encounter with Dr Osler on 2021-07-01 for Patient 03. |
Encounter with Dr Osler on 2021-07-14 for Patient 03 |
This is an Encounter example for encounter with Dr Osler on 2021-07-14 for Patient 03. |
Encounter with Dr Osler on 2021-07-27 for Patient 03 |
This is an Encounter example for encounter with Dr Osler on 2021-07-27 for Patient 03. |
Encounter with Dr Osler on 2021-08-08 for Patient 03 |
This is an Encounter example for encounter with Dr Osler on 2021-08-08 for Patient 03. |
Encounter with Dr Pump on 2021-08-06 for Patient 02 |
This is an Encounter example for encounter with Dr Pump on 2021-08-06 for Patient 02. |
Organization Example: XYZ Laboratory |
Laboratory that created lab observations |
Organization: ABC Payer |
ABC Payer is an Organization example that generated Risk Adjustment Coding Gap Report. |
Organization: Best RA Vendor |
Best RA Vendor is an Organization example that generated Risk Adjustment Data Exchange MeasureReport. |
Organization: Community HealthCenter |
Community HealthCenter is an Organization example, which is used for example Patient 03 data. |
Organization: Community Urgent Care |
Community Urgent Care is an Organization example, which is used for example Patient 01 data. |
Organization: GHH Outpatient Clinic |
GHH Outpatient Clinic is an Organization example, which is used for example Patient 02 data |
Organization: Risk Adjustment Author |
This is an example Organization that is the author of the RA report |
Outpatient Note for Patient01 Eve Everywoman |
This is an outpatient note example for the US Core DocumentReference Profile. |
PHQ9 Total Score for Patient 03 |
This is a PHQ9 Total Score for Patient 03. |
Patch Example01 with multiple value (ra-measurereport01) |
This is an example using the patch operation to send a Condition Category Remark with data for two Condition Categories (group-001, group-002) and one with multiple attributes: authorDatetime, text. |
Patch Example02 (ra-measurereport01) |
This is an example using the patch operation to send a Condition Category Remark for one Condition Category (group-001) with one attribute: authorDatetime. |
Patient Group Example 1 |
This is an example for the Patient Group profile. This example patient group has one member. |
Patient Group Example 2 |
This is an example for the Patient Group profile. This example patient group has two members. |
Patient01: Eve Everywoman |
This is an example patient that uses the USCore profile. The example patient name is Eve Everywoman. |
Patient02: Adam Everyman |
This is an example patient that uses the US Core Patient profile. The example patient name is Adam Everyman. |
Patient03: Nelda Nuclear |
This is an example patient that uses the US Core Patient profile. The example patient name is Nelda Nuclear. |
Practitioner01: Harold Hippocrates |
This is an example practitioner that uses the US Core Practitioner profile. The example practitioner is an individual practitioner: Harold Hippocrates. |
Practitioner02: Patrick Pump |
This is an example practitioner that uses the US Core Practitioner profile. The example practitioner is an organization: GHH Outpatient Clinic. |
Practitioner03: Otto Osler |
This is an example practitioner that uses the US Core Practitioner profile. The example practitioner is an organization: Community HealthCenter. |
RA Coding Gap MeasureReport Example01 with RA Model CMS-HCC V24 for Patient01 Eve Everywoman |
This is an example for the Risk Adjustment Coding Gap MeasureReport profile. This example report uses the CMS-HCC version 24 as the Risk Adjustment Model and the example patient used is Eve Everywoman. |
RA Coding Gap MeasureReport Example02 with RA Model CMS-RxHCC V5 for Patient01 Eve Everywoman |
This is an example for the Risk Adjustment Coding Gap MeasureReport profile. This example report uses the CMS-RxHCC version 5 as the Risk Adjustment Model and the example patient used is Eve Everywoman. |
RA Coding Gap MeasureReport Example03 with RA Model CMS-HCC V24 for Patient02 Adam Everyman |
This is an example for the Risk Adjustment Coding Gap MeasureReport profile. This example report uses the CMS-HCC version 24 as the Risk Adjustment Model and the example patient used is Eve Everywoman. |
RA Coding Gap MeasureReport Example04 with RA Model CMS-HCC V21 for Patient03 Nelda Nuclear |
This is an example for the Risk Adjustment Coding Gap MeasureReport profile. This example report uses the CMS-HCC version 21 as the Risk Adjustment Model and the example patient used is Eve Everywoman. |
RA Coding Gap MeasureReport Example05 with RA Model CMS-RxHCC V5 for Patient03 Nelda Nuclear |
This is an example for the Risk Adjustment Coding Gap MeasureReport profile. This example report uses the CMS-RxHCC version 5 as the Risk Adjustment Model and the example patient used is Eve Everywoman. |
RA Coding Gap MeasureReport Example06 with RA Model CMS-RxHCC V5 for Patient02 Adam Everyman |
This is an example for the Risk Adjustment Coding Gap MeasureReport profile. This example report uses the CMS-RxHCC version 5 as the Risk Adjustment Model and the example patient used is Eve Everywoman. |
RA MeasureReport with Remark Example (ra-measurereport01-with-remark) |
This is an example for the Risk Adjustment Coding Gap MeasureReport profile that shows using the Condition Category Remark extension. The remark is added to MeasureReport. |
RA Model Example01 CMS-HCC version 24 |
This is an example for the Risk Adjustment Model Measure profile. The example uses the CMS-HCC version 24 as the example Risk Adjustment Model. |
RA Model Example02 CMS-HCC version 21 |
This is an example for the Risk Adjustment Model Measure profile. The example uses the CMS-HCC version 21 as the example Risk Adjustment Model. |
RA Model Example03 CMS-RxHCC version 5 |
This is an example for the Risk Adjustment Model Measure profile. The example uses the CMS-RxHCC version 5 as the example Risk Adjustment Model. |
Risk Adjustment MeasureReport Bundle example, MeasureReport01: Patient01 |
This is an Risk Adjustment MeasureReport Bundle example includes MeasureReport01 for Patient01. |
Serum Creatinine for Patient 03 |
This is an example for Observation. Serum Creatinine for Patient 03 Nelda Nuclear performed at XYZ Laboratory. |
Submit Data example for sending a C-CDA document |
This is an example for using $submit-data oepration to send a C-CDA document as supporting evidence using the RA Data Exchange MeasureReport. |
Trypsin [Mass/volume] in Serum or Plasma for Patient 01 |
Trypsin [Mass/volume] in Serum or Plasma for Patient 01. |
Trypsin [Mass/volume] in Serum or Plasma for Patient 02 |
This is an example for Observation profile. Trypsin [Mass/volume] in Serum or Plasma for Patient 02 Adam Everyman performed at XYZ Laboratory. |