Implementation Guide
TIFlow - Verordnungen für Arzneimittel
Version 2.0.0-ballot.2 - ballot

## Mapping einer Wirkstoff Medikation

Diese Seite beschreibt Anforderungen und Umsetzungsunterstützung für das Mapping von

- KBV Medication (Wirkstoff) (aus dem KBV_PR_ERP_Bundle)
- zur EPA Medication.

## Wichtige Punkte beim Mapping der Wirkstoff Medication Ressource

Die folgenden Punkte sind relevant für das Mapping der Wirkstoff Medication Ressource:

- `Medication.extension:type` soll nach Möglichkeit erzeugt und korrekt belegt werden (F_020)

## Generelles Mapping des Profils

Die folgende Tabelle stellt generell das Mapping der beiden Profile gegenüber:

### Feld-Mappings

Quelle (Eingangsdaten) | Ziel (Ausgabedaten) | Aktion | Transformation & Beschreibung
--- | --- | --- | ---
`KBVPRERPMedicationIngredient` | `EPAMedication.extension` | Nicht Übertragen | Feld wird nicht gemappt | Quelle: Medication.extension:Kategorie
`KBVPRERPMedicationIngredient` | `EPAMedication.extension` | Manuell | Fester Wert: 781405001, Medicinal product package (product) | Quelle: Medication.extension:type

### Extensions

#### Extension: KBV_EX_ERP_Medication_Category

Bedingung: url = `https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Category`

Quelle (Eingangsdaten) | Ziel (Ausgabedaten) | Aktion | Transformation & Beschreibung
--- | --- | --- | ---
`KBVPRERPMedicationIngredient.extension` `[Bedingung: url = 'https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Category']` | `EPAMedication.extension.url` | Fester Wert | setzt festen Wert: `https://gematik.de/fhir/epa-medication/StructureDefinition/drug-category-extension`
`KBVPRERPMedicationIngredient.extension.value` `[Bedingung: url = 'https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Category']` | `EPAMedication.extension.value.system` | Fester Wert | setzt festen Wert: `https://gematik.de/fhir/epa-medication/CodeSystem/epa-drug-category-cs`

#### Extension: KBV_EX_ERP_Medication_Vaccine

Bedingung: url = `https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Vaccine`

Quelle (Eingangsdaten) | Ziel (Ausgabedaten) | Aktion | Transformation & Beschreibung
--- | --- | --- | ---
`KBVPRERPMedicationIngredient.extension` `[Bedingung: url = 'https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Vaccine']` | `EPAMedication.extension.url` | Fester Wert | setzt festen Wert: `https://gematik.de/fhir/epa-medication/StructureDefinition/medication-id-vaccine-extension`

#### Extension: normgroesse

Bedingung: url = `http://fhir.de/StructureDefinition/normgroesse`

Quelle (Eingangsdaten) | Ziel (Ausgabedaten) | Aktion | Transformation & Beschreibung
--- | --- | --- | ---
`KBVPRERPMedicationIngredient.extension` `[Bedingung: url = 'http://fhir.de/StructureDefinition/normgroesse']` | `EPAMedication.extension.url` | Fester Wert | setzt festen Wert: `http://fhir.de/StructureDefinition/normgroesse`

Zur Übersicht der Medication-Mappings siehe:

- Mapping der Medication Ressource

## Transformationsregeln

Folgende zusätzliche Anmerkungen und Regeln sind für das Mapping zu umzusetzen:

### Mapping von KBV_PR_ERP_Medication_Compounding

