CDS Hooks
3.0.0-ballot - R3 Normative Ballot International flag

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 Clinical Selection

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)

Logical Definition (CLD)

  • Include these codes as defined in http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes version 📦3.0.0-ballot
    CodeDisplayDefinition
    cds-not-applicablePC CDS does not apply to patientThe CDS recommendation is irrelevant, completed, or the patient does not meet the criteria.
    cds-suboptimal-contextPC CDS delivered in suboptimal contextThe CDS was delivered at a time or to a recipient that made the action impossible or impractical to address.
    recipient-disagrees-evidenceRecipient disagrees with recommendation because of issues with the evidenceThe recipient (clinician or patient) has an objection based on the supporting evidence or conflicting advice/policy.
    recipient-concerns-outcomesRecipient has concerns regarding potential health outcomesConcerns about the action's risk/benefit ratio, potential negative outcomes, or contraindications.
    does-not-align-preferencesRecommendation does not align with patient preferences or valuesThe action conflicts with the patient's personal, cultural, or religious beliefs, or they prefer an alternative.
    not-convenient-feasibleRecommendation is not convenient or feasiblePractical barriers related to cost, logistics, technology, or patient capability prevent the action.
    action-completedRecommended action was already completedThe action or procedure recommended by the CDS has already been performed.
    patient-contraindicationPatient has contraindication to recommended actionA patient factor (e.g., allergy, existing condition, previous reaction) explicitly rules out the recommended action.
    patient-refusesPatient refuses/declines (no context given)*The patient has simply refused the recommendation without providing an explicit, detailed reason.
    too-costly-uncoveredRecommended action is too costly or not covered by insuranceFinancial burden is a barrier, either due to the cost of the service or lack of insurance coverage.
    service-not-availableTreatment or service is not practically availableThe required service, medication, or equipment is not accessible, either geographically or logistically.
    recipient-does-not-understandRecipient does not understand the recommended action or know how to perform the recommended actionThe recipient (patient or clinician) lacks the necessary health literacy or procedural knowledge to execute the action.

 

Expansion

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

This value set contains 12 concepts

SystemCodeDisplay (en)DefinitionJSONXML
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes  cds-not-applicablePC CDS does not apply to patientThe CDS recommendation is irrelevant, completed, or the patient does not meet the criteria.
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes  cds-suboptimal-contextPC CDS delivered in suboptimal contextThe 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-evidenceRecipient disagrees with recommendation because of issues with the evidenceThe 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-outcomesRecipient has concerns regarding potential health outcomesConcerns about the action's risk/benefit ratio, potential negative outcomes, or contraindications.
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes  does-not-align-preferencesRecommendation does not align with patient preferences or valuesThe 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-feasibleRecommendation is not convenient or feasiblePractical barriers related to cost, logistics, technology, or patient capability prevent the action.
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes  action-completedRecommended action was already completedThe action or procedure recommended by the CDS has already been performed.
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes  patient-contraindicationPatient has contraindication to recommended actionA 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-refusesPatient 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-uncoveredRecommended action is too costly or not covered by insuranceFinancial 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-availableTreatment or service is not practically availableThe required service, medication, or equipment is not accessible, either geographically or logistically.
http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes  recipient-does-not-understandRecipient does not understand the recommended action or know how to perform the recommended actionThe recipient (patient or clinician) lacks the necessary health literacy or procedural knowledge to execute the action.

Description of the above table(s).