Medication IG DE
2.0.0-ballot - ballot

Medication IG DE, published by HL7 Deutschland e.V.. This guide is not an authorized publication; it is the continuous build for version 2.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7germany/medication-ig-de-r4/ and changes regularly. See the Directory of published versions

Angabe von Start- und Enddatum

Diese Seite beschreibt strukturierte Angaben von Start- und Enddatum innerhalb einer einzelnen Dosierung. Die Angabe von Start- und/oder Enddatum ermöglicht es, Dosierschemata eindeutig im zeitlichen Verlauf zu verorten, z. B. bei akuten Behandlungen. Die explizite Angabe von Start- und Endzeitpunkten erhöht somit die Eindeutigkeit von Dosierangaben und unterstützt eine korrekte Umsetzung in der Praxis.

Die Seite beschreibt die hierfür geltenden technischen Anforderungen im dgMP-Kontext. Die folgenden fachlichen Definitionen gelten für die Modellierung:

Information Beschreibung FHIR-Modellierung Datentyp
Startdatum Das Startdatum beziehungsweise der Startzeitpunkt legt fest, ab wann das Dosierschema anzuwenden ist. Ein Startzeitpunkt mit Uhrzeit bezeichnet die erste Gabe. Timing.repeat.boundsPeriod.start dateTime
Enddatum Das Enddatum beziehungsweise der Endzeitpunkt legt fest, bis wann das Dosierschema anzuwenden ist. Ein Endzeitpunkt mit Uhrzeit bezeichnet die letzte Gabe. Timing.repeat.boundsPeriod.end dateTime

Die Angabe von Start- und Enddatum definiert den zeitlichen Gültigkeitsbereich einer Dosieranweisung. Sie kann nicht mit der Dauer einer Anwendung (.boundsDuration) kombiniert werden.

Start und Ende können als vollständiges Kalenderdatum oder als Datum mit Uhrzeit angegeben werden; die in FHIR dateTime ebenfalls möglichen Teildaten JJJJ und JJJJ-MM sind nicht zulässig (TimingBoundsPeriodFullDate). Enthält ein FHIR-dateTime eine Uhrzeit, ist eine Zeitzone verpflichtend. Für die Textdarstellung wird der Zeitpunkt in die IANA-Zeitzone Europe/Berlin umgerechnet.

Folgende weitere Beispiele sind in diesem IG dargestellt:

Beispiel Beispiel Datei
Dosierung mit Startdatum Example-MR-Dosage-1000-startdate
Dosierung mit Enddatum Example-MR-Dosage-1000-enddate
Dosierung mit Start und Enddatum Example-MR-Dosage-1000-startandenddate
Dosierung mit Startzeitpunkt und Zeitzone Example-MR-Dosage-1000-startdatetime
Dosierung mit Startzeitpunkt und Tageswechsel durch Zeitzonenumrechnung Example-MR-Dosage-1000-startdatetime-daychange

Hinweis: Für eine gute UI eignet es sich das Start-Datum in Kombination mit dem Uhrzeiten- oder Tageszeitenschema entsprechend der Eingabe des Nutzers vorzuschlagen.

Uhrzeit von Start und Ende im Uhrzeiten-, Tageszeiten- und Wochentagsschema

  • Im Uhrzeitenschema (timeOfDay), auch in Kombination mit dayOfWeek, muss eine Uhrzeit in boundsPeriod.start oder boundsPeriod.end einer der angegebenen Uhrzeiten entsprechen (TimingBoundsPeriodMatchesTime). Die Uhrzeit wird so verglichen, wie sie angegeben ist; sie ist daher in Ortszeit von Europe/Berlin mit dem passenden Zeitzonenversatz anzugeben, z. B. 2026-06-05T08:00:00+02:00 zu timeOfDay = 08:00:00.
  • Im Tageszeitenschema (when) dürfen boundsPeriod.start und boundsPeriod.end nur ein Datum ohne Uhrzeit enthalten (TimingBoundsPeriodNotForWhen). Tagesabschnitte wie „morgens“ haben keine feste Uhrzeit, mit der ein Startzeitpunkt abgeglichen werden könnte.
  • Im reinen Wochentagsschema (dayOfWeek ohne when und ohne timeOfDay) ist ebenfalls nur ein Datum ohne Uhrzeit zulässig. Eine Wochentagsangabe wie „montags“ legt keine feste Einnahmezeit fest; dafür gilt ebenfalls TimingBoundsPeriodNotForWhen.

