ELGA e-Medikation (R4) DRAFT
0.1.1 - ci-build
ELGA e-Medikation (R4) DRAFT, published by ELGA GmbH. This guide is not an authorized publication; it is the continuous build for version 0.1.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7Austria/ELGA-e-Medikation-R4/ and changes regularly. See the Directory of published versions
Ein berechtigter GDA (siehe Rollen und Berechtigungen) kann basierend auf einem bestehenden Medikationsplaneintrag eine oder mehrere Geplanten Abgaben erstellen. Für jedes verordnete Medikament muss eine eigene Geplante Abgabe erstellt werden.
Falls für eine Geplante Abgabe noch kein entsprechender Medikationsplaneintrag existiert, muss dieser zuerst erstellt werden (siehe Sub_UC_eMed_02_02 - Planeintrag in Medikationsplan hinzufügen). Bei Bedarf kann ein bestehender Medikationsplaneintrag angepasst werden (siehe Sub_UC_eMed_02_03 - Planeintrag im Medikationsplan ändern).
Ist keine Anpassung des Medikationsplaneintrags erforderlich, führt der GDA ein $plan-read aus und erhält von der Fachanwendung das Medikationsplan-Searchset-Bundle, das den Medikationsplan mit allen für die Erstellung der Geplanten Abgaben relevanten Ressourcen enthält.
Basierend auf darin enthaltenen Planeinträgen erstellt der GDA neue Geplante Abgaben mit folgenden Angaben:
Die erstellten Geplanten Abgaben werden in einem Bundle vom Typ Transaction mittels Prescription-Write an die Fachanwendung übermittelt wird.
Offene Punkte:
- Wirkstoffe in Planeintrag?
- Dürfen Geplante Abgaben hinsichtich Medikation und Dosierung vom Planeintrag abweichen?
AtElgaEmedMedicationRequestGeplanteAbgabe
status: active
category[mrcategory]: 2 "Geplante Abgabe" //Kategorie zur Unterscheidung der MedicationRequests
category[recipetype]: KASSEN | PRIVAT | SUBST // Verpflichtende Angabe der Rezeptart
intent: order // Fester Wert
medicationReference.reference: Medikation gemäß zugehörigem Planeintrag // Contained Medication
authoredOn: Datum der Erstellung der Geplanten Abgabe
requester: veranwortlicher GDA für die Geplante Abgabe // wird auf Übereinstimmung mit List.source geprüft
basedOn: id des zugehörigen Medikationsplaneintrags // referenziert aktuelle Version
groupIdentifier: e-Med GroupIdentifier // optionale Rezeptklammer
dosageInstruction: Dosierung + Einnahmezeitraum (ab sofort | in der Zukunft)
dispenseRequest.validityPeriod: Gültigkeitszeitraum // abhängig von Rezeptart bzw. verkürzt durch GDA
dispenseRequest.numberOfRepeatsAllowed: Anzahl weiterer Einlösungen // abhängig von Rezeptart bzw. verkürzt durch GDA
dispenseRequest.quantity: Abzugebende Menge (Packungen) je Abgabe
Offene Punkte:
$prescription-write: in Arbeit.
Der Ablauf zur Erstellung von Geplanten Abgaben und der Bezug des e-Med GroupIdentifiers kann unterschiedlich erfolgen. Exemplarisch werden drei Varianten angeführt.
Der e-Med GroupIdentifier ("Rezeptklammer") wird via POST $groupidentifier-create vorab von der Fachanwendung bezogen, in den Geplanten Abgaben ergänzt und zur Erstellung des e-Rezepts an die e-Rezept-Anwendung mitgegeben, um dieses mit den Geplanten Abgaben zu verknüpfen. Der Trigger zu Erstellung des e-Rezepts und Prescription-Write können parallel erfolgen (siehe Normalfall).
Liefert e-Rezept einen Fehler zurück, können mittels POST $prescription-discard bereits in der e-Medikation erstellte Geplante Abgaben verworfen werden (siehe Sub_UC_eMed_08_04 - Geplante Abgabe stornieren ($prescription-discard)). Liefert die e-Medikation Fachanwendung einen Fehler zurück, kann nach Fehlerkorrektur erneut ein Prescription-Write erfolgen oder ein bereits durch den e-Med groupIdentifer verknüpftes e-Rezept wieder von den Geplanten Abgaben "entkoppelt" werden (siehe Variante A: Fehlerfall).
Alternativ kann der e-Med GroupIdentifier durch die Fachanwendung automatisch ergänzt werden, wenn dieser beim Prescription-Write nicht in den Geplanten Abgaben im Transaction Bundle enthalten ist. Dadurch bleibt das Verhalten konsistent zur bestehenden e-Medikations-Implementierung. Hierfür müssen die Geplanten Abgaben gemeinsam in einem Transaction Bundle an die e-Medikation Fachanwendung übermittelt werden. Der Server ergänzt den e-Med GroupIdentifier während der Transaktionsverarbeitung. Die persistierten Ressourcen einschließlich des erzeugten e-Med GroupIdentifiers werden im Response an den Client zurückgegeben. Im Anschluss kann der Trigger zur Erstellung des e-Rezepts inkl. e-Med GroupIdentifier erfolgen.
Der Trigger zu Erstellung des e-Rezepts und Prescription-Write können parallel erfolgen (Variante A), allerdings noch ohne e-Med GroupIdentifier. Die e-Medikation Fachanwendung ergänzt diesen und liefert ihn an den Client zurück (wie in Variante B), der Client führt im Anschluss eine nachträgliche Verknüfung des bereits erstellten e-Rezepts mit den geplanten Abgaben mittels e-Med GroupIdentifier durch.
Offene Punkte:
$groupidentifier-create: in Arbeit.
Ein GDA kann eine selbsterfasste Geplante Abgabe aufgrund eines Fehlers stornieren, solange noch keine Abgaben durchgeführt (dh. noch keine zugehörige Durchgeführten Abgaben erstellt) wurden.
Um eine Geplante Abgabe zu stornieren, führt der GDA die Operation $prescription-discard aus:
AtElgaEmedMedicationRequestGeplanteAbgabe
status: entered-in-error
authoredOn: Datum des Verwerfens der Geplanten Abgabe
requester: veranwortlicher GDA für das Verwerfen der Geplanten Abgabe
Offene Punkte:
$prescription-discard: in Arbeit.
Wurden alle möglichen Einlösungen einer Geplanten Abgabe planmäßig durchgeführt (siehe Sub_UC_eMed_05_01 - Durchgeführte Abgabe erfassen), setzt die Fachanwendung die Geplante Abgabe automatisch auf den Status completed (siehe Status des MedicationRequests in der geplanten Abgabe). Die Geplante Abgabe ist damit abgeschlossen.
Sonderfall: Wenn die letzte Durchgeführte Abgabe danach verworfen wird (Status entered-in-error), wird der Status der Geplanten Abgabe durch die Fachanwendung wieder auf active gesetzt.
Die Fachanwendung erkennt anhand von MedicationRequest.numberOfRepeatsAllowed, ob weitere Einlösungen erlaubt sind (z.B. bei einem Privatrezept). Ist nur eine einmalige Einlösung möglich (z.B. Kassenrezept), setzt die Fachanwendung die Geplanten Abgabe sofort auf den Status completed.
Ermöglicht die Geplante Abgabe mehrere Einlösungen (MedicationRequest.numberOfRepeatsAllowed > 0), muss je Einlösung mindestens eine Durchgeführte Abgabe erstellt werden (bei Teilabgaben können es mehrere sein). Eine Einlösung gilt als vollständig, wenn für MedicationDispense.type den Wert FFC (First Fill – Complete) oder PFC (Part Fill - Complete) enthält.
Der Status der Geplanten Abgabe bleibt solange active, bis die letztmögliche Einlösung erfolgt ist (sieheSub_UC_eMed_08_02 - Geplante Abgabe beenden (durch Fachanwendung)).
AtElgaEmedMedicationRequestGeplanteAbgabe
status: completed
authoredOn: Datum der Erstellung der geplanten Abgabe // bleibt unverändert
requester: Ursprünglicher Ersteller // bleibt unverändert
Offene Punkte:
Erfolgt in der Geplanten Abgabe eine Datumsanpassung bei automatischen Aktionen durch die Fachanwendung? (in R6 gibt es dafür das Element: statusChanged); betrifft alle automatischen Statuswechsel der Geplanten Abgabe.
Ist der Gültigkeitszeitraum in dispenseRequest.validityPeriod der Geplanten Abgabe gemäß der ausgewählten Rezeptart (category:recipetype) (siehe Gültigkeit von Geplanten Abgaben basierend auf der Rezeptart) oder den Einschränkungen des GDAs überschritten, setzt die Fachanwendung die Geplante Abgabe automatisch auf den Status stopped (siehe Status des MedicationRequests in der geplanten Abgabe). Die Geplante Abgabe ist damit abgeschlossen.
AtElgaEmedMedicationRequestGeplanteAbgabe
status: stopped
authoredOn: Datum der Erstellung der geplanten Abgabe // bleibt unverändert
requester: Ursprünglicher Ersteller // bleibt unverändert
Eine Geplante Abgabe erhält automatisch den Status cancelled (siehe Status des MedicationRequests in der geplanten Abgabe), wenn alle Durchgeführten Abgaben (jede Einlösung) den Status cancelled erhalten haben ("Leerabgabe", d.h. keine Abgabe durchgeführt). Die Geplanten Abgabe ist damit abgeschlossen.
Sonderfall: Wenn die letzte Durchgeführte Abgabe danach verworfen wird (Status entered-in-error), wird der Status der Geplanten Abgabe durch die Fachanwendung wieder auf active gesetzt.
AtElgaEmedMedicationRequestGeplanteAbgabe
status: cancelled
authoredOn: Datum der Erstellung der geplanten Abgabe // bleibt unverändert
requester: Ursprünglicher Ersteller // bleibt unverändert
Offene Punkte:
Umsetzung Teilnehmerrechte
Der ELGA-Teilnehmer kann eine Geplante Abgabe endgültig löschen. Bereits dokumentierte zugehörige Durchgeführte Abgaben sowie bestehende Planeinträge bleiben davon unberührt.
Die Löschung der Geplanten Abgabe umfasst:
Zum Löschen einer Geplanten Abgabe ruft der ELGA-Teilnehmer diese im Zugangsportal auf. Dieses führt zunächst eine Leseoperation auf die betreffende MedicationRequest-Ressource aus (GET MedicationRequest/[id]) und löscht anschließend die betreffende Geplante Abgabe mittels DELETE (DELETE [base]/MedicationRequest/[id]).
Die Ressource einschließlich aller historischen Versionen darf nach erfolgreicher Löschung weder über reguläre FHIR-Interaktionen noch über administrative Schnittstellen abrufbar sein.
Offene Punkte:
Referenzen auf gelöschte Ressourcen (z.B. von bestehenden Durchgefürhte Abgaben auf gelöschte Geplante Abgaben) können nicht mehr aufgelöst werden.