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

## ValueSet: Non-Adherence Reason Categories ValueSet

Official URL: http://terminology.hl7.org/ValueSet/non-adherence-reason-category | Version: 3.0.0-ballot
Standards status: Trial-use Active as of 2025-12-14 | Maturity Level: 1 | Computable Name: NonAdherenceReasonCategory

A set of codes capturing the six high-level categories for why a PC CDS recommendation may not be followed.

References

This value set is not used here; it may be used elsewhere (e.g. specifications and/or implementations that use this content)

### Logical Definition (CLD)

- Include these codes as defined in `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.

### Expansion

Expansion performed internally based on codesystem Non-Adherence Reason Codes v3.0.0-ballot (CodeSystem)

This value set contains 6 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. |  |

Description of the above table(s).