Da Vinci Risk Adjustment Implementation Guide
3.0.0 - STU 3
Da Vinci Risk Adjustment Implementation Guide
3.0.0 - STU 3
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 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
| Page standards status: Trial-use | Maturity Level: 2 |
<CodeSystem xmlns="http://hl7.org/fhir">
<id value="remark-reason"/>
<language value="en"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: CodeSystem remark-reason</b></p><a name="remark-reason"> </a><a name="hcremark-reason"> </a><p>This case-sensitive code system <code>http://hl7.org/fhir/us/davinci-ra/CodeSystem/remark-reason</code> defines the following codes:</p><table class="codes"><tr><td style="white-space:nowrap"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td></tr><tr><td style="white-space:nowrap">additional-evidence-needed<a name="remark-reason-additional-evidence-needed"> </a></td><td>Additional Evidence Needed</td><td>Reason primarily for the in-progress remark and sometimes for the deferred remark. Available information reviewed by the remarking actor is insufficient to confirm the Condition Category as present or to invalidate it as not present. Additional clinical documentation, outside records, patient evaluation, diagnostic results, or reconciliation is needed before the gap can be resolved.</td></tr><tr><td style="white-space:nowrap">already-submitted<a name="remark-reason-already-submitted"> </a></td><td>Data Already Submitted</td><td>Reason for the assessed-present or assessed-not-present remark. Clinical evidence addressing this coding gap was previously submitted to the payer.</td></tr><tr><td style="white-space:nowrap">attribution-routing-mismatch<a name="remark-reason-attribution-routing-mismatch"> </a></td><td>Attribution or Routing Mismatch</td><td>Reason primarily for the not-assessed remark and sometimes for the not-presented or the not-ingested remark. The remarking actor indicates that the Condition Category gap appears to have been attributed, assigned, or routed to the wrong clinician, organization, care team, or other responsible party. The gap may require reassignment, rerouting, attribution correction, or review of supporting evidence context before assessment by the appropriate party.</td></tr><tr><td style="white-space:nowrap">inactive-condition<a name="remark-reason-inactive-condition"> </a></td><td>Condition no longer active</td><td>Reason for the assessed-not-present remark is because the patient's condition is no longer active.</td></tr><tr><td style="white-space:nowrap">inapplicable-gap<a name="remark-reason-inapplicable-gap"> </a></td><td>Inapplicable gap</td><td>Reason for the assessed-not-present remark is because the patient has an active condition but the gap does not accurately describe it.</td></tr><tr><td style="white-space:nowrap">never-had-condition<a name="remark-reason-never-had-condition"> </a></td><td>Patient never had the condition</td><td>Reason for the assessed-not-present remark is because the patient has never had this condition.</td></tr><tr><td style="white-space:nowrap">outside-specialty-scope<a name="remark-reason-outside-specialty-scope"> </a></td><td>Outside Clinician Specialty or Scope</td><td>Reason for the not-assessed remark. Assessment or confirmation of this condition is outside the rendering clinician’s specialty or scope of practice.</td></tr><tr><td style="white-space:nowrap">patient-declined-evaluation<a name="remark-reason-patient-declined-evaluation"> </a></td><td>Patient Declined Evaluation</td><td>Reason for the not-assessed remark. The patient was offered an evaluation to address this gap but declined assessment.</td></tr><tr><td style="white-space:nowrap">patient-not-evaluated<a name="remark-reason-patient-not-evaluated"> </a></td><td>Patient Not Evaluated During Period</td><td>Reason for the not-assessed remark. The patient was not seen or evaluated by the provider during the relevant reporting period.</td></tr><tr><td style="white-space:nowrap">payer-attribution-mismatch<a name="remark-reason-payer-attribution-mismatch"> </a></td><td>Payer Attribution Mismatch</td><td>Reason for the not-presented remark. The patient is not attributed to this provider or organization based on the payer’s records.</td></tr><tr><td style="white-space:nowrap">requires-follow-up<a name="remark-reason-requires-follow-up"> </a></td><td>Requires Patient Follow-up</td><td>Reason for the deferred remark. Further assessment or action is needed to address the coding gap at a future patient encounter.</td></tr></table></div>
</text>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
<valueCode value="cqi"/>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
<valueInteger value="2">
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom">
<valueCanonical
value="http://hl7.org/fhir/us/davinci-ra/ImplementationGuide/davinci-ra"/>
</extension>
</valueInteger>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
<valueCode value="trial-use">
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom">
<valueCanonical
value="http://hl7.org/fhir/us/davinci-ra/ImplementationGuide/davinci-ra"/>
</extension>
</valueCode>
</extension>
<url value="http://hl7.org/fhir/us/davinci-ra/CodeSystem/remark-reason"/>
<identifier>
<system value="urn:ietf:rfc:3986"/>
<value value="urn:oid:2.16.840.1.113883.4.642.40.29.16.5"/>
</identifier>
<version value="3.0.0"/>
<name value="RemarkReason"/>
<title value="Remark Reason Codes"/>
<status value="active"/>
<experimental value="false"/>
<date value="2026-09-17T21:49:37+00:00"/>
<publisher value="HL7 International / Clinical Quality Information"/>
<contact>
<telecom>
<system value="url"/>
<value value="http://www.hl7.org/Special/committees/cqi"/>
</telecom>
</contact>
<description value="Reason codes for remark"/>
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="US"/>
<display value="United States of America"/>
</coding>
</jurisdiction>
<copyright
value="Used by permission of HL7 International, all rights reserved Creative Commons License"/>
<caseSensitive value="true"/>
<content value="complete"/>
<count value="11"/>
<concept>
<code value="additional-evidence-needed"/>
<display value="Additional Evidence Needed"/>
<definition
value="Reason primarily for the in-progress remark and sometimes for the deferred remark. Available information reviewed by the remarking actor is insufficient to confirm the Condition Category as present or to invalidate it as not present. Additional clinical documentation, outside records, patient evaluation, diagnostic results, or reconciliation is needed before the gap can be resolved."/>
</concept>
<concept>
<code value="already-submitted"/>
<display value="Data Already Submitted"/>
<definition
value="Reason for the assessed-present or assessed-not-present remark. Clinical evidence addressing this coding gap was previously submitted to the payer."/>
</concept>
<concept>
<code value="attribution-routing-mismatch"/>
<display value="Attribution or Routing Mismatch"/>
<definition
value="Reason primarily for the not-assessed remark and sometimes for the not-presented or the not-ingested remark. The remarking actor indicates that the Condition Category gap appears to have been attributed, assigned, or routed to the wrong clinician, organization, care team, or other responsible party. The gap may require reassignment, rerouting, attribution correction, or review of supporting evidence context before assessment by the appropriate party."/>
</concept>
<concept>
<code value="inactive-condition"/>
<display value="Condition no longer active"/>
<definition
value="Reason for the assessed-not-present remark is because the patient's condition is no longer active."/>
</concept>
<concept>
<code value="inapplicable-gap"/>
<display value="Inapplicable gap"/>
<definition
value="Reason for the assessed-not-present remark is because the patient has an active condition but the gap does not accurately describe it."/>
</concept>
<concept>
<code value="never-had-condition"/>
<display value="Patient never had the condition"/>
<definition
value="Reason for the assessed-not-present remark is because the patient has never had this condition."/>
</concept>
<concept>
<code value="outside-specialty-scope"/>
<display value="Outside Clinician Specialty or Scope"/>
<definition
value="Reason for the not-assessed remark. Assessment or confirmation of this condition is outside the rendering clinician’s specialty or scope of practice."/>
</concept>
<concept>
<code value="patient-declined-evaluation"/>
<display value="Patient Declined Evaluation"/>
<definition
value="Reason for the not-assessed remark. The patient was offered an evaluation to address this gap but declined assessment."/>
</concept>
<concept>
<code value="patient-not-evaluated"/>
<display value="Patient Not Evaluated During Period"/>
<definition
value="Reason for the not-assessed remark. The patient was not seen or evaluated by the provider during the relevant reporting period."/>
</concept>
<concept>
<code value="payer-attribution-mismatch"/>
<display value="Payer Attribution Mismatch"/>
<definition
value="Reason for the not-presented remark. The patient is not attributed to this provider or organization based on the payer’s records."/>
</concept>
<concept>
<code value="requires-follow-up"/>
<display value="Requires Patient Follow-up"/>
<definition
value="Reason for the deferred remark. Further assessment or action is needed to address the coding gap at a future patient encounter."/>
</concept>
</CodeSystem>
IG © 2021+ HL7 International / Clinical Quality Information.
Package hl7.fhir.us.davinci-ra#3.0.0 based on FHIR 4.0.1.
Generated
2026-09-17
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change