add clarification on usage

.gitignore

@@ -89,3 +89,7 @@ Network Trash Folder
 Temporary Items
 .apdisk
 
+Resources/fsh-generated/fsh-index.json
+Resources/fsh-generated/fsh-index.json
+Resources/fsh-generated/fsh-index.txt
+Resources/fsh-generated/fsh-index.json

ImplementationGuide/markdown/ReleaseNotes.md

@@ -5,12 +5,13 @@ 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: 4.0.1
 
 Datum: tbd
 
 * ´improve´ ´test modifying´ Möglicher Breaking Change für Clients: Änderung (Schwächung) der MS-Definition für .reasonCode und reasonReference für MedicationAdministration und MedicationStatement https://github.com/gematik/spec-ISiK-Medikation/pull/140
+* ´improve´ ´test modifying´ Klärung zur Nutzung der Zeit-Elemente in ISiKMedikationsInformation -und ISiKMedikationsVerabreichung
+  * Zum Hintergrund der Entscheidungsfindung beachte [öffentliche Fragestellung und Diskussion](https://chat.fhir.org/#narrow/channel/287581-german.2Fisik/topic/.5BMED.5D.20Administration.2FVerabreichung.20-.20Date.20or.20Timestamp). 
 
 
 ----

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

@@ -6,7 +6,7 @@
   "experimental": false,
   "version": "4.0.1",
   "publisher": "gematik GmbH",
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "implementationGuide": [
     "https://gematik.de/fhir/Medikation/ImplementationGuide/ISiK-Medikation"
   ],

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

@@ -6,11 +6,7 @@
   "experimental": false,
   "version": "4.0.1",
   "publisher": "gematik GmbH",
-<<<<<<< HEAD
-  "date": "2024-10-23",
-=======
-  "date": "2024-10-31",
->>>>>>> TC_4.0.1
+  "date": "2024-12-12",
   "implementationGuide": [
     "https://gematik.de/fhir/Medikation/ImplementationGuide/ISiK-Medikation"
   ],

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

@@ -6,11 +6,7 @@
   "experimental": false,
   "version": "4.0.1",
   "publisher": "gematik GmbH",
-<<<<<<< HEAD
-  "date": "2024-10-23",
-=======
-  "date": "2024-10-31",
->>>>>>> TC_4.0.1
+  "date": "2024-12-12",
   "implementationGuide": [
     "https://gematik.de/fhir/ISiK/ImplementationGuide/ISiK-Medikation"
   ],

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

@@ -6,11 +6,7 @@
   "experimental": false,
   "version": "4.0.1",
   "publisher": "gematik GmbH",
-<<<<<<< HEAD
-  "date": "2024-10-23",
-=======
-  "date": "2024-10-31",
->>>>>>> TC_4.0.1
+  "date": "2024-12-12",
   "implementationGuide": [
     "https://gematik.de/fhir/ISiK/ImplementationGuide/ISiK-Medikation"
   ],

Resources/fsh-generated/resources/CodeSystem-ISiKMedikationsartCS.json

@@ -20,6 +20,6 @@
   ],
   "experimental": false,
   "publisher": "gematik GmbH",
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "count": 2
 }

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

@@ -7,7 +7,7 @@
   "title": "ISiK Accepted Risk",
   "status": "active",
   "experimental": false,
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
   "description": "Extension zur Dokumentation eines im Rahmen der AMTS bewusst eingegangenen Risikos. In diesem Freitext kann die Begründung und ggf. zu treffende besondere Maßnahmen dokumentiert werden.",
   "fhirVersion": "4.0.1",

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

@@ -7,11 +7,7 @@
   "title": "ISiK Behandlungsziel",
   "status": "active",
   "experimental": false,
-<<<<<<< HEAD
-  "date": "2024-10-23",
-=======
-  "date": "2024-10-31",
->>>>>>> TC_4.0.1
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
   "description": "Extension zur freitextlichen Angabe des Behandlungsziels.",
   "fhirVersion": "4.0.1",

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

@@ -7,7 +7,7 @@
   "title": "ISiK MedicationRequestReplaces",
   "status": "active",
   "experimental": false,
