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 Tageszeiten-Bezug

Dieses Modell beschreibt die tägliche Anwendung eines Arzneimittels, ausgerichtet an den Tageszeiten „Morgen“, „Mittag“, „Abend“ und „Nacht“. Es sagt also aus, zu welchen groben Tagesabschnitten und in welcher Menge das Arzneimittel angewendet wird hne eine genaue Uhrzeit festzulegen.

Welcher Zeitraum mit einer Tageszeit konkret gemeint ist, ergibt sich aus dem Tagesablauf der anwendenden Person oder aus einrichtungsinternen Konventionen.

Es ist das in Deutschland gebräuchlichste Dosierschema. Es wird häufig auch „Viererschema“ oder „MMAN-Schema“ genannt und üblicherweise als Kette von vier Zahlen dargestellt (z.B. „1-0-2-0“ für eine Tablette morgens, keine mittags, zwei abends und keine zur Nacht).

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. WhenSchemeLogical 0..* Base Fachliches Informationsmodell für das Schema mit Tageszeiten-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.
..... tageszeiten 1..* Coding Tageszeit(en) der Anwendung, ausgedrückt als morgens | mittags | abends | zur Nacht
Binding: Timing When dgMP (required)
.... 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-1010",
  "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-1010</b></p><a name=\"Example-MR-Dosage-1010\"> </a><a name=\"hcExample-MR-Dosage-1010\"> </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, Evening, 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" : {
          "when" : [
            "MORN",
            "EVE"
          ]
        }
      },
      "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-0-1/2-0 Example-MR-Dosage-10120
1-0-2-0 Example-MR-Dosage-1020
1-0-0-0 Example-MR-Dosage-1000
1-0-1-0 Example-MR-Dosage-1010
1-1-1-1 Example-MR-Dosage-1111
1-0-1-0 für 10 Tage Example-MR-Dosage-1010-10-Days
1-0-1-0 unsortierte Tageszeiten Example-MR-Dosage-1010-Unsorted

Angabe und Erkennung der Dosierart

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

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

angegeben ist. An diesem Feld wird dann kodiert die Tageszeit 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.when.exists() and
timing.repeat.timeOfDay.empty() and
timing.repeat.dayOfWeek.empty()

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

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

Beispiel:

  • Dosage.timing.repeat.when = #MORN, #EVE
  • Dosage.doseAndRate.doseQuantity = 1 Stück bedeutet, dass eine Stück morgens und abends einzunehmen ist.

Lesende Systeme werten entsprechend auch Dosage.timing.repeat aus. Wenn nur .when angegeben ist, ist dem Nutzer das 4-er Schema anzuzeigen.