MedikationsVerabreichung (MedicationAdministration)


Profil

NameCanonical
ISiKMedikationsVerabreichunghttps://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsVerabreichung

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
identifier0..*Identifier
instantiatesΣ0..*uri
partOfΣ I0..*Reference(MedicationAdministration | Procedure)
statusS Σ ?!1..1codeBinding
statusReason0..*CodeableConcept
category0..1CodeableConceptBinding
id0..1string
extensionI0..*Extension
PZNS Σ0..1ISiKPZNCodingPattern
ATC-DES Σ0..1ISiKATCCodingPattern
SCTS Σ0..1ISiKSnomedCTCodingPattern
textΣ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
supportingInformationI0..*Reference(Resource)
effectiveDateTimeS Σ0..1dateTime
id0..1string
extensionI0..*Extension
startS Σ I0..1dateTime
endS Σ I0..1dateTime
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
function0..1CodeableConcept
id0..1string
extensionI0..*Extension
referenceS Σ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
reasonCode0..*CodeableConcept
id0..1string
extensionI0..*Extension
referenceS Σ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
requestI0..1Reference(MedicationRequest)
deviceI0..*Reference(Device)
id0..1string
extensionI0..*Extension
authorStringstring
authorReferenceReference(Practitioner | Patient | RelatedPerson | Organization)
timeΣ0..1dateTime
textS Σ1..1markdown
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
textS0..1string
id0..1string
extensionI0..*Extension
SNOMED-CTS Σ0..1ISiKSnomedCTCodingPattern
textS Σ0..1string
id0..1string
extensionI0..*Extension
EDQMS Σ0..1ISiKCodingBindingPattern
SNOMED-CTS Σ0..1ISiKSnomedCTCodingBindingPattern
textS Σ0..1string
method0..1CodeableConcept
doseS I0..1MedicationQuantity
id0..1string
extensionI0..*Extension
numeratorS Σ I1..1MedicationQuantity
denominatorS Σ I1..1MedicationQuantity
rateQuantityS I0..1MedicationQuantity
eventHistoryI0..*Reference(Provenance)


Terminology Bindings

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

Anmerkungen zu Must-Support-Feldern

FeldnameKurzbeschreibungHinweise
MedicationAdministration.statusStatus der Verabreichungsinformation
MedicationAdministration.medication[x]:medicationCodeableConceptMedikament in codierter Form oder ggf. als Freitext

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

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

wird verwendet, wenn detaillierte Informationen zum Medikament vorliegen

MedicationAdministration.subjectReferenz auf den Patienten
MedicationAdministration.contextReferenz auf den Abteilungskontakt
MedicationAdministration.effective[x]:effectiveDateTimeZeitpunkt der Verabreichung
MedicationAdministration.effective[x]:effectivePeriodZeitraum der Verabreichung
MedicationAdministration.performer.actorReferenz auf die verabreichende Person
MedicationAdministration.reasonReferenceGrund der Medikation (Referenz)
MedicationAdministration.note.textFreitext-Notiz
MedicationAdministration.dosageDosierungsangaben
MedicationAdministration.dosage.textFreitext-Dosierungsangabe
MedicationAdministration.dosage.siteKörperstelle der Verabreichung
MedicationAdministration.dosage.routeRoute
MedicationAdministration.dosage.doseverabreichte Dosis
MedicationAdministration.dosage.rate[x]:rateRatioVerabreichungs-Rate (Verhältnis)

Das Must-Support-Flag auf rateRatio bzw. rateQuantity bedeutet, dass produzierende Systeme zur Kodierung der Ratenangaben nach eigenem Ermessen entweder den Datentyp Ratio oder Quantity verwenden können. Beim Empfang und Verarbeitung der eingehenden Daten müssen dagegen beide Datentypen interpretiert werden können.

MedicationAdministration.dosage.rate[x]:rateQuantityVerabreichungs-Rate

Das Must-Support-Flag auf rateRatio bzw. rateQuantity bedeutet, dass produzierende Systeme zur Kodierung der Ratenangaben nach eigenem Ermessen entweder den Datentyp Ratio oder Quantity verwenden können. Beim Empfang und Verarbeitung der eingehenden Daten müssen dagegen beide Datentypen interpretiert werden können.

Beispiele

Valide Beispiele für das Profil MedikationsVerabreichung:

Einfache Einnahme:

{
    "resourceType": "MedicationAdministration",
    "id": "ExampleISiKMedikationsVerabreichung",
    "meta": {
        "profile":  [
            "https://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsVerabreichung"
        ]
    },
    "dosage": {
        "dose": {
            "system": "http://unitsofmeasure.org",
            "value": 1,
            "unit": "Tablette",
            "code": "1"
        }
    },
    "status": "completed",
    "medicationReference": {
        "reference": "Medication/ExampleISiKMedikament1"
    },
    "subject": {
        "reference": "Patient/PatientinMusterfrau"
    },
    "context": {
        "reference": "Encounter/Fachabteilungskontakt"
    },
    "effectiveDateTime": "2021-07-01"
}

Zytostatika-Infusion:

{
    "resourceType": "MedicationAdministration",
    "id": "ExampleISiKMedikationsVerabreichung2",
    "meta": {
        "profile":  [
            "https://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsVerabreichung"
        ]
    },
    "dosage": {
        "dose": {
            "system": "http://unitsofmeasure.org",
            "value": 1,
            "unit": "Beutel",
            "code": "1"
        }
    },
    "status": "completed",
    "medicationReference": {
        "reference": "Medication/ExampleISiKMedikament9"
    },
    "subject": {
        "reference": "Patient/PatientinMusterfrau"
    },
    "context": {
        "reference": "Encounter/Fachabteilungskontakt"
    },
    "effectiveDateTime": "2024-01-22"
}

