TC 3.0.7

ImplementationGuide/ImplementierungsleitfadenIsiK_Terminplanung.json

@@ -2,7 +2,7 @@
   "resourceType": "ImplementationGuide",
   "url": "https://gematik.de/fhir/ISiK/v3/Terminplanung/ImplementationGuide/ISiK-Terminplanung",
   "name": "Implementierungsleitfaden ISiK-Modul Terminplanung",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "status": "active",
   "fhirVersion": [
     "4.0.1"

ImplementationGuide/markdown/Einfuehrung.md

@@ -1,9 +1,9 @@
 <img src="https://raw.githubusercontent.com/gematik/spec-ISiK-Terminplanung/main-stufe-3/Material/images/Gematik_Logo_Flag.svg" alt="gematik logo" width="400"/>
 
 ----
-Version: 3.0.6
+Version: 3.0.7
 
-Datum: 19.11.2024
+Datum: 20.02.2025
 
 Status: Aktiv
 

ImplementationGuide/markdown/ReleaseNotes.md

@@ -4,6 +4,18 @@ Im Rahmen der ISiK-Veröffentlichungen wird das [Semantic Versioning](https://se
 
 Die erste Ziffer X bezeichnet ein Major-Release und regelt die Gültigkeit von Releases. Die dritte Ziffer Y (Release x.0.y) bezeichnet eine technische Korrektur und versioniert kleinere Änderungen (Packages) während eines Jahres, z. B. 1.0.1.
 
+Version: 3.0.7
+
+Datum: 20.02.2025
+
+* `change` Die Verbindlichkeit der Suchparameter `subject`  in Communication sowie `include` (für `Communication:recipient` und `Communication:sender`) wurde von SHALL auf MAY reduziert https://github.com/gematik/spec-ISiK-Terminplanung/pull/257
+* `fixed` Display Values ISiKTerminCancelationReason https://github.com/gematik/spec-ISiK-Terminplanung/pull/265
+* `fixed` Korektur des Constraints zur Kardinalität im Sinne der Kohärenz mit Schedule (Kalender) auch bei Appointment.participant.actor.display https://github.com/gematik/spec-ISiK-Terminplanung/pull/263
+* `fixed` Anpassung der Kardinalität von Appointment.start/end um 'proposed', 'cancelled', 'waitlist' als Status zu ermöglichen https://github.com/gematik/spec-ISiK-Terminplanung/pull/261
+
+---
+
+
 Version: 3.0.6
 
 Datum: 19.11.2024

Resources/fsh-generated/resources/CapabilityStatement-ISiKCapabilityStatementTerminplanungServer.json

@@ -5,10 +5,10 @@
   "status": "active",
   "experimental": false,
   "publisher": "gematik GmbH",
-  "version": "3.0.6",
-  "date": "2024-11-19",
+  "version": "3.0.7",
+  "date": "2025-02-20",
   "implementationGuide": [
-    "https://gematik.de/fhir/isik/v3/Terminplanung/ImplementationGuide|3.0.6"
+    "https://gematik.de/fhir/isik/v3/Terminplanung/ImplementationGuide|3.0.7"
   ],
   "name": "ISiKCapabilityStatementTerminplanungServer",
   "title": "ISiK CapabilityStatement Terminplanung Server",
@@ -406,15 +406,15 @@
               "extension": [
                 {
                   "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-                  "valueCode": "SHALL"
+                  "valueCode": "MAY"
                 }
               ]
             },
             {
               "extension": [
                 {
                   "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-                  "valueCode": "SHALL"
+                  "valueCode": "MAY"
                 }
               ]
             }
@@ -485,13 +485,24 @@
               "extension": [
                 {
                   "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-                  "valueCode": "SHALL"
+                  "valueCode": "MAY"
                 }
               ],
               "name": "subject",
               "definition": "http://hl7.org/fhir/SearchParameter/Communication-subject",
               "type": "reference"
             },
