Home

Official URL: https://gematik.de/fhir/epa-medication/ImplementationGuide/de.gematik.epa.medication				Version: 1.2.0-ballot.1
Draft as of 2025-08-01				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.

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.

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 hl7.fhir.uv.extensions.r4#5.3.0-ballot This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Fri, Aug 1, 2025 13:17+1000+10:00)

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 de.ihe-d.terminology#3.0.1 de.ihe-d.terminology

Package de.gematik.fhir.directory#0.15.0 This pull request introduces updates to pharmacy healthcare specialty codes and removes an unused value set from healthcare service category codes. These changes ensure better clarity in code displays and streamline the codebase by eliminating unnecessary elements.

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)

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”.