<?xml version="1.0" encoding="UTF-8"?>

<CapabilityStatement xmlns="http://hl7.org/fhir">
  <id value="MedicationOverviewConsumer"/>
  <text>
    <status value="extensions"/><div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: CapabilityStatement MedicationOverviewConsumer</b></p><a name="MedicationOverviewConsumer"> </a><a name="hcMedicationOverviewConsumer"> </a><h2 id="title">Medication Overview Consumer</h2><ul><li>Implementation Guide Version: 1.0.0-preview </li><li>FHIR Version: 4.0.1 </li><li>Supported Formats: <code>application/fhir+json</code>, <code>application/fhir+xml</code></li><li>Published on: 2025-01-01 </li><li>Published by: Integrating the Healthcare Enterprise (IHE) </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>client</code></h3></div><div class="panel-body"><div><p>The Consumer initiates PHARM-11 queries to retrieve MedicationTreatmentLine resources
and optionally related resources for a given patient.
The Consumer optionally initiates PHARM-12 requests to retrieve MedicationOverviewBundle
documents (Document Option).</p>
</div></div></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="#MedicationStatement1-1">MedicationStatement</a></td><td>Supported Profiles<br/>  <a href="StructureDefinition-MedicationTreatmentLine.html">Medication Treatment Line</a></td><td class="text-center">y</td><td class="text-center">y</td><td class="text-center"/><td class="text-center"/><td>patient, status, effective, category, _lastUpdated</td><td><code>MedicationStatement:medication</code>, <code>MedicationStatement:derivedFrom</code>, <code>MedicationStatement:partOf</code></td><td><code>MedicationDispense:prescription</code>, <code>MedicationAdministration:request</code></td><td/></tr><tr><td><a href="#Bundle1-2">Bundle</a></td><td>Supported Profiles<br/>  <a href="StructureDefinition-MedicationOverview.html">Medication Overview Bundle</a></td><td class="text-center">y</td><td class="text-center">y</td><td class="text-center"/><td class="text-center"/><td>type, patient, date</td><td/><td/><td/></tr></tbody></table></div><hr/><div class="panel panel-default"><div class="panel-heading"><h4 id="MedicationStatement1-1" class="panel-title"><span style="float: right;">Resource Conformance: unspecified </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>Supports <code>search-type</code>, <code>read</code>.</li></ul></div></div><p/><div class="row"><div class="col-6"><span class="lead">Supported Profiles</span><p><a href="StructureDefinition-MedicationTreatmentLine.html">Medication Treatment Line</a></p></div></div><p/><div class="row"><div class="col-12"><span class="lead">Documentation</span><blockquote><div><p>The Consumer searches for MedicationTreatmentLine resources (PHARM-11).</p>
</div></blockquote></div></div><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>patient</td><td><code>reference</code></td><td><div><p>Required. The patient whose medication overview is requested.</p>
</div></td></tr><tr><td><b>SHALL</b></td><td>status</td><td><code>token</code></td><td><div><p>Filter by treatment line status (e.g. active, completed, stopped).</p>
</div></td></tr><tr><td><b>SHALL</b></td><td>effective</td><td><code>date</code></td><td><div><p>Filter by effective period of the treatment line.</p>
</div></td></tr><tr><td><b>SHALL</b></td><td>category</td><td><code>token</code></td><td><div><p>Filter by medication list category / list type.</p>
</div></td></tr><tr><td><b>SHALL</b></td><td>_lastUpdated</td><td><code>date</code></td><td><div><p>Filter resources updated since a given instant (incremental sync).</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-2" class="panel-title"><span style="float: right;">Resource Conformance: unspecified </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>Supports <code>read</code>, <code>search-type</code>.</li></ul></div></div><p/><div class="row"><div class="col-6"><span class="lead">Supported Profiles</span><p><a href="StructureDefinition-MedicationOverview.html">Medication Overview Bundle</a></p></div></div><p/><div class="row"><div class="col-12"><span class="lead">Documentation</span><blockquote><div><p>Document Option (PHARM-12). The Consumer retrieves MedicationOverviewBundle documents
by logical id or by searching with patient, type, and date parameters.</p>
</div></blockquote></div></div><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>type</td><td><code>token</code></td><td><div><p>Filter by document type / medication list category.</p>
</div></td></tr><tr><td><b>SHALL</b></td><td>patient</td><td><code>reference</code></td><td><div><p>Required for patient-scoped document search.</p>
</div></td></tr><tr><td><b>SHALL</b></td><td>date</td><td><code>date</code></td><td><div><p>Filter by document creation date.</p>
</div></td></tr></tbody></table></div><div class="col-lg-5"> </div></div></div></div></div></div>
  </text>
  <url value="https://profiles.ihe.net/PHARM/MEOW/CapabilityStatement/MedicationOverviewConsumer"/>
  <version value="1.0.0-preview"/>
  <name value="MedicationOverviewConsumer"/>
  <title value="Medication Overview Consumer"/>
  <status value="active"/>
  <experimental value="false"/>
  <date value="2025-01-01"/>
  <publisher value="Integrating the Healthcare Enterprise (IHE)"/>
  <contact>
    <name value="Integrating the Healthcare Enterprise (IHE)"/>
    <telecom>
      <system value="url"/>
      <value value="http://ihe.net"/>
    </telecom>
    <telecom>
      <system value="email"/>
      <value value="secretary@ihe.net"/>
    </telecom>
  </contact>
  <contact>
    <name value="Jose Costa Teixeira"/>
    <telecom>
      <system value="email"/>
      <value value="jose.a.teixeira@gmail.com"/>
      <use value="work"/>
    </telecom>
  </contact>
  <description value="CapabilityStatement for the Medication Overview Consumer actor in the IHE PHARM MEOW profile.&#xA;&#xA;The Consumer is a client that queries a Medication Overview Repository or Creator to retrieve&#xA;a patient's medication overview. It supports PHARM-11 (Query Medication Resources) as a&#xA;required capability, and optionally PHARM-12 (Retrieve Medication Document) when the&#xA;Document Option is declared."/>
  <jurisdiction>
    <coding>
      <system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>
      <code value="001"/>
    </coding>
  </jurisdiction>
  <copyright value="IHE http://www.ihe.net/Governance/#Intellectual_Property"/>
  <kind value="requirements"/>
  <fhirVersion value="4.0.1"/>
  <format value="application/fhir+json"/>
  <format value="application/fhir+xml"/>
  <rest>
    <mode value="client"/>
    <documentation value="The Consumer initiates PHARM-11 queries to retrieve MedicationTreatmentLine resources&#xA;and optionally related resources for a given patient.&#xA;The Consumer optionally initiates PHARM-12 requests to retrieve MedicationOverviewBundle&#xA;documents (Document Option)."/>
    <resource>
      <type value="MedicationStatement"/>
      <supportedProfile value="https://profiles.ihe.net/PHARM/MEOW/StructureDefinition/MedicationTreatmentLine"/>
      <documentation value="The Consumer searches for MedicationTreatmentLine resources (PHARM-11)."/>
      <interaction>
        <code value="search-type"/>
      </interaction>
      <interaction>
        <code value="read"/>
      </interaction>
      <searchInclude value="MedicationStatement:medication"/>
      <searchInclude value="MedicationStatement:derivedFrom"/>
      <searchInclude value="MedicationStatement:partOf"/>
      <searchRevInclude value="MedicationDispense:prescription"/>
      <searchRevInclude value="MedicationAdministration:request"/>
      <searchParam>
        <name value="patient"/>
        <type value="reference"/>
        <documentation value="Required. The patient whose medication overview is requested."/>
      </searchParam>
      <searchParam>
        <name value="status"/>
        <type value="token"/>
        <documentation value="Filter by treatment line status (e.g. active, completed, stopped)."/>
      </searchParam>
      <searchParam>
        <name value="effective"/>
        <type value="date"/>
        <documentation value="Filter by effective period of the treatment line."/>
      </searchParam>
      <searchParam>
        <name value="category"/>
        <type value="token"/>
        <documentation value="Filter by medication list category / list type."/>
      </searchParam>
      <searchParam>
        <name value="_lastUpdated"/>
        <type value="date"/>
        <documentation value="Filter resources updated since a given instant (incremental sync)."/>
      </searchParam>
    </resource>
    <resource>
      <type value="Bundle"/>
      <supportedProfile value="https://profiles.ihe.net/PHARM/MEOW/StructureDefinition/MedicationOverview"/>
      <documentation value="Document Option (PHARM-12). The Consumer retrieves MedicationOverviewBundle documents&#xA;by logical id or by searching with patient, type, and date parameters."/>
      <interaction>
        <code value="read"/>
      </interaction>
      <interaction>
        <code value="search-type"/>
      </interaction>
      <searchParam>
        <name value="type"/>
        <type value="token"/>
        <documentation value="Filter by document type / medication list category."/>
      </searchParam>
      <searchParam>
        <name value="patient"/>
        <type value="reference"/>
        <documentation value="Required for patient-scoped document search."/>
      </searchParam>
      <searchParam>
        <name value="date"/>
        <type value="date"/>
        <documentation value="Filter by document creation date."/>
      </searchParam>
    </resource>
  </rest>
</CapabilityStatement>