Zielgruppe:
Hier dokumentiert die gematik die Nutzung der Schnittstellen rund um das E-Rezept aus Sicht der Versicherten, die ihre E-Rezepte verwalten und einlösen möchten.
- Anwendungsfälle E-Rezept als Versicherter verwalten
- Profilierung
- Alle E-Rezepte ansehen
- Ein einzelnes E-Rezept abrufen und in der Apotheke einlösen
- Informationen an den Apotheker übergeben
- Eine Apotheke aus dem Apotheken-Verzeichnis auswählen
- Abgabeinformationen abrufen
- Abgabeinformationen zu einem E-Rezept abrufen
- Mehrere Abgabeinformationen zu einem E-Rezept abrufen
- Ein E-Rezept löschen
- Einsicht in das Zugriffsprotokoll
Der Versicherte hat mit der E-Rezept-App die Möglichkeit, seine E-Rezepte zu verwalten, Zugriffsprotokolle einzusehen und sich zusätzliche Informationen über das herausgegebene Medikament herunterzuladen.
Verzichtet er bei der Handhabung des E-Rezepts auf einen Papierausdruck in der Arztpraxis, erfolgt die Einlösung des E-Rezeptes ebenso über die E-Rezept-App. Dafür generiert die E-Rezept-App aus den heruntergeladenen E-Rezept-Daten einen 2D-Code (DataMatrix-Darstellung), den er in der Apotheke vom Bildschirm seines Smartphones abscannen lässt. Mit den abgescannten Informationen erhält der Apotheker die Adresse und Zugriffsberechtigung des E-Rezepts, um seinerseits das E-Rezept herunterzuladen und den Versicherten dann mit dem Medikament versorgen zu dürfen.
Einige der nachfolgenden UseCases sind auch für Vertreter des Versicherten vorgesehen, dabei sind sie bspw. berechtigt, ein E-Rezept einzusehen bzw. herunterzuladen, wenn sie im Wissen um den zugehörigen AccessCode sind, den sie vom Versicherten mitgeteilt bekommen (z.B. durch Abscannen des 2D-Codes vom Smartphone des Versicherten).
Die Kommunikation zwischen Versicherten und einer Apotheke über E-Rezepte erfolgt ebenfalls über den Dienst zur Verwaltung der E-Rezepte. Aus Gründen der besseren Lesbarkeit und der Darstellung der Zusammenhänge zwischen Anfrage zur Verfügbarkeit eines Medikaments und der Antwort einer Apotheke erfolgt die Beschreibung über das an dieser Stelle verlinkte Dokument.
In diesen Anwendungsfällen werden die FHIR-Resourcen "Task": http://hl7.org/fhir/R4/task.html und AuditEvent https://www.hl7.org/fhir/auditevent.html verwendet. Die Ressource Bundle https://www.hl7.org/fhir/bundle.html kommt in ihrem Standardprofil als Suchergebnis und zusätzlich als signiertes Dokument der Verordnung und als Quittung zur Anwendung.
Diese werden für das E-Rezept profiliert und werden hier spezifiziert:
Task: https://simplifier.net/erezept-workflow/gem_erp_pr_task
AuditEvent: https://simplifier.net/erezept-workflow/gem_erp_pr_auditevent
Als Versicherter möchte ich all meine E-Rezepte einsehen.
Der Aufruf erfolgt als http-GET-Operation auf die Ressource /Task. Im Aufruf muss das während der Authentisierung erhaltene ACCESS_TOKEN im http-Request-Header Authorization übergeben werden, der Fachdienst filtert die Task-Einträge nach der im ACCESS_TOKEN enthaltenen KVNR des Versicherten.
Es wird empfohlen beim Abruf der Tasks den Zeitstempel der letzten Abfrage zu übergeben, um nur die Tasks abzurufen, die sich seit der letzten Abfrage geändert haben. Dieser Zeitstempel wird als URL-Parameter ?lastmodified=ge<Zeitstempel der letzten Anfrage> übergeben.
Request
URI |
|||||
|---|---|---|---|---|---|
Method |
GET |
||||
Requester |
|||||
Responder |
|||||
HTTP Header |
Authorization: Bearer eyJraWQ.ewogImL2pA10Qql22ddtutrvx4FsDlz.rHQjEmB1lLmpqn9J
|
||||
URL Parameter |
status, authored-on, modified |
||||
Payload |
- |
Response
HTTP/1.1 200 OK
Content-Type: application/fhir+json;charset=utf-8{
"resourceType": "Bundle",
"id": "erp-versicherte-01-response-taskGetAll",
"meta": {
"lastUpdated": "2025-01-15T15:29:00.434+00:00"
},
"type": "collection",
"link": [
{
"relation": "self",
"url": "https://erp.app.ti-dienste.de/Task/"
}
],
"entry": [
{
"fullUrl": "https://erp.app.ti-dienste.de/Task/160.000.000.000.000.01",
"resource": {
"resourceType": "Task",
"id": "160.000.000.000.000.01",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.4"
]
},
"intent": "order",
"extension": [
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_PrescriptionType",
"valueCoding": {
"code": "160",
"system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_FlowType",
"display": "Muster 16 (Apothekenpflichtige Arzneimittel)"
}
},
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_AcceptDate",
"valueDate": "2025-02-12"
},
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_ExpiryDate",
"valueDate": "2025-04-15"
}
],
"identifier": [
{
"use": "official",
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "160.000.000.000.000.01"
},
{
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_AccessCode",
"use": "official",
"value": "777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea"
}
],
"for": {
"identifier": {
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X123456789"
}
},
"status": "ready",
"authoredOn": "2025-01-15T15:29:00+00:00",
"lastModified": "2025-01-15T15:29:00.434+00:00",
"performerType": [
{
"coding": [
{
"code": "urn:oid:1.2.276.0.76.4.54",
"system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_OrganizationType",
"display": "Öffentliche Apotheke"
}
],
"text": "Öffentliche Apotheke"
}
]
}
},
{
"fullUrl": "https://erp.app.ti-dienste.de/Task/160.000.000.000.000.02",
"resource": {
"resourceType": "Task",
"id": "160.000.000.000.000.02",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.4"
]
},
"intent": "order",
"extension": [
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_PrescriptionType",
"valueCoding": {
"code": "160",
"system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_FlowType",
"display": "Muster 16 (Apothekenpflichtige Arzneimittel)"
}
},
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_AcceptDate",
"valueDate": "2025-02-12"
},
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_ExpiryDate",
"valueDate": "2025-04-15"
}
],
"identifier": [
{
"use": "official",
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "160.000.000.000.000.02"
},
{
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_AccessCode",
"use": "official",
"value": "777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea"
}
],
"for": {
"identifier": {
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X123456789"
}
},
"status": "ready",
"authoredOn": "2025-01-15T15:29:00+00:00",
"lastModified": "2025-01-15T15:29:00.434+00:00",
"performerType": [
{
"coding": [
{
"code": "urn:oid:1.2.276.0.76.4.54",
"system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_OrganizationType",
"display": "Öffentliche Apotheke"
}
],
"text": "Öffentliche Apotheke"
}
]
}
},
{
"fullUrl": "https://erp.app.ti-dienste.de/Task/160.000.000.000.000.03",
"resource": {
"resourceType": "Task",
"id": "160.000.000.000.000.03",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.4"
]
},
"intent": "order",
"extension": [
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_PrescriptionType",
"valueCoding": {
"code": "160",
"system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_FlowType",
"display": "Muster 16 (Apothekenpflichtige Arzneimittel)"
}
},
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_AcceptDate",
"valueDate": "2025-02-12"
},
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_ExpiryDate",
"valueDate": "2025-04-15"
}
],
"identifier": [
{
"use": "official",
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "160.000.000.000.000.03"
},
{
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_AccessCode",
"use": "official",
"value": "777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea"
}
],
"for": {
"identifier": {
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X123456789"
}
},
"status": "ready",
"authoredOn": "2025-01-15T15:29:00+00:00",
"lastModified": "2025-01-15T15:29:00.434+00:00",
"performerType": [
{
"coding": [
{
"code": "urn:oid:1.2.276.0.76.4.54",
"system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_OrganizationType",
"display": "Öffentliche Apotheke"
}
],
"text": "Öffentliche Apotheke"
}
]
}
}
]
}
|
ℹ️
|
Mit dem AccessCode "value":"777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea" wird der Zugriff für Vertreter und Apotheker gesteuert, in dem der Versicherte diesen AccessCode z.B. als QR-Code weitergibt
|
|
ℹ️
|
Der Prozesstyp referenziert die Workflow-Definition, in diesem Fall den Prozess für apothekenpflichtige Arzneimittel mit "url":"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_PrescriptionType"
|
|
ℹ️
|
Mit der Angabe "display":"Öffentliche Apotheke" kann dem Versicherten ein Hinweis angezeigt werden, wo er das E-Rezept einlösen kann (bspw. Apotheke oder Sanitätshaus).
|
|
ℹ️
|
Wenn ein Task sich im Status "in-progress" befindet und das Feld Task.extension:lastMedicationDispense befüllt ist, stehen dem Task auch Abgabeinformationen zur Verfügung und beschreibt den Zeitpunkt, an dem der Versicherte sein Arzneimittel übergeben bekommen hat. Das E-Rezept-FdV kann dem Versicherten dann darstellen, dass das E-Rezept beliefert wurde bevor der Vorgang mit Aufruf der $close-Operation abgeschlossen wurde. Bis der Task nicht abgeschlossen ist, können die Abgabeinformationen gelöscht oder geändert werden. Dabei wird das Feld lastMedicationDispense aktualisiert. Wenn das AVS den Workflow mittels der $close-Operation abschließt, wird der Status auf "complete" gesetzt, und eine Änderung der Abgabeinformationen ist nicht mehr möglich. |
Code |
Type Success |
200 |
OK |
Code |
Type Error |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
405 |
Method Not Allowed |
429 |
Too Many Requests |
500 |
Server Errors |
Der Zugriff auf ein einzelnes E-Rezept ist durch den Versicherten mit Nachweis seiner Identität immer zulässig. Als Vertreter ist der Zugriff auf ein E-Rezept eines anderen Versicherten nur gestattet, wenn der Vertreter in Kenntnis des beim Einstellen des E-Rezepts erzeugten AccessCodes ist.
Der Aufruf erfolgt als http-GET-Operation auf eine konkrete Ressource /Task/<task_id>. Im Aufruf muss das während der Authentisierung erhaltene ACCESS_TOKEN im http-Request-Header Authorization übergeben werden. Der Aufruf kann auch durch einen Vertreter des Versicherten erfolgen, hierbei wird lediglich die Rolle Versicherter im ACCESS_TOKEN geprüft. Um die Berechtigung für den Zugriff auf einen Task mit einer fremden KVNR nachzuweisen, muss der Zugreifende den richtigen AccessCode im http-Request-Header X-AccessCode übergeben. Die Rückgabe eines Tasks erfolgt immer zusammen mit dem entsprechenden, signierten E-Rezept-Datensatz zu diesem Task, welcher die Verordnungsinformationen des E-Rezepts enthält.
Die durch den Verordnenden signierten Daten der Verordnung ändern sich nach dem Einstellen (Activate Operation) nicht mehr. Dies betrifft insbesondere die Statuswechsel des E-Rezepts. Die Informationen müssen nicht widerholt heruntergeladen werden, wenn sie bereits in der App für die Anzeige vorliegen.
Beim Statusübergang zu "cancelled" werden die Informationen zum E-Rezept ausser dem Status des Task gelöscht. Somit liefert der E-Rezept-Fachdienst keine Details. Ein GET /Task/<task_id> für E-Rezepte mit dem Status "cancelled" sind nicht zulässig.
Beim Statusübergang zu "closed" stehen die MedicationDispense Informationen zur Verfügung und können abgefragt werden.
Request
URI |
|||||||||
|---|---|---|---|---|---|---|---|---|---|
Method |
GET |
||||||||
Requester |
|||||||||
Responder |
|||||||||
HTTP Header |
Authorization: Bearer eyJraWQ.ewogImL2pA10Qql22ddtutrvx4FsDlz.rHQjEmB1lLmpqn9J X-AccessCode: 777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea
|
||||||||
Payload |
- |
Response HTTP/1.1 200 OK Content-Type: application/fhir+json;charset=utf-8
{
"resourceType": "Bundle",
"id": "erp-versicherte-02-response-taskGetSingle",
"meta": {
"lastUpdated": "2025-01-15T15:29:00.434+00:00"
},
"type": "collection",
"link": [
{
"relation": "self",
"url": "https://erp.app.ti-dienste.de/Task/160.000.000.000.000.01"
}
],
"entry": [
{
"fullUrl": "https://erp.app.ti-dienste.de/Task/160.000.000.000.000.01",
"resource": {
"resourceType": "Task",
"id": "160.000.000.000.000.01",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.4"
]
},
"intent": "order",
"extension": [
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_PrescriptionType",
"valueCoding": {
"code": "160",
"system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_FlowType",
"display": "Muster 16 (Apothekenpflichtige Arzneimittel)"
}
},
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_AcceptDate",
"valueDate": "2025-02-12"
},
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_ExpiryDate",
"valueDate": "2025-04-15"
}
],
"identifier": [
{
"use": "official",
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "160.000.000.000.000.01"
},
{
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_AccessCode",
"use": "official",
"value": "777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea"
}
],
"for": {
"identifier": {
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X123456789"
}
},
"status": "ready",
"authoredOn": "2025-01-15T15:29:00+00:00",
"lastModified": "2025-01-15T15:29:00.434+00:00",
"performerType": [
{
"coding": [
{
"code": "urn:oid:1.2.276.0.76.4.54",
"system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_OrganizationType",
"display": "Öffentliche Apotheke"
}
],
"text": "Öffentliche Apotheke"
}
],
"input": [
{
"type": {
"coding": [
{
"code": "2",
"system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_DocumentType"
}
]
},
"valueReference": {
"reference": "414ca393-dde3-4082-9a3b-3752e629e4aa"
}
}
]
}
},
{
"fullUrl": "urn:uuid:414ca393-dde3-4082-9a3b-3752e629e4aa",
"resource": {
"resourceType": "Bundle",
"id": "414ca393-dde3-4082-9a3b-3752e629e4aa",
"meta": {
"profile": [
"https://fhir.kbv.de/StructureDefinition/KBV_PR_ERP_Bundle|1.1.0"
],
"lastUpdated": "2025-01-15T15:29:00.434+00:00"
},
"type": "document",
"identifier": {
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "160.000.000.000.000.01"
},
"timestamp": "2025-01-15T15:29:00.434+00:00",
"entry": [
{
"fullUrl": "http://pvs.praxis-topp-gluecklich.local/fhir/Composition/b0e22b86-e7e9-46c1-80fe-e6e24442d77c",
"resource": {
"resourceType": "Composition",
"id": "b0e22b86-e7e9-46c1-80fe-e6e24442d77c",
"meta": {
"profile": [
"https://fhir.kbv.de/StructureDefinition/KBV_PR_ERP_Composition|1.1.0"
]
},
"status": "final",
"title": "elektronische Arzneimittelverordnung",
"author": [
{
"type": "Practitioner",
"reference": "Practitioner/d8463daf-258e-4cad-a86a-6fd42fac161c"
},
{
"identifier": {
"system": "https://fhir.kbv.de/NamingSystem/KBV_NS_FOR_Pruefnummer",
"value": "Y/400/1910/36/346"
},
"type": "Device"
}
],
"type": {
"coding": [
{
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_FORMULAR_ART",
"code": "e16A"
}
]
},
"extension": [
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_FOR_Legal_basis",
"valueCoding": {
"code": "00",
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_STATUSKENNZEICHEN"
}
}
],
"attester": [
{
"mode": "legal",
"party": {
"reference": "Practitioner/20597e0e-cb2a-45b3-95f0-dc3dbdb617c3"
}
}
],
"section": [
{
"code": {
"coding": [
{
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_ERP_Section_Type",
"code": "Prescription"
}
]
},
"entry": [
{
"reference": "MedicationRequest/f58f4403-7a3a-4a12-bb15-b2fa25b02561"
}
]
},
{
"code": {
"coding": [
{
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_ERP_Section_Type",
"code": "Coverage"
}
]
},
"entry": [
{
"reference": "Coverage/1b1ffb6e-eb05-43d7-87eb-Cov-GKV"
}
]
}
],
"subject": {
"reference": "Patient/9774f67f-a238-4daf-b4e6-Pat-GKV"
},
"date": "2025-01-15T15:29:00.434+00:00",
"custodian": {
"reference": "Organization/cf042e44-086a-4d51-9c77-172f9a972e3b"
}
}
},
{
"fullUrl": "http://pvs.praxis-topp-gluecklich.local/fhir/MedicationRequest/f58f4403-7a3a-4a12-bb15-b2fa25b02561",
"resource": {
"resourceType": "MedicationRequest",
"id": "f58f4403-7a3a-4a12-bb15-b2fa25b02561",
"meta": {
"profile": [
"https://fhir.kbv.de/StructureDefinition/KBV_PR_ERP_Prescription|1.1.0"
]
},
"status": "active",
"intent": "order",
"extension": [
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_EmergencyServicesFee",
"valueBoolean": false
},
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_BVG",
"valueBoolean": false
},
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Multiple_Prescription",
"extension": [
{
"url": "Kennzeichen",
"valueBoolean": true
},
{
"url": "Nummerierung",
"valueRatio": {
"numerator": {
"value": 2
},
"denominator": {
"value": 4
}
}
},
{
"url": "Zeitraum",
"valuePeriod": {
"start": "2025-01-15",
"end": "2025-02-14"
}
},
{
"valueIdentifier": {
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:24e2e10d-e962-4d1c-be4f-8760e690a5f0"
},
"url": "ID"
}
]
},
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_FOR_StatusCoPayment",
"valueCoding": {
"code": "0",
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_FOR_StatusCoPayment"
}
},
{
"extension": [
{
"url": "Unfallkennzeichen",
"valueCoding": {
"code": "1",
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_FOR_Ursache_Type"
}
},
{
"url": "Unfalltag",
"valueDate": "2025-01-15"
}
],
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_FOR_Accident"
}
],
"dispenseRequest": {
"quantity": {
"system": "http://unitsofmeasure.org",
"code": "{Package}",
"value": 2
}
},
"dosageInstruction": [
{
"extension": [
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_DosageFlag",
"valueBoolean": false
}
]
}
],
"medicationReference": {
"reference": "Medication/e3a4efa7-84fc-465b-b14c-720195097783"
},
"subject": {
"reference": "Patient/9774f67f-a238-4daf-b4e6-Pat-GKV"
},
"authoredOn": "2025-01-15",
"requester": {
"reference": "Practitioner/d8463daf-258e-4cad-a86a-6fd42fac161c"
},
"insurance": [
{
"reference": "Coverage/1b1ffb6e-eb05-43d7-87eb-Cov-GKV"
}
],
"note": [
{
"text": "Dummy-Hinweis für die Apotheke"
}
]
}
},
{
"fullUrl": "http://pvs.praxis-topp-gluecklich.local/fhir/Medication/e3a4efa7-84fc-465b-b14c-720195097783",
"resource": {
"resourceType": "Medication",
"id": "e3a4efa7-84fc-465b-b14c-720195097783",
"meta": {
"profile": [
"https://fhir.kbv.de/StructureDefinition/KBV_PR_ERP_Medication_Ingredient|1.1.0"
]
},
"extension": [
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Category",
"valueCoding": {
"code": "00",
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_ERP_Medication_Category"
}
},
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Vaccine",
"valueBoolean": false
}
],
"code": {
"coding": [
{
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_ERP_Medication_Type",
"code": "wirkstoff"
}
]
},
"ingredient": [
{
"strength": {
"denominator": {
"value": 1
},
"numerator": {
"value": 800,
"unit": "mg"
}
},
"itemCodeableConcept": {
"coding": [
{
"code": "Dummy-ASK",
"system": "http://fhir.de/CodeSystem/ask"
}
],
"text": "Ibuprofen"
}
}
],
"amount": {
"numerator": {
"extension": [
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_PackagingSize",
"valueString": "2x20"
}
],
"unit": "Stk"
},
"denominator": {
"value": 1
}
},
"form": {
"text": "Tabletten"
}
}
},
{
"fullUrl": "http://pvs.praxis-topp-gluecklich.local/fhir/Patient/9774f67f-a238-4daf-b4e6-Pat-GKV",
"resource": {
"resourceType": "Patient",
"id": "9774f67f-a238-4daf-b4e6-Pat-GKV",
"meta": {
"profile": [
"https://fhir.kbv.de/StructureDefinition/KBV_PR_FOR_Patient|1.1.0"
]
},
"identifier": [
{
"type": {
"coding": [
{
"system": "http://fhir.de/CodeSystem/identifier-type-de-basis",
"code": "GKV"
}
]
},
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X234567890"
}
],
"name": [
{
"use": "official",
"family": "Ludger Königsstein",
"_family": {
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/humanname-own-name",
"valueString": "Königsstein"
}
]
},
"given": [
"Ludger"
]
}
],
"address": [
{
"type": "both",
"line": [
"Musterstr. 1"
],
"_line": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber",
"valueString": "1"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName",
"valueString": "Musterstr."
}
]
}
],
"city": "Berlin",
"postalCode": "10623"
}
],
"birthDate": "1935-06-22"
}
},
{
"fullUrl": "http://pvs.praxis-topp-gluecklich.local/fhir/Practitioner/20597e0e-cb2a-45b3-95f0-dc3dbdb617c3",
"resource": {
"resourceType": "Practitioner",
"id": "20597e0e-cb2a-45b3-95f0-dc3dbdb617c3",
"meta": {
"profile": [
"https://fhir.kbv.de/StructureDefinition/KBV_PR_FOR_Practitioner|1.1.0"
]
},
"name": [
{
"use": "official",
"prefix": [
"Dr. med."
],
"_prefix": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier",
"valueCode": "AC"
}
]
}
],
"family": "Topp-Glücklich",
"_family": {
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/humanname-own-name",
"valueString": "Topp-Glücklich"
}
]
},
"given": [
"Hans"
]
}
],
"qualification": [
{
"code": {
"coding": [
{
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_FOR_Qualification_Type",
"code": "00"
}
]
}
},
{
"code": {
"coding": [
{
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_FOR_Berufsbezeichnung",
"code": "Berufsbezeichnung"
}
],
"text": "FA Biochemie"
}
}
],
"identifier": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "LANR"
}
]
},
"system": "https://fhir.kbv.de/NamingSystem/KBV_NS_Base_ANR",
"value": "838382202"
}
]
}
},
{
"fullUrl": "http://pvs.praxis-topp-gluecklich.local/fhir/Practitioner/d8463daf-258e-4cad-a86a-6fd42fac161c",
"resource": {
"resourceType": "Practitioner",
"id": "d8463daf-258e-4cad-a86a-6fd42fac161c",
"meta": {
"profile": [
"https://fhir.kbv.de/StructureDefinition/KBV_PR_FOR_Practitioner|1.1.0"
]
},
"name": [
{
"use": "official",
"family": "Meier",
"_family": {
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/humanname-own-name",
"valueString": "Meier"
}
]
},
"given": [
"Jörgen"
]
}
],
"qualification": [
{
"code": {
"coding": [
{
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_FOR_Qualification_Type",
"code": "03"
}
]
}
},
{
"code": {
"coding": [
{
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_FOR_Berufsbezeichnung",
"code": "Berufsbezeichnung"
}
],
"text": "FA Onkologie"
}
}
],
"identifier": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "LANR"
}
]
},
"system": "https://fhir.kbv.de/NamingSystem/KBV_NS_Base_ANR",
"value": "838382210"
}
]
}
},
{
"fullUrl": "http://pvs.praxis-topp-gluecklich.local/fhir/Organization/cf042e44-086a-4d51-9c77-172f9a972e3b",
"resource": {
"resourceType": "Organization",
"id": "cf042e44-086a-4d51-9c77-172f9a972e3b",
"meta": {
"profile": [
"https://fhir.kbv.de/StructureDefinition/KBV_PR_FOR_Organization|1.1.0"
]
},
"telecom": [
{
"system": "phone",
"value": "0301234567"
}
],
"address": [
{
"type": "both",
"line": [
"Musterstr. 2"
],
"_line": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber",
"valueString": "2"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName",
"valueString": "Musterstr."
}
]
}
],
"city": "Berlin",
"postalCode": "10623"
}
],
"identifier": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "BSNR"
}
]
},
"system": "https://fhir.kbv.de/NamingSystem/KBV_NS_Base_BSNR",
"value": "031234567"
}
],
"name": "Hausarztpraxis Dr. Topp-Glücklich"
}
},
{
"fullUrl": "http://pvs.praxis-topp-gluecklich.local/fhir/Coverage/1b1ffb6e-eb05-43d7-87eb-Cov-GKV",
"resource": {
"resourceType": "Coverage",
"id": "1b1ffb6e-eb05-43d7-87eb-Cov-GKV",
"meta": {
"profile": [
"https://fhir.kbv.de/StructureDefinition/KBV_PR_FOR_Coverage|1.1.0"
]
},
"status": "active",
"payor": [
{
"identifier": {
"system": "http://fhir.de/sid/arge-ik/iknr",
"value": "104212059"
},
"display": "AOK Rheinland/Hamburg"
}
],
"extension": [
{
"url": "http://fhir.de/StructureDefinition/gkv/besondere-personengruppe",
"valueCoding": {
"code": "00",
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_PERSONENGRUPPE"
}
},
{
"url": "http://fhir.de/StructureDefinition/gkv/dmp-kennzeichen",
"valueCoding": {
"code": "00",
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DMP"
}
},
{
"url": "http://fhir.de/StructureDefinition/gkv/wop",
"valueCoding": {
"code": "03",
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_ITA_WOP"
}
},
{
"url": "http://fhir.de/StructureDefinition/gkv/versichertenart",
"valueCoding": {
"code": "1",
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_VERSICHERTENSTATUS"
}
}
],
"type": {
"coding": [
{
"code": "GKV",
"system": "http://fhir.de/CodeSystem/versicherungsart-de-basis"
}
]
},
"beneficiary": {
"reference": "Patient/9774f67f-a238-4daf-b4e6-Pat-GKV"
}
}
}
]
}
}
]
}|
ℹ️
|
Mit dem AccessCode in "value":"777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea" wird der Zugriff für Vertreter und Apotheker gesteuert, in dem der Versicherte diesen AccessCode z.B. als QR-Code weitergibt.
|
|
ℹ️
|
Bei "value":"X123456789" ist die KVNR des Versicherten enthalten, nach welcher die Rezept-Tasks gefiltert wurden. Im Ergebnis wurde nur ein einzelnes E-Rezept gefunden.
|
|
ℹ️
|
Der Prozesstyp in "url":"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_PrescriptionType" referenziert die Workflow-Definition, in diesem Fall den Prozess für apothekenpflichtige Arzneimittel.
|
|
ℹ️
|
Mit der Angabe ` "display":"Öffentliche Apotheke"` kann dem Versicherten ein Hinweis angezeigt werden, wo er das E-Rezept einlösen kann (bspw. Apotheke oder Sanitätshaus). |
|
ℹ️
|
Mit "valueString": "f8c2298f-7c00-4a68-af29-8a2862d55d43" verweist der Task auf das signierte E-Rezept-Bundle im zurückgegebenen Bundle.
|
|
ℹ️
|
Aus Gründen der besseren Lesbarkeit ist das E-Rezept-Bundle hier nicht vollständig dargestellt. Ein komplettes Beispiel kann hier eingesehen werden: https://simplifier.net/eRezept/0428d416-149e-48a4-977c-394887b3d85c/~json. |
|
ℹ️
|
Bei der Rückgabe der Verordnung an den Versicherten wird eine vom E-Rezept-Fachdienst erstellte Signatur des E-Rezept-Bundles übertragen. Diese muss vom E-Rezept-FdV nicht validiert werden. |
Code |
Type Success |
200 |
OK |
Code |
Type Error |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not found |
405 |
Method Not Allowed |
429 |
Too Many Requests |
500 |
Server Errors |
Um den Apotheker in die Lage zu versetzen, das E-Rezept einsehen zu können, müssen ihm die folgenden zwei Parameter für seinen Abruf übergeben werden, z.B. in Form eines QR-Codes oder DataMatrix-Codes:
-
AccessCode:
777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea -
Adresse des Tasks unter dem das E-Rezept geführt wird:
https://erp.app.ti-dienste.de/Task/160.000.000.000.000.01
Diese Informationen lassen sich nach den Vorgaben in ISO/IEC 18004:2015 in einen QR-Code oder gemäß ISO/IEC 16022:2006 in einen DataMatrix-Code transformieren.
{
"urls": [ "Task/160.000.000.000.000.01/$accept?ac=777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea" ]
} |
In DataMatrix-Darstellung gemäß ISO/IEC 16022:2006 |
Sammlung von drei E-Rezept-Referenzen in einem 2D-Code {
"urls": [
"Task/160.000.000.000.000.01/$accept?ac=777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea",
"Task/160.346.135.722.516.16/$accept?ac=0936cfa582b447144b71ac89eb7bb83a77c67c99d4054f91ee3703acf5d6a629",
"Task/160.880.966.157.248.22/$accept?ac=d3e6092ae3af14b5225e2ddbe5a4f59b3939a907d6fdd5ce6a760ca71f45d8e5"
]
} |
In DataMatrix-Darstellung gemäß ISO/IEC 16022:2006 |
|
ℹ️
|
Aktuell unterstüten die Apothekenverwaltungssysteme auf Basis des SecurPharm-System in jedem Fall das DataMatrix-Format. |
Als Versicherter möchte ich eine Apotheke aus einem Verzeichnis wählen, um ihr eine Verfügbarkeitsanfrage zu meinem E-Rezept zu schicken oder ihr ein E-Rezept direkt zuzuweisen. Der Verzeichnisdienst der Telematikinfrastruktur führt eine Liste aller (Zahn-)Arztpraxen, Krankenhäuser und Apotheken in Deutschland, in der nach einer Apotheke über z.B. den Namen oder die Postleitzahl für eine Umgebungssuche gesucht werden kann. Im folgenden Beispiel wird die Suche nach Apotheken im Umkreis von 7 km um den aktuellen Standort ausgeführt.
https://apovzd.app.ti-dienste.de/api/Location?near=48.13129322109354%7C11.563464055060686%7C999%7Ckm
Folgende Suchalternativen sind ebenfalls möglich:
-
Suche nach einer Apotheke mit konkretem Namen "Apotheke um die Ecke"
https://apovzd.app.ti-dienste.de/api/Location?name=Apotheke%20um%20die%20Ecke -
Suche nach allen Apotheken in "Berlin"
https://apovzd.app.ti-dienste.de/api/Location?address-city=Berlin
Der Aufruf erfolgt als http-GET-Operation am Apothekenverzeichnis der Telematikinfrastruktur für die Ressource /Location. Eine Authentifizierung der App-Nutzer erfolgt nicht, eine Absicherung gegenüber unberechtigte Zugriffe erfolgt mitels API-Key. Der Verzeichnisdienst liefert eine Liste von Apotheken, welche den ggfs. angegebenen Suchparametern entsprechen. Liefert die gewählte Suchanfrage eine zu große Ergebnismenge, bricht der Verzeichnisdienst bei einer technischen Obergrenze von max. 100 Ergebniseinträgen ab.
Request
URI |
|||
|---|---|---|---|
Method |
GET |
||
Requester |
|||
Responder |
APOVZD |
||
Request |
GET /api/Location?name=Adler HTTP/1.1 Host: apovzd.app.ti-dienste.de Pragma: no-cache Cache-Control: no-cache
|
|
ℹ️
|
In der Aufruf-Adresse können Suchparameter gemäß https://www.hl7.org/fhir/organization.html#search angegeben werden (wie hier in GET /api/Location?name=Adler HTTP/1.1). Im konkreten Beispiel soll nach Apotheken (Location) mit Adler im Namen gefiltert werden. Weitere Suchparameter können z.B. eine Ortsangabe (z.B. address-city=Köln bzw. address-city=K%C3%B6ln) umfassen. Mehrere Suchparameter werden über das &-Zeichen miteinander kombiniert.
|
Response
HTTP/1.1 200 OK
Content-Type: application/fhir+json;charset=utf-8
...Details
{
"resourceType": "Bundle",
"id": "erp-versicherte-03-response-GetLocation",
"meta": {
"lastUpdated": "2025-01-15T15:29:00.434+00:00"
},
"type": "searchset",
"total": 2,
"link": [
{
"relation": "self",
"url": "Bundle2b50e07d-ace1-4f83-ae8f-e2845e291cc3"
}
],
"entry": [
{
"resource": {
"resourceType": "Location",
"id": "5a403761-3a18-4ae9-bca8-9ed8abada08a",
"address": {
"use": "work",
"type": "physical",
"line": [
"Friedrichstr. 136"
],
"postalCode": "10117",
"city": "Berlin",
"country": "de"
},
"identifier": [
{
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "3-1.54.10123404"
}
],
"name": "Adlerapotheke",
"position": {
"latitude": 52.522575,
"longitude": 13.387884
},
"status": "active",
"telecom": [
{
"system": "email",
"value": "service@gematik.de"
},
{
"system": "phone",
"value": "030 40041 0"
},
{
"system": "url",
"value": "www.gematik.de"
}
],
"type": [
{
"coding": [
{
"code": "PHARM",
"system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
"display": "pharmacy"
}
]
},
{
"coding": [
{
"code": "MOBL",
"system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
"display": "Mobile Services"
}
]
}
]
},
"search": {
"mode": "match"
}
},
{
"resource": {
"resourceType": "Location",
"id": "354d16fa-ceff-4a18-b1b7-c583ee211cea",
"meta": {
"lastUpdated": "2021-10-12T11:54:29+02:00"
},
"contained": [
{
"id": "8fe0eea1-6379-41ce-bb51-efd33f02e853",
"resourceType": "HealthcareService",
"active": true,
"coverageArea": [
{
"extension": [
{
"url": "https://ngda.de/fhir/extensions/ServiceCoverageRange",
"valueQuantity": {
"value": 5000,
"unit": "m"
}
}
]
}
],
"location": [
{
"reference": "/Location/354d16fa-ceff-4a18-b1b7-c583ee211cea"
}
],
"type": [
{
"coding": [
{
"code": "498",
"system": "http://terminology.hl7.org/CodeSystem/service-type",
"display": "Mobile Services"
}
]
}
]
}
],
"address": {
"use": "work",
"type": "physical",
"line": [
"Adlerstr. 21"
],
"postalCode": "10178",
"city": "Berlin",
"country": "de"
},
"hoursOfOperation": [
{
"daysOfWeek": [
"mon"
],
"openingTime": "08:30:00",
"closingTime": "13:30:00"
},
{
"daysOfWeek": [
"mon"
],
"openingTime": "14:30:00",
"closingTime": "18:30:00"
},
{
"daysOfWeek": [
"tue"
],
"openingTime": "08:30:00",
"closingTime": "13:30:00"
},
{
"daysOfWeek": [
"tue"
],
"openingTime": "14:30:00",
"closingTime": "18:30:00"
},
{
"daysOfWeek": [
"wed"
],
"openingTime": "08:30:00",
"closingTime": "13:30:00"
},
{
"daysOfWeek": [
"wed"
],
"openingTime": "14:30:00",
"closingTime": "18:30:00"
},
{
"daysOfWeek": [
"thu"
],
"openingTime": "08:30:00",
"closingTime": "13:30:00"
},
{
"daysOfWeek": [
"thu"
],
"openingTime": "14:30:00",
"closingTime": "18:30:00"
},
{
"daysOfWeek": [
"fri"
],
"openingTime": "08:30:00",
"closingTime": "13:30:00"
},
{
"daysOfWeek": [
"fri"
],
"openingTime": "14:30:00",
"closingTime": "18:30:00"
},
{
"daysOfWeek": [
"sat"
],
"openingTime": "08:30:00",
"closingTime": "14:00:00"
}
],
"identifier": [
{
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "3-10.2.0123456100.10.228"
},
{
"system": "https://ngda.de/fhir/NamingSystem/NID",
"value": "APO1234642"
}
],
"name": "Apotheke am Adler",
"position": {
"latitude": 52.523044,
"longitude": 13.411917
},
"status": "active",
"telecom": [
{
"system": "phone",
"value": "030/400410"
},
{
"system": "email",
"value": "erezept@gematik.de"
},
{
"system": "url",
"value": "https://www.gematik.de"
}
],
"type": [
{
"coding": [
{
"code": "PHARM",
"system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
"display": "pharmacy"
}
]
},
{
"coding": [
{
"code": "OUTPHARM",
"system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
"display": "outpatient pharmacy"
}
]
}
]
},
"search": {
"mode": "match"
}
}
]
}|
ℹ️
|
Die Suchanfrage nach Adler-Apotheken liefert genau zwei Treffer.
|
|
ℹ️
|
Die Telematik-ID ist die eindeutige Kennung der Apotheke, um an diese bspw. eine Nachricht zu schicken.
|
|
ℹ️
|
Der Name der Apotheke, unter dem sie im Verzeichnis geführt wird findet sich unter z.B."name": "Apotheke am Adler"
|
Code |
Type Success |
200 |
OK |
Code |
Type Error |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not found |
500 |
Server Errors |
Mit dem Suchergebnis kennt der Versicherte nun die Apotheken in seinem Umkreis. Eine Navigationsanwendung könnte ihm nun den kürzesten Weg zu einer der beiden Apotheken berechnen, unter folgendem Link stellen wir dar, wie der Apotheke eine Nachricht geschickt werden kann.
Als Versicherter möchte ich die Abgabeinformationen erhalten, um mir darüber einen digitalen Beipackzettel herunterzuladen und weitere Anwendungshinweise für mein Medikament zu erhalten.
Der Aufruf erfolgt als http-GET-Operation auf die Ressource /MedicationDispense. Im Aufruf muss das während der Authentisierung erhaltene ACCESS_TOKEN im http-Request-Header Authorization übergeben werden, der Fachdienst filtert die MedicationDispense-Einträge nach der im ACCESS_TOKEN enthaltenen KVNR des Versicherten und ggfs. in der Aufrufadresse angegebenen weiteren Suchparametern. Die Rückgabe erfolgt als Liste im Bundle eines oder mehrerer MedicationDispenses, welche den ggfs. angegebenen Suchparametern entsprechen.
Request
URI |
|||||
|---|---|---|---|---|---|
Method |
GET |
||||
Requester |
|||||
Responder |
|||||
URL Parameter |
whenhandedover, whenprepared, performer |
||||
HTTP Header |
Authorization: Bearer eyJraWQ.ewogImL2pA10Qql22ddtutrvx4FsDlz.rHQjEmB1lLmpqn9J
|
||||
Payload |
- |
Response HTTP/1.1 200 OK Content-Type: application/fhir+json;charset=utf-8
{
"resourceType": "Bundle",
"id": "erp-versicherte-04-response-getDispense",
"meta": {
"lastUpdated": "2025-01-15T15:29:00.434+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://erp.app.ti-dienste.de/MedicationDispense?whenhandedover=gt2020-01-01"
}
],
"entry": [
{
"fullUrl": "https://erp.app.ti-dienste.de/MedicationDispense/160.000.000.000.000.01",
"resource": {
"resourceType": "MedicationDispense",
"id": "160.000.000.000.000.01",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_MedicationDispense|1.4"
]
},
"identifier": [
{
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "160.000.000.000.000.01"
}
],
"status": "completed",
"subject": {
"identifier": {
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X123456789"
}
},
"performer": [
{
"actor": {
"identifier": {
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "3-2-APO-XanthippeVeilchenblau01"
}
}
}
],
"dosageInstruction": [
{
"text": "1-0-1-0"
}
],
"whenHandedOver": "2025-01-15",
"quantity": {
"value": 1,
"code": "{Package}",
"system": "http://unitsofmeasure.org"
},
"medicationReference": {
"reference": "Medication/d51b39ab-dad0-4a14-8072-ed87534af585"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://erp.app.ti-dienste.de/Medication/d51b39ab-dad0-4a14-8072-ed87534af585",
"resource": {
"resourceType": "Medication",
"id": "d51b39ab-dad0-4a14-8072-ed87534af585",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Medication|1.4"
]
},
"extension": [
{
"url": "https://gematik.de/fhir/epa-medication/StructureDefinition/drug-category-extension",
"valueCoding": {
"code": "00"
}
},
{
"url": "https://gematik.de/fhir/epa-medication/StructureDefinition/medication-id-vaccine-extension",
"valueBoolean": false
},
{
"url": "http://fhir.de/StructureDefinition/normgroesse",
"valueCode": "N1"
}
],
"amount": {
"numerator": {
"extension": [
{
"url": "https://gematik.de/fhir/epa-medication/StructureDefinition/medication-total-quantity-formulation-extension",
"valueString": "20"
}
],
"unit": "St"
},
"denominator": {
"value": 1
}
},
"ingredient": [
{
"strength": {
"numerator": {
"value": 100,
"unit": "mg",
"_system": {
"extension": [
{
"valueCode": "unknown",
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
]
},
"_code": {
"extension": [
{
"valueCode": "unknown",
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
]
}
},
"denominator": {
"value": 1,
"_system": {
"extension": [
{
"valueCode": "unknown",
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
]
},
"_code": {
"extension": [
{
"valueCode": "unknown",
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
]
}
}
},
"itemCodeableConcept": {
"text": "Sumatriptan"
}
}
],
"code": {
"coding": [
{
"code": "06313728",
"system": "http://fhir.de/CodeSystem/ifa/pzn"
}
],
"text": "Sumatriptan-1a Pharma 100 mg Tabletten"
},
"form": {
"coding": [
{
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM",
"code": "TAB",
"display": "Tabletten"
}
]
}
},
"search": {
"mode": "include"
}
}
]
}|
ℹ️
|
Der Task wird unter "identifier.value":"160.000.000.000.000.01" des eingelösten E-Rezepts referenziert. Über den Link können weitere Informationen wie E-Rezept-Datensatz und ggfs. die Quittung abgerufen werden.
|
|
ℹ️
|
Unter "performer" findet sich die Telematik-ID der Apotheke, bei der das E-Rezept eingelöst wurde.
|
|
ℹ️
|
` "whenHandedOver"` wurde als Filterkriterium verwendet, das Medikament wurde hier am 15.01.2025 ausgehändigt (whenhandedover) und ist damit vom Datumswert "größer" als das Datum des Filterkriteriums der Suchanfrage 01.01.2020 (whenhandedover=gt2020-01-01)
|
|
|
Mit dem Übergang in die Profilversion 1.4 der Workflow Profile verändert sich die Struktur der MedicationDispenses. Unter Version ⇐ 1.3 der Workflow Profile war die Medication in der MedicationDispense als .contained Resource enthalten. Ab Version 1.4 wird die Medication als separate Ressource im Bundle ausgewiesen. Im Folgenden ein Beispiel der Rückgabe von GET /MedicationDispense mit MedicationDispenses in Version 1.4, 1.3 und 1.2: |
Beispiel-Response für MedicationDispenses mit mehreren Versionen (Klicken zum Ausklappen)
HTTP/1.1 200 OK Content-Type: application/fhir+xml;charset=utf-8
{
"resourceType": "Bundle",
"id": "erp-versicherte-04-response-getDispenseMultiple2",
"type": "searchset",
"entry": [
{
"fullUrl": "https://erp-dev.zentral.erp.splitdns.ti-dienste.de/MedicationDispense/160.000.000.000.000.01",
"resource": {
"resourceType": "MedicationDispense",
"id": "160.000.000.000.000.01",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_MedicationDispense|1.4"
]
},
"identifier": [
{
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "160.000.000.000.000.01"
}
],
"status": "completed",
"subject": {
"identifier": {
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X123456789"
}
},
"performer": [
{
"actor": {
"identifier": {
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "3-2-APO-XanthippeVeilchenblau01"
}
}
}
],
"whenHandedOver": "2025-01-15",
"medicationReference": {
"reference": "urn:uuid:86ce7563-9819-4dfa-9944-d307f7cfec9b"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "urn:uuid:86ce7563-9819-4dfa-9944-d307f7cfec9b",
"resource": {
"resourceType": "Medication",
"id": "86ce7563-9819-4dfa-9944-d307f7cfec9b",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Medication|1.4"
]
},
"code": {
"coding": [
{
"system": "http://fhir.de/CodeSystem/ifa/pzn",
"code": "06313728"
}
]
},
"batch": {
"lotNumber": "123456"
}
},
"search": {
"mode": "include"
}
},
{
"fullUrl": "https://erp-dev.zentral.erp.splitdns.ti-dienste.de/MedicationDispense/160.000.000.000.000.02",
"resource": {
"resourceType": "MedicationDispense",
"id": "160.000.000.000.000.02",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_MedicationDispense|1.4"
]
},
"identifier": [
{
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "160.000.000.000.000.02"
}
],
"status": "completed",
"subject": {
"identifier": {
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X123456789"
}
},
"performer": [
{
"actor": {
"identifier": {
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "3-2-APO-XanthippeVeilchenblau01"
}
}
}
],
"whenHandedOver": "2025-01-15",
"medicationReference": {
"reference": "urn:uuid:56c61db7-0a94-4b7b-832a-b8ac3752035d"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "urn:uuid:56c61db7-0a94-4b7b-832a-b8ac3752035d",
"resource": {
"resourceType": "Medication",
"id": "56c61db7-0a94-4b7b-832a-b8ac3752035d",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Medication|1.4"
]
},
"code": {
"coding": [
{
"system": "http://fhir.de/CodeSystem/ifa/pzn",
"code": "06313728"
}
]
},
"batch": {
"lotNumber": "123456"
}
},
"search": {
"mode": "include"
}
},
{
"fullUrl": "https://erp-dev.zentral.erp.splitdns.ti-dienste.de/MedicationDispense/160.000.000.000.000.04",
"resource": {
"resourceType": "MedicationDispense",
"id": "160.000.000.000.000.04",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_MedicationDispense|1.2"
]
},
"medicationReference": {
"reference": "#65b6d139-93a6-459f-8b3c-5ae1d1f809a2"
},
"contained": [
{
"resourceType": "Medication",
"id": "65b6d139-93a6-459f-8b3c-5ae1d1f809a2",
"meta": {
"profile": [
"https://fhir.kbv.de/StructureDefinition/KBV_PR_ERP_Medication_PZN|1.1.0"
]
},
"code": {
"text": "Sumatriptan Dura 100mg",
"coding": [
{
"code": "04866280",
"system": "http://fhir.de/CodeSystem/ifa/pzn"
}
]
},
"extension": [
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Category",
"valueCoding": {
"code": "00",
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_ERP_Medication_Category"
}
},
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_Base_Medication_Type",
"valueCodeableConcept": {
"coding": [
{
"code": "763158003",
"system": "http://snomed.info/sct",
"display": "Medicinal product (product)",
"version": "http://snomed.info/sct/900000000000207008/version/20220331"
}
]
}
},
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Vaccine",
"valueBoolean": false
},
{
"url": "http://fhir.de/StructureDefinition/normgroesse",
"valueCode": "N3"
}
],
"form": {
"coding": [
{
"code": "FTA",
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM"
}
]
},
"amount": {
"denominator": {
"value": 1
},
"numerator": {
"extension": [
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_PackagingSize",
"valueString": "12"
}
],
"unit": "St"
}
},
"batch": {
"lotNumber": "123456"
}
}
],
"dosageInstruction": [
{
"text": "1-0-1-0"
}
],
"subject": {
"identifier": {
"value": "X123456789"
}
},
"status": "completed",
"performer": [
{
"actor": {
"identifier": {
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "3-2-APO-XanthippeVeilchenblau01"
}
}
}
],
"whenHandedOver": "2024-07-02",
"identifier": [
{
"value": "160.000.000.000.000.04",
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId"
}
]
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://erp-dev.zentral.erp.splitdns.ti-dienste.de/MedicationDispense/160.000.000.000.000.05",
"resource": {
"resourceType": "MedicationDispense",
"id": "160.000.000.000.000.05",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_MedicationDispense|1.3"
]
},
"medicationReference": {
"reference": "#7ebb8f0c-06a7-4b71-b6b2-81000eabbf8d"
},
"contained": [
{
"resourceType": "Medication",
"id": "7ebb8f0c-06a7-4b71-b6b2-81000eabbf8d",
"meta": {
"profile": [
"https://fhir.kbv.de/StructureDefinition/KBV_PR_ERP_Medication_PZN|1.1.0"
]
},
"code": {
"text": "Sumatriptan Dura 100mg",
"coding": [
{
"code": "04866280",
"system": "http://fhir.de/CodeSystem/ifa/pzn"
}
]
},
"extension": [
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Category",
"valueCoding": {
"code": "00",
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_ERP_Medication_Category"
}
},
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_Base_Medication_Type",
"valueCodeableConcept": {
"coding": [
{
"code": "763158003",
"system": "http://snomed.info/sct",
"display": "Medicinal product (product)",
"version": "http://snomed.info/sct/900000000000207008/version/20220331"
}
]
}
},
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Vaccine",
"valueBoolean": false
},
{
"url": "http://fhir.de/StructureDefinition/normgroesse",
"valueCode": "N3"
}
],
"form": {
"coding": [
{
"code": "FTA",
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM"
}
]
},
"amount": {
"denominator": {
"value": 1
},
"numerator": {
"extension": [
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_PackagingSize",
"valueString": "12"
}
],
"unit": "St"
}
},
"batch": {
"lotNumber": "123456"
}
}
],
"dosageInstruction": [
{
"text": "1-0-1-0"
}
],
"subject": {
"identifier": {
"value": "X123456789"
}
},
"status": "completed",
"performer": [
{
"actor": {
"identifier": {
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "3-2-APO-XanthippeVeilchenblau01"
}
}
}
],
"whenHandedOver": "2024-07-02",
"identifier": [
{
"value": "160.000.000.000.000.05",
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId"
}
]
},
"search": {
"mode": "match"
}
}
]
}Code |
Type Success |
200 |
OK |
Code |
Type Error |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not found |
500 |
Server Errors |
Als Versicherter möchte ich die Abgabeinformationen aus der Apotheke zu meinem belieferten E-Rezept erhalten, um mir darüber einen digitalen Beipackzettel herunterzuladen und weitere Anwendungshinweise für mein Medikament zu erhalten.
Der Aufruf erfolgt als http-GET-Operation auf die Ressource /MedicationDispense?identifier=<system-prescription-id>|<task_id>. Im Aufruf muss das während der Authentisierung erhaltene ACCESS_TOKEN im http-Request-Header Authorization übergeben werden.
Der Fachdienst filtert die MedicationDispense-Einträge nach der im ACCESS_TOKEN enthaltenen KVNR des Versicherten, den MedicationDispenses die dem Task zugeordnet sind und ggfs. in der Aufrufadresse angegebenen weiteren Suchparametern.
Die Rückgabe erfolgt als Bundle, dass eines oder mehrere MedicationDispenses enthält.
|
|
Der Endpunkt GET /MedicationDispense/<id> wird deprecated und steht ab dem 15.04.2025 nicht mehr zur Verfügung. Der Abruf von Abgabeinformationen zu einem E-Rezept erfolgt ab dem 15.04.2025 ausschließlich über den Endpunkt GET /MedicationDispense?identifier=<system-prescription-id>|<task_id> und wird aktuell schon unterstützt.
|
Request
URI |
|||||
|---|---|---|---|---|---|
Method |
GET |
||||
Requester |
|||||
Responder |
|||||
HTTP Header |
Authorization: Bearer eyJraWQ.ewogImL2pA10Qql22ddtutrvx4FsDlz.rHQjEmB1lLmpqn9J
|
||||
Payload |
- |
Response HTTP/1.1 200 OK Content-Type: application/fhir+json;charset=utf-8
{
"resourceType": "Bundle",
"id": "erp-versicherte-05-response-get-single-medicationdispense-by-id",
"type": "searchset",
"timestamp": "2025-01-15T15:29:00.434+00:00",
"total": 0,
"link": [
{
"relation": "self",
"url": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/MedicationDispense?identifier=200.000.000.000.000.01"
}
],
"entry": [
{
"fullUrl": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/MedicationDispense/200.000.000.000.000.01",
"resource": {
"resourceType": "MedicationDispense",
"id": "200.000.000.000.000.01",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_MedicationDispense|1.4"
]
},
"identifier": [
{
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "200.000.000.000.000.01"
}
],
"status": "completed",
"subject": {
"identifier": {
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X123456789"
}
},
"performer": [
{
"actor": {
"identifier": {
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "3-2-APO-XanthippeVeilchenblau01"
}
}
}
],
"dosageInstruction": [
{
"text": "1-0-1-0"
}
],
"whenHandedOver": "2025-01-15",
"quantity": {
"value": 1,
"code": "{Package}",
"system": "http://unitsofmeasure.org"
},
"medicationReference": {
"reference": "Medication/a6635059-bb82-4cdc-90dc-907bc83be523"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/Medication/a6635059-bb82-4cdc-90dc-907bc83be523",
"resource": {
"resourceType": "Medication",
"id": "a6635059-bb82-4cdc-90dc-907bc83be523",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Medication|1.4"
]
},
"extension": [
{
"url": "https://gematik.de/fhir/epa-medication/StructureDefinition/drug-category-extension",
"valueCoding": {
"code": "00"
}
},
{
"url": "https://gematik.de/fhir/epa-medication/StructureDefinition/medication-id-vaccine-extension",
"valueBoolean": false
},
{
"url": "http://fhir.de/StructureDefinition/normgroesse",
"valueCode": "N1"
}
],
"amount": {
"numerator": {
"extension": [
{
"url": "https://gematik.de/fhir/epa-medication/StructureDefinition/medication-total-quantity-formulation-extension",
"valueString": "20"
}
],
"unit": "St"
},
"denominator": {
"value": 1
}
},
"ingredient": [
{
"strength": {
"numerator": {
"value": 100,
"unit": "mg",
"_system": {
"extension": [
{
"valueCode": "unknown",
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
]
},
"_code": {
"extension": [
{
"valueCode": "unknown",
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
]
}
},
"denominator": {
"value": 1,
"_system": {
"extension": [
{
"valueCode": "unknown",
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
]
},
"_code": {
"extension": [
{
"valueCode": "unknown",
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
]
}
}
},
"itemCodeableConcept": {
"text": "Sumatriptan"
}
}
],
"code": {
"coding": [
{
"code": "06313728",
"system": "http://fhir.de/CodeSystem/ifa/pzn"
}
],
"text": "Sumatriptan-1a Pharma 100 mg Tabletten"
},
"form": {
"coding": [
{
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM",
"code": "TAB",
"display": "Tabletten"
}
]
}
},
"search": {
"mode": "include"
}
}
]
}|
ℹ️
|
Der Task wird unter "reference":"Task/160.880.966.157.248.22" des eingelösten E-Rezepts referenziert. Über den Link können weitere Informationen wie E-Rezept-Datensatz und ggfs. die Quittung abgerufen werden.
|
|
ℹ️
|
Unter "performer" findet sich der Name und die Betriebsstättennummer Telematik-ID der Apotheke, bei der das E-Rezept eingelöst wurde.
|
|
ℹ️
|
Ab der Workflow Profilversion 1.4 kann in der Response des Aufrufs MedicationDispense und Medication Ressourcen aufgelistet werden. Medications werden hierbei über absolute urn:uuid’s in der fullURL referenziert und mit dem search.mode "include" ausgewiesen. |
Code |
Type Success |
200 |
OK |
Code |
Type Error |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not found |
500 |
Server Errors |
Als Versicherter möchte ich alle Abgabeinformationen aus der Apotheke zu meinem belieferten E-Rezept erhalten, um mir darüber einen digitalen Beipackzettel herunterzuladen und weitere Anwendungshinweise für mein Medikament zu erhalten.
Der Aufruf erfolgt als http-GET-Operation auf die Ressource /MedicationDispense?identifier=https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId|<task_id>. Im Aufruf muss das während der Authentisierung erhaltene ACCESS_TOKEN im http-Request-Header Authorization übergeben werden.
Der Fachdienst filtert die MedicationDispense-Einträge nach der im ACCESS_TOKEN enthaltenen KVNR des Versicherten, den MedicationDispenses die dem Task zugeordnet sind und ggfs. in der Aufrufadresse angegebenen weiteren Suchparametern.
Die Rückgabe erfolgt als Bundle, das ein oder mehrere MedicationDispenses enthält.
Request
URI |
|||||
|---|---|---|---|---|---|
Method |
GET |
||||
Requester |
|||||
Responder |
|||||
HTTP Header |
Authorization: Bearer eyJraWQ.ewogImL2pA10Qql22ddtutrvx4FsDlz.rHQjEmB1lLmpqn9J
|
||||
Payload |
- |
Response HTTP/1.1 200 OK Content-Type: application/fhir+json;charset=utf-8
{
"resourceType": "Bundle",
"id": "erp-versicherte-06-response-get-multiple-medication-dispense",
"type": "searchset",
"timestamp": "2025-01-15T15:29:00.434+00:00",
"total": 2,
"entry": [
{
"fullUrl": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/MedicationDispense/200.000.000.000.000.01",
"resource": {
"resourceType": "MedicationDispense",
"id": "200.000.000.000.000.01",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_MedicationDispense|1.4"
]
},
"identifier": [
{
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "200.000.000.000.000.01"
}
],
"status": "completed",
"subject": {
"identifier": {
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X123456789"
}
},
"performer": [
{
"actor": {
"identifier": {
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "3-2-APO-XanthippeVeilchenblau01"
}
}
}
],
"dosageInstruction": [
{
"text": "1-0-1-0"
}
],
"whenHandedOver": "2025-01-15",
"quantity": {
"value": 1,
"code": "{Package}",
"system": "http://unitsofmeasure.org"
},
"medicationReference": {
"reference": "Medication/e25e68d2-8aa4-4fb4-8498-68d9856f8ec3"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/Medication/e25e68d2-8aa4-4fb4-8498-68d9856f8ec3",
"resource": {
"resourceType": "Medication",
"id": "e25e68d2-8aa4-4fb4-8498-68d9856f8ec3",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Medication|1.4"
]
},
"extension": [
{
"url": "https://gematik.de/fhir/epa-medication/StructureDefinition/drug-category-extension",
"valueCoding": {
"code": "00"
}
},
{
"url": "https://gematik.de/fhir/epa-medication/StructureDefinition/medication-id-vaccine-extension",
"valueBoolean": false
},
{
"url": "http://fhir.de/StructureDefinition/normgroesse",
"valueCode": "N1"
}
],
"amount": {
"numerator": {
"extension": [
{
"url": "https://gematik.de/fhir/epa-medication/StructureDefinition/medication-total-quantity-formulation-extension",
"valueString": "20"
}
],
"unit": "St"
},
"denominator": {
"value": 1
}
},
"ingredient": [
{
"strength": {
"numerator": {
"value": 100,
"unit": "mg",
"_system": {
"extension": [
{
"valueCode": "unknown",
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
]
},
"_code": {
"extension": [
{
"valueCode": "unknown",
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
]
}
},
"denominator": {
"value": 1,
"_system": {
"extension": [
{
"valueCode": "unknown",
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
]
},
"_code": {
"extension": [
{
"valueCode": "unknown",
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
]
}
}
},
"itemCodeableConcept": {
"text": "Sumatriptan"
}
}
],
"code": {
"coding": [
{
"code": "06313728",
"system": "http://fhir.de/CodeSystem/ifa/pzn"
}
],
"text": "Sumatriptan-1a Pharma 100 mg Tabletten"
},
"form": {
"coding": [
{
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM",
"code": "TAB",
"display": "Tabletten"
}
]
}
},
"search": {
"mode": "include"
}
},
{
"fullUrl": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/MedicationDispense/200.000.000.000.000.02",
"resource": {
"resourceType": "MedicationDispense",
"id": "200.000.000.000.000.02",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_MedicationDispense|1.4"
]
},
"identifier": [
{
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "200.000.000.000.000.02"
}
],
"status": "completed",
"subject": {
"identifier": {
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X123456789"
}
},
"performer": [
{
"actor": {
"identifier": {
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "3-2-APO-XanthippeVeilchenblau01"
}
}
}
],
"dosageInstruction": [
{
"text": "1-0-1-0"
}
],
"whenHandedOver": "2025-01-15",
"quantity": {
"value": 1,
"code": "{Package}",
"system": "http://unitsofmeasure.org"
},
"medicationReference": {
"reference": "Medication/32c2f072-38ba-4990-9d74-80938ccb05b6"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/Medication/32c2f072-38ba-4990-9d74-80938ccb05b6",
"resource": {
"resourceType": "Medication",
"id": "32c2f072-38ba-4990-9d74-80938ccb05b6",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Medication|1.4"
]
},
"extension": [
{
"url": "https://gematik.de/fhir/epa-medication/StructureDefinition/drug-category-extension",
"valueCoding": {
"code": "00"
}
},
{
"url": "https://gematik.de/fhir/epa-medication/StructureDefinition/medication-id-vaccine-extension",
"valueBoolean": false
},
{
"url": "http://fhir.de/StructureDefinition/normgroesse",
"valueCode": "N1"
}
],
"code": {
"coding": [
{
"code": "14186244",
"system": "http://fhir.de/CodeSystem/ifa/pzn"
}
],
"text": "FLUSARION EH50/250UG/60 PC"
},
"form": {
"coding": [
{
"code": "IHP",
"system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM"
}
]
}
},
"search": {
"mode": "include"
}
}
],
"link": [
{
"relation": "self",
"url": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/MedicationDispense?identifier=200.000.000.000.000.01"
}
]
}|
ℹ️
|
Der Task wird unter "reference":"Task/160.880.966.157.248.22" des eingelösten E-Rezepts referenziert. Über den Link können weitere Informationen wie E-Rezept-Datensatz und ggfs. die Quittung abgerufen werden.
|
|
ℹ️
|
Unter "performer" findet sich der Name und die Betriebsstättennummer Telematik-ID der Apotheke, bei der das E-Rezept eingelöst wurde.
|
Code |
Type Success |
200 |
OK |
Code |
Type Error |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not found |
500 |
Server Errors |
Als Versicherter möchte ich ein E-Rezept löschen können, um mein Recht auf informationelle Selbstbestimmung wahrzunehmen.
Der Aufruf erfolgt als http-POST-Operation auf eine konkrete Ressource /Task/<task_id> mit dem Zusatz der FHIR-Operation $abort. Im Aufruf muss das während der Authentisierung erhaltene ACCESS_TOKEN im http-Request-Header Authorization übergeben werden. Der Aufruf kann auch durch einen Vertreter des Versicherten erfolgen, hierbei wird lediglich die Rolle Versicherter im ACCESS_TOKEN geprüft. Um die Berechtigung für den Zugriff auf einen Task mit einer fremden KVNR nachzuweisen, muss der Zugreifende den richtigen AccessCode im http-Request-Header X-AccessCode übergeben. Die Operation löscht alle personenbezogenen und medizinischen Daten.
Request
URI |
|||||
|---|---|---|---|---|---|
Method |
POST |
||||
Requester |
|||||
Responder |
|||||
HTTP Header |
Authorization: Bearer eyJraWQ.ewogImL2pA10Qql22ddtutrvx4FsDlz.rHQjEmB1lLmpqn9J X-AccessCode: 777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea
|
||||
Payload |
- |
Response
HTTP/1.1 204 No Content|
ℹ️
|
Im Ergebnis der $abort-Operation wird der referenzierte Task gelöscht. Dementsprechend werden keine Daten an den aufrufenden Client zurückgegeben. |
Code |
Type Success |
204 |
No Content |
Code |
Type Error |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not found |
405 |
Method Not Allowed |
429 |
Too Many Requests |
500 |
Server Errors |
Als Versicherter möchte ich Einsicht in das Zugriffsprotokoll meiner Daten im E-Rezept-Fachdienst nehmen, um Zugriffe nachvollziehen zu können und eine unberechtigte Einsicht in meine Daten zu prüfen.
Der Aufruf erfolgt als http-GET-Operation auf die Ressource /AuditEvent. Im Aufruf muss das während der Authentisierung erhaltene ACCESS_TOKEN im http-Request-Header Authorization übergeben werden, der Fachdienst filtert die AuditEvent-Einträge nach der im ACCESS_TOKEN enthaltenen KVNR des Versicherten.
Der E-Rezept-Fachdienst liefert eine Liste von Protokolleinträgen, die mit einem zusätzlichen Suchparameter in der Anfrage-URL sortiert werden kann. https://erp.app.ti-dienste.de/AuditEvent?_sort=-date sortiert die Protokolleinträge nach dem Protokollierungszeitpunkt recorded gemäß https://www.hl7.org/fhir/auditevent.html#search, das Minuszeichen in -date bewirkt die absteigende Sortierung (jüngster Eintrag zuerst).
Der Fachdienst liefert Links für die Paginierung zurück, die gerne genutzt werden können. Dies erspart eine eigene Implementierung von _offset usw. Standardmäßig werden nur 50 Einträge zurückgegeben. Mittels _sort können die Einträge nach Datum sortiert werden. Das Abfragepattern soll so gestaltet sein, dass über den Link, der unter "next" zurückgegeben wird, die nächsten abgerufen werden können. Dort wird statt der URL-Parameter _offset und _count ein URL-Parameter _id verwendet, der die id des letzten Eintrags der vorherigen Seite enthält (Ssp.: _id=gt9ce81651-9e8b-4e11-ac6c-29934730fe4f).
|
ℹ️
|
Dieser Aufruf soll nicht regelmäßig im FdV ausgeführt werden, sondern nur, wenn der Versicherte Einsicht in das Protokoll nehmen möchte. Dies spart Ressourcen am E-Rezept-Fachdienst. |
|
ℹ️
|
Die Angabe "total" wird vom E-Rezept-Fachdienst aus Gründen der Performance nicht unterstützt. Die Anzahl der zurückgegebenen Einträge ist nach Möglichkeit immer 50. |
|
ℹ️
|
Die Sprache muss in jedem Aufruf mittels "Accept-Language" Heder übergeben werden, um die Protokolleinträge in der bevorzugten Sprache des Versicherten zurückzugeben. |
Request
URI |
|||||||
|---|---|---|---|---|---|---|---|
Method |
GET |
||||||
Requester |
|||||||
Responder |
|||||||
URL Parameter |
date, subtype, _sort, _offset, _count |
||||||
HTTP Header |
Authorization: Bearer eyJraWQ.ewogImL2pA10Qql22ddtutrvx4FsDlz.rHQjEmB1lLmpqn9J
|
||||||
Payload |
- |
Response HTTP/1.1 200 OK Content-Type: application/fhir+json;charset=utf-8
{
"resourceType": "Bundle",
"id": "erp-versicherte-07-response-getAuditEvent",
"meta": {
"lastUpdated": "2025-01-15T16:29:00.434+00:00"
},
"type": "searchset",
"link": [
{
"relation": "self",
"url": "https://erp.app.ti-dienste.de/AuditEvent"
},
{
"relation": "next",
"url": "https://erp.app.ti-dienste.de/AuditEvent?_getpages=12653b13-5fca-4e3b-860c-9558bdfef9a1&_getpagesoffset=20&_count=20"
}
],
"entry": [
{
"fullUrl": "https://erp.app.ti-dienste.de/AuditEvent/58862",
"resource": {
"resourceType": "AuditEvent",
"id": "58862",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_AuditEvent|1.4"
]
},
"type": {
"system": "http://terminology.hl7.org/CodeSystem/audit-event-type",
"code": "rest"
},
"source": {
"site": "E-Rezept Fachdienst",
"observer": {
"reference": "Device/1234"
}
},
"subtype": [
{
"code": "create",
"system": "http://hl7.org/fhir/restful-interaction"
}
],
"action": "C",
"recorded": "2025-01-15T15:29:00.434+00:00",
"outcome": "0",
"agent": [
{
"type": {
"coding": [
{
"code": "humanuser",
"system": "http://terminology.hl7.org/CodeSystem/extra-security-role-type",
"display": "Human User"
}
]
},
"who": {
"identifier": {
"value": "1-2-DOC-Testkarte-012423424",
"system": "https://gematik.de/fhir/sid/telematik-id"
}
},
"name": "Praxis Dr. Müller",
"requestor": false
}
],
"entity": [
{
"what": {
"reference": "https://erp.app.ti-dienste.de/Task/160.000.000.000.000.01",
"identifier": {
"use": "official",
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "160.000.000.000.000.01"
}
},
"name": "X123456789",
"description": "*160.000.000.000.000.01*"
}
]
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://erp.app.ti-dienste.de/AuditEvent/58863",
"resource": {
"resourceType": "AuditEvent",
"id": "58863",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_AuditEvent|1.4"
],
"versionId": "1",
"lastUpdated": "2025-01-15T15:29:00.434+00:00",
"source": "#IkMt252YovlsJTAE"
},
"type": {
"system": "http://terminology.hl7.org/CodeSystem/audit-event-type",
"code": "rest"
},
"source": {
"site": "E-Rezept Fachdienst",
"observer": {
"reference": "Device/5678"
}
},
"subtype": [
{
"code": "read",
"system": "http://hl7.org/fhir/restful-interaction"
}
],
"action": "R",
"recorded": "2025-01-15T15:29:00.434+00:00",
"outcome": "0",
"agent": [
{
"type": {
"coding": [
{
"code": "humanuser",
"system": "http://terminology.hl7.org/CodeSystem/extra-security-role-type",
"display": "Human User"
}
]
},
"who": {
"identifier": {
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "3-2-APO-XanthippeVeilchenblau01"
}
},
"name": "Ihre Apotheke um die Ecke, Hauptstraße 1",
"requestor": false
}
],
"entity": [
{
"what": {
"reference": "https://erp.app.ti-dienste.de/Task/160.000.000.000.000.01",
"identifier": {
"use": "official",
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "160.000.000.000.000.01"
}
},
"name": "X123456789",
"description": "*160.000.000.000.000.01*"
}
]
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://erp.app.ti-dienste.de/AuditEvent/620049",
"resource": {
"resourceType": "AuditEvent",
"id": "620049",
"meta": {
"profile": [
"https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_AuditEvent|1.4"
],
"versionId": "1",
"lastUpdated": "2025-01-15T15:29:00.434+00:00",
"source": "#IkMt252YovlsJTAE"
},
"type": {
"system": "http://terminology.hl7.org/CodeSystem/audit-event-type",
"code": "rest"
},
"source": {
"site": "E-Rezept Fachdienst",
"observer": {
"reference": "Device/1234"
}
},
"subtype": [
{
"code": "update",
"system": "http://hl7.org/fhir/restful-interaction"
}
],
"action": "U",
"recorded": "2025-01-15T15:29:00.434+00:00",
"outcome": "0",
"agent": [
{
"type": {
"coding": [
{
"code": "humanuser",
"system": "http://terminology.hl7.org/CodeSystem/extra-security-role-type",
"display": "Human User"
}
]
},
"who": {
"identifier": {
"system": "https://gematik.de/fhir/sid/telematik-id",
"value": "3-2-APO-XanthippeVeilchenblau01"
}
},
"name": "Ihre Apotheke um die Ecke, Hauptstraße 1",
"requestor": false
}
],
"entity": [
{
"what": {
"reference": "https://erp.app.ti-dienste.de/Task/160.000.000.000.000.01",
"identifier": {
"use": "official",
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
"value": "160.000.000.000.000.01"
}
},
"name": "X123456789",
"description": "*160.000.000.000.000.01*"
}
]
},
"search": {
"mode": "match"
}
}
]
}|
ℹ️
|
Beim Abrufen der Protokolleinträge erfolgt die Rückgabe als Bundle, in dem die Protokolleinträge mit Bezug zum authentifizierten Versicherten über dessen KVNR aufgelistet werden. In diesem vereinfachten Beispiel werden nur drei Einträge dargestellt.
|
|
ℹ️
|
Für eine komfortable Darstellung vieler Protokolleinträge und zur Reduktion der übertragenen Datenmenge kommt ein Paging-Mechanismus zum Einsatz. Über diese url können die nächsten 20 Protokolleinträge abgerufen werden (sofern weitere vorhanden)
|
|
ℹ️
|
Die Darstellung eines Protokolleintrags erfolgt als AuditEvent
|
|
ℹ️
|
Unter "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Praxis Dr. Müller,
Bahnhofstr. 78 hat ein E-Rezept 160.000.000.000.000.01 eingestellt</div>" wird eine lesbare Darstellung in HTML-Format bereitgestellt.
|
|
ℹ️
|
Der Versichertenbezug wird über die Versichertennummer des jeweils gelesenen/eingestellten/gelöschten E-Rezept in "name": "X123456789" oder auch MedicationDispense hergestellt.
|
Code |
Type Success |
200 |
OK |
Code |
Type Error |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
405 |
Method Not Allowed |
429 |
Too Many Requests |
500 |
Server Errors |