-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
+
+
-
-
+
+
-
-
-
-
+
+
+
+
-
-
-
-
+
+
+
+
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
+
+
+
+
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
-
@@ -483,10 +513,10 @@ image:medication-rezeptur-schematics.png[width=50%]
-
+
-
@@ -502,12 +532,12 @@ image:medication-rezeptur-schematics.png[width=50%]
@@ -520,12 +550,12 @@ image:medication-rezeptur-schematics.png[width=50%]
@@ -543,9 +573,8 @@ Das Erzeugen von Kombipackungen geschieht analog zur Rezeptur. Statt der Ingredi
====
[source,xml]
----
-
-
+
-
@@ -601,9 +630,9 @@ Das Erzeugen von Kombipackungen geschieht analog zur Rezeptur. Statt der Ingredi
+
-
@@ -645,17 +674,17 @@ Das Erzeugen von Kombipackungen geschieht analog zur Rezeptur. Statt der Ingredi
-
+
-
+
-
+
+
+
+
+ ...
+
+
+----
+
+Folgend ein korrigiertes Beispiel:
+
+[source,xml]
+----
+
+
+ ...
+
+
+----
+
+Alternativ ein korrektes Beispiel für relative Referenzierung:
+
+[source,xml]
+----
+
+
+ ...
+
+
+----
+
+
+Die Referenz "Patient/123" kann nicht aufgelöst werden, da die Umgebende Composition-Ressource keine fullUrl besitzt, die eine base-URL enthält, wonach aufgelöst werden kann.
+
+==== Format von fullURLs
+fullURLs müssen entweder als URL-Schema oder als URN-Schema angegeben werden. Wenn das URL-Schema verwendet wird, muss dieses nach dem link:https://hl7.org/fhir/R4/references.html#regex[Regex für FHIR-URLs] aufgebaut sein. Folgende Hinweise sind zu beachten:
+
+* URLs haben das Format "http(s):////".
+* URNs haben das Format "urn:uuid:".
+
+Folgendes Beispiel zeigt eine **ungültige** URL-Referenz:
+
+[source,xml]
+----
+
+
+
+ ...
+
+----
+
+Beispiel für korrekte Angabe der .id:
+
+[source,xml]
+----
+
+
+
+ ...
+
+----
+
== Tools und Hinweise zu FHIR
diff --git a/docs/erp_fhirversion.adoc b/docs/erp_fhirversion.adoc
index 18238c9d..5f3263cf 100644
--- a/docs/erp_fhirversion.adoc
+++ b/docs/erp_fhirversion.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Zielgruppe: image:{PVS}[] image:{AVS}[] image:{FdV}[]
Auf dieser Seite finden Sie eine Übersicht der FHIR-Release-Pakete der Prozessbeteiligten KBV, DAV, GKV, PKV und gematik. +
diff --git a/docs/erp_fhirversion_change_20241101.adoc b/docs/erp_fhirversion_change_20241101.adoc
index 07cc9aa0..a67d0903 100644
--- a/docs/erp_fhirversion_change_20241101.adoc
+++ b/docs/erp_fhirversion_change_20241101.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Ab dem 01.11.2024 ist das gematik Workflow Package 1.3 gültig. Es gibt sowohl einen neuen Endpunkt $dispense für die Apotheke als auch ein paar kleine Veränderungen an den FHIR-Objekten. Diese Seite bietet eine Zusammenfassung der Veränderungen in einem Format, das zeigt, was die verschiedenen Hersteller tun müssen, um ein bestimmtes Feature FHIR-mäßig umzusetzen. Alle Breaking Changes sind ebenfalls aufgelistet.
toc::[]
diff --git a/docs/erp_fhirversion_change_20250115.adoc b/docs/erp_fhirversion_change_20250115.adoc
index 25b55020..baf7bd68 100644
--- a/docs/erp_fhirversion_change_20250115.adoc
+++ b/docs/erp_fhirversion_change_20250115.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Ab dem 15.01.2025 ist das gematik Workflow Package 1.4.0 gültig. Da sowohl DiGA als auch eML Teil des Packages sind, müssen einige Veränderungen vorgenommen werden. Es gibt sowohl Veränderungen an manchen FHIR-Objekten, neue FHIR-Objekte, als auch Änderungen an den #dispense- und $close-Endpunkten. Diese Seite bietet eine Zusammenfassung der Veränderungen in einem Format, das zeigt, was die verschiedenen Hersteller tun müssen, um ein bestimmtes Feature FHIR-mäßig umzusetzen. Alle Breaking Changes sind ebenfalls aufgelistet.
toc::[]
diff --git a/docs/erp_fhirversion_change_YYYYMMDD.adoc b/docs/erp_fhirversion_change_YYYYMMDD.adoc
index 2958e5c3..6cd30f87 100644
--- a/docs/erp_fhirversion_change_YYYYMMDD.adoc
+++ b/docs/erp_fhirversion_change_YYYYMMDD.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
IMPORTANT: Diese Seite ist nur ein Template für zukünftige Releases! Die Informationen zu den Versionsübergängen werden nicht aktualisiert.
Ab dem TT.MM.JJJJ ist das gematik Workflow Package 1.X gültig. Diese Seite bietet eine Zusammenfassung der Veränderungen in einem Format, das zeigt, was die verschiedenen Hersteller tun müssen, um ein bestimmtes Feature FHIR-mäßig umzusetzen. Alle Breaking Changes sind ebenfalls aufgelistet.
diff --git a/docs/erp_fhirversion_changes.adoc b/docs/erp_fhirversion_changes.adoc
index 3dbafb1b..112d2dfa 100644
--- a/docs/erp_fhirversion_changes.adoc
+++ b/docs/erp_fhirversion_changes.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Zielgruppe: image:{PVS}[] image:{AVS}[] image:{FdV}[]
== Methodik
diff --git a/docs/erp_fhirvzd_usage.adoc b/docs/erp_fhirvzd_usage.adoc
index d612d786..db476d09 100644
--- a/docs/erp_fhirvzd_usage.adoc
+++ b/docs/erp_fhirvzd_usage.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Zielgruppe: image:{FdV}[]
Hier dokumentiert die gematik die Nutzung der Schnittstellen im Kontext der Apothekensuche im Frontend des Versicherten (FdV) des E-Rezept.
diff --git a/docs/erp_implemented_features.adoc b/docs/erp_implemented_features.adoc
index a69d97bb..8c419b99 100644
--- a/docs/erp_implemented_features.adoc
+++ b/docs/erp_implemented_features.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Zielgruppe: image:{PVS}[] image:{AVS}[] image:{FdV}[]
Auf dieser Seite finden sie eine Übersicht der Produkte und Verordnungen, die über das E-Rezept verordnet werden können.
diff --git a/docs/erp_notification.adoc b/docs/erp_notification.adoc
index fadb2418..3c269922 100644
--- a/docs/erp_notification.adoc
+++ b/docs/erp_notification.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Zielgruppe: image:{FdV}[]
Hier dokumentiert die gematik die Nutzung der Schnittstellen rund um den Benachrichtigungsdienst.
diff --git a/docs/erp_notification_avs.adoc b/docs/erp_notification_avs.adoc
index bf34112c..09eef811 100644
--- a/docs/erp_notification_avs.adoc
+++ b/docs/erp_notification_avs.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Zielgruppe: image:{AVS}[]
Auf dieser Seite dokumentiert die gematik die Schnittstellen des E-Rezept-Fachdienstes für Apotheken, über welche sie sich für Benachrichtigungen bei neuen Communications, registrieren können.
@@ -58,8 +62,9 @@ Content-Type: application/fhir+xml; charset=UTF-8
Accept: application/fhir+xml; charset=utf-8
+
-
+
-
-
-
----
@@ -56,17 +57,15 @@ Dies ist ein Beispiel für eine OperationOutcome, in der ein Abruf nicht erlaubt
[source,xml]
----
-
-
-
-
+
----
== Status Codes am Endpunkt /VAU
diff --git a/docs/erp_steuerung_durch_le.adoc b/docs/erp_steuerung_durch_le.adoc
index 806d5959..fbd141fc 100644
--- a/docs/erp_steuerung_durch_le.adoc
+++ b/docs/erp_steuerung_durch_le.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Zielgruppe: image:{PVS}[] image:{AVS}[] image:{FdV}[]
Hier dokumentiert die gematik die Nutzung der Schnittstellen rund um das E-Rezept Feature "Workflow-Steuerung durch Leistungserbringer". Hierbei handelt es sich um eine besondere Versorgungssituation, bei der ein E-Rezept direkt vom verordnenden Leistungserbringer an die abgebende Apotheke zugewiesen und übermittelt werden kann. Der wesentliche Unterschied gegenüber der bisherigen Prozessdefinition für den Workflowtype 160 (bzw. 200 für PKV) besteht in der Übergabe der Einlöseinformationen an die Apotheke durch den verordnenden Leistungserbringer.
@@ -75,6 +79,7 @@ NOTE: Im http-Header des äußeren http-Requests an die VAU (POST /VAU) sind die
[source,xml]
----
+
@@ -95,40 +100,38 @@ HTTP/1.1 201 Created
Content-Type: application/fhir+xml; charset=UTF-8
-
-
-
-
-
-
-
-
-
-
+
----
@@ -199,12 +202,13 @@ NOTE: Im http-Header des äußeren http-Requests an die VAU (POST /VAU) sind die
[source,xml]
----
+
-
-
@@ -221,70 +225,71 @@ HTTP/1.1 200 OK
Content-Type: application/fhir+xml;charset=utf-8
-
-
-
-
-
-
-
-
-
-
+
-
-
-
-
@@ -501,166 +506,131 @@ Content-Type: application/fhir+json;charset=utf-8
{
"resourceType": "Bundle",
- "id": "f5ba6eaf-9052-42f6-ac4e-fadceed7293b",
+ "id": "erp-steuerung-durch-le-08-response-taskGet169Versicherter",
"meta": {
"lastUpdated": "2020-03-01T07:02:37.836+00:00"
},
"type": "collection",
- "total": 2,
- "link": [{
- "relation": "self",
- "url": "https://erp.zentral.erp.splitdns.ti-dienste.de/Task/"
- }],
- "entry": [{
- "fullUrl": "https://erp.zentral.erp.splitdns.ti-dienste.de/Task/169.774.328.939.869.74",
- "resource": {
-
- "resourceType": "Task",
- "id": "169.774.328.939.869.74",
- "meta": {
- "profile": [
- "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.3"
- ],
- "tag": [
- {
- "display": "Task in READY state activated by (Z)PVS/KIS via $activate operation"
- }]
- },
- "intent": "order",
- "extension": [{
+ "link": [
+ {
+ "relation": "self",
+ "url": "https://erp.zentral.erp.splitdns.ti-dienste.de/Task/"
+ }
+ ],
+ "entry": [
+ {
+ "fullUrl": "https://erp.zentral.erp.splitdns.ti-dienste.de/Task/169.000.000.000.000.01",
+ "resource": {
+ "resourceType": "Task",
+ "id": "169.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": "169",
- "system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_FlowType",
- "display": "Muster 16 (Direkte Zuweisung)"
- }},
- {
+ "code": "169",
+ "system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_FlowType"
+ }
+ },
+ {
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_AcceptDate",
- "valueDate": "2022-06-02"
- },{
+ "valueDate": "2025-02-12"
+ },
+ {
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_ExpiryDate",
- "valueDate": "2022-06-02"
- }],
- "identifier": [
- {
+ "valueDate": "2025-04-15"
+ }
+ ],
+ "identifier": [
+ {
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
- "value": "169.774.328.939.869.74"
- }],
- "status": "ready",
- "authoredOn": "2022-03-18T15:26:00+00:00",
- "performerType": [
- {
- "coding": [{
- "code": "urn:oid:1.2.276.0.76.4.54",
- "system": "urn:ietf:rfc:3986",
- "display": "Öffentliche Apotheke"
- }]
- }],
- "for": {
- "identifier": {
+ "value": "169.000.000.000.000.01"
+ }
+ ],
+ "for": {
+ "identifier": {
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X123456789"
- }},
- "lastModified": "2022-03-18T15:27:00+00:00",
- "input": [
- {
- "type": {
- "coding": [
- {
- "code": "1",
- "system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_DocumentType",
- "display": "Health Care Provider Prescription"
- }]
- },
- "valueReference": {
- "reference": "281a985c-f25b-4aae-91a6-41ad744080b0"
- }
- },{
- "type": {
- "coding": [{
- "code": "2",
- "system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_DocumentType",
- "display": "Patient Confirmation"
- }]
- },
- "valueReference": {
- "reference": "f8c2298f-7c00-4a68-af29-8a2862d55d43"
- }}
- ]}
- },{
-
- "fullUrl": "https://erp.zentral.erp.splitdns.ti-dienste.de/Task/169.000.033.491.280.78",
- "resource": {
- "resourceType": "Task",
- "id": "169.000.033.491.280.78",
- "meta": {
- "profile": [
- "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.3"
- ]
+ }
+ },
+ "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"
+ }
+ ]
+ }
+ ],
+ "status": "ready"
+ }
},
- "intent": "order",
- "extension": [{
+ {
+ "fullUrl": "https://erp.zentral.erp.splitdns.ti-dienste.de/Task/169.000.000.000.000.02",
+ "resource": {
+ "resourceType": "Task",
+ "id": "169.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": "169",
- "system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_FlowType",
- "display": "Muster 16 (Direkte Zuweisung)"
- }},
- {
+ "code": "169",
+ "system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_FlowType"
+ }
+ },
+ {
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_AcceptDate",
- "valueDate": "2022-06-03"
- },{
+ "valueDate": "2025-02-12"
+ },
+ {
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_ExpiryDate",
- "valueDate": "2022-06-03"
- }],
- "identifier": [
- {
+ "valueDate": "2025-04-15"
+ }
+ ],
+ "identifier": [
+ {
"system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
- "value": "169.000.033.491.280.78"
- }],
- "status": "ready",
- "authoredOn": "2022-03-18T15:26:00+00:00",
- "performerType": [
- {
- "coding": [{
- "code": "urn:oid:1.2.276.0.76.4.54",
- "system": "urn:ietf:rfc:3986",
- "display": "Öffentliche Apotheke"
- }]
- }],
- "for": {
- "identifier": {
+ "value": "169.000.000.000.000.02"
+ }
+ ],
+ "for": {
+ "identifier": {
"system": "http://fhir.de/sid/gkv/kvid-10",
"value": "X123456789"
- }},
- "lastModified": "2022-03-18T15:27:00+00:00",
- "input": [
- {
- "type": {
- "coding": [
- {
- "code": "1",
- "system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_DocumentType",
- "display": "Health Care Provider Prescription"
- }]
- },
- "valueReference": {
- "reference": "281a985c-f25b-4aae-91a6-41ad744080b0"
- }
- },{
- "type": {
- "coding": [{
- "code": "2",
- "system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_DocumentType",
- "display": "Patient Confirmation"
- }]
- },
- "valueReference": {
- "reference": "f8c2298f-7c00-4a68-af29-8a2862d55d43"
- }
- }
- ]}
- }]
+ }
+ },
+ "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"
+ }
+ ]
+ }
+ ],
+ "status": "ready"
+ }
+ }
+ ]
}
----
NOTE: 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.
diff --git a/docs/erp_validation.adoc b/docs/erp_validation.adoc
index e2c592dc..2924baee 100644
--- a/docs/erp_validation.adoc
+++ b/docs/erp_validation.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Zielgruppe: image:{PVS}[] image:{AVS}[] image:{FdV}[]
Titus unterstützt die Validierung von FHIR-Ressourcen. Jeder eingehende Request wird vor seiner Weiterleitung an den Fachdienst vom HAPI-FHIR-Validator (mehr Infos unter https://confluence.hl7.org/display/FHIR/Using+the+FHIR+Validator) geprüft. Sollte die Validierung einen Fehler (ERROR-Meldung) aufweisen, so wird ein OperationOutcome erzeugt und als HTTP-Nachricht mit Status 400 an den Sender zurückgegeben. Die Validierung kann mit der CLI-Variante des HAPI-FHIR-Validator und den im Folgenden aufgelisteten Profil-Bundles nachvollzogen werden.
diff --git a/docs/erp_versicherte.adoc b/docs/erp_versicherte.adoc
index f0d311ed..c30bccfb 100644
--- a/docs/erp_versicherte.adoc
+++ b/docs/erp_versicherte.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Zielgruppe: image:{FdV}[]
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.
@@ -71,9 +75,9 @@ Content-Type: application/fhir+json;charset=utf-8
----
{
"resourceType": "Bundle",
- "id": "f5ba6eaf-9052-42f6-ac4e-fadceed7293b",
+ "id": "erp-versicherte-01-response-taskGetAll",
"meta": {
- "lastUpdated": "2020-03-01T07:02:37.836+00:00"
+ "lastUpdated": "2025-01-15T15:29:00.434+00:00"
},
"type": "collection",
"link": [
@@ -84,32 +88,16 @@ Content-Type: application/fhir+json;charset=utf-8
],
"entry": [
{
- "fullUrl": "https://erp.app.ti-dienste.de/Task/160.123.456.789.123.58",
+ "fullUrl": "https://erp.app.ti-dienste.de/Task/160.000.000.000.000.01",
"resource": {
"resourceType": "Task",
- "id": "160.123.456.789.123.58",
+ "id": "160.000.000.000.000.01",
"meta": {
- "versionId": "2",
- "lastUpdated": "2020-02-18T10:05:05.038+00:00",
- "source": "#AsYR9plLkvONJAiv",
"profile": [
- "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.3"
+ "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.4"
]
},
- "identifier": [
- {
- "use": "official",
- "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
- "value": "160.123.456.789.123.58"
- },
- {
- "use": "official",
- "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_AccessCode",
- "value": "777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea"
- }
- ],
"intent": "order",
- "status": "ready",
"extension": [
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_PrescriptionType",
@@ -119,57 +107,61 @@ Content-Type: application/fhir+json;charset=utf-8
"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": "2020-06-02"
+ "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"
},
{
- "url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_AcceptDate",
- "valueDate": "2020-04-01"
+ "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_AccessCode",
+ "use": "official",
+ "value": "777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea"
}
],
- "authoredOn": "2020-03-02T08:25:05+00:00",
- "lastModified": "2020-03-02T08:45:05+00:00",
+ "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"
- }
- ]
- }
+ {
+ "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.123.456.789.123.78",
+ "fullUrl": "https://erp.app.ti-dienste.de/Task/160.000.000.000.000.02",
"resource": {
"resourceType": "Task",
- "id": "160.123.456.789.123.78",
+ "id": "160.000.000.000.000.02",
"meta": {
- "versionId": "2",
- "lastUpdated": "2020-02-18T10:06:05.038+00:00",
- "source": "#AsYR9plLkvONJAiv",
"profile": [
- "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.3"
+ "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.4"
]
},
- "identifier": [
- {
- "use": "official",
- "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
- "value": "160.123.456.789.123.78"
- },
- {
- "use": "official",
- "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_AccessCode",
- "value": "777bea0e13cc9c42ceec14aec3ddee8402643dc2c6c699db115f58fe423607ea"
- }
- ],
"intent": "order",
- "status": "ready",
"extension": [
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_PrescriptionType",
@@ -179,57 +171,61 @@ Content-Type: application/fhir+json;charset=utf-8
"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": "2020-06-02"
+ "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"
},
{
- "url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_AcceptDate",
- "valueDate": "2020-04-01"
+ "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_AccessCode",
+ "use": "official",
+ "value": "777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea"
}
],
- "authoredOn": "2020-03-02T08:25:05+00:00",
- "lastModified": "2020-03-02T08:45:05+00:00",
+ "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"
- }
- ]
- }
+ {
+ "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.123.456.789.123.61",
+ "fullUrl": "https://erp.app.ti-dienste.de/Task/160.000.000.000.000.03",
"resource": {
"resourceType": "Task",
- "id": "160.123.456.789.123.61",
+ "id": "160.000.000.000.000.03",
"meta": {
- "versionId": "2",
- "lastUpdated": "2020-02-18T10:05:05.038+00:00",
- "source": "#AsYR9plLkvONJAiv",
"profile": [
- "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.3"
+ "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.4"
]
},
- "identifier": [
- {
- "use": "official",
- "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
- "value": "160.123.456.789.123.61"
- },
- {
- "use": "official",
- "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_AccessCode",
- "value": "777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607bl"
- }
- ],
"intent": "order",
- "status": "in-progress",
"extension": [
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_PrescriptionType",
@@ -240,30 +236,46 @@ Content-Type: application/fhir+json;charset=utf-8
}
},
{
- "url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_ExpiryDate",
- "valueDate": "2020-06-02"
+ "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_AcceptDate",
- "valueDate": "2020-04-01"
+ "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"
},
{
- "url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_LastMedicationDispense",
- "valueInstant": "2020-04-01T16:37:17+01:00"
+ "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_AccessCode",
+ "use": "official",
+ "value": "777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea"
}
],
- "authoredOn": "2020-03-02T08:25:05+00:00",
- "lastModified": "2020-03-02T08:45:05+00:00",
+ "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"
- }
- ]
- }
+ {
+ "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"
+ }
]
}
}
@@ -318,7 +330,7 @@ Beim Statusübergang zu "closed" stehen die MedicationDispense Informationen zur
[cols="h,a"]
[%autowidth]
|===
-|URI |https://erp.app.ti-dienste.de/Task/160.123.456.789.123.58
+|URI |https://erp.app.ti-dienste.de/Task/160.000.000.000.000.01
|Method |GET
|Requester |image:{FdV}[]
|Responder |image:{eRp}[]
@@ -346,43 +358,29 @@ Content-Type: application/fhir+json;charset=utf-8
----
{
"resourceType": "Bundle",
- "id": "f5ba6eaf-9052-42f6-ac4e-fadceed7293b",
+ "id": "erp-versicherte-02-response-taskGetSingle",
"meta": {
- "lastUpdated": "2020-03-01T07:02:37.836+00:00"
+ "lastUpdated": "2025-01-15T15:29:00.434+00:00"
},
"type": "collection",
- "total": 2,
- "link": [{
- "relation": "self",
- "url": "https://erp.app.ti-dienste.de/Task/160.123.456.789.123.58"
- }],
- "entry": [{
- "fullUrl": "https://erp.app.ti-dienste.de/Task/160.123.456.789.123.58",
- "resource": {
+ "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.123.456.789.123.58",
+ "id": "160.000.000.000.000.01",
"meta": {
- "versionId": "2",
- "lastUpdated": "2020-02-18T10:05:05.038+00:00",
- "source": "#AsYR9plLkvONJAiv",
"profile": [
- "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.3"
+ "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.4"
]
},
- "identifier": [
- {
- "use": "official",
- "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
- "value": "160.123.456.789.123.58"
- },
- {
- "use": "official",
- "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_AccessCode",
- "value": "777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea"
- }
- ],
"intent": "order",
- "status": "ready",
"extension": [
{
"url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_PrescriptionType",
@@ -392,624 +390,1701 @@ Content-Type: application/fhir+json;charset=utf-8
"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": "2020-06-02"
+ "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"
},
{
- "url": "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_EX_AcceptDate",
- "valueDate": "2020-04-01"
+ "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_AccessCode",
+ "use": "official",
+ "value": "777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea"
}
],
- "authoredOn": "2020-03-02T08:25:05+00:00",
- "lastModified": "2020-03-02T08:45:05+00:00",
+ "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"
- }
- ]
- }
+ {
+ "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": [{
- "system":"https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_DocumentType",
- "code":"2"
- }]
- },
- "valueString": "f8c2298f-7c00-4a68-af29-8a2862d55d43"
- }]
+ "input": [
+ {
+ "type": {
+ "coding": [
+ {
+ "code": "2",
+ "system": "https://gematik.de/fhir/erp/CodeSystem/GEM_ERP_CS_DocumentType"
+ }
+ ]
+ },
+ "valueReference": {
+ "reference": "414ca393-dde3-4082-9a3b-3752e629e4aa"
+ }
+ }
+ ]
}
- },{
- "resource": {
+ },
+ {
+ "fullUrl": "urn:uuid:414ca393-dde3-4082-9a3b-3752e629e4aa",
+ "resource": {
"resourceType": "Bundle",
"id": "414ca393-dde3-4082-9a3b-3752e629e4aa",
"meta": {
- "lastUpdated": "2022-05-20T08:30:00Z",
"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": "200.086.824.605.539.20"
- },
- [...],
- "signature": {
- "type": {
- "system": "http://hl7.org/fhir/ValueSet/signature-type",
- "code": "1.2.840.10065.1.12.1.1"
+ "value": "160.000.000.000.000.01"
},
- "when": "2020-03-20T07:31:34.328+00:00",
- "who": "https://erp.app.ti-dienste.de/signature/verification",
- "data": "eyJ0eXAiOiJKV1MiLCJhbGciOiJFUzI1NiIsIng1dSI6Imh0dHBzOi8vcHJlc2NyaXB0aW9uc2VydmVyLnRlbGVtYXRpay9zaWduYXR1cmUvY2VydGlmaWNhdGUifQ..SSBhbSBhIHNpZ25hdHVyZSE="
- }
- }
- }]
-}
-----
-NOTE: 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.
-
-NOTE: 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.
-
-NOTE: 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.
-
-NOTE: 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).
-
-NOTE: Mit `"valueString": "f8c2298f-7c00-4a68-af29-8a2862d55d43"` verweist der Task auf das signierte E-Rezept-Bundle im zurückgegebenen Bundle.
-
-NOTE: 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.
-
-NOTE: 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.
-
-
-[cols="a,a"]
-[%autowidth]
-|===
-s|Code s|Type Success
-|200 | OK +
-[small]#Die Anfrage wurde erfolgreich bearbeitet. Die angeforderte Ressource wird im ResponseBody bereitgestellt.#
-s|Code s|Type Error
-|400 | Bad Request +
-[small]#Die Anfrage-Nachricht war fehlerhaft aufgebaut.#
-|401 |Unauthorized +
-[small]#Die Anfrage kann nicht ohne gültige Authentifizierung durchgeführt werden. Wie die Authentifizierung durchgeführt werden soll, wird im "WWW-Authenticate"-Header-Feld der Antwort übermittelt.#
-|403 |Forbidden +
-[small]#Die Anfrage wurde mangels Berechtigung des Clients nicht durchgeführt, bspw. weil der authentifizierte Benutzer nicht berechtigt ist.#
-|404 |Not found +
-[small]#Die adressierte Ressource wurde nicht gefunden, die übergebene ID ist ungültig.#
-|405 |Method Not Allowed +
-[small]#Die Anfrage darf nur mit anderen HTTP-Methoden (zum Beispiel GET statt POST) gestellt werden. Gültige Methoden für die betreffende Ressource werden im "Allow"-Header-Feld der Antwort übermittelt.#
-|429 |Too Many Requests +
-[small]#Der Client hat zu viele Anfragen in einem bestimmten Zeitraum gesendet.#
-|500 |Server Errors +
-[small]#Unerwarteter Serverfehler#
-|===
-
-== Informationen an den Apotheker übergeben
-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.123.456.789.123.58`
-
-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.
-[cols="a,a", grid="all", width="99%"]
-|================
-|
-[source,json]
-----
-{
- "urls": [ "Task/160.123.456.789.123.58/$accept?ac=777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea" ]
-}
-----
-^.^| image:datamatrix_sample.png[width=250px]
-
-In DataMatrix-Darstellung gemäß ISO/IEC 16022:2006
-| Sammlung von drei E-Rezept-Referenzen in einem 2D-Code +
-[source,json]
-----
-{
- "urls": [
- "Task/160.123.456.789.123.58/$accept?ac=777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea",
- "Task/160.346.135.722.516.16/$accept?ac=0936cfa582b447144b71ac89eb7bb83a77c67c99d4054f91ee3703acf5d6a629",
- "Task/160.880.966.157.248.22/$accept?ac=d3e6092ae3af14b5225e2ddbe5a4f59b3939a907d6fdd5ce6a760ca71f45d8e5"
- ]
-}
-----
-
-^.^| image:datamatrix_sample_3.png[width=250px]
-
-In DataMatrix-Darstellung gemäß ISO/IEC 16022:2006
-|================
-NOTE: Aktuell unterstüten die Apothekenverwaltungssysteme auf Basis des SecurPharm-System in jedem Fall das DataMatrix-Format.
-
-// horizontal line
-***
-
-== Eine Apotheke aus dem Apotheken-Verzeichnis auswählen
-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.
+ "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"
+ }
+ }
+ }
+ ]
+ }
+ }
+ ]
+}
+----
+NOTE: 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.
+
+NOTE: 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.
+
+NOTE: 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.
+
+NOTE: 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).
+
+NOTE: Mit `"valueString": "f8c2298f-7c00-4a68-af29-8a2862d55d43"` verweist der Task auf das signierte E-Rezept-Bundle im zurückgegebenen Bundle.
+
+NOTE: 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.
+
+NOTE: 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.
+
+
+[cols="a,a"]
+[%autowidth]
+|===
+s|Code s|Type Success
+|200 | OK +
+[small]#Die Anfrage wurde erfolgreich bearbeitet. Die angeforderte Ressource wird im ResponseBody bereitgestellt.#
+s|Code s|Type Error
+|400 | Bad Request +
+[small]#Die Anfrage-Nachricht war fehlerhaft aufgebaut.#
+|401 |Unauthorized +
+[small]#Die Anfrage kann nicht ohne gültige Authentifizierung durchgeführt werden. Wie die Authentifizierung durchgeführt werden soll, wird im "WWW-Authenticate"-Header-Feld der Antwort übermittelt.#
+|403 |Forbidden +
+[small]#Die Anfrage wurde mangels Berechtigung des Clients nicht durchgeführt, bspw. weil der authentifizierte Benutzer nicht berechtigt ist.#
+|404 |Not found +
+[small]#Die adressierte Ressource wurde nicht gefunden, die übergebene ID ist ungültig.#
+|405 |Method Not Allowed +
+[small]#Die Anfrage darf nur mit anderen HTTP-Methoden (zum Beispiel GET statt POST) gestellt werden. Gültige Methoden für die betreffende Ressource werden im "Allow"-Header-Feld der Antwort übermittelt.#
+|429 |Too Many Requests +
+[small]#Der Client hat zu viele Anfragen in einem bestimmten Zeitraum gesendet.#
+|500 |Server Errors +
+[small]#Unerwarteter Serverfehler#
+|===
+
+== Informationen an den Apotheker übergeben
+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.
+[cols="a,a", grid="all", width="99%"]
+|================
+|
+[source,json]
+----
+{
+ "urls": [ "Task/160.000.000.000.000.01/$accept?ac=777bea0e13cc9c42ceec14aec3ddee2263325dc2c6c699db115f58fe423607ea" ]
+}
+----
+^.^| image:datamatrix_sample.png[width=250px]
+
+In DataMatrix-Darstellung gemäß ISO/IEC 16022:2006
+| Sammlung von drei E-Rezept-Referenzen in einem 2D-Code +
+[source,json]
+----
+{
+ "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"
+ ]
+}
+----
+
+^.^| image:datamatrix_sample_3.png[width=250px]
+
+In DataMatrix-Darstellung gemäß ISO/IEC 16022:2006
+|================
+NOTE: Aktuell unterstüten die Apothekenverwaltungssysteme auf Basis des SecurPharm-System in jedem Fall das DataMatrix-Format.
+
+// horizontal line
+***
+
+== Eine Apotheke aus dem Apotheken-Verzeichnis auswählen
+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*
+[cols="h,a"]
+[%autowidth]
+|===
+|URI |https://apovzd.app.ti-dienste.de/api/Location?name=Adler
+|Method |GET
+|Requester |image:{FdV}[]
+|Responder | APOVZD
+|Request|
+----
+GET /api/Location?name=Adler HTTP/1.1
+Host: apovzd.app.ti-dienste.de
+Pragma: no-cache
+Cache-Control: no-cache
+----
+
+TIP: Dieser Request ist NICHT zusätzlich VAU-verschlüsselt, sondern wird plain an das Apothekenverzeichnis geschickt.
+|===
+
+NOTE: 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*
+[source,text]
+----
+HTTP/1.1 200 OK
+Content-Type: application/fhir+json;charset=utf-8
+
+...
+----
+
+[%collapsible]
+====
+[source,json]
+----
+{
+ "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"
+ }
+ }
+ ]
+}
+----
+NOTE: Die Suchanfrage nach `Adler`-Apotheken liefert genau zwei Treffer.
+
+NOTE: Die `Telematik-ID` ist die eindeutige Kennung der Apotheke, um an diese bspw. eine Nachricht zu schicken.
+
+NOTE: Der Name der Apotheke, unter dem sie im Verzeichnis geführt wird findet sich unter z.B.`"name": "Apotheke am Adler"`
+====
+
+[cols="a,a"]
+[%autowidth]
+|===
+s|Code s|Type Success
+|200 | OK +
+[small]#Die Anfrage wurde erfolgreich bearbeitet. Die Response enthält die angefragten Daten.#
+s|Code s|Type Error
+|400 | Bad Request +
+[small]#Die Anfrage-Nachricht war fehlerhaft aufgebaut.#
+|401 |Unauthorized +
+[small]#Die Anfrage kann nicht ohne gültige Authentifizierung durchgeführt werden. Wie die Authentifizierung durchgeführt werden soll, wird im "WWW-Authenticate"-Header-Feld der Antwort übermittelt.#
+|403 |Forbidden +
+[small]#Die Anfrage wurde mangels Berechtigung des Clients nicht durchgeführt, bspw. weil der authentifizierte Benutzer nicht berechtigt ist.#
+|404 |Not found +
+[small]#Es wurde kein passender Verzeichniseintrag gefunden.#
+|500 |Server Errors +
+[small]#Unerwarteter Serverfehler#
+|===
+
+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 link:./erp_communication.adoc[Apotheke eine Nachricht geschickt werden kann].
+
+== Abgabeinformationen abrufen
+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*
[cols="h,a"]
[%autowidth]
|===
-|URI |https://apovzd.app.ti-dienste.de/api/Location?name=Adler
+|URI |https://erp.app.ti-dienste.de/MedicationDispense?whenhandedover=gt2020-03-01
|Method |GET
|Requester |image:{FdV}[]
-|Responder | APOVZD
-|Request|
+|Responder |image:{eRp}[]
+|URL Parameter | whenhandedover, whenprepared, performer
+|HTTP Header |
----
-GET /api/Location?name=Adler HTTP/1.1
-Host: apovzd.app.ti-dienste.de
-Pragma: no-cache
-Cache-Control: no-cache
+Authorization: Bearer eyJraWQ.ewogImL2pA10Qql22ddtutrvx4FsDlz.rHQjEmB1lLmpqn9J
+----
+NOTE: Mit dem ACCESS_TOKEN im `Authorization`-Header weist sich der Zugreifende als Versicherter aus, im Token ist seine Versichertennummer enthalten nach welcher die Einträge gefiltert werden. Die Base64-Darstellung des Tokens ist stark gekürzt.
+
+NOTE: Im http-Header des äußeren http-Requests an die VAU (POST /VAU) sind die Header `X-erp-user: v` und `X-erp-resource: MedicationDispense` zu setzen.
+
+|Payload | -
+|===
+
+
+*Response*
+HTTP/1.1 200 OK
+Content-Type: application/fhir+json;charset=utf-8
+
+[source,json]
+----
+{
+ "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"
+ }
+ }
+ ]
+}
----
+NOTE: 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.
-TIP: Dieser Request ist NICHT zusätzlich VAU-verschlüsselt, sondern wird plain an das Apothekenverzeichnis geschickt.
-|===
-
-NOTE: 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.
+NOTE: Unter `"performer"` findet sich die Telematik-ID der Apotheke, bei der das E-Rezept eingelöst wurde.
-*Response*
-[source,text]
-----
-HTTP/1.1 200 OK
-Content-Type: application/fhir+json;charset=utf-8
+NOTE: ` "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`)
-...
-----
+WARNING: 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)
[%collapsible]
====
-[source,json]
+HTTP/1.1 200 OK
+Content-Type: application/fhir+xml;charset=utf-8
+[source,xml]
----
{
- "id": "2b50e07d-ace1-4f83-ae8f-e2845e291cc3",
- "meta": {
- "lastUpdated": "2021-11-23T10:33:52.590809+02:00"
- },
"resourceType": "Bundle",
+ "id": "erp-versicherte-04-response-getDispenseMultiple2",
"type": "searchset",
- "total": 2,
- "link": [
- {
- "relation": "self",
- "url": "Bundle2b50e07d-ace1-4f83-ae8f-e2845e291cc3"
- }
- ],
"entry": [
{
+ "fullUrl": "https://erp-dev.zentral.erp.splitdns.ti-dienste.de/MedicationDispense/160.000.000.000.000.01",
"resource": {
- "id": "5a403761-3a18-4ae9-bca8-9ed8abada08a",
- "resourceType": "Location",
- "address": {
- "use": "work",
- "type": "physical",
- "line": [
- "Friedrichstr. 136"
- ],
- "postalCode": "10117",
- "city": "Berlin",
- "country": "de"
+ "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/sid/telematik-id",
- "value": "3-1.54.10123404"
+ "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
+ "value": "160.000.000.000.000.01"
}
],
- "name": "Adlerapotheke",
- "position": {
- "latitude": 52.522575,
- "longitude": 13.387884
+ "status": "completed",
+ "subject": {
+ "identifier": {
+ "system": "http://fhir.de/sid/gkv/kvid-10",
+ "value": "X123456789"
+ }
},
- "status": "active",
- "telecom": [
- {
- "system": "email",
- "value": "service@gematik.de"
- },
- {
- "system": "phone",
- "value": "030 40041 0"
- },
+ "performer": [
{
- "system": "url",
- "value": "www.gematik.de"
+ "actor": {
+ "identifier": {
+ "system": "https://gematik.de/fhir/sid/telematik-id",
+ "value": "3-2-APO-XanthippeVeilchenblau01"
+ }
+ }
}
],
- "type": [
+ "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": [
{
- "coding": [
- {
- "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
- "code": "PHARM",
- "display": "pharmacy"
- }
- ]
- },
+ "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": [
{
- "coding": [
- {
- "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
- "code": "MOBL",
- "display": "Mobile Services"
+ "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": {
- "id": "354d16fa-ceff-4a18-b1b7-c583ee211cea",
+ "resourceType": "Medication",
+ "id": "56c61db7-0a94-4b7b-832a-b8ac3752035d",
"meta": {
- "lastUpdated": "2021-10-12T11:54:29+02:00"
+ "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"
},
- "resourceType": "Location",
"contained": [
{
- "id": "8fe0eea1-6379-41ce-bb51-efd33f02e853",
- "resourceType": "HealthcareService",
- "active": true,
- "coverageArea": [
+ "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": [
{
- "extension": [
- {
- "url": "https://ngda.de/fhir/extensions/ServiceCoverageRange",
- "valueQuantity": {
- "value": 5000,
- "unit": "m"
+ "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"
}
- }
- ]
- }
- ],
- "location": [
+ ]
+ }
+ },
{
- "reference": "/Location/354d16fa-ceff-4a18-b1b7-c583ee211cea"
+ "url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Vaccine",
+ "valueBoolean": false
+ },
+ {
+ "url": "http://fhir.de/StructureDefinition/normgroesse",
+ "valueCode": "N3"
}
],
- "type": [
- {
- "coding": [
+ "form": {
+ "coding": [
+ {
+ "code": "FTA",
+ "system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM"
+ }
+ ]
+ },
+ "amount": {
+ "denominator": {
+ "value": 1
+ },
+ "numerator": {
+ "extension": [
{
- "system": "http://terminology.hl7.org/CodeSystem/service-type",
- "code": "498",
- "display": "Mobile Services"
+ "url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_PackagingSize",
+ "valueString": "12"
}
- ]
+ ],
+ "unit": "St"
}
- ]
+ },
+ "batch": {
+ "lotNumber": "123456"
+ }
}
],
- "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"
- },
+ "dosageInstruction": [
{
- "daysOfWeek": [
- "sat"
- ],
- "openingTime": "08:30:00",
- "closingTime": "14:00:00"
+ "text": "1-0-1-0"
}
],
- "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"
+ "subject": {
+ "identifier": {
+ "value": "X123456789"
}
- ],
- "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"
- },
+ "status": "completed",
+ "performer": [
{
- "system": "url",
- "value": "https://www.gematik.de"
+ "actor": {
+ "identifier": {
+ "system": "https://gematik.de/fhir/sid/telematik-id",
+ "value": "3-2-APO-XanthippeVeilchenblau01"
+ }
+ }
}
],
- "type": [
- {
- "coding": [
- {
- "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
- "code": "PHARM",
- "display": "pharmacy"
- }
- ]
- },
+ "whenHandedOver": "2024-07-02",
+ "identifier": [
{
- "coding": [
- {
- "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
- "code": "OUTPHARM",
- "display": "outpatient pharmacy"
- }
- ]
+ "value": "160.000.000.000.000.04",
+ "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId"
}
]
},
"search": {
"mode": "match"
- }
- }
- ]
-}
-----
-NOTE: Die Suchanfrage nach `Adler`-Apotheken liefert genau zwei Treffer.
-
-NOTE: Die `Telematik-ID` ist die eindeutige Kennung der Apotheke, um an diese bspw. eine Nachricht zu schicken.
-
-NOTE: Der Name der Apotheke, unter dem sie im Verzeichnis geführt wird findet sich unter z.B.`"name": "Apotheke am Adler"`
-====
-
-[cols="a,a"]
-[%autowidth]
-|===
-s|Code s|Type Success
-|200 | OK +
-[small]#Die Anfrage wurde erfolgreich bearbeitet. Die Response enthält die angefragten Daten.#
-s|Code s|Type Error
-|400 | Bad Request +
-[small]#Die Anfrage-Nachricht war fehlerhaft aufgebaut.#
-|401 |Unauthorized +
-[small]#Die Anfrage kann nicht ohne gültige Authentifizierung durchgeführt werden. Wie die Authentifizierung durchgeführt werden soll, wird im "WWW-Authenticate"-Header-Feld der Antwort übermittelt.#
-|403 |Forbidden +
-[small]#Die Anfrage wurde mangels Berechtigung des Clients nicht durchgeführt, bspw. weil der authentifizierte Benutzer nicht berechtigt ist.#
-|404 |Not found +
-[small]#Es wurde kein passender Verzeichniseintrag gefunden.#
-|500 |Server Errors +
-[small]#Unerwarteter Serverfehler#
-|===
-
-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 link:./erp_communication.adoc[Apotheke eine Nachricht geschickt werden kann].
-
-== Abgabeinformationen abrufen
-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*
-[cols="h,a"]
-[%autowidth]
-|===
-|URI |https://erp.app.ti-dienste.de/MedicationDispense?whenhandedover=gt2020-03-01
-|Method |GET
-|Requester |image:{FdV}[]
-|Responder |image:{eRp}[]
-|URL Parameter | whenhandedover, whenprepared, performer
-|HTTP Header |
-----
-Authorization: Bearer eyJraWQ.ewogImL2pA10Qql22ddtutrvx4FsDlz.rHQjEmB1lLmpqn9J
-----
-NOTE: Mit dem ACCESS_TOKEN im `Authorization`-Header weist sich der Zugreifende als Versicherter aus, im Token ist seine Versichertennummer enthalten nach welcher die Einträge gefiltert werden. Die Base64-Darstellung des Tokens ist stark gekürzt.
-
-NOTE: Im http-Header des äußeren http-Requests an die VAU (POST /VAU) sind die Header `X-erp-user: v` und `X-erp-resource: MedicationDispense` zu setzen.
-
-|Payload | -
-|===
-
-
-*Response*
-HTTP/1.1 200 OK
-Content-Type: application/fhir+json;charset=utf-8
-
-[source,json]
-----
-{
- "resourceType": "Bundle",
- "id": "187dc298-c2b8-40f5-8938-c6c4078660ed",
- "meta": {
- "lastUpdated": "2020-04-07T08:05:42.225+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/1093629",
+ "fullUrl": "https://erp-dev.zentral.erp.splitdns.ti-dienste.de/MedicationDispense/160.000.000.000.000.05",
"resource": {
- "status": "completed",
- "id": "1093629",
- "identifier": [
- {
- "value": "160.123.456.789.123.58",
- "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId"
- }
- ],
"resourceType": "MedicationDispense",
- "medicationReference": {
- "display": "Sumatriptan-1a Pharma 100 mg Tabletten",
- "reference": "#med0314"
- },
+ "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"
]
},
- "id": "med0314",
"code": {
+ "text": "Sumatriptan Dura 100mg",
"coding": [
{
- "code": "06313728",
+ "code": "04866280",
"system": "http://fhir.de/CodeSystem/ifa/pzn"
}
- ],
- "text": "Sumatriptan-1a Pharma 100 mg Tabletten"
+ ]
},
"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": [
{
- "display": "Medicinal product (product)",
+ "code": "763158003",
"system": "http://snomed.info/sct",
- "version": "http://snomed.info/sct/900000000000207008/version/20220331",
- "code": "763158003"
+ "display": "Medicinal product (product)",
+ "version": "http://snomed.info/sct/900000000000207008/version/20220331"
}
]
}
},
- {
- "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
+ },
+ {
+ "url": "http://fhir.de/StructureDefinition/normgroesse",
+ "valueCode": "N3"
}
],
- "resourceType": "Medication",
+ "form": {
+ "coding": [
+ {
+ "code": "FTA",
+ "system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM"
+ }
+ ]
+ },
"amount": {
"denominator": {
"value": 1
},
"numerator": {
- "unit": "Tabletten",
"extension": [
{
"url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_PackagingSize",
- "valueString": "10"
+ "valueString": "12"
}
],
- "system": "http://unitsofmeasure.org",
- "code": "{tbl}"
+ "unit": "St"
}
},
- "form": {
- "coding": [
- {
- "code": "TAB",
- "system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM"
- }
- ]
+ "batch": {
+ "lotNumber": "123456"
}
}
],
@@ -1018,28 +2093,29 @@ Content-Type: application/fhir+json;charset=utf-8
"text": "1-0-1-0"
}
],
+ "subject": {
+ "identifier": {
+ "value": "X123456789"
+ }
+ },
+ "status": "completed",
"performer": [
{
"actor": {
"identifier": {
- "value": "3-SMC-B-Testkarte-883110000129070",
- "system": "https://gematik.de/fhir/sid/telematik-id"
+ "system": "https://gematik.de/fhir/sid/telematik-id",
+ "value": "3-2-APO-XanthippeVeilchenblau01"
}
}
}
],
- "whenHandedOver": "2020-03-20",
- "quantity": {
- "system": "http://unitsofmeasure.org",
- "value": 1,
- "code": "{Package}"
- },
- "subject": {
- "identifier": {
- "value": "X123456789",
- "system": "http://fhir.de/sid/gkv/kvid-10"
+ "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"
@@ -1048,11 +2124,8 @@ Content-Type: application/fhir+json;charset=utf-8
]
}
----
-NOTE: 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.
-NOTE: Unter `"performer"` findet sich der Name und die Betriebsstättennummer Telematik-ID der Apotheke, bei der das E-Rezept eingelöst wurde.
-
-NOTE: ` "whenHandedOver"` wurde als Filterkriterium verwendet, das Medikament wurde hier am 20.03.2020 ausgehändigt (`whenhandedover`) und ist damit vom Datumswert "größer" als das Datum des Filterkriteriums der Suchanfrage 01.01.2020 (`whenhandedover=gt2020-01-01`)
+====
[cols="a,a"]
@@ -1088,7 +2161,7 @@ WARNING: Der Endpunkt `GET /MedicationDispense/` wird deprecated und steht a
[cols="h,a",separator=¦]
[%autowidth]
|===
-¦URI ¦https://erp.app.ti-dienste.de/MedicationDispense?identifier=https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId|160.880.966.157.248.22
+¦URI ¦https://erp.app.ti-dienste.de/MedicationDispense?identifier=https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId|160.000.000.000.000.01®
¦Method ¦GET
|Requester |image:{FdV}[]
|Responder |image:{eRp}[]
@@ -1111,144 +2184,182 @@ Content-Type: application/fhir+json;charset=utf-8
[source,json]
----
{
- "id": "7f68987f-4e18-405e-9159-8fb603b71da7",
- "type": "searchset",
- "timestamp": "2024-02-15T06:01:44.119+00:00",
- "resourceType": "Bundle",
- "total": 0,
- "link": [
- {
- "relation": "self",
- "url": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/MedicationDispense?identifier=200.000.002.097.952.60"
+ "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"
}
- ],
- "entry": [
- {
- "fullUrl": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/MedicationDispense/200.000.002.097.952.60",
- "resource": {
- "resourceType": "MedicationDispense",
- "meta": {
- "profile": [
- "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_MedicationDispense|1.3"
- ]
- },
- "contained": [
- {
- "resourceType": "Medication",
- "id": "b4c2bba5-23bd-4be3-b58f-a70621edd84f",
- "meta": {
- "profile": [
- "https://fhir.kbv.de/StructureDefinition/KBV_PR_ERP_Medication_PZN|1.1.0"
- ]
- },
- "extension": [
- {
- "url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_Base_Medication_Type",
- "valueCodeableConcept": {
- "coding": [
- {
- "system": "http://snomed.info/sct",
- "version": "http://snomed.info/sct/900000000000207008/version/20220331",
- "code": "763158003",
- "display": "Medicinal product (product)"
- }
- ]
- }
- },
- {
- "url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Category",
- "valueCoding": {
- "system": "https://fhir.kbv.de/CodeSystem/KBV_CS_ERP_Medication_Category",
- "code": "00"
- }
- },
- {
- "url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Vaccine",
- "valueBoolean": false
- },
- {
- "url": "http://fhir.de/StructureDefinition/normgroesse",
- "valueCode": "N1"
- }
- ],
- "code": {
- "coding": [
- {
- "system": "http://fhir.de/CodeSystem/ifa/pzn",
- "code": "03879429"
- }
- ],
- "text": "Beloc-Zok® mite 47,5 mg, 30 Retardtabletten N1"
- },
- "form": {
- "coding": [
- {
- "system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM",
- "code": "RET"
- }
- ]
- },
- "amount": {
- "numerator": {
- "extension": [
- {
- "url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_PackagingSize",
- "valueString": "30"
- }
- ],
- "unit": "Stück"
- },
- "denominator": {
- "value": 1
- }
- }
- }
- ],
- "identifier": [
+ },
+ "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": [
{
- "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
- "value": "200.000.002.097.951.63"
+ "valueCode": "unknown",
+ "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
- ],
- "status": "completed",
- "medicationReference": {
- "reference": "#b4c2bba5-23bd-4be3-b58f-a70621edd84f",
- "display": "Sumatriptan-1a Pharma 100 mg Tabletten"
+ ]
},
- "subject": {
- "identifier": {
- "system": "http://fhir.de/sid/gkv/kvid-10",
- "value": "X110501499"
+ "_code": {
+ "extension": [
+ {
+ "valueCode": "unknown",
+ "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
- },
- "performer": [
+ ]
+ }
+ },
+ "denominator": {
+ "value": 1,
+ "_system": {
+ "extension": [
{
- "actor": {
- "identifier": {
- "system": "https://gematik.de/fhir/sid/telematik-id",
- "value": "3-2-APO-XanthippeVeilchenblau01"
- }
- }
+ "valueCode": "unknown",
+ "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
- ],
- "quantity": {
- "value": 1,
- "system": "http://unitsofmeasure.org",
- "code": "{Package}"
+ ]
},
- "whenHandedOver": "2024-02-15",
- "dosageInstruction": [
+ "_code": {
+ "extension": [
{
- "text": "1-0-1-0"
+ "valueCode": "unknown",
+ "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
- ],
- "id": "200.000.002.097.951.63"
+ ]
+ }
+ }
},
- "search": {
- "mode": "match"
+ "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"
+ }
+ }
+ ]
}
----
NOTE: 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.
@@ -1311,269 +2422,282 @@ Content-Type: application/fhir+json;charset=utf-8
[source,json]
----
{
- "id": "7f68987f-4e18-405e-9159-8fb603b71da7",
- "type": "searchset",
- "timestamp": "2024-02-15T06:01:44.119+00:00",
- "resourceType": "Bundle",
- "total": 0,
- "entry": [
- {
- "fullUrl": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/MedicationDispense/200.000.002.097.952.60",
- "resource": {
- "resourceType": "MedicationDispense",
- "id": "200.000.002.097.952.60",
- "meta": {
- "profile": [
- "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_MedicationDispense|1.3"
- ],
- "tag": [
- {
- "display": "Beispiel MedicationDispense PKV PZN Bsp 7 1/2"
- }
- ]
- },
- "contained": [
- {
- "resourceType": "Medication",
- "id": "b4c2bba5-23bd-4be3-b58f-a70621edd84f",
- "meta": {
- "profile": [
- "https://fhir.kbv.de/StructureDefinition/KBV_PR_ERP_Medication_PZN|1.1.0"
- ]
- },
- "extension": [
- {
- "url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_Base_Medication_Type",
- "valueCodeableConcept": {
- "coding": [
- {
- "system": "http://snomed.info/sct",
- "version": "http://snomed.info/sct/900000000000207008/version/20220331",
- "code": "763158003",
- "display": "Medicinal product (product)"
- }
- ]
- }
- },
- {
- "url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Category",
- "valueCoding": {
- "system": "https://fhir.kbv.de/CodeSystem/KBV_CS_ERP_Medication_Category",
- "code": "00"
- }
- },
- {
- "url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Vaccine",
- "valueBoolean": false
- },
- {
- "url": "http://fhir.de/StructureDefinition/normgroesse",
- "valueCode": "N1"
- }
- ],
- "code": {
- "coding": [
- {
- "system": "http://fhir.de/CodeSystem/ifa/pzn",
- "code": "03879429"
- }
- ],
- "text": "Beloc-Zok® mite 47,5 mg, 30 Retardtabletten N1"
- },
- "form": {
- "coding": [
- {
- "system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM",
- "code": "RET"
- }
- ]
- },
- "amount": {
- "numerator": {
- "extension": [
- {
- "url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_PackagingSize",
- "valueString": "30"
- }
- ],
- "unit": "Stück"
- },
- "denominator": {
- "value": 1
- }
- }
- }
- ],
- "identifier": [
- {
- "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
- "value": "200.000.002.097.952.60"
- }
- ],
- "status": "completed",
- "medicationReference": {
- "reference": "#b4c2bba5-23bd-4be3-b58f-a70621edd84f",
- "display": "Amoxicillin/Clavulansäure Heumann 875mg/125mg 10St"
- },
- "subject": {
- "identifier": {
- "system": "http://fhir.de/sid/pkv/kvid-10",
- "value": "X110501499"
- }
- },
- "performer": [
- {
- "actor": {
- "identifier": {
- "system": "https://gematik.de/fhir/sid/telematik-id",
- "value": "3-2-APO-XanthippeVeilchenblau01"
- }
- }
- }
- ],
- "whenHandedOver": "2024-02-15",
- "dosageInstruction": [
- {
- "text": "1 Tablette noch in der Nacht, dann für 7 Tage jeweils 1 Tablette morgens und 1 Tablette abends einnehmen"
- }
- ]
- },
- "search": {
- "mode": "match"
+ "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
+ }
},
- {
- "fullUrl": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/MedicationDispense/200.000.002.097.952.60-1",
- "resource": {
- "resourceType": "MedicationDispense",
- "id": "200.000.002.097.952.60-1",
- "meta": {
- "profile": [
- "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_MedicationDispense|1.3"
- ],
- "tag": [
- {
- "display": "Beispiel MedicationDispense PKV PZN Bsp 7 2/2"
- }
- ]
- },
- "contained": [
- {
- "resourceType": "Medication",
- "id": "b4c2bba5-23bd-4be3-b58f-a70621edd84f",
- "meta": {
- "profile": [
- "https://fhir.kbv.de/StructureDefinition/KBV_PR_ERP_Medication_PZN|1.1.0"
- ]
- },
- "extension": [
- {
- "url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_Base_Medication_Type",
- "valueCodeableConcept": {
- "coding": [
- {
- "system": "http://snomed.info/sct",
- "version": "http://snomed.info/sct/900000000000207008/version/20220331",
- "code": "763158003",
- "display": "Medicinal product (product)"
- }
- ]
- }
- },
- {
- "url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Category",
- "valueCoding": {
- "system": "https://fhir.kbv.de/CodeSystem/KBV_CS_ERP_Medication_Category",
- "code": "00"
- }
- },
- {
- "url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_Vaccine",
- "valueBoolean": false
- },
- {
- "url": "http://fhir.de/StructureDefinition/normgroesse",
- "valueCode": "N1"
- }
- ],
- "code": {
- "coding": [
- {
- "system": "http://fhir.de/CodeSystem/ifa/pzn",
- "code": "03879429"
- }
- ],
- "text": "Beloc-Zok® mite 47,5 mg, 30 Retardtabletten N1"
- },
- "form": {
- "coding": [
- {
- "system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM",
- "code": "RET"
- }
- ]
- },
- "amount": {
- "numerator": {
- "extension": [
- {
- "url": "https://fhir.kbv.de/StructureDefinition/KBV_EX_ERP_Medication_PackagingSize",
- "valueString": "30"
- }
- ],
- "unit": "Stück"
- },
- "denominator": {
- "value": 1
- }
- }
- }
- ],
- "identifier": [
+ "ingredient": [
+ {
+ "strength": {
+ "numerator": {
+ "value": 100,
+ "unit": "mg",
+ "_system": {
+ "extension": [
{
- "system": "https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
- "value": "200.000.002.097.952.60"
+ "valueCode": "unknown",
+ "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
- ],
- "status": "completed",
- "medicationReference": {
- "reference": "#b4c2bba5-23bd-4be3-b58f-a70621edd84f",
- "display": "Amoxicillin/Clavulansäure Heumann 875mg/125mg 10St"
+ ]
},
- "subject": {
- "identifier": {
- "system": "http://fhir.de/sid/pkv/kvid-10",
- "value": "X110501499"
+ "_code": {
+ "extension": [
+ {
+ "valueCode": "unknown",
+ "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
- },
- "performer": [
+ ]
+ }
+ },
+ "denominator": {
+ "value": 1,
+ "_system": {
+ "extension": [
{
- "actor": {
- "identifier": {
- "system": "https://gematik.de/fhir/sid/telematik-id",
- "value": "3-2-APO-XanthippeVeilchenblau01"
- }
- }
+ "valueCode": "unknown",
+ "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
- ],
- "whenHandedOver": "2024-02-15",
- "dosageInstruction": [
+ ]
+ },
+ "_code": {
+ "extension": [
{
- "text": "1 Tablette noch in der Nacht, dann für 7 Tage jeweils 1 Tablette morgens und 1 Tablette abends einnehmen"
+ "valueCode": "unknown",
+ "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
}
- ]
+ ]
+ }
+ }
},
- "search": {
- "mode": "match"
+ "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"
}
- ],
- "link": [
- {
- "relation": "self",
- "url": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/MedicationDispense?identifier=200.000.002.097.952.60"
+ },
+ "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"
+ }
+ ]
}
----
NOTE: 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.
@@ -1703,225 +2827,236 @@ Content-Type: application/fhir+json;charset=utf-8
----
{
"resourceType": "Bundle",
- "id": "12653b13-5fca-4e3b-860c-9558bdfef9a1",
+ "id": "erp-versicherte-07-response-getAuditEvent",
"meta": {
- "lastUpdated": "2020-03-29T13:44:18.783+00:00"
+ "lastUpdated": "2025-01-15T16:29:00.434+00:00"
},
"type": "searchset",
- "link": [ {
- "relation": "first",
- "url": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/AuditEvent?_sort=date&_count=50"
- },
- {
- "relation": "next",
- "url": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/AuditEvent?_sort=date&_count=50&_id=gt01eb8522-5695-1830-0000-000000000000"
- },
- {
- "relation": "self",
- "url": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/AuditEvent?_sort=date"
- } ],
- "entry": [ {
- "fullUrl": "https://erp.app.ti-dienste.de/AuditEvent/58862",
- "resource": {
- "resourceType": "AuditEvent",
- "id": "58862",
- "meta": {
- "versionId": "1",
- "lastUpdated": "2020-02-27T08:04:27.434+00:00",
- "source": "#IkMt252YovlsJTAE",
- "profile": [
- "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_AuditEvent|1.3"
- ]
- },
- "text": {
- "status": "generated",
- "div": "Praxis Dr. Müller, Bahnhofstr. 78 hat ein E-Rezept 160.123.456.789.123.58 eingestellt"
- },
- "type": {
- "system": "http://terminology.hl7.org/CodeSystem/audit-event-type",
- "code": "rest"
- },
- "subtype": [ {
- "system": "http://hl7.org/fhir/restful-interaction",
- "code": "create"
- } ],
- "action": "C",
- "recorded": "2020-02-27T08:04:27.434+00:00",
- "outcome": "0",
- "agent": [ {
+ "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": {
- "coding": [ {
- "system": "http://terminology.hl7.org/CodeSystem/extra-security-role-type",
- "code": "humanuser",
- "display": "Human User"
- } ]
+ "system": "http://terminology.hl7.org/CodeSystem/audit-event-type",
+ "code": "rest"
},
- "who": {
- "identifier": {
- "system": "https://gematik.de/fhir/sid/telematik-id",
- "value": "1-1.54.102323123404"
+ "source": {
+ "site": "E-Rezept Fachdienst",
+ "observer": {
+ "reference": "Device/1234"
}
},
- "name": "Praxis Dr. Müller",
- "requestor": false
- }],
- "source": {
- "site": "E-Rezept Fachdienst",
- "observer": {
- "reference": "Device/1234"
- }
- },
- "entity": [ {
- "what": {
- "reference": "https://erp.app.ti-dienste.de/Task/160.123.456.789.123.58",
- "identifier": {
- "use":"official",
- "system":"https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
- "value":"160.123.456.789.123.58"
+ "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*"
}
- },
- "name": "X123456789",
- "description": "*160.123.456.789.123.58*"
- } ]
- },
- "search": {
- "mode": "match"
- }
- }, {
- "fullUrl": "https://erp.app.ti-dienste.de/AuditEvent/58863",
- "resource": {
- "resourceType": "AuditEvent",
- "id": "58863",
- "meta": {
- "versionId": "1",
- "lastUpdated": "2020-02-27T09:04:27.434+00:00",
- "source": "#IkMt252YovlsJTAE",
- "profile": [
- "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_AuditEvent|1.3"
]
},
- "text": {
- "status": "generated",
- "div": "Max Mustermann hat ein E-Rezept 160.123.456.789.123.58 heruntergeladen"
- },
- "type": {
- "system": "http://terminology.hl7.org/CodeSystem/audit-event-type",
- "code": "rest"
- },
- "subtype": [ {
- "system": "http://hl7.org/fhir/restful-interaction",
- "code": "read"
- } ],
- "action": "R",
- "recorded": "2020-02-27T09:04:27.434+00:00",
- "outcome": "0",
- "agent": [ {
+ "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": {
- "coding": [ {
- "system": "http://terminology.hl7.org/CodeSystem/extra-security-role-type",
- "code": "humanuser",
- "display": "Human User"
- } ]
+ "system": "http://terminology.hl7.org/CodeSystem/audit-event-type",
+ "code": "rest"
},
- "who": {
- "identifier": {
- "system": "https://gematik.de/fhir/sid/telematik-id",
- "value": "3-1.54.10123404"
+ "source": {
+ "site": "E-Rezept Fachdienst",
+ "observer": {
+ "reference": "Device/5678"
}
},
- "name": "Ihre Apotheke um die Ecke, Hauptstraße 1",
- "requestor": false
- }],
- "source": {
- "site": "E-Rezept Fachdienst",
- "observer": {
- "reference": "Device/5678"
- }
- },
- "entity": [ {
- "what": {
- "reference": "https://erp.app.ti-dienste.de/Task/160.123.456.789.123.58",
- "identifier": {
- "use":"official",
- "system":"https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
- "value":"160.123.456.789.123.58"
+ "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*"
}
- },
- "name": "X123456789",
- "description": "*160.123.456.789.123.58*"
- } ]
- },
- "search": {
- "mode": "match"
- }
- }, {
- "fullUrl": "https://erp.app.ti-dienste.de/AuditEvent/620049",
- "resource": {
- "resourceType": "AuditEvent",
- "id": "620049",
- "meta": {
- "versionId": "1",
- "lastUpdated": "2020-02-27T10:04:27.434+00:00",
- "source": "#IkMt252YovlsJTAE",
- "profile": [
- "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_AuditEvent|1.3"
]
},
- "text": {
- "status": "generated",
- "div": "Ihre Apotheke um die Ecke, Hauptstraße 1 hat ein E-Rezept 160.123.456.789.123.58 beliefert"
- },
- "type": {
- "system": "http://terminology.hl7.org/CodeSystem/audit-event-type",
- "code": "rest"
- },
- "subtype": [ {
- "system": "http://hl7.org/fhir/restful-interaction",
- "code": "update"
- } ],
- "action": "U",
- "recorded": "2020-02-27T10:04:27.434+00:00",
- "outcome": "0",
- "agent": [ {
+ "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": {
- "coding": [ {
- "system": "http://terminology.hl7.org/CodeSystem/extra-security-role-type",
- "code": "humanuser",
- "display": "Human User"
- } ]
+ "system": "http://terminology.hl7.org/CodeSystem/audit-event-type",
+ "code": "rest"
},
- "who": {
- "identifier": {
- "system": "https://gematik.de/fhir/sid/telematik-id",
- "value": "3-1.54.10123404"
+ "source": {
+ "site": "E-Rezept Fachdienst",
+ "observer": {
+ "reference": "Device/1234"
}
},
- "name": "Ihre Apotheke um die Ecke, Hauptstraße 1",
- "requestor": false
- }],
- "source": {
- "site": "E-Rezept Fachdienst",
- "observer": {
- "reference": "Device/1234"
- }
- },
- "entity": [ {
- "what": {
- "reference": "https://erp.app.ti-dienste.de/Task/160.123.456.789.123.58",
- "identifier": {
- "use":"official",
- "system":"https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId",
- "value":"160.123.456.789.123.58"
+ "subtype": [
+ {
+ "code": "update",
+ "system": "http://hl7.org/fhir/restful-interaction"
}
- },
- "name": "X123456789",
- "description": "*160.123.456.789.123.58*"
- } ]
- },
- "search": {
- "mode": "match"
+ ],
+ "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"
+ }
}
- } ]
+ ]
}
----
NOTE: 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.
@@ -1931,7 +3066,7 @@ NOTE: Für eine komfortable Darstellung vieler Protokolleinträge und zur Redukt
NOTE: Die Darstellung eines Protokolleintrags erfolgt als `AuditEvent`
NOTE: Unter `"div": "Praxis Dr. Müller,
- Bahnhofstr. 78 hat ein E-Rezept 160.123.456.789.123.58 eingestellt"` wird eine lesbare Darstellung in HTML-Format bereitgestellt.
+ Bahnhofstr. 78 hat ein E-Rezept 160.000.000.000.000.01 eingestellt"` wird eine lesbare Darstellung in HTML-Format bereitgestellt.
NOTE: Der Versichertenbezug wird über die Versichertennummer des jeweils gelesenen/eingestellten/gelöschten E-Rezept in `"name": "X123456789"` oder auch MedicationDispense hergestellt.
diff --git a/docs/erp_versicherte_mvo.adoc b/docs/erp_versicherte_mvo.adoc
index 391205e4..1cf28e4e 100644
--- a/docs/erp_versicherte_mvo.adoc
+++ b/docs/erp_versicherte_mvo.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Zielgruppe: image:{FdV}[]
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.
diff --git a/docs/erp_versionsuebergang.adoc b/docs/erp_versionsuebergang.adoc
index edb79ca7..6321c917 100644
--- a/docs/erp_versionsuebergang.adoc
+++ b/docs/erp_versionsuebergang.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
WARNING: DISCLAIMER: Dieses Dokument ist ein Template für folgende Übergangszeiträume und hat aktuell keine Gültigkeit. Die Daten sind veraltet und dienen nur zur Veranschaulichung.
Auf dieser Seite sind relevante Informationen zum Verhalten des Fachdienstes während und nach der Übergangszeit aufgeführt. Dieser Übergangszeitraum wird nach der https://update.kbv.de/ita-update/DigitaleMuster/ERP/III_2023/KBV_ITA_VGEX_Technische_Anlage_ERP.pdf[Technischen Anlage der KBV] (KP36-04) *6 Monate* betragen. Gilt also somit vom 01.07.2023 bis 31.12.2023.
diff --git a/docs/misc_api_endpoints.adoc b/docs/misc_api_endpoints.adoc
index b8968875..923ef304 100644
--- a/docs/misc_api_endpoints.adoc
+++ b/docs/misc_api_endpoints.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Zielgruppe: image:{PVS}[] image:{AVS}[] image:{FdV}[]
Auf dieser Seite werden generische Endpunkte des E-Rezept-Fachdienst beschrieben. Die Endpunkte sind in der Regel für alle Anbieter gleich und werden in der Regel nicht individuell konfiguriert.
@@ -43,196 +47,181 @@ NOTE: Die Base64-Darstellung des ACCESS_TOKEN im `Authorization`-Header ist sta
*Response*
[source,xml]
----
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/pkv_ik_numbers.adoc b/docs/pkv_ik_numbers.adoc
index a3f15ccc..17a87bd6 100644
--- a/docs/pkv_ik_numbers.adoc
+++ b/docs/pkv_ik_numbers.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Zielgruppe: image:{PVS}[]
Die PKV-IK-Liste ist als CSV- und FHIR-Datei und unter folgendem Link öffentlich einsehbar:
diff --git a/docs/ti_configuration.adoc b/docs/ti_configuration.adoc
index 553aa1bf..199be405 100644
--- a/docs/ti_configuration.adoc
+++ b/docs/ti_configuration.adoc
@@ -16,6 +16,10 @@
:eRp: https://img.shields.io/badge/eRp--FD-blue
:KTR: https://img.shields.io/badge/KTR-AE8E1C
+// Variables for the Examples that are to be used
+:branch: main
+:date-folder: 2025-01-15
+
Zielgruppe: image:{PVS}[] image:{AVS}[]
Hier gibt die gematik eine Hilfestellung zur Konfiguration des lokalen Netzwerkes der Leistungserbringerumgebung.
diff --git a/docs_sources/authentisieren-source.adoc b/docs_sources/authentisieren-source.adoc
index 7f099072..1cd92c37 100644
--- a/docs_sources/authentisieren-source.adoc
+++ b/docs_sources/authentisieren-source.adoc
@@ -133,7 +133,7 @@ SOAPAction: "http://ws.gematik.de/conn/CertificateService/v7.4#ReadCardCertifica
|Payload |
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/authentisieren/01_request_ReadCardCertificate.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/authentisieren/01_request_ReadCardCertificate.xml[]
----
NOTE: In `C.AUT ` wird angegeben, dass das Zertifikat zur Authentisierung gegenüber dem IDP aus der SMC-B ausgelesen werden soll.
|===
@@ -144,7 +144,7 @@ NOTE: In `C.AUT ` wird angegeben, dass das Zertifikat
HTTP/1.1 200 OK
Content-Type: text/xml;charset=utf-8
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/authentisieren/02_response_ReadCardCertificate.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/authentisieren/02_response_ReadCardCertificate.xml[]
----
NOTE: Der Konnektor liefert das Zertifikat in `` zurück, wie es auf der Karte gespeichert ist, ASN.1 DER codiert in Base64-Darstellung.
@@ -183,7 +183,7 @@ IMPORTANT: Die Länge des Soap-Requests, muss entsprechend im Header mit der Eig
|Payload |
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/authentisieren/03_request_VerifyCertificate.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/authentisieren/03_request_VerifyCertificate.xml[]
----
NOTE: Das zu prüfende Zertifikat in Base64-DER-Codierung ist mit `` wird das Prüfergebnis des Zertifikats [VALID = gültig, INCONCLUSIVE = offline-gültig ohne Sperrstatus, INVALID = ungültig] angegeben
@@ -224,7 +224,7 @@ SOAPAction: "http://ws.gematik.de/conn/SignatureService/v7.4#ExternalAuthenticat
|Payload |
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/authentisieren/05_request_ExternalAuthenticate.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/authentisieren/05_request_ExternalAuthenticate.xml[]
----
NOTE: Entsprechend der Mandantenkonfiguration wird in `` bezieht sich auf die Übergabe des Medikaments, wann es dem Überbringer des E-Rezepts ausgehändigt wurde.
-NOTE: Die Codierung der Einnahmehinweise in `` erfolgt z.B. in Textform [morgens-mittags-abends-nachts] in boolescher Notation 1=ja, 0=nein
+NOTE: Die Codierung der Einnahmehinweise in `` erfolgt in Textform [morgens-mittags-abends-nachts] in boolescher Notation 1=ja, 0=nein
|===
-Es können auch mehrere MedicationDispenses für eine $dispense-Operation übergeben werden. Die MedicationDispenses werden in einem "collection"-Bundle verschickt.
+Für die Übertragung der Abgabeinformationen wird als Transportmedium die FHIR-Parameters Ressource genutzt. Darüber können auch mehrere Abgaben erfolgen. Hierzu werden weitere `rxDispensation`-Parameter angegeben.
.Beispiel für eine mehrfache Abgabe (Klicken zum Ausklappen)
[%collapsible]
@@ -326,26 +326,19 @@ Es können auch mehrere MedicationDispenses für eine $dispense-Operation überg
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_abrufen/07_request_taskCloseMultiple.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_abrufen/07_request_taskCloseMultiple.xml[]
----
====
*Response*
-[source,xml]
-----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_abrufen/08_response_taskDispense.xml[]
-----
-
[cols="a,a"]
[%autowidth]
|===
s|Code s|Type Success
-|200 | OK +
-[small]#Die Anfrage wurde erfolgreich bearbeitet. Die angeforderte Ressource wurde vor dem Senden der Antwort erstellt. Das "Location"-Header-Feld enthält die Adresse der erstellten Ressource.#
-|201 | OK +
-[small]#Neues Objekt wurde erfolgreich angelegt, in der Rückgabe ist das Objekt enthalten.#
+|204 | No Content +
+[small]#Die Anfrage wurde erfolgreich bearbeitet. Die Abgabeinformationen wurden erfolgreich im Fachdienst eingestellt#
s|Code s|Type Warning
|253 |Die ID einer Ressource und die ID ihrer zugehörigen fullUrl stimmen nicht überein. +
[small]#*Hinweis: Es ist vorgesehen, dass zu einem späteren Zeitpunkt die fehlerhafte Validierung einer Ressource-ID zu einem Fehler statt zu einer Warnung führt.*#
@@ -386,13 +379,15 @@ NOTE: Die maximale Dateigröße für die Kommunikation am E-Rezept-Fachdienst be
NOTE: Wenn mit der $dispense-Operation die Abgabendaten bereits erstellt wurden, kann die $close-Operation ohne Request Body durchgeführt werden.
+NOTE: Hinweise zur Erstellung der Abgabeinformationen ab Profilversion 1.4 finden sich auf der Seite xref:../docs/erp_abrufen_dispense.adoc[Angabe von Dosierinformationen].
+
WARNING: Wenn die $close-Operation aufgerufen wird und kein Request Body vorhanden ist, und die Abgabendaten nicht vorher mit einer $dispense-Operation erstellt wurden, kommt eine Fehlermeldung mit HttpStatus 403 und einem OperationOutcome mit der Meldung "Abschluss des Workflows konnte nicht durchgeführt werden. Dispensierinformationen wurden nicht bereitgestellt." zurück.
*Request*
[cols="h,a", separator=¦]
[%autowidth]
|===
-¦URI ¦https://erp.zentral.erp.splitdns.ti-dienste.de/Task/160.123.456.789.123.58/$close?secret=c36ca26502892b371d252c99b496e31505ff449aca9bc69e231c58148f6233cf +
+¦URI ¦https://erp.zentral.erp.splitdns.ti-dienste.de/Task/160.000.000.000.000.01/$close?secret=c36ca26502892b371d252c99b496e31505ff449aca9bc69e231c58148f6233cf +
Zum Nachweis als berechtigte Apotheke, die das E-Rezept gerade in Bearbeitung hält, muss im URL-Parameter `secret` das beim Abrufen generierte Secret übergeben werden.
¦Method ¦POST
¦Requester ¦image:{AVS}[]
@@ -406,12 +401,10 @@ NOTE: Mit dem ACCESS_TOKEN im `Authorization`-Header weist sich der Zugreifende
NOTE: Im http-Header des äußeren http-Requests an die VAU (POST /VAU) sind die Header `X-erp-user: l` und `X-erp-resource: Task` zu setzen.
-NOTE: In den Profilen ist unter meta.profile auch die Version mit anzugeben. (Bsp.: "https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_MedicationDispense|*1.2*")
-
¦Payload ¦
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_abrufen/06_request_taskClose.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_abrufen/06_request_taskClose.xml[]
----
NOTE: Mit der Übergabe der MedicationDispense signalisiert der Apotheker den Abschluss des E-Rezept-Workflows. Der Versicherte erhält Informationen über das abgegebene Medikament.
@@ -422,9 +415,7 @@ NOTE: Die Codierung der Einnahmehinweise in `` erfolgt z.B. i
|===
-Es können auch mehrere MedicationDispenses für eine $close-Operation übergeben werden. Die MedicationDispenses werden in einem "collection"-Bundle verschickt.
-
-WARNING: Der E-Rezept-Fachdienst hat ein Datenlimit von 100kb pro Request. Falls eine Verordnung sehr viele Abgaben enthält ist darauf zu achten, dass nur ein Medication Objekt je Charge übermittelt wird, damit die Datenmenge nicht zu groß wird.
+Für die Übertragung der Abgabeinformationen wird als Transportmedium die FHIR-Parameters Ressource genutzt. Darüber können auch mehrere Abgaben erfolgen. Hierzu werden weitere `rxDispensation`-Parameter angegeben.
.Beispiel für eine mehrfache Abgabe (Klicken zum Ausklappen)
[%collapsible]
@@ -433,7 +424,7 @@ WARNING: Der E-Rezept-Fachdienst hat ein Datenlimit von 100kb pro Request. Falls
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_abrufen/07_request_taskCloseMultiple.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_abrufen/07_request_taskCloseMultiple.xml[]
----
====
@@ -446,7 +437,7 @@ Content-Type: application/fhir+xml;charset=utf-8
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_abrufen/09_response_taskClose.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_abrufen/09_response_taskClose.xml[]
----
NOTE: Im Ergebnis der Operation wird ein signiertes Bundle als Nachweis des ordnungsgemäßen Durchlaufs des E-Rezept-Workflows zurückgegeben.
@@ -544,7 +535,7 @@ Der Aufruf erfolgt als http-POST-Operation mit der FHIR-Operation `$reject`. Im
[cols="h,a"]
[%autowidth]
|===
-|URI |https://erp.zentral.erp.splitdns.ti-dienste.de/Task/160.123.456.789.123.58/$reject?secret=c36ca26502892b371d252c99b496e31505ff449aca9bc69e231c58148f6233cf +
+|URI |https://erp.zentral.erp.splitdns.ti-dienste.de/Task/160.000.000.000.000.01/$reject?secret=c36ca26502892b371d252c99b496e31505ff449aca9bc69e231c58148f6233cf +
Zum Nachweis als berechtigte Apotheke, die das E-Rezept gerade in Bearbeitung hält, muss im URL-Parameter `secret` das beim Abrufen generierte Secret übergeben werden
|Method |POST
|Requester |image:{AVS}[]
@@ -605,7 +596,7 @@ Der Aufruf erfolgt als http-POST-Operation mit der FHIR-Operation `$abort`. Im h
[cols="h,a"]
[%autowidth]
|===
-|URI |https://erp.zentral.erp.splitdns.ti-dienste.de/Task/160.123.456.789.123.58/$abort?secret=c36ca26502892b371d252c99b496e31505ff449aca9bc69e231c58148f6233cf +
+|URI |https://erp.zentral.erp.splitdns.ti-dienste.de/Task/160.000.000.000.000.01/$abort?secret=c36ca26502892b371d252c99b496e31505ff449aca9bc69e231c58148f6233cf +
Zum Nachweis als berechtigte Apotheke, die das E-Rezept gerade in Bearbeitung hält, muss im URL-Parameter `secret` das beim Abrufen generierte Secret übergeben werden
|Method |POST
|Requester |image:{AVS}[]
@@ -666,7 +657,7 @@ Als Apotheker kann es erforderlich sein, die Quittung für ein beliefertes E-Rez
[cols="h,a"]
[%autowidth]
|===
-|URI | https://erp.zentral.erp.splitdns.ti-dienste.de/Task/160.123.456.789.123.58?secret=c36ca26502892b371d252c99b496e31505ff449aca9bc69e231c58148f6233cf
+|URI | https://erp.zentral.erp.splitdns.ti-dienste.de/Task/160.000.000.000.000.01?secret=c36ca26502892b371d252c99b496e31505ff449aca9bc69e231c58148f6233cf
Zum Nachweis als berechtigte Apotheke, die das E-Rezept verarbeitet hat(te), muss im URL-Parameter `secret` das beim Abrufen generierte Secret übergeben werden
|Method |GET
@@ -688,7 +679,7 @@ NOTE: Im http-Header des äußeren http-Requests an die VAU (POST /VAU) sind die
----
HTTP/1.1 200 OK
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_abrufen/10_response_taskGet.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_abrufen/10_response_taskGet.xml[]
----
In `
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+----
+
+====
+
+== Angabe von Wirkstoff, Wirkstärke und Handelsname
+
+AVS müssen bei der Abgabe von **Fertigarneimitteln** Wirkstoff, Wirkstärke und Handelsname in der `MedicationDispense` angeben, sofern die Daten in der zugrundeliegenden Arzneimitteldatenbank vorhanden sind.
+Für **Rezepturen** müssen die Angaben zu Wirkstoff und Wirkstärke angegeben werden, wenn diese Information strukturiert im Verordnungsdatensatz vorliegen. Entsprechende Vorgaben sind in gemILF_PS_eRp zu finden.
+
+Hier ist ein Beispiel, wie eine FHIR-Ressource Medication für ein Fertigarzneimittel aussehen könnte:
+
+.**Beispiel für Angabe von Wirkstoff, Wirkstärke und Handelsname bei Fertigarzneimitteln** (Klicken zum Ausklappen)
+[%collapsible]
+
+====
+
+[source,xml]
+----
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+----
+
+====
+
+== Profilversion der Abgabeinformationen
+
+Das Datenmodell für die Abgabe bei den Operationen $dispense und $close sieht vor, dass eine Parameters Ressource mit 1..* `.parameter[rxDispensation]` übergeben werden kann. Nach Datenmodell muss die Profilversion aller enthaltenen Ressourcen (MedicationDispense und Medication) die *gleiche* Profilversion tragen.
+Die Gültigkeit der Profilversion wird nach dem jüngsten Datum aller MedicationDispense.whenHandedOver (max(.whenHandedOver)) bestimmt.
+
+=== Beispiel für die Bestimmung der Profilversion
+
+Angenommen es gilt folgende Konfiguration der Gültigkeit der Profilversion des Workflow Package im E-Rezept-Fachdienst:
+
+image:parameters-max-whenhandedover-gültigkeiten.png[]
+
+So wird am Ende des Profilübergangs 1.3 zu 1.4 am 15.04. folgendes Verhalten erwartet:
+
+1. Ein AVS beliefert den ersten Teil der Verordnung am 10.04.
+** Es gibt eine MedicationDispense mit .whenHandedOver = 2025-04-10
+** Das AVS erstellt die Abgabeinformationen mit Profilversion 1.2, 1.3 oder 1.4
+2. Das AVS beliefert den restlichen Teil der Verordnung am 22.04.
+** Um die Belieferung abzuschließen, erstellt das AVS eine Parameters Ressource mit
+** MedicationDispense_1.whenHandedOver = 2025-04-10
+** MedicationDispense_2.whenHandedOver = 2025-04-22
+** Das AVS erstellt die Abgabeinformationen mit Profilversion 1.4
+
+image:parameters-max-whenhandedover.png[]
+
+Die zu verwendende Profilversion richtet sich nach dem jüngsten Datum aller MedicationDispense.whenHandedOver (max(.whenHandedOver)), also 2025-04-22, damit ist die Profilversion 1.4 für alle Ressourcen der Abgabeinformationen zu verwenden.
diff --git a/docs_sources/erp_abrufen_egk-source.adoc b/docs_sources/erp_abrufen_egk-source.adoc
index f0cf40dc..49e8903c 100644
--- a/docs_sources/erp_abrufen_egk-source.adoc
+++ b/docs_sources/erp_abrufen_egk-source.adoc
@@ -39,7 +39,7 @@ SOAPAction: "http://ws.gematik.de/conn/EventService/v7.2#GetCards"
|Payload |
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_abrufen_egk/01_GetCards.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_abrufen_egk/01_GetCards.xml[]
----
NOTE: `Terminal1 ` hier wird das Kartenterminal am jeweiligen Handverkaufstisch benannt, wie es in der Mandanten- und Arbeitsplatzkonfiguration im Konnektor und AVS konfiguriert ist.
@@ -49,7 +49,7 @@ NOTE: `Terminal1 ` hier wird das Kartenterminal am j
*Response*
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_abrufen_egk/02_GetCards_Response.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_abrufen_egk/02_GetCards_Response.xml[]
----
NOTE: Mit dem gemeldeten `a5567061-f3b0-436b-b702-fbb5026aa168 ` wird die eGK zum Auslesen der Versichertenstammdaten adressiert.
@@ -75,7 +75,7 @@ SOAPAction: "http://ws.gematik.de/conn/vsds/VSDService/v6.0#ReadVSD"
|Payload |
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_abrufen_egk/03_ReadVSD.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_abrufen_egk/03_ReadVSD.xml[]
----
NOTE: Das `` benennt die Gesundheitskarte, von welcher die VSD gelesen werden sollen.
@@ -88,7 +88,7 @@ dass zwingend eine Online-Prüfung durchgeführt und im Anschluss ein Prüfungsn
*Response*
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_abrufen_egk/04_ReadVSD_Response.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_abrufen_egk/04_ReadVSD_Response.xml[]
----
CAUTION: Liefert die ` ` einen `1 ` *(ungleich 0)*, konnte der Stammdatenabgleich nicht erfolgreich beendet werden. Bei dieser Rückmeldung kann durch einen erneuten Aufruf von ReadVSD versucht werden, das Problem zu beheben. Falls es dann nicht klappt, muss der Anwendungsfall abgebrochen werden
@@ -159,7 +159,7 @@ NOTE: Im http-Header des äußeren http-Requests an die VAU (POST /VAU) sind die
*Response*
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_abrufen_egk/05_Response_Task.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_abrufen_egk/05_Response_Task.xml[]
----
NOTE: Alle gelieferten Tasks haben den Status `urn:ietf:rfc:5652 ` auf den RFC-5652 erfolgt die Erzeugung der nonQES als CMS-Signatur (CAdES).
@@ -89,7 +89,7 @@ NOTE: In `` erfolgt d
*Response*
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_alternative_zuweisung/02_sign_avs_response.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_alternative_zuweisung/02_sign_avs_response.xml[]
----
NOTE: Das Ergebnis der erfolgreichen nonQES wird Base64-codiert in `` zurückgegeben. Darin enthalten ist eine PKCS#7-Datei in HEX-Codierung, die mit einem ASN1-Decoder angesehen werden kann.
@@ -163,7 +163,7 @@ Das APOVZD stellt jedes Zertifikat in einer eigenen FHIR-Binary-Ressource bereit
Beispiel eines solchen Binaries:
[[apovzd-cert-binary]]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_alternative_zuweisung/03_certificate_in_apovzd.json[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_alternative_zuweisung/03_certificate_in_apovzd.json[]
----
Das Synchronisieren vom Upload-Container in das APOVZD erfolgt täglich zwischen 0 und 6 Uhr. Spätestens ab 6 Uhr ist die Änderung für das E-Rezept-FdV verfügbar.
@@ -181,7 +181,7 @@ Dem E-Rezept-FdV werden über das APOVZD die URLs innerhalb der LocationRessourc
Beispiel:
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_alternative_zuweisung/04_url_in_apovzd.json[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_alternative_zuweisung/04_url_in_apovzd.json[]
----
Um aus dem E-Rezept-FdV nach Apotheken zu filtern, die dieses Feature unterstützen, wird ein zusätzlicher Type DELEGATOR aus dem Codesystem http://terminology.hl7.org/CodeSystem/v3-RoleCode eingeführt.
@@ -217,7 +217,7 @@ Als Versicherter möchte ich mein Rezept an die Apotheke meiner Wahl übermittel
Der folgende Datensatz wird erstellt:
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_alternative_zuweisung/05_message_from_fdv.json[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_alternative_zuweisung/05_message_from_fdv.json[]
----
=== Verschlüsselung des Datensatzes
@@ -243,7 +243,7 @@ Diese ASN.1-Struktur muss Base64-DER codiert im Aufruf der Verschlüsselungsoper
Das folgende beispielhafte Kommando verschlüsselt einen Datensatz für ein ENC-Zertifikat inkl. Einbettung der unsafe-Attribute (kotlin-Code).
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_alternative_zuweisung/06_example_encryption.java[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_alternative_zuweisung/06_example_encryption.java[]
----
Der erhaltene CMS-Datensatz enthält unter der genannten OID die Entschlüsselungsinformationen für den Empfänger:
@@ -263,13 +263,13 @@ Wenn das FdV eine mit dem Zertifikat der SMB-C verschlüsselte Nachricht an den
=== Entschlüsselung der Nachricht
Der übermittelte CMS-Datensatz enthält die notwendigen Informationen zur Lokalisierung der für die Entschlüsselung zu nutzende SMC-B. Der Datensatz kann mit der Operation `DecryptDocument` des Konnektors entschlüsselt werden.
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_alternative_zuweisung/07_decrypt_request.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_alternative_zuweisung/07_decrypt_request.xml[]
----
Der entschlüsselte Datensatz enthält folgende Informationen:
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_alternative_zuweisung/05_message_from_fdv.json[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_alternative_zuweisung/05_message_from_fdv.json[]
----
NOTE: "transactionID" beinhaltet die von der E-Rezept-App erzeuge UUID zur eindeutigen Identifikation der Transaktion.
diff --git a/docs_sources/erp_bereitstellen-source.adoc b/docs_sources/erp_bereitstellen-source.adoc
index e2769160..54806b20 100644
--- a/docs_sources/erp_bereitstellen-source.adoc
+++ b/docs_sources/erp_bereitstellen-source.adoc
@@ -98,7 +98,7 @@ NOTE: Der Parameter `urn:ietf:rfc:5652 ` auf den RFC-5652 erfolgt die Erzeugung der QES als CMS-Signatur (CAdES).
@@ -207,7 +207,7 @@ IMPORTANT: Der Parameter `IncludeRevocationInfo = true` ist von herausragender B
HTTP/1.1 200 OK
Content-Type: text/xml;charset=utf-8
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_bereitstellen/04_response_SignDocument.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_bereitstellen/04_response_SignDocument.xml[]
----
NOTE: Das Ergebnis der erfolgreichen qualifizierten Signatur wird Base64-codiert in `` zurückgegeben. Darin enthalten ist eine PKCS#7-Datei in HEX-Codierung, die mit einem ASN1-Decoder angesehen werden kann.
@@ -234,7 +234,7 @@ Der E-Rezept-Fachdienst aktualisiert bei gültiger QES den Task und erzeugt eine
[cols="h,a"]
[%autowidth]
|===
-|URI |https://erp.zentral.erp.splitdns.ti-dienste.de/Task/160.123.456.789.123.58/$activate
+|URI |https://erp.zentral.erp.splitdns.ti-dienste.de/Task/160.000.000.000.000.01/$activate
|Method |POST
|Requester |image:{PVS}[]
|Responder |image:{eRp}[]
@@ -272,7 +272,7 @@ NOTE: Bei dem Wert in `` zurückgegeben. Darin enthalten ist eine PKCS#7-Datei in HEX-Codierung, die mit einem ASN1-Decoder angesehen werden kann.
@@ -116,7 +116,7 @@ NOTE: In den Profilen ist unter meta.profile auch die Version mit anzugeben. (Bs
¦Payload ¦
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_chargeItem/03_POST_ChargeItem_Request.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_chargeItem/03_POST_ChargeItem_Request.xml[]
----
NOTE: Der PKV-Abgabesatz in Binary.data ist aus Platzgründen stark gekürzt.
@@ -140,7 +140,7 @@ Content-Type: application/fhir+xml;charset=utf-8
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_chargeItem/04_POST_ChargeItem_Response.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_chargeItem/04_POST_ChargeItem_Response.xml[]
----
|===
@@ -212,7 +212,7 @@ NOTE: Mit dem ACCESS_TOKEN im `Authorization`-Header weist sich der Zugreifende
¦Payload ¦
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_chargeItem/05_GET_ChargeItem_Response.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_chargeItem/05_GET_ChargeItem_Response.xml[]
----
NOTE: Aus Gründen der besseren Lesbarkeit ist das PKV-Abgabdedatenbundle hier nicht vollständig dargestellt und wurde mit `...` abgekürzt. Es kann aber vollständig unter https://simplifier.net/erezept-patientenrechnung/~resources?category=Example&exampletype=Bundle eingesehen werden.
@@ -272,7 +272,7 @@ NOTE: In den Profilen ist unter meta.profile auch die Version mit anzugeben. (Bs
¦Payload ¦
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_chargeItem/06_PUT_ChargeItem_Request.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_chargeItem/06_PUT_ChargeItem_Request.xml[]
----
NOTE: In `` als Absender der Nachricht.
+
+[cols="a,a"]
+[%autowidth]
+|===
+s|Code s|Type Success
+|201 | Created +
+[small]#Die Anfrage wurde erfolgreich bearbeitet. Die angeforderte Ressource wurde vor dem Senden der Antwort erstellt.#
+s|Code s|Type Warning
+|253 |Die ID einer Ressource und die ID ihrer zugehörigen fullUrl stimmen nicht überein. +
+ [small]#*Hinweis: Es ist vorgesehen, dass zu einem späteren Zeitpunkt die fehlerhafte Validierung einer Ressource-ID zu einem Fehler statt zu einer Warnung führt.*#
+|254 |Format der fullUrl ist ungültig. +
+ [small]#*Hinweis: Es ist vorgesehen, dass zu einem späteren Zeitpunkt das ungültige Format der fullUrl zu einem Fehler anstatt einem Warning führt.*#
+s|Code s|Type Error
+|400 | Bad Request +
+[small]#Die Anfrage-Nachricht war fehlerhaft aufgebaut.# +
+[small]#Die Antwort "Referenced Task does not contain a KVNR" weist darauf hin, dass der Task ggf. gelöscht wurde.#
+|401 |Unauthorized +
+[small]#Die Anfrage kann nicht ohne gültige Authentifizierung durchgeführt werden. Wie die Authentifizierung durchgeführt werden soll, wird im "WWW-Authenticate"-Header-Feld der Antwort übermittelt.#
+|403 |Forbidden +
+[small]#Die Anfrage wurde mangels Berechtigung des Clients nicht durchgeführt, bspw. weil der authentifizierte Benutzer nicht berechtigt ist.#
+|405 |Method Not Allowed +
+[small]#Die Anfrage darf nur mit anderen HTTP-Methoden (zum Beispiel GET statt POST) gestellt werden. Gültige Methoden für die betreffende Ressource werden im "Allow"-Header-Feld der Antwort übermittelt.#
+|408 |Request Timeout +
+[small]#Innerhalb der vom Server erlaubten Zeitspanne wurde keine vollständige Anfrage des Clients empfangen.#
+|429 |Too Many Requests +
+[small]#Der Client hat zu viele Anfragen in einem bestimmten Zeitraum gesendet.#
+|500 |Server Errors +
+[small]#Unerwarteter Serverfehler#
|===
\ No newline at end of file
diff --git a/docs_sources/erp_eml-epa-notes-source.adoc b/docs_sources/erp_eml-epa-notes-source.adoc
index af4b60ef..05028da0 100644
--- a/docs_sources/erp_eml-epa-notes-source.adoc
+++ b/docs_sources/erp_eml-epa-notes-source.adoc
@@ -32,7 +32,7 @@ Im folgenden ein Beispiel für die Übermittlung eines Abgabedatensatzes mit den
====
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_eml-epa-notes/01_Parameters-ExampleCloseInputParameters.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_eml-epa-notes/01_Parameters-ExampleCloseInputParameters.xml[]
----
====
@@ -46,7 +46,7 @@ image:parameters-schematics-multiple.png[width=50%]
//TODO: Change to real example from Examples Repository
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_eml-epa-notes/02_Parameters-ExampleDispenseInputParametersMultipleMedicationDispenses.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_eml-epa-notes/02_Parameters-ExampleDispenseInputParametersMultipleMedicationDispenses.xml[]
----
====
@@ -101,7 +101,7 @@ image:medication-rezeptur-schematics.png[width=50%]
====
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_eml-epa-notes/03_Medication-Medication-Rezeptur.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_eml-epa-notes/03_Medication-Medication-Rezeptur.xml[]
----
====
@@ -115,7 +115,7 @@ Das Erzeugen von Kombipackungen geschieht analog zur Rezeptur. Statt der Ingredi
====
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_eml-epa-notes/04_Medication-Medication-Kombipackung.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_eml-epa-notes/04_Medication-Medication-Kombipackung.xml[]
----
====
diff --git a/docs_sources/erp_fhir_infos-source.adoc b/docs_sources/erp_fhir_infos-source.adoc
index f8da5425..6bcfcd7c 100644
--- a/docs_sources/erp_fhir_infos-source.adoc
+++ b/docs_sources/erp_fhir_infos-source.adoc
@@ -38,6 +38,7 @@ Durchgängige Beispieldatensätze von der Verordnung und qualifizierter Signatur
=== Referenzierung von FHIR-Objekten in Bundles
Der FHIR-Standard definiert wie Ressourcen in einem Bundle referenziert werden sollen. Siehe hierzu link:https://hl7.org/fhir/R4/references.html[Referezen] und link:http://hl7.org/fhir/R4/bundle.html[Bundles].
+==== Übereinstimmung von id und fullUrl
Bei Verwendung von relativer Referenzierung in Bundles muss darauf geachtet werden, dass die id der fullUrl der Ressource mit der id der Ressource übereinstimmt.
Beispielsweise ist folgende Konstellation ungültig, da der hintere Teil der fullUrl nicht mit der Ressourcen-ID übereinstimmt (b54dd6cad655 ≠ 000000000000):
@@ -50,6 +51,110 @@ Beispielsweise ist folgende Konstellation ungültig, da der hintere Teil der ful
+
+
+
+ ...
+
+
+----
+
+Folgend ein korrigiertes Beispiel:
+
+[source,xml]
+----
+
+
+ ...
+
+
+----
+
+Alternativ ein korrektes Beispiel für relative Referenzierung:
+
+[source,xml]
+----
+
+
+ ...
+
+
+----
+
+
+Die Referenz "Patient/123" kann nicht aufgelöst werden, da die Umgebende Composition-Ressource keine fullUrl besitzt, die eine base-URL enthält, wonach aufgelöst werden kann.
+
+==== Format von fullURLs
+fullURLs müssen entweder als URL-Schema oder als URN-Schema angegeben werden. Wenn das URL-Schema verwendet wird, muss dieses nach dem link:https://hl7.org/fhir/R4/references.html#regex[Regex für FHIR-URLs] aufgebaut sein. Folgende Hinweise sind zu beachten:
+
+* URLs haben das Format "http(s):////".
+* URNs haben das Format "urn:uuid:".
+
+Folgendes Beispiel zeigt eine **ungültige** URL-Referenz:
+
+[source,xml]
+----
+
+
+
+ ...
+
+----
+
+Beispiel für korrekte Angabe der .id:
+
+[source,xml]
+----
+
+
+
+ ...
+
+----
+
== Tools und Hinweise zu FHIR
diff --git a/docs_sources/erp_notification_avs-source.adoc b/docs_sources/erp_notification_avs-source.adoc
index fa202463..73a75f8f 100644
--- a/docs_sources/erp_notification_avs-source.adoc
+++ b/docs_sources/erp_notification_avs-source.adoc
@@ -42,7 +42,7 @@ Authorization: Bearer eyJraWQ.ewogImL2pA10Qql22ddtutrvx4FsDlz.rHQjEmB1lLmpqn9J
Content-Type: application/fhir+xml; charset=UTF-8
Accept: application/fhir+xml; charset=utf-8
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_notification_avs/01_request_PostSubscriptionPseudo.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_notification_avs/01_request_PostSubscriptionPseudo.xml[]
----
NOTE: Im http-Header des äußeren http-Requests an die VAU (POST /VAU) sind die Header `X-erp-user: l` und `X-erp-resource: Subscription` zu setzen.
@@ -59,7 +59,7 @@ HTTP/1.1 200 OK
Content-Length: 510
Content-Type: application/fhir+xml;charset=utf-8
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_notification_avs/02_response_PostSubscriptionPseudo.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_notification_avs/02_response_PostSubscriptionPseudo.xml[]
----
NOTE: In ` ` wird deprecated und steht a
[cols="h,a",separator=¦]
[%autowidth]
|===
-¦URI ¦https://erp.app.ti-dienste.de/MedicationDispense?identifier=https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId|160.880.966.157.248.22
+¦URI ¦https://erp.app.ti-dienste.de/MedicationDispense?identifier=https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId|160.000.000.000.000.01®
¦Method ¦GET
|Requester |image:{FdV}[]
|Responder |image:{eRp}[]
@@ -383,7 +397,7 @@ Content-Type: application/fhir+json;charset=utf-8
[source,json]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_versicherte/05_response_get-single-medicationdispense-by-id.json[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_versicherte/05_response_get-single-medicationdispense-by-id.json[]
----
NOTE: 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.
@@ -444,7 +458,7 @@ Content-Type: application/fhir+json;charset=utf-8
[source,json]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_versicherte/06_response_get-multiple-medication-dispense.json[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_versicherte/06_response_get-multiple-medication-dispense.json[]
----
NOTE: 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.
@@ -571,7 +585,7 @@ Content-Type: application/fhir+json;charset=utf-8
[source,json]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/erp_versicherte/07_response_getAuditEvent.json[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/erp_versicherte/07_response_getAuditEvent.json[]
----
NOTE: 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.
@@ -580,7 +594,7 @@ NOTE: Für eine komfortable Darstellung vieler Protokolleinträge und zur Redukt
NOTE: Die Darstellung eines Protokolleintrags erfolgt als `AuditEvent`
NOTE: Unter `"div": "Praxis Dr. Müller,
- Bahnhofstr. 78 hat ein E-Rezept 160.123.456.789.123.58 eingestellt"` wird eine lesbare Darstellung in HTML-Format bereitgestellt.
+ Bahnhofstr. 78 hat ein E-Rezept 160.000.000.000.000.01 eingestellt"` wird eine lesbare Darstellung in HTML-Format bereitgestellt.
NOTE: Der Versichertenbezug wird über die Versichertennummer des jeweils gelesenen/eingestellten/gelöschten E-Rezept in `"name": "X123456789"` oder auch MedicationDispense hergestellt.
diff --git a/docs_sources/misc_api_endpoints-source.adoc b/docs_sources/misc_api_endpoints-source.adoc
index e317f1f1..99fcd0e9 100644
--- a/docs_sources/misc_api_endpoints-source.adoc
+++ b/docs_sources/misc_api_endpoints-source.adoc
@@ -28,7 +28,7 @@ NOTE: Die Base64-Darstellung des ACCESS_TOKEN im `Authorization`-Header ist sta
*Response*
[source,xml]
----
-include::https://raw.githubusercontent.com/gematik/eRezept-Examples/main/API-Examples/2024-11-01/misc_api_endpoints/CapabilityStatement_RU.xml[]
+include::https://raw.githubusercontent.com/gematik/eRezept-Examples/{branch}/API-Examples/{date-folder}/misc_api_endpoints/CapabilityStatement_RU.xml[]
----
diff --git "a/images/parameters-max-whenhandedover-g\303\274ltigkeiten.png" "b/images/parameters-max-whenhandedover-g\303\274ltigkeiten.png"
new file mode 100644
index 00000000..5ff7a1f9
Binary files /dev/null and "b/images/parameters-max-whenhandedover-g\303\274ltigkeiten.png" differ
diff --git a/images/parameters-max-whenhandedover.png b/images/parameters-max-whenhandedover.png
new file mode 100644
index 00000000..0cd43a38
Binary files /dev/null and b/images/parameters-max-whenhandedover.png differ