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 Kombinationen von Zeitintervallen

Dieses Modell beschreibt eine Anwendung in regelmäßigen Abständen, die zusätzlich an Tageszeiten oder eine Uhrzeiten gebunden ist.

Die Häufigkeit ergibt sich aus drei Angaben: Die Frequenz (wie oft) und die Periode (je welchem Zeitraum; mindestens ein Tag) beschreiben, an welchen Tagen das Arzneimittel anzuwenden ist. Die ergänzende Tageszeit oder Uhrzeit legt fest, wann an den vom Intervall betroffenen Tagen das Arzneimittel angewendet werden soll.

Das Modell ist damit eine Kombination des Schemas für wiederkehrende Intervalle mit entweder dem Schema mit Tageszeiten-Bezug oder dem Schema mit Uhrzeiten-Bezug.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. IntervalCombinationSchemeLogical 0..* Base Fachliches Informationsmodell für das Schema für Kombinationen von Zeitintervallen
... 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.
..... haeufigkeit 1..1 Base Häufigkeit der Anwendung: wie oft je Zeitraum eine Dosis angewendet wird (z.B. „jeden zweiten Tag“).
...... anzahl 1..1 Base Wie oft je Periode eine Dosis angewendet wird.
....... wert 1..1 positiveInt Anzahl; bei einer Bereichsangabe die untere Grenze (z.B. 1). Nur ganze Zahlen.
....... wertBis 0..1 positiveInt Obere Grenze bei einer Bereichs- oder Obergrenzenangabe (z.B. 2 für „1 bis 2“ oder „bis zu 2“). Nur ganze Zahlen.
...... periode 1..1 Base Zeitraum, auf den sich die Anzahl bezieht.
....... wert 1..1 decimal Zahlenwert des Zeitraums; bei einer Bereichsangabe die untere Grenze (z.B. 1).
....... wertBis 0..1 decimal Obere Grenze bei einer Bereichsangabe (z.B. 2 für „1 bis 2 Wochen“).
....... einheit 1..1 Coding Zeiteinheit: Tag, Woche oder Monat.
Binding: Period UnitsOfTime dgMP ValueSet (required)
..... uhrzeiten 0..* time Uhrzeit(en) der Anwendung an den vom Intervall betroffenen Tagen. Alternativ zur Tageszeit anzugeben.
..... tageszeiten 0..* Coding Tageszeit(en) an den vom Intervall betroffenen Tagen, ausgedrückt als morgens | mittags | abends | zur Nacht. Alternativ zur Uhrzeit anzugeben.
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-comb-interval-1",
  "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-comb-interval-1</b></p><a name=\"Example-MR-Dosage-comb-interval-1\"> </a><a name=\"hcExample-MR-Dosage-comb-interval-1\"> </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 per 2 days</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><blockquote><p><b>dosageInstruction</b></p><p><b>timing</b>: Once per 2 days</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>2 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" : {
          "period" : 2,
          "periodUnit" : "d",
          "timeOfDay" : [
            "08:00:00"
          ]
        }
      },
      "doseAndRate" : [
        {
          "doseQuantity" : {
            "value" : 1,
            "unit" : "Stück",
            "system" : "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BMP_DOSIEREINHEIT",
            "code" : "1"
          }
        }
      ]
    },
    {
      "timing" : {
        "repeat" : {
          "period" : 2,
          "periodUnit" : "d",
          "timeOfDay" : [
            "18:00:00"
          ]
        }
      },
      "doseAndRate" : [
        {
          "doseQuantity" : {
            "value" : 2,
            "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  
Jeden 2. Tag 1 Stück um 08:00 Uhr und 2 Stück um 18:00 Uhr Example-MR-Dosage-comb-interval-1  
Wöchentlich 1 Stück morgens Example-MR-Dosage-comb-interval-2  
Jeden 2. Tag 1 Stück um 08:00 Uhr und jeden 2. Tag 1 Stück um 08:00 Uhr Example-MR-Dosage-comb-interval-3  
Jeden 2. Tag 1 Stück um 08:00 und 20:00 Uhr sowie 2 Stück um 10:00, 14:00 und 22:00 Uhr (ohne frequency) Example-MR-Dosage-comb-interval-4  

Angabe und Erkennung der Dosierart

Diese Dosierungsart wird daran erkannt, dass folgende Felder unter Dosage.timing.repeat angegeben sind:

  • period
  • periodUnit
  • timeOfDay ODER when
  • opt. Angabe von frequency
  • opt. Angabe von bounds[x]

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

timing.repeat.period.exists() and
timing.repeat.periodUnit.exists() and
timing.repeat.dayOfWeek.empty() and
  (
    (timing.repeat.timeOfDay.exists() and timing.repeat.when.empty()) or
    (timing.repeat.when.exists() and timing.repeat.timeOfDay.empty())
  )

frequency ist in diesem Schema als Legacy-Angabe zulässig. Die Häufigkeit ergibt sich bereits aus den konkreten Werten in when beziehungsweise timeOfDay; eine vorhandene Angabe muss deren Anzahl entsprechen und wird im generierten Text nicht ausgegeben. period und periodUnit sind hier dagegen keine Legacy-Angaben, sondern legen den Rhythmus fest.

Die Regel TimingFreqOrPeriodGtOne, nach der von Frequenz und Periode nur eine größer als 1 sein darf, gilt ausschließlich für reine Intervallangaben ohne Zeitpunkte. Hier legen when beziehungsweise timeOfDay die Zahl der Gaben fest, und eine Periode größer als 1 beschreibt den Abstand der Anwendungstage. Im dgMP-Profil ist die Regel ein Fehler, im generischen Profil TimingDE eine Warnung.

Mit period und periodUnit wird der Einnahmerhythmus festgelegt. when oder timeOfDay ordnet diesem Rhythmus konkrete Tagesabschnitte beziehungsweise Uhrzeiten zu.

Lesende Systeme werten entsprechend auch Dosage.timing.repeat aus. Wenn die oben genannten Felder angegeben sind, ist dem Nutzer anzuzeigen, dass die Dosierung nach einem Einnahmerhythmus mit Tageszeit- oder Uhrzeitbezug definiert ist.