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: Condition Category Remark Extension

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

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

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.

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 C 0..* Extension Condition Category remark
Constraints: ra-2
... Slices for extension Content/Rules for all slices
.... extension:remarkType 0..1 Extension Remark Type
..... url 1..1 uri "remarkType"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Remark Type (extensible)
.... extension:author 0..1 Extension Identifier of the person who added the remark such as NPI
..... url 1..1 uri "author"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueString string
...... valueReference Reference(US Core Practitioner Profile(7.0.0))
.... extension:authorOrganization 0..1 Extension Identifier of the organization that added the remark such as TIN, NPI
..... url 1..1 uri "authorOrganization"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueString string
...... valueReference Reference(US Core Organization Profile(7.0.0))
.... extension:authorSoftware 0..1 Extension Identifier of the software that added the remark
..... url 1..1 uri "authorSoftware"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueString string
.... extension:authorDatetime 0..1 Extension When the remark was added
..... url 1..1 uri "authorDatetime"
..... value[x] 1..1 dateTime Value of extension
.... extension:text 0..* Extension Free text remark
..... url 1..1 uri "text"
..... value[x] 1..1 string Value of extension
.... extension:code 0..1 Extension Coded remark
..... url 1..1 uri "code"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Coding Gap Remark (extensible)
.... extension:reasonCode 0..* Extension Remark reason
..... url 1..1 uri "reasonCode"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Remark Reason (extensible)
.... extension:relatedData 0..* Extension Related data
..... url 1..1 uri "relatedData"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueReference Reference(Any)
... url 1..1 uri "http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-ccRemark"
... value[x] 0..0 Value of extension

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Extension.extension:remarkType.​value[x] Base extensible Remark Type 📦3.0.0-ballot This IG
Extension.extension:code.​value[x] Base extensible Coding Gap Remark 📦3.0.0-ballot This IG
Extension.extension:reasonCode.​value[x] Base extensible Remark Reason 📦3.0.0-ballot This IG

Constraints

Id Grade Path(s) Description Expression
ra-2 error Extension A remark shall include an author, an authorOrganization, or an authorSoftware extension.where(url = 'author').exists() or extension.where(url = 'authorOrganization').exists() or extension.where(url = 'authorSoftware').exists()
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension C 0..* Extension Condition Category remark
Constraints: ra-2
... 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:remarkType 0..1 Extension Remark Type
..... 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 "remarkType"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Remark Type (extensible)
.... extension:author 0..1 Extension Identifier of the person who added the remark such as NPI
..... 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 "author"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueString string
...... valueReference Reference(US Core Practitioner Profile(7.0.0))
.... extension:authorOrganization 0..1 Extension Identifier of the organization that added the remark such as TIN, NPI
..... 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 "authorOrganization"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueString string
...... valueReference Reference(US Core Organization Profile(7.0.0))
.... extension:authorSoftware 0..1 Extension Identifier of the software that added the remark
..... 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 "authorSoftware"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueString string
.... extension:authorDatetime 0..1 Extension When the remark was added
..... 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 "authorDatetime"
..... value[x] 1..1 dateTime Value of extension
.... extension:text 0..* Extension Free text remark
..... 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 "text"
..... value[x] 1..1 string Value of extension
.... extension:code 0..1 Extension Coded remark
..... 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 "code"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Coding Gap Remark (extensible)
.... extension:reasonCode 0..* Extension Remark reason
..... 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 "reasonCode"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Remark Reason (extensible)
.... extension:relatedData 0..* Extension Related data
..... 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 "relatedData"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueReference Reference(Any)
... url 1..1 uri "http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-ccRemark"

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:remarkType.​value[x] Base extensible Remark Type 📦3.0.0-ballot This IG
Extension.extension:code.​value[x] Base extensible Coding Gap Remark 📦3.0.0-ballot This IG
Extension.extension:reasonCode.​value[x] Base extensible Remark Reason 📦3.0.0-ballot This IG

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()
ra-2 error Extension A remark shall include an author, an authorOrganization, or an authorSoftware extension.where(url = 'author').exists() or extension.where(url = 'authorOrganization').exists() or extension.where(url = 'authorSoftware').exists()

Summary

Complex 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.

  • remarkType: CodeableConcept: An Extension
  • author: Identifier, string, Reference: An Extension
  • authorOrganization: Identifier, string, Reference: An Extension
  • authorSoftware: Identifier, string: An Extension
  • authorDatetime: dateTime: An Extension
  • text: string: An Extension
  • code: CodeableConcept: An Extension
  • reasonCode: CodeableConcept: An Extension
  • relatedData: Identifier, Reference: An Extension

Maturity: 2