Verabreichung einer Infusion mit Angabe der Dosierungs-Rate in zwei Varianten (Quantity und Ratio):

{
    "resourceType": "MedicationAdministration",
    "id": "ExampleISiKMedikationsVerabreichung3",
    "meta": {
        "profile":  [
            "https://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsVerabreichung"
        ]
    },
    "dosage": {
        "dose": {
            "system": "http://unitsofmeasure.org",
            "value": 1000,
            "unit": "mL",
            "code": "mL"
        },
        "rateQuantity": {
            "system": "http://unitsofmeasure.org",
            "value": 50,
            "unit": "mL/h",
            "code": "mL/h"
        },
        "text": "1L Infusion mit Rate 50ml/h",
        "site": {
            "coding":  [
                {
                    "code": "6073002",
                    "system": "http://snomed.info/sct",
                    "display": "Structure of ligament of left superior vena cava"
                }
            ]
        },
        "route": {
            "coding":  [
                {
                    "code": "255560000",
                    "system": "http://snomed.info/sct",
                    "display": "Intravenous"
                }
            ]
        }
    },
    "status": "completed",
    "medicationReference": {
        "reference": "Medication-Read-Example"
    },
    "subject": {
        "reference": "Patient/PatientinMusterfrau"
    },
    "context": {
        "reference": "Encounter/Fachabteilungskontakt",
        "identifier": {
            "value": "0123456789"
        }
    },
    "effectiveDateTime": "2021-07-01",
    "note":  [
        {
            "text": "Testnotiz"
        }
    ]
}

{
    "resourceType": "MedicationAdministration",
    "id": "ExampleISiKMedikationsVerabreichung4",
    "meta": {
        "profile":  [
            "https://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsVerabreichung"
        ]
    },
    "dosage": {
        "dose": {
            "system": "http://unitsofmeasure.org",
            "value": 1000,
            "unit": "mL",
            "code": "mL"
        },
        "rateRatio": {
            "numerator": {
                "system": "http://unitsofmeasure.org",
                "value": 50,
                "unit": "mL",
                "code": "mL"
            },
            "denominator": {
                "system": "http://unitsofmeasure.org",
                "value": 1,
                "unit": "h",
                "code": "h"
            }
        },
        "text": "1L Infusion mit Rate 50ml/h",
        "site": {
            "coding":  [
                {
                    "code": "6073002",
                    "system": "http://snomed.info/sct",
                    "display": "Structure of ligament of left superior vena cava"
                }
            ]
        },
        "route": {
            "coding":  [
                {
                    "code": "255560000",
                    "system": "http://snomed.info/sct",
                    "display": "Intravenous"
                }
            ]
        }
    },
    "status": "completed",
    "medicationReference": {
        "reference": "Medication-Read-Example"
    },
    "subject": {
        "reference": "Patient/PatientinMusterfrau"
    },
    "context": {
        "reference": "Encounter/Fachabteilungskontakt",
        "identifier": {
            "value": "0123456789"
        }
    },
    "effectiveDateTime": "2021-07-01",
    "note":  [
        {
            "text": "Testnotiz"
        }
    ]
}

Interaktionen

Für die Ressource MedicationAdministration 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]/MedicationAdministration?_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]/MedicationAdministration?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]/MedicationAdministration?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]/MedicationAdministration?context.identifier=http://mein-krankenhaus.example/fhir/sid/fallnummern|7567867

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

    Use Case Zusammenhang: Um bei einem wiederkehrenden Patienten eine

    Command 'pagelink' could not render: Page not found.
    des Falls und damit eine falsche Verabreichung zu vermeiden.

    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-time" MUSS unterstützt werden:

    Beispiele:

    GET [base]/MedicationAdministration?effective-time=2022-03-23

    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]/MedicationAdministration?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]/MedicationAdministration?medication.code=http://fhir.de/CodeSystem/bfarm/atc|V03AB23

    Use Case Zusammenhang: Um eine

    Command 'pagelink' could not render: Page not found.
    bei der Verabreichung auf Basis des Wirkstoffes zu vermeiden.

    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 "patient" MUSS unterstützt werden:

    Beispiele:

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

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

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

    Beispiele:

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

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

    Use Case Zusammenhang: Um bei der Verabreichung eine

    Command 'pagelink' could not render: Page not found.
    zwischen verschiedenen Patienten vermeiden.

    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".

  10. Der Suchparameter "performer" MUSS unterstützt werden:

    Beispiele:

    GET [base]/MedicationAdministration?performer=Practitioner/101112

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

  11. Der verkettete Suchparameter "performer.identifier" MUSS unterstützt werden:

    Beispiele:

    GET [base]/MedicationAdministration?performer.identifier=http://fhir.de/sid/bundesaerztekammer/efn|123456789123456

    GET [base]/MedicationAdministration?performer.identifier=123456789123456

    Use Case Zusammenhang: Um mich als Heilberufler über die

    Command 'pagelink' could not render: Page not found.
    meiner Medikationsverabreichungen zur informieren.

    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".

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

    Beispiele:

    GET [base]/MedicationRequest?status=completed

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