Hier dokumentiert die gematik die Nutzung der Schnittstellen rund um das E-Rezept aus Sicht der verordnenden Primärsysteme, Kostenträger und Frontends der Versicherten für die Bearbeitung von DiGA-Verordnungen.
- Beschreibung Anwendungsfall DiGA Verordnung beliefern
- Profilierung
- Anwendungsfälle DiGA für Primärsysteme verordnender LEI
- Anwendungsfälle DiGA für Frontend des Versicherten
- Anwendungsfälle DiGA für Kostenträger
Mit diesem UseCase stellt ein verordnendes Primärsystem eine DiGA-Verordnung aus und stellt eine QES-signierte Verordnung im E-Rezept Fachdienst ein. Der Versicherte kann die Verordnung abrufen und muss sie dann aktiv seiner Krankenkasse, zum Erhalt eines Freischaltcodes, zuweisen. Das E-Rezept-FdV lädt das E-Rezept vom E-Rezept-Fachdienst herunter, ermittelt die Telematik-ID des Kostenträgers des Versicherten und weist die Verordnung dem Kostenträger zu. Damit werden Task-ID und AccessCode dem Kostenträger zur Bearbeitung bereitgestellt. Mit der Bekanntmachung der Task-ID und des AccessCodes durch den Versicherten mittels Kommunikationsnachricht liegen im Clientsystem des Kostenträgers alle notwendigen Parameter für den Abruf der Verordnung vor. Ist der Task inkl. des DiGA-Verordnungsdatensatzes heruntergeladen, kann das Clientsystem des Kostenträgers die Signatur des Datensatzes überprüfen. Ist die DiGA-Verordnung gültig signiert und die DiGA bereitgestellt, erfolgt der Abschluss der Transaktion mit dem Bereitstellen eines Abgabedatensatzes inklusive Freischaltcode der DiGA für den Versicherten. Der E-Rezept-Fachdienst erzeugt daraufhin eine Signatur als Quittung für den Kostenträger und beendet den Workflow. Falls kein Freischaltcode erzeugt werden konnte, erhält der Versicherte über die Abgabeinformationen eine entsprechende Begründung.
Für diesen Anwendungsfall werden die FHIR-Resourcen Task und MedicationDispense profiliert.
Die Profile können als JSON oder XML hier eingesehen werden:
Die für diese Anwendung wichtigen Attribute und Besonderheiten durch die Profilierung der Ressourcen werden in der folgenden Tabelle kurz zusammengefasst:
Name |
Beschreibung |
GEM_ERP_PR_Task |
|
identifier:PrescriptionID |
Rezept-ID; eindeutig für jedes Rezept |
identifier:AccessCode |
vom E-Rezept-Fachdienst generierter Berechtigungs-Code |
identifier:Secret |
vom E-Rezept-Fachdienst generierter Berechtigungs-Code |
status |
Status des E-Rezepts |
intent |
Intension des Tasks. Fixer Wert="order" |
for |
Krankenversichertennummer |
authoredOn |
Erstellungszeitpunkt des Tasks |
lastModified |
letzte Änderung am Task |
performerType |
Institution, in der das Rezept eingelöst werden soll |
input |
Verweis auf die für den Patienten und den Leistungserbringer gedachten Bundle |
output |
Verweis auf das Quittungs-Bundle |
extension:flowType |
gibt den Typ des Rezeptes an |
extension:expiryDate |
Verfallsdatum, 90 Tage nach Ausstellung der Verordnung |
extension:lastMedicationDispense |
Zeitpunkt der letzten Aktualisierung der Abgabeinformationen |
GEM_ERP_PR_MedicationDispense_DiGA |
|
identifier:PrescriptionID |
Rezept-ID; eindeutig für jedes Rezept |
status |
Status des E-Rezepts |
medicationReference |
Angaben zur DiGA |
medicationReference.identifier.value |
Eindeutiger Code der Verordnungseinheit |
medicationReference.display |
Name der Verordnungseinheit |
subject:identifier |
Krankenversichertennummer |
performer |
Telematik-ID des Kostenträgers, die das E-Rezept beliefert hat |
whenHandedOver |
Datum der Übergabe bzw. Herausgabe an den Versicherten |
Analog zum Anwendungsfall "E-Rezept erstellen" muss das Primärsystem der Verordnenden LEI die Task-ID für eine DiGA Verordnung vom E-Rezept-Fachdienst abfragen.
Hierfür wird eine Abfrage für einen neuen Task mit WorkflowType '162' erstellt.
Request
URI |
|||||
|---|---|---|---|---|---|
Method |
POST |
||||
HTTP Header |
Content-Type: application/fhir+xml; charset=UTF-8 Authorization: Bearer eyJraWQ.ewogImL2pA10Qql22ddtutrvx4FsDlz.rHQjEmB1lLmpqn9J
|
||||
Payload |
<Parameters xmlns="http://hl7.org/fhir">
<parameter>
<name value="workflowType"/>
<valueCoding>
<system value="https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_FlowType"/>
<code value="162"/>
</valueCoding>
</parameter>
</Parameters> |
Response
HTTP/1.1 201 Created
Content-Type: application/fhir+xml; charset=UTF-8
<Task xmlns="http://hl7.org/fhir">
<id value="162.123.456.789.123.58"/>
<meta>
<versionId value="1"/>
<lastUpdated value="2025-03-02T08:26:21.594+00:00"/>
<profile value="https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.4"/>
</meta>
<extension url="https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_PrescriptionType">
<valueCodeableConcept>
<coding>
<system value="https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_FlowType" />
<code value="162" />
<display value="Muster 16 (Digitale Gesundheitsanwendungen)" />
</coding>
</valueCodeableConcept>
</extension>
<identifier>
<use value="official"/>
<system value="https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId"/>
<value value="162.123.456.789.123.58"/>
</identifier>
<identifier>
<use value="official"/>
<system value="https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_AccessCode"/>
<value value="777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea"/>
</identifier>
<status value="draft"/>
<intent value="order"/>
<authoredOn value="2025-03-02T08:25:05+00:00"/>
<lastModified value="2025-03-02T08:25:05+00:00"/>
<performerType>
<coding>
<system value="urn:ietf:rfc:3986"/>
<code value="urn:oid:1.2.276.0.76.4.59"/>
<display value="Kostenträger"/>
</coding>
<text value="Kostenträger"/>
</performerType>
</Task>|
ℹ️
|
Der Wert urn:oid:1.2.276.0.76.4.59 entspricht dem intendierten Institutionstyp, in welchen der Versicherte für die Einlösung des Rezepts gelenkt werden soll (Kostenträger für Workflow 162).
|
Code |
Type Success |
201 |
Created |
Code |
Type Error |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
405 |
Method Not Allowed |
408 |
Request Timeout |
429 |
Too Many Requests |
500 |
Server Errors |
Nach Bereitstellung des Tasks für die DiGA-Verordnung muss das Primärsystem der Verordnenden LEI den Verordnungsdatensatz für die DiGA bereitstellen. Hierfür sind die Profile der KBV für die DiGA Verordnung zu verwenden.
Der Datensatz ist analog zum Arzneimittelkontext qualifiziert zu signieren und dann via POST am E-Rezept-Fachdienst einzustellen.
Ein Beispielhafter Aufruf kann auf der Seite "E-Rezept vervollständigen und Task aktivieren" eingesehen werden.
Wie im Kontext der Arzneimittelverordnung kann der Versicherte die DiGA-Verordnung abrufen. Siehe hierzu den Anwendungsfall "Alle E-Rezepte ansehen" und "Ein einzelnes E-Rezept abrufen".
Folgende Quellen dienen zur Unterstützung der Interpretation des Datensatzes:
Der Versicherte muss die Telematik-ID des Kostenträgers ermitteln, um die Verordnung dem Kostenträger zuweisen zu können.
Folgender Ablauf ist für die Bestimmung vorgesehen:
-
Ermitteln der IKNR des Kostenträgers des Versicherten
-
Anfrage an den FHIR Verzeichnisdienst der TI zur Ermittlung der Telematik-ID des Kostenträgers
-
Die Telematik-ID liegt vor und kann zur Zuweisung der Verordnung genutzt werden
Das E-Rezept-FdV ermittelt das IKNR des Versicherten aus den Authentifizierungsverfahren.
Im ACCESS_TOKEN des Versicherten ist die IKNR des Versicherten enthalten. Dies gilt für die Authentifizierung via zentralem IDP Dienst der TI, sowie über den Sektoralen IDP.
Die IKNR ist in beiden Fällen im claim organizationIK enthalten
Der FHIR-Verzeichnisdienst der TI stellt die Organisationen und deren HealthCareServices bereit. Als Entwicklungsunterstüztung kann der Implementation Guide für die Suche und die FHIR-Profile des FHIR-VZD eingesehen werden.
Um die Telematik-ID des Kostenträgers zu ermitteln ist die folgende Suchoperation durchzuführen:
-
Abfrage der Ressource "HealthcareService"HealthcareServices, deren Organisation aktiv sind
-
HealthcareServices, deren Organisation den Typ-oid "1.2.276.0.76.4.59" haben
-
HealthcareServices, deren Organisation einen Identifier vom Typ "IKNR" haben
-
HealthcareServices, deren Organisation eine IKNR mit IKNR aus dem ACCESS_TOKEN enthält
-
HealthcareServices, deren Organisation einen Identifier vom Typ "Telematik-ID" haben
-
Einbeziehen der Organisation in das Rückgabeergebnis
Das Ergebnis liefert genau eine Organisation und HealthCare Ressource.
Request
URI |
|
|---|---|
Method |
GET |
HTTP Header |
Authorization: Bearer eyJhbGciOiJCUDI1NlIxIiwidHlwIjoiSldUIn0.eyJpc3MiOiJodHRwczovL2ZoaXItZGlyZWN0b3J5LXJlZi52emQudGktZGllbnN0ZS5kZS90aW0tYXV0aGVudGljYXRlIiwiYXVkIjoiaHR0cHM6Ly9maGlyLWRpcmVjdG9yeS1yZWYudnpkLnRpLWRpZW5zdGUuZGUvc2VhcmNoIiwiZXhwIjoxNzE0NzU2OTMwLCJpYXQiOjE3MTQ2NzA1MzB9.P88pE2mjEfWe8s0V9ia9Cj2su0eQbCJS_8moso5ZgxZV_MkAyr2QXuvbRzgdCq--HZkmVV9u8CP37isxy1FaXw |
Response HTTP/1.1 200 OK Content-Length: 3906 Content-Type: application/fhir+xml;charset=utf-8
{
"resourceType": "Bundle",
"id": "1503938d-6761-4cdd-b0a9-3723d5b5a5e4",
"meta": {
"lastUpdated": "2024-07-02T12:57:06.425+02:00"
},
"type": "searchset",
"total": 2,
"entry": [
{
"fullUrl": "https://fhir-directory-ref.vzd.ti-dienste.de/search/HealthcareService/f86e1f95-08f1-4651-aed5-dfd82ce2b05e",
"resource": {
"resourceType": "HealthcareService",
"id": "f86e1f95-08f1-4651-aed5-dfd82ce2b05e",
"meta": {
"versionId": "4",
"lastUpdated": "2024-03-27T17:55:10.913+01:00",
"profile": [
"https://gematik.de/fhir/directory/StructureDefinition/HealthcareServiceDirectory"
],
"tag": [
{
"system": "https://gematik.de/fhir/directory/CodeSystem/Origin",
"code": "ldap",
"display": "Synchronized from LDAP VZD",
"userSelected": false
}
]
},
"identifier": [
{
"system": "https://gematik.de/fhir/directory/CodeSystem/ldapUID",
"value": "6f01ba0b-5d78-4bb1-a789-9a8be7f30ca3"
}
],
"providedBy": {
"reference": "Organization/235f4997-acea-41b3-85db-c54c4ffd2fc2"
},
"location": [
{
"reference": "Location/6ac29f34-f531-4fc2-b530-c1a9f143b1d1"
}
]
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://fhir-directory-ref.vzd.ti-dienste.de/search/Organization/235f4997-acea-41b3-85db-c54c4ffd2fc2",
"resource": {
"resourceType": "Organization",
"id": "235f4997-acea-41b3-85db-c54c4ffd2fc2",
"meta": {
"versionId": "2",
"lastUpdated": "2024-02-26T12:38:14.001+01:00",
"source": "#2WkZQ3ZhfsTF9vgi",
"profile": [
"https://gematik.de/fhir/directory/StructureDefinition/OrganizationDirectory"
],
"tag": [
{
"system": "https://gematik.de/fhir/directory/CodeSystem/Origin",
"code": "ldap",
"display": "Synchronized from LDAP VZD",
"userSelected": false
}
]
},
"identifier": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "PRN"
}
]
},
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "8-01-0000000232"
},
{
"system": "http://fhir.de/StructureDefinition/identifier-iknr",
"value": "107815761"
},
{
"system": "https://gematik.de/fhir/directory/CodeSystem/ldapUID",
"value": "6f01ba0b-5d78-4bb1-a789-9a8be7f30ca3"
}
],
"active": true,
"type": [
{
"coding": [
{
"system": "https://gematik.de/fhir/directory/CodeSystem/OrganizationProfessionOID",
"code": "1.2.276.0.76.4.59",
"display": "Betriebsstätte Kostenträger"
}
]
}
],
"name": "AOK Baden-Württemberg",
"alias": [
"AOK Baden-Württemberg NOT-VALID"
]
},
"search": {
"mode": "include"
}
}
]
}|
ℹ️
|
Im Ergebnis ist die Telematik-ID des Kostenträgers '8-01-0000000232' unter Organization.identifier mit identifier.type == 'PRN' enthalten. |
Für die Zuweisung einer Verordnung wird, wie auch im Arzneimittelkontext das Profil GEM_ERP_PR_Communication_DispReq verwendet und der Anwendungsfall analog zu "Anwendungsfall Ein E-Rezept verbindlich einer Apotheke zuweisen" durchgeführt.
Für diesen Anwendungsfall gibt es Abweichungen vom Arzneimittelprozess, die das E-Rezept-FdV beachten muss:
-
Es ist verpflichtend der WorkflowType anzugeben. Für DiGA Verordnungen ist das der Wert '162'
-
Wenn der Wert '162' angegeben ist, muss keine JSON-Payload unter .payload.contentString bereitgestellt werden
Es wird nur der E-Rezept-Token bereitgestellt, der es dem Kostenträger ermöglicht, die Verordnung abzurufen.
Ein Beispiel einer Zuweisung an einen Kostenträger:
{
"resourceType": "Communication",
"id": "2be1c6ac-5d10-47f6-84ee-8318b2c22c76",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Communication_DispReq|1.4"
],
"tag": [
{
"display": "Communication message sent by patient to pharmacy to request the dispensation of medicine by providing the AccessCode"
}
]
},
"status": "unknown",
"extension": [
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_PrescriptionType",
"valueCoding": {
"code": "162",
"system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_FlowType",
"display": "Muster 16 (Digitale Gesundheitsanwendungen)"
}
}
],
"recipient": [
{
"identifier": {
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "8-01-0000000232"
}
}
],
"basedOn": [
{
"reference": "Task/162.000.033.491.280.78/$accept?ac=777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea"
}
],
"sender": {
"identifier": {
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X234567890"
}
},
"sent": "2025-03-02T13:44:30.128+02:00"
}Zum Einsehen des Freischaltcodes ruft das E-Rezept-FdV die Abgabedaten analog zum Arzneimittelkontext ab. Siehe hierzu den Anwendungsfall "Abgabeinformationen abrufen".
Unter MedicationDispense.extension:redeemCode.valueString ist der Freischaltcode enthalten:
{
"resourceType": "MedicationDispense",
"id": "23dddf62-881c-4db9-8a96-22be7d58f7bd",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_MedicationDispense_DiGA|1.4"
]
},
"extension": [
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM-ERP-EX-RedeemCode",
"valueString": "DE12345678901234"
}
],
"identifier": [
{
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "162.123.456.789.123.58"
}
],
"status": "completed",
"medicationReference": {
"identifier": {
"system": "https://fhir.bfarm.de/Identifier/DigaVeId",
"value": "12345678"
},
"display": "Gematico Diabetestherapie"
},
"subject": {
"identifier": {
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X123456789"
}
},
"performer": [
{
"actor": {
"identifier": {
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "8-SMC-B-Testkarte-883110000095957"
}
}
}
],
"whenHandedOver": "2024-04-03"
}Der Empfang von Zuweisungen erfolgt via Abrufen von Communications am E-Rezept-Fachdienst. Dies erfolgt analog zu abgebenden LEI. Dabei kann ein "Subscription Service" genutzt werden, um über neue Zuweisungen informiert zu werden. Alternativ ist auch ein manuelles "Abfragen der Communications" möglich.
Der E-Rezept-Token, welcher die Task-ID und den AccessCode enthält ist in der Communication unter .basedOn.reference enthalten.
Ein Kostenträger hat vom Versicherten mittels Zuweisung die Informationen https://erp.zentral.erp.splitdns.ti-dienste.de/Task/162.123.456.789.123.58/$accept?ac=777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea für den Abruf eines E-Rezepts vom E-Rezept-Fachdienst erhalten.
Der Aufruf erfolgt als http-POST-Operation mit der FHIR-Operation $accept. Im http-Request-Header Authorization muss das während der Authentisierung erhaltene ACCESS_TOKEN übergeben werden. Als URL-Parameter ?ac=… muss der beim Erzeugen des Tasks generierte AccessCode für die Berechtigungsprüfung übergeben werden.
Im http-ResponseBody wird der referenzierte Task sowie das qualifiziert signierte E-Rezept als E-Rezept-Datensatz zurückgegeben, wobei im Task das secret als zusätzliches Geheimnis in einem Task.identifier generiert wird, das in allen folgenden Zugriffen durch den Apotheker mitgeteilt werden muss.
Request
URI |
|||
|---|---|---|---|
Method |
POST |
||
HTTP Header |
Content-Type: application/fhir+xml; charset=UTF-8 Authorization: Bearer eyJraWQ.ewogImL2pA10Qql22ddtutrvx4FsDlz.rHQjEmB1lLmpqn9J
|
Response
<Bundle xmlns="http://hl7.org/fhir">
<id value="d5e04846-e753-4a91-ab60-9e4c6fb4b533" />
<type value="collection" />
<timestamp value="2025-03-03T08:26:21.594+00:00" />
<link>
<relation value="self" />
<url
value="https://erp-ref.zentral.erp.splitdns.ti-dienste.de/Task/162.123.456.789.123.58/$accept/" />
</link>
<entry>
<fullUrl value="https://erp-ref.zentral.erp.splitdns.ti-dienste.de/Task/162.123.456.789.123.58" />
<resource>
<Task xmlns="http://hl7.org/fhir">
<id value="162.123.456.789.123.58" />
<meta>
<versionId value="1" />
<lastUpdated value="2025-03-03T08:26:21.594+00:00" />
<profile value="https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.4" />
</meta>
<extension url="https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_PrescriptionType">
<valueCodeableConcept>
<coding>
<system value="https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_FlowType" />
<code value="162" />
<display value="Muster 16 (Digitale Gesundheitsanwendungen)" />
</coding>
</valueCodeableConcept>
</extension>
<extension url="https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_ExpiryDate">
<valueDateTime value="2025-06-02" />
</extension>
<extension url="https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_AcceptDate">
<valueDateTime value="2025-06-02" />
</extension>
<identifier>
<use value="official" />
<system value="https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId" />
<value value="162.123.456.789.123.58" />
</identifier>
<identifier>
<use value="official" />
<system value="https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_AccessCode" />
<value value="777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea" />
</identifier>
<identifier>
<use value="official"/>
<system value="https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_Secret"/>
<value value="90bcf075768d582571ede9f241a8365bf8d12a19c6e353940ae070cb34f5fb7c"/>
</identifier>
<status value="draft" />
<intent value="order" />
<authoredOn value="2025-03-02T08:25:05+00:00" />
<lastModified value="2025-03-02T08:25:05+00:00" />
<performerType>
<coding>
<system value="urn:ietf:rfc:3986" />
<code value="urn:oid:1.2.276.0.76.4.59" />
<display value="Kostenträger" />
</coding>
<text value="Kostenträger" />
</performerType>
<for>
<identifier>
<system value="http://fhir.de/sid/gkv/kvid-10"/>
<value value="X123456789"/>
</identifier>
</for>
<owner>
<identifier>
<system value="https://gematik.de/fhir/sid/telematik-id" />
<value value="8-SMC-B-Testkarte-883110000116873" />
</identifier>
</owner>
<input>
<type>
<coding>
<system value="https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_DocumentType" />
<code value="1" />
</coding>
</type>
<valueReference>
<reference value="a061507a-0d00-0000-0001-000000000000" />
</valueReference>
</input>
</Task>
</resource>
</entry>
<entry>
<fullUrl value="urn:uuid:a061507a-0d00-0000-0001-000000000000" />
<resource>
<Binary xmlns="http://hl7.org/fhir">
<meta>
<versionId value="1" />
<profile value="https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Binary|1.2" />
</meta>
<contentType value="application/pkcs7-mime" />
<data value="MII1GwYJKoZIhvcNAQ..." />
</Binary>
</resource>
</entry>
</Bundle>Code |
Type Success |
200 |
OK |
Code |
Type Error |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not found |
405 |
Method Not Allowed |
408 |
Request Timeout |
409 |
Conflict |
410 |
Gone |
429 |
Too Many Requests |
500 |
Server Errors |
Nach bearbeiten des E-Rezeptes im Clientsystems des Kostenträgers erfolgt die Bereitstellung des Freischaltcodes des Versichten in den Abgabeinformationen des E-Rezeptes. Der Kostenträger erstellt eine Instanz des Profils GEM_ERP_PR_MedicationDispense_DiGA und stellt die Abgabeinformationen inklusive des Freischaltcodes via der $close-Operation bereit.
Der Aufruf erfolgt als http-POST-Operation mit der FHIR-Operation $close. Im http-Request-Header Authorization muss das während der Authentisierung erhaltene ACCESS_TOKEN übergeben werden. Als URL-Parameter ?secret=… muss das beim Abrufen des E-Rezepts im Task generierte Secret für die Berechtigungsprüfung übergeben werden. Zusätzlich werden Informationen über die DiGA, für die ein Freischaltcode bereitgestellt wurde, an den E-Rezept-Fachdienst übergeben.
Im http-ResponseBody wird die serverseitig über den Task und das E-Rezept-Bundle erzeugte Signatur als Quittungs-Bundle-Ressource zurückgegeben, die bestätigt, dass der Workflow erfolgreich abgeschlossen wurde.
In dem Falle, dass die Bearbeitung des E-Rezeptes ergibt, dass die Bereitstellung eines Freischaltcodes abgelehnt wird, kann der Workflow via $close abgeschlossen werden, ohne dass ein Freischaltcode bereitgestellt wird. In diesem Fall muss in MedicationDispense.note eine Begründung für die Ablehnung hinterlegt werden.
Request
URI |
https://erp.zentral.erp.splitdns.ti-dienste.de/Task/162.123.456.789.123.58/$close?secret=c36ca26502892b371d252c99b496e31505ff449aca9bc69e231c58148f6233cf |
||||||
|---|---|---|---|---|---|---|---|
Method |
POST |
||||||
HTTP Header |
Content-Type: application/fhir+xml; charset=UTF-8 Authorization: Bearer eyJraWQ.ewogImL2pA10Qql22ddtutrvx4FsDlz.rHQjEmB1lLmpqn9J
|
||||||
Payload |
<?xml version="1.0" encoding="UTF-8"?>
<MedicationDispense xmlns="http://hl7.org/fhir">
<id value="23dddf62-881c-4db9-8a96-22be7d58f7bd"/>
<meta>
<profile value="https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_MedicationDispense_DiGA|1.4"/>
</meta>
<extension url="https://gematik.de/fhir/erp/StructureDefinition/GEM-ERP-EX-RedeemCode">
<valueString value="DE12345678901234"/>
</extension>
<identifier>
<system value="https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId"/>
<value value="162.123.456.789.123.58"/>
</identifier>
<status value="completed"/>
<medicationReference>
<identifier>
<system value="https://fhir.bfarm.de/Identifier/DigaVeId"/>
<value value="12345678"/>
</identifier>
<display value="Gematico Diabetestherapie"/>
</medicationReference>
<subject>
<identifier>
<system value="http://fhir.de/sid/gkv/kvid-10"/>
<value value="X123456789"/>
</identifier>
</subject>
<performer>
<actor>
<identifier>
<system value="https://gematik.de/fhir/sid/telematik-id"/>
<value value="8-SMC-B-Testkarte-883110000095957"/>
</identifier>
</actor>
</performer>
<whenHandedOver value="2024-04-03"/>
</MedicationDispense>
|
Ein Kostenträger hat im vorherigen Schritt ein E-Rezept abgerufen und fachlich geprüft. Er kommt zu dem Schluss, das E-Rezept nicht zu beliefern und möchte nun das E-Rezept zurückweisen, damit der Versicherte das E-Rezept ggfs. bei einem anderen Kostenträger einlösen kann.
Der Aufruf erfolgt als http-POST-Operation mit der FHIR-Operation $reject. Im http-Request-Header Authorization muss das während der Authentisierung erhaltene ACCESS_TOKEN übergeben werden. Als URL-Parameter ?secret=… muss das beim Abrufen des E-Rezepts im Task generierte Secret für die Berechtigungsprüfung übergeben werden.
Request
URI |
https://erp.zentral.erp.splitdns.ti-dienste.de/Task/160.123.456.789.123.58/$reject?secret=c36ca26502892b371d252c99b496e31505ff449aca9bc69e231c58148f6233cf |
||||
|---|---|---|---|---|---|
Method |
POST |
||||
HTTP Header |
Content-Type: application/fhir+xml; charset=UTF-8; Authorization: Bearer eyJraWQ.ewogImL2pA10Qql22ddtutrvx4FsDlz.rHQjEmB1lLmpqn9J
|
Response
HTTP/1.1 204 No Content|
ℹ️
|
Im Ergebnis der $reject-Operation wird der referenzierte Task auf den aktiven Status ready zurückgesetzt und das Secret gelöscht. Dementsprechend werden keine Daten an den aufrufenden Client zurückgegeben.
|
|
ℹ️
|
Ein Löschen des E-Rezeptes seitens des Kostenträgers ist nicht möglich. |
Code |
Type Success |
204 |
No Content |
Code |
Type Error |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not found |
405 |
Method Not Allowed |
408 |
Request Timeout |
410 |
Gone |
429 |
Too Many Requests |
500 |
Server Errors |