CDS Hooks Library, published by Clinical Decision Support WG. This guide is not an authorized publication; it is the continuous build for version 2.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-library/ and changes regularly. See the Directory of published versions
| Official URL: http://cds-hooks.hl7.org/hooks/ImplementationGuide/hl7.fhir.uv.cds-hooks-library | Version: 2.0.0-ballot | ||||
| IG Standards status: Normative | Maturity Level: 6 | Computable Name: CDSHooksLibrary | |||
| Other Identifiers: OID:2.16.840.1.113883.4.642.40.94 | |||||
This is the 2.0.0 ballot of the CDS Hooks Library (Release 2), balloted as a mixed Normative/Trial-Use specification. The patient-view and order-sign hooks are balloted as Normative, and the other active hooks remain Standard for Trial Use. This ballot also applies implementer feedback received since the STU 1 publication.
Summary of changes
patient-view and order-sign advance to maturity level 6 (Normative) and are balloted as normative contentmedication-verify hook (maturity level 1, Submitted) for pharmacist verification of signed medication ordersorder-sign (version 1.1.0) allows orders being re-signed after revision, and order-select adds guidance on limiting interruption of the ordering workflowFor the complete list of changes, with tracker references and links to where each change was applied, see the Changes page. New and modified content is highlighted throughout the specification; use the Highlight text changes? checkbox at the top of each page to turn the highlighting on or off.
Questions for balloters
patient-view and order-sign stable and sufficiently implemented to be published as Normative?appointment-book and encounter-start pages, including whether episodeOfCareId would be useful context for encounter-start.The CDS Hooks Library contains specifications of industry standardized clinical workflow steps upon which remote clinical decision support can be requested. The Library is an HL7 publication with mixed standards status: the patient-view and order-sign hooks are Normative, and the remaining hooks are each published at the status shown on their page (Standard for Trial Use, Draft, or Deprecated). The names of the below hooks hyperlink to their individual specification and the number following their name indicates their specific maturity, according to the CDS Hooks Maturity Model. Because hook maturity is based on the extent of implementation, client and CDS Service implementations of each hook are tracked on the CDS Hooks Availability page, and implementers are encouraged to add their own implementations there. All hooks are intended to be used by systems conforming to the HL7 CDS Hooks Implementation Guide.
New hooks are proposed in a prescribed format using the documentation template by submitting a pull request for community feedback. Hooks are versioned, and mature according to the Hook Maturity Model. Anyone may propose a new CDS Hooks hook. New hooks will continue to be specified and matured in the Library while changes to the base CDS Hooks Implementation Guide become infrequent and tightly constrained.
See https://cds-hooks.org/ for additional information, resources and ways to get involved.
Looking for Feedback: Several hooks are used together across a larger clinical workflow. We are seeking implementer feedback on these overall workflows, including the workflow diagrams on the linked hook pages:Have you encountered any useful documentation, references or diagrams that help illustrate these workflows? Please share!
- Encounter start to finish: appointment-book, encounter-start, encounter-discharge
- Medication refill: order-sign, medication-refill
- Ordering: order-select, order-sign, order-dispatch
- The Da Vinci Coverage Requirements Discovery (CRD), Documentation Templates and Rules (DTR) and Prior Authorization Support (PAS) flow
Implementers who need to refer to CDS Hook Definitions using HL7's binding machinery (e.g. in CapabilityStatements) may make use of the codes defined in the Hook Codes CodeSystem.
CDS Hooks is the copyright of HL7 International and Boston Children's Hospital. The CDS Hooks specification is licensed under a Creative Commons Attribution 4.0 International License. All source code for CDS Hooks is available at https://github.com/cds-hooks.