C_12173_Anlage_V1.0.0
Prereleases:
C_12173_Anlage - Communications v3
ML-167375 - E-Rezept: Communication Payload v3
[<=]
Inhaltsverzeichnis
1 Änderungsbedarf
Die FHIR Ressource Communication wird in der Anwendung E-Rezept u.a. für Nachrichten zwischen Versicherten und Apotheken verwendet. Die Profile besitzen ein Payload-Feld, das den Inhalt der Nachricht im JSON-Format enthält. Derzeit existieren zwei verschiedene gültige Versionen des JSON Schemas, die beide durch Version 3 ersetzt werden.
Das JSON Schema der Version 3 erweitert die Funktionalität der Communication-Profile (u.a. GEM_ERP_PR_Communication_DispReq und GEM_ERP_PR_Communication_Reply) sowohl durch neue Felder als auch durch die Festlegung verschiedener Nachrichtenarten. Die Nachrichtenarten bestimmen, welche Felder verpflichtend und welche nicht anzugeben sind.
2 Änderung in gemILF_PS_eRp
2.1 Änderung in 5.3.9 Nachrichten von Versicherten empfangen
Mit diesem Anwendungsfall kann eine abgebende Institution Nachrichten von Versicherten empfangen.
Eine Apotheke kann von einem Versicherten Nachrichten im Rahmen eines Belieferungswunsches für Arzneimittel oder eines Änderungswunsches für eine Abrechnungsinformation erhalten.
Ein Kostenträger kann von einem Versicherten eine Nachricht zur Abfrage eines Freischaltcodes erhalten.
Die Absätze nach A_19329-01 werden ersetzt:
Für weitere Informationen siehe Operationen "Anwendungsfall auf neue Nachrichten prüfen" und "Anwendungsfall Alle Nachrichten vom E-Rezept-Fachdienst abrufen" aus der API-Schnittstelle [E-Rezept API Dokumentation].
Falls eine oder mehrere E-Rezept-Nachrichten für die abgebende LEI auf dem E-Rezept-Fachdienst bereitstehen, übermittelt der E-Rezept-Fachdienst ein Bundle von Communication Ressourcen.
Ein in der Nachricht übermittelter E-Rezept-Token berechtigt die abgebende Institution auf das E-Rezept, auf welches sich die Nachricht bezieht, zuzugreifen (Anwendungsfall "E-Rezept abrufen").
Eine Communication GEM_ERP_PR_Communication_DispReq Ressource im Rahmen des Belieferungswunsches für Arzneimittel dient in der initialen Nachricht zu einem Vorgang dem Zuweisen des E-Rezept (communicationType = "order"). In folgenden Nachrichten (communicationType = "text") zu einem Vorgang ist es die Antwort auf eine Nachricht der Apotheke zum Belieferungswunsch enthalten. Für die Beschreibung des Payloads siehe [gemSpec_DM_eRp#TAB_eRpDM_002].
Beispiele und ein Validator für diese Szenarien stehen im GitHub https://github.com/gematik/interactive-api-erp.
2.2 Überarbeitung 5.3.9 Nachricht an Versicherten versenden
Eine Apotheke kann von einem Versicherten Nachrichten im Rahmen eines Belieferungswunsches für Arzneimittel oder eines Änderungswunsches für eine Abrechnungsinformation erhalten.
Ein Kostenträger kann von einem Versicherten eine Nachricht zur Abfrage eines Freischaltcodes erhalten.
Mit diesem Anwendungsfall kann die abgebende Institution auf die Nachricht eines Versicherten antworten.
Für Apotheken werden im Rahmen eines Belieferungswunsches für Arzneimittel folgende Fälle unterschieden (Sie werden anhand des communicationType unterschieden.):
- Anzeige eines Freitextes (text)
- Anzeige einer URL (link)
- Es muss verpflichtend ein Text mitgegeben werden, der das Ziel der URL für den Versicherten beschreibt.
- Hinweis zum Reservierungsstatus
- Für den referenzierten Task wird der Versicherte darüber informiert, wann die Ware verfügbar ist.
- Abholcode menschenlesbar (pickupCodeHR)
- Abholcode Abholautomat (pickupCodeDMC)
- Hinweis zum Lieferzustand (deliveryStatus)
- Für delivery und shipment können Zustände der Lieferung übergeben werden.
- Hinweis zum Zahlbetrag (paymentInfo)
A_19330 - PS abgebende LEI: Nachricht versenden - E-Rezept auswählen
Das PS der abgebenden LEI MUSS es dem Nutzer ermöglichen, eine E-Rezept-Nachricht auszuwählen, um eine Antwort zu senden. [<=]
A_19331 - PS abgebende LEI: Nachricht versenden - Mitteilung erfassen
Das PS der abgebenden LEI MUSS es dem Nutzer ermöglichen, für eine E-Rezept-Nachricht an einen Versicherten eine Textnachricht zu erfassen. [<=]
Wickelt die Apotheke ein E-Rezept über einen Onlineshop ab, kann dem Versicherten das Weiterbearbeiten seines Warenkorbs in einer externen Bestellplattform (z.B. Versandadresse, Zuzahlung) ermöglicht werden. Hierzu erlaubt der E-Rezept-Fachdienst den Versand einer Warenkorb-URL in der Nachricht an den Versicherten.
A_21373 - PS abgebende LEI: Nachricht versenden - Externe URL ausschließlich für Einlösung
Das PS der abgebenden LEI MUSS sicherstellen, dass die Einbettung einer externen URL ausschließlich für das Einlösen von E-Rezepten in einer externen Bestellplattform genutzt wird. [<=]
A_19332 - PS abgebende LEI: Nachricht an Versicherten versenden
Das PS der abgebenden LEI MUSS den Anwendungsfall "UC 4.7 - Nachricht durch Abgebenden übermitteln" aus [gemSysL_eRp] gemäß TAB_ILFERP_011 umsetzen.
Tabelle 1 : TAB_ILFERP_011 – Nachricht an Versicherten versenden
| Name | Nachricht an Versicherten versenden |
| Auslöser |
|
| Akteur | Leistungserbringer, Mitarbeiter der abgebenden LEI |
| Vorbedingung |
|
| Nachbedingung |
|
| Standardablauf |
|
A_28538 - PS abgebende LEI: Nachricht versenden - Apotheke - Belieferung Arzneimittel - Nachricht erstellen
Das PS der abgebenden LEI (Apotheke) MUSS im Anwendungsfall "Nachricht an Versicherten versenden" die Nachricht gemäß der Struktur [gemSpec_DM_eRp#TAB_eRpDM_003] und
- einem communicationType entsprechend der zu übermittelnden Information
- TransactionID aus der empfangenen Nachricht des Versicherten
Beispiele für diesen Anwendungsfall stehen im GitHub https://github.com/gematik/interactive-api-erp.
Die Erläuterung und das Schema des Payloads sind in [gemSpec_DM_eRp#TAB_eRpDM_003] zu finden.
A_19333-02 - PS abgebende LEI: Nachricht versenden - Apotheke - Belieferung Arzneimittel - Communication Ressource erstellen
Das PS der abgebenden LEI (Apotheke) MUSS im Anwendungsfall "Nachricht an Versicherten versenden" bezüglich der Belieferung eines Arzneimittels eine Communication Ressource mit dem Profil GEM_ERP_PR_Communication_Reply mit
- Versicherten-ID des Absenders der empfangenen Nachricht in recipient
- Task-ID des referenzierten E-Rezeptes in basedOn
- Nachrichten-ID der empfangenen Anfrage in inResponseTo (optional)
- Nachricht in payload contentString
A_28539 - PS abgebende LEI: Nachricht versenden - Apotheke - Abrechnungsinformation - Communication Ressource erstellen
Das PS der abgebenden LEI (Apotheke) MUSS im Anwendungsfall "Nachricht an Versicherten versenden" bezüglich dem Änderungswunsch einer Abrechnungsinformation eine Communication Ressource mit dem Profil GEM_ERPCHRG_PR_Communication_ChargChangeReply erstellen. [<=]
A_28540 - PS abgebende LEI: Nachricht versenden - Kostenträger - Communication Ressource erstellen
Das PS der abgebenden Institution (Kostenträger) MUSS im Anwendungsfall "Nachricht an Versicherten versenden" eine Communication Ressource mit dem Profil GEM_ERP_PR_Communication_DiGA erstellen. [<=]
Für die Spezifikation der Communication Ressource siehe [gemSpec_DM_eRp].
A_19334 - PS abgebende LEI: Nachricht versenden - Nachricht auf Fachdienst einstellen
Das PS der abgebenden LEI MUSS im Anwendungsfall "Nachricht an Versicherten versenden" die HTTP-Operation POST /Communication mit
- ACCESS_TOKEN im Authorization-Header
- Communication Ressource im HTTP-Request-Body
Für weitere Informationen siehe Operationen "Anwendungsfall Nachricht als Apotheke an einen Versicherten schicken" aus der API-Schnittstelle [E-Rezept API Dokumentation].
3 Änderung in gemSpec_eRp_FdV
3.1 Änderung in 5.2.3.11 E-Rezept zuweisen
User Stories:
- ...
- Als Patient möchte ich auf Nachrichten meiner Apotheke antworten können
Neue Anforderung nach A_20011-01
A_28541 - E-Rezept FdV: E-Rezept zuweisen - Kontaktinformationseingabe ermöglichen
Das E-Rezept-FdV MUSS im Anwendungsfall "E-Rezept einer Apotheke zuweisen" es dem Versicherten ermöglichen, Kontaktinformationen (Telefonnummer und E-Mail Adresse) zu erfassen. [<=]
Neue Anforderung nach A_19200-*:
A_28542 - E-Rezept-FdV: E-Rezept zuweisen - Zuweisen - Payload
Das E-Rezept-FdV MUSS im Anwendungsfall "E-Rezept einer Apotheke zuweisen" im Rahmen der Belieferung eines Arzneimittels für den payload_contentstring einen JSON Datensatz mit communicationType = "order" erstellen. [<=]
A_28543 - E-Rezept-FdV: E-Rezept zuweisen - Zuweisen - TransactionID
Das E-Rezept-FdV MUSS im Anwendungsfall "E-Rezept einer Apotheke zuweisen" im Rahmen der Belieferung eines Arzneimittels für den payload_contentstring eine TransactionID erzeugen, um Nachrichten zu dem Vorgang zuordnen zu können. [<=]
A_28544 - E-Rezept-FdV: E-Rezept zuweisen - Auf Nachricht antworten - Payload
Das E-Rezept-FdV MUSS im Anwendungsfall "E-Rezept einer Apotheke zuweisen" im Rahmen der Belieferung eines Arzneimittels , wenn der Nutzer auf eine empfangene Nachricht einer Apotheke antwortet, für den payload_contentstring einen JSON Datensatz mit communicationType = "text" erstellen. [<=]
A_28545 - E-Rezept-FdV: E-Rezept zuweisen - Auf Nachricht antworten - TransactionID
Das E-Rezept-FdV MUSS im Anwendungsfall "E-Rezept einer Apotheke zuweisen" im Rahmen der Belieferung eines Arzneimittels, wenn der Nutzer auf eine empfangene Nachricht einer Apotheke antwortet, die TransactionID aus der empfangenen Nachricht der Apotheke unverändert im payload contentString der Textnachricht an die Apotheke zurückgeben. [<=]
Für die Spezifikation des JSON Datensatzes siehe [gemSpec_DM_eRp#TAB_eRpDM_002 E-Rezept einer Apotheke zuweisen].
3.2 Änderung in 5.2.3.16 Nachrichten anzeigen
Am Ende des Absatzes nach A_19205
Im Rahmen der Belieferung eines Arzneimittels können die folgenden Nachrichttypen abgebildet werden:
- Freitext
- Eine URL
- Hinweis zum Reservierungsstatus
- Menschenlesbarer Abholcode
- Abholcode für Abholautomat
- Hinweis zum Lieferzustand
- Hinweis zum Zahlbetrag
Für die Beschreibung des payloads zu den Nachrichtentypen siehe [gemSpec_DM_eRp#TAB_eRpDM_003].
4 Änderung in gemSpec_FD_eRp
4.1 Änderung in 6.5.2.1 POST /Communication/
Alt:
A_23878-01 - E-Rezept-Fachdienst - Nachricht einstellen - Validierung des Payload-Inhalt von GEM_ERP_PR_Communication_DispReq
Der E-Rezept-Fachdienst MUSS beim Einstellen einer Nachricht über die http-Operation POST auf den Endpunkt /Communication den Inhalt der contentString-Eigenschaft des GEM_ERP_PR_Communication_DispReq-Profils auf valides JSON überprüfen und, falls die Inhalte des strukturierten JSON die unter "Prüfungsoperationen durch den Fachdienst" aufgeführten Anforderungen nicht erfüllen mit, einem Http-Fehler 400 (Bad Request) abbrechen sowie mit einer aussagekräftigen Fehlermeldung in Form einer eingebetteten OperationOutcome-Ressource antworten.
Tabelle 2 : TAB_eRPFD_011 Prüfungsoperationen durch den Fachdienst GEM_ERP_PR_Communication_DispReq-Profil
| Attribut | Pflicht / Optional | Prüfungsoperationen durch den Fachdienst |
|---|---|---|
| version | Pflicht | Der Wert muss immer 1 sein. |
| supplyOptionsType | Pflicht | Einer der folgenden Werte muss gesetzt sein: "onPremise", "delivery", "shipment". |
| Wenn Communication.extension:flowType == 166 ist nur "onPremise" und "delivery" erlaubt | ||
| name | Optional | Die Zeichenlänge darf maximal 100 Zeichen betragen. |
| address | Optional | die Zeichenlänge darf maximal 500 Zeichen betragen. |
| hint | Optional | Die Zeichenlänge darf maximal 500 Zeichen betragen. |
| phone | Optional | Die Zeichenlänge darf maximal 100 Zeichen betragen. |
Neu:
A_23878-02 - E-Rezept-Fachdienst - Nachricht einstellen - Validierung Payload GEM_ERP_PR_Communication_DispReq
Der E-Rezept-Fachdienst MUSS beim Einstellen einer Nachricht über die http-Operation POST auf den Endpunkt /Communication , falls die Ressource dem GEM_ERP_PR_Communication_DispReq-Profil entspricht, den Inhalt der contentString-Eigenschaft auf valides JSON sowie gegen die Struktur in [gemSpec_DM_eRp#TAB_eRpDM_002] überprüfen und bei negativem Prüfergebnis, mit einem Http-Fehler 400 (Bad Request) abbrechen sowie mit einer aussagekräftigen Fehlermeldung in Form einer eingebetteten OperationOutcome-Ressource antworten.
[<=]Alt:
A_23879 - E-Rezept-Fachdienst - Nachricht einstellen - Validierung des Payload-Inhalt von GEM_ERP_PR_Communication_Reply
Der E-Rezept-Fachdienst MUSS beim Einstellen einer Nachricht über die http-Operation POST auf den Endpunkt /Communication den Inhalt der contentString-Eigenschaft des GEM_ERP_PR_Communication_Reply-Profils auf valides JSON überprüfen und, falls die Inhalte des strukturierten JSON die unter "Prüfungsoperationen durch den Fachdienst" aufgeführten Anforderungen nicht erfüllen, mit einem Http-Fehler 400 (Bad Request) abbrechen sowie mit einer aussagekräftigen Fehlermeldung in Form einer eingebetteten OperationOutcome-Ressource antworten.
Tabelle 3 : TAB_eRPFD_012 Prüfungsoperationen durch den Fachdienst GEM_ERP_PR_Communication_Reply-Profil
| Attribut | Pflicht / Optional | Prüfungsoperationen durch den Fachdienst |
|---|---|---|
| version | Pflicht | Der Wert muss immer 1 sein. |
| supplyOptionsType | Pflicht | Einer der folgenden Werte muss gesetzt sein: "onPremise", "delivery", "shipment". |
| info_text | Optional | Die Zeichenlänge darf maximal 500 Zeichen betragen. |
| url | Optional | Wenn gesetzt, muss der übermittelte String eine valide URL gemäß RFC3986 sein.
Die Zeichenlänge darf maximal 500 Zeichen betragen. |
| pickUpCodeHR | Optional | Wenn gesetzt, muss das Attribut supplyOptionsType den Wert "onPremise" haben und die Zeichenlänge darf maximal 8 Zeichen betragen. |
| pickUpCodeDMC | Optional | Wenn gesetzt, muss das Attribut supplyOptionsType den Wert "onPremise" haben und die Zeichenlänge darf maximal 128 Zeichen betragen. |
Neu:
A_23879-01 - E-Rezept-Fachdienst - Nachricht einstellen - Validierung Payload GEM_ERP_PR_Communication_Reply
Der E-Rezept-Fachdienst MUSS beim Einstellen einer Nachricht über die http-Operation POST auf den Endpunkt /Communication , falls die Ressource dem GEM_ERP_PR_Communication_Reply-Profil entspricht, den Inhalt der contentString-Eigenschaft auf valides JSON sowie gegen die Struktur in [gemSpec_DM_eRp#TAB_eRpDM_003] überprüfen und bei negativem Prüfergebnis, mit einem Http-Fehler 400 (Bad Request) abbrechen sowie mit einer aussagekräftigen Fehlermeldung in Form einer eingebetteten OperationOutcome-Ressource antworten. [<=]
5 Änderung in gemSpec_DM_eRp
5.1 Änderung in 2.7 Nachrichten zwischen E-Rezept-FdV und abgebender LEI
Der Payload einer Nachricht mittels der Communication Profile GEM_ERP_PR_Communication_DispReq und GEM_ERP_PR_Communication_Reply wird in einer JSON Struktur übermittelt. Die Datenstruktur wird in diesem Abschnitt beschrieben.
Die Nachrichten zwischen E-Rezept-FdV und PS der abgebenden LEI müssen gemäß den Vorgaben aus A_28429 UTF-8 kodiert sein.
A_28546 - E-Rezept - Nachrichtenaustausch - Keine Non-Printable Character
Das E-Rezept-FdV und das PS der abgebenden LEI DÜRFEN NICHT in der in contentSring übermittelten Nachricht Non-Printable-Characters verwenden. [<=]
5.1.1 Änderung in 2.7.1 E-Rezept einer Apotheke zuweisen
Alt:
A_23876 - E-Rezept - Nachrichtenaustausch - E-Rezept einer Apotheke zuweisen - Datenstruktur Nachricht
Das E-Rezept-FdV, der E-Rezept-Fachdienst und das PS der abgebenden LEI MÜSSEN für den Anwendungsfall "E-Rezept einer Apotheke zuweisen" Nachrichten mit der Datenstruktur gemäß TAB_eRpDM_002 in der contentString-Eigenschaft des GEM_ERP_PR_Communication_DispReq-Profils unterstützen.
Tabelle 4 : TAB_eRpDM_002 E-Rezept einer Apotheke zuweisen
| Attribut | verpflichtend | Beschreibung | zulässige Werte | Beispiel |
|---|---|---|---|---|
| version | ja | Gibt die Version des JSON an. Aktuell immer 1. Kann im weiteren Lebenszyklus verändert werden. | nummerisch, bis zu 6 Stellen | 1 |
| supplyOptionsType | ja | Wird gemäß des Servicerequests gesetzt, den der Nutzer wählt.
Die für den Nutzer zur Auswahl stehenden Services gibt die Apotheke vor, indem sie den servicespezifischen Zuweisungs-Endpunkt angibt, oder nicht. |
onPremise, shipment, delivery | onPremise |
| name | nein | Name des Versicherten. | 100 Stellen,
UTF-8 |
Dr. Maximilian von Muster |
| address | nein | String-Array der Zeilen einer Adresse. Sie ist im JSON in der korrekten Reihenfolge anzugeben und auch auszulesen.
"onPremise": Adresse des Versicherten laut Rezept "delivery"/"shipment": Adresse des Lieferungsempfänger mindestens: Strasse+Hausnummer, PLZ+Ort werden gesetzt |
Array von Strings je 500 Stellen UTF-8 | "address": [ "wohnhaft bei Emilia Fischer", "Bundesallee 312", "123. OG", "12345 Berlin" ] |
| hint | nein | Hinweis, den der Versicherte mit angeben kann. | 500 Stellen,
UTF-8 |
Bitte im Morsecode klingeln: -.-. |
| phone | nein | Telefonnummer | 32 Stellen,
UTF-8 |
004916094858168 |
Neu:
A_23876-01 - E-Rezept - Nachrichtenaustausch - E-Rezept einer Apotheke zuweisen - Datenstruktur Nachricht
Das E-Rezept-FdV, der E-Rezept-Fachdienst und das PS der abgebenden LEI MÜSSEN für den Anwendungsfall "E-Rezept einer Apotheke zuweisen" Nachrichten mit der Datenstruktur gemäß TAB_eRpDM_002 in der contentString-Eigenschaft des GEM_ERP_PR_Communication_DispReq-Profils unterstützen.
Tabelle 5 : TAB_eRpDM_002 E-Rezept einer Apotheke zuweisen
| Attribut | verpflichtend | Beschreibung | zulässige Werte | Beispiel |
|---|---|---|---|---|
| version | ja | Gibt die Version des JSON an. Aktuell immer 3. Kann im weiteren Lebenszyklus verändert werden. | nummerisch, bis zu 6 Stellen | 3 |
| communicationType | ja | Beschreibt die Art der Nachricht.
|
order, text | order |
| supplyOptionsType | Falls communicationType = order: ja
Falls communicationType = text: verboten |
Wird gemäß des Servicerequests gesetzt, den der Nutzer wählt.
Die für den Nutzer verfügbaren Services sind für die jeweilige Apotheke im FHIR-VZD hinterlegt. |
onPremise, shipment, delivery | onPremise |
| firstname | Falls communicationType = order und supplyOptionsType = delivery oder shipment: ja
Ansonsten: nein |
Vorname des Versicherten bzw. Lieferungsempfänger | 45 Stellen
|
Maximilian |
| lastname | Falls communicationType = order und supplyOptionsType = delivery oder shipment: ja
Ansonsten: nein |
Name des Versicherten bzw. Lieferungsempfänger. | 45 Stellen
|
Dr. von Muster |
| address | Falls communicationType = order und supplyOptionsType = delivery oder shipment: ja
Ansonsten: nein |
Strasse und Hausnummer des Versicherten bzw. Lieferungsempfänger
|
3-100 Stellen | Bundesallee 312 |
| postcode | Falls communicationType = order und supplyOptionsType = delivery oder shipment: ja
Ansonsten: nein |
PLZ des Versicherten bzw. Lieferungsempfänger | 3-10 Stellen | 12345 |
| city | Falls communicationType = order und supplyOptionsType = delivery oder shipment: ja
Ansonsten: nein |
Ort des Versicherten bzw. Lieferungsempfänger | 2-100 Stellen | Berlin |
| country | Falls communicationType = order und supplyOptionsType = delivery oder shipment: ja
Ansonsten: nein |
Land des Versicherten bzw. Lieferungsempfänger | ISO 3166-1 Alpha-2 Code | DE |
| hint | nein | Lieferanweisung, die der Nutzer mit angeben kann. | 0-100 Stellen
|
Bitte im Morsecode klingeln: -.-. |
| text | Falls communicationType = text: ja
Ansonsten: nein |
Zusätzliche Anmerkungen des Nutzers zur Bestellung.
|
0-800 Stellen, keine URL | |
| phone | Falls communicationType = order: ja
Ansonsten: nein |
Telefonnummer
E-164 Format, jedoch anstelle des „+“ mit „00“ / rein nummerisch. |
32 Stellen
|
004916094858168 |
| nein | E-Mail-Adresse des Nutzers
Format mit @ und Punkt. |
0-70 Stellen,
RFC-5322-konforme E-Mail-Adresse |
max@musterfrau.de | |
| transactionID | ja | Dient dazu, Nachrichten einer Transaktion zuordnen zu können. | 36 Stellen,
UUID |
8196b610-9b77-47ab-936e-362cd92ef2aa |
[<=]
| Nachrichtentyp (communicationType) | Beschreibung |
|---|---|
| order | Zuweisen eines E-Rezepts |
| text | Antwort auf eine Nachricht der Apotheke |
5.1.2 Änderung in 2.7.2 Nachricht durch Abgebenden übermitteln
Alt:
A_23877 - E-Rezept - Nachrichtenaustausch - Nachricht durch Abgebenden übermitteln - Datenstruktur Nachricht
Das E-Rezept-FdV, der E-Rezept-Fachdienst und das PS der abgebenden LEI MÜSSEN für den Anwendungsfall "Nachricht durch Abgebenden übermitteln" Nachrichten mit der folgenden Datenstruktur in der contentString-Eigenschaft des GEM_ERP_PR_Communication_Reply unterstützen.
Tabelle 6 : TAB_eRpDM_003 Nachricht als Apotheke an einen Versicherten schicken
| Attribut | verpflichtend | Beschreibung | zulässige Werte | Beispiel |
|---|---|---|---|---|
| version | ja | Gibt die Version des JSON an. Aktuell immer 1. Kann im weiteren Lebenszyklus verändert werden. | nummerisch, bis zu 6 Stellen | 1 |
| supplyOptionsType | ja | Wird gemäß des Servicerequests gesetzt, den der Nutzer wählt.
Die für den Nutzer zur Auswahl stehenden Services gibt die Apotheke vor, indem sie den servicespezifischen Zuweisungs-Endpunkt angibt, oder nicht. |
onPremise, shipment, delivery | onPremise |
| info_text | nein | Zusätzlicher Freitext des Versicherten an die Apotheke | 500 Stellen,
UTF-8 |
Wir möchten Sie informieren, dass Ihre bestellten Medikamente zur Abholung bereitstehen. Den Abholcode finden Sie anbei. |
| url | nein | Einbettung einer externen URL ausschließlich für das Einlösen von E-Rezepten in einer externen Bestellplattform | 500 Stellen,
URL gemäß RFC3986, |
https://www.meine-apotheke.de/pickup/59b52340-7a6a-430d-99ea-45a8e5cd03f6 |
| pickUpCodeHR | nein | menschenlesbarer Abholcode
Nur bei supplyOptionsType "onPremise". Wenn gesetzt, wird dem Nutzer der Inhalt des "pickUpCodeHR" optisch hervorgehoben angezeigt. |
8 Stellen, UTF-8 | 12315615 |
| pickUpCodeDMC | nein | maschinenlesbarer Abholcode (Data-Matrix-Code)
Nur bei supplyOptionsType "onPremise". Wenn gesetzt, kann sich der Nutzer den Inhalt als Data-Matrix-Code anzeigen lassen. Der Inhalt wird gemäß ISO/IEC 16022:2006 von der App in einen DMC gewandelt. Fehlt die Interpretation, so wird der Code als Freitext angezeigt. |
128 Stellen, UTF-8 | 5346a991-c5c6-49c8-b87b-4cdd255bbde4 |
Neu:
A_23877-01 - E-Rezept - Nachrichtenaustausch - Nachricht durch Abgebenden übermitteln - Datenstruktur Nachricht
Das E-Rezept-FdV, der E-Rezept-Fachdienst und das PS der abgebenden LEI MÜSSEN für den Anwendungsfall "Nachricht durch Abgebenden übermitteln" Nachrichten mit der folgenden Datenstruktur in der contentString-Eigenschaft des GEM_ERP_PR_Communication_Reply unterstützen.
Tabelle 7 : TAB_eRpDM_003 Nachricht als Apotheke an einen Versicherten schicken
| Attribut | verpflichtend | Beschreibung | zulässige Werte | Beispiel |
|---|---|---|---|---|
| version | ja | Gibt die Version des JSON an. Aktuell immer 3.
Kann im weiteren Lebenszyklus verändert werden. |
nummerisch, bis zu 6 Stellen | 3 |
| communicationType | ja | Beschreibt die Art der Nachricht. | text, link, reservationStatus, pickupCodeHR, pickupCodeDMC, deliveryStatus, paymentInfo | reservationStatus |
| text | Falls communicationType = text oder link ist: ja
Falls communicationType = pickupCodeHR, pickupCodeDMC, deliveryStatus oder paymentInfo: nein Falls communicationType = reservationStatus: verboten |
Zusätzlicher Freitext der Apotheke an den Versicherten.
Falls communicationType gleich "link" ist, beschreibt dies das URL-Ziel, sodass der Versicherten vor dem Aufruf über das Ziel des Absprungs informiert wird. |
800 Stellen, keine Url | Wir möchten Sie informieren, dass Ihre bestellten Medikamente zur Abholung bereitstehen. Den Abholcode finden Sie anbei. |
| url | Falls communicationType = link: ja
Ansonsten: verboten |
Externe URL, z.B. zu Webshop, um OTC Geschäft zu ermöglichen. | 500 Stellen, URL gemäß RFC3986,
|
https://www.meine-apotheke.de/pickup/59b52340-7a6a-430d-99ea-45a8e5cd03f6 |
| transactionID | ja | Wiederholung aus der empfangenen Nachricht.
Dient dazu, Nachrichten einer Transaktion zuordnen zu können. |
36 Stellen, UUID | 8196b610-9b77-47ab-936e-362cd92ef2aa |
| readyForCollection | Falls communicationType =
reservationStatus: ja Ansonsten: verboten |
Zeitpunkt der Verfügbarkeit | immediately, sameDay, nextDay, nextDayAM, nextDayPM, unknown, notAvailable | immediately |
| deliveryStatus | Falls communicationType =
deliveryStatus: ja Ansonsten: verboten |
Information zum Status der Lieferung (Bote, Versand) | preparedWaiting (Lieferung vorbereitet, wartet auf Abholung), inTransport (an Lieferdienst übergeben und in Auslieferung), deliverd (Übergeben), incident (Störung bei Lieferung) | inTransport |
| inTransportPosition | Falls communicationType =
deliveryStatus: nein Ansonsten: verboten |
GMS Position des Transporters | Lat, Long | {
"long": 13.387595793605172, "lat": 52.522529939635795 } |
| inTransportETA | Falls communicationType =
deliveryStatus: nein Ansonsten: verboten |
Erwartete Ankunft Zeitfenster
von – bis |
TIMESTAMP-TIMESTAMP | {
"from": 1735736400, "to": 1735741800 } |
| totalAmount | Falls communicationType =
paymentInfo: ja Ansonsten: verboten |
Zu zahlende Betrag in Eurocent, rein nummerisch | Nummerisch | 12550 |
| paymentMethods | Falls communicationType =
paymentInfo: nein Ansonsten: verboten |
Verfügbare Zahlungsarten | Array aus Objects:
cash, bankaccount, creditcard, paypal (optional) |
"paymentMethods": [
{ "method": "cash" }, { "method": "bankaccount", "url": "https://my.payment.provider.de/pay/<payment_transaction_id>" }, { "method": "paypal", "url": "https://paypal.me/<some_account>" } ] |
| pickUpCodeHR | Falls communicationType =
pickupCodeHR und supplyOptionsType = onPremise: ja Ansonsten: verboten |
menschenlesbarer Abholcode
|
1-8 Stellen | 12315615 |
| pickUpCodeDMC | Falls communicationType =
pickupCodeDMC und supplyOptionsType = onPremise: ja Ansonsten: verboten |
maschinenlesbarer Abholcode (Data-Matrix-Code gemäß ISO/IEC 16022:2006)
|
8-2000 Stellen | 5346a991-c5c6-49c8-b87b-4cdd255bbde4 |
[<=]
| Nachrichtentyp (communicationType) | Beschreibung |
|---|---|
| text | Übermittlung einer Freitext-Nachricht |
| link | Übermittlung einer URL zum Vorgang |
| reservationStatus | Übermittlung des Reservierungsstatus |
| pickupCodeHR | Übermittlung eines menschenlesbares Abholcodes |
| pickupCodeDMC | Übermittlung eines maschinenlesbaren Abholcodes |
| deliveryStatus | Übermittlung des Lieferstatus |
| paymentInfo | Übermittlung eines Hinweises zum zu zahlenden Betrags |