Differential ViewDifferential View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension C 0..* Extension Condition Category remark
Constraints: ra-2
... Slices for extension Content/Rules for all slices
.... extension:remarkType 0..1 Extension Remark Type
..... url 1..1 uri "remarkType"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Remark Type (extensible)
.... extension:author 0..1 Extension Identifier of the person who added the remark such as NPI
..... url 1..1 uri "author"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueString string
...... valueReference Reference(US Core Practitioner Profile(7.0.0))
.... extension:authorOrganization 0..1 Extension Identifier of the organization that added the remark such as TIN, NPI
..... url 1..1 uri "authorOrganization"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueString string
...... valueReference Reference(US Core Organization Profile(7.0.0))
.... extension:authorSoftware 0..1 Extension Identifier of the software that added the remark
..... url 1..1 uri "authorSoftware"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueString string
.... extension:authorDatetime 0..1 Extension When the remark was added
..... url 1..1 uri "authorDatetime"
..... value[x] 1..1 dateTime Value of extension
.... extension:text 0..* Extension Free text remark
..... url 1..1 uri "text"
..... value[x] 1..1 string Value of extension
.... extension:code 0..1 Extension Coded remark
..... url 1..1 uri "code"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Coding Gap Remark (extensible)
.... extension:reasonCode 0..* Extension Remark reason
..... url 1..1 uri "reasonCode"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Remark Reason (extensible)
.... extension:relatedData 0..* Extension Related data
..... url 1..1 uri "relatedData"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueReference Reference(Any)
... url 1..1 uri "http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-ccRemark"
... value[x] 0..0 Value of extension

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Extension.extension:remarkType.​value[x] Base extensible Remark Type 📦3.0.0-ballot This IG
Extension.extension:code.​value[x] Base extensible Coding Gap Remark 📦3.0.0-ballot This IG
Extension.extension:reasonCode.​value[x] Base extensible Remark Reason 📦3.0.0-ballot This IG

Constraints

Id Grade Path(s) Description Expression
ra-2 error Extension A remark shall include an author, an authorOrganization, or an authorSoftware extension.where(url = 'author').exists() or extension.where(url = 'authorOrganization').exists() or extension.where(url = 'authorSoftware').exists()

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension C 0..* Extension Condition Category remark
Constraints: ra-2
... 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:remarkType 0..1 Extension Remark Type
..... 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 "remarkType"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Remark Type (extensible)
.... extension:author 0..1 Extension Identifier of the person who added the remark such as NPI
..... 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 "author"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueString string
...... valueReference Reference(US Core Practitioner Profile(7.0.0))
.... extension:authorOrganization 0..1 Extension Identifier of the organization that added the remark such as TIN, NPI
..... 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 "authorOrganization"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueString string
...... valueReference Reference(US Core Organization Profile(7.0.0))
.... extension:authorSoftware 0..1 Extension Identifier of the software that added the remark
..... 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 "authorSoftware"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueString string
.... extension:authorDatetime 0..1 Extension When the remark was added
..... 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 "authorDatetime"
..... value[x] 1..1 dateTime Value of extension
.... extension:text 0..* Extension Free text remark
..... 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 "text"
..... value[x] 1..1 string Value of extension
.... extension:code 0..1 Extension Coded remark
..... 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 "code"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Coding Gap Remark (extensible)
.... extension:reasonCode 0..* Extension Remark reason
..... 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 "reasonCode"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Remark Reason (extensible)
.... extension:relatedData 0..* Extension Related data
..... 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 "relatedData"
..... value[x] 1..1 Value of extension
...... valueIdentifier Identifier
...... valueReference Reference(Any)
... url 1..1 uri "http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-ccRemark"

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:remarkType.​value[x] Base extensible Remark Type 📦3.0.0-ballot This IG
Extension.extension:code.​value[x] Base extensible Coding Gap Remark 📦3.0.0-ballot This IG
Extension.extension:reasonCode.​value[x] Base extensible Remark Reason 📦3.0.0-ballot This IG

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()
ra-2 error Extension A remark shall include an author, an authorOrganization, or an authorSoftware extension.where(url = 'author').exists() or extension.where(url = 'authorOrganization').exists() or extension.where(url = 'authorSoftware').exists()

Summary

Complex 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.

  • remarkType: CodeableConcept: An Extension
  • author: Identifier, string, Reference: An Extension
  • authorOrganization: Identifier, string, Reference: An Extension
  • authorSoftware: Identifier, string: An Extension
  • authorDatetime: dateTime: An Extension
  • text: string: An Extension
  • code: CodeableConcept: An Extension
  • reasonCode: CodeableConcept: An Extension
  • relatedData: Identifier, Reference: An Extension

Maturity: 2

 

Other representations of profile: CSV, Excel, Schematron