-  "date": "2024-10-23",
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
   "description": "Extension zur Verlinkung der Medikationsverordnung die ersetzt wurde",
   "fhirVersion": "4.0.1",

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

@@ -7,7 +7,7 @@
   "title": "ISiK MedicationStatementReplaces",
   "status": "active",
   "experimental": false,
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
   "description": "Extension zur Verlinkung der Medikationsinformation die ersetzt wurde",
   "fhirVersion": "4.0.1",

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

@@ -7,11 +7,7 @@
   "title": "ISiK Medikationsart",
   "status": "active",
   "experimental": false,
-<<<<<<< HEAD
-  "date": "2024-10-23",
-=======
-  "date": "2024-10-31",
->>>>>>> TC_4.0.1
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
   "description": "Extension zur Dokumentation der Therapieart einer Medikation (Akut- oder Dauermedikation).",
   "fhirVersion": "4.0.1",

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

@@ -7,7 +7,7 @@
   "title": "ISiK Selbstmedikation",
   "status": "active",
   "experimental": false,
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
   "description": "Extension zur Angabe, ob es sich bei der Medikation um eine Selbstmedikation handelt.",
   "fhirVersion": "4.0.1",

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

@@ -7,7 +7,7 @@
   "title": "ISiK AMTS-Bewertung",
   "status": "active",
   "experimental": false,
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
   "description": "Dieses Profil ermöglicht die Abbildung von Informationen zur Risikobeurteilung im Rahmen der Arzneimitteltherapiesicherheit (AMTS).",
   "fhirVersion": "4.0.1",

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

@@ -6,7 +6,7 @@
   "name": "ISiKMedikament",
   "status": "active",
   "experimental": false,
-  "date": "2024-10-23",
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
   "description": "Dieses Profil ermöglicht die Abbildung von patientenunabhängigen Informationen zu Medikamenten in ISiK Szenarien.",
   "fhirVersion": "4.0.1",

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

@@ -7,7 +7,7 @@
   "title": "ISiK Medikation Transactionbundle",
   "status": "active",
   "experimental": false,
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
   "description": "Dieses Profil definiert die Transaktions-Bundles im Rahmen von ISiK-Medikations-Szenarien.",
   "fhirVersion": "4.0.1",

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

@@ -7,7 +7,7 @@
   "title": "ISiK Medikation TransactionBundle-Response",
   "status": "active",
   "experimental": false,
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
   "description": "Dieses Profil definiert die Server-Antwort auf Transaktions-Bundles im Rahmen von ISiK-Medikations-Szenarien.",
   "fhirVersion": "4.0.1",

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

@@ -6,9 +6,9 @@
   "name": "ISiKMedikationsInformation",
   "status": "active",
   "experimental": false,
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
-  "description": "Dieses Profil ermöglicht die Abbildung von Informationen zur Medikation eines Patienten in ISiK Szenarien.",
+  "description": "Dieses Profil ermöglicht die Abbildung von Informationen zur Medikation eines Patienten in ISiK Szenarien.\n\nHinweis zur Auswahl des Profils: \nIn Abgrenzung zu ISiKMedikationsVerabreichung (MedicationAdministration) wird mittels des vorliegenden Profils die Verabreichung eines Medikaments an einen Patienten mit einer lediglich Datums-genauen Angabe abgebildet (einschließlich Granularität Jahr, Monat oder Tag für .effectiveDateTime oder .effectivePeriod auf Datums-Ebene gemäß der [FHIR-Core Vorgabe](https://hl7.org/fhir/R4/datatypes.html#dateTime)).\nZur sekunden-genauen Angabe der Verabreichung eines Medikaments an einen Patienten SOLL das Profil ISiKMedikationsVerabreichung (MedicationAdministration) verwendet werden.",
   "fhirVersion": "4.0.1",
   "kind": "resource",
   "abstract": false,
@@ -351,7 +351,8 @@
         "id": "MedicationStatement.effective[x]:effectiveDateTime",
         "path": "MedicationStatement.effective[x]",
         "sliceName": "effectiveDateTime",
