Implementation Guide
ePA Medication Service
Version 1.2.0-ballot.2 - draft

## : ExampleEPABatchEmpRequestBundle - XML Representation

Raw xml | Download

    <Bundle xmlns="http://hl7.org/fhir">
      <id value="example-epa-batch-emp-request-bundle"/>
      <meta>
        <profile
                 value="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-batch-emp-request-bundle"/>
      </meta>
      <type value="transaction"/>
      <entry>
        <fullUrl value="urn:uuid:42a697f3-3989-4be8-bf27-92c05a025e79"/>
        <resource>
          <Parameters>
            <id value="517301af-f07c-4694-9780-451132352d95"/>
            <meta>
              <profile
                       value="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-op-add-emp-entry-input-parameters"/>
            </meta>
            <parameter>
              <name value="empEntry"/>
              <resource>
                <MedicationRequest>
                  <id value="881f3c6d-20e6-443e-b7dc-580a40fa3d14"/>
                  <meta>
                    <profile
                             value="https://gematik.de/fhir/epa-medication/StructureDefinition/emp-medication-request"/>
                  </meta>
                  <extension
                             url="https://gematik.de/fhir/epa-medication/StructureDefinition/context-extension">
                    <valueCode value="EMP"/>
                  </extension>
                  <extension
                             url="https://gematik.de/fhir/epa-medication/StructureDefinition/reason-patient-instruction-extension">
                    <valueString value="Bluthochdruck"/>
                  </extension>
                  <extension
                             url="https://gematik.de/fhir/epa-medication/StructureDefinition/patient-note-extension">
                    <valueAnnotation>
                      <text
                            value="Benazepril kann anfangs Schwindel verursachen - daher zuerst in Ruhe einnehmen und Autofahren vermeiden."/>
                    </valueAnnotation>
                  </extension>
                  <extension
                             url="http://hl7.org/fhir/5.0/StructureDefinition/extension-MedicationRequest.effectiveDosePeriod">
                    <valuePeriod>
                      <start value="2026-12-01"/>
                    </valuePeriod>
                  </extension>
                  <status value="active"/>
                  <intent value="plan"/>
                  <medicationReference>
                    <reference
                               value="Medication/1193c409-3df4-4b55-b672-811665aaa1b7"/>
                  </medicationReference>
                  <subject>
                    <identifier>
                      <system value="http://fhir.de/sid/gkv/kvid-10"/>
                      <value value="X110411319"/>
                    </identifier>
                  </subject>
                  <authoredOn value="2026-12-01"/>
                  <note>
                    <text value="Hinweis für den LE"/>
                  </note>
                  <dosageInstruction>
                    <extension
                               url="http://ig.fhir.de/igs/medication/StructureDefinition/GeneratedDosageInstructions">
                      <extension url="algorithm">
                        <valueCoding>
                          <system
                                  value="http://ig.fhir.de/igs/medication/CodeSystem/DosageTextAlgorithm"/>
                          <version value="1.0.0"/>
                          <code value="GematikDosageTextGenerator"/>
                        </valueCoding>
                      </extension>
                      <extension url="algorithmVersion">
                        <valueString value="1.0.0"/>
                      </extension>
                      <extension url="language">
                        <valueCode value="de-DE"/>
                      </extension>
                      <extension url="text">
                        <valueString
                                     value="2 x täglich: morgens und abends — je 1 Stück"/>
                      </extension>
                    </extension>
                    <timing>
                      <repeat>
                        <frequency value="2"/>
                        <period value="1"/>
                        <periodUnit value="d"/>
                        <when value="MORN"/>
                        <when value="EVE"/>
                      </repeat>
                    </timing>
                    <doseAndRate>
                      <doseQuantity>
                        <value value="1"/>
                        <unit value="Stück"/>
                        <system
                                value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BMP_DOSIEREINHEIT"/>
                        <code value="1"/>
                      </doseQuantity>
                    </doseAndRate>
                  </dosageInstruction>
                </MedicationRequest>
              </resource>
            </parameter>
            <parameter>
              <name value="medication"/>
              <resource>
                <Medication>
                  <id value="1193c409-3df4-4b55-b672-811665aaa1b7"/>
                  <meta>
                    <profile
                             value="https://gematik.de/fhir/epa-medication/StructureDefinition/emp-medication"/>
                  </meta>
                  <extension
                             url="https://gematik.de/fhir/epa-medication/StructureDefinition/context-extension">
                    <valueCode value="EMP"/>
                  </extension>
                  <extension
                             url="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-type-extension">
                    <valueCoding>
                      <system value="http://snomed.info/sct"/>
                      <code value="763158003"/>
                      <display value="Medicinal product (product)"/>
                    </valueCoding>
                  </extension>
                  <extension
                             url="https://gematik.de/fhir/epa-medication/StructureDefinition/drug-category-extension">
                    <valueCoding>
                      <system
                              value="https://gematik.de/fhir/epa-medication/CodeSystem/epa-drug-category-cs"/>
                      <code value="00"/>
                    </valueCoding>
                  </extension>
                  <extension
                             url="http://fhir.de/StructureDefinition/normgroesse">
                    <valueCode value="N3"/>
                  </extension>
                  <extension
                             url="https://gematik.de/fhir/epa-medication/StructureDefinition/medication-id-vaccine-extension">
                    <valueBoolean value="false"/>
                  </extension>
                  <code>
                    <coding>
                      <system value="http://fhir.de/CodeSystem/ifa/pzn"/>
                      <code value="04351736"/>
                      <display value="Benazepril AL 20mg 98 Filmtabletten N3"/>
                    </coding>
                    <text value="Benazepril AL 20mg 98 Filmtabletten N3"/>
                  </code>
                  <status value="active"/>
                  <form>
                    <coding>
                      <system
                              value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM"/>
                      <code value="FTA"/>
                    </coding>
                  </form>
                  <amount>
                    <numerator>
                      <extension
                                 url="https://gematik.de/fhir/epa-medication/StructureDefinition/medication-total-quantity-formulation-extension">
                        <valueString value="98"/>
                      </extension>
                      <unit value="Stück"/>
                    </numerator>
                    <denominator>
                      <value value="1"/>
                    </denominator>
                  </amount>
                  <ingredient>
                    <itemCodeableConcept>
                      <coding>
                        <system value="http://fhir.de/CodeSystem/ask"/>
                        <code value="23413"/>
                      </coding>
                      <text value="Benazepril hydrochlorid"/>
                    </itemCodeableConcept>
                    <strength>
                      <numerator>
                        <value value="20"/>
                        <unit value="mg"/>
                      </numerator>
                      <denominator>
                        <value value="1"/>
                        <unit value="Filmtbl."/>
                      </denominator>
                    </strength>
                  </ingredient>
                </Medication>
              </resource>
            </parameter>
          </Parameters>
        </resource>
        <request>
          <method value="POST"/>
          <url value="$add-emp-entry"/>
        </request>
      </entry>
      <entry>
        <fullUrl value="urn:uuid:cae0c349-08bc-4fe5-9233-ca5a9a4c4673"/>
        <resource>
          <Parameters>
            <id value="7ccb2670-7178-4f82-912a-de70f68ecd51"/>
            <meta>
              <profile
                       value="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-op-update-emp-entry-input-parameters"/>
            </meta>
            <parameter>
              <name value="medicationPlanIdentifier"/>
              <valueIdentifier>
                <system value="https://gematik.de/fhir/sid/emp-identifier"/>
                <value value="266620a9-2c26-41c1-b0cb-a10947b867f5"/>
              </valueIdentifier>
            </parameter>
            <parameter>
              <name value="empEntry"/>
              <resource>
                <MedicationRequest>
                  <id value="266620a9-2c26-41c1-b0cb-a10947b867f5"/>
                  <meta>
                    <versionId value="2"/>
                    <lastUpdated value="2026-11-01T15:43:33.244Z"/>
                    <profile
                             value="https://gematik.de/fhir/epa-medication/StructureDefinition/emp-medication-request"/>
                  </meta>
                  <extension
                             url="https://gematik.de/fhir/epa-medication/StructureDefinition/context-extension">
                    <valueCode value="EMP"/>
                  </extension>
                  <extension
                             url="https://gematik.de/fhir/epa-medication/StructureDefinition/reason-patient-instruction-extension">
                    <valueString
                                 value="akuten Behandlung von Migräneanfällen mit und ohne Aura"/>
                  </extension>
                  <extension
                             url="https://gematik.de/fhir/epa-medication/StructureDefinition/patient-note-extension">
                    <valueAnnotation>
                      <text
                            value="Bitte schützen Sie das Arzneimittel vor hohen Temperaturen und direkter Sonneneinstrahlung."/>
                    </valueAnnotation>
                  </extension>
                  <extension
                             url="http://hl7.org/fhir/5.0/StructureDefinition/extension-MedicationRequest.effectiveDosePeriod">
                    <valuePeriod>
                      <start value="2027-02-01"/>
                    </valuePeriod>
                  </extension>
                  <extension
                             url="https://gematik.de/fhir/epa-medication/StructureDefinition/emp-medicationrequest-activity-extension">
                    <valueReference>🔗
                      <reference
                                 value="MedicationStatement/f29f1d0c-be05-4b0d-a335-3e508da39c0c"/>
                    </valueReference>
                  </extension>
                  <identifier>
                    <system value="https://gematik.de/fhir/sid/emp-identifier"/>
                    <value value="266620a9-2c26-41c1-b0cb-a10947b867f5"/>
                  </identifier>
                  <status value="active"/>
                  <intent value="plan"/>
                  <medicationReference>🔗
                    <reference
                               value="Medication/87f08ba2-da7e-467e-86aa-404d9035297c"/>
                  </medicationReference>
                  <subject>
                    <identifier>
                      <system value="http://fhir.de/sid/gkv/kvid-10"/>
                      <value value="X110411319"/>
                    </identifier>
                  </subject>
                  <authoredOn value="2026-11-01"/>
                  <note>
                    <text value="Hinweis für den LE"/>
                  </note>
                  <dosageInstruction>
                    <extension
                               url="http://ig.fhir.de/igs/medication/StructureDefinition/GeneratedDosageInstructions">
                      <extension url="algorithm">
                        <valueCoding>
                          <system
                                  value="http://ig.fhir.de/igs/medication/CodeSystem/DosageTextAlgorithm"/>
                          <version value="1.0.0"/>
                          <code value="GematikDosageTextGenerator"/>
                        </valueCoding>
                      </extension>
                      <extension url="algorithmVersion">
                        <valueString value="1.0.0"/>
                      </extension>
                      <extension url="language">
                        <valueCode value="de-DE"/>
                      </extension>
                      <extension url="text">
                        <valueString value="täglich: morgens — je 1 Stück"/>
                      </extension>
                    </extension>
                    <timing>
                      <repeat>
                        <frequency value="1"/>
                        <period value="1"/>
                        <periodUnit value="d"/>
                        <when value="MORN"/>
                      </repeat>
                    </timing>
                    <doseAndRate>
                      <doseQuantity>
                        <value value="1"/>
                        <unit value="Stück"/>
                        <system
                                value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BMP_DOSIEREINHEIT"/>
                        <code value="1"/>
                      </doseQuantity>
                    </doseAndRate>
                  </dosageInstruction>
                </MedicationRequest>
              </resource>
            </parameter>
          </Parameters>
        </resource>
        <request>
          <method value="POST"/>
          <url value="$update-emp-entry"/>
        </request>
      </entry>
      <entry>
        <fullUrl value="urn:uuid:ba863a1b-f6bc-45f7-92ba-cc8bf79cf8c2"/>
        <resource>
          <Parameters>
            <id value="4beaf1af-daec-4c7a-930d-c2062517b42c"/>
            <meta>
              <profile
                       value="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-op-rmp-commit-input-parameters"/>
            </meta>
            <parameter>
              <name value="acknowledgedChronologyId"/>
              <valueId value="b467ce05-e0e5-4d71-9a0b-d824dbb492ef"/>
            </parameter>
          </Parameters>
        </resource>
        <request>
          <method value="POST"/>
          <url value="$emp-commit"/>
        </request>
      </entry>
    </Bundle>