This page is part of the Da Vinci Risk Adjustment FHIR Implementation Guide (v1.0.0: STU 1) based on FHIR 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
Official URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-measurereport | Version: 1.0.0 | |||
Active as of 2022-06-16 | Computable Name: RiskAdjustmentCodingGapReport | |||
Copyright/Legal: Used by permission of HL7 International - Clinical Quality Information Work Group, all rights reserved Creative Commons License |
This risk adjustment coding gap report profile is based on the MeasureReport to represent a risk adjustment coding gap report.
The following data-elements are mandatory (i.e data MUST be present).
Each MeasureReport must have:
MeasureReport.status
elementMeasureReport.type
element hard coded to “individual”MeasureReport.measure
element references a Risk Adjustment model measureMeasureReport.subject
element references a US Core Patient profileMeasureReport.period
element for the clinical evaluation period for which the risk adjustment coding gap report was generated.Each MeasureReport should have ([Must Support]):
MeasureReport.group
elementMeasureReport.group
should have a MeasureReport.group.code
elementMeasureReport.group
should have a MeasureReport.group.ra-suspectType
elementMeasureReport.group
should have a MeasureReport.group.ra-evidenceStatus
elementMeasureReport.group
should have a MeasureReport.group.ra-evidenceStatusDate
elementMeasureReport.group
should have a MeasureReport.group.ra-hierarchicalStatus
elementMeasureReport.group
should have zero to many MeasureReport.evalautedResource
elementAdditional Profile specific implementation guidance:
evaluatedResource
SHALL reference resources using USCore profiles where applicableevaluatedResource
SHALL be returned in the bundle by $report operationThe Clinical Data Collection Deadline element, ra-clinicalDataCollectionDeadline
, was added as an extension to MeasureReport. We are seeking comment from implementers if they intend to use this element when communicating risk adjustment coding gap reports from payers to providers.
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from MeasureReport
Summary
Mandatory: 6 elements (1 nested mandatory element)
Must-Support: 19 elements
Fixed Value: 1 element
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
This structure is derived from MeasureReport
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
MeasureReport | 0..* | MeasureReport | This is a Risk Adjustment Coding Gap Report. | |
ra-clinicalDataCollectionDeadline | S | 0..1 | date | This is the deadline by which the providers must have all claims data to the payers to count for risk adjustment for a clinical evaluation period. This date is set by the Payer and applies to the early-bird date if incentive were offered. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-clinicalDataCollectionDeadline |
status | S | 1..1 | code | complete | pending | error |
type | S | 1..1 | code | The type code is fixed to 'individual' for Risk Adjustment Coding Gap Report Fixed Value: individual |
measure | S | 1..1 | canonical(Risk Adjustment Model Measure) | This references a measure that represents a Risk Adjustment model, such as CMS-HCC V24. |
subject | S | 1..1 | Reference(US Core Patient Profile) | What individual(s) the report is for |
date | S | 1..1 | dateTime | When the report was generated |
reporter | S | 1..1 | Reference(US Core Organization Profile) | Organization that generated the MeasureReport |
period | SI | 1..1 | Period | Clinical evaluation period during which risk adjusting encounters could be conducted and documented with expectations of submission for risk adjustment purposes. ra-1: Date precision SHALL be at least to day ( YYYY-MM-DD ) |
start | S | 1..1 | dateTime | Starting time with inclusive boundary |
end | S | 1..1 | dateTime | End time with inclusive boundary, if not ongoing |
group | S | 0..* | BackboneElement | A group contains information for a Condition Category. If a patient/member has multiple Condition Categories, there will be multiple group(s) and each group represents a Condition Category. |
id | S | 1..1 | string | Unique id for inter-element referencing |
ra-suspectType | S | 0..1 | CodeableConcept | This is the risk adjustment suspect type for a Condition Category (CC) gap URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-suspectType Binding: Risk Adjustment Suspect Type Value Set (extensible) |
ra-evidenceStatus | S | 0..1 | CodeableConcept | This is evidence status of a Condition Category (CC) coding gap: open-gap|closed-gap|pending. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-evidenceStatus Binding: Risk Adjustment Evidence Status Value Set (extensible) |
ra-evidenceStatusDate | S | 0..1 | date | When the evidence status was changed to either closed-gap, open-gap, or pending URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-evidenceStatusDate |
ra-hierarchicalStatus | S | 0..1 | CodeableConcept | This is to indicate whether hierarchies were applied to a Condition Category (CC), and if applied, whether the Condition Category (CC) is superseded: applied-superseded|applied-not-superseded|not-applied|not-applicable URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-hierarchicalStatus Binding: Risk Adjustment Hierarchical Status Value Set (extensible) |
code | S | 0..1 | CodeableConcept | Condition Category (CC) code for a Risk Adjustment Model Binding: Example CMS Hierarchical Condition Category Value Set (example) |
stratifier | ||||
code | 0..1 | CodeableConcept | What stratifier of the group | |
evaluatedResource | S | 0..* | Reference(Resource) | An evaluated resource is any data a clinician would need to independently arrive at the clinical inference that a Condition Category (CC) listed on a Risk Adjustment Coding Gap Report could be present for a patient. Risk adjusted evaluated resources may include practitioners, encounters, diagnoses, medications, labs, or any other clinical evidence that the suspecting algorithm may have used as supporting evidence to infer the presence of a Condition Category (CC) gap. |
ra-groupReference | S | 0..* | string | This references the MeasureReport.group.id. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-groupReference |
Documentation for this format |
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
MeasureReport | I | 0..* | MeasureReport | This is a Risk Adjustment Coding Gap Report. | ||||
id | Σ | 0..1 | string | Logical id of this artifact | ||||
meta | Σ | 0..1 | Meta | Metadata about the resource | ||||
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
language | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |||||
contained | 0..* | Resource | Contained, inline Resources | |||||
ra-clinicalDataCollectionDeadline | S | 0..1 | date | This is the deadline by which the providers must have all claims data to the payers to count for risk adjustment for a clinical evaluation period. This date is set by the Payer and applies to the early-bird date if incentive were offered. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-clinicalDataCollectionDeadline | ||||
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored | ||||
identifier | Σ | 0..* | Identifier | Additional identifier for the MeasureReport | ||||
status | ?!SΣ | 1..1 | code | complete | pending | error Binding: MeasureReportStatus (required): The status of the measure report. | ||||
type | SΣI | 1..1 | code | The type code is fixed to 'individual' for Risk Adjustment Coding Gap Report Binding: MeasureReportType (required): The type of the measure report. Fixed Value: individual | ||||
measure | SΣ | 1..1 | canonical(Risk Adjustment Model Measure) | This references a measure that represents a Risk Adjustment model, such as CMS-HCC V24. | ||||
subject | SΣ | 1..1 | Reference(US Core Patient Profile) | What individual(s) the report is for | ||||
date | SΣ | 1..1 | dateTime | When the report was generated | ||||
reporter | SΣ | 1..1 | Reference(US Core Organization Profile) | Organization that generated the MeasureReport | ||||
period | SΣI | 1..1 | Period | Clinical evaluation period during which risk adjusting encounters could be conducted and documented with expectations of submission for risk adjustment purposes. ra-1: Date precision SHALL be at least to day ( YYYY-MM-DD ) | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
start | SΣI | 1..1 | dateTime | Starting time with inclusive boundary | ||||
end | SΣI | 1..1 | dateTime | End time with inclusive boundary, if not ongoing | ||||
improvementNotation | ?!Σ | 0..1 | CodeableConcept | increase | decrease Binding: MeasureImprovementNotation (required): Observation values that indicate what change in a measurement value or score is indicative of an improvement in the measured item or scored issue. | ||||
group | SI | 0..* | BackboneElement | A group contains information for a Condition Category. If a patient/member has multiple Condition Categories, there will be multiple group(s) and each group represents a Condition Category. | ||||
id | S | 1..1 | string | Unique id for inter-element referencing | ||||
Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
ra-suspectType | S | 0..1 | CodeableConcept | This is the risk adjustment suspect type for a Condition Category (CC) gap URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-suspectType Binding: Risk Adjustment Suspect Type Value Set (extensible) | ||||
ra-evidenceStatus | S | 0..1 | CodeableConcept | This is evidence status of a Condition Category (CC) coding gap: open-gap|closed-gap|pending. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-evidenceStatus Binding: Risk Adjustment Evidence Status Value Set (extensible) | ||||
ra-evidenceStatusDate | S | 0..1 | date | When the evidence status was changed to either closed-gap, open-gap, or pending URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-evidenceStatusDate | ||||
ra-hierarchicalStatus | S | 0..1 | CodeableConcept | This is to indicate whether hierarchies were applied to a Condition Category (CC), and if applied, whether the Condition Category (CC) is superseded: applied-superseded|applied-not-superseded|not-applied|not-applicable URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-hierarchicalStatus Binding: Risk Adjustment Hierarchical Status Value Set (extensible) | ||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | SΣ | 0..1 | CodeableConcept | Condition Category (CC) code for a Risk Adjustment Model Binding: Example CMS Hierarchical Condition Category Value Set (example) | ||||
population | 0..* | BackboneElement | The populations in the group | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | Σ | 0..1 | CodeableConcept | initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation Binding: MeasurePopulationType (extensible): The type of population (e.g. initial, numerator, denominator, etc.). | ||||
count | 0..1 | integer | Size of the population | |||||
subjectResults | 0..1 | Reference(List) | For subject-list reports, the subject results in this population | |||||
measureScore | Σ | 0..1 | Quantity | What score this group achieved | ||||
stratifier | 0..* | BackboneElement | Stratification results | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | 0..1 | CodeableConcept | What stratifier of the group | |||||
stratum | 0..* | BackboneElement | Stratum results, one for each unique value, or set of values, in the stratifier, or stratifier components | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
value | 0..1 | CodeableConcept | The stratum value, e.g. male | |||||
component | 0..* | BackboneElement | Stratifier component values | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | 1..1 | CodeableConcept | What stratifier component of the group | |||||
value | 1..1 | CodeableConcept | The stratum component value, e.g. male | |||||
population | 0..* | BackboneElement | Population results in this stratum | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | 0..1 | CodeableConcept | initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation Binding: MeasurePopulationType (extensible): The type of population (e.g. initial, numerator, denominator, etc.). | |||||
count | 0..1 | integer | Size of the population | |||||
subjectResults | 0..1 | Reference(List) | For subject-list reports, the subject results in this population | |||||
measureScore | 0..1 | Quantity | What score this stratum achieved | |||||
evaluatedResource | S | 0..* | Reference(Resource) | An evaluated resource is any data a clinician would need to independently arrive at the clinical inference that a Condition Category (CC) listed on a Risk Adjustment Coding Gap Report could be present for a patient. Risk adjusted evaluated resources may include practitioners, encounters, diagnoses, medications, labs, or any other clinical evidence that the suspecting algorithm may have used as supporting evidence to infer the presence of a Condition Category (CC) gap. | ||||
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 | |||||
ra-groupReference | S | 0..* | string | This references the MeasureReport.group.id. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-groupReference | ||||
reference | ΣI | 0..1 | string | Literal reference, Relative, internal or absolute URL | ||||
type | Σ | 0..1 | uri | Type the reference refers to (e.g. "Patient") Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model). | ||||
identifier | Σ | 0..1 | Identifier | Logical reference, when literal reference is not known | ||||
display | Σ | 0..1 | string | Text alternative for the resource | ||||
Documentation for this format |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
MeasureReport | I | 0..* | MeasureReport | This is a Risk Adjustment Coding Gap Report. |
ra-clinicalDataCollectionDeadline | 0..1 | date | This is the deadline by which the providers must have all claims data to the payers to count for risk adjustment for a clinical evaluation period. This date is set by the Payer and applies to the early-bird date if incentive were offered. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-clinicalDataCollectionDeadline | |
status | ?!Σ | 1..1 | code | complete | pending | error Binding: MeasureReportStatus (required): The status of the measure report. |
type | ΣI | 1..1 | code | The type code is fixed to 'individual' for Risk Adjustment Coding Gap Report Binding: MeasureReportType (required): The type of the measure report. Fixed Value: individual |
measure | Σ | 1..1 | canonical(Risk Adjustment Model Measure) | This references a measure that represents a Risk Adjustment model, such as CMS-HCC V24. |
subject | Σ | 1..1 | Reference(US Core Patient Profile) | What individual(s) the report is for |
date | Σ | 1..1 | dateTime | When the report was generated |
reporter | Σ | 1..1 | Reference(US Core Organization Profile) | Organization that generated the MeasureReport |
period | ΣI | 1..1 | Period | Clinical evaluation period during which risk adjusting encounters could be conducted and documented with expectations of submission for risk adjustment purposes. ra-1: Date precision SHALL be at least to day ( YYYY-MM-DD ) |
start | ΣI | 1..1 | dateTime | Starting time with inclusive boundary |
end | ΣI | 1..1 | dateTime | End time with inclusive boundary, if not ongoing |
group | I | 0..* | BackboneElement | A group contains information for a Condition Category. If a patient/member has multiple Condition Categories, there will be multiple group(s) and each group represents a Condition Category. |
id | 1..1 | string | Unique id for inter-element referencing | |
ra-suspectType | 0..1 | CodeableConcept | This is the risk adjustment suspect type for a Condition Category (CC) gap URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-suspectType Binding: Risk Adjustment Suspect Type Value Set (extensible) | |
ra-evidenceStatus | 0..1 | CodeableConcept | This is evidence status of a Condition Category (CC) coding gap: open-gap|closed-gap|pending. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-evidenceStatus Binding: Risk Adjustment Evidence Status Value Set (extensible) | |
ra-evidenceStatusDate | 0..1 | date | When the evidence status was changed to either closed-gap, open-gap, or pending URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-evidenceStatusDate | |
ra-hierarchicalStatus | 0..1 | CodeableConcept | This is to indicate whether hierarchies were applied to a Condition Category (CC), and if applied, whether the Condition Category (CC) is superseded: applied-superseded|applied-not-superseded|not-applied|not-applicable URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-hierarchicalStatus Binding: Risk Adjustment Hierarchical Status Value Set (extensible) | |
code | Σ | 0..1 | CodeableConcept | Condition Category (CC) code for a Risk Adjustment Model Binding: Example CMS Hierarchical Condition Category Value Set (example) |
evaluatedResource | 0..* | Reference(Resource) | An evaluated resource is any data a clinician would need to independently arrive at the clinical inference that a Condition Category (CC) listed on a Risk Adjustment Coding Gap Report could be present for a patient. Risk adjusted evaluated resources may include practitioners, encounters, diagnoses, medications, labs, or any other clinical evidence that the suspecting algorithm may have used as supporting evidence to infer the presence of a Condition Category (CC) gap. | |
ra-groupReference | 0..* | string | This references the MeasureReport.group.id. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-groupReference | |
Documentation for this format |
This structure is derived from MeasureReport
Summary
Mandatory: 6 elements (1 nested mandatory element)
Must-Support: 19 elements
Fixed Value: 1 element
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Differential View
This structure is derived from MeasureReport
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
MeasureReport | 0..* | MeasureReport | This is a Risk Adjustment Coding Gap Report. | |
ra-clinicalDataCollectionDeadline | S | 0..1 | date | This is the deadline by which the providers must have all claims data to the payers to count for risk adjustment for a clinical evaluation period. This date is set by the Payer and applies to the early-bird date if incentive were offered. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-clinicalDataCollectionDeadline |
status | S | 1..1 | code | complete | pending | error |
type | S | 1..1 | code | The type code is fixed to 'individual' for Risk Adjustment Coding Gap Report Fixed Value: individual |
measure | S | 1..1 | canonical(Risk Adjustment Model Measure) | This references a measure that represents a Risk Adjustment model, such as CMS-HCC V24. |
subject | S | 1..1 | Reference(US Core Patient Profile) | What individual(s) the report is for |
date | S | 1..1 | dateTime | When the report was generated |
reporter | S | 1..1 | Reference(US Core Organization Profile) | Organization that generated the MeasureReport |
period | SI | 1..1 | Period | Clinical evaluation period during which risk adjusting encounters could be conducted and documented with expectations of submission for risk adjustment purposes. ra-1: Date precision SHALL be at least to day ( YYYY-MM-DD ) |
start | S | 1..1 | dateTime | Starting time with inclusive boundary |
end | S | 1..1 | dateTime | End time with inclusive boundary, if not ongoing |
group | S | 0..* | BackboneElement | A group contains information for a Condition Category. If a patient/member has multiple Condition Categories, there will be multiple group(s) and each group represents a Condition Category. |
id | S | 1..1 | string | Unique id for inter-element referencing |
ra-suspectType | S | 0..1 | CodeableConcept | This is the risk adjustment suspect type for a Condition Category (CC) gap URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-suspectType Binding: Risk Adjustment Suspect Type Value Set (extensible) |
ra-evidenceStatus | S | 0..1 | CodeableConcept | This is evidence status of a Condition Category (CC) coding gap: open-gap|closed-gap|pending. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-evidenceStatus Binding: Risk Adjustment Evidence Status Value Set (extensible) |
ra-evidenceStatusDate | S | 0..1 | date | When the evidence status was changed to either closed-gap, open-gap, or pending URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-evidenceStatusDate |
ra-hierarchicalStatus | S | 0..1 | CodeableConcept | This is to indicate whether hierarchies were applied to a Condition Category (CC), and if applied, whether the Condition Category (CC) is superseded: applied-superseded|applied-not-superseded|not-applied|not-applicable URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-hierarchicalStatus Binding: Risk Adjustment Hierarchical Status Value Set (extensible) |
code | S | 0..1 | CodeableConcept | Condition Category (CC) code for a Risk Adjustment Model Binding: Example CMS Hierarchical Condition Category Value Set (example) |
stratifier | ||||
code | 0..1 | CodeableConcept | What stratifier of the group | |
evaluatedResource | S | 0..* | Reference(Resource) | An evaluated resource is any data a clinician would need to independently arrive at the clinical inference that a Condition Category (CC) listed on a Risk Adjustment Coding Gap Report could be present for a patient. Risk adjusted evaluated resources may include practitioners, encounters, diagnoses, medications, labs, or any other clinical evidence that the suspecting algorithm may have used as supporting evidence to infer the presence of a Condition Category (CC) gap. |
ra-groupReference | S | 0..* | string | This references the MeasureReport.group.id. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-groupReference |
Documentation for this format |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
MeasureReport | I | 0..* | MeasureReport | This is a Risk Adjustment Coding Gap Report. | ||||
id | Σ | 0..1 | string | Logical id of this artifact | ||||
meta | Σ | 0..1 | Meta | Metadata about the resource | ||||
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
language | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |||||
contained | 0..* | Resource | Contained, inline Resources | |||||
ra-clinicalDataCollectionDeadline | S | 0..1 | date | This is the deadline by which the providers must have all claims data to the payers to count for risk adjustment for a clinical evaluation period. This date is set by the Payer and applies to the early-bird date if incentive were offered. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-clinicalDataCollectionDeadline | ||||
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored | ||||
identifier | Σ | 0..* | Identifier | Additional identifier for the MeasureReport | ||||
status | ?!SΣ | 1..1 | code | complete | pending | error Binding: MeasureReportStatus (required): The status of the measure report. | ||||
type | SΣI | 1..1 | code | The type code is fixed to 'individual' for Risk Adjustment Coding Gap Report Binding: MeasureReportType (required): The type of the measure report. Fixed Value: individual | ||||
measure | SΣ | 1..1 | canonical(Risk Adjustment Model Measure) | This references a measure that represents a Risk Adjustment model, such as CMS-HCC V24. | ||||
subject | SΣ | 1..1 | Reference(US Core Patient Profile) | What individual(s) the report is for | ||||
date | SΣ | 1..1 | dateTime | When the report was generated | ||||
reporter | SΣ | 1..1 | Reference(US Core Organization Profile) | Organization that generated the MeasureReport | ||||
period | SΣI | 1..1 | Period | Clinical evaluation period during which risk adjusting encounters could be conducted and documented with expectations of submission for risk adjustment purposes. ra-1: Date precision SHALL be at least to day ( YYYY-MM-DD ) | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
start | SΣI | 1..1 | dateTime | Starting time with inclusive boundary | ||||
end | SΣI | 1..1 | dateTime | End time with inclusive boundary, if not ongoing | ||||
improvementNotation | ?!Σ | 0..1 | CodeableConcept | increase | decrease Binding: MeasureImprovementNotation (required): Observation values that indicate what change in a measurement value or score is indicative of an improvement in the measured item or scored issue. | ||||
group | SI | 0..* | BackboneElement | A group contains information for a Condition Category. If a patient/member has multiple Condition Categories, there will be multiple group(s) and each group represents a Condition Category. | ||||
id | S | 1..1 | string | Unique id for inter-element referencing | ||||
Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
ra-suspectType | S | 0..1 | CodeableConcept | This is the risk adjustment suspect type for a Condition Category (CC) gap URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-suspectType Binding: Risk Adjustment Suspect Type Value Set (extensible) | ||||
ra-evidenceStatus | S | 0..1 | CodeableConcept | This is evidence status of a Condition Category (CC) coding gap: open-gap|closed-gap|pending. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-evidenceStatus Binding: Risk Adjustment Evidence Status Value Set (extensible) | ||||
ra-evidenceStatusDate | S | 0..1 | date | When the evidence status was changed to either closed-gap, open-gap, or pending URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-evidenceStatusDate | ||||
ra-hierarchicalStatus | S | 0..1 | CodeableConcept | This is to indicate whether hierarchies were applied to a Condition Category (CC), and if applied, whether the Condition Category (CC) is superseded: applied-superseded|applied-not-superseded|not-applied|not-applicable URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-hierarchicalStatus Binding: Risk Adjustment Hierarchical Status Value Set (extensible) | ||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | SΣ | 0..1 | CodeableConcept | Condition Category (CC) code for a Risk Adjustment Model Binding: Example CMS Hierarchical Condition Category Value Set (example) | ||||
population | 0..* | BackboneElement | The populations in the group | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | Σ | 0..1 | CodeableConcept | initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation Binding: MeasurePopulationType (extensible): The type of population (e.g. initial, numerator, denominator, etc.). | ||||
count | 0..1 | integer | Size of the population | |||||
subjectResults | 0..1 | Reference(List) | For subject-list reports, the subject results in this population | |||||
measureScore | Σ | 0..1 | Quantity | What score this group achieved | ||||
stratifier | 0..* | BackboneElement | Stratification results | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | 0..1 | CodeableConcept | What stratifier of the group | |||||
stratum | 0..* | BackboneElement | Stratum results, one for each unique value, or set of values, in the stratifier, or stratifier components | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
value | 0..1 | CodeableConcept | The stratum value, e.g. male | |||||
component | 0..* | BackboneElement | Stratifier component values | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | 1..1 | CodeableConcept | What stratifier component of the group | |||||
value | 1..1 | CodeableConcept | The stratum component value, e.g. male | |||||
population | 0..* | BackboneElement | Population results in this stratum | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | 0..1 | CodeableConcept | initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation Binding: MeasurePopulationType (extensible): The type of population (e.g. initial, numerator, denominator, etc.). | |||||
count | 0..1 | integer | Size of the population | |||||
subjectResults | 0..1 | Reference(List) | For subject-list reports, the subject results in this population | |||||
measureScore | 0..1 | Quantity | What score this stratum achieved | |||||
evaluatedResource | S | 0..* | Reference(Resource) | An evaluated resource is any data a clinician would need to independently arrive at the clinical inference that a Condition Category (CC) listed on a Risk Adjustment Coding Gap Report could be present for a patient. Risk adjusted evaluated resources may include practitioners, encounters, diagnoses, medications, labs, or any other clinical evidence that the suspecting algorithm may have used as supporting evidence to infer the presence of a Condition Category (CC) gap. | ||||
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 | |||||
ra-groupReference | S | 0..* | string | This references the MeasureReport.group.id. URL: http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-groupReference | ||||
reference | ΣI | 0..1 | string | Literal reference, Relative, internal or absolute URL | ||||
type | Σ | 0..1 | uri | Type the reference refers to (e.g. "Patient") Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model). | ||||
identifier | Σ | 0..1 | Identifier | Logical reference, when literal reference is not known | ||||
display | Σ | 0..1 | string | Text alternative for the resource | ||||
Documentation for this format |
Other representations of profile: CSV, Excel, Schematron
Path | Conformance | ValueSet / Code |
MeasureReport.language | preferred | CommonLanguages Max Binding: AllLanguages |
MeasureReport.status | required | MeasureReportStatus |
MeasureReport.type | required | Fixed Value: individual |
MeasureReport.improvementNotation | required | MeasureImprovementNotation |
MeasureReport.group.code | example | ExampleCMSHCCValueSet |
MeasureReport.group.population.code | extensible | MeasurePopulationType |
MeasureReport.group.stratifier.stratum.population.code | extensible | MeasurePopulationType |
MeasureReport.evaluatedResource.type | extensible | ResourceType |
Id | Grade | Path | Details | Requirements |
dom-2 | error | MeasureReport | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
dom-3 | error | MeasureReport | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() | |
dom-4 | error | MeasureReport | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() | |
dom-5 | error | MeasureReport | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
dom-6 | Best Practice | MeasureReport | A resource should have narrative for robust management : text.`div`.exists() | |
mrp-1 | error | MeasureReport | Measure Reports used for data collection SHALL NOT communicate group and score information : (type != 'data-collection') or group.exists().not() | |
mrp-2 | error | MeasureReport | Stratifiers SHALL be either a single criteria or a set of criteria components : group.stratifier.stratum.all(value.exists() xor component.exists()) | |
ele-1 | error | MeasureReport.meta | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.implicitRules | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.language | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.text | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.extension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.extension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.modifierExtension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.modifierExtension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.identifier | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.status | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.type | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.measure | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.subject | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.date | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.reporter | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.period | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ra-1 | error | MeasureReport.period | Date precision SHALL be at least to day ( YYYY-MM-DD ) : start.matches('^([0-9]{4})(-)(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9]).*') and end.matches('^([0-9]{4})(-)(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9]).*') | |
ele-1 | error | MeasureReport.period.extension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.period.extension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.period.start | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.period.end | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.improvementNotation | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.extension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.extension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.extension:suspectType | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.extension:suspectType | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.extension:evidenceStatus | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.extension:evidenceStatus | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.extension:evidenceStatusDate | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.extension:evidenceStatusDate | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.extension:hierarchicalStatus | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.extension:hierarchicalStatus | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.modifierExtension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.modifierExtension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.code | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.population | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.population.extension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.population.extension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.population.modifierExtension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.population.modifierExtension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.population.code | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.population.count | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.population.subjectResults | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.measureScore | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.stratifier | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.stratifier.extension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.stratifier.extension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.stratifier.modifierExtension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.stratifier.modifierExtension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.stratifier.code | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.stratifier.stratum | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.stratifier.stratum.extension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.stratifier.stratum.extension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.stratifier.stratum.modifierExtension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.stratifier.stratum.modifierExtension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.stratifier.stratum.value | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.stratifier.stratum.component | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.stratifier.stratum.component.extension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.stratifier.stratum.component.extension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.stratifier.stratum.component.modifierExtension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.stratifier.stratum.component.modifierExtension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.stratifier.stratum.component.code | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.stratifier.stratum.component.value | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.stratifier.stratum.population | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.stratifier.stratum.population.extension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.stratifier.stratum.population.extension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.stratifier.stratum.population.modifierExtension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.group.stratifier.stratum.population.modifierExtension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.group.stratifier.stratum.population.code | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.stratifier.stratum.population.count | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.stratifier.stratum.population.subjectResults | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.group.stratifier.stratum.measureScore | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.evaluatedResource | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.evaluatedResource.extension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.evaluatedResource.extension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.evaluatedResource.extension:groupReference | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | MeasureReport.evaluatedResource.extension:groupReference | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | error | MeasureReport.evaluatedResource.reference | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.evaluatedResource.type | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.evaluatedResource.identifier | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | error | MeasureReport.evaluatedResource.display | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) |