-        "short": "Zeitpunkt",
+        "short": "Zeitpunkt (Datum und/oder Uhrzeit)",
+        "comment": "Begründung des Must-Support: Basisinformation\n  \n  Festlegung zur Nutzung: \n  An dieser Stelle MUSS eine lediglich Datums-genauen Angabe (einschließlich Granularität Jahr, Monat oder Tag für .effectiveDateTime oder .effectivePeriod auf Datums-Ebene gemäß der [FHIR-Core Vorgabe](https://hl7.org/fhir/R4/datatypes.html#dateTime) seitens eines bestätigungsrelevanten Systems unterstützt werden.\n  Für sekunden-genauen Angaben zur Verabreichung eines Medikaments an einen Patienten SOLL das Profil ISiKMedikationsVerabreichung (MedicationAdministration) verwendet werden. \n  ",
         "min": 0,
         "max": "1",
         "type": [
@@ -366,6 +367,7 @@
         "path": "MedicationStatement.effective[x]",
         "sliceName": "effectivePeriod",
         "short": "Zeitraum",
+        "comment": "Begründung des Must-Support: Basisinformation\n  \n  Festlegung zur Nutzung: \n  An dieser Stelle MUSS eine lediglich Datums-genauen Angabe (einschließlich Granularität Jahr, Monat oder Tag für .effectiveDateTime oder .effectivePeriod auf Datums-Ebene gemäß der [FHIR-Core Vorgabe](https://hl7.org/fhir/R4/datatypes.html#dateTime) seitens eines bestätigungsrelevanten Systems unterstützt werden.\n  Für sekunden-genauen Angaben zur Verabreichung eines Medikaments an einen Patienten SOLL das Profil ISiKMedikationsVerabreichung (MedicationAdministration) verwendet werden. \n  ",
         "min": 0,
         "max": "1",
         "type": [
@@ -396,7 +398,7 @@
         "id": "MedicationStatement.reasonCode",
         "path": "MedicationStatement.reasonCode",
         "short": "Grund der Medikation (codiert)",
-        "comment": "Begründung des Must-Support: Nachvollziehbarkeit",
+        "comment": "  Festlegung zum MS: Die Elemente .reasonCode und .reasonReference MÜSSEN nach OR-Logik in der Ausgabe verwendet werden, d.h. nur eines MUSS geliefert werden können. Weiterhin MÜSSEN beide Elemente interpretiert werden können.\n  \n  Begründung zu Must-Support: Konsolidierung mit MII.",
         "mustSupport": true
       },
       {
@@ -430,7 +432,7 @@
         "id": "MedicationStatement.reasonReference",
         "path": "MedicationStatement.reasonReference",
         "short": "Grund der Medikation (Referenz)",
-        "comment": "Begründung des Must-Support: Nachvollziehbarkeit",
+        "comment": "  Festlegung zum MS: Die Elemente .reasonCode und .reasonReference MÜSSEN nach OR-Logik in der Ausgabe verwendet werden, d.h. nur eines MUSS geliefert werden können. Weiterhin MÜSSEN beide Elemente interpretiert werden können.\n  \n  Begründung zu Must-Support: Konsolidierung mit MII.",
         "mustSupport": true
       },
       {

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

@@ -7,7 +7,7 @@
   "title": "ISiK Medikationsliste",
   "status": "active",
   "experimental": false,
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
   "description": "Dieses Profil ermöglicht die Zusammenführung einzelner MedikationsInformationen eines Patienten in ISiK Szenarien.",
   "fhirVersion": "4.0.1",

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

@@ -6,9 +6,9 @@
   "name": "ISiKMedikationsVerabreichung",
   "status": "active",
   "experimental": false,
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
-  "description": "Dieses Profil ermöglicht die Abbildung der Verabreichung von Medikamenten für einen Patienten in ISiK Szenarien.",
+  "description": "Dieses Profil ermöglicht die Abbildung der Verabreichung von Medikamenten für einen Patienten in ISiK Szenarien. \nHinweis zur Auswahl des Profils: In Abgrenzung zu ISiKMedikationsInformation (MedicationStatement) wird mittels des vorliegenden Profils die Verabreichung eines Medikaments an einen Patienten mit einer Zeitpunkt-genauen Angabe abgebildet (.effectiveDateTime oder .effectivePeriod auf Sekundenebene gemäß der [FHIR-Core Vorgabe](https://hl7.org/fhir/R4/datatypes.html#dateTime)).\nDas Profil ISiKMedikationsInformation (MedicationStatement) kann ebenfalls für  die Abbildung der Verabreichung von Medikamenten für einen Patienten verwendet werden, wenn keine Zeitpunkt-genauen Angaben zur Verabreichung vorliegen, sondern lediglich Datums-genaue Angaben (einschließlich Granularität Jahr, Monat oder Tag).",
   "fhirVersion": "4.0.1",
   "kind": "resource",
   "abstract": false,
@@ -201,7 +201,7 @@
         "path": "MedicationAdministration.effective[x]",
         "sliceName": "effectiveDateTime",
         "short": "Zeitpunkt der Verabreichung",
-        "comment": "Begründung des Must-Support: Basisinformation",
+        "comment": "Begründung des Must-Support: Basisinformation\n  \n  Festlegung zur Nutzung: eine Zeitpunkt-genauen Angabe (.effectiveDateTime oder .effectivePeriod auf Sekundenebene gemäß der [FHIR-Core Vorgabe](https://hl7.org/fhir/R4/datatypes.html#dateTime)) MUSS hier seitens eines bestätigungsrelevanten Systems unterstützt werden.\n\n  Für grobgranularere Angaben (z.B. nur Jahr, Monat oder Tag) kann das Profil ISiKMedikationsInformation (MedicationStatement) verwendet werden.\n  ",
         "min": 0,
         "max": "1",
         "type": [
@@ -216,7 +216,7 @@
         "path": "MedicationAdministration.effective[x]",
         "sliceName": "effectivePeriod",
         "short": "Zeitraum der Verabreichung",
-        "comment": "Begründung des Must-Support: Basisinformation",
+        "comment": "Begründung des Must-Support: Basisinformation\n  \n  Festlegung zur Nutzung: eine Zeitpunkt-genauen Angabe (.effectiveDateTime oder .effectivePeriod auf Sekundenebene gemäß der [FHIR-Core Vorgabe](https://hl7.org/fhir/R4/datatypes.html#dateTime)) MUSS hier seitens eines bestätigungsrelevanten Systems unterstützt werden.\n  Für grobgranularere Angaben (z.B. nur Jahr, Monat oder Tag) kann das Profil ISiKMedikationsInformation (MedicationStatement) verwendet werden.\n  ",
         "min": 0,
         "max": "1",
         "type": [
@@ -265,7 +265,7 @@
         "id": "MedicationAdministration.reasonReference",
         "path": "MedicationAdministration.reasonReference",
         "short": "Grund der Medikation (Referenz)",
-        "comment": "Begründung des Must-Support: Nachvollziehbarkeit",
+        "comment": "  Festlegung zum MS: Die Elemente .reasonCode und .reasonReference MÜSSEN nach OR-Logik in der Ausgabe verwendet werden, d.h. nur eines MUSS geliefert werden können. Weiterhin MÜSSEN beide Elemente interpretiert werden können.",
         "mustSupport": true
       },
       {

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

@@ -6,7 +6,7 @@
   "name": "ISiKMedikationsVerordnung",
   "status": "active",
   "experimental": false,
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
   "description": "Dieses Profil ermöglicht die Abbildung von Medikationsverordnungen eines Patienten in ISiK Szenarien.",
   "fhirVersion": "4.0.1",

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

@@ -7,7 +7,7 @@
   "title": "Medication Quantity",
   "status": "active",
   "experimental": false,
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "publisher": "gematik GmbH",
   "description": "Quantity Datentyp der die Nutzung von UCUM vorgibt. Bei dimensionslosen Einheiten wie 'Tablette' wird ein code von '1' erwartet, 'Tablette' kann als String in Unit hinterlegt werden.",
   "fhirVersion": "4.0.1",

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

@@ -8,7 +8,7 @@
   "url": "https://gematik.de/fhir/isik/ValueSet/ISiKMedikationsartVS",
   "experimental": false,
   "publisher": "gematik GmbH",
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "compose": {
     "include": [
       {

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

@@ -9,7 +9,7 @@
   "url": "https://gematik.de/fhir/isik/ValueSet/MedikationsListeListModeVS",
   "experimental": false,
   "publisher": "gematik GmbH",
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "compose": {
     "include": [
       {

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

@@ -8,7 +8,7 @@
   "url": "https://gematik.de/fhir/isik/ValueSet/SctRouteOfAdministration",
   "experimental": false,
   "publisher": "gematik GmbH",
-  "date": "2024-10-31",
+  "date": "2024-12-12",
   "compose": {
     "include": [
       {

Resources/input/fsh/ISiKMedikationsInformation.fsh

@@ -1,7 +1,12 @@
 Profile: ISiKMedikationsInformation
 Parent: MedicationStatement
 Id: ISiKMedikationsInformation
-Description: "Dieses Profil ermöglicht die Abbildung von Informationen zur Medikation eines Patienten in ISiK Szenarien."
+Description: "Dieses Profil ermöglicht die Abbildung von Informationen zur Medikation eines Patienten in ISiK Szenarien.
+
+Hinweis zur Auswahl des Profils: 
+In Abgrenzung zu ISiKMedikationsVerabreichung (MedicationAdministration) wird mittels des vorliegenden Profils die Verabreichung eines Medikaments an einen Patienten mit einer lediglich Datums-genauen Angabe abgebildet (einschließlich Granularität Jahr, Monat oder Tag für .effectiveDateTime oder .effectivePeriod auf Datums-Ebene gemäß der [FHIR-Core Vorgabe](https://hl7.org/fhir/R4/datatypes.html#dateTime)).
+Zur sekunden-genauen Angabe der Verabreichung eines Medikaments an einen Patienten SOLL das Profil ISiKMedikationsVerabreichung (MedicationAdministration) verwendet werden."
+
 * insert Meta
 * extension MS
 * extension contains
@@ -90,9 +95,21 @@ Description: "Dieses Profil ermöglicht die Abbildung von Informationen zur Medi
   * ^short = "Zeitpunkt oder Zeitraum, für den die MedikationsInformation gilt"
   * ^comment = "Begründung des Must-Support: Basisinformation"
 * effectiveDateTime MS
-  * ^short = "Zeitpunkt"
+  * ^short = "Zeitpunkt (Datum und/oder Uhrzeit)"
+  * ^comment = "Begründung des Must-Support: Basisinformation
+
+  Festlegung zur Nutzung: 
+  An dieser Stelle MUSS eine lediglich Datums-genauen Angabe (einschließlich Granularität Jahr, Monat oder Tag für .effectiveDateTime oder .effectivePeriod auf Datums-Ebene gemäß der [FHIR-Core Vorgabe](https://hl7.org/fhir/R4/datatypes.html#dateTime) seitens eines bestätigungsrelevanten Systems unterstützt werden.
+  Für sekunden-genauen Angaben zur Verabreichung eines Medikaments an einen Patienten SOLL das Profil ISiKMedikationsVerabreichung (MedicationAdministration) verwendet werden. 
+  "  
 * effectivePeriod MS
   * ^short = "Zeitraum"
+  * ^comment = "Begründung des Must-Support: Basisinformation
+
+  Festlegung zur Nutzung: 
+  An dieser Stelle MUSS eine lediglich Datums-genauen Angabe (einschließlich Granularität Jahr, Monat oder Tag für .effectiveDateTime oder .effectivePeriod auf Datums-Ebene gemäß der [FHIR-Core Vorgabe](https://hl7.org/fhir/R4/datatypes.html#dateTime) seitens eines bestätigungsrelevanten Systems unterstützt werden.
+  Für sekunden-genauen Angaben zur Verabreichung eines Medikaments an einen Patienten SOLL das Profil ISiKMedikationsVerabreichung (MedicationAdministration) verwendet werden. 
+  "  
   * start MS
   * end MS
 * dateAsserted MS