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 für Bedarfsmedikation

Dieses Modell beschreibt die Anwendung eines Arzneimittels nur bei Bedarf, das heißt ausgelöst durch einen konkreten Anlass wie Schmerzen, einen erhöhten Messwert oder einen Risikokontakt. Ein im Voraus festgelegter Anwendungszeitpunkt besteht nicht: Das Arzneimittel wird angewendet, wenn der Anlass eintritt.

Dadurch unterscheidet sich dieses Modell von anderen Schemata, bei denen die Anwendung zwar ebenfalls an den Bedarf angepasst sein kann, im Bedarfsfall aber zu festen Zeitpunkten erfolgt.

Da kein konkreter Anwendungszeitpunkt festgelegt ist, kann festgelegt werden, welcher Mindestabstand zwischen zwei Anwendungen einzuhalten ist und welche Höchstmenge pro Tag nicht überschritten werden darf, um Fehldosierungen zu vermeiden.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PRNSchemeLogical 0..* Base Fachliches Informationsmodell für das Schema Bedarfsmedikation
... 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)
.... maximaldosis 0..1 Base Höchstmenge des Arzneimittels, die innerhalb von 24 Stunden (1 Tag) angewendet werden darf.
..... wert 1..1 decimal Zahlenwert der Höchstmenge (z.B. 6).
..... einheit 1..1 Coding Einheit der Höchstmenge; entspricht der Einheit der Einzeldosis (z.B. Tablette oder mg).
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.
..... mindestabstand 0..1 Base Mindestzeit, die zwischen zwei aufeinanderfolgenden Anwendungen einzuhalten ist.
...... wert 1..1 decimal Zahlenwert des Mindestabstands; 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 Stunden“ oder „bis zu 2 Stunden“).
...... einheit 1..1 Coding Zeiteinheit: Stunde oder Minute.
.... anlass 0..1 string Anlass oder Bedingung, bei deren Auftreten das Arzneimittel 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-Bedarfsmedikation-Kopfschmerzen",
  "meta" : {
    "profile" : [
      🔗 "http://ig.fhir.de/igs/medication/StructureDefinition/MedicationRequestDgMP"
    ]
  },
  "text" : {
    "status" : "extensions",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: MedicationRequest Example-MR-Dosage-Bedarfsmedikation-Kopfschmerzen</b></p><a name=\"Example-MR-Dosage-Bedarfsmedikation-Kopfschmerzen\"> </a><a name=\"hcExample-MR-Dosage-Bedarfsmedikation-Kopfschmerzen\"> </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>Dosage asNeededFor</b>: <span title=\"Codes:\">Kopfschmerzen</span></p><p><b>Minimum Interval Between Administrations</b>: No display for Duration  (value: 4; unit: Stunde(n); system: http://unitsofmeasure.org; code: h)</p><p><b>asNeeded</b>: true</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><p><b>maxDosePerPeriod</b>: 6 Stück<span style=\"background: LightGoldenRodYellow\"> (Details: KBV_CS_SFHIR_BMP_DOSIEREINHEIT  code1 = '1')</span>/24 Stunde(n)<span style=\"background: LightGoldenRodYellow\"> (Details: UCUM  codeh = 'h')</span></p></blockquote></div>"
  },
  "status" : "active",
  "intent" : "order",
  "medicationCodeableConcept" : {
    "text" : "Ibuprofen 400mg"
  },
  "subject" : {
    "display" : "Patient"
  },
  "dosageInstruction" : [
    {
      "extension" : [
        {
          "url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-Dosage.asNeededFor",
          "valueCodeableConcept" : {
            "text" : "Kopfschmerzen"
          }
        }
      ],
      "modifierExtension" : [
        {
          "url" : "http://ig.fhir.de/igs/medication/StructureDefinition/MinimumIntervalBetweenAdministrations",
          "valueDuration" : {
            "value" : 4,
            "unit" : "Stunde(n)",
            "system" : "http://unitsofmeasure.org",
            "code" : "h"
          }
        }
      ],
      "asNeededBoolean" : true,
      "doseAndRate" : [
        {
          "doseQuantity" : {
            "value" : 1,
            "unit" : "Stück",
            "system" : "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BMP_DOSIEREINHEIT",
            "code" : "1"
          }
        }
      ],
      "maxDosePerPeriod" : {
        "numerator" : {
          "value" : 6,
          "unit" : "Stück",
          "system" : "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BMP_DOSIEREINHEIT",
          "code" : "1"
        },
        "denominator" : {
          "value" : 24,
          "unit" : "Stunde(n)",
          "system" : "http://unitsofmeasure.org",
          "code" : "h"
        }
      }
    }
  ]
}

