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
| Official URL: http://terminology.hl7.org/ValueSet/non-adherence-reason-clinical | Version: 3.0.0-ballot | |||
| Standards status: Trial-use Active as of 2025-12-14 | Maturity Level: 1 | Computable Name: NonAdherenceReasonClinical | ||
A set of common and clinically relevant reasons for non-adherence, including all categories and key specific sub-codes for point-of-care selection.
References
This value set is not used here; it may be used elsewhere (e.g. specifications and/or implementations that use this content)
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes version 📦3.0.0-ballot| Code | Display | Definition |
| cds-not-applicable | PC CDS does not apply to patient | The CDS recommendation is irrelevant, completed, or the patient does not meet the criteria. |
| cds-suboptimal-context | PC CDS delivered in suboptimal context | The CDS was delivered at a time or to a recipient that made the action impossible or impractical to address. |
| recipient-disagrees-evidence | Recipient disagrees with recommendation because of issues with the evidence | The recipient (clinician or patient) has an objection based on the supporting evidence or conflicting advice/policy. |
| recipient-concerns-outcomes | Recipient has concerns regarding potential health outcomes | Concerns about the action's risk/benefit ratio, potential negative outcomes, or contraindications. |
| does-not-align-preferences | Recommendation does not align with patient preferences or values | The action conflicts with the patient's personal, cultural, or religious beliefs, or they prefer an alternative. |
| not-convenient-feasible | Recommendation is not convenient or feasible | Practical barriers related to cost, logistics, technology, or patient capability prevent the action. |
| action-completed | Recommended action was already completed | The action or procedure recommended by the CDS has already been performed. |
| patient-contraindication | Patient has contraindication to recommended action | A patient factor (e.g., allergy, existing condition, previous reaction) explicitly rules out the recommended action. |
| patient-refuses | Patient refuses/declines (no context given)* | The patient has simply refused the recommendation without providing an explicit, detailed reason. |
| too-costly-uncovered | Recommended action is too costly or not covered by insurance | Financial burden is a barrier, either due to the cost of the service or lack of insurance coverage. |
| service-not-available | Treatment or service is not practically available | The required service, medication, or equipment is not accessible, either geographically or logistically. |
| recipient-does-not-understand | Recipient does not understand the recommended action or know how to perform the recommended action | The recipient (patient or clinician) lacks the necessary health literacy or procedural knowledge to execute the action. |
Expansion performed internally based on codesystem Non-Adherence Reason Codes v3.0.0-ballot (CodeSystem)
This value set contains 12 concepts
| System | Code | Display (en) | Definition | JSON | XML |
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes | cds-not-applicable | PC CDS does not apply to patient | The CDS recommendation is irrelevant, completed, or the patient does not meet the criteria. | ||
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes | cds-suboptimal-context | PC CDS delivered in suboptimal context | The CDS was delivered at a time or to a recipient that made the action impossible or impractical to address. | ||
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes | recipient-disagrees-evidence | Recipient disagrees with recommendation because of issues with the evidence | The recipient (clinician or patient) has an objection based on the supporting evidence or conflicting advice/policy. | ||
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes | recipient-concerns-outcomes | Recipient has concerns regarding potential health outcomes | Concerns about the action's risk/benefit ratio, potential negative outcomes, or contraindications. | ||
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes | does-not-align-preferences | Recommendation does not align with patient preferences or values | The action conflicts with the patient's personal, cultural, or religious beliefs, or they prefer an alternative. | ||
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes | not-convenient-feasible | Recommendation is not convenient or feasible | Practical barriers related to cost, logistics, technology, or patient capability prevent the action. | ||
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes | action-completed | Recommended action was already completed | The action or procedure recommended by the CDS has already been performed. | ||
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes | patient-contraindication | Patient has contraindication to recommended action | A patient factor (e.g., allergy, existing condition, previous reaction) explicitly rules out the recommended action. | ||
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes | patient-refuses | Patient refuses/declines (no context given)* | The patient has simply refused the recommendation without providing an explicit, detailed reason. | ||
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes | too-costly-uncovered | Recommended action is too costly or not covered by insurance | Financial burden is a barrier, either due to the cost of the service or lack of insurance coverage. | ||
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes | service-not-available | Treatment or service is not practically available | The required service, medication, or equipment is not accessible, either geographically or logistically. | ||
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes | recipient-does-not-understand | Recipient does not understand the recommended action or know how to perform the recommended action | The recipient (patient or clinician) lacks the necessary health literacy or procedural knowledge to execute the action. |