Implementation Guide
E-T-Rezept Datenaustausch
Version 1.1.0-ballot-1 - ballot

: E-T-Rezept Structure Map for KBV PZN Medication - XML Representation

Draft as of 2025-07-07

Raw xml | Download


<StructureMap xmlns="http://hl7.org/fhir">
  <id value="ERPTPrescriptionStructureMapKBVPZNMedication"/>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: StructureMap ERPTPrescriptionStructureMapKBVPZNMedication</b></p><a name="ERPTPrescriptionStructureMapKBVPZNMedication"> </a><a name="hcERPTPrescriptionStructureMapKBVPZNMedication"> </a><pre class="fml">
<b>map</b><span style="color: navy"> &quot;</span>https://gematik.de/fhir/erp-t-prescription/StructureMap/ERPTPrescriptionStructureMapKBVPZNMedication<span style="color: navy">&quot; = &quot;</span>ERPTPrescriptionStructureMapKBVPZNMedication<span style="color: navy">&quot;

</span><span style="color: navy">// </span><span style="color: green">Mapping-Anweisungen zur Transformation von KBV PZN-Medikamenten zu BfArM T-Prescription Format</span>

<b>uses</b><span style="color: navy"> &quot;</span><a href="http://hl7.org/fhir/R4/medication.html" title="Medication">http://hl7.org/fhir/StructureDefinition/Medication</a><span style="color: navy">&quot; </span><b>alias </b>kbvMedicationPZN <b>as </b><b>source</b>
<b>uses</b><span style="color: navy"> &quot;</span><a href="http://hl7.org/fhir/R4/medication.html" title="Medication">http://hl7.org/fhir/StructureDefinition/Medication</a><span style="color: navy">&quot; </span><b>alias </b>bfarmMedication <b>as </b><b>target</b>

