# C_12173_Anlage - Communications v3

ML-167375 - E-Rezept: Communication Payload v3

[<=]

I nhaltsverzeichnis

#

- C_12173_Anlage - Communications v3
- 1 Änderungsbedarf
- 2 Änderung in gemILF_PS_eRp
- 2.1 Änderung in 5.3.9 Nachrichten von Versicherten empfangen
- 2.2 Überarbeitung 5.3.9 Nachricht an Versicherten versenden
- 3 Änderung in gemSpec_eRp_FdV
- 3.1 Änderung in 5.2.3.11 E-Rezept zuweisen
- 3.2 Änderung in 5.2.3.16 Nachrichten anzeigen
- 4 Änderung in gemSpec_FD_eRp
- 4.1 Änderung in 6.5.2.1 POST /Communication/
- 5 Änderung in gemSpec_DM_eRp
- 5.1 Änderung in 2.7 Nachrichten zwischen E-Rezept-FdV und abgebender LEI
- 5.1.1 Änderung in 2.7.1 E-Rezept einer Apotheke zuweisen
- 5.1.2 Änderung in 2.7.2 Nachricht durch Abgebenden übermitteln

## 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 | Versicherten-ID aus der Nachricht des Versicherten bestimmen Communication Ressource erstellen 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