Standardized Medication Profile (SMP) FHIR IG
1.0.0 - STU 1
Standardized Medication Profile (SMP) FHIR IG
1.0.0 - STU 1
Standardized Medication Profile (SMP) FHIR IG, published by HL7 International / Pharmacy. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/smp-ig/ and changes regularly. See the Directory of published versions
| Page standards status: Trial-use | Maturity Level: 1 |
<CapabilityStatement xmlns="http://hl7.org/fhir">
<id value="smp-server"/>
<text>
<status value="extensions"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: CapabilityStatement smp-server</b></p><a name="smp-server"> </a><a name="hcsmp-server"> </a><h2 id="title"/><ul><li>Implementation Guide Version: 1.0.0 </li><li>FHIR Version: 4.0.1 </li><li>Supported Formats: <strong>SHALL</strong> support <code>json</code>, <strong>SHOULD</strong> support <code>xml</code></li><li>Published on: 2024-04-29 00:00:00-0600 </li><li>Published by: HL7 International / Pharmacy </li></ul><blockquote class="impl-note"><p><strong>Note to Implementers: FHIR Capabilities</strong></p><p>Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.</p></blockquote><h2 id="rest">FHIR RESTful Capabilities</h2><div class="panel panel-default"><div class="panel-heading"><h3 id="mode1" class="panel-title">Mode: <code>server</code></h3></div><div class="panel-body"/></div><h3 id="resourcesCap1">Capabilities by Resource/Profile</h3><h4 id="resourcesSummary1">Summary</h4><p>The summary table lists the resources that are part of this configuration, and for each resource it lists:</p><ul><li>The relevant profiles (if any)</li><li>The interactions supported by each resource (<b><span class="bg-info">R</span></b>ead, <b><span class="bg-info">S</span></b>earch, <b><span class="bg-info">U</span></b>pdate, and <b><span class="bg-info">C</span></b>reate, are always shown, while <b><span class="bg-info">VR</span></b>ead, <b><span class="bg-info">P</span></b>atch, <b><span class="bg-info">D</span></b>elete, <b><span class="bg-info">H</span></b>istory on <b><span class="bg-info">I</span></b>nstance, or <b><span class="bg-info">H</span></b>istory on <b><span class="bg-info">T</span></b>ype are only present if at least one of the resources has support for them.</li><li><span>The required, recommended, and some optional search parameters (if any). </span></li><li>The linked resources enabled for <code>_include</code></li><li>The other resources enabled for <code>_revinclude</code></li><li>The operations on the resource (if any)</li></ul><div class="table-responsive"><table class="table table-condensed table-hover"><thead><tr><th><b>Resource Type</b></th><th><b>Profile</b></th><th class="text-center"><b title="GET a resource (read interaction)">R</b></th><th class="text-center"><b title="GET all set of resources of the type (search interaction)">S</b></th><th class="text-center"><b title="PUT a new resource version (update interaction)">U</b></th><th class="text-center"><b title="POST a new resource (create interaction)">C</b></th><th><b title="Required and recommended search parameters">Searches</b></th><th><code><b>_include</b></code></th><th><code><b>_revinclude</b></code></th><th><b>Operations</b></th></tr></thead><tbody><tr><td><a href="#List1-1">List</a></td><td>Supported Profiles<br/> <a href="StructureDefinition-smp-medication-list.html">Standardized Medication Profile - Medication List</a></td><td class="text-center"><span title="SHALL"><b>Y</b></span></td><td class="text-center"/><td class="text-center"><span title="SHOULD">Y</span></td><td class="text-center"><span title="SHOULD">Y</span></td><td>patient, code</td><td/><td/><td><code>$smp-query</code>, <code>$smp-submit</code></td></tr><tr><td><a href="#MedicationStatement1-2">MedicationStatement</a></td><td>Supported Profiles<br/> <a href="StructureDefinition-smp-medicationstatement.html">Standardized Medication Profile - MedicationStatement</a></td><td class="text-center"><span title="SHALL"><b>Y</b></span></td><td class="text-center"/><td class="text-center"><span title="SHOULD">Y</span></td><td class="text-center"><span title="SHOULD">Y</span></td><td>patient, status</td><td/><td/><td/></tr><tr><td><a href="#Medication1-3">Medication</a></td><td>Supported Profiles<br/> <a href="StructureDefinition-smp-medication.html">Standardized Medication Profile - Medication</a></td><td class="text-center"><span title="SHOULD">Y</span></td><td class="text-center"/><td class="text-center"/><td class="text-center"><span title="MAY">y?</span></td><td/><td/><td/><td/></tr><tr><td><a href="#MedicationRequest1-4">MedicationRequest</a></td><td>Supported Profiles<br/> <a href="http://hl7.org/fhir/us/core/STU8/StructureDefinition-us-core-medicationrequest.html">US Core MedicationRequest Profile</a></td><td class="text-center"><span title="SHOULD">Y</span></td><td class="text-center"/><td class="text-center"><span title="MAY">y?</span></td><td class="text-center"><span title="MAY">y?</span></td><td>patient, intent, status</td><td/><td/><td/></tr><tr><td><a href="#MedicationAdministration1-5">MedicationAdministration</a></td><td>Supported Profiles<br/> <a href="StructureDefinition-smp-medicationadministration.html">Standardized Medication Profile - MedicationAdministration</a></td><td class="text-center"><span title="SHOULD">Y</span></td><td class="text-center"/><td class="text-center"><span title="MAY">y?</span></td><td class="text-center"><span title="MAY">y?</span></td><td>patient, status</td><td/><td/><td/></tr><tr><td><a href="#CarePlan1-6">CarePlan</a></td><td>Supported Profiles<br/> <a href="StructureDefinition-smp-medication-action-plan.html">Standardized Medication Profile - Medication Action Plan</a></td><td class="text-center"><span title="SHOULD">Y</span></td><td class="text-center"/><td class="text-center"><span title="MAY">y?</span></td><td class="text-center"><span title="MAY">y?</span></td><td>patient</td><td/><td/><td/></tr><tr><td><a href="#DetectedIssue1-7">DetectedIssue</a></td><td>Supported Profiles<br/> <a href="StructureDefinition-smp-medication-action-plan-detected-issue.html">Standardized Medication Profile - Medication Action Plan Detected Issue</a></td><td class="text-center"><span title="SHOULD">Y</span></td><td class="text-center"/><td class="text-center"/><td class="text-center"/><td>patient</td><td/><td/><td/></tr><tr><td><a href="#Patient1-8">Patient</a></td><td>Supported Profiles<br/> <a href="http://hl7.org/fhir/us/core/STU8/StructureDefinition-us-core-patient.html">US Core Patient Profile</a></td><td class="text-center"><span title="SHALL"><b>Y</b></span></td><td class="text-center"/><td class="text-center"/><td class="text-center"/><td>_id</td><td/><td/><td/></tr><tr><td><a href="#Bundle1-9">Bundle</a></td><td>Supported Profiles<br/> <a href="StructureDefinition-smp-bundle.html">Standardized Medication Profile - Bundle Medication List</a><br/> <a href="StructureDefinition-smp-bundle-transaction.html">Standardized Medication Profile - Bundle Medication List Maintenance</a><br/> <a href="StructureDefinition-smp-medication-action-plan-bundle.html">Standardized Medication Profile - Bundle Medication Action Plan</a></td><td class="text-center"><span title="MAY">y?</span></td><td class="text-center"/><td class="text-center"/><td class="text-center"/><td/><td/><td/><td/></tr></tbody></table></div><hr/><div class="panel panel-default"><div class="panel-heading"><h4 id="List1-1" class="panel-title"><span style="float: right;">Resource Conformance: SHALL </span>List</h4></div><div class="panel-body"><div class="container"><div class="row"><div class="col-lg-4"><span class="lead">Core FHIR Resource</span><br/><a href="http://hl7.org/fhir/R4/list.html">List</a></div><div class="col-lg-4"><span class="lead">Reference Policy</span><br/></div><div class="col-lg-4"><span class="lead">Interaction summary</span><br/><ul><li><strong>SHALL</strong> support <br/><code>read</code><div><p>Allows retrieval of medication list for the various point in time information.</p>
</div></li><li><strong>SHOULD</strong> support <br/><code>update</code><div><p>Allows for the maintenance of the medication lists.</p>
</div><code>create</code><div><p>Allows for the creation of a medication list.</p>
</div></li></ul></div></div><p/><div class="row"><div class="col-6"><span class="lead">Supported Profiles</span><p><a href="StructureDefinition-smp-medication-list.html">Standardized Medication Profile - Medication List</a></p></div></div><p/><div class="row"><div class="col-lg-7"><span class="lead">Search Parameters</span><table class="table table-condensed table-hover"><thead><tr><th>Conformance</th><th>Parameter</th><th>Type</th><th>Documentation</th></tr></thead><tbody><tr><td><b>SHALL</b></td><td><a href="http://hl7.org/fhir/R4/list.html#search">patient</a></td><td><code>reference</code></td><td><div><p>Allows retrieving medication lists for the patient</p>
</div></td></tr><tr><td><b>SHOULD</b></td><td><a href="http://hl7.org/fhir/R4/list.html#search">code</a></td><td><code>token</code></td><td><div><p>Allows retrieving specific kinds of medication lists</p>
</div></td></tr></tbody></table></div><div class="col-lg-5"> </div></div><div class="row"><div class="col-12"><span class="lead">Extended Operations</span><table class="table table-condensed table-hover"><thead><tr><th>Conformance</th><th>Operation</th><th>Documentation</th></tr></thead><tbody><tr><td><b>MAY</b></td><td><a href="OperationDefinition-smp-operation-retrieve.html">$smp-query</a></td><td><div><p>Operation used to retrieve individual patient's medication history</p>
</div></td></tr><tr><td><b>MAY</b></td><td><a href="OperationDefinition-smp-operation-submit.html">$smp-submit</a></td><td><div><p>Operation used to submit individual patient's medication list for storage</p>
</div></td></tr></tbody></table></div></div></div></div></div><div class="panel panel-default"><div class="panel-heading"><h4 id="MedicationStatement1-2" class="panel-title"><span style="float: right;">Resource Conformance: SHALL </span>MedicationStatement</h4></div><div class="panel-body"><div class="container"><div class="row"><div class="col-lg-4"><span class="lead">Core FHIR Resource</span><br/><a href="http://hl7.org/fhir/R4/medicationstatement.html">MedicationStatement</a></div><div class="col-lg-4"><span class="lead">Reference Policy</span><br/></div><div class="col-lg-4"><span class="lead">Interaction summary</span><br/><ul><li><strong>SHALL</strong> support <br/><code>read</code><div><p>Allows retrieval of medication details.</p>
</div></li><li><strong>SHOULD</strong> support <br/><code>update</code><div><p>Allows for the maintenance of the medication details.</p>
</div><code>create</code><div><p>Allows for the creation of a medication details. (Mandatory if creation of Medication lists enabled.)</p>
</div></li></ul></div></div><p/><div class="row"><div class="col-6"><span class="lead">Supported Profiles</span><p><a href="StructureDefinition-smp-medicationstatement.html">Standardized Medication Profile - MedicationStatement</a></p></div></div><p/><div class="row"><div class="col-lg-7"><span class="lead">Search Parameters</span><table class="table table-condensed table-hover"><thead><tr><th>Conformance</th><th>Parameter</th><th>Type</th><th>Documentation</th></tr></thead><tbody><tr><td><b>SHALL</b></td><td><a href="http://hl7.org/fhir/R4/medicationstatement.html#search">patient</a></td><td><code>reference</code></td><td><div><p>Allows retrieving medication statements for a patient</p>
</div></td></tr><tr><td><b>SHOULD</b></td><td><a href="http://hl7.org/fhir/R4/medicationstatement.html#search">status</a></td><td><code>token</code></td><td><div><p>Allows filtering by medication statement status</p>
</div></td></tr></tbody></table></div><div class="col-lg-5"> </div></div></div></div></div><div class="panel panel-default"><div class="panel-heading"><h4 id="Medication1-3" class="panel-title"><span style="float: right;">Resource Conformance: SHOULD </span>Medication</h4></div><div class="panel-body"><div class="container"><div class="row"><div class="col-lg-4"><span class="lead">Core FHIR Resource</span><br/><a href="http://hl7.org/fhir/R4/medication.html">Medication</a></div><div class="col-lg-4"><span class="lead">Reference Policy</span><br/></div><div class="col-lg-4"><span class="lead">Interaction summary</span><br/><ul><li><strong>SHOULD</strong> support <br/><code>read</code><div><p>Allows retrieval medication details</p>
</div></li><li><strong>MAY</strong> support <br/><code>create</code><div><p>Allows for the creation of a medication.</p>
</div></li></ul></div></div><p/><div class="row"><div class="col-6"><span class="lead">Supported Profiles</span><p><a href="StructureDefinition-smp-medication.html">Standardized Medication Profile - Medication</a></p></div></div><p/></div></div></div><div class="panel panel-default"><div class="panel-heading"><h4 id="MedicationRequest1-4" class="panel-title"><span style="float: right;">Resource Conformance: SHALL </span>MedicationRequest</h4></div><div class="panel-body"><div class="container"><div class="row"><div class="col-lg-4"><span class="lead">Core FHIR Resource</span><br/><a href="http://hl7.org/fhir/R4/medicationrequest.html">MedicationRequest</a></div><div class="col-lg-4"><span class="lead">Reference Policy</span><br/></div><div class="col-lg-4"><span class="lead">Interaction summary</span><br/><ul><li><strong>SHOULD</strong> support <br/><code>read</code><div><p>Allows retrieval of .</p>
</div></li><li><strong>MAY</strong> support <br/><code>create</code><div><p>Allows for the creation of a medication.</p>
</div><code>update</code><div><p>Allows for the maintenance of a MedicationRequest as required.</p>
</div></li></ul></div></div><p/><div class="row"><div class="col-6"><span class="lead">Supported Profiles</span><p><a href="http://hl7.org/fhir/us/core/STU8/StructureDefinition-us-core-medicationrequest.html">US Core MedicationRequest Profile</a></p></div></div><p/><div class="row"><div class="col-lg-7"><span class="lead">Search Parameters</span><table class="table table-condensed table-hover"><thead><tr><th>Conformance</th><th>Parameter</th><th>Type</th><th>Documentation</th></tr></thead><tbody><tr><td><b>SHALL</b></td><td><a href="http://hl7.org/fhir/R4/medicationrequest.html#search">patient</a></td><td><code>reference</code></td><td><div><p>Allows retrieving medication requests for a patient</p>
</div></td></tr><tr><td><b>SHOULD</b></td><td><a href="http://hl7.org/fhir/R4/medicationrequest.html#search">intent</a></td><td><code>token</code></td><td><div><p>Allows filtering by medication request intent</p>
</div></td></tr><tr><td><b>SHOULD</b></td><td><a href="http://hl7.org/fhir/R4/medicationrequest.html#search">status</a></td><td><code>token</code></td><td><div><p>Allows filtering by medication request status</p>
</div></td></tr></tbody></table></div><div class="col-lg-5"> </div></div></div></div></div><div class="panel panel-default"><div class="panel-heading"><h4 id="MedicationAdministration1-5" class="panel-title"><span style="float: right;">Resource Conformance: SHALL </span>MedicationAdministration</h4></div><div class="panel-body"><div class="container"><div class="row"><div class="col-lg-4"><span class="lead">Core FHIR Resource</span><br/><a href="http://hl7.org/fhir/R4/medicationadministration.html">MedicationAdministration</a></div><div class="col-lg-4"><span class="lead">Reference Policy</span><br/></div><div class="col-lg-4"><span class="lead">Interaction summary</span><br/><ul><li><strong>SHOULD</strong> support <br/><code>read</code><div><p>Allows retrieval medication details.</p>
</div></li><li><strong>MAY</strong> support <br/><code>create</code><div><p>Allows for the creation of a medication.</p>
</div><code>update</code><div><p>Allows for the maintenance of a MedicationAdministration as required.</p>
</div></li></ul></div></div><p/><div class="row"><div class="col-6"><span class="lead">Supported Profiles</span><p><a href="StructureDefinition-smp-medicationadministration.html">Standardized Medication Profile - MedicationAdministration</a></p></div></div><p/><div class="row"><div class="col-lg-7"><span class="lead">Search Parameters</span><table class="table table-condensed table-hover"><thead><tr><th>Conformance</th><th>Parameter</th><th>Type</th><th>Documentation</th></tr></thead><tbody><tr><td><b>SHALL</b></td><td><a href="http://hl7.org/fhir/R4/medicationadministration.html#search">patient</a></td><td><code>reference</code></td><td><div><p>Allows retrieving medication administrations for a patient</p>
</div></td></tr><tr><td><b>SHOULD</b></td><td><a href="http://hl7.org/fhir/R4/medicationadministration.html#search">status</a></td><td><code>token</code></td><td><div><p>Allows filtering by medication administration status</p>
</div></td></tr></tbody></table></div><div class="col-lg-5"> </div></div></div></div></div><div class="panel panel-default"><div class="panel-heading"><h4 id="CarePlan1-6" class="panel-title"><span style="float: right;">Resource Conformance: SHALL </span>CarePlan</h4></div><div class="panel-body"><div class="container"><div class="row"><div class="col-lg-4"><span class="lead">Core FHIR Resource</span><br/><a href="http://hl7.org/fhir/R4/careplan.html">CarePlan</a></div><div class="col-lg-4"><span class="lead">Reference Policy</span><br/></div><div class="col-lg-4"><span class="lead">Interaction summary</span><br/><ul><li><strong>SHOULD</strong> support <br/><code>read</code><div><p>Allows retrieval medication action plan details.</p>
</div></li><li><strong>MAY</strong> support <br/><code>create</code><div><p>Allows for the creation of a medication action plan.</p>
</div><code>update</code><div><p>Allows for the maintenance of a CarePlan as required.</p>
</div></li></ul></div></div><p/><div class="row"><div class="col-6"><span class="lead">Supported Profiles</span><p><a href="StructureDefinition-smp-medication-action-plan.html">Standardized Medication Profile - Medication Action Plan</a></p></div></div><p/><div class="row"><div class="col-lg-7"><span class="lead">Search Parameters</span><table class="table table-condensed table-hover"><thead><tr><th>Conformance</th><th>Parameter</th><th>Type</th><th>Documentation</th></tr></thead><tbody><tr><td><b>SHALL</b></td><td><a href="http://hl7.org/fhir/R4/careplan.html#search">patient</a></td><td><code>reference</code></td><td><div><p>Allows retrieving medication action plans for a patient</p>
</div></td></tr></tbody></table></div><div class="col-lg-5"> </div></div></div></div></div><div class="panel panel-default"><div class="panel-heading"><h4 id="DetectedIssue1-7" class="panel-title"><span style="float: right;">Resource Conformance: SHALL </span>DetectedIssue</h4></div><div class="panel-body"><div class="container"><div class="row"><div class="col-lg-4"><span class="lead">Core FHIR Resource</span><br/><a href="http://hl7.org/fhir/R4/detectedissue.html">DetectedIssue</a></div><div class="col-lg-4"><span class="lead">Reference Policy</span><br/></div><div class="col-lg-4"><span class="lead">Interaction summary</span><br/><ul><li><strong>SHOULD</strong> support <br/><code>read</code><div><p>Allows retrieval medication action plan detected issue details.</p>
</div></li></ul></div></div><p/><div class="row"><div class="col-6"><span class="lead">Supported Profiles</span><p><a href="StructureDefinition-smp-medication-action-plan-detected-issue.html">Standardized Medication Profile - Medication Action Plan Detected Issue</a></p></div></div><p/><div class="row"><div class="col-lg-7"><span class="lead">Search Parameters</span><table class="table table-condensed table-hover"><thead><tr><th>Conformance</th><th>Parameter</th><th>Type</th><th>Documentation</th></tr></thead><tbody><tr><td><b>SHALL</b></td><td><a href="http://hl7.org/fhir/R4/detectedissue.html#search">patient</a></td><td><code>reference</code></td><td><div><p>Allows retrieving medication action plans for a patient</p>
</div></td></tr></tbody></table></div><div class="col-lg-5"> </div></div></div></div></div><div class="panel panel-default"><div class="panel-heading"><h4 id="Patient1-8" class="panel-title"><span style="float: right;">Resource Conformance: SHALL </span>Patient</h4></div><div class="panel-body"><div class="container"><div class="row"><div class="col-lg-4"><span class="lead">Core FHIR Resource</span><br/><a href="http://hl7.org/fhir/R4/patient.html">Patient</a></div><div class="col-lg-4"><span class="lead">Reference Policy</span><br/></div><div class="col-lg-4"><span class="lead">Interaction summary</span><br/><ul><li><strong>SHALL</strong> support <br/><code>read</code><div><p>Required for identification and retrieval of patient medication information</p>
</div></li></ul></div></div><p/><div class="row"><div class="col-6"><span class="lead">Supported Profiles</span><p><a href="http://hl7.org/fhir/us/core/STU8/StructureDefinition-us-core-patient.html">US Core Patient Profile</a></p></div></div><p/><div class="row"><div class="col-lg-7"><span class="lead">Search Parameters</span><table class="table table-condensed table-hover"><thead><tr><th>Conformance</th><th>Parameter</th><th>Type</th><th>Documentation</th></tr></thead><tbody><tr><td><b>SHALL</b></td><td><a href="http://hl7.org/fhir/R4/resource.html#search">_id</a></td><td><code>token</code></td><td><div><p>Allows retrieval of patient by id. Aligns with US Core requirement and FHIR base spec.</p>
</div></td></tr></tbody></table></div><div class="col-lg-5"> </div></div></div></div></div><div class="panel panel-default"><div class="panel-heading"><h4 id="Bundle1-9" class="panel-title"><span style="float: right;">Resource Conformance: MAY </span>Bundle</h4></div><div class="panel-body"><div class="container"><div class="row"><div class="col-lg-4"><span class="lead">Core FHIR Resource</span><br/><a href="http://hl7.org/fhir/R4/bundle.html">Bundle</a></div><div class="col-lg-4"><span class="lead">Reference Policy</span><br/></div><div class="col-lg-4"><span class="lead">Interaction summary</span><br/><ul><li><strong>MAY</strong> support <br/><code>read</code><div><p>Allows retrieval of collection-type medication list bundles from a repository. Does NOT apply to transaction bundles which are ephemeral. If the smp-query operation on List is implemented, this capability becomes mandatory.</p>
</div></li></ul></div></div><p/><div class="row"><div class="col-6"><span class="lead">Supported Profiles</span><p><a href="StructureDefinition-smp-bundle.html">Standardized Medication Profile - Bundle Medication List</a><br/><a href="StructureDefinition-smp-bundle-transaction.html">Standardized Medication Profile - Bundle Medication List Maintenance</a><br/><a href="StructureDefinition-smp-medication-action-plan-bundle.html">Standardized Medication Profile - Bundle Medication Action Plan</a></p></div></div><p/><div class="row"><div class="col-12"><span class="lead">Documentation</span><blockquote><div><p>Supports three Bundle profiles: (1) Bundle Medication List profile (type=collection) for retrieving medication lists with supporting resources - supports read interaction; (2) Bundle Medication List Maintenance profile (type=transaction) for submitting create/update operations - transaction bundles are ephemeral processing instructions and are not stored as resources, so the read interaction does not apply to them; (3) Bundle Medication Action Plan (type=document) for submitting a medication action plan consisting of detected issues and an unstructured document attachment.</p>
</div></blockquote></div></div></div></div></div></div>
</text>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
<valueCode value="phx"/>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
<valueInteger value="1">
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom">
<valueCanonical
value="http://hl7.org/fhir/us/smp/ImplementationGuide/hl7.fhir.us.smp"/>
</extension>
</valueInteger>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
<valueCode value="trial-use">
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom">
<valueCanonical
value="http://hl7.org/fhir/us/smp/ImplementationGuide/hl7.fhir.us.smp"/>
</extension>
</valueCode>
</extension>
<url value="http://hl7.org/fhir/us/smp/CapabilityStatement/smp-server"/>
<version value="1.0.0"/>
<name value="SMP_Server"/>
<status value="active"/>
<date value="2024-04-29T00:00:00-06:00"/>
<publisher value="HL7 International / Pharmacy"/>
<contact>
<name value="HL7 International / Pharmacy"/>
<telecom>
<system value="url"/>
<value value="http://www.hl7.org/Special/committees/medication"/>
</telecom>
<telecom>
<system value="email"/>
<value value="pharmacylists@lists.hl7.org"/>
</telecom>
</contact>
<contact>
<name value="Andy Stechishin"/>
<telecom>
<system value="email"/>
<value value="mailto:andy.stechishin@gmail.com"/>
</telecom>
</contact>
<description
value="This resource defines the expected capabilities of the SMP Server actor when conforming to the SMP IG and It is expected that it will be used in conjunction with the US Core CapabilityStatement. Together they describe the complete list of actual profiles and RESTful operations supported by SMP servers. SMP Server requirements may also be impacted by the rules of local jurisdictions or other contextual requirements."/>
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="US"/>
<display value="United States of America"/>
</coding>
</jurisdiction>
<kind value="requirements"/>
<fhirVersion value="4.0.1"/>
<format value="json">
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
</format>
<format value="xml">
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHOULD"/>
</extension>
</format>
<rest>
<mode value="server"/>
<resource>
<type value="List"/>
<supportedProfile
value="http://hl7.org/fhir/us/smp/StructureDefinition/smp-medication-list"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="read"/>
<documentation
value="Allows retrieval of medication list for the various point in time information."/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHOULD"/>
</extension>
<code value="update"/>
<documentation
value="Allows for the maintenance of the medication lists."/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHOULD"/>
</extension>
<code value="create"/>
<documentation value="Allows for the creation of a medication list."/>
</interaction>
<searchParam>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<name value="patient"/>
<definition value="http://hl7.org/fhir/SearchParameter/List-subject"/>
<type value="reference"/>
<documentation
value="Allows retrieving medication lists for the patient"/>
</searchParam>
<searchParam>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHOULD"/>
</extension>
<name value="code"/>
<definition
value="http://hl7.org/fhir/SearchParameter/clinical-code"/>
<type value="token"/>
<documentation
value="Allows retrieving specific kinds of medication lists"/>
</searchParam>
<operation>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY"/>
</extension>
<name value="smp-query"/>
<definition
value="http://hl7.org/fhir/us/smp/OperationDefinition/smp-operation-retrieve"/>
<documentation
value="Operation used to retrieve individual patient's medication history"/>
</operation>
<operation>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY"/>
</extension>
<name value="smp-submit"/>
<definition
value="http://hl7.org/fhir/us/smp/OperationDefinition/smp-operation-submit"/>
<documentation
value="Operation used to submit individual patient's medication list for storage"/>
</operation>
</resource>
<resource>
<type value="MedicationStatement"/>
<supportedProfile
value="http://hl7.org/fhir/us/smp/StructureDefinition/smp-medicationstatement"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="read"/>
<documentation value="Allows retrieval of medication details."/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHOULD"/>
</extension>
<code value="update"/>
<documentation
value="Allows for the maintenance of the medication details."/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHOULD"/>
</extension>
<code value="create"/>
<documentation
value="Allows for the creation of a medication details. (Mandatory if creation of Medication lists enabled.)"/>
</interaction>
<searchParam>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<name value="patient"/>
<definition
value="http://hl7.org/fhir/SearchParameter/clinical-patient"/>
<type value="reference"/>
<documentation
value="Allows retrieving medication statements for a patient"/>
</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/medications-status"/>
<type value="token"/>
<documentation
value="Allows filtering by medication statement status"/>
</searchParam>
</resource>
<resource>
<type value="Medication"/>
<supportedProfile
value="http://hl7.org/fhir/us/smp/StructureDefinition/smp-medication"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHOULD"/>
</extension>
<code value="read"/>
<documentation value="Allows retrieval medication details"/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY"/>
</extension>
<code value="create"/>
<documentation value="Allows for the creation of a medication."/>
</interaction>
</resource>
<resource>
<type value="MedicationRequest"/>
<supportedProfile
value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationrequest"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHOULD"/>
</extension>
<code value="read"/>
<documentation value="Allows retrieval of ."/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY"/>
</extension>
<code value="create"/>
<documentation value="Allows for the creation of a medication."/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY"/>
</extension>
<code value="update"/>
<documentation
value="Allows for the maintenance of a MedicationRequest as required."/>
</interaction>
<searchParam>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<name value="patient"/>
<definition
value="http://hl7.org/fhir/SearchParameter/clinical-patient"/>
<type value="reference"/>
<documentation
value="Allows retrieving medication requests for a patient"/>
</searchParam>
<searchParam>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHOULD"/>
</extension>
<name value="intent"/>
<definition
value="http://hl7.org/fhir/SearchParameter/MedicationRequest-intent"/>
<type value="token"/>
<documentation value="Allows filtering by medication request intent"/>
</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/medications-status"/>
<type value="token"/>
<documentation value="Allows filtering by medication request status"/>
</searchParam>
</resource>
<resource>
<type value="MedicationAdministration"/>
<supportedProfile
value="http://hl7.org/fhir/us/smp/StructureDefinition/smp-medicationadministration"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHOULD"/>
</extension>
<code value="read"/>
<documentation value="Allows retrieval medication details."/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY"/>
</extension>
<code value="create"/>
<documentation value="Allows for the creation of a medication."/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY"/>
</extension>
<code value="update"/>
<documentation
value="Allows for the maintenance of a MedicationAdministration as required."/>
</interaction>
<searchParam>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<name value="patient"/>
<definition
value="http://hl7.org/fhir/SearchParameter/clinical-patient"/>
<type value="reference"/>
<documentation
value="Allows retrieving medication administrations for a patient"/>
</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/medications-status"/>
<type value="token"/>
<documentation
value="Allows filtering by medication administration status"/>
</searchParam>
</resource>
<resource>
<type value="CarePlan"/>
<supportedProfile
value="http://hl7.org/fhir/us/smp/StructureDefinition/smp-medication-action-plan"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHOULD"/>
</extension>
<code value="read"/>
<documentation
value="Allows retrieval medication action plan details."/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY"/>
</extension>
<code value="create"/>
<documentation
value="Allows for the creation of a medication action plan."/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY"/>
</extension>
<code value="update"/>
<documentation
value="Allows for the maintenance of a CarePlan as required."/>
</interaction>
<searchParam>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<name value="patient"/>
<definition
value="http://hl7.org/fhir/SearchParameter/clinical-patient"/>
<type value="reference"/>
<documentation
value="Allows retrieving medication action plans for a patient"/>
</searchParam>
</resource>
<resource>
<type value="DetectedIssue"/>
<supportedProfile
value="http://hl7.org/fhir/us/smp/StructureDefinition/smp-medication-action-plan-detected-issue"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHOULD"/>
</extension>
<code value="read"/>
<documentation
value="Allows retrieval medication action plan detected issue details."/>
</interaction>
<searchParam>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<name value="patient"/>
<definition
value="http://hl7.org/fhir/SearchParameter/clinical-patient"/>
<type value="reference"/>
<documentation
value="Allows retrieving medication action plans for a patient"/>
</searchParam>
</resource>
<resource>
<type value="Patient"/>
<supportedProfile
value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="read"/>
<documentation
value="Required for identification and retrieval of patient medication information"/>
</interaction>
<searchParam>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<name value="_id"/>
<definition value="http://hl7.org/fhir/SearchParameter/Resource-id"/>
<type value="token"/>
<documentation
value="Allows retrieval of patient by id. Aligns with US Core requirement and FHIR base spec."/>
</searchParam>
</resource>
<resource>
<type value="Bundle"/>
<supportedProfile
value="http://hl7.org/fhir/us/smp/StructureDefinition/smp-bundle"/>
<supportedProfile
value="http://hl7.org/fhir/us/smp/StructureDefinition/smp-bundle-transaction"/>
<supportedProfile
value="http://hl7.org/fhir/us/smp/StructureDefinition/smp-medication-action-plan-bundle"/>
<documentation
value="Supports three Bundle profiles: (1) Bundle Medication List profile (type=collection) for retrieving medication lists with supporting resources - supports read interaction; (2) Bundle Medication List Maintenance profile (type=transaction) for submitting create/update operations - transaction bundles are ephemeral processing instructions and are not stored as resources, so the read interaction does not apply to them; (3) Bundle Medication Action Plan (type=document) for submitting a medication action plan consisting of detected issues and an unstructured document attachment."/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY"/>
</extension>
<code value="read"/>
<documentation
value="Allows retrieval of collection-type medication list bundles from a repository. Does NOT apply to transaction bundles which are ephemeral. If the smp-query operation on List is implemented, this capability becomes mandatory."/>
</interaction>
</resource>
</rest>
</CapabilityStatement>
IG © 2023+ HL7 International / Pharmacy. Package hl7.fhir.us.smp#1.0.0 based on FHIR 4.0.1. Generated 2026-01-20
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change