<span style="color: navy">// </span><span style="color: green">Mapping-Anweisungen zur Transformation von KBV PZN-Medikamenten zu BfArM T-Prescription Format</span>
<b>group </b>ERPTPrescriptionStructureMapKBVPZNMedication<span style="color: navy">(</span><b>source</b> <span style="color: maroon">kbvMedicationPZN</span><span style="color: navy"> : </span>kbvMedicationPZN, <b>target</b> <span style="color: maroon">bfarmMedication</span><span style="color: navy"> : </span>bfarmMedication<span style="color: navy">)</span><span style="color: navy"> {
</span>  kbvMedicationPZN.extension<b> as </b><span style="color: maroon">extVar</span><span style="color: navy"><b> -&gt; </b></span>bfarmMedication.extension<b> as </b><span style="color: maroon">tgtExtVar</span><b> then</b><span style="color: navy"> {
</span>    extVar<b> where </b>url='http://fhir.de/StructureDefinition/normgroesse'<span style="color: navy"><b> -&gt; </b></span>tgtExtVar.url = <span style="color: blue">'http://fhir.de/StructureDefinition/normgroesse'</span><b> then</b><span style="color: navy"> {
</span>      extVar.value<b> as </b><span style="color: maroon">extValVar</span><span style="color: navy"><b> -&gt; </b></span>tgtExtVar.value = <span style="color: maroon">extValVar</span> <i>&quot;copyExtensionValue&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Kopiert den Wert der Normgröße-Extension (N1, N2, N3)</span>
    <span style="color: navy">}</span> <i>&quot;copyNormgroesseExtensionUrl&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Übernimmt die Normgröße-Extension unverändert (deutsche Packungsgrößenangabe)</span>
  <span style="color: navy">}</span> <i>&quot;medicationExt&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Mappt Medication-Extensions von KBV- zu BfArM-Format</span>
  kbvMedicationPZN.id<b> as </b><span style="color: maroon">IdVar</span><span style="color: navy"><b> -&gt; </b></span>bfarmMedication.id = <span style="color: maroon">IdVar</span> <i>&quot;medicationId&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Übernimmt die eindeutige Medication-ID unverändert</span>
  kbvMedicationPZN.code<b> as </b><span style="color: maroon">codeVar</span><span style="color: navy"><b> -&gt; </b></span>bfarmMedication.code = <span style="color: maroon">codeVar</span> <i>&quot;medicationCode&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Kopiert den Medikamentencode (PZN - Pharmazentralnummer) für die eindeutige Identifikation</span>
  kbvMedicationPZN.form<b> as </b><span style="color: maroon">formVar</span><span style="color: navy"><b> -&gt; </b></span>bfarmMedication.form = <span style="color: maroon">formVar</span> <i>&quot;medicationForm&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Übernimmt die Darreichungsform (Tabletten, Kapseln, Tropfen, etc.)</span>
  kbvMedicationPZN.amount<b> as </b><span style="color: maroon">amountVar</span><span style="color: navy"><b> -&gt; </b></span>bfarmMedication.amount<b> as </b><span style="color: maroon">tgtAmountVar</span><b> then</b><span style="color: navy"> {
</span>    amountVar.denominator<b> as </b><span style="color: maroon">amountDenominatorVar</span><span style="color: navy"><b> -&gt; </b></span>tgtAmountVar.denominator = <span style="color: maroon">amountDenominatorVar</span> <i>&quot;medicationAmountDenominator&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Kopiert den Nenner der Mengenangabe (z.B. '1' für 'pro Packung')</span>
    amountVar.numerator<b> as </b><span style="color: maroon">amountNumeratorVar</span><span style="color: navy"><b> -&gt; </b></span>tgtAmountVar.numerator<b> as </b><span style="color: maroon">tgtAmountNumeratorVar</span><b> then</b><span style="color: navy"> {
</span>      amountNumeratorVar.extension<b> as </b><span style="color: maroon">amountNumExtVar</span><span style="color: navy"><b> -&gt; </b></span>tgtAmountNumeratorVar.extension<b> as </b><span style="color: maroon">tgtAmountNumExtVar</span><b> then</b><span style="color: navy"> {
</span>        amountNumExtVar<b> where </b>url='https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_PackagingSize'<span style="color: navy"><b> -&gt; </b></span>tgtAmountNumExtVar.url = <span style="color: blue">'https://gematik.de/fhir/epa-medication/StructureDefinition/medication-packaging-size-extension'</span><b> then</b><span style="color: navy"> {
</span>          amountNumExtVar.value<b> as </b><span style="color: maroon">extValVar</span><span style="color: navy"><b> -&gt; </b></span>tgtAmountNumExtVar.value = <span style="color: maroon">extValVar</span> <i>&quot;copyExtensionValue&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Übernimmt den Packungsgrößenwert unverändert</span>
        <span style="color: navy">}</span> <i>&quot;copyPackagingSizeExtensionUrl&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Wandelt KBV-Packungsgrößen-Extension in gematik EPA-Medication Extension um</span>
      <span style="color: navy">}</span> <i>&quot;medicationAmountExt&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Transformiert Packungsgrößen-Extensions von KBV- zu gematik-Format</span>
      amountNumeratorVar.value<b> as </b><span style="color: maroon">amountNumeratorValueVar</span><span style="color: navy"><b> -&gt; </b></span>tgtAmountNumeratorVar.value = <span style="color: maroon">amountNumeratorValueVar</span> <i>&quot;medicationAmountNumeratorValue&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Kopiert den numerischen Wert der Menge (z.B. '20' für 20 Tabletten)</span>
      amountNumeratorVar.unit<b> as </b><span style="color: maroon">amountNumeratorUnitVar</span><span style="color: navy"><b> -&gt; </b></span>tgtAmountNumeratorVar.unit = <span style="color: maroon">amountNumeratorUnitVar</span> <i>&quot;medicationAmountNumeratorUnit&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Übernimmt die Mengeneinheit (Stück, ml, g, etc.)</span>
      amountNumeratorVar.system<b> as </b><span style="color: maroon">amountNumeratorSystemVar</span><span style="color: navy"><b> -&gt; </b></span>tgtAmountNumeratorVar.system = <span style="color: maroon">amountNumeratorSystemVar</span> <i>&quot;medicationAmountNumeratorSystem&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Kopiert das Codesystem für die Mengeneinheit (meist UCUM)</span>
      amountNumeratorVar.code<b> as </b><span style="color: maroon">amountNumeratorCodeVar</span><span style="color: navy"><b> -&gt; </b></span>tgtAmountNumeratorVar.code = <span style="color: maroon">amountNumeratorCodeVar</span> <i>&quot;medicationAmountNumeratorCode&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Übernimmt den standardisierten Code für die Mengeneinheit</span>
    <span style="color: navy">}</span> <i>&quot;medicationAmountNumerator&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Mappt den Zähler der Mengenangabe mit allen Details (Wert, Einheit, Extensions)</span>
  <span style="color: navy">}</span> <i>&quot;medicationAmount&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Mappt die Mengenangaben des Fertigarzneimittels (Packungsgröße und Inhalt)</span>
  kbvMedicationPZN.ingredient<b> as </b><span style="color: maroon">ingredientVar</span><span style="color: navy"><b> -&gt; </b></span>bfarmMedication.ingredient = <span style="color: maroon">ingredientVar</span> <i>&quot;medicationIngredient&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Kopiert Wirkstoffinformationen (bei PZN-Medikamenten meist nicht detailliert angegeben)</span>
<span style="color: navy">}

