Da Vinci - Documentation Templates and Rules, published by HL7 International / Clinical Decision Support. This guide is not an authorized publication; it is the continuous build for version 2.1.0-preview built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/davinci-dtr/ and changes regularly. See the Directory of published versions
Page standards status: Trial-use | Maturity Level: 2 |
<CapabilityStatement xmlns="http://hl7.org/fhir">
<id value="smart-dtr-client-311"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><h2 id="title">SMART on FHIR DTR Client</h2><ul><li><b>Official URL:</b><code>http://hl7.org/fhir/us/davinci-dtr/CapabilityStatement/smart-dtr-client-311</code></li><li><b>Implementation Guide Version:</b> 2.1.0-preview</li><li><b>FHIR Version:</b> 4.0.1</li><li><b>Intended Use:</b> Requirements</li><li><b>Supported Formats: </b>JSON</li><li><b>Published:</b> 2024-08-02</li><li><b>Published by:</b> HL7 International / Clinical Decision Support</li><li><b>Status:</b> Active</li></ul><p>This statement defines the expected capabilities of DTR SMART on FHIR applications for USCDI 1 (US-Core 3.1.1). Such apps require client support for retrieving and editing QuestionnaireResponse resources and related resources, as well as client support for the Questionnaire Package, ValueSet Expand, and Next Question operations.</p> <!-- Imports --><h3 id="should_css" class="no_toc">Include And Support Everything In The Following CapabilityStatements:</h3><ul><li><a href="http://hl7.org/fhir/us/core/CapabilityStatement/us-core-client|3.1.1">US Core Client CapabilityStatement</a></li></ul> <!-- REST Behavior --><h3 id="behavior">FHIR Client RESTful Capabilities</h3><p>A SMART on FHIR DTR Client provides an application conforming to the SMART on FHIR specification and related requirements declared in this Implementation Guide.</p><p id="security"><strong>Security:</strong></p><p>Implementations <strong>SHALL</strong> meet the general security requirements documented in the <a href="https://build.fhir.org/ig/HL7/davinci-ehrx">HRex implementation guide</a>.</p><p><strong>Summary of Client Wide Operations</strong></p><ul><li><strong>SHALL</strong> support the <a href="OperationDefinition-questionnaire-package.html"><code>$questionnaire-package</code></a> operation.</li><li><strong>SHALL</strong> support the <a href="http://hl7.org/fhir/OperationDefinition/ValueSet-expand"><code>$expand</code></a> operation.</li><li><strong>SHALL</strong> support the <a href="http://hl7.org/fhir/uv/sdc/OperationDefinition/Questionnaire-next-question"><code>$next-question</code></a> operation.</li></ul><h3 id="resource--details" class="no_toc">RESTful Capabilities by Resource/Profile:</h3><p><strong>Summary</strong></p><p><i>♦ = <b>SHALL</b> expectation</i>;<i>⋄ = <b>SHOULD</b> expectation</i>;<i>▿ = <b>MAY</b> expectation</i>;</p><table class="grid"><thead><tr><th>Resource Type</th><th>Supported Interactions</th><th>Supported Profiles</th><th>Supported Searches</th><th>Supported <code>_includes</code></th><th>Supported <code>_revincludes</code></th><th>Supported Operations</th></tr></thead><tbody><tr><td><a href="#questionnaireresponse"><span style="white-space: nowrap;">QuestionnaireResponse</span></a></td><td><span style="white-space: nowrap;">read<span title="SHALL"><sup>♦</sup></span></span>, <span style="white-space: nowrap;">create<span title="SHALL"><sup>♦</sup></span></span>, <span style="white-space: nowrap;">update<span title="SHALL"><sup>♦</sup></span></span>, <span style="white-space: nowrap;">search-type<span title="SHALL"><sup>♦</sup></span></span></td> <!-- Supported Profiles --><td><a href="StructureDefinition-dtr-questionnaireresponse.html">DTR Questionnaire Response</a></td> <!-- Supported Searches will need to do some sort of mapping instead of join to get the expectations printed out --><td><span style="white-space: nowrap;">context<span title="SHALL"><sup>♦</sup></span></span>, <span style="white-space: nowrap;">patient<span title="SHALL"><sup>♦</sup></span></span></td> <!-- Supported _includes --><td/> <!-- Supported _revincludes --><td> <!-- --></td> <!-- Supported Operations --><td/></tr><tr><td><a href="#encounter"><span style="white-space: nowrap;">Encounter</span></a></td><td><span style="white-space: nowrap;">read<span title="SHALL"><sup>♦</sup></span></span></td> <!-- Supported Profiles --><td><a href="https://build.fhir.org/ig/HL7/davinci-crd/StructureDefinition-profile-encounter3.1.html">CRD Encounter - USCDI 1</a></td> <!-- Supported Searches will need to do some sort of mapping instead of join to get the expectations printed out --><td/> <!-- Supported _includes --><td/> <!-- Supported _revincludes --><td> <!-- --></td> <!-- Supported Operations --><td/></tr><tr><td><a href="#devicerequest"><span style="white-space: nowrap;">DeviceRequest</span></a></td><td><span style="white-space: nowrap;">read<span title="SHALL"><sup>♦</sup></span></span></td> <!-- Supported Profiles --><td><a href="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-devicerequest">CRD Device Request</a></td> <!-- Supported Searches will need to do some sort of mapping instead of join to get the expectations printed out --><td/> <!-- Supported _includes --><td/> <!-- Supported _revincludes --><td> <!-- --></td> <!-- Supported Operations --><td/></tr><tr><td><a href="#medicationrequest"><span style="white-space: nowrap;">MedicationRequest</span></a></td><td><span style="white-space: nowrap;">read<span title="SHALL"><sup>♦</sup></span></span></td> <!-- Supported Profiles --><td><a href="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-medicationrequest">CRD Medication Request</a></td> <!-- Supported Searches will need to do some sort of mapping instead of join to get the expectations printed out --><td/> <!-- Supported _includes --><td/> <!-- Supported _revincludes --><td> <!-- --></td> <!-- Supported Operations --><td/></tr><tr><td><a href="#nutritionorder"><span style="white-space: nowrap;">NutritionOrder</span></a></td><td><span style="white-space: nowrap;">read<span title="SHALL"><sup>♦</sup></span></span></td> <!-- Supported Profiles --><td><a href="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-nutritionorder">CRD Nutrition Order</a></td> <!-- Supported Searches will need to do some sort of mapping instead of join to get the expectations printed out --><td/> <!-- Supported _includes --><td/> <!-- Supported _revincludes --><td> <!-- --></td> <!-- Supported Operations --><td/></tr><tr><td><a href="#communicationrequest"><span style="white-space: nowrap;">CommunicationRequest</span></a></td><td><span style="white-space: nowrap;">read<span title="SHALL"><sup>♦</sup></span></span></td> <!-- Supported Profiles --><td><a href="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-communicationrequest">CRD Communication Request</a></td> <!-- Supported Searches will need to do some sort of mapping instead of join to get the expectations printed out --><td/> <!-- Supported _includes --><td/> <!-- Supported _revincludes --><td> <!-- --></td> <!-- Supported Operations --><td/></tr><tr><td><a href="#servicerequest"><span style="white-space: nowrap;">ServiceRequest</span></a></td><td><span style="white-space: nowrap;">read<span title="SHALL"><sup>♦</sup></span></span></td> <!-- Supported Profiles --><td><a href="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-servicerequest">CRD Service Request</a></td> <!-- Supported Searches will need to do some sort of mapping instead of join to get the expectations printed out --><td/> <!-- Supported _includes --><td/> <!-- Supported _revincludes --><td> <!-- --></td> <!-- Supported Operations --><td/></tr><tr><td><a href="#visionprescription"><span style="white-space: nowrap;">VisionPrescription</span></a></td><td><span style="white-space: nowrap;">read<span title="SHALL"><sup>♦</sup></span></span></td> <!-- Supported Profiles --><td><a href="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-visionprescription">CRD Vision Prescription</a></td> <!-- Supported Searches will need to do some sort of mapping instead of join to get the expectations printed out --><td/> <!-- Supported _includes --><td/> <!-- Supported _revincludes --><td> <!-- --></td> <!-- Supported Operations --><td/></tr><tr><td><a href="#task"><span style="white-space: nowrap;">Task</span></a></td><td><span style="white-space: nowrap;">read<span title="SHALL"><sup>♦</sup></span></span>, <span style="white-space: nowrap;">create<span title="SHALL"><sup>♦</sup></span></span>, <span style="white-space: nowrap;">update<span title="SHALL"><sup>♦</sup></span></span></td> <!-- Supported Profiles --><td/> <!-- Supported Searches will need to do some sort of mapping instead of join to get the expectations printed out --><td/> <!-- Supported _includes --><td/> <!-- Supported _revincludes --><td> <!-- --></td> <!-- Supported Operations --><td/></tr></tbody></table> <!-- Resource Details --><h4 id="questionnaireresponse" class="no_toc">QuestionnaireResponse</h4><p>Supported Profiles:</p><ul><li><a href="StructureDefinition-dtr-questionnaireresponse.html">DTR Questionnaire Response</a></li></ul><p>Profile Interaction Summary:</p><ul><li><strong>SHALL</strong> support <code>read</code>, <code>create</code>, <code>update</code>, <code>search-type</code>.</li></ul><p>Modify Criteria:</p><ul><li>A Client <strong>SHALL</strong> be capable of posting a QuestionnaireResponse resource using:<code class="highlighter-rouge">POST [base]/QuestionnaireResponse/[id]{?_format=[mime-type]}</code></li><li>A Client <strong>SHALL</strong> be capable of putting an existing QuestionnaireResponse resource using:<code class="highlighter-rouge">PUT [base]/QuestionnaireResponse/[id]{?_format=[mime-type]}</code></li></ul><p>Fetch and Search Criteria:</p><ul><li>A Client <strong>SHALL</strong> be capable of fetching a QuestionnaireResponse resource using:<code class="highlighter-rouge">GET [base]/QuestionnaireResponse/[id]</code></li><li>A Client <strong>SHALL</strong> be capable of fetching resources matching a search query using:<code class="highlighter-rouge">GET [base]/QuestionnaireResponse/[id]{?[parameters]{&_format=[mime-type]}}</code></li></ul> <!-- Only included search parameters that are not MAY or there is no conformance requirement included --><p>Search Parameter Summary:</p><table class="grid"><thead><tr><th style="white-space: nowrap;">Conformance</th><th>Parameter</th><th>Type</th><th>Example</th></tr></thead><tbody><tr><td><strong>SHALL</strong></td><td><a href="http://hl7.org/fhir/R4/questionnaireresponse.html#search">context</a></td><td>reference</td><td><code class="highlighter-rouge">GET [base]/QuestionnaireResponse?context=[type]/[id]</code></td></tr><tr><td><strong>SHALL</strong></td><td><a href="http://hl7.org/fhir/R4/questionnaireresponse.html#search">patient</a></td><td>reference</td><td><code class="highlighter-rouge">GET [base]/QuestionnaireResponse?patient=[type]/[id]</code></td></tr></tbody></table><div><p>Search Parameter Requirements (When Used Alone or in Combination):</p><ul><li><a href="http://hl7.org/fhir/R4/questionnaireresponse.html#search">context</a> (reference):<p>Allows retrieving QuestionnaireResponse for a context</p></li><li><a href="http://hl7.org/fhir/R4/questionnaireresponse.html#search">patient</a> (reference):<p>Allows retrieving QuestionnaireResponse for a patient</p></li></ul></div><h4 id="encounter" class="no_toc">Encounter</h4><p>Supported Profiles:</p><ul><li><a href="https://build.fhir.org/ig/HL7/davinci-crd/StructureDefinition-profile-encounter3.1.html">CRD Encounter - USCDI 1</a></li></ul><p>Profile Interaction Summary:</p><ul><li><strong>SHALL</strong> support <code>read</code>.</li></ul><p>Fetch and Search Criteria:</p><ul><li>A Client <strong>SHALL</strong> be capable of fetching an Encounter resource using:<code class="highlighter-rouge">GET [base]/Encounter/[id]</code></li></ul><h4 id="devicerequest" class="no_toc">DeviceRequest</h4><p>Supported Profiles:</p><ul><li><a href="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-devicerequest">CRD Device Request</a></li></ul><p>Profile Interaction Summary:</p><ul><li><strong>SHALL</strong> support <code>read</code>.</li></ul><p>Fetch and Search Criteria:</p><ul><li>A Client <strong>SHALL</strong> be capable of fetching a DeviceRequest resource using:<code class="highlighter-rouge">GET [base]/DeviceRequest/[id]</code></li></ul><h4 id="medicationrequest" class="no_toc">MedicationRequest</h4><p>Supported Profiles:</p><ul><li><a href="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-medicationrequest">CRD Medication Request</a></li></ul><p>Profile Interaction Summary:</p><ul><li><strong>SHALL</strong> support <code>read</code>.</li></ul><p>Fetch and Search Criteria:</p><ul><li>A Client <strong>SHALL</strong> be capable of fetching a MedicationRequest resource using:<code class="highlighter-rouge">GET [base]/MedicationRequest/[id]</code></li></ul><h4 id="nutritionorder" class="no_toc">NutritionOrder</h4><p>Supported Profiles:</p><ul><li><a href="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-nutritionorder">CRD Nutrition Order</a></li></ul><p>Profile Interaction Summary:</p><ul><li><strong>SHALL</strong> support <code>read</code>.</li></ul><p>Fetch and Search Criteria:</p><ul><li>A Client <strong>SHALL</strong> be capable of fetching a NutritionOrder resource using:<code class="highlighter-rouge">GET [base]/NutritionOrder/[id]</code></li></ul><h4 id="communicationrequest" class="no_toc">CommunicationRequest</h4><p>Supported Profiles:</p><ul><li><a href="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-communicationrequest">CRD Communication Request</a></li></ul><p>Profile Interaction Summary:</p><ul><li><strong>SHALL</strong> support <code>read</code>.</li></ul><p>Fetch and Search Criteria:</p><ul><li>A Client <strong>SHALL</strong> be capable of fetching a CommunicationRequest resource using:<code class="highlighter-rouge">GET [base]/CommunicationRequest/[id]</code></li></ul><h4 id="servicerequest" class="no_toc">ServiceRequest</h4><p>Supported Profiles:</p><ul><li><a href="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-servicerequest">CRD Service Request</a></li></ul><p>Profile Interaction Summary:</p><ul><li><strong>SHALL</strong> support <code>read</code>.</li></ul><p>Fetch and Search Criteria:</p><ul><li>A Client <strong>SHALL</strong> be capable of fetching a ServiceRequest resource using:<code class="highlighter-rouge">GET [base]/ServiceRequest/[id]</code></li></ul><h4 id="visionprescription" class="no_toc">VisionPrescription</h4><p>Supported Profiles:</p><ul><li><a href="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-visionprescription">CRD Vision Prescription</a></li></ul><p>Profile Interaction Summary:</p><ul><li><strong>SHALL</strong> support <code>read</code>.</li></ul><p>Fetch and Search Criteria:</p><ul><li>A Client <strong>SHALL</strong> be capable of fetching a VisionPrescription resource using:<code class="highlighter-rouge">GET [base]/VisionPrescription/[id]</code></li></ul><h4 id="task" class="no_toc">Task</h4><p>Profile Interaction Summary:</p><ul><li><strong>SHALL</strong> support <code>read</code>, <code>create</code>, <code>update</code>.</li></ul><p>Modify Criteria:</p><ul><li>A Client <strong>SHALL</strong> be capable of posting a Task resource using:<code class="highlighter-rouge">POST [base]/Task/[id]{?_format=[mime-type]}</code></li><li>A Client <strong>SHALL</strong> be capable of putting an existing Task resource using:<code class="highlighter-rouge">PUT [base]/Task/[id]{?_format=[mime-type]}</code></li></ul><p>Fetch and Search Criteria:</p><ul><li>A Client <strong>SHALL</strong> be capable of fetching a Task resource using:<code class="highlighter-rouge">GET [base]/Task/[id]</code></li></ul></div>
</text>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
<valueCode value="cds"/>
</extension>
<url
value="http://hl7.org/fhir/us/davinci-dtr/CapabilityStatement/smart-dtr-client-311"/>
<version value="2.1.0-preview"/>
<name value="DTRSmartClient"/>
<title value="SMART on FHIR DTR Client"/>
<status value="active"/>
<experimental value="false"/>
<date value="2024-08-02"/>
<publisher value="HL7 International / Clinical Decision Support"/>
<contact>
<name value="HL7 International / Clinical Decision Support"/>
<telecom>
<system value="url"/>
<value value="http://www.hl7.org/Special/committees/dss"/>
</telecom>
</contact>
<description
value="This statement defines the expected capabilities of DTR SMART on FHIR applications for USCDI 1 (US-Core 3.1.1). Such apps require client support for retrieving and editing QuestionnaireResponse resources and related resources, as well as client support for the Questionnaire Package, ValueSet Expand, and Next Question operations."/>
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="US"/>
</coding>
</jurisdiction>
<kind value="requirements"/>
<imports
value="http://hl7.org/fhir/us/core/CapabilityStatement/us-core-client|3.1.1"/>
<fhirVersion value="4.0.1"/>
<format value="json"/>
<rest>
<mode value="client"/>
<documentation
value="A SMART on FHIR DTR Client provides an application conforming to the SMART on FHIR specification and related requirements declared in this Implementation Guide."/>
<security>
<description
value="Implementations **SHALL** meet the general security requirements documented in the <a href="https://build.fhir.org/ig/HL7/davinci-ehrx">HRex implementation guide</a>."/>
</security>
<resource>
<type value="QuestionnaireResponse"/>
<supportedProfile
value="http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/dtr-questionnaireresponse"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="read"/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="create"/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="update"/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="search-type"/>
</interaction>
<searchParam>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<name value="context"/>
<definition
value="http://hl7.org/fhir/us/davinci-dtr/SearchParameter/dtr-context"/>
<type value="reference"/>
<documentation
value="Allows retrieving QuestionnaireResponse for a context"/>
</searchParam>
<searchParam>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<name value="patient"/>
<type value="reference"/>
<documentation
value="Allows retrieving QuestionnaireResponse for a patient"/>
</searchParam>
</resource>
<resource>
<type value="Encounter"/>
<supportedProfile
value="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-encounter3.1"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="read"/>
</interaction>
</resource>
<resource>
<type value="DeviceRequest"/>
<supportedProfile
value="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-devicerequest"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="read"/>
</interaction>
</resource>
<resource>
<type value="MedicationRequest"/>
<supportedProfile
value="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-medicationrequest"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="read"/>
</interaction>
</resource>
<resource>
<type value="NutritionOrder"/>
<supportedProfile
value="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-nutritionorder"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="read"/>
</interaction>
</resource>
<resource>
<type value="CommunicationRequest"/>
<supportedProfile
value="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-communicationrequest"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="read"/>
</interaction>
</resource>
<resource>
<type value="ServiceRequest"/>
<supportedProfile
value="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-servicerequest"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="read"/>
</interaction>
</resource>
<resource>
<type value="VisionPrescription"/>
<supportedProfile
value="http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-visionprescription"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="read"/>
</interaction>
</resource>
<resource>
<type value="Task"/>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="read"/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="create"/>
</interaction>
<interaction>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<code value="update"/>
</interaction>
</resource>
<operation>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<name value="questionnaire-package"/>
<definition
value="http://hl7.org/fhir/us/davinci-dtr/OperationDefinition/questionnaire-package"/>
</operation>
<operation>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<name value="expand"/>
<definition
value="http://hl7.org/fhir/OperationDefinition/ValueSet-expand"/>
</operation>
<operation>
<extension
url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL"/>
</extension>
<name value="next-question"/>
<definition
value="http://hl7.org/fhir/uv/sdc/OperationDefinition/Questionnaire-next-question"/>
</operation>
</rest>
</CapabilityStatement>