CDS Hooks
3.0.0-ballot - R3 Normative Ballot
CDS Hooks
3.0.0-ballot - R3 Normative Ballot
CDS Hooks, published by Clinical Decision Support WG. 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/cds-hooks/ and changes regularly. See the Directory of published versions
| Page standards status: Trial-use | Maturity Level: 1 |
<CodeSystem xmlns="http://hl7.org/fhir">
<id value="non-adherence-reason-codes"/>
<language value="en"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: CodeSystem non-adherence-reason-codes</b></p><a name="non-adherence-reason-codes"> </a><a name="hcnon-adherence-reason-codes"> </a><p>This case-sensitive code system <code>http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes</code> defines the following codes in a Grouped By hierarchy:</p><table class="codes"><tr><td><b>Lvl</b></td><td style="white-space:nowrap"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td></tr><tr><td>1</td><td style="white-space:nowrap">cds-not-applicable<a name="non-adherence-reason-codes-cds-not-applicable"> </a></td><td>PC CDS does not apply to patient</td><td>The CDS recommendation is irrelevant, completed, or the patient does not meet the criteria.</td></tr><tr><td>2</td><td style="white-space:nowrap"> patient-ineligible<a name="non-adherence-reason-codes-patient-ineligible"> </a></td><td>Patient does not meet eligibility for recommended action</td><td>The patient does not satisfy the criteria (e.g., age, condition, lab result) for the recommended action.</td></tr><tr><td>2</td><td style="white-space:nowrap"> indication-order-exists<a name="non-adherence-reason-codes-indication-order-exists"> </a></td><td>Patient has indication/order for intended action</td><td>The recommended action is already indicated or ordered in the patient's record, making the CDS redundant.</td></tr><tr><td>2</td><td style="white-space:nowrap"> action-completed<a name="non-adherence-reason-codes-action-completed"> </a></td><td>Recommended action was already completed</td><td>The action or procedure recommended by the CDS has already been performed.</td></tr><tr><td>2</td><td style="white-space:nowrap"> action-unsuccessful<a name="non-adherence-reason-codes-action-unsuccessful"> </a></td><td>Recommended action was previously unsuccessful</td><td>The recommended action was attempted before and failed to achieve the desired outcome.</td></tr><tr><td>2</td><td style="white-space:nowrap"> action-performed-no-adverse-effect<a name="non-adherence-reason-codes-action-performed-no-adverse-effect"> </a></td><td>Intended action was performed previously without adverse effect</td><td>A previously performed action that was the subject of the CDS did not cause harm, suggesting the action is safe despite the CDS warning.</td></tr><tr><td>2</td><td style="white-space:nowrap"> action-not-priority<a name="non-adherence-reason-codes-action-not-priority"> </a></td><td>Recommended action is not relevant or a priority in current state of health</td><td>The patient's acute or chronic conditions require more immediate attention than the action recommended by the CDS.</td></tr><tr><td>1</td><td style="white-space:nowrap">cds-suboptimal-context<a name="non-adherence-reason-codes-cds-suboptimal-context"> </a></td><td>PC CDS delivered in suboptimal context</td><td>The CDS was delivered at a time or to a recipient that made the action impossible or impractical to address.</td></tr><tr><td>2</td><td style="white-space:nowrap"> limited-time<a name="non-adherence-reason-codes-limited-time"> </a></td><td>Could not address recommended action due to limited time</td><td>The recipient had insufficient time during the current patient encounter or workflow step to act on the recommendation.</td></tr><tr><td>2</td><td style="white-space:nowrap"> wrong-time-workflow<a name="non-adherence-reason-codes-wrong-time-workflow"> </a></td><td>PC CDS delivered at wrong time in workflow or patient lifecycle</td><td>The alert appeared at a point in the workflow or patient's care journey where it could not be practically acted upon.</td></tr><tr><td>2</td><td style="white-space:nowrap"> inappropriate-recipient<a name="non-adherence-reason-codes-inappropriate-recipient"> </a></td><td>PC CDS delivered to inappropriate recipient/role</td><td>The person receiving the recommendation (e.g., a nurse, clerk) is not authorized or responsible for performing the action.</td></tr><tr><td>2</td><td style="white-space:nowrap"> need-more-info<a name="non-adherence-reason-codes-need-more-info"> </a></td><td>Could not address recommended action due to need for more information/pending results/pending consult</td><td>The recipient requires additional data (e.g., a lab result, imaging) or a specialist's opinion before the action can be safely or definitively taken.</td></tr><tr><td>1</td><td style="white-space:nowrap">recipient-disagrees-evidence<a name="non-adherence-reason-codes-recipient-disagrees-evidence"> </a></td><td>Recipient disagrees with recommendation because of issues with the evidence</td><td>The recipient (clinician or patient) has an objection based on the supporting evidence or conflicting advice/policy.</td></tr><tr><td>2</td><td style="white-space:nowrap"> does-not-align-latest-evidence<a name="non-adherence-reason-codes-does-not-align-latest-evidence"> </a></td><td>Recommended action does not align with the latest evidence</td><td>The recipient believes the CDS rule is outdated compared to current medical literature or best practices.</td></tr><tr><td>2</td><td style="white-space:nowrap"> expert-contradicts<a name="non-adherence-reason-codes-expert-contradicts"> </a></td><td>Advice from expert contradicts the recommended action</td><td>Guidance received from a specialist or recognized authority conflicts with the CDS recommendation.</td></tr><tr><td>2</td><td style="white-space:nowrap"> policy-contradicts<a name="non-adherence-reason-codes-policy-contradicts"> </a></td><td>Institutional policy/guideline contradicts the recommended action</td><td>The recommendation conflicts with the official procedures, policies, or local guidelines of the healthcare facility.</td></tr><tr><td>2</td><td style="white-space:nowrap"> recipient-does-not-trust<a name="non-adherence-reason-codes-recipient-does-not-trust"> </a></td><td>Recipient does not agree with or trust the recommended action</td><td>The recipient fundamentally disbelieves the validity or necessity of the CDS action.</td></tr><tr><td>1</td><td style="white-space:nowrap">recipient-concerns-outcomes<a name="non-adherence-reason-codes-recipient-concerns-outcomes"> </a></td><td>Recipient has concerns regarding potential health outcomes</td><td>Concerns about the action's risk/benefit ratio, potential negative outcomes, or contraindications.</td></tr><tr><td>2</td><td style="white-space:nowrap"> risk-benefit-ratio<a name="non-adherence-reason-codes-risk-benefit-ratio"> </a></td><td>Recipient assessment of risk/benefit ratio</td><td>The recipient determines that the potential risks of the action outweigh the anticipated benefits for this specific patient.</td></tr><tr><td>2</td><td style="white-space:nowrap"> mitigate-risk-negative-outcome<a name="non-adherence-reason-codes-mitigate-risk-negative-outcome"> </a></td><td>Action taken to mitigate risk of negative outcome</td><td>The recommended action was superseded by an alternative measure taken to specifically avoid a known potential adverse event.</td></tr><tr><td>2</td><td style="white-space:nowrap"> likely-negative-health-outcomes<a name="non-adherence-reason-codes-likely-negative-health-outcomes"> </a></td><td>Recommended action likely to have negative health outcomes</td><td>The recipient believes the action, if taken, would predictably lead to an adverse patient outcome (e.g., severe side effect).</td></tr><tr><td>2</td><td style="white-space:nowrap"> patient-contraindication<a name="non-adherence-reason-codes-patient-contraindication"> </a></td><td>Patient has contraindication to recommended action</td><td>A patient factor (e.g., allergy, existing condition, previous reaction) explicitly rules out the recommended action.</td></tr><tr><td>1</td><td style="white-space:nowrap">does-not-align-preferences<a name="non-adherence-reason-codes-does-not-align-preferences"> </a></td><td>Recommendation does not align with patient preferences or values</td><td>The action conflicts with the patient's personal, cultural, or religious beliefs, or they prefer an alternative.</td></tr><tr><td>2</td><td style="white-space:nowrap"> patient-fears-discomfort<a name="non-adherence-reason-codes-patient-fears-discomfort"> </a></td><td>Patient fears discomfort from complying with recommended action</td><td>The patient is unwilling to proceed due to anticipated pain, anxiety, or general discomfort associated with the action.</td></tr><tr><td>2</td><td style="white-space:nowrap"> patient-does-not-want-change<a name="non-adherence-reason-codes-patient-does-not-want-change"> </a></td><td>Patient does not want to change behavior or believes the change is unnecessary</td><td>The patient lacks motivation for lifestyle change or disagrees with the premise that a change is needed for their health.</td></tr><tr><td>2</td><td style="white-space:nowrap"> cultural-religious-reason<a name="non-adherence-reason-codes-cultural-religious-reason"> </a></td><td>Patient has a cultural or religious reason for not following recommended action</td><td>The patient's deeply held cultural or religious beliefs prohibit them from accepting the recommendation (e.g., blood transfusions).</td></tr><tr><td>2</td><td style="white-space:nowrap"> prefers-alternative<a name="non-adherence-reason-codes-prefers-alternative"> </a></td><td>Patient prefers an alternative approach or treatment</td><td>The patient wishes to pursue a different, non-recommended treatment or approach (e.g., holistic medicine).</td></tr><tr><td>2</td><td style="white-space:nowrap"> patient-refuses<a name="non-adherence-reason-codes-patient-refuses"> </a></td><td>Patient refuses/declines (no context given)*</td><td>The patient has simply refused the recommendation without providing an explicit, detailed reason.</td></tr><tr><td>1</td><td style="white-space:nowrap">not-convenient-feasible<a name="non-adherence-reason-codes-not-convenient-feasible"> </a></td><td>Recommendation is not convenient or feasible</td><td>Practical barriers related to cost, logistics, technology, or patient capability prevent the action.</td></tr><tr><td>2</td><td style="white-space:nowrap"> inadequate-support<a name="non-adherence-reason-codes-inadequate-support"> </a></td><td>Patient has inadequate caregiver/social support</td><td>The patient lacks the necessary assistance from family or caregivers to comply with the action.</td></tr><tr><td>2</td><td style="white-space:nowrap"> service-not-available<a name="non-adherence-reason-codes-service-not-available"> </a></td><td>Treatment or service is not practically available</td><td>The required service, medication, or equipment is not accessible, either geographically or logistically.</td></tr><tr><td>2</td><td style="white-space:nowrap"> implementation-challenges<a name="non-adherence-reason-codes-implementation-challenges"> </a></td><td>Recommended action cannot be implemented due to technology/challenges</td><td>Technical issues, system downtime, or complexity of the EHR/device prevent the action from being recorded or performed.</td></tr><tr><td>2</td><td style="white-space:nowrap"> too-costly-uncovered<a name="non-adherence-reason-codes-too-costly-uncovered"> </a></td><td>Recommended action is too costly or not covered by insurance</td><td>Financial burden is a barrier, either due to the cost of the service or lack of insurance coverage.</td></tr><tr><td>2</td><td style="white-space:nowrap"> recipient-does-not-understand<a name="non-adherence-reason-codes-recipient-does-not-understand"> </a></td><td>Recipient does not understand the recommended action or know how to perform the recommended action</td><td>The recipient (patient or clinician) lacks the necessary health literacy or procedural knowledge to execute the action.</td></tr><tr><td>2</td><td style="white-space:nowrap"> comorbidity-disability<a name="non-adherence-reason-codes-comorbidity-disability"> </a></td><td>Patient has co-morbidity or disability that hinders them from completing recommended action</td><td>An unrelated or co-existing physical/mental condition (e.g., severe arthritis, dementia) makes the action impossible for the patient.</td></tr></table></div>
</text>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
<valueCode value="cds"/>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
<valueCode value="trial-use"/>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
<valueInteger value="1"/>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/artifact-relatedArtifact">
<valueRelatedArtifact>
<type value="citation"/>
<citation
value="Boxwala AA, Correa KH, Richesson RL, Leaphart D, Ahmed A, Desai PJ, the CDSiC Standards and Regulatory Frameworks Workgroup, and Dullabh PM. CDS Standards and Regulatory Frameworks Workgroup: Approaches to Standardizing Override Reasons for Patient-Centered Clinical Decision Support. Prepared under Contract No. 75Q80120D00018. AHRQ Publication No. 25-0073. Agency for Healthcare Research and Quality; June 2025."/>
</valueRelatedArtifact>
</extension>
<url
value="http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes"/>
<version value="3.0.0-ballot"/>
<name value="NonAdherenceReasonCodes"/>
<title value="Non-Adherence Reason Codes"/>
<status value="active"/>
<experimental value="false"/>
<date value="2025-12-14T21:46:53+00:00"/>
<publisher value="Clinical Decision Support WG"/>
<contact>
<name value="Clinical Decision Support WG"/>
<telecom>
<system value="url"/>
<value value="http://www.hl7.org/Special/committees/dss/index.cfm"/>
</telecom>
<telecom>
<system value="email"/>
<value value="cds@lists.HL7.org"/>
</telecom>
</contact>
<description
value="Codes representing reasons why a Patient Care Clinical Decision Support (PC CDS) recommendation may not be followed, categorized by the source of the barrier. The concepts here were originally defined in the AHRQ CDSiC publication [Approaches to Standardizing Override Reasons for Patient-Centered Clinical Decision Support](https://digital.ahrq.gov/sites/default/files/508_SRF%20Level%202%20Override%20Taxonomy%20Implementation%208.28.25.pdf).
Notes: "Recipient" means the individual who received the PC CDS, which could be a clinician for clinician-facing PC CDS, or a patient or caregiver for patient-facing PC CDS. "Recommended action" refers to the action suggested by the PC CDS. "Intended action" refers to the course of action that the PC CDS recipient (clinician, patient, or caregiver) meant to take, and which triggered the PC CDS. *The category "Patient refuses/declines (no context given)" is included to acknowledge that override reasons that document patient refusal without providing more information are common in current CDS tools. However, this category is separated from the main taxonomy to indicate that it is not a preferred option; in the future, it would be ideal if PC CDS tools provided more specific patient override reasons."/>
<jurisdiction>
<coding>
<system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>
<code value="001"/>
<display value="World"/>
</coding>
</jurisdiction>
<caseSensitive value="true"/>
<valueSet value="http://terminology.hl7.org/ValueSet/non-adherence-reason"/>
<hierarchyMeaning value="grouped-by"/>
<content value="complete"/>
<concept>
<code value="cds-not-applicable"/>
<display value="PC CDS does not apply to patient"/>
<definition
value="The CDS recommendation is irrelevant, completed, or the patient does not meet the criteria."/>
<concept>
<code value="patient-ineligible"/>
<display
value="Patient does not meet eligibility for recommended action"/>
<definition
value="The patient does not satisfy the criteria (e.g., age, condition, lab result) for the recommended action."/>
</concept>
<concept>
<code value="indication-order-exists"/>
<display value="Patient has indication/order for intended action"/>
<definition
value="The recommended action is already indicated or ordered in the patient's record, making the CDS redundant."/>
</concept>
<concept>
<code value="action-completed"/>
<display value="Recommended action was already completed"/>
<definition
value="The action or procedure recommended by the CDS has already been performed."/>
</concept>
<concept>
<code value="action-unsuccessful"/>
<display value="Recommended action was previously unsuccessful"/>
<definition
value="The recommended action was attempted before and failed to achieve the desired outcome."/>
</concept>
<concept>
<code value="action-performed-no-adverse-effect"/>
<display
value="Intended action was performed previously without adverse effect"/>
<definition
value="A previously performed action that was the subject of the CDS did not cause harm, suggesting the action is safe despite the CDS warning."/>
</concept>
<concept>
<code value="action-not-priority"/>
<display
value="Recommended action is not relevant or a priority in current state of health"/>
<definition
value="The patient's acute or chronic conditions require more immediate attention than the action recommended by the CDS."/>
</concept>
</concept>
<concept>
<code value="cds-suboptimal-context"/>
<display value="PC CDS delivered in suboptimal context"/>
<definition
value="The CDS was delivered at a time or to a recipient that made the action impossible or impractical to address."/>
<concept>
<code value="limited-time"/>
<display
value="Could not address recommended action due to limited time"/>
<definition
value="The recipient had insufficient time during the current patient encounter or workflow step to act on the recommendation."/>
</concept>
<concept>
<code value="wrong-time-workflow"/>
<display
value="PC CDS delivered at wrong time in workflow or patient lifecycle"/>
<definition
value="The alert appeared at a point in the workflow or patient's care journey where it could not be practically acted upon."/>
</concept>
<concept>
<code value="inappropriate-recipient"/>
<display value="PC CDS delivered to inappropriate recipient/role"/>
<definition
value="The person receiving the recommendation (e.g., a nurse, clerk) is not authorized or responsible for performing the action."/>
</concept>
<concept>
<code value="need-more-info"/>
<display
value="Could not address recommended action due to need for more information/pending results/pending consult"/>
<definition
value="The recipient requires additional data (e.g., a lab result, imaging) or a specialist's opinion before the action can be safely or definitively taken."/>
</concept>
</concept>
<concept>
<code value="recipient-disagrees-evidence"/>
<display
value="Recipient disagrees with recommendation because of issues with the evidence"/>
<definition
value="The recipient (clinician or patient) has an objection based on the supporting evidence or conflicting advice/policy."/>
<concept>
<code value="does-not-align-latest-evidence"/>
<display
value="Recommended action does not align with the latest evidence"/>
<definition
value="The recipient believes the CDS rule is outdated compared to current medical literature or best practices."/>
</concept>
<concept>
<code value="expert-contradicts"/>
<display value="Advice from expert contradicts the recommended action"/>
<definition
value="Guidance received from a specialist or recognized authority conflicts with the CDS recommendation."/>
</concept>
<concept>
<code value="policy-contradicts"/>
<display
value="Institutional policy/guideline contradicts the recommended action"/>
<definition
value="The recommendation conflicts with the official procedures, policies, or local guidelines of the healthcare facility."/>
</concept>
<concept>
<code value="recipient-does-not-trust"/>
<display
value="Recipient does not agree with or trust the recommended action"/>
<definition
value="The recipient fundamentally disbelieves the validity or necessity of the CDS action."/>
</concept>
</concept>
<concept>
<code value="recipient-concerns-outcomes"/>
<display
value="Recipient has concerns regarding potential health outcomes"/>
<definition
value="Concerns about the action's risk/benefit ratio, potential negative outcomes, or contraindications."/>
<concept>
<code value="risk-benefit-ratio"/>
<display value="Recipient assessment of risk/benefit ratio"/>
<definition
value="The recipient determines that the potential risks of the action outweigh the anticipated benefits for this specific patient."/>
</concept>
<concept>
<code value="mitigate-risk-negative-outcome"/>
<display value="Action taken to mitigate risk of negative outcome"/>
<definition
value="The recommended action was superseded by an alternative measure taken to specifically avoid a known potential adverse event."/>
</concept>
<concept>
<code value="likely-negative-health-outcomes"/>
<display
value="Recommended action likely to have negative health outcomes"/>
<definition
value="The recipient believes the action, if taken, would predictably lead to an adverse patient outcome (e.g., severe side effect)."/>
</concept>
<concept>
<code value="patient-contraindication"/>
<display value="Patient has contraindication to recommended action"/>
<definition
value="A patient factor (e.g., allergy, existing condition, previous reaction) explicitly rules out the recommended action."/>
</concept>
</concept>
<concept>
<code value="does-not-align-preferences"/>
<display
value="Recommendation does not align with patient preferences or values"/>
<definition
value="The action conflicts with the patient's personal, cultural, or religious beliefs, or they prefer an alternative."/>
<concept>
<code value="patient-fears-discomfort"/>
<display
value="Patient fears discomfort from complying with recommended action"/>
<definition
value="The patient is unwilling to proceed due to anticipated pain, anxiety, or general discomfort associated with the action."/>
</concept>
<concept>
<code value="patient-does-not-want-change"/>
<display
value="Patient does not want to change behavior or believes the change is unnecessary"/>
<definition
value="The patient lacks motivation for lifestyle change or disagrees with the premise that a change is needed for their health."/>
</concept>
<concept>
<code value="cultural-religious-reason"/>
<display
value="Patient has a cultural or religious reason for not following recommended action"/>
<definition
value="The patient's deeply held cultural or religious beliefs prohibit them from accepting the recommendation (e.g., blood transfusions)."/>
</concept>
<concept>
<code value="prefers-alternative"/>
<display value="Patient prefers an alternative approach or treatment"/>
<definition
value="The patient wishes to pursue a different, non-recommended treatment or approach (e.g., holistic medicine)."/>
</concept>
<concept>
<code value="patient-refuses"/>
<display value="Patient refuses/declines (no context given)*"/>
<definition
value="The patient has simply refused the recommendation without providing an explicit, detailed reason."/>
</concept>
</concept>
<concept>
<code value="not-convenient-feasible"/>
<display value="Recommendation is not convenient or feasible"/>
<definition
value="Practical barriers related to cost, logistics, technology, or patient capability prevent the action."/>
<concept>
<code value="inadequate-support"/>
<display value="Patient has inadequate caregiver/social support"/>
<definition
value="The patient lacks the necessary assistance from family or caregivers to comply with the action."/>
</concept>
<concept>
<code value="service-not-available"/>
<display value="Treatment or service is not practically available"/>
<definition
value="The required service, medication, or equipment is not accessible, either geographically or logistically."/>
</concept>
<concept>
<code value="implementation-challenges"/>
<display
value="Recommended action cannot be implemented due to technology/challenges"/>
<definition
value="Technical issues, system downtime, or complexity of the EHR/device prevent the action from being recorded or performed."/>
</concept>
<concept>
<code value="too-costly-uncovered"/>
<display
value="Recommended action is too costly or not covered by insurance"/>
<definition
value="Financial burden is a barrier, either due to the cost of the service or lack of insurance coverage."/>
</concept>
<concept>
<code value="recipient-does-not-understand"/>
<display
value="Recipient does not understand the recommended action or know how to perform the recommended action"/>
<definition
value="The recipient (patient or clinician) lacks the necessary health literacy or procedural knowledge to execute the action."/>
</concept>
<concept>
<code value="comorbidity-disability"/>
<display
value="Patient has co-morbidity or disability that hinders them from completing recommended action"/>
<definition
value="An unrelated or co-existing physical/mental condition (e.g., severe arthritis, dementia) makes the action impossible for the patient."/>
</concept>
</concept>
</CodeSystem>
IG © 2019+ Clinical Decision Support WG.
Package hl7.fhir.uv.cds-hooks#3.0.0-ballot based on FHIR 4.0.1.
Generated
2025-12-14
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change