<?xml version="1.0" encoding="UTF-8"?>

<CodeSystem xmlns="http://hl7.org/fhir">
  <id value="HookCodes"/>
  <language value="en"/>
  <text>
    <status value="generated"/><div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: CodeSystem HookCodes</b></p><a name="HookCodes"> </a><a name="hcHookCodes"> </a><p><b>Properties</b></p><p><b>This code system defines the following properties for its concepts</b></p><table class="grid"><tr><td><b>Name</b></td><td><b>Code</b></td><td><b>URI</b></td><td><b>Type</b></td><td><b>Description</b></td></tr><tr><td>status</td><td>status</td><td>http://hl7.org/fhir/concept-properties#status</td><td>code</td><td/></tr><tr><td>maturity-level</td><td>maturity-level</td><td/><td>integer</td><td>Hook maturity level per the CDS Hooks Maturity Model</td></tr></table><p><b>Concepts</b></p><p>This case-sensitive code system <code>http://cds-hooks.hl7.org/hooks/CodeSystem/HookCodes</code> defines the following codes:</p><table class="codes"><tr><td style="white-space:nowrap"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td><td><b>status</b></td><td><b>maturity-level</b></td></tr><tr><td style="white-space:nowrap">allergyintolerance-create<a name="HookCodes-allergyintolerance-create"> </a></td><td>AllergyIntolerance create</td><td>Invoked when when a clinician adds a new allergy or intolerance to a patient's list of allergies</td><td/><td>1</td></tr><tr><td style="white-space:nowrap">appointment-book<a name="HookCodes-appointment-book"> </a></td><td>Appointment book</td><td>Invoked when the user is scheduling one or more future encounters/visits for the patient</td><td/><td>1</td></tr><tr><td style="white-space:nowrap">encounter-discharge<a name="HookCodes-encounter-discharge"> </a></td><td>Encounter discharge</td><td>Invoked when the user is performing the discharge process for an encounter where the notion of 'discharge' is relevant - typically an inpatient encounter</td><td/><td>1</td></tr><tr><td style="white-space:nowrap">encounter-start<a name="HookCodes-encounter-start"> </a></td><td>Encounter start</td><td>Invoked when the user is initiating a new encounter</td><td/><td>1</td></tr><tr style="background-color: #ffeeee"><td style="white-space:nowrap">medication-prescribe<a name="HookCodes-medication-prescribe"> </a></td><td>Medication prescribe</td><td>Deprecated in favor of the order-select and order-sign hooks</td><td>deprecated</td><td>2</td></tr><tr><td style="white-space:nowrap">medication-refill<a name="HookCodes-medication-refill"> </a></td><td>Medication refill</td><td>Invoked when a medication refill request for an existing prescription of a specific medication is received</td><td/><td>1</td></tr><tr><td style="white-space:nowrap">medication-verify<a name="HookCodes-medication-verify"> </a></td><td>Medication verify</td><td>Invoked when a pharmacist is ready to verify a medication order for a patient</td><td/><td>1</td></tr><tr><td style="white-space:nowrap">order-dispatch<a name="HookCodes-order-dispatch"> </a></td><td>Order dispatch</td><td>Invoked when a practitioner is selecting a candidate performer for a pre-existing order or (set of orders) that was not assigned to a specific performer</td><td/><td>0</td></tr><tr style="background-color: #ffeeee"><td style="white-space:nowrap">order-review<a name="HookCodes-order-review"> </a></td><td>Order review</td><td>Deprecated in favor of the order-sign hook</td><td>deprecated</td><td>3</td></tr><tr><td style="white-space:nowrap">order-select<a name="HookCodes-order-select"> </a></td><td>Order select</td><td>Invoked when a clinician initially selects one or more new orders from a list of potential orders for a specific patient</td><td/><td>4</td></tr><tr><td style="white-space:nowrap">order-sign<a name="HookCodes-order-sign"> </a></td><td>Order sign</td><td>Invoked when a clinician is ready to sign one or more orders for a patient</td><td/><td>6</td></tr><tr><td style="white-space:nowrap">patient-view<a name="HookCodes-patient-view"> </a></td><td>Patient view</td><td>Invoked when the user has just opened a patient's record</td><td/><td>6</td></tr><tr><td style="white-space:nowrap">problem-list-item-create<a name="HookCodes-problem-list-item-create"> </a></td><td>Problem list item create</td><td>Invoked when a clinician has added one or more new problems to a patient's problem list</td><td/><td>1</td></tr></table></div>
  </text>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
    <valueCode value="cds"/>
  </extension>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
    <valueInteger value="6">
      <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom">
        <valueCanonical value="http://cds-hooks.hl7.org/hooks/ImplementationGuide/hl7.fhir.uv.cds-hooks-library"/>
      </extension>
    </valueInteger>
  </extension>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
    <valueCode value="normative">
      <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom">
        <valueCanonical value="http://cds-hooks.hl7.org/hooks/ImplementationGuide/hl7.fhir.uv.cds-hooks-library"/>
      </extension>
    </valueCode>
  </extension>
  <url value="http://cds-hooks.hl7.org/hooks/CodeSystem/HookCodes"/>
  <identifier>
    <system value="urn:ietf:rfc:3986"/>
    <value value="urn:oid:2.16.840.1.113883.4.642.40.94.16.1"/>
  </identifier>
  <version value="2.0.0-ballot"/>
  <name value="HookCodes"/>
  <title value="CDS Hook Codes"/>
  <status value="active"/>
  <experimental value="false"/>
  <date value="2026-11-19T14:23:07+00:00"/>
  <publisher value="Clinical Decision Support WG"/>
  <contact>
    <name value="Clinical Decision Support WG"/>
    <telecom>
      <system value="url"/>
      <value value="http://www.hl7.org/Special/committees/dss/index.cfm"/>
    </telecom>
    <telecom>
      <system value="email"/>
      <value value="cds@lists.HL7.org"/>
    </telecom>
  </contact>
  <description value="A code system defining codes for all 'standard' hooks"/>
  <jurisdiction>
    <coding>
      <system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>
      <code value="001"/>
    </coding>
  </jurisdiction>
  <caseSensitive value="true"/>
  <content value="complete"/>
  <count value="13"/>
  <property>
    <code value="status"/>
    <uri value="http://hl7.org/fhir/concept-properties#status"/>
    <type value="code"/>
  </property>
  <property>
    <code value="maturity-level"/>
    <description value="Hook maturity level per the CDS Hooks Maturity Model"/>
    <type value="integer"/>
  </property>
  <concept>
    <code value="allergyintolerance-create"/>
    <display value="AllergyIntolerance create"/>
    <definition value="Invoked when when a clinician adds a new allergy or intolerance to a patient's list of allergies"/>
    <property>
      <code value="maturity-level"/>
      <valueInteger value="1"/>
    </property>
  </concept>
  <concept>
    <code value="appointment-book"/>
    <display value="Appointment book"/>
    <definition value="Invoked when the user is scheduling one or more future encounters/visits for the patient"/>
    <property>
      <code value="maturity-level"/>
      <valueInteger value="1"/>
    </property>
  </concept>
  <concept>
    <code value="encounter-discharge"/>
    <display value="Encounter discharge"/>
    <definition value="Invoked when the user is performing the discharge process for an encounter where the notion of 'discharge' is relevant - typically an inpatient encounter"/>
    <property>
      <code value="maturity-level"/>
      <valueInteger value="1"/>
    </property>
  </concept>
  <concept>
    <code value="encounter-start"/>
    <display value="Encounter start"/>
    <definition value="Invoked when the user is initiating a new encounter"/>
    <property>
      <code value="maturity-level"/>
      <valueInteger value="1"/>
    </property>
  </concept>
  <concept>
    <code value="medication-prescribe"/>
    <display value="Medication prescribe"/>
    <definition value="Deprecated in favor of the order-select and order-sign hooks"/>
    <property>
      <code value="status"/>
      <valueCode value="deprecated"/>
    </property>
    <property>
      <code value="maturity-level"/>
      <valueInteger value="2"/>
    </property>
  </concept>
  <concept>
    <code value="medication-refill"/>
    <display value="Medication refill"/>
    <definition value="Invoked when a medication refill request for an existing prescription of a specific medication is received"/>
    <property>
      <code value="maturity-level"/>
      <valueInteger value="1"/>
    </property>
  </concept>
  <concept>
    <code value="medication-verify"/>
    <display value="Medication verify"/>
    <definition value="Invoked when a pharmacist is ready to verify a medication order for a patient"/>
    <property>
      <code value="maturity-level"/>
      <valueInteger value="1"/>
    </property>
  </concept>
  <concept>
    <code value="order-dispatch"/>
    <display value="Order dispatch"/>
    <definition value="Invoked when a practitioner is selecting a candidate performer for a pre-existing order or (set of orders) that was not assigned to a specific performer"/>
    <property>
      <code value="maturity-level"/>
      <valueInteger value="0"/>
    </property>
  </concept>
  <concept>
    <code value="order-review"/>
    <display value="Order review"/>
    <definition value="Deprecated in favor of the order-sign hook"/>
    <property>
      <code value="status"/>
      <valueCode value="deprecated"/>
    </property>
    <property>
      <code value="maturity-level"/>
      <valueInteger value="3"/>
    </property>
  </concept>
  <concept>
    <code value="order-select"/>
    <display value="Order select"/>
    <definition value="Invoked when a clinician initially selects one or more new orders from a list of potential orders for a specific patient"/>
    <property>
      <code value="maturity-level"/>
      <valueInteger value="4"/>
    </property>
  </concept>
  <concept>
    <code value="order-sign"/>
    <display value="Order sign"/>
    <definition value="Invoked when a clinician is ready to sign one or more orders for a patient"/>
    <property>
      <code value="maturity-level"/>
      <valueInteger value="6"/>
    </property>
  </concept>
  <concept>
    <code value="patient-view"/>
    <display value="Patient view"/>
    <definition value="Invoked when the user has just opened a patient's record"/>
    <property>
      <code value="maturity-level"/>
      <valueInteger value="6"/>
    </property>
  </concept>
  <concept>
    <code value="problem-list-item-create"/>
    <display value="Problem list item create"/>
    <definition value="Invoked when a clinician has added one or more new problems to a patient's problem list"/>
    <property>
      <code value="maturity-level"/>
      <valueInteger value="1"/>
    </property>
  </concept>
</CodeSystem>