Folgende weitere Beispiele sind in diesem IG dargestellt:

Beispiel Beispiel Datei
Bei Kopfschmerzen: 1 Stück, Mindestabstand 4 Stunden, maximal 6 Stück pro 24 Stunden Example-MR-Dosage-Bedarfsmedikation-Kopfschmerzen

Angabe und Erkennung der Dosierart

Bedarfsangaben können in zwei unterschiedlichen Formen auftreten:

  1. als reine Bedarfsdosierung ohne festes Einnahmeschema
  2. als Bedarfskennzeichnung zu einem bestehenden strukturierten Dosierschema

Eine Bedarfsangabe wird daran erkannt, dass auf Ebene von Dosage

  • asNeededBoolean = true

angegeben ist. Der Anlass extension[asNeededFor] ist optional und beschreibt den Bedarf lediglich näher.

Folgende FHIRPath Expression auf Ebene von Dosage liefert die Angabe, ob es sich grundsätzlich um eine Bedarfsangabe handelt:

asNeeded.ofType(boolean) = true

Reine Bedarfsdosierung

Eine reine Bedarfsdosierung liegt vor, wenn die Dosage-Instanz eine Bedarfsangabe enthält und kein timing angegeben ist.

Folgende FHIRPath Expression auf Ebene von Dosage liefert die Angabe, ob es sich um eine reine Bedarfsdosierung handelt:

asNeeded.ofType(boolean) = true and timing.empty()

Für eine Bedarfsmedikation ist asNeededBoolean = true verpflichtend. Der Anlass asNeededFor ist optional; umgekehrt darf asNeededFor nur bei asNeededBoolean = true angegeben werden.

Der Anlass wird als Freitext in extension[asNeededFor].valueCodeableConcept.text angegeben. Mehrere asNeededFor-Extensions können verwendet werden; sie sind fachlich als ODER-Verknüpfung zu interpretieren.

Bei Verwendung von asNeededFor muss valueCodeableConcept.text befüllt sein.

Bedarfsmedikation als Kennzeichnung eines Dosierschemas

Ist zusätzlich zur Bedarfsangabe ein timing angegeben, handelt es sich nicht um eine reine Bedarfsdosierung. Die Bedarfsangabe kennzeichnet dann ein bestehendes strukturiertes Dosierschema als Bedarfsmedikation, z. B. eine Einnahme bei Bedarf nach einem angegebenen Intervall oder Schema.

Für die konkrete Interpretation der Dosierung gelten in diesem Fall die Regeln des jeweils verwendeten strukturierten Dosierschemas. Lesende Systeme werten asNeededBoolean und extension[asNeededFor] aus und müssen dem Nutzer darstellen, dass das Dosierschema nur bei Bedarf angewendet wird.

Strukturierte Angaben

Die einzunehmende Menge wird wie in den anderen strukturierten Dosierschemata über doseAndRate.doseQuantity angegeben.

Bei einer reinen Bedarfsdosierung wird timing nicht befüllt.

Der Mindestabstand zwischen zwei Gaben wird über die Modifier Extension modifierExtension[MinimumIntervalBetweenAdministrations].valueDuration angegeben.

maxDosePerPeriod kann optional verwendet werden, um eine maximale Menge je Zeitraum anzugeben. Wie der Mindestabstand ist die Angabe der reinen Bedarfsdosierung vorbehalten: Ein strukturierter Rhythmus legt bereits fest, wie viel im Bezugszeitraum angewendet wird. Dabei muss die Einheit im numerator der Einheit von doseAndRate.doseQuantity entsprechen. Als Bezugszeitraum (denominator) ist ausschließlich 24 Stunden (24 h) oder 1 Tag (1 d) zulässig; andere Perioden sind nicht erlaubt. Die Auswahl wird eingabetreu wiedergegeben: 24 h ergibt „in 24 Stunden", 1 d ergibt „pro Tag".

Lesende Systeme werten asNeededBoolean, extension[asNeededFor], modifierExtension[MinimumIntervalBetweenAdministrations] und maxDosePerPeriod aus. Sie müssen dem Nutzer insbesondere Anlass, Mindestabstand und Maximalgabe verständlich darstellen.