MedikationsInformation (MedicationStatement)


Profil

NameCanonical
ISiKMedikationsInformationhttps://gematik.de/fhir/isik/v2/Medikation/StructureDefinition/ISiKMedikationsInformation

idS Σ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
identifierΣ0..*Identifier
basedOnΣ I0..*Reference(MedicationRequest | CarePlan | ServiceRequest)
partOfΣ I0..*Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Observation)
statusS Σ ?!1..1codeBinding
statusReason0..*CodeableConcept
categoryΣ0..1CodeableConceptBinding
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uriPattern
versionΣ0..1string
codeS Σ1..1code
displayS Σ0..1string
userSelectedΣ0..1boolean
id0..1string
extensionI0..*Extension
systemS Σ1..1uriPattern
versionΣ0..1string
codeS Σ1..1code
displayS Σ0..1string
userSelectedΣ0..1boolean
id0..1string
extensionI0..*Extension
systemS Σ1..1uriPattern
versionΣ0..1string
codeS Σ1..1code
displayS Σ0..1string
userSelectedΣ0..1boolean
textS Σ0..1string
id0..1string
extensionI0..*Extension
referenceS Σ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
id0..1string
extensionI0..*Extension
referenceS Σ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
id0..1string
extensionI0..*Extension
referenceS Σ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
effectiveDateTimeS Σ0..1dateTime
id0..1string
extensionI0..*Extension
startS Σ I0..1dateTime
endS Σ I0..1dateTime
dateAssertedS Σ0..1dateTime
informationSourceI0..1Reference(Patient | Practitioner | PractitionerRole | RelatedPerson | Organization)
derivedFromI0..*Reference(Resource)
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uri
versionΣ0..1string
codeS Σ1..1code
displayS Σ0..1string
userSelectedΣ0..1boolean
textS Σ0..1string
id0..1string
extensionI0..*Extension
referenceS Σ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
id0..1string
extensionI0..*Extension
authorStringstring
authorReferenceReference(Practitioner | Patient | RelatedPerson | Organization)
timeΣ0..1dateTime
textS Σ1..1markdown
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
sequenceΣ0..1integer
textS Σ0..1string
additionalInstructionΣ0..*CodeableConcept
patientInstructionS Σ0..1string
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
eventS Σ0..*dateTime
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..1codeBinding
unitS Σ0..1string
systemS Σ I1..1uriPattern
codeS Σ1..1code
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..0codeBinding
unitS Σ0..1string
systemS Σ I1..1uriPattern
codeS Σ1..1code
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..0codeBinding
unitS Σ0..1string
systemS Σ I1..1uriPattern
codeS Σ1..1code
id0..1string
extensionI0..*Extension
startS Σ I0..1dateTime
endS Σ I0..1dateTime
countS Σ0..1positiveInt
countMaxS Σ0..1positiveInt
durationS Σ0..1decimal
durationMaxS Σ0..1decimal
durationUnitS Σ0..1codeBinding
frequencyS Σ0..1positiveInt
frequencyMaxS Σ0..1positiveInt
periodS Σ0..1decimal
periodMaxS Σ0..1decimal
periodUnitS Σ0..1codeBinding
dayOfWeekS Σ0..*codeBinding
timeOfDayS Σ0..*time
whenS Σ0..*codeBinding
offsetS Σ0..1unsignedInt
codeΣ0..1CodeableConceptBinding
asNeededCodeableConceptCodeableConcept
asNeededBooleanS Σ0..1boolean
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uriPattern
versionΣ0..1string
codeS Σ1..1code
displayS Σ0..1string
userSelectedΣ0..1boolean
textS Σ0..1string
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uriPattern
versionΣ0..1string
codeS Σ1..1code
displayS Σ0..1string
userSelectedΣ0..1boolean
id0..1string
extensionI0..*Extension
systemS Σ1..1uriPattern
versionΣ0..1string
codeS Σ1..1code
displayS Σ0..1string
userSelectedΣ0..1boolean
textS Σ0..1string
methodΣ0..1CodeableConcept
id0..1string
extensionI0..*Extension
typeΣ0..1CodeableConcept
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..0codeBinding
unitS Σ0..1string
systemS Σ I1..1uriPattern
codeS Σ1..1code
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..0codeBinding
unitS Σ0..1string
systemS Σ I1..1uriPattern
codeS Σ1..1code
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..0codeBinding
unitS Σ0..1string
systemS Σ I1..1uriPattern
codeS Σ1..1code
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..1codeBinding
unitS Σ0..1string
systemS Σ I1..1uriPattern
codeS Σ1..1code
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..1codeBinding
unitS Σ0..1string
systemS Σ I1..1uriPattern
codeS Σ1..1code
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..0codeBinding
unitS Σ0..1string
systemS Σ I1..1uriPattern
codeS Σ1..1code
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..0codeBinding
unitS Σ0..1string
systemS Σ I1..1uriPattern
codeS Σ1..1code
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..0codeBinding
unitS Σ0..1string
systemS Σ I1..1uriPattern
codeS Σ1..1code
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..1codeBinding
unitS Σ0..1string
systemS Σ I1..1uriPattern
codeS Σ1..1code
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..1codeBinding
unitS Σ0..1string
systemS Σ I1..1uriPattern
codeS Σ1..1code
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..0codeBinding
unitS Σ0..1string
systemS Σ I1..1uriPattern
codeS Σ1..1code
maxDosePerLifetimeΣ I0..1SimpleQuantity


