Implementation Guide
ePA Medication Service
Version 1.2.0 - release

: Batch eMP Einträge - XML Representation

Active as of 2025-09-12

Raw xml | Download


<OperationDefinition xmlns="http://hl7.org/fhir">
  <id value="batch-emp-entries-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 batch-emp-entries-op</b></p><a name="batch-emp-entries-op"> </a><a name="hcbatch-emp-entries-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://simplifier.net/resolve?scope=de.gematik.ti@1.1.1&amp;canonical=https://gematik.de/fhir/ti/StructureDefinition/ti-operationdefinition">OperationDefinition Profil für TI FHIR Data Service</a></p></div><p>URL: [base]/$batch-emp</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>resource</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/bundle.html">Bundle</a></td><td/><td><div><p>FHIR-Bundle vom Typ transaction gemäß des Profils gemäß EPABatchEmpRequestBundle.
Die Ausführungssemantik ist serverseitig festgelegt. Verboten: direkte POST/PUT/DELETE auf Ressourcen außerhalb von Operationen.</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>Antwort ist ein Bundle vom Typ transaction-response (bei atomarer Server-Policy.
Für jeden Request-Entry enthält die Antwort einen korrespondierenden Entry mit:</p>
<ul>
<li>response.status (HTTP-Status),</li>
<li>resource = Parameters (Ergebnisse von $add-emp-entry / $update-emp-entry),</li>
<li>beim letzten Eintrag ($emp-commit): eine Provenance-Instanz (neue eMP-Plan-Version).</li>
</ul>
</div></td></tr></table></div>
  </text>
  <extension
             url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-method">
    <valueCode value="POST"/>
  </extension>
  <url
       value="https://gematik.de/fhir/epa-medication/OperationDefinition/batch-emp-entries-op"/>
  <version value="1.2.0"/>
  <name value="batchEMPEntries_MedicationSvc"/>
  <title value="Batch eMP Einträge"/>
  <status value="active"/>
  <kind value="operation"/>
  <date value="2025-09-12"/>
  <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="Mit der Batch Operation $batch-emp können Primärsysteme mehrere fachliche Änderungen am eMP in einem Aufruf
an den Medication Service übergeben. Innerhalb des Request-Bundles werden ausschließlich FHIR-Operationen
ausgeführt (keine direkten Resource-CRUDs). Am Ende wird ein emp-commit ausgeführt, der eine neue
Plan-Version (Provenance) erzeugt. Die Operation antwortet mit einem Bundle vom Typ transaction-response."/>
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="DE"/>
    </coding>
  </jurisdiction>
  <purpose
           value="Stapelverarbeitung von eMP-Änderungen mit konsistenter, atomarer Ausführung und anschließender
Versionierung des eMP. Reduziert Roundtrips, vermeidet Zwischenzustände und stellt eine neue Plan-Version bereit."/>
  <affectsState value="true"/>
  <code value="batch-emp"/>
  <system value="true"/>
  <type value="false"/>
  <instance value="false"/>
  <parameter>
    <name value="resource"/>
    <use value="in"/>
    <min value="1"/>
    <max value="1"/>
    <documentation
                   value="FHIR-Bundle vom Typ transaction gemäß des Profils gemäß EPABatchEmpRequestBundle.
Die Ausführungssemantik ist serverseitig festgelegt. Verboten: direkte POST/PUT/DELETE auf Ressourcen außerhalb von Operationen."/>
    <type value="Bundle"/>
  </parameter>
  <parameter>
    <name value="return"/>
    <use value="out"/>
    <min value="1"/>
    <max value="1"/>
    <documentation
                   value="Antwort ist ein Bundle vom Typ transaction-response (bei atomarer Server-Policy. 
Für jeden Request-Entry enthält die Antwort einen korrespondierenden Entry mit:
- response.status (HTTP-Status),
- resource = Parameters (Ergebnisse von $add-emp-entry / $update-emp-entry),
- beim letzten Eintrag ($emp-commit): eine Provenance-Instanz (neue eMP-Plan-Version)."/>
    <type value="Bundle"/>
  </parameter>
</OperationDefinition>