erp_fhirversion_change_20241101.adoc

E-Rezept FHIR Veränderungen für 01.11.2024

Ab dem 01.11.2024 ist das gematik Workflow Package 1.3 gültig. Es gibt sowohl einen neuen Endpunkt $dispense für die Apotheke als auch ein paar kleine Veränderungen an den FHIR-Objekten. Diese Seite bietet eine Zusammenfassung der Veränderungen in einem Format, das zeigt, was die verschiedenen Hersteller tun müssen, um ein bestimmtes Feature FHIR-mäßig umzusetzen. Alle Breaking Changes sind ebenfalls aufgelistet.

Inhaltsverzeichnis

• Versionsübergabegänge
• Änderungen
  • Übersicht
  • Allgemein
  • Zeitnahe Dokumentation der Abgabe

Versionsübergabegänge

Ab dem 01.11.2024 kann der E-Rezept-Fachdienst mehrere aktive Profile haben. Das bedeutet, dass Übergangszeiten mit mehr als zwei aktiven Profilen möglich sind. Vom 15.01.2025 bis 15.07.2025 sind die drei Profile 1.2, 1.3 und 1.4 gleichzeitig aktiv. In dieser Zeit wird besonders auf das meta.profile der Ressourcen geachtet, um festzustellen, gegen welche Profile validiert werden sollte.

Unten sind sowohl ein Diagramm als auch eine Tabelle zu sehen, die zeigen, wann welches Profil aktiv ist und bis wann.

ℹ️	Aufgrund der Updatezyklen von Apps im Feld können die FdVs die Profilversionen 1.2 und 1.3 im Zeitraum vom 15.04.2025 bis zum 15.07.2025 weiterhin nutzen. Ab dem 15.07.2025 ist auch für die FdVs die Verwendung der Versionen 1.2 und 1.3 nicht mehr möglich.

ℹ️	Ab dem 15.07.2025 ist nur Profil 1.4 für die FdVs verfügbar.

Änderungen

Im Folgenden finden sich die Änderungen des gematik Workflow Package 1.3 in Form einer Übersichtstabelle und detaillierten Beschreibungen, aufgeteilt nach Features und betroffenen Clientsystemen.

Übersicht

Betrifft	Feature	Ressource	Änderungen
	Allgemein	Alle	Anpassen der Versionsangabe in meta.profile von '|1.2' zu '|1.3'.
	Allgemein	MedicationDispense	MedicationDispense.whenHandedOver muss das Format YYYY-MM-DD haben.
	Allgemein	GEM_ERP_PR_Communication_DispReq GEM_ERP_PR_Communication_InfoReq	Communication.sender ist kein Pflichtfeld mehr
	Zeitnahe Dokumentation der Abgabe	Task	Erhält ein zusätzliches Feld: Task.extension:lastMedicationDispense

Allgemein

Betrifft:

• Anpassen der Versionsangabe in meta.profile von '|1.2' zu '|1.3'. Das betrifft alle Ressourcen.

• MedicationDispense.whenHandedOver muss das Format YYYY-MM-DD haben.

• .sender ist kein Pflichtfeld beim Erstellen einer Communication.

Zeitnahe Dokumentation der Abgabe

Betrifft:

• Keine FHIR-Änderungen auf der Apothekenseite, aber es gibt den neuen $dispense Endpunkt.

• $close kann auch ohne MedicationDispense abgeschlossen werden, wenn zuvor ein MedicationDispense über $dispense erfolgt ist. Weitere Informationen sind hier zu finden.

• Die Task-Ressource erhält ein zusätzliches Feld:

  • Task.extension:lastMedicationDispense Dieses Feld wird nur ausgefüllt, wenn Dispensierinformationen bereits bereitgestellt wurden, und kann sich ändern, bis die Task-Ressource den Status "completed" erreicht.

• Die FdVs können die Dispensierinformationen herunterladen, wenn dieses Feld befüllt ist, mit dem Hinweis, dass es sich verändern könnte. Wenn sich das Datum verändert hat, haben sich auch die Dispensierinformationen verändert.