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

Schema mit Uhrzeiten-Bezug

Dieses Modell beschreibt die tägliche Anwendung eines Arzneimittels zu konkreten Uhrzeiten.

Im Unterschied zum Schema mit Tageszeiten-Bezug wird hier bewusst eine feste Uhrzeit und nicht nur ein grober Tagesabschnitt angegeben. Es eignet sich vor allem für Arzneimittel, bei denen der genaue Zeitpunkt wichtig ist, etwa um einen möglichst gleichmäßigen Wirkspiegel im Körper zu erreichen.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. TimeSchemeLogical 0..* Base Fachliches Informationsmodell für das Schema mit Uhrzeiten-Bezug
... generierterText 0..1 string Vollständige Dosierungsangabe als für Menschen lesbarer Text, generiert gemäß Dosis Textgenerierung
... dosierungsdetails 1..* Base Strukturierte Angaben zur Dosierung
.... hinweis 0..1 string Ergänzender Anwendungshinweis im Freitext, der sich nicht strukturiert abbilden lässt, aber für die sichere, korrekte oder verständliche Anwendung wichtig ist (z.B. „mit ausreichend Wasser einnehmen“ oder „nicht auf nüchternen Magen“).
.... dosis 1..1 Base Menge des Arzneimittels je Anwendung.
..... wert 1..1 decimal Zahlenwert der Menge; bei einer Bereichsangabe die untere Grenze (z.B. 1).
..... wertBis 0..1 decimal Obere Grenze bei einer Bereichs- oder Obergrenzenangabe (z.B. 2 für „1 bis 2 Tabletten“ oder „bis zu 2 Tabletten“). Bei einem festen Wert bleibt dieses Feld leer.
..... einheit 1..1 Coding Einheit der Menge, z.B. Tablette, Milligramm (mg) oder Milliliter (ml).
Binding: https://fhir.kbv.de/ValueSet/KBV_VS_SFHIR_BMP_DOSIEREINHEIT (required)
.... zeitangaben 0..1 Base Angaben dazu, wann die Dosierung angewendet wird.
..... zeitrahmen 0..1 Base Zeitraum, für den die Dosieranweisung gilt. Er legt fest, ab wann, bis wann oder für wie lange angewendet werden soll, entweder über eine Dauer (z.B. „für eine Woche“) oder über ein Start- und/oder Enddatum.
...... dauer 0..1 Base Dauer der Anwendung. Nicht gleichzeitig mit Start- oder Enddatum anzugeben.
....... wert 1..1 decimal Zahlenwert der Dauer; bei einer Bereichsangabe die untere Grenze (z.B. 1).
....... wertBis 0..1 decimal Obere Grenze bei einer Bereichs- oder Obergrenzenangabe (z.B. 2 für „1 bis 2 Wochen“ oder „bis zu 2 Wochen“).
....... einheit 1..1 Coding Zeiteinheit der Dauer: Tag, Woche oder Monat.
Binding: Duration UnitsOfTime dgMP ValueSet (required)
...... startzeitpunkt 0..1 Base Zeitpunkt, ab dem die Dosierangabe gilt. Kann allein oder gemeinsam mit einem Endzeitpunkt angegeben werden.
....... startdatum 1..1 date Datum, ab dem die Anwendung beginnen soll.
....... startuhrzeit 0..1 time Uhrzeit am Startdatum, falls der Beginn auf die Uhrzeit genau festgelegt werden soll. Nur zusammen mit einem Startdatum zulässig.
...... endzeitpunkt 0..1 Base Zeitpunkt, bis zu dem die Dosierangabe gilt. Kann allein oder gemeinsam mit einem Startzeitpunkt angegeben werden.
....... enddatum 1..1 date Datum, bis zu dem die Anwendung fortgeführt werden soll.
....... enduhrzeit 0..1 time Uhrzeit am Enddatum, falls das Ende auf die Uhrzeit genau festgelegt werden soll. Nur zusammen mit einem Enddatum zulässig.
..... uhrzeiten 1..* time Uhrzeit(en) der Anwendung
.... bedarfsmedikation 0..1 boolean Kennzeichen, dass die Anwendung nur bei tatsächlichem Bedarf erfolgen soll.
.... einnahmeanlass 0..1 string Anlass oder Bedingung, bei der das Arzneimittel im Bedarfsfall angewendet werden soll (z.B. „bei Schmerzen“ oder „bei Fieber über 38,5 °C“).

