US Meds Implementation Guide STU2 Ballot (version 1.1.0)

This page is part of the US-Medication FHIR IG (v1.1.0: STU 2 Ballot 1) based on FHIR R3. The current version which supercedes this version is 1.2.0. For a full list of available versions, see the Directory of published versions

Example: CapabilityStatement-client

Formats: Narrative, XML, JSON, Turtle

Raw xml


<CapabilityStatement xmlns="http://hl7.org/fhir">
  <id value="client"/>
  <text>
    <status value="additional"/>
    <div xmlns="http://www.w3.org/1999/xhtml">
			
			<ul id="markdown-toc">
				<li>
					<a href="#conformance-requirements-for-the-us-meds-client" id="markdown-toc-conformance-requirements-for-the-us-meds-client">Conformance requirements for the US Meds Client</a>
					<ul>
						<li>
							<a href="#behavior-1" id="markdown-toc-behavior-1">Behavior</a>
						</li>
						<li>
							<a href="#security-1" id="markdown-toc-security-1">Security</a>
						</li>
						<li>
							<a href="#resource--details-1" id="markdown-toc-resource--details-1">Resource  Details:</a>
							<ul>
								<li>
									<a href="#medication-1" id="markdown-toc-medication-1">1. Medication</a>
								</li>
								<li>
									<a href="#medicationadministration-1" id="markdown-toc-medicationadministration-1">2. MedicationAdministration</a>
								</li>
								<li>
									<a href="#medicationdispense-1" id="markdown-toc-medicationdispense-1">3. MedicationDispense</a>
								</li>
								<li>
									<a href="#medicationrequest-1" id="markdown-toc-medicationrequest-1">4. MedicationRequest</a>
								</li>
								<li>
									<a href="#medicationstatement-1" id="markdown-toc-medicationstatement-1">5. MedicationStatement</a>
								</li>
							</ul>
						</li>
					</ul>
				</li>
			</ul>
			<p id="publish-box">Not open for May 2018 ballot</p>
			
			<h3 id="conformance-requirements-for-the-us-meds-client">Conformance requirements for the US Meds Client</h3>
			<ul>
				<li>FHIR Version: 3.0.0</li>
				<li>Supported formats: xml, json</li>
				<li>Published: 2017-03-08</li>
				<li>Published by: Health Level Seven International Pharmacy Work Group</li>
			</ul>
			<p>This section describes the expected capabilities of a client actor which is responsible for creating and initiating the queries for information about an individual patient.It is expected that this CapabilityStatement will be used with the <a href="http://hl7.org/fhir/us/core/STU1/capstmnts.html">US Core CapabilityStatement</a>. Together they describe the basic expectations for the capabilities of a conformant client application. The complete list of actual profiles and dependencies on other profiles outside the FHIR specification RESTful interactions which includes the search and read operations that <strong>MAY</strong> be supported by the client</p>
			<h4 id="behavior-1">Behavior</h4>
			<p>The US Meds Clent <strong>SHALL</strong> support fetching and querying of one or more US Meds profile(s), using the supported RESTful interactions and search parameters declared in the <a href="CapabilityStatement-server.html#conformance-requirements-for-the-us-meds-server">US Meds Server CapabilityStatement</a>
			</p>
			<p>The US Meds Clent <strong>SHOULD</strong> Declare a CapabilityStatement identifying the list of profiles, operations, search parameter supported.</p>
			<h4 id="security-1">Security</h4>
			<p>US Core Servers <strong>SHALL</strong> implement the security requirements documented in the <a href="http://hl7.org/fhir/us/core/STU1/security.html">US-Core IG</a>.</p>
			<p>
				<strong>Summary of US Meds search criteria</strong>
			</p>
			<p>Specific client search capabilities are described in detail below in each of the resource sections.  The MedicationAdministration, MedicationDispense, MedicationStatement and MedicationRequest resources can represent a medication using either a code or refer to the Medication resource.  When referencing a Medication resource, the resource may be contained or an external resource. The server application can choose any one way or more than one method, but <em>if</em> the an external reference to Medication is used, the server <strong>SHALL</strong> support the [<code class="highlighter-rouge">_include</code>]((http://hl7.org/fhir/STU3/http.html#include) parameter for searching this element. The client application <strong>SHALL</strong> support all above methods without causing the application to fail.</p>
			<h4 id="resource--details-1">Resource  Details:</h4>
			<h5 id="medication-1">1. Medication</h5>
			<p>Supported Profiles: <a href="http://hl7.org/fhir/us/core/STU1/StructureDefinition-us-core-medication.html">US Core Medication Profile</a>
			</p>
			<h5 id="medicationadministration-1">2. MedicationAdministration</h5>
			<p>Supported Profiles:  <a href="StructureDefinition-medicationadministration.html">US Meds MedicationAdministration Profile</a>
			</p>
			<p>Search Criteria:</p>
			<p>A client <strong>SHALL</strong> be capable of fetching a patient’s administered medications using:</p>
			<ul>
				<li>
					<code class="highlighter-rouge">GET /MedicationAdministration?patient=[id]</code>
				</li>
				<li>
					<code class="highlighter-rouge">GET /MedicationAdministration?patient=[id]&amp;_include=MedicationAdministration:medication</code>
				</li>
			</ul>
			<h5 id="medicationdispense-1">3. MedicationDispense</h5>
			<p>Supported Profiles:  <a href="StructureDefinition-medicationdispense.html">US Meds MedicationDispense Profile</a>
			</p>
			<p>Search Criteria:</p>
			<p>A client <strong>SHALL</strong> be capable of fetching a patient’s dispensed medications using:</p>
			<ul>
				<li>
					<code class="highlighter-rouge">GET /MedicationDispense?patient=[id]</code>
				</li>
				<li>
					<code class="highlighter-rouge">GET /MedicationDispense?patient=[id]&amp;_include=MedicationDispense:medication</code>
				</li>
			</ul>
			<h5 id="medicationrequest-1">4. MedicationRequest</h5>
			<p>Supported Profiles:  <a href="http://hl7.org/fhir/us/core/STU1/StructureDefinition-us-core-medicationrequest.html">US Core MedicationRequest Profile</a>
			</p>
			<p>Search Criteria:</p>
			<p>A client <strong>SHALL</strong> be capable of fetching all patient’s active medications orders using:</p>
			<ul>
				<li>
					<code class="highlighter-rouge">GET /MedicationRequest?patient=[id]&amp;status=active</code>
				</li>
				<li>
					<code class="highlighter-rouge">GET /MedicationRequest?patient=[id]&amp;status=active&amp;_include=MedicationRequest:medication</code>
				</li>
			</ul>
			<h5 id="medicationstatement-1">5. MedicationStatement</h5>
			<p>Supported Profiles:  <a href="http://hl7.org/fhir/us/core/STU1/StructureDefinition-us-core-medicationstatement.html">US Core MedicationStatement Profile</a>
			</p>
			<p>Search Criteria:</p>
			<p>A client <strong>SHALL</strong> be capable of fetching all medications for a patient using:</p>
			<ul>
				<li>
					<code class="highlighter-rouge">GET /MedicationStatement?patient=[id]</code>
				</li>
				<li>
					<code class="highlighter-rouge">GET /MedicationStatement?patient=[id]&amp;_include=MedicationStatement:medication</code>
				</li>
			</ul>
			<p>A client <strong>SHALL</strong> be capable of fetching all active medications for a patient using:</p>
			<ul>
				<li>
					<code class="highlighter-rouge">GET /MedicationStatement?patient=[id]&amp;status=active</code>
				</li>
				<li>
					<code class="highlighter-rouge">GET /MedicationStatement?patient=[id]&amp;status=active&amp;_include=MedicationStatement:medication</code>
				</li>
			</ul>
			<p>A client <strong>SHALL</strong> be capable of fetching all medications for a patient for an encounter using:</p>
			<ul>
				<li>
					<code class="highlighter-rouge">GET /MedicationStatement?patient=[id]&amp;context=[id]</code>
				</li>
				<li>
					<code class="highlighter-rouge">GET /MedicationStatement?patient=[id]&amp;context=[id]&amp;_include=MedicationStatement:medication</code>
				</li>
			</ul>
			<p>
				<br/>
			</p>
		</div>
  </text>
  <url value="http://hl7.org/fhir/us/meds/CapabilityStatement/client"/>
  <version value="1.1.0"/>
  <name value="US Meds Client"/>
  <status value="draft"/>
  <date value="2017-03-08T00:00:00+11:00"/>
  <publisher value="Health Level Seven International Pharmacy Work Group"/>
  <contact>
    <telecom>
      <system value="other"/>
      <value value="http://www.hl7.org/Special/committees/medication/index.cfm"/>
    </telecom>
  </contact>
  <description
               value="This resource defines the expected capabilities of the US Meds Client actor when conforming to the US Meds IG and It is expected that it will be used in conjuction with the US Core CapabilityStatement. Together they describe the complete list of actual profiles, RESTful operations, and search parameters supported by US Meds Clients."/>
  <kind value="requirements"/>
  <fhirVersion value="3.0.0"/>
  <format value="xml"/>
  <format value="json"/>
  <rest>
    <mode value="client"/>
    <resource>
      <type value="Medication"/>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="search-type"/>
        <documentation
                       value="IF the Medication Resource is used in a MedicationStatement or a MedicationRequest.   Allows discovery of existing US Core Medication resources using different search criteria."/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="read"/>
        <documentation
                       value="IF the Medication Resource is used in a MedicationStatement or a MedicationRequest.  Allows retrieval of a specific US Core Medication by id"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="history-instance"/>
        <documentation
                       value="Allows review of changes to US Core Medication instance over time"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="vread"/>
        <documentation
                       value="Allows retrieval of a historical version of a US Core Medication instance"/>
      </interaction>
    </resource>
    <resource>
      <type value="MedicationAdministration"/>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="search-type"/>
        <documentation
                       value="Allows discovery of existing US Meds MedicationAdministration resources using different search criteria"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="read"/>
        <documentation
                       value="Allows retrieval of a specific US Meds MedicationAdministration by id"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="history-instance"/>
        <documentation
                       value="Allows review of changes to US Meds MedicationAdministration instance over time"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="vread"/>
        <documentation
                       value="Allows retrieval of a historical version of a US Meds MedicationAdministration instance"/>
      </interaction>
      <searchInclude value="MedicationAdministration:medication"/>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <name value="patient"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/MedicationAdministration-Patient"/>
        <type value="reference"/>
      </searchParam>
    </resource>
    <resource>
      <type value="MedicationDispense"/>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="search-type"/>
        <documentation
                       value="Allows discovery of existing US Meds MedicationDispense resources using different search criteria"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="read"/>
        <documentation
                       value="Allows retrieval of a specific US Meds MedicationDispense by id"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="history-instance"/>
        <documentation
                       value="Allows review of changes to US Meds MedicationDispense instance over time"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="vread"/>
        <documentation
                       value="Allows retrieval of a historical version of a US Meds MedicationDispense instance"/>
      </interaction>
      <searchInclude value="MedicationDispense:medication"/>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <name value="patient"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/MedicationDispense-Patient"/>
        <type value="reference"/>
      </searchParam>
    </resource>
    <resource>
      <extension
                 url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-search-parameter-combination">
        <extension url="required">
          <valueString value="patient"/>
        </extension>
        <extension url="required">
          <valueString value="status"/>
        </extension>
      </extension>
      <type value="MedicationRequest"/>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="search-type"/>
        <documentation
                       value="Allows discovery of existing US Core MedicationRequest resources using different search criteria"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="read"/>
        <documentation
                       value="Allows retrieval of a specific US Core MedicationRequest by id"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="history-instance"/>
        <documentation
                       value="Allows review of changes to US Core MedicationRequest instance over time"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="vread"/>
        <documentation
                       value="Allows retrieval of a historical version of a US Core MedicationRequest instance"/>
      </interaction>
      <searchInclude value="MedicationRequest:medication"/>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <name value="patient"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/MedicationRequest-Patient"/>
        <type value="reference"/>
      </searchParam>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <name value="status"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/MedicationRequest-Status"/>
        <type value="token"/>
      </searchParam>
    </resource>
    <resource>
      <extension
                 url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-search-parameter-combination">
        <extension url="required">
          <valueString value="patient"/>
        </extension>
        <extension url="required">
          <valueString value="status"/>
        </extension>
      </extension>
      <extension
                 url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-search-parameter-combination">
        <extension url="required">
          <valueString value="patient"/>
        </extension>
        <extension url="required">
          <valueString value="context"/>
        </extension>
      </extension>
      <type value="MedicationStatement"/>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="search-type"/>
        <documentation
                       value="Allows discovery of existing US Core MedicationStatement resources using different search criteria"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="read"/>
        <documentation
                       value="Allows retrieval of a specific US Core MedicationStatement by id"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="history-instance"/>
        <documentation
                       value="Allows review of changes to US Core MedicationStatement instance over time"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <code value="vread"/>
        <documentation
                       value="Allows retrieval of a historical version of a US Core MedicationStatement instance"/>
      </interaction>
      <searchInclude value="MedicationStatement:medication"/>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <name value="patient"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/MedicationStatement-Patient"/>
        <type value="reference"/>
      </searchParam>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHOULD"/>
        </extension>
        <name value="status"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/MedicationStatement-Status"/>
        <type value="token"/>
      </searchParam>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="MAY"/>
        </extension>
        <name value="category"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/MedicationStatement-Category"/>
        <type value="reference"/>
      </searchParam>
    </resource>
  </rest>
</CapabilityStatement>