Implementation Guide
ePA Medication Service
Version 1.0.5-ballot.1 - draft

Operation API: Dispensierung stornieren (E-Rezept-Fachdienst)

Die Operation Dispensierung stornieren (E-Rezept-Fachdienst) ermöglicht das Stornieren oder Rückgängigmachen einer Arzneimittelabgabe im Medication Service. Sie wird über die Löschung einer Dispensierinformation im E-Rezept-Fachdienst als Stornierung im Medication Service “weitergereicht”. Dies erfolgt, wenn eine Arzneimittelabgabe irrtümlich erfolgt ist oder wenn eine Aktualisierung in der Arzneimittelhistorie des Versicherten notwendig wird. Nachdem der E-Rezept-Fachdienst die Operation durchführt, wird die betreffende Abgabe im Medication Service des Versicherten als storniert bzw. rückgängig gemacht markiert, was zu einer genauen und aktuellen Erfassung der Arzneimitteldaten des Versicherten beiträgt.

ePA-AktensystemePA-Aktensystem / VAUAVSE-Rezept-FachdienstInformation ServiceVAUSessionManagementMedication Service1Anfrage: Dispensierinformationen löschen2Durchführen der standardisierten Workflow-Logik des E-Rezept-Fachdienstes3Antwort: Erfolg4Persistieren der Resource ID der zu stornierenden Dispensierinformationen (aus MedicationDispense)in einer Warteschlange für die asynchrone ÜbertragungrefLokalisierung der Service-Endpunkte der ePA und der Akte eines Versicherten5Anfrage: Widerspruchsinformationen zum Einstellen durch E-Rezept-Fachdienst6Antwort: Widerspruchsinformationenalt[Widerspruch zum Einstellen durch E-Rezept-Fachdienst vorhanden]7Abbruch. Löschen der Resource ID der zu stornierenden Dispensierinformationen aus der Warteschlange[Kein Widerspruch zum Einstellen durch E-Rezept-Fachdienst]refLogin in die Akte des Versicherten8Übermittlung des rxPrescriptionProcessIdentifier in der FHIR Operation per HTTP POST9MedicationDispense.status = "cancelled"aktualisierenalt[successful case]10Antwort: Transaktion erfolgreich11Löschen der Resource ID der zu stornierenden Dispensierinformationen aus der Warteschlange12Abbruch. Die Resource ID der zu stornierenden Dispensierinformationen bleibt in der Warteschlangefür eine spätere Übertragung
Abbildung: Anwendungsfall Dispensierinformationen stornieren

Nachricht

Die Nachricht zur Stornierung oder Löschung einer Dispensierung wird als HTTP POST-Anfrage an den Medication Service gesendet.

Auslösung

Der E-Rezept-Fachdienst sendet eine Nachricht zur Stornierung oder Löschung einer Dispensierinformationen an den Medication Service. Der Medication Service verarbeitet die Anfrage, führt die entsprechende Stornierung oder Löschung der Dispensierinformationen durch und speichert diese Information dauerhaft.

FHIR Operation API

Der Medication Service MUSS die Operation API: Dispensierung stornieren (E-Rezept-Fachdienst) gemäß der FHIR OperationDefinition Cancel Dispensation eRP ausführen. Die Verarbeitung der Dispensierinformationen MUSS entsprechend den in der OperationDefinition festgelegten Regeln und Strukturen erfolgen. Der Medication Service MUSS die Operation Dispensierung stornieren (E-Rezept-Fachdienst) mittels einer HTTP POST-Anfrage verarbeiten. Die empfangene Stornierungsanfrage MUSS entsprechend verarbeitet und die Information zur stornierten Dispensierung dauerhaft gespeichert werden. Der Medication Service MUSS für die Operation Verschreibungsdaten einstellen (E-Rezept-Fachdienst) einen Partial Success ermöglichen.
  • Falls einzelne Dispensierungen erfolgreich storniert wurden, MUSS der Medication Service die zugehörigen prescriptionId und authoredOn Werte in der Antwort zurückgeben.
  • Falls einzelne Stornierungen nicht verarbeitet werden können, MUSS der Medication Service für diese ein OperationOutcome in der Antwort bereitstellen
  • Auch bei einer erfolgreichen Stornierung MUSS der Medication Service ein OperationOutcome mit einer entsprechenden Bestätigung bereitstellen
  • Der HTTP-Response-Code MUSS 200 OK sein, unabhängig davon, ob eine oder mehrere Stornierungen fehlschlagen

Geschäftslogik

Das folgende Aktivitätsdiagramm illustriert die Geschäftslogik der Operation Dispensierung stornieren (E-Rezept-Fachdienst) im Medication Service.

$cancel-dispensation-erpGenerateRxPrescriptionProcessIdentifierfrom the values ofInput-Parameters[x].RxDispensation.part.authoredOnand theInput-Parameters[x].RxDispensation.part.PrescriptionId Check if there is at least oneMedicationDispensewith theRxPrescriptionProcessIdentifieralready in the Medication Service yesnotransactionSet allMedicationDispensewith theextension[RxPrescriptionProcessIdentifier] equal toRxPrescriptionProcessIdentifierto StatuscancelledSet allMedicationwith theextension[RxPrescriptionProcessIdentifier] equal toRxPrescriptionProcessIdentifierto StatusinactiveSetMedicationRequestwith theidentifier[RxPrescriptionProcessIdentifier] equal toRxPrescriptionProcessIdentifierto StatusactiveAdd informationOperationOutcome(MEDICATIONSVC_OPERATION_SUCCESS) to theOutput-ParametersAdd errorOperationOutcome(MEDICATIONSVC_DISPENSATION_NO_EXIST) or (MEDICATIONSVC_DISPENSATION_STATUS)to theOutput-ParametersGet nextRxDispensationfrom theInput-ParametersnoIf nextInput-ParametersexistsyesReturn "Output-Parameters"
Abbildung: Geschäftslogik des Medication Service für die Operation Dispensierung stornieren (E-Rezept-Fachdienst)

Sicherheitsanforderungen

Generelle Sicherheitsanforderungen werden hier festgehalten.