+            {
+              "extension": [
+                {
+                  "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
+                  "valueCode": "SHALL"
+                }
+              ],
+              "name": "patient",
+              "definition": "http://hl7.org/fhir/SearchParameter/clinical-patient",
+              "type": "reference"
+            },
             {
               "extension": [
                 {
@@ -524,15 +535,15 @@
               "extension": [
                 {
                   "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-                  "valueCode": "SHALL"
+                  "valueCode": "MAY"
                 }
               ]
             },
             {
               "extension": [
                 {
                   "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-                  "valueCode": "SHALL"
+                  "valueCode": "MAY"
                 }
               ]
             }

Resources/fsh-generated/resources/OperationDefinition-ISiKAppointmentBookOperation.json

@@ -4,8 +4,8 @@
   "status": "active",
   "experimental": false,
   "publisher": "gematik GmbH",
-  "version": "3.0.6",
-  "date": "2024-11-19",
+  "version": "3.0.7",
+  "date": "2025-02-20",
   "name": "book",
   "url": "https://gematik.de/fhir/isik/v3/Terminplanung/OperationDefinition/AppointmentBook",
   "kind": "operation",

Resources/fsh-generated/resources/StructureDefinition-AppointmentReplaces.json

@@ -2,11 +2,11 @@
   "resourceType": "StructureDefinition",
   "id": "AppointmentReplaces",
   "url": "http://hl7.org/fhir/5.0/StructureDefinition/extension-Appointment.replaces",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "name": "AppointmentReplaces",
   "status": "active",
   "experimental": false,
-  "date": "2024-11-19",
+  "date": "2025-02-20",
   "publisher": "gematik GmbH",
   "fhirVersion": "4.0.1",
   "kind": "complex-type",

Resources/fsh-generated/resources/StructureDefinition-ISiKKalender.json

@@ -2,11 +2,11 @@
   "resourceType": "StructureDefinition",
   "id": "ISiKKalender",
   "url": "https://gematik.de/fhir/isik/v3/Terminplanung/StructureDefinition/ISiKKalender",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "name": "ISiKKalender",
   "status": "active",
   "experimental": false,
-  "date": "2024-11-19",
+  "date": "2025-02-20",
   "publisher": "gematik GmbH",
   "fhirVersion": "4.0.1",
   "kind": "resource",
@@ -170,7 +170,7 @@
       {
         "id": "Schedule.actor.display",
         "path": "Schedule.actor.display",
-        "comment": "Hinweis: Für alle Target-Ressourcen SOLL ein Displaywert für die Referenz angegeben werden, sodass Systeme eine Übersicht der am Termin beteiligten Akteure anzeigen können ohne die Referenzen auflösen zu müssen.",
+        "comment": "Begründung zu Must Support: Dieses Feld ist optional (0..1), muss jedoch implementiert werden (MS), um die Möglichkeit zu bieten, einen Display-Wert (z.B. Namen) für einen Akteur zu verarbeiten und zu persistieren, dem der Kalender zugewiesen ist.\n    \n    Hinweis: Für alle Target-Ressourcen SOLL ein Displaywert für die Referenz angegeben werden, sodass Systeme eine Übersicht der am Termin beteiligten Akteure anzeigen können ohne die Referenzen auflösen zu müssen.",
         "mustSupport": true
       },
       {

Resources/fsh-generated/resources/StructureDefinition-ISiKMedizinischeBehandlungseinheit.json

@@ -2,11 +2,11 @@
   "resourceType": "StructureDefinition",
   "id": "ISiKMedizinischeBehandlungseinheit",
   "url": "https://gematik.de/fhir/isik/v3/Terminplanung/StructureDefinition/ISiKMedizinischeBehandlungseinheit",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "name": "ISiKMedizinischeBehandlungseinheit",
   "status": "active",
   "experimental": false,
-  "date": "2024-11-19",
+  "date": "2025-02-20",
   "publisher": "gematik GmbH",
   "fhirVersion": "4.0.1",
   "kind": "resource",

Resources/fsh-generated/resources/StructureDefinition-ISiKNachricht.json

@@ -2,11 +2,11 @@
   "resourceType": "StructureDefinition",
   "id": "ISiKNachricht",
   "url": "https://gematik.de/fhir/isik/v3/Terminplanung/StructureDefinition/ISiKNachricht",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "name": "ISiKNachricht",
   "status": "active",
   "experimental": false,
-  "date": "2024-11-19",
+  "date": "2025-02-20",
   "publisher": "gematik GmbH",
   "fhirVersion": "4.0.1",
   "kind": "resource",

Resources/fsh-generated/resources/StructureDefinition-ISiKNachrichtExtension.json

@@ -2,11 +2,11 @@
   "resourceType": "StructureDefinition",
   "id": "ISiKNachrichtExtension",
   "url": "https://gematik.de/fhir/isik/v3/Terminplanung/StructureDefinition/ISiKNachrichtExtension",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "name": "ISiKNachrichtExtension",
   "status": "active",
   "experimental": false,
-  "date": "2024-11-19",
+  "date": "2025-02-20",
   "publisher": "gematik GmbH",
   "fhirVersion": "4.0.1",
   "kind": "complex-type",

Resources/fsh-generated/resources/StructureDefinition-ISiKTermin.json

@@ -2,11 +2,11 @@
   "resourceType": "StructureDefinition",
   "id": "ISiKTermin",
   "url": "https://gematik.de/fhir/isik/v3/Terminplanung/StructureDefinition/ISiKTermin",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "name": "ISiKTermin",
   "status": "active",
   "experimental": false,
-  "date": "2024-11-19",
+  "date": "2025-02-20",
   "publisher": "gematik GmbH",
   "fhirVersion": "4.0.1",
   "kind": "resource",
@@ -191,16 +191,6 @@
       {
         "id": "Appointment.priority.extension",
         "path": "Appointment.priority.extension",
-        "slicing": {
-          "discriminator": [
-            {
-              "type": "value",
-              "path": "url"
-            }
-          ],
-          "ordered": false,
-          "rules": "open"
-        },
         "mustSupport": true
       },
       {
@@ -222,13 +212,13 @@
       {
         "id": "Appointment.start",
         "path": "Appointment.start",
-        "min": 1,
+        "comment": "Begründung zu Kardinalität und Must Support: Der Startzeitpunkt eines Termins ist von entscheidender Bedeutung, um die Verfügbarkeit und Planung des Termins zu gewährleisten. Daher muss dieses Feld unterstützt werden (MS). Das Feld ist in den meisten Fällen verpflichtend, nur für die Status 'proposed', 'cancelled', 'waitlist' existiert kein Wert.",
         "mustSupport": true
       },
       {
         "id": "Appointment.end",
         "path": "Appointment.end",
-        "min": 1,
+        "comment": "Begründung zu Kardinalität und Must Support: Der Endzeitpunkt eines Termins ist von entscheidender Bedeutung, um die Verfügbarkeit und Planung des Termins zu gewährleisten. Daher muss dieses Feld unterstützt werden (MS). Das Feld ist in den meisten Fällen verpflichtend, nur für die Status 'proposed', 'cancelled', 'waitlist' existiert kein Wert.",
         "mustSupport": true
       },
       {
@@ -272,7 +262,7 @@
       {
         "id": "Appointment.participant.actor.display",
         "path": "Appointment.participant.actor.display",
-        "min": 1,
+        "comment": "Begründung zu Must Support: Dieses Feld ist optional (0..1), muss jedoch implementiert werden (MS), um die Möglichkeit zu bieten, einen Display-Wert für einen am Termin teilnehmenden Akteur zu verarbeiten und zu persistieren.",
         "mustSupport": true
       },
       {

Resources/fsh-generated/resources/StructureDefinition-ISiKTerminKontaktMitGesundheitseinrichtung.json

@@ -2,11 +2,11 @@
   "resourceType": "StructureDefinition",
   "id": "ISiKTerminKontaktMitGesundheitseinrichtung",
   "url": "https://gematik.de/fhir/isik/v3/Terminplanung/StructureDefinition/ISiKTerminKontaktMitGesundheitseinrichtung",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "name": "ISiKTerminKontaktMitGesundheitseinrichtung",
   "status": "active",
   "experimental": false,
-  "date": "2024-11-19",
+  "date": "2025-02-20",
   "publisher": "gematik GmbH",
   "fhirVersion": "4.0.1",
   "kind": "resource",

Resources/fsh-generated/resources/StructureDefinition-ISiKTerminPriorityExtension.json

@@ -2,11 +2,11 @@
   "resourceType": "StructureDefinition",
   "id": "ISiKTerminPriorityExtension",
   "url": "https://gematik.de/fhir/isik/v3/Terminplanung/StructureDefinition/ISiKTerminPriorityExtension",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "name": "ISiKTerminPriorityExtension",
   "status": "active",
   "experimental": false,
-  "date": "2024-11-19",
+  "date": "2025-02-20",
   "publisher": "gematik GmbH",
   "fhirVersion": "4.0.1",
   "kind": "complex-type",

Resources/fsh-generated/resources/StructureDefinition-ISiKTerminblock.json

@@ -2,11 +2,11 @@
   "resourceType": "StructureDefinition",
   "id": "ISiKTerminblock",
   "url": "https://gematik.de/fhir/isik/v3/Terminplanung/StructureDefinition/ISiKTerminblock",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "name": "ISiKTerminblock",
   "status": "active",
   "experimental": false,
-  "date": "2024-11-19",
+  "date": "2025-02-20",
   "publisher": "gematik GmbH",
   "fhirVersion": "4.0.1",
   "kind": "resource",

Resources/fsh-generated/resources/StructureDefinition-ScheduleName.json

@@ -2,11 +2,11 @@
   "resourceType": "StructureDefinition",
   "id": "ScheduleName",
   "url": "http://hl7.org/fhir/5.0/StructureDefinition/extension-Schedule.name",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "name": "ScheduleName",
   "status": "active",
   "experimental": false,
-  "date": "2024-11-19",
+  "date": "2025-02-20",
   "publisher": "gematik GmbH",
   "fhirVersion": "4.0.1",
   "kind": "complex-type",

Resources/fsh-generated/resources/ValueSet-ISiKTerminCancelationReason.json

@@ -4,30 +4,35 @@
   "name": "ISiKTerminCancelationReason",
   "id": "ISiKTerminCancelationReason",
   "description": "Enthaelt alle erlaubten Gruende fuer eine Stornierung eines ISiKTermins",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "url": "https://gematik.de/fhir/isik/v3/Terminplanung/ValueSet/ISiKTerminCancelationReason",
   "experimental": false,
   "publisher": "gematik GmbH",
-  "date": "2024-11-19",
+  "date": "2025-02-20",
   "compose": {
     "include": [
       {
         "system": "http://terminology.hl7.org/CodeSystem/appointment-cancellation-reason",
         "concept": [
           {
-            "code": "pat"
+            "code": "pat",
+            "display": "Patient"
           },
           {
-            "code": "prov"
+            "code": "prov",
+            "display": "Provider"
           },
           {
-            "code": "maint"
+            "code": "maint",
+            "display": "Equipment Maintenance/Repair"
           },
           {
-            "code": "meds-inc"
+            "code": "meds-inc",
+            "display": "Prep/Med Incomplete"
           },
           {
-            "code": "other"
+            "code": "other",
+            "display": "Other"
           }
         ]
       }

Resources/fsh-generated/resources/ValueSet-ISiKTerminPriority.json

@@ -4,11 +4,11 @@
   "name": "ISiKTerminPriority",
   "id": "ISiKTerminPriority",
   "description": "Enthaelt alle SNOMED Codes, die eine valide Priorität für den ISiKTermin sind",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "url": "https://gematik.de/fhir/isik/v3/Terminplanung/ValueSet/ISiKTerminPriority",
   "experimental": false,
   "publisher": "gematik GmbH",
-  "date": "2024-11-19",
+  "date": "2025-02-20",
   "compose": {
     "include": [
       {

Resources/input/fsh/ISiKKalender.fsh

@@ -29,8 +29,10 @@ Id: ISiKKalender
 * actor 1..* MS
   * ^comment = "Ein dezidierter Kalender ist für jeden Akteur zu pflegen."  
   * identifier 0..1 MS
-  * display 0..1 MS
-    * ^comment = "Hinweis: Für alle Target-Ressourcen SOLL ein Displaywert für die Referenz angegeben werden, sodass Systeme eine Übersicht der am Termin beteiligten Akteure anzeigen können ohne die Referenzen auflösen zu müssen."  
+  * display MS
+    * ^comment = "Begründung zu Must Support: Dieses Feld ist optional (0..1), muss jedoch implementiert werden (MS), um die Möglichkeit zu bieten, einen Display-Wert (z.B. Namen) für einen Akteur zu verarbeiten und zu persistieren, dem der Kalender zugewiesen ist.
+
+    Hinweis: Für alle Target-Ressourcen SOLL ein Displaywert für die Referenz angegeben werden, sodass Systeme eine Übersicht der am Termin beteiligten Akteure anzeigen können ohne die Referenzen auflösen zu müssen."  
   * ^slicing.discriminator.type = #type
   * ^slicing.discriminator.path = "$this"
   * ^slicing.rules = #open