C_11928_Anlage_V1.0.0
Prereleases:
C_11928 - E-Rezept: Abschaltung Endpunkt zum Abrufen einzelner Abgabeinformationen
Inhaltsverzeichnis
1 Änderungsbedarf
In der ersten Konzeption des E-Rezeptes wurde die Annahme getroffen, dass es für eine Verordnung genau eine Abgabeinformation gibt. Daher wurde der Endpunkt GET /MedicationDispense/<task-id> eingeführt. Damit sollte ein E-Rezept-FdV die Abgabeinformation einer Verordnung abrufen können. Die nach REST erwartete Response des E-Rezept-Fachdienstes ist ein MedicationDispense Objekt ohne Bundle.
Mit der Einführung der Möglichkeit mehrere Abgabeinformationen für eine Verordnung einstellen zu können, ergab sich die Anforderung alle für eine Verordnung verfügbaren Abgabeinformationen abzurufen. Dies wurde ermöglicht mit der Abfrage: GET /MedicationDispense?identifier=https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId|<task_id>.
Die Rückgabe dieses Aufrufs ist ein Bundle, dass alle (eines oder mehrere) Abgabeinformationen zu einer Verordnung zurückgibt.
Um die Nutzung der API für Hersteller zu vereinfachen und die Implementierung am E-Rezept-Fachdienst zu optimieren, soll der Endpunkt GET /MedicationDispense/<task-id> abgekündigt werden.
2 Änderungen gemSpec_FD_eRp
2.1 Änderungen Kapitel 5.4 Fehlercodes
Änderung Tabelle 3: TAB_eRPFD_003 Übersicht HTTP-Statuscodes
Entfernen von "GET /MedicationDispense/<id> in Zeile für Fehlercode 404
404 | Die adressierte Ressource wurde nicht gefunden. |
GET /Task/<id> POST /Task/<id>/$activate POST /Task/<id>/$accept POST /Task/<id>/$dispense POST /Task/<id>/$reject POST /Task/<id>/$close POST /Task/<id>/$abort GET /AuditEvent/<id> GET /Communication/<id> GET /MedicationDispense/<id> GET /notifications/opt-out |
Die über die <id> adressierte Ressource existiert nicht, d.h. wurde auch nicht zwischenzeitlich gelöscht (siehe Code 410). |
2.2 Änderungen Kapitel 5.5 Protokollierung
Änderung von A_19284-06
alt:
A_19284-06 - E-Rezept-Fachdienst - Versichertenprotokoll zu Operationen
Der E-Rezept-Fachdienst MUSS jeden Aufruf der folgenden Operationen protokollieren:
Operation | Rolle des zugreifenden Nutzers |
Beschreibung (ggfs. als Vorschlag für einen lesbaren Protokolleintrag in einfacher Sprache) |
---|---|---|
http GET /Task/<id> | ||
- | Versicherter, Vertreter |
Patient/Versicherter/Vertreter hat das E-Rezept heruntergeladen |
Apotheker | Apotheke hat die E-Rezept-Quittung heruntergeladen | |
http GET /Task | ||
Apotheker | im Erfolgsfall: Apotheke hat mit Ihrer eGK die Liste der offenen E-Rezepte abgerufen. im Fehlerfall: Apotheke konnte aufgrund eines Fehlerfalls nicht die Liste der offenen E-Rezepte mit Ihrer eGK abgerufen. |
|
http POST /Task | ||
$activate | Arzt-/Zahnarztpraxis/Krankenhaus | Arzt-/Zahnarztpraxis/Krankenhaus hat das E-Rezept bereitgestellt |
$accept | Apotheke | Apotheke hat das E-Rezept heruntergeladen |
$reject | Apotheke | Apotheke hat das E-Rezept zurückgegeben |
$dispense | Apotheke | Apotheke hat das E-Rezept beliefert |
$close | Apotheke | Apotheke hat das E-Rezept abgeschlossen |
$abort | Versicherter, Vertreter |
Patient/Versicherter/Vertreter hat das E-Rezept gelöscht |
Arzt-/Zahnarztpraxis/Krankenhaus | Arzt-/Zahnarztpraxis/Krankenhaus hat das E-Rezept gelöscht | |
Apotheke | Apotheke hat das E-Rezept gelöscht | |
http GET /MedicationDispense/<id> bzw. Zugriff via Suchparameter GET /MedicationDispense?<parameter>=... | ||
Versicherter, Vertreter |
Patient/Versicherter hat Medikament-Informationen heruntergeladen | |
http DELETE /ChargeItem/<id> | Versicherter | Versicherter hat Abrechnungsinformation gelöscht |
http GET /ChargeItem/<id> | Versicherter | Versicherter hat Abrechnungsinformation gelesen |
Apotheke | Apotheke hat Abrechnungsinformation gelesen | |
http POST /ChargeItem | Apotheke | Apotheke hat Abrechnungsinformation bereitgestellt |
http PATCH /ChargeItem/<id> | Versicherter | Versicherter hat Markierung zu Abrechnungsinformation gespeichert |
http PUT /ChargeItem/<id> | Apotheke | Apotheke hat PKV-Abgabedatensatz gespeichert |
http POST /Consent | Versicherter | Versicherter hat Einwilligung erteilt |
http DELETE /Consent | Versicherter | Versicherter hat Einwilligung widerrufen |
Automatisches Löschen durch den Fachdienst | ||
Ressource Task | E-Rezept-Fachdienst | Veraltete E-Rezepte vom Fachdienst automatisch gelöscht |
Ressource MedicationDispense | Veraltete Medikament-Informationen vom Fachdienst automatisch gelöscht | |
Ressource Communication | Veraltete Nachrichten vom Fachdienst automatisch gelöscht | |
Ressource ChargeItem | Veraltete Abrechnungsinformation vom E-Rezept-Fachdienst automatisch gelöscht |
und die gelesene bzw. geschriebene Ressource im Protokolleintrag AuditEvent.entity.what als Referenz hinzufügen sowie die KVNR des betroffenen Versicherten in AuditEvent.entity.name speichern.
Mit diesen Informationen kann der Versicherte die Zugriffe auf seine Daten nachvollziehen und bei einem unberechtigten Zugriff ggfs. intervenieren. [<=]
neu:
A_19284-10 - E-Rezept-Fachdienst - Versichertenprotokoll zu Operationen
Der E-Rezept-Fachdienst MUSS jeden Aufruf der folgenden Operationen protokollieren:
Operation | Rolle des zugreifenden Nutzers |
Beschreibung (ggfs. als Vorschlag für einen lesbaren Protokolleintrag in einfacher Sprache) |
---|---|---|
http GET /Task/<id> | ||
- | Versicherter, Vertreter |
Patient/Versicherter/Vertreter hat das E-Rezept heruntergeladen |
Apotheker | Apotheke hat die E-Rezept-Quittung heruntergeladen | |
http GET /Task | ||
Apotheker | im Erfolgsfall beim passenden AcceptPN3VSDMxx=false: Apotheke hat mit Ihrer eGK die Liste der offenen E-Rezepte abgerufen. im Erfolgsfall bei PN3 und passende AcceptPN3VSDMxx=true: Apotheke hat mit Ihrer eGK die Liste der offenen E-Rezepte abgerufen. (Offline-Check wurde akzeptiert) im Fehlerfall PN3 und passende AcceptPN3VSDMxx=false: Apotheke konnte aufgrund eines Fehlerfalls nicht die Liste der offenen E-Rezepte mit Ihrer eGK abgerufen. (Offline-Check wurde nicht akzeptiert) im sonstigen Fehlerfall: Apotheke konnte aufgrund eines Fehlerfalls nicht die Liste der offenen E-Rezepte mit Ihrer eGK abgerufen. |
|
http POST /Task | ||
$activate | Arzt-/Zahnarztpraxis/Krankenhaus/Psychotherapeut | Arzt-/Zahnarztpraxis/Krankenhaus/Psychotherapeut hat das E-Rezept bereitgestellt |
$accept | Apotheke | Apotheke hat das E-Rezept heruntergeladen |
Kostenträger | Krankenkasse hat das E-Rezept heruntergeladen | |
$reject | Apotheke | Apotheke hat das E-Rezept zurückgegeben |
Kostenträger | Krankenkasse hat das E-Rezept zurückgegeben | |
$dispense | Apotheke | Apotheke hat das E-Rezept beliefert |
$close | Apotheke | Apotheke hat das E-Rezept abgeschlossen |
Kostenträger | Krankenkasse hat das E-Rezept abgeschlossen | |
$abort | Versicherter, Vertreter |
Patient/Versicherter/Vertreter hat das E-Rezept gelöscht |
Arzt-/Zahnarztpraxis/Krankenhaus/Psychotherapeut | Arzt-/Zahnarztpraxis/Krankenhaus/Psychotherapeut hat das E-Rezept gelöscht | |
Apotheke | Apotheke hat das E-Rezept gelöscht | |
GET /MedicationDispense?<parameter>=... | ||
Versicherter, Vertreter |
Patient/Versicherter hat Medikament-Informationen heruntergeladen | |
http DELETE /ChargeItem/<id> | Versicherter | Versicherter hat Abrechnungsinformation gelöscht |
http GET /ChargeItem/<id> | Versicherter | Versicherter hat Abrechnungsinformation gelesen |
Apotheke | Apotheke hat Abrechnungsinformation gelesen | |
http POST /ChargeItem | Apotheke | Apotheke hat Abrechnungsinformation bereitgestellt |
http PATCH /ChargeItem/<id> | Versicherter | Versicherter hat Markierung zu Abrechnungsinformation gespeichert |
http PUT /ChargeItem/<id> | Apotheke | Apotheke hat PKV-Abgabedatensatz gespeichert |
http POST /Consent | Versicherter | Versicherter hat Einwilligung erteilt |
http DELETE /Consent | Versicherter | Versicherter hat Einwilligung widerrufen |
Automatisches Löschen durch den Fachdienst | ||
Ressource Task | E-Rezept-Fachdienst | Veraltete E-Rezepte vom Fachdienst automatisch gelöscht |
Ressource MedicationDispense | Veraltete Medikament-Informationen vom Fachdienst automatisch gelöscht | |
Ressource Communication | Veraltete Nachrichten vom Fachdienst automatisch gelöscht | |
Ressource ChargeItem | Veraltete Abrechnungsinformation vom E-Rezept-Fachdienst automatisch gelöscht |
und die gelesene bzw. geschriebene Ressource im Protokolleintrag AuditEvent.entity.what als Referenz hinzufügen sowie die KVNR des betroffenen Versicherten in AuditEvent.entity.name speichern.
Mit diesen Informationen kann der Versicherte die Zugriffe auf seine Daten nachvollziehen und bei einem unberechtigten Zugriff ggfs. intervenieren. [<=]
2.3 Änderung Kapitel 6.1.2.5 POST /Task/<id>/$close
Änderung A_22069
alt:
A_22069 - E-Rezept-Fachdienst - Task schließen - Speicherung mehrerer MedicationDispenses
Der E-Rezept-Fachdienst MUSS beim Beenden eines Tasks mittels /Task/<id>/$close auch die Übergabe mehrerer MedicationDispense-Objekte in einem validen Standard-FHIR-Bundle im http-Body des Requests ermöglichen und die zweite, dritte usw. MedicationDispense für den Abruf unter einer einzelnen ID (z.B. MedicationDispense/<prescriptionID> +"suffix") durch den Versicherten speichern. [<=]
neu:
A_22069-01 - E-Rezept-Fachdienst - Task schließen - Speicherung mehrerer MedicationDispenses
Der E-Rezept-Fachdienst MUSS beim Beenden eines Tasks mittels /Task/<id>/$close auch die Übergabe mehrerer MedicationDispense-Objekte in einem validen Standard-FHIR-Bundle im http-Body des Requests ermöglichen. [<=]
2.4 Änderung Kapitel 6.1.2.7 POST /Task/<id>/$dispense
Änderung A_24283
alt:
A_24283-01 - E-Rezept-Fachdienst - Dispensierinformationen bereitstellen - Speicherung mehrerer MedicationDispenses
Der E-Rezept-Fachdienst MUSS bei der Bereitstellung von Dispensierinformationen mittels POST /Task/<id>/$dispense auch die Übergabe mehrerer MedicationDispense-Objekte in einem validen Standard- FHIR-Bundle im http-Body des Requests ermöglichen und die zweite, dritte usw. MedicationDispense für den Abruf unter einer einzelnen ID (z.B. MedicationDispense/<prescriptionID> +"suffix") durch den Versicherten speichern.
[<=]
neu:
A_24283-02 - E-Rezept-Fachdienst - Dispensierinformationen bereitstellen - Speicherung mehrerer MedicationDispenses
Der E-Rezept-Fachdienst MUSS bei der Bereitstellung von Dispensierinformationen mittels POST /Task/<id>/$dispense auch die Übergabe mehrerer MedicationDispense-Objekte in einem validen Standard- FHIR-Bundle im http-Body des Requests ermöglichen. [<=]
2.5 Änderung Kapitel 6.2 Ressource MedicationDispense
Änderung A_19405-01
alt:
A_19405-01 - E-Rezept-Fachdienst - Rollenprüfung Versicherter liest MedicationDispense
Der E-Rezept-Fachdienst MUSS beim Aufruf der HTTP-GET-Operation auf den Endpunkt /MedicationDispense und auf einen konkreten über <id> adressierten /MedicationDispense/<id> sicherstellen, dass ausschließlich Versicherte in der Rolle
- oid_versicherter
neu:
A_19405-02 - E-Rezept-Fachdienst - MedicationDispense abrufen - Rollenprüfung
Der E-Rezept-Fachdienst MUSS beim Aufruf der HTTP-GET-Operation auf den Endpunkt /MedicationDispense sicherstellen, dass ausschließlich Nutzer in der Rolle
- oid_versicherter
Änderung A_22070-02
alt:
A_22070-02 - E-Rezept-Fachdienst - MedicationDispense abrufen - Rückgabe mehrerer MedicationDispenses
Der E-Rezept-Fachdienst MUSS das Suchergebnis mit mehreren MedicationDispense-Objekten anhand der PrescriptionID (?identifier=https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId|<PrescriptionID>) und bei Vorhandensein mehrerer MedicationDispense-Objekte zu einem beendeten Task, die MedicationDispense-Objekte in einem Bundle an den Aufrufenden zurückgeben. [<=]
neu:
A_22070-03 - E-Rezept-Fachdienst - MedicationDispense abrufen - Rückgabe mehrerer MedicationDispenses
Der E-Rezept-Fachdienst MUSS im Anwendungsfall "Abgabeinformationen abrufen" die Suche aller Abgabeinformationen zu einer Verordnung mit dem Aufruf
GET /MedicationDispense?identifier=https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId|<PrescriptionID>
unterstützten und dabei eines oder mehrere MedicationDispense-Objekte in einem Bundle an den Aufrufenden zurückgeben. [<=]
3 Änderungen in gemSpec_eRp_FdV
3.1 Änderung in Kapitel 5.1.2 Kommunikation mit Diensten der TI
Änderung Tabelle 3 : TAB_FdVERP_019 - HTTP-Header "X-erp-resource"
Streichen des Zeileneintrags für GET /MedicationDispense/<id>
Operation | X-erp-ressource |
---|---|
GET /MedicationDispense/<id> | MedicationDispense |
3.2 Änderung in Kapitel 5.2.3.16 Abgabeinformationen anzeigen
Änderung des Absatzes vor A_20036-01
alt:
Der Abruf mehrerer MedicationDispense-Objekte über GET /MedicationDispense und die Suche auf Basis der MedicationDispense-Suchparameter (?identifier=|<PrescriptionID>) liefert ein FHIR-Bundle von MedicationDispense-Objekten. Wurde die Verordnung eines Medikaments mit mehreren Medikamenten beliefert (z.B. 2*50 Tabletten, weil 100er- Packung nicht verfügbar ist), so liefert die Abfrage GET /MedicationDispense/<id> (mit <id> ggfs. <prescriptionID>) die erste MedicationDispense und die Abfrage über Suchparameter ein Bundle mehrerer MedicationDispense-Objekten (sofern mehrere eingestellt wurden).
neu:
Der Abruf aller MedicationDispense-Objekte zu einer Verordnung erfolgt über die Abfrage GET /MedicationDispense?identifer=|<PrescriptionID>. Dieser Aufruf liefert ein FHIR-Bundle von MedicationDispense-Objekten. Enthalten sind alle (ein oder mehrere) MedicationDispense-Objekte die für die Verordnung mit PrescriptionID eingestellt wurden.