Implementation Guide
ePA Medication Service
Version 1.3.0 - release

## : Get Medication Plan (eMP) - XML Representation

Active as of 2025-12-15

Raw xml | Download

    <OperationDefinition xmlns="http://hl7.org/fhir">
      <id value="get-medication-plan-op"/>
      <meta>
        <profile
                 value="https://gematik.de/fhir/ti/StructureDefinition/ti-operationdefinition"/>
      </meta>
      <text>
        <status value="generated"/>
        <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: OperationDefinition get-medication-plan-op</b></p><a name="get-medication-plan-op"> </a><a name="hcget-medication-plan-op"> </a><div style="display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%"><p style="margin-bottom: 0px"/><p style="margin-bottom: 0px">Profile: <a href="https://gematik.de/fhir/ti/1.2.0/StructureDefinition-ti-operationdefinition.html">OperationDefinition Profil für TI FHIR Data Service</a></p></div><p>URL: [base]/$medication-plan</p><h3>Parameters</h3><table class="grid"><tr><td><b>Use</b></td><td><b>Name</b></td><td><b>Scope</b></td><td><b>Cardinality</b></td><td><b>Type</b></td><td><b>Binding</b></td><td><b>Documentation</b></td></tr><tr><td>IN</td><td>provenance</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#uuid">uuid</a></td><td/><td><div><p>Die UUID der Provenance-Instanz, die eine bestimmte Version des elektronischen Medikationsplans (eMP) identifiziert. Diese Provenance-Instanz repräsentiert den Zustand zu einem bestimmten Zeitpunkt und bündelt die zu diesem Zeitpunkt aktiven eMP-Elemente. Wird kein provenance-Parameter angegeben, liefert die Operation den aktuellsten bekannten Zustand des eMP zurück.</p>
    </div></td></tr><tr><td>OUT</td><td>return</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/bundle.html">Bundle</a></td><td/><td><div><p>Ein Bundle vom Typ collection, das alle relevanten Ressourceninstanzen enthält, die zum angegebenen eMP-Zustand gehören. Diese Ressourcen stammen aus dem Datenraum des Medication Service und bilden gemeinsam den logischen Medikationsplan zum gewünschten Stand ab.</p>
    </div></td></tr></table></div>
      </text>
      <extension
                 url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-method">
        <valueCode value="GET"/>
      </extension>
      <url
           value="https://gematik.de/fhir/epa-medication/OperationDefinition/get-medication-plan-op"/>
      <version value="1.3.0"/>
      <name value="getMedicationPlan_MedicationSvc"/>
      <title value="Get Medication Plan (eMP)"/>
      <status value="active"/>
      <kind value="operation"/>
      <date value="2025-12-15"/>
      <publisher value="gematik GmbH"/>
      <contact>
        <name value="gematik GmbH"/>
        <telecom>
          <system value="url"/>
          <value value="https://www.gematik.de"/>
        </telecom>
        <telecom>
          <system value="email"/>
          <value value="patientteam [ at ] gematik.de"/>
        </telecom>
      </contact>
      <description
                   value="Diese Operation ermöglicht den gezielten Abruf eines elektronischen Medikationsplans (eMP) aus dem Datenraum des Medication Service. Der zurückgegebene Medikationsplan besteht aus einer Sammlung relevanter Ressourceninstanzen, die zu einem bestimmten Zeitpunkt gemeinsam gültig waren, sowie die zugehörige Versicherteninformation (Patient) aus dem Patient Service. Die Operation akzeptiert optional eine Provenance-Referenz.id als Eingabeparameter. Wird diese übergeben, liefert die Operation exakt den Zustand des Medikationsplans, wie er durch diese Provenance-Version beschrieben ist. So kann auch ein vergangener Stand des eMP nachvollziehbar wiedergegeben werden. Wird keine Provenance angegeben, gibt die Operation den aktuellsten Stand des Medikationsplans zurück - also die derzeit gültige Kombination aus aktiven und pausierten Medikationsdaten. Das Ergebnis ist ein Bundle vom Typ collection, das alle zugehörigen Ressourcendaten enthält."/>
      <jurisdiction>
        <coding>
          <system value="urn:iso:std:iso:3166"/>
          <code value="DE"/>
        </coding>
      </jurisdiction>
      <affectsState value="false"/>
      <code value="medication-plan"/>
      <system value="true"/>
      <type value="false"/>
      <instance value="false"/>
      <parameter>
        <name value="provenance"/>
        <use value="in"/>
        <min value="0"/>
        <max value="1"/>
        <documentation
                       value="Die UUID der Provenance-Instanz, die eine bestimmte Version des elektronischen Medikationsplans (eMP) identifiziert. Diese Provenance-Instanz repräsentiert den Zustand zu einem bestimmten Zeitpunkt und bündelt die zu diesem Zeitpunkt aktiven eMP-Elemente. Wird kein provenance-Parameter angegeben, liefert die Operation den aktuellsten bekannten Zustand des eMP zurück."/>
        <type value="uuid"/>
      </parameter>
      <parameter>
        <name value="return"/>
        <use value="out"/>
        <min value="1"/>
        <max value="1"/>
        <documentation
                       value="Ein Bundle vom Typ collection, das alle relevanten Ressourceninstanzen enthält, die zum angegebenen eMP-Zustand gehören. Diese Ressourcen stammen aus dem Datenraum des Medication Service und bilden gemeinsam den logischen Medikationsplan zum gewünschten Stand ab."/>
        <type value="Bundle"/>
      </parameter>
    </OperationDefinition>