ID | `F_017`
Beschreibung | Handelt es sich bei der ingredient des QuellProfils um einen PZN Codierten Wirkstoff muss eine contained Medication vom Typ "EPA Medication Ingredient" hinzugefügt werden Hinweis: F_009 findet hier auch Anwendung Daher muss wenn Medication eine KBV_PR_ERP_Medication_Compounding ist: Für jedes ingredient: Wenn ingredient.itemCodeableConcept.coding.system=`http://fhir.de/CodeSystem/ifa/pzn` dann weiter zu 2. Füge eine Medication (contained) hinzu vom Typ "EPA Medication Ingredient":
      <Medication>
          <id value="MedicationHydrocortison-FD" />
          <meta>
              <profile value="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-pzn-ingredient" />
          </meta>
          <!-- "EPA Medication Ingredients" haben haben immer diese Extension -->
          <extension url="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-type-extension">
              <valueCoding>
                  <system value="http://snomed.info/sct" />
                  <version value="http://snomed.info/sct/900000000000207008/version/20240201" />
                  <code value="781405001" />
                  <display value="Medicinal product package (product)" />
              </valueCoding>
          </extension>
          <code>
              <coding>
                  <system value="http://fhir.de/CodeSystem/ifa/pzn" />
                  <code value="03424249" />                       <!-- Wert von ingredient.itemCodeableConcept.coding.code -->
                  <display value="Hydrocortison 1% Creme" />      <!-- Wert von ingredient.itemCodeableConcept.text -->
              </coding>
              <text value="Hydrocortison 1% Creme" />             <!-- Wert von ingredient.itemCodeableConcept.text -->
          </code>
      </Medication>
In der Ziel Medication.ingredient setze die itemReference:
    <itemReference>
        <reference value="#MedicationHydrocortison-FD" />
    </itemReference>
Hinweise: "EPA Medication Ingredients" haben haben immer die Extension:
      <extension url="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-type-extension">
        <valueCoding>
            <system value="http://snomed.info/sct" />
            <version value="http://snomed.info/sct/900000000000207008/version/20240201" />
            <code value="781405001" />
            <display value="Medicinal product package (product)" />
        </valueCoding>
      </extension>
Die Werte in der EPA Medication Ingredients für `<code>` werden wie folgt gesetzt code: Wert von ingredient.itemCodeableConcept.coding.code display: Wert von ingredient.itemCodeableConcept.text text: Wert von ingredient.itemCodeableConcept.text
Profile | EPA Medication EPA Medication Ingredient EPA Pharmaceutical Product Medication
Referenzen | ANFERP-2911

### Erzeugen von Medication.extension:type

ID | `F_020`
Beschreibung | Bei der Erzeugung von EPA Medication EPA Medication Ingredient EPA Pharmaceutical Product Medication soll nach Möglichkeit `Medication.extension:type` erzeugt und mit dem korrekten Wert belegt werden. Folgende Optionen stehen für ePA 3.0 zur Verfügung (s. EPAMedicationTypeVS):
Code | Display | Deutsche Entsprechung
--- | --- | ---
781405001 | Medicinal product package (product) | Fertigarzneimittel
1208954007 | Extemporaneous preparation (product) | Rezeptur
373873005 | Pharmaceutical / biologic product (product) | Komponente einer Kombipackung
Für folgende Konstellationen sind die Codes entsprechend zu setzen:
# | Konstellation | Quellprofil | Erkennung/Kriterium | EPA Medication (type) | EPA Medication Ingredient (type) | EPA Pharmaceutical Product Medication (type)
--- | --- | --- | --- | --- | --- | ---
1 | PZN Verordnung | `KBV_PR_ERP_Medication_PZN` | `.form.code != KPG` | Fertigarzneimittel (`781405001`, Medicinal product package (product)) | n/a | n/a
2 | PZN Verordnung einer Kombipackung | `KBV_PR_ERP_Medication_PZN` | `.form.code = KPG` | Extension nicht setzen (wird über `.form.code` erkannt) | n/a | n/a
3 | Wirkstoffverordnung | `KBV_PR_ERP_Medication_Ingredient` | — | Fertigarzneimittel (`781405001`, Medicinal product package (product)) | n/a | n/a
4 | Freitextverordnung | `KBV_PR_ERP_Medication_FreeText` | — | Extension nicht setzen | n/a | n/a
5 | Rezeptur ohne PZNs in Rezepturbestandteilen | `KBV_PR_ERP_Medication_Compounding` | `.ingredient.itemCodeableConcept.text` | Rezeptur (`1208954007`, Extemporaneous preparation (product)) | n/a | n/a
6 | Rezeptur mit PZNs in Rezepturbestandteilen | `KBV_PR_ERP_Medication_Compounding` | `.ingredient.itemCodeableConcept.coding.code:pzn` | Rezeptur (`1208954007`, Extemporaneous preparation (product)) | Fertigarzneimittel (`781405001`, Medicinal product package (product)) | n/a
Profile | EPA Medication EPA Medication Ingredient EPA Pharmaceutical Product Medication