</span></pre></div>
  </text>
  <url
       value="https://gematik.de/fhir/erp-t-prescription/StructureMap/ERPTPrescriptionStructureMapKBVPZNMedication"/>
  <version value="1.1.0-ballot-1"/>
  <name value="ERPTPrescriptionStructureMapKBVPZNMedication"/>
  <title value="E-T-Rezept Structure Map for KBV PZN Medication"/>
  <status value="draft"/>
  <experimental value="false"/>
  <date value="2025-07-07"/>
  <publisher value="gematik GmbH"/>
  <contact>
    <name value="gematik GmbH"/>
    <telecom>
      <system value="url"/>
      <value value="https://gematik.de"/>
    </telecom>
    <telecom>
      <system value="email"/>
      <value value="erp-umsetzung@gematik.de"/>
    </telecom>
  </contact>
  <description
               value="Mapping-Anweisungen zur Transformation von KBV PZN-Medikamenten zu BfArM T-Prescription Format"/>
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="DE"/>
      <display value="Germany"/>
    </coding>
  </jurisdiction>
  <structure>
    <url value="http://hl7.org/fhir/StructureDefinition/Medication"/>
    <mode value="source"/>
    <alias value="kbvMedicationPZN"/>
  </structure>
  <structure>
    <url value="http://hl7.org/fhir/StructureDefinition/Medication"/>
    <mode value="target"/>
    <alias value="bfarmMedication"/>
  </structure>
  <group>
    <name value="ERPTPrescriptionStructureMapKBVPZNMedication"/>
    <typeMode value="none"/>
    <documentation
                   value="Mapping-Anweisungen zur Transformation von KBV PZN-Medikamenten zu BfArM T-Prescription Format"/>
    <input>
      <name value="kbvMedicationPZN"/>
      <type value="kbvMedicationPZN"/>
      <mode value="source"/>
    </input>
    <input>
      <name value="bfarmMedication"/>
      <type value="bfarmMedication"/>
      <mode value="target"/>
    </input>
    <rule>
      <name value="medicationExt"/>
      <source>
        <context value="kbvMedicationPZN"/>
        <element value="extension"/>
        <variable value="extVar"/>
      </source>
      <target>
        <context value="bfarmMedication"/>
        <contextType value="variable"/>
        <element value="extension"/>
        <variable value="tgtExtVar"/>
      </target>
      <rule>
        <name value="copyNormgroesseExtensionUrl"/>
        <source>
          <context value="extVar"/>
          <condition
                     value="url='http://fhir.de/StructureDefinition/normgroesse'"/>
        </source>
        <target>
          <context value="tgtExtVar"/>
          <contextType value="variable"/>
          <element value="url"/>
          <transform value="copy"/>
          <parameter>
            <valueString
                         value="http://fhir.de/StructureDefinition/normgroesse"/>
          </parameter>
        </target>
        <rule>
          <name value="copyExtensionValue"/>
          <source>
            <context value="extVar"/>
            <element value="value"/>
            <variable value="extValVar"/>
          </source>
          <target>
            <context value="tgtExtVar"/>
            <contextType value="variable"/>
            <element value="value"/>
            <transform value="copy"/>
            <parameter>
              <valueId value="extValVar"/>
            </parameter>
          </target>
          <documentation
                         value="Kopiert den Wert der Normgröße-Extension (N1, N2, N3)"/>
        </rule>
        <documentation
                       value="Übernimmt die Normgröße-Extension unverändert (deutsche Packungsgrößenangabe)"/>
      </rule>
      <documentation
                     value="Mappt Medication-Extensions von KBV- zu BfArM-Format"/>
    </rule>
    <rule>
      <name value="medicationId"/>
      <source>
        <context value="kbvMedicationPZN"/>
        <element value="id"/>
        <variable value="IdVar"/>
      </source>
      <target>
        <context value="bfarmMedication"/>
        <contextType value="variable"/>
        <element value="id"/>
        <transform value="copy"/>
        <parameter>
          <valueId value="IdVar"/>
        </parameter>
      </target>
      <documentation
                     value="Übernimmt die eindeutige Medication-ID unverändert"/>
    </rule>
    <rule>
      <name value="medicationCode"/>
      <source>
        <context value="kbvMedicationPZN"/>
        <element value="code"/>
        <variable value="codeVar"/>
      </source>
      <target>
        <context value="bfarmMedication"/>
        <contextType value="variable"/>
        <element value="code"/>
        <transform value="copy"/>
        <parameter>
          <valueId value="codeVar"/>
        </parameter>
      </target>
      <documentation
                     value="Kopiert den Medikamentencode (PZN - Pharmazentralnummer) für die eindeutige Identifikation"/>
    </rule>
    <rule>
      <name value="medicationForm"/>
      <source>
        <context value="kbvMedicationPZN"/>
        <element value="form"/>
        <variable value="formVar"/>
      </source>
      <target>
        <context value="bfarmMedication"/>
        <contextType value="variable"/>
        <element value="form"/>
        <transform value="copy"/>
        <parameter>
          <valueId value="formVar"/>
        </parameter>
      </target>
      <documentation
                     value="Übernimmt die Darreichungsform (Tabletten, Kapseln, Tropfen, etc.)"/>
    </rule>
    <rule>
      <name value="medicationAmount"/>
      <source>
        <context value="kbvMedicationPZN"/>
        <element value="amount"/>
        <variable value="amountVar"/>
      </source>
      <target>
        <context value="bfarmMedication"/>
        <contextType value="variable"/>
        <element value="amount"/>
        <variable value="tgtAmountVar"/>
      </target>
      <rule>
        <name value="medicationAmountDenominator"/>
        <source>
          <context value="amountVar"/>
          <element value="denominator"/>
          <variable value="amountDenominatorVar"/>
        </source>
        <target>
          <context value="tgtAmountVar"/>
          <contextType value="variable"/>
          <element value="denominator"/>
          <transform value="copy"/>
          <parameter>
            <valueId value="amountDenominatorVar"/>
          </parameter>
        </target>
        <documentation
                       value="Kopiert den Nenner der Mengenangabe (z.B. '1' für 'pro Packung')"/>
      </rule>
      <rule>
        <name value="medicationAmountNumerator"/>
        <source>
          <context value="amountVar"/>
          <element value="numerator"/>
          <variable value="amountNumeratorVar"/>
        </source>
        <target>
          <context value="tgtAmountVar"/>
          <contextType value="variable"/>
          <element value="numerator"/>
          <variable value="tgtAmountNumeratorVar"/>
        </target>
        <rule>
          <name value="medicationAmountExt"/>
          <source>
            <context value="amountNumeratorVar"/>
            <element value="extension"/>
            <variable value="amountNumExtVar"/>
          </source>
          <target>
            <context value="tgtAmountNumeratorVar"/>
            <contextType value="variable"/>
            <element value="extension"/>
            <variable value="tgtAmountNumExtVar"/>
          </target>
          <rule>
            <name value="copyPackagingSizeExtensionUrl"/>
            <source>
              <context value="amountNumExtVar"/>
              <condition
                         value="url='https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_PackagingSize'"/>
            </source>
            <target>
              <context value="tgtAmountNumExtVar"/>
              <contextType value="variable"/>
              <element value="url"/>
              <transform value="copy"/>
              <parameter>
                <valueString
                             value="https://gematik.de/fhir/epa-medication/StructureDefinition/medication-packaging-size-extension"/>
              </parameter>
            </target>
            <rule>
              <name value="copyExtensionValue"/>
              <source>
                <context value="amountNumExtVar"/>
                <element value="value"/>
                <variable value="extValVar"/>
              </source>
              <target>
                <context value="tgtAmountNumExtVar"/>
                <contextType value="variable"/>
                <element value="value"/>
                <transform value="copy"/>
                <parameter>
                  <valueId value="extValVar"/>
                </parameter>
              </target>
              <documentation
                             value="Übernimmt den Packungsgrößenwert unverändert"/>
            </rule>
            <documentation
                           value="Wandelt KBV-Packungsgrößen-Extension in gematik EPA-Medication Extension um"/>
          </rule>
          <documentation
                         value="Transformiert Packungsgrößen-Extensions von KBV- zu gematik-Format"/>
        </rule>
        <rule>
          <name value="medicationAmountNumeratorValue"/>
          <source>
            <context value="amountNumeratorVar"/>
            <element value="value"/>
            <variable value="amountNumeratorValueVar"/>
          </source>
          <target>
            <context value="tgtAmountNumeratorVar"/>
            <contextType value="variable"/>
            <element value="value"/>
            <transform value="copy"/>
            <parameter>
              <valueId value="amountNumeratorValueVar"/>
            </parameter>
          </target>
          <documentation
                         value="Kopiert den numerischen Wert der Menge (z.B. '20' für 20 Tabletten)"/>
        </rule>
        <rule>
          <name value="medicationAmountNumeratorUnit"/>
          <source>
            <context value="amountNumeratorVar"/>
            <element value="unit"/>
            <variable value="amountNumeratorUnitVar"/>
          </source>
          <target>
            <context value="tgtAmountNumeratorVar"/>
            <contextType value="variable"/>
            <element value="unit"/>
            <transform value="copy"/>
            <parameter>
              <valueId value="amountNumeratorUnitVar"/>
            </parameter>
          </target>
          <documentation
                         value="Übernimmt die Mengeneinheit (Stück, ml, g, etc.)"/>
        </rule>
        <rule>
          <name value="medicationAmountNumeratorSystem"/>
          <source>
            <context value="amountNumeratorVar"/>
            <element value="system"/>
            <variable value="amountNumeratorSystemVar"/>
          </source>
          <target>
            <context value="tgtAmountNumeratorVar"/>
            <contextType value="variable"/>
            <element value="system"/>
            <transform value="copy"/>
            <parameter>
              <valueId value="amountNumeratorSystemVar"/>
            </parameter>
          </target>
          <documentation
                         value="Kopiert das Codesystem für die Mengeneinheit (meist UCUM)"/>
        </rule>
        <rule>
          <name value="medicationAmountNumeratorCode"/>
          <source>
            <context value="amountNumeratorVar"/>
            <element value="code"/>
            <variable value="amountNumeratorCodeVar"/>
          </source>
          <target>
            <context value="tgtAmountNumeratorVar"/>
            <contextType value="variable"/>
            <element value="code"/>
            <transform value="copy"/>
            <parameter>
              <valueId value="amountNumeratorCodeVar"/>
            </parameter>
          </target>
          <documentation
                         value="Übernimmt den standardisierten Code für die Mengeneinheit"/>
        </rule>
        <documentation
                       value="Mappt den Zähler der Mengenangabe mit allen Details (Wert, Einheit, Extensions)"/>
      </rule>
      <documentation
                     value="Mappt die Mengenangaben des Fertigarzneimittels (Packungsgröße und Inhalt)"/>
    </rule>
    <rule>
      <name value="medicationIngredient"/>
      <source>
        <context value="kbvMedicationPZN"/>
        <element value="ingredient"/>
        <variable value="ingredientVar"/>
      </source>
      <target>
        <context value="bfarmMedication"/>
        <contextType value="variable"/>
        <element value="ingredient"/>
        <transform value="copy"/>
        <parameter>
          <valueId value="ingredientVar"/>
        </parameter>
      </target>
      <documentation
                     value="Kopiert Wirkstoffinformationen (bei PZN-Medikamenten meist nicht detailliert angegeben)"/>
    </rule>
  </group>
</StructureMap>