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

Artifacts Summary

Contents:

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Structures: Logical Models

These define data models that represent the domain covered by this implementation guide in more business-friendly terms than the underlying FHIR resources.

CDS Hook Specific Context (Logical Definition)

This structure is defined to allow the FHIR Validator to validate a CDSHooks Request Context.
CDSHooks Discovery Response (Logical Definition)

This structure is defined to allow the FHIR Validator to validate a CDSHooks Discovery response body.
CDSHooks Feedback (Logical Definition)

This structure is defined to allow the FHIR Validator to validate a CDSHooks Feedback request body.
CDSHooks Request (Logical Definition)

This structure is defined to allow the FHIR Validator to validate a CDSHooks Request Body.
CDSHooks Response (Logical Definition)

This structure is defined to allow the FHIR Validator to validate a CDSHooks Response body.
CDSHooks Services Base Extensible Element

This structure is defined to allow the FHIR Validator to validate a CDSHooks Services Element with Extensions.
CDSHooks Services Extensions

This is a concrete subtype of Base that has extensions (though the format in JSON is different)

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

Non-Adherence Reason

A set of codes capturing all reasons why a Patient Care Clinical Decision Support (PC CDS) recommendation may not be followed, drawn from the CDS-NonAdherence-Reason CodeSystem.
Non-Adherence Reason Categories ValueSet

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

A set of common and clinically relevant reasons for non-adherence, including all categories and key specific sub-codes for point-of-care selection.

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

Non-Adherence Reason Codes

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.

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.