C_12173_Anlage_V1.0.0


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.):

  1. Anzeige eines Freitextes (text)
  2. Anzeige einer URL (link)
    • Es muss verpflichtend ein Text mitgegeben werden, der das Ziel der URL für den Versicherten beschreibt.
  3. Hinweis zum Reservierungsstatus
    • Für den referenzierten Task wird der Versicherte darüber informiert, wann die Ware verfügbar ist.
  4. Abholcode menschenlesbar (pickupCodeHR)
  5. Abholcode Abholautomat (pickupCodeDMC)
  6. Hinweis zum Lieferzustand (deliveryStatus)
    • Für delivery und shipment können Zustände der Lieferung übergeben werden.
  7. 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
  • Aufruf des Anwendungsfalls in der GUI
Akteur Leistungserbringer, Mitarbeiter der abgebenden LEI
Vorbedingung
  • Die LEI hat eine E-Rezept-Nachricht vom E-Rezept-Fachdienst heruntergeladen.
  • Der Nutzer hat eine Mitteilung als Antwort auf die Nachricht erfasst.
  • Die LEI hat sich gegenüber der TI authentisiert.
Nachbedingung
  • Auf dem E-Rezept-Fachdienst steht eine E-Rezept-Nachricht für den Versicherten bereit.
Standardablauf
  1. Versicherten-ID aus der Nachricht des Versicherten bestimmen
  2. Communication Ressource erstellen
  3. E-Rezept-Nachricht auf Fachdienst einstellen
[<=]

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
erstellen. [<=]

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 
erstellen. [<=]

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
ausführen. [<=]

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
email 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