CDS Hooks
3.0.0 - R3 Normative/Trial-Use
CDS Hooks, published by HL7 International / Clinical Decision Support. 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/cds-hooks/ and changes regularly. See the Directory of published versions
| Page standards status: Trial-use | Maturity Level: 1 |
{
"resourceType" : "ValueSet",
"id" : "non-adherence-reason-category",
"language" : "en",
"text" : {
"status" : "extensions",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: ValueSet non-adherence-reason-category</b></p><a name=\"non-adherence-reason-category\"> </a><a name=\"hcnon-adherence-reason-category\"> </a><ul><li>Include these codes as defined in <a href=\"CodeSystem-non-adherence-reason-codes.html\"><code>http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes</code></a><span title=\"Version is not explicitly stated, which means it is fixed to the version provided in this specification\"> version 📦3.0.0</span><table class=\"none\"><tr><td style=\"white-space:nowrap\"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td></tr><tr><td><a href=\"CodeSystem-non-adherence-reason-codes.html#non-adherence-reason-codes-cds-not-applicable\">cds-not-applicable</a></td><td style=\"color: #cccccc\">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><a href=\"CodeSystem-non-adherence-reason-codes.html#non-adherence-reason-codes-cds-suboptimal-context\">cds-suboptimal-context</a></td><td style=\"color: #cccccc\">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><a href=\"CodeSystem-non-adherence-reason-codes.html#non-adherence-reason-codes-recipient-disagrees-evidence\">recipient-disagrees-evidence</a></td><td style=\"color: #cccccc\">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><a href=\"CodeSystem-non-adherence-reason-codes.html#non-adherence-reason-codes-recipient-concerns-outcomes\">recipient-concerns-outcomes</a></td><td style=\"color: #cccccc\">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><a href=\"CodeSystem-non-adherence-reason-codes.html#non-adherence-reason-codes-does-not-align-preferences\">does-not-align-preferences</a></td><td style=\"color: #cccccc\">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><a href=\"CodeSystem-non-adherence-reason-codes.html#non-adherence-reason-codes-not-convenient-feasible\">not-convenient-feasible</a></td><td style=\"color: #cccccc\">Recommendation is not convenient or feasible</td><td>Practical barriers related to cost, logistics, technology, or patient capability prevent the action.</td></tr></table></li></ul></div>"
},
"extension" : [
{
"url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
"valueCode" : "cds"
},
{
"url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
"valueCode" : "trial-use"
},
{
"url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
"valueInteger" : 1
}
],
"url" : "http://terminology.hl7.org/ValueSet/non-adherence-reason-category",
"identifier" : [
{
"system" : "urn:ietf:rfc:3986",
"value" : "urn:oid:2.16.840.1.113883.4.642.40.93.48.1"
}
],
"version" : "3.0.0",
"name" : "NonAdherenceReasonCategory",
"title" : "Non-Adherence Reason Categories ValueSet",
"status" : "active",
"experimental" : false,
"date" : "2026-10-19T12:39:41+00:00",
"publisher" : "HL7 International / Clinical Decision Support",
"contact" : [
{
"name" : "HL7 International / Clinical Decision Support",
"telecom" : [
{
"system" : "url",
"value" : "http://www.hl7.org/Special/committees/dss/index.cfm"
},
{
"system" : "email",
"value" : "cds@lists.HL7.org"
}
]
}
],
"description" : "A set of codes capturing the six high-level categories for why a PC CDS recommendation may not be followed.",
"jurisdiction" : [
{
"coding" : [
{
"system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
"code" : "001",
"display" : "World"
}
]
}
],
"compose" : {
"include" : [
{
"system" : "http://terminology.hl7.org/CodeSystem/non-adherence-reason-codes",
"concept" : [
{
"code" : "cds-not-applicable"
},
{
"code" : "cds-suboptimal-context"
},
{
"code" : "recipient-disagrees-evidence"
},
{
"code" : "recipient-concerns-outcomes"
},
{
"code" : "does-not-align-preferences"
},
{
"code" : "not-convenient-feasible"
}
]
}
]
}
}