Merge pull request #166 from gematik/TC_3.0.3

* Präzisieren der Anforderung für Encounter * update Slot search requirement * update releasenotes * fix Changes * update releasenotes * Update ImplementationGuide/markdown/Datenobjekte/ISiKTerminblockSlot.md Co-authored-by: Alexander Zautke <[email protected]> * update description * add Chaining examples * Klarstellung, dass das Verschieben eines Termins nur durchgeführt werden soll, wenn der vorgeschlagene Termin verfügbar ist (#170) * Klarstellung, dass das Verschieben eines Termins nur durchgeführt werden soll, wenn der vorgeschlagene Termin verfügbar ist * Update ISiKBookOperation.fsh * update dependency Basis 3.0.4 * reduce requirement -for TC Stufe 3 (#172) * reduce requirement * reduce requirement CpS + add releasenote * Apply suggestions from code review * Update ImplementationGuide/markdown/Datenobjekte/ISiKNachrichtCommunication.md * Beschreibung von HealthcareService verbessert (#176) * Beschreibung von HealthcareService hinzugefügt * update Motivation HealthcareService * Update ImplementationGuide/markdown/Datenobjekte/ISiKMedizinischeBehandlungseinheitHealthcareService.md Co-authored-by: Alexander Zautke <[email protected]> * Update ImplementationGuide/markdown/Datenobjekte/ISiKMedizinischeBehandlungseinheitHealthcareService.md Co-authored-by: Alexander Zautke <[email protected]> * update releasenote --------- Co-authored-by: f-peverali <[email protected]> * update version and date --------- Co-authored-by: Alexander Zautke <[email protected]>
gematik · Mar 25, 2024 · e018ed6 · e018ed6
2 parents cbd2e53 + 2a3988a
commit e018ed6
Show file tree

Hide file tree

Showing 26 changed files with 267 additions and 236 deletions.
diff --git a/ImplementationGuide/ImplementierungsleitfadenIsiK_Terminplanung.json b/ImplementationGuide/ImplementierungsleitfadenIsiK_Terminplanung.json
@@ -1,116 +1,116 @@
-{
-  "resourceType": "ImplementationGuide",
-  "url": "https://gematik.de/fhir/ISiK/v3/Terminplanung/ImplementationGuide/ISiK-Terminplanung",
-  "name": "Implementierungsleitfaden ISiK-Modul Terminplanung",
-  "version": "3.0.2",
-  "status": "active",
-  "fhirVersion": [
-    "4.0.1"
-  ],
-  "packageId": "de.gematik.isik-terminplanung-stufe-3",
-  "definition": {
-    "resource": [
-      {
-        "reference": {
-          "reference": "Appointment/ISiKTerminExample"
-        }
-      }
-    ],
-    "page": {
-      "nameUrl": "ImplementationGuide/markdown/Einfuehrung.md",
-      "title": "Einführung",
-      "generation": "markdown",
-      "page": [
-        {
-          "nameUrl": "ImplementationGuide/markdown/ReleaseNotes.md",
-          "title": "Release Notes",
-          "generation": "markdown"
-        },
-        {
-          "nameUrl": "ImplementationGuide/markdown/Motivation.md",
-          "title": "Motivation",
-          "generation": "markdown"
-        },
-        {
-          "nameUrl": "ImplementationGuide/markdown/UebergreifendeFestlegungen/UebergreifendeFestlegungen.md",
-          "title": "Übergreifende Festlegungen",
-          "generation": "markdown",
-          "page": [
-            {
-              "nameUrl": "ImplementationGuide/markdown/UebergreifendeFestlegungen/BestaetigungsrelevanteSysteme.md",
-              "title": "Bestätigungsrelevante Systeme",
-              "generation": "markdown"
-            },
-            {
-              "nameUrl": "ImplementationGuide/markdown/UebergreifendeFestlegungen/Kompatibilitaet.md",
-              "title": "Kompatibilität",
-              "generation": "markdown"
-            },
-            {
-              "nameUrl": "ImplementationGuide/markdown/UebergreifendeFestlegungen/Akteure.md",
-              "title": "Akteure",
-              "generation": "markdown"
-            },
-            {
-              "nameUrl": "ImplementationGuide/markdown/UebergreifendeFestlegungen/Interaktionen.md",
-              "title": "Interaktionen",
-              "generation": "markdown"
-            }
-          ]
-        },
-        {
-          "generation": "markdown",
-          "nameUrl": "ImplementationGuide/markdown/Datenobjekte.md",
-          "title": "Datenobjekte",
-          "page": [
-            {
-              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/CapabilityStatement.md",
-              "title": "CapabilityStatement",
-              "generation": "markdown"
-            },
-            {
-              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/Operations.md",
-              "title": "Operations",
-              "generation": "markdown"
-            },
-            {
-              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/ISiKKalenderSchedule.md",
-              "title": "ISiKKalender (Schedule)",
-              "generation": "markdown"
-            },
-            {
-              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/ISiKTerminblockSlot.md",
-              "title": "ISiKTerminblock (Slot)",
-              "generation": "markdown"
-            },
-            {
-              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/ISiKTerminKontaktMitGesundheitseinrichtung.md",
-              "title": "ISiKTerminKontaktMitGesundheitseinrichtung (Encounter)",
-              "generation": "markdown"
-            },
-            {
-              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/ISiKTerminAppointment.md",
-              "title": "ISiKTermin (Appointment)",
-              "generation": "markdown"
-            },
-            {
-              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/ISiKNachrichtCommunication.md",
-              "title": "ISiKNachricht (Communication)",
-              "generation": "markdown"
-            },
-            {
-              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/ISiKMedizinischeBehandlungseinheitHealthcareService.md",
-              "title": "ISiKMedizinischeBehandlungseinheit (HealthcareService)",
-              "generation": "markdown"
-            },
-            {
-              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/ISiKBinary.md",
-              "title": "ISiKBinary (Binary)",
-              "generation": "markdown"
-            }
-          ]
-        }
-      ]
-    }
-  }
+{
+  "resourceType": "ImplementationGuide",
+  "url": "https://gematik.de/fhir/ISiK/v3/Terminplanung/ImplementationGuide/ISiK-Terminplanung",
+  "name": "Implementierungsleitfaden ISiK-Modul Terminplanung",
+  "version": "3.0.3",
+  "status": "active",
+  "fhirVersion": [
+    "4.0.1"
+  ],
+  "packageId": "de.gematik.isik-terminplanung-stufe-3",
+  "definition": {
+    "resource": [
+      {
+        "reference": {
+          "reference": "Appointment/ISiKTerminExample"
+        }
+      }
+    ],
+    "page": {
+      "nameUrl": "ImplementationGuide/markdown/Einfuehrung.md",
+      "title": "Einführung",
+      "generation": "markdown",
+      "page": [
+        {
+          "nameUrl": "ImplementationGuide/markdown/ReleaseNotes.md",
+          "title": "Release Notes",
+          "generation": "markdown"
+        },
+        {
+          "nameUrl": "ImplementationGuide/markdown/Motivation.md",
+          "title": "Motivation",
+          "generation": "markdown"
+        },
+        {
+          "nameUrl": "ImplementationGuide/markdown/UebergreifendeFestlegungen/UebergreifendeFestlegungen.md",
+          "title": "Übergreifende Festlegungen",
+          "generation": "markdown",
+          "page": [
+            {
+              "nameUrl": "ImplementationGuide/markdown/UebergreifendeFestlegungen/BestaetigungsrelevanteSysteme.md",
+              "title": "Bestätigungsrelevante Systeme",
+              "generation": "markdown"
+            },
+            {
+              "nameUrl": "ImplementationGuide/markdown/UebergreifendeFestlegungen/Kompatibilitaet.md",
+              "title": "Kompatibilität",
+              "generation": "markdown"
+            },
+            {
+              "nameUrl": "ImplementationGuide/markdown/UebergreifendeFestlegungen/Akteure.md",
+              "title": "Akteure",
+              "generation": "markdown"
+            },
+            {
+              "nameUrl": "ImplementationGuide/markdown/UebergreifendeFestlegungen/Interaktionen.md",
+              "title": "Interaktionen",
+              "generation": "markdown"
+            }
+          ]
+        },
+        {
+          "generation": "markdown",
+          "nameUrl": "ImplementationGuide/markdown/Datenobjekte.md",
+          "title": "Datenobjekte",
+          "page": [
+            {
+              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/CapabilityStatement.md",
+              "title": "CapabilityStatement",
+              "generation": "markdown"
+            },
+            {
+              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/Operations.md",
+              "title": "Operations",
+              "generation": "markdown"
+            },
+            {
+              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/ISiKKalenderSchedule.md",
+              "title": "ISiKKalender (Schedule)",
+              "generation": "markdown"
+            },
+            {
+              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/ISiKTerminblockSlot.md",
+              "title": "ISiKTerminblock (Slot)",
+              "generation": "markdown"
+            },
+            {
+              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/ISiKTerminKontaktMitGesundheitseinrichtung.md",
+              "title": "ISiKTerminKontaktMitGesundheitseinrichtung (Encounter)",
+              "generation": "markdown"
+            },
+            {
+              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/ISiKTerminAppointment.md",
+              "title": "ISiKTermin (Appointment)",
+              "generation": "markdown"
+            },
+            {
+              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/ISiKNachrichtCommunication.md",
+              "title": "ISiKNachricht (Communication)",
+              "generation": "markdown"
+            },
+            {
+              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/ISiKMedizinischeBehandlungseinheitHealthcareService.md",
+              "title": "ISiKMedizinischeBehandlungseinheit (HealthcareService)",
+              "generation": "markdown"
+            },
+            {
+              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/ISiKBinary.md",
+              "title": "ISiKBinary (Binary)",
+              "generation": "markdown"
+            }
+          ]
+        }
+      ]
+    }
+  }
 }
diff --git a/...de/markdown/Datenobjekte/ISiKMedizinischeBehandlungseinheitHealthcareService.md b/...de/markdown/Datenobjekte/ISiKMedizinischeBehandlungseinheitHealthcareService.md
@@ -4,7 +4,14 @@
 
 ### Motivation
 
-Unter einer medizinischen Behandlungseinheit wird innerhalb dieser Spezifikation ein (virtueller) Zusammenschluss von Fachabteilungen, darin agierenden Personen im Gesundheitswesen und zur Verfügung stehenden Ressourcen (z.B. Räume / Geräte), zum Zweck der Ausübung einer Behandlungsleistung, verstanden. Hierfür können von der Fachabteilung (Organization) unabhängige Kalender gepflegt werden.
+Unter einer medizinischen Behandlungseinheit wird hier im weiten Sinne eine Dienstleistung (diagnostisch, therapeutisch, im weiten Sinne gesundheitsfördernd etc.) zum Zweck einer Terminbuchung verstanden. Hierfür können von der Fachabteilung (Organization) unabhängige Kalender gepflegt werden. Im Kontext der Terminplanung können somit angebotene Leistungen (z.B. CT/MRT-Untersuchungen, chirurgische Eingriffe, Beratungsstunden zur Geburt etc.) abgebildet werden.
+
+Der Kontext zu diesem Profil wird mit folgender User Story veranschaulicht: 
+
+**User Story**: Ein Patient erhält von seiner Hausärztin einen Überweisungsschein für eine weitere diagnostische Untersuchung in Form einer Kapselendoskopie der Speiseröhre. Der Patient nutzt ein Patientenportal, um unter Angabe der benötigten diagnostische Leistung nach einem verfügbaren Termin zu suchen und findet einen passenden Termin bei der Fachabteilung für Gastroenterologie eines örtlichen Krankenhauses.
+
+Hintergrund: Die Suche nach verfügbaren Terminenblöcken (Slot) unter Einbeziehung der Dienstleistung entspricht der Angabe des Überweisungsscheins, ermöglicht hier zugleich eine präzisere Suche und vergrößert darüber hinaus den Raum möglicher Termine über verschiedene Abteilungen (und Institutionen im Patientenportal) hinweg.
+
 
 ---
 
@@ -26,6 +33,10 @@ Folgende FHIRPath-Constraints sind im Profil zu beachten:
 
 @``` from StructureDefinition where url = 'https://gematik.de/fhir/isik/v3/Terminplanung/StructureDefinition/ISiKMedizinischeBehandlungseinheit' for differential.element.constraint select key, severity, human, expression```
 
+
+Die Verknüpfung mit anderen Parametern, wie beteiligten Akteuren, erfolgt über ISiKTermin (Appointment) oder ISiKKalender (Schedule).
+
+
 ---
 
 **Terminology Bindings**

diff --git a/ImplementationGuide/markdown/Datenobjekte/ISiKNachrichtCommunication.md b/ImplementationGuide/markdown/Datenobjekte/ISiKNachrichtCommunication.md
@@ -10,6 +10,10 @@ Es liegt in der Verantwortung des bestätigungsrelevanten Systems, eine dem Schu
 * ISiKNachricht SOLL ausschließlich für den Austausch administrativer, nicht personenbezogener Informationen im Kontext der Terminbuchung verwendet werden, z. B. zur Übermittlung von Coronahinweisen oder Lageplänen.
 * Der Austausch personenbezogener medizinischer Daten SOLL ausschließlich über die dafür vorgesehenen sicheren Dienste der Telematikinfrastruktur, wie z. B. ePA und zukünftig auch den TI-Messenger, erfolgen.
 
+#### Normativer Status und Bestätigung
+
+Dieses Profil MUSS im Rahmen der Bestätigung NICHT unterstützt werden. Falls das Profil unterstützt werden soll, MÜSSEN die hier definierten Festlegungen greifen (auch im Bestätigungsverfahren; in diesem Sinn sind auch die SHALL-Vorgaben im CapabilityStatement als bedingte zu verstehen).
+
 ---
 
 ### Kompabilität

diff --git a/...tationGuide/markdown/Datenobjekte/ISiKTerminKontaktMitGesundheitseinrichtung.md b/...tationGuide/markdown/Datenobjekte/ISiKTerminKontaktMitGesundheitseinrichtung.md
@@ -8,6 +8,8 @@ Das Datenobjekt ISiKKontaktMitGesundheitseinrichtung dient der Verknüpfung des
 
 Die Anforderung dieser Verknüpfung stammt aus dem Szenario der Dokument-Übertragung zwischen Patientenportal und krankenhaus-internem Primärsystem (KIS): Dokumente liegen bei Termin-Buchung erst im Patientenportal (im Appointment) vor und werden erst mit Anlage des Encounters in das KIS (etc.) übermittelt. Dazu muss das Appointment mit dem neu angelegten Encounter verknüpft werden, um die Dokumente aus dem Patientenportal darüber zuzuordnen.
 
+Hieraus folgt, dass das Datenobjekt nur relevant ist, falls das bestätigungsrelevante System das Datenobjekt ISiKKontaktGesundheitseinrichtung sowie ISiKTermin implementiert. Zu Beginn des Termins sollte das System die Verknüpfung zwischen Encounter und Appointment herstellen. Ausgenommen hiervon sind Termine, die nicht stattfinden, da für diese in der Regel keine Encounter angelegt werden.
+
 ---
 
 ### Kompabilität

diff --git a/ImplementationGuide/markdown/Datenobjekte/ISiKTerminblockSlot.md b/ImplementationGuide/markdown/Datenobjekte/ISiKTerminblockSlot.md
@@ -74,29 +74,30 @@ Für die Ressource Slot MUSS die REST-Interaktion "READ" implementiert werden.
 
     ```GET [base]/Slot?schedule=Schedule/ISiKKalenderExample```
 
-    Anwendungshinweise: Weitere Informationen zur Suche nach "Slot.schedule" finden sich in der [FHIR-Basisspezifikation - Abschnitt "reference"](https://hl7.org/fhir/R4/search.html#reference).
+    Anwendungshinweise: In diesem Fall ist auch ein Chaining auf weitere verknüpfte Akteure möglich: `GET https://example.org/fhir/Slot?schedule.actor:HealthcareService.type=https://example.org/fhir/CodeSystem/Behandlungsleistung|CT`
+    Weitere Informationen zur Suche nach "Slot.schedule" finden sich in der [FHIR-Basisspezifikation - Abschnitt "reference"](https://hl7.org/fhir/R4/search.html#reference).
 
-3. Der Suchparameter "status" MUSS unterstützt werden:
+3. Der Suchparameter "status" MUSS in Kombination ('&') mit einer Abfrage auf Schedule unterstützt werden. Diese Abfrage KANN entweder eine direkte Angabe einer Referenz oder eine Angabe von weiteren Chaining-Parametern sein:
 
     Beispiele:
 
-    ```GET [base]/Slot?status=busy```
+    ```GET [base]/Slot?status=free&schedule=Schedule/ISiKTerminExample```
 
-    Anwendungshinweise: Weitere Informationen zur Suche nach "Slot.status" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Token Search"](https://hl7.org/fhir/R4/search.html#token).
+    ```GET [base]/Slot?status=free&schedule.actor:Practitioner.name=Musterarzt```
 
-4. Der Suchparameter "start" MUSS unterstützt werden:
 
-    Beispiele:
+    Anwendungshinweise: Der Suchparameter MUSS NICHT alleinstehend unterstützt werden. Weitere Informationen zur Suche nach "Slot.status" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Token Search"](https://hl7.org/fhir/R4/search.html#token).
 
-    ```GET [base]/Slot?start=2022-12-10T09:00:00Z```
+4. Der Suchparameter "start" MUSS in Kombination ('&') mit einer Parameter-Abfrage auf Schedule unterstützt werden. Diese Abfrage KANN entweder eine direkte Angabe einer Referenz oder eine Angabe von weiteren Chaining-Parametern sein:
 
-    Anwendungshinweise: Weitere Informationen zur Suche nach "Slot.start" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Date Search"](https://hl7.org/fhir/R4/search.html#date).
+    Beispiele:
 
-5. Abfrage aller verfügbaren Slots für einen Kalender:
+    ```GET [base]/Slot?start=2022-12-10T09:00:00Z&schedule=Schedule/ISiKTerminExample```
 
-    ```GET https://example.org/fhir/Slot?schedule=<Schedule/ISiKKalenderExample>```
+    ```GET [base]/Slot?start=2022-12-10T09:00:00Z&schedule.actor:Practitioner.name=Musterarzt```
+
+    Anwendungshinweise: Der Suchparameter MUSS NICHT alleinstehend unterstützt werden. Weitere Informationen zur Suche nach "Slot.start" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Date Search"](https://hl7.org/fhir/R4/search.html#date).
 
-    Anwendungshinweise: In diesem Fall ist auch ein Chaining auf weitere verknüpfte Akteure möglich: `GET https://example.org/fhir/Slot?schedule.actor:HealthcareService.type=https://example.org/fhir/CodeSystem/Behandlungsleistung|CT`
 ---
 
 ### Beispiele
-Original file line number
+Diff line change
@@ Expand Up @@
     Die Anforderung dieser Verknüpfung stammt aus dem Szenario der Dokument-Übertragung zwischen Patientenportal und krankenhaus-internem Primärsystem (KIS): Dokumente liegen bei Termin-Buchung erst im Patientenportal (im Appointment) vor und werden erst mit Anlage des Encounters in das KIS (etc.) übermittelt. Dazu muss das Appointment mit dem neu angelegten Encounter verknüpft werden, um die Dokumente aus dem Patientenportal darüber zuzuordnen.
+    Hieraus folgt, dass das Datenobjekt nur relevant ist, falls das bestätigungsrelevante System das Datenobjekt ISiKKontaktGesundheitseinrichtung sowie ISiKTermin implementiert. Zu Beginn des Termins sollte das System die Verknüpfung zwischen Encounter und Appointment herstellen. Ausgenommen hiervon sind Termine, die nicht stattfinden, da für diese in der Regel keine Encounter angelegt werden.
     ---
     ### Kompabilität
@@ Expand Down @@