Bekannte Einschränkung der Validierung: TimingBoundsPeriodMatchesTime prüft den Zeitzonenversatz nicht. 2026-06-05T06:00:00Z mit timeOfDay = 06:00:00 besteht den Stringvergleich, wird aber als Start um 08:00 Uhr in Europe/Berlin dargestellt. Anwendungen MÜSSEN deshalb für Start und Ende zusätzlich prüfen, ob der angegebene Versatz zur Ortszeit von Europe/Berlin passt. Dabei sind die tatsächlichen Sommer-/Winterzeitregeln zu verwenden, nicht nur eine Monatszuordnung. Eine erfolgreiche Profilvalidierung allein genügt für diesen Nachweis nicht.

Beispiel

{
  "resourceType" : "MedicationRequest",
  "id" : "Example-MR-Dosage-1000-startandenddate",
  "meta" : {
    "profile" : [
      🔗 "http://ig.fhir.de/igs/medication/StructureDefinition/MedicationRequestDgMP"
    ]
  },
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: MedicationRequest Example-MR-Dosage-1000-startandenddate</b></p><a name=\"Example-MR-Dosage-1000-startandenddate\"> </a><a name=\"hcExample-MR-Dosage-1000-startandenddate\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-MedicationRequestDgMP.html\">Medication Request dgMP</a></p></div><p><b>status</b>: Active</p><p><b>intent</b>: Order</p><p><b>medication</b>: <span title=\"Codes:\">Ibuprofen 400mg</span></p><p><b>subject</b>: Patient</p><blockquote><p><b>dosageInstruction</b></p><p><b>timing</b>: Morning, Once</p><h3>DoseAndRates</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Dose[x]</b></td></tr><tr><td style=\"display: none\">*</td><td>1 Stück<span style=\"background: LightGoldenRodYellow\"> (Details: KBV_CS_SFHIR_BMP_DOSIEREINHEIT  code1 = '1')</span></td></tr></table></blockquote></div>"
  },
  "status" : "active",
  "intent" : "order",
  "medicationCodeableConcept" : {
    "text" : "Ibuprofen 400mg"
  },
  "subject" : {
    "display" : "Patient"
  },
  "dosageInstruction" : [
    {
      "timing" : {
        "repeat" : {
          "boundsPeriod" : {
            "start" : "2026-06-05",
            "end" : "2026-07-05"
          },
          "when" : [
            "MORN"
          ]
        }
      },
      "doseAndRate" : [
        {
          "doseQuantity" : {
            "value" : 1,
            "unit" : "Stück",
            "system" : "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BMP_DOSIEREINHEIT",
            "code" : "1"
          }
        }
      ]
    }
  ]
}

Technische Anforderungen

Angabe von Dauer und der Kombination aus Start- und Enddatum ist nicht zulässig sowie Angabe von Dauer und Enddatum ist nicht zulässig

Diese Anforderungen werden durch den FHIR-Standard erfüllt. Das Element bounds[x], was die zeitliche Grenze von einer Dosieranweisung beschreibt ist ein Choice-Datatype, der nur einen Datentypen gleichzeitig zulässt. Damit ist es nicht möglich gleichzeitig die Dauer und konkrete Start und Enddaten einer Medikation auszudrücken.

Eine intendierte Kombination aus Startdatum und Dauer, bspw. "Ab 13.05.2026 für 2 Wochen" muss im Primärsystem berechnet werden und dann mit Start- und Enddatum im Datensatz versehen werden.