doco Documentation for this format

Beispiel

{
  "resourceType" : "MedicationRequest",
  "id" : "Example-MR-Dosage-tod-1t-8am",
  "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-tod-1t-8am</b></p><a name=\"Example-MR-Dosage-tod-1t-8am\"> </a><a name=\"hcExample-MR-Dosage-tod-1t-8am\"> </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>: 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" : {
          "timeOfDay" : [
            "08:00:00"
          ]
        }
      },
      "doseAndRate" : [
        {
          "doseQuantity" : {
            "value" : 1,
            "unit" : "Stück",
            "system" : "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BMP_DOSIEREINHEIT",
            "code" : "1"
          }
        }
      ]
    }
  ]
}

Folgende weitere Beispiele sind in diesem IG dargestellt:

Beispiel Beipspiel Datei
1 Stück um 08:00 Uhr Example-MR-Dosage-tod-1t-8am
1 Stück mit unsortierten Zeiten Example-MR-Dosage-tod-unsorted
2 Stück um 12:00 Uhr Example-MR-Dosage-tod-2-12am
8 Uhr 2 Stück - 11 Uhr 1 Stück - 14 Uhr 1 Stück - 17 Uhr 1 Stück - 20 Uhr 1 Stück - 23 Uhr 1 Stück Example-MR-Dosage-tod-multi
8 Uhr 2 Stück - 11 Uhr 1 Stück - 14 Uhr 1 Stück - 17 Uhr 1 Stück - 20 Uhr 1 Stück - 23 Uhr 1 Stück, für 10 Tage Example-MR-Dosage-tod-multi-bound

Angabe und Erkennung der Dosierart

Diese Dosierungsart wird daran erkannt, dass unter Dosage.timing.repeat

  • timeOfDay
  • opt. Angabe von frequency (muss der Anzahl der timeOfDay-Elemente entsprechen)
  • opt. Angabe von period = 1 und periodUnit = d
  • opt. Angabe von bounds[x]

angegeben ist. An diesem Feld wird dann kodiert die Uhrzeit angegeben an der eine konkrete Dosierung einzunehmen ist.

Folgende FHIR-Path Expression auf Ebene von Dosage.timing.repeat liefert die Angabe, ob es sich um das Schema handelt:

timing.repeat.timeOfDay.exists() and
timing.repeat.when.empty() and
timing.repeat.dayOfWeek.empty()

Die tägliche Wiederholung und die Zahl der Gaben ergeben sich bereits aus timeOfDay. Als Legacy-Angaben zulässig sind hier frequency — entsprechend der Anzahl der timeOfDay-Elemente — sowie das Paar period = 1 und periodUnit = d.

Soll das Arzneimittel in derselben Dosierung zu mehreren Uhrzeiten angewandt werden, wird dies über mehrere Angaben von .timeOfDay ausgedrückt. Die angegebene Dosierung ist dann zu jeder der genannten Uhrzeiten anzuwenden.

Beispiel:

  • Dosage.timing.repeat.timeOfDay` = "08:00:00", "12:00:00"
  • Dosage.doseAndRate.doseQuantity = 1 Stück bedeutet, dass eine Stück jeweils um 08:00 und um 12:00 einzunehmen ist.

Lesende Systeme werten entsprechend auch Dosage.timing.repeat aus. Wenn nur .timeOfDay angegeben ist, ist dem Nutzer anzuzeigen, dass die Dosierung nach Uhrzeizen definiert ist.