Da Vinci Risk Adjustment Implementation Guide
3.0.0-ballot - STU 3 Ballot United States of America flag

Da Vinci Risk Adjustment Implementation Guide, published by HL7 International / Clinical Quality Information. This guide is not an authorized publication; it is the continuous build for version 3.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/davinci-ra/ and changes regularly. See the Directory of published versions

Extension: QualifyingDxCode Extension

Official URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-qualifyingDxCode Version: 3.0.0-ballot
Standards status: Trial-use Active as of 2026-03-19 Maturity Level: 2 Computable Name: QualifyingDxCode
Other Identifiers: OID:2.16.840.1.113883.4.642.40.29.42.21

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

Diagnosis code(s) classified under a Condition Category, as defined by the risk adjustment model. This usually comes into play in the scenario where proprietary risk models are used and the mappings of ICD-10 codes to Condition Categories are not readily available. Note that whether qualifying codes may be included in a report depending may depend on individual Risk Adjustment model licensing agreement.

Context of Use

Usage info

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Extension Content

Description Differentials, Snapshots, and other representations.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Qualifying diagnosis code(s)
... url 1..1 uri "http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-qualifyingDxCode"
... valueCodeableConcept 0..1 CodeableConcept Diagnosis codes classified under a Condition Category as defined by the risk adjustment model
Binding: USCoreConditionCodes (7.0.0) (extensible)
.... Slices for extension Content/Rules for all slices
..... extension:codeOptions 0..1 canonical(ValueSet) Qualifying diagnosis codes provided as a value set
URL: http://hl7.org/fhir/StructureDefinition/codeOptions

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Extension.valueCodeableConcept Base extensible US Core Condition Codes 📍7.0.0 US Core v7.0
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Qualifying diagnosis code(s)
... id 0..1 string Unique id for inter-element referencing
... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
... url 1..1 uri "http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-qualifyingDxCode"
.... value[x]:valueCodeableConcept 0..1 CodeableConcept Diagnosis codes classified under a Condition Category as defined by the risk adjustment model
Binding: USCoreConditionCodes (7.0.0) (extensible)
..... id 0..1 string Unique id for inter-element referencing
..... Slices for extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
...... extension:codeOptions 0..1 canonical(ValueSet) Qualifying diagnosis codes provided as a value set
URL: http://hl7.org/fhir/StructureDefinition/codeOptions
..... coding Σ 0..* Coding Code defined by a terminology system
..... text Σ 0..1 string Plain text representation of the concept

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.value[x]:valueCodeableConcept Base extensible US Core Condition Codes 📍7.0.0 US Core v7.0

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

Summary

Simple Extension with the type CodeableConcept: Diagnosis code(s) classified under a Condition Category, as defined by the risk adjustment model. This usually comes into play in the scenario where proprietary risk models are used and the mappings of ICD-10 codes to Condition Categories are not readily available. Note that whether qualifying codes may be included in a report depending may depend on individual Risk Adjustment model licensing agreement.

Maturity: 2

Differential ViewDifferential View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Qualifying diagnosis code(s)
... url 1..1 uri "http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-qualifyingDxCode"
... valueCodeableConcept 0..1 CodeableConcept Diagnosis codes classified under a Condition Category as defined by the risk adjustment model
Binding: USCoreConditionCodes (7.0.0) (extensible)
.... Slices for extension Content/Rules for all slices
..... extension:codeOptions 0..1 canonical(ValueSet) Qualifying diagnosis codes provided as a value set
URL: http://hl7.org/fhir/StructureDefinition/codeOptions

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Extension.valueCodeableConcept Base extensible US Core Condition Codes 📍7.0.0 US Core v7.0

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Qualifying diagnosis code(s)
... id 0..1 string Unique id for inter-element referencing
... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
... url 1..1 uri "http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-qualifyingDxCode"
.... value[x]:valueCodeableConcept 0..1 CodeableConcept Diagnosis codes classified under a Condition Category as defined by the risk adjustment model
Binding: USCoreConditionCodes (7.0.0) (extensible)
..... id 0..1 string Unique id for inter-element referencing
..... Slices for extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
...... extension:codeOptions 0..1 canonical(ValueSet) Qualifying diagnosis codes provided as a value set
URL: http://hl7.org/fhir/StructureDefinition/codeOptions
..... coding Σ 0..* Coding Code defined by a terminology system
..... text Σ 0..1 string Plain text representation of the concept

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.value[x]:valueCodeableConcept Base extensible US Core Condition Codes 📍7.0.0 US Core v7.0

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

Summary

Simple Extension with the type CodeableConcept: Diagnosis code(s) classified under a Condition Category, as defined by the risk adjustment model. This usually comes into play in the scenario where proprietary risk models are used and the mappings of ICD-10 codes to Condition Categories are not readily available. Note that whether qualifying codes may be included in a report depending may depend on individual Risk Adjustment model licensing agreement.

Maturity: 2

 

Other representations of profile: CSV, Excel, Schematron