Terminology Bindings

PathNameStrengthURL
MedicationStatement.dosage.route.codingmedicine-route-of-administrationrequiredhttp://hl7.org/fhir/uv/ips/ValueSet/medicine-route-of-administration
MedicationStatement.dosage.route.codingSctRouteOfAdministrationrequiredhttps://gematik.de/fhir/isik/v2/Medikation/ValueSet/SctRouteOfAdministration

Anmerkungen zu Must-Support-Feldern

FeldnameKurzbeschreibungHinweise
MedicationStatement.ideindeutige ID der Ressource auf dem Server
MedicationStatement.statusStatus der Medikationsinformation
MedicationStatement.medication[x]:medicationCodeableConceptMedikament in codierter Form oder ggf. als Freitext

kann verwendet werden, wenn keine detaillierten Informationen zum Medikament (z.B. Rezepturen) existieren.

MedicationStatement.medication[x]:medicationReferenceReferenz auf das Medikament (Medication-Ressource)

wird verwendet, wenn detaillierte Informationen zum Medikament vorliegen

MedicationStatement.subjectReferenz auf den Patienten
MedicationStatement.contextReferenz auf den Abteilungskontakt
MedicationStatement.effective[x]Zeitpunkt oder Zeitraum, für den die MedikationsInformation gilt
MedicationStatement.effective[x]:effectiveDateTimeZeitpunkt
MedicationStatement.effective[x]:effectivePeriodZeitraum
MedicationStatement.dateAssertedDatum der Feststellung/des Bekanntwerdens der MedikationsInformation
MedicationStatement.reasonCodeGrund der Medikation (codiert)
MedicationStatement.reasonReferenceGrund der Medikation (Referenz)
MedicationStatement.note.textFreitext-Notiz
MedicationStatement.dosageDosierungsangaben
MedicationStatement.dosage.textFreitext-Dosierungsanweisungen

Festlegung zum Must-Support: Die Verarbeitung MUSS unterstützt werden, indem empfangende Systeme die Freitext-Dosierungsinformation entweder direkt in der Textform persistieren, ODER die Informationen in eine alternative (strukturierte) Form umwandeln (ggf. unter Einwirkung geeigneter Nutzer). Im letzteren Fall KANN auf eine Persistierung in Textform verzichtet werden, um Inkonsistenzen zu vermeiden.

Ein System KANN jedoch strukturierte Dosierungsinformationen in Freitext-Dosierungsinformationen umwandeln, um sie in einem Dokument oder einer Benutzeroberfläche anzuzeigen - dabei ist auf Konsistenzwahrung zu allen strukturierten Elementen zu achten.

Hinweis: Diese Festlegung folgt und spezifiziert folgende MS-Festlegung aus dem ISiK Basismodul: 'Systeme KÖNNEN es darüber hinaus ermöglichen, dass die jeweiligen Informationen vom Anwender ergänzt oder editiert werden.'

Zum Beispiel könnte ein empfangendes System die Freitext-Dosierungsinformation in strukturierte Dosierungsinformation umwandeln, um sie in einer Medikationsverwaltung anzuzeigen oder später zu exponieren. Geht es zum Beispiel um eine Angabe zu Tageszeiten der Einnahme in der freitextlichen Dosierungsinformation als 'Morgens, Mittags, Abends', so könnte das empfangende System diese Angabe in strukturierte Dosierungsinformationen umwandeln, die die Einnahmezeiten in kodierter Form mit 'MORN', 'NOON', 'EVE' deklariert.

MedicationStatement.dosage.patientInstructionbesondere Anweisungen für den Patienten
MedicationStatement.dosage.timingAngaben zum Timing
MedicationStatement.dosage.timing.eventfester Zeitpunkt
MedicationStatement.dosage.timing.repeatWiederholungs-Angaben
MedicationStatement.dosage.timing.repeat.bounds[x]:boundsDurationBegrenzung der Dauer
MedicationStatement.dosage.timing.repeat.bounds[x]:boundsRangeBereich für die Begrenzung
MedicationStatement.dosage.timing.repeat.bounds[x]:boundsPeriodbegrenzender Zeitraum
MedicationStatement.dosage.timing.repeat.countAnzahl Wiederholungen
MedicationStatement.dosage.timing.repeat.countMaxmaximale Anzahl Wiederholungen
MedicationStatement.dosage.timing.repeat.durationDauer der Verabreichung
MedicationStatement.dosage.timing.repeat.durationMaxmaximale Dauer der Verabreichung
MedicationStatement.dosage.timing.repeat.durationUnitEinheit der Dauer
MedicationStatement.dosage.timing.repeat.frequencyFrequenz (Anzahl der Gaben pro Periode)
MedicationStatement.dosage.timing.repeat.frequencyMaxmaximale Frequenz
MedicationStatement.dosage.timing.repeat.periodZeitperiode zur Frequenz
MedicationStatement.dosage.timing.repeat.periodMaxmaximale Zeitperiode zur Frequenz
MedicationStatement.dosage.timing.repeat.periodUnitEinheit der Zeitperiode
MedicationStatement.dosage.timing.repeat.dayOfWeekWochentag
MedicationStatement.dosage.timing.repeat.timeOfDayTageszeit
MedicationStatement.dosage.timing.repeat.whenTageszeitpunkt codiert
MedicationStatement.dosage.timing.repeat.offsetzeitlicher Abstand der Gabe zum beschriebenen Zeitpunkt
MedicationStatement.dosage.asNeeded[x]:asNeededBooleanBedarfsmedikation
MedicationStatement.dosage.siteKörperstelle der Verabreichung
MedicationStatement.dosage.routeRoute
MedicationStatement.dosage.doseAndRateAngaben zu Dosis und Rate
MedicationStatement.dosage.doseAndRate.dose[x]:doseRangeDosisbereich
MedicationStatement.dosage.doseAndRate.dose[x]:doseQuantityDosis
MedicationStatement.dosage.doseAndRate.rate[x]:rateRatioRaten-Verhältnis
MedicationStatement.dosage.doseAndRate.rate[x]:rateRangeRaten-Bereich
MedicationStatement.dosage.doseAndRate.rate[x]:rateQuantityRate
MedicationStatement.dosage.maxDosePerPeriodMaximaldosis (Zähler) pro Zeitraum (Nenner)
MedicationStatement.dosage.maxDosePerAdministrationMaximaldosis pro Verabreichung

Beispiele

Valide Beispiele für das Profil MedikationsInformation:

{
    "resourceType": "MedicationStatement",
    "id": "ExampleISiKMedikationsInformation1",
    "meta": {
        "profile":  [
            "https://gematik.de/fhir/isik/v2/Medikation/StructureDefinition/ISiKMedikationsInformation"
        ]
    },
    "dosage":  [
        {
            "doseAndRate":  [
                {
                    "doseQuantity": {
                        "system": "http://unitsofmeasure.org",
                        "value": 1,
                        "unit": "Brausetablette",
                        "code": "1"
                    }
                }
            ],
            "timing": {
                "repeat": {
                    "when":  [
                        "MORN",
                        "NOON",
                        "EVE"
                    ]
                }
            }
        }
    ],
    "status": "active",
    "medicationReference": {
        "reference": "Medication/ExampleISiKMedikament1"
    },
    "subject": {
        "reference": "Patient/PatientinMusterfrau"
    },
    "context": {
        "reference": "Encounter/Versorgungsstellenkontakt"
    },
    "effectivePeriod": {
        "start": "2021-07-01"
    },
    "dateAsserted": "2021-07-01",
    "reasonReference":  [
        {
            "reference": "Condition/BehandlungsDiagnoseFreitext"
        }
    ]
}

{
    "resourceType": "MedicationStatement",
    "id": "ExampleISiKMedikationsInformation2",
    "meta": {
        "profile":  [
            "https://gematik.de/fhir/isik/v2/Medikation/StructureDefinition/ISiKMedikationsInformation"
        ]
    },
    "dosage":  [
        {
            "doseAndRate":  [
                {
                    "doseQuantity": {
                        "system": "http://unitsofmeasure.org",
                        "value": 100,
                        "unit": "mg",
                        "code": "mg"
                    }
                }
            ],
            "timing": {
                "repeat": {
                    "count": 6,
                    "frequency": 1,
                    "period": 3,
                    "periodUnit": "wk"
                }
            }
        }
    ],
    "status": "active",
    "medicationReference": {
        "reference": "Medication/ExampleISiKMedikament2"
    },
    "subject": {
        "reference": "Patient/PatientinMusterfrau"
    },
    "context": {
        "reference": "Encounter/Versorgungsstellenkontakt"
    },
    "effectivePeriod": {
        "start": "2021-07-04"
    },
    "dateAsserted": "2021-07-03"
}

Interaktionen

Für die Ressource MedicationStatement MÜSSEN die REST-Interaktionen "READ", "CREATE" und "UPDATE" implementiert werden.

Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Kombination:

  1. Der Suchparameter "_id" MUSS unterstützt werden:

    Beispiele:

    GET [base]/MedicationStatement?_id=103270

    Anwendungshinweise: Weitere Informationen zur Suche nach "_id" finden sich in der FHIR-Basisspezifikation - Abschnitt "Parameters for all resources".

  2. Der Suchparameter "code" MUSS unterstützt werden:

    Beispiele:

    GET [base]/MedicationStatement?code=http://fhir.de/CodeSystem/bfarm/atc|V03AB23

    Anwendungshinweise: Weitere Informationen zur Suche nach Token-type Parametern finden sich in der FHIR-Basisspezifikation - Abschnitt "Token Search".

  3. Der Suchparameter "context" MUSS unterstützt werden:

    Beispiele:

    GET [base]/MedicationStatement?context=Encounter/123

    Anwendungshinweise: Weitere Informationen zur Suche nach Reference-type Parametern finden sich in der FHIR-Basisspezifikation - Abschnitt "Reference Search".

  4. Der verkettete Suchparameter "context.identifier" MUSS unterstützt werden:

    Beispiele:

    GET [base]/MedicationStatement?context.identifier=http://mein-krankenhaus.example/fhir/sid/fallnummern|7567867

    GET [base]/MedicationStatement?context.identifier=7567867

    Anwendungshinweise: Weitere Informationen zur Suche nach Reference-type Parametern finden sich in der FHIR-Basisspezifikation - Abschnitt "Reference Search".

    Weitere Informationen zur Suche nach verketteten Parametern finden sich in der FHIR-Basisspezifikation - Abschnitt "Chained Parameters".

  5. Der Suchparameter "effective" MUSS unterstützt werden:

    Beispiele:

    GET [base]/MedicationStatement?effective=2022-03-21

    Anwendungshinweise: Weitere Informationen zur Suche nach Date-type Parametern finden sich in der FHIR-Basisspezifikation - Abschnitt "Date".

  6. Der Suchparameter "medication" MUSS unterstützt werden:

    Beispiele:

    GET [base]/MedicationStatement?medication=Medication/123

    Anwendungshinweise: Weitere Informationen zur Suche nach Reference-type Parametern finden sich in der FHIR-Basisspezifikation - Abschnitt "Reference Search".

  7. Der verkettete Suchparameter "medication.code" MUSS unterstützt werden:

    Beispiele:

    GET [base]/MedicationStatement?medication.code=http://fhir.de/CodeSystem/bfarm/atc|V03AB23

    Anwendungshinweise: Weitere Informationen zur Suche nach Token-type Parametern finden sich in der FHIR-Basisspezifikation - Abschnitt "Token Search".

    Weitere Informationen zur Suche nach verketteten Parametern finden sich in der FHIR-Basisspezifikation - Abschnitt "Chained Parameters".

  8. Der Suchparameter "part-of" MUSS unterstützt werden:

    Beispiele:

    GET [base]/MedicationStatement?part-of=MedicationAdministration/789

    Anwendungshinweise: Weitere Informationen zur Suche nach Reference-type Parametern finden sich in der FHIR-Basisspezifikation - Abschnitt "Reference Search".

  9. Der Suchparameter "patient" MUSS unterstützt werden:

    Beispiele:

    GET [base]/MedicationStatement?patient=Patient/123

    Anwendungshinweise: Weitere Informationen zur Suche nach Reference-type Parametern finden sich in der FHIR-Basisspezifikation - Abschnitt "Reference Search".

  10. Der verkettete Suchparameter "patient.identifier" MUSS unterstützt werden:

    Beispiele:

    GET [base]/MedicationStatement?patient.identifier=http://mein-krankenhaus.example/fhir/sid/patienten|1032702

    GET [base]/MedicationStatement?patient.identifier=1032702

    Anwendungshinweise: Weitere Informationen zur Suche nach Token-type Parametern finden sich in der FHIR-Basisspezifikation - Abschnitt "Token Search".

    Weitere Informationen zur Suche nach verketteten Parametern finden sich in der FHIR-Basisspezifikation - Abschnitt "Chained Parameters".

  11. Der Suchparameter "status" MUSS unterstützt werden:

    Beispiele:

    GET [base]/MedicationStatement?status=active

    Anwendungshinweise: Weitere Informationen zur Suche nach Token-type Parametern finden sich in der FHIR-Basisspezifikation - Abschnitt "Token Search".