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

## Home

Official URL: https://gematik.de/fhir/epa-medication/ImplementationGuide/de.gematik.epa.medication | Version: 1.2.0-ballot.2
Draft as of 2025-09-02 | Computable Name: EPA_Medication

Die ePA für alle stärkt den digital gestützten Medikationsprozess (dgMP) in dem sie an den Versorgungsschnittstellen Medikationsinformationen für Medikationsanalyse und -management bereitstellt. Dies wird vornehmlich durch

- die automatische Befüllung der elektronischen Medikationsliste (eML) mit verordneten und abgegebenen Arzneimitteln,

- der Möglichkeit der Dokumentation von Arzneimitteleinnahmen inkl. Dosierinformation,

- der Bereitstellung einer Übersicht über aktuelle und zukünftig einzunehmende Arzneimittel auf dem elektronischen Medikationsplan (eMP),

- der Bearbeitung von Statuswerten von Medikationen auf dem eMP sowie

- das Ändern von Dosierangaben zu verordneten und abgegebenen Arzneimitteln und eMP-Medikationen

erreicht. Der ePA Medication Service (kurz Medication Service) des dgMP unterstützt diese Funktionalitäten über eine HL7 FHIR-basierte Verarbeitung.

### Organisation dieses Implementation Guide

Dieser Implementation Guide sollte “von links nach rechts” gelesen werden. Ausgehend von der Fachlichkeit wird anschließend die dazugehörige FHIR-Modellierung über technische Anwendungsfälle beschrieben, die schließlich in FHIR-Ressourcen und -APIs aufgehen:

Fachlichkeit | In einem Überblick werden fachliche Zusammenhänge des dgMP mitsamt den Sichtkonzepten eML und eMP erläutert. Weiterhin werden idealtypische Szenarien des dgMP für verschiedene Sektoren und diesbezügliche fachliche Anwendungsfälle beschrieben.
Technische Umsetzung | Die technische Umsetzung der Prozessunterstützung wird anhand technischer Anwendungsfälle erläutert. Diese sind: Verordnung, Verschreibung und Dispensierung (inkl. Arzneimittelsubstitution bei Abgabe) mit dem eMP Nachtrag in der eML Aktualisierung eines eML-Eintrags Nachtrag im eMP Aktualisierung eines eMP-Eintrags Hinzufügen und Entfernen einer eML-eMP-Verknüpfung Lesezugriffe für eML und eMP Diesen Beschreibungen schließen sich Verarbeitungsregeln zum FHIR-basierten Auslesen und der folgenden Anzeige in Benutzungsoberflächen für die eML als auch den eMP an. Zuletzt wird die Datenmigration beschrieben, die beim Aktualisieren des Medication Service auf eine neue Version durchgeführt werden müssen.
Schnittstellen | Die Schnittstellen des Medication Service setzen sich aus Query API, Operation API sowie Render API zusammen. Allgemeingültige und ePA-spezifische Anforderungen an FHIR Data Services als auch Datenschutz- und Datensicherheitsaspekte werden in diesem Abschnitt dargelegt.
FHIR-Artefakte | Hier findet sich eine tabellarische Übersicht aller in diesem Implementation Guide verwendeten FHIR-Artefakte zu Schnittstellen und Inhaltsdaten für Abruf und Verwaltung von Medikationsdaten.
Anhänge | Diesem Implementation Guide werden Download-Artefakte (u.a. Paketdatei, Beispiele, Schematron-Dateien, dieser Guide im ZIP-Format), OpenAPI-Spezifikationen, Release Notes sowie Steckbriefe angehängt.

Tabelle: Organisation dieses Implementation Guide

### Abhängigkeiten

Hinweis

Die Dosierungsangaben in Medikationsdaten des dgMP basieren auf dem [Medication_IG_DE] von HL7 Deutschland e.V. bzw. den darin befindlichen [DosageDgMP] und [TimingDgMP]-Datentypprofilen für den dgMP. Diese legen die strukturierte Abbildung der Dosierung und die zulässigen Elemente fest. Die Verarbeitungsregeln sind in [Medication_IG_DE] beschrieben.

IG | Package | FHIR | Comment
--- | --- | --- | ---
ePA Medication Service | de.gematik.epa.medication#1.2.0-ballot.2 | R4 |
HL7 Terminology (THO) | hl7.terminology.r4#6.5.0 | R4 | Automatically added as a dependency - all IGs depend on HL7 Terminology
FHIR Extensions Pack | hl7.fhir.uv.extensions.r4#5.2.0 | R4 |
de.basisprofil.r4 | de.basisprofil.r4#1.5.4 | R4 |
Medication IG DE | de.fhir.medication#1.0.0-ballot | R4 |
de.gematik.fhir.directory | de.gematik.fhir.directory#0.16.0 | R4 |
de.ihe-d.terminology | de.ihe-d.terminology#3.0.1 | R4 |
TI Terminology | de.gematik.terminology#1.0.6 | R4 |
HL7 Terminology (THO) | hl7.terminology.r4#6.3.0 | R4 |
dvmd.kdl.r4 | dvmd.kdl.r4#2025.0.0 | R4 |
Telematikinfrastruktur (TI) Common | de.gematik.ti#1.1.1-ballot.1 | R4 |
de.basisprofil.r4 | de.basisprofil.r4#1.5.3 | R4 |
ePA Basisfunktionalitäten | de.gematik.epa#1.2.0-ballot.2 | R4 |
FHIR Tooling Extensions IG | hl7.fhir.uv.tools.r4#0.7.1 | R4 | for example references

Package hl7.fhir.uv.extensions.r4#5.2.0 This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Mon, Feb 10, 2025 21:45+1100+11:00)

Package de.basisprofil.r4#1.5.4 Projekt Basisprofilierung R4 (HL7 Deutschland e.V.)

Package de.ihe-d.terminology#3.0.1 de.ihe-d.terminology

Package de.gematik.fhir.directory#0.16.0 This pull request updates the FHIR Directory package to version 0.16.0 and introduces a new tagging system for Organisation resources. The main changes include the addition of a new fdv-relevant tag, the creation of a ResourceTag CodeSystem for non-origin meta tags, and dependency/version updates across the codebase. Tagging and CodeSystem Enhancements: Added the fdv-relevant tag to Organisation resources and introduced the new ResourceTag CodeSystem, which defines all allowed non-origin meta.tag values for directory resources (src/fhir/fsh-generated/resources/CodeSystem-ResourceTag.json, changelog.md). [1] [2] Version and Dependency Updates: Bumped the project version from 0.15.0 to 0.16.0 in all relevant files, including CodeSystem resources, to reflect the new release (package.json, all src/fhir/fsh-generated/resources/CodeSystem-*.json). [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15] [16] Updated dependencies to use de.basisprofil.r4 version 1.5.4 in package.json and fhirpkg.lock.json. [1] [2] Updated the fhirpkg.lock.json timestamp to reflect the latest package state.

Package dvmd.kdl.r4#2025.0.0 Publikation der Terminologie-Ressourcen für die Nutzung der Klinische Dokumentenklassen-Liste (KDL) des DVMD Version 2025

Package de.gematik.terminology#1.0.6 Terminologies for Telematics Infrastructure (TI)

Package de.basisprofil.r4#1.5.3 v1.5.3 - 18.03.25 `fixed` die in den Vitalparametern genutzten, optionalen, SnomedCT-VS enthielten nicht alle benötigten Konzepte, fehlende Konzepte wurden ergänzt

Package hl7.fhir.uv.tools.r4#0.7.1 This IG defines the extensions that the tools use internally. Some of these extensions are content that are being evaluated for elevation into the main spec, and others are tooling concerns (built Sat, Jul 26, 2025 06:59+1000+10:00)

### Kontakt

Allgemeine Fragen und Kommentare zum Implementation Guide können Sie über das [Anfragenportal] der gematik einreichen. Falls kein Zugang besteht, senden Sie bitte eine E-Mail an “patientteam [ at ] gematik [ dot ] de” mit dem Betreff “Anfragenportal Zugang”.