MedikationsListe (List)


Profil

NameCanonical
ISiKMedikationsListehttps://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsListe

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
identifier0..*Identifier
statusS Σ ?!1..1codeBinding
modeS Σ ?!1..1codeBinding
titleΣ0..1string
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uriPattern
versionΣ0..1string
codeS Σ1..1codePattern
displayS Σ0..1string
userSelectedΣ0..1boolean
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
dateS Σ0..1dateTime
sourceΣ0..1Reference(Practitioner | PractitionerRole | Patient | Device)
orderedBy0..1CodeableConceptBinding
note0..*Annotation
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
flag0..1CodeableConcept
deleted?! I0..1boolean
dateS0..1dateTime
id0..1string
extensionI0..*Extension
referenceS Σ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
emptyReasonI0..1CodeableConceptBinding

Anmerkungen zu Must-Support-Feldern

FeldnameKurzbeschreibungHinweise
List.status(Aktualitäts-)Status der Liste

Begründung des Must-Support: Erforderliche Angabe im FHIR-Standard

List.modeListenmodus

Begründung des Must-Support: Erforderliche Angabe im FHIR-Standard

Beispiel: eingelesene Medikationspläne werden als snapshot repräsentiert. Kontinuierlich fortgeschriebene Listen, z.B. im Rahmen der hausinternen Behandlung, sind als 'working' codiert.

List.codeArt der Liste.

Begründung des Must-Support: Dient der Differenzierung zu anderen Listen.

Hinweis: Es ist mindestens ein Coding mit dem Code 'medications' anzugeben. Weitere Codes, z.B. im Kontext anderer Spezifikationen oder Hauscodierungen sind zulässig.

List.subjectReferenz auf den Patienten

Begründung des Must-Support: Basisinformation

List.encounterReferenz auf den Abteilungskontakt

Begründung des Must-Support: Basisinformation im Krankenhaus-Kontext

List.dateErstellungsdatum der Liste

Begründung des Must-Support: Basisinformation

List.entryListeneintrag
List.entry.dateDatum des Listeneintrags

Begründung des Must-Support: Nachvollziehbarkeit

Hinweis: nur zulässig im Listenmodus 'working'
List.entry.itemReferenz auf die MedikationsInformation

Begründung des Must-Support: Basisinformation (eigentlicher Zweck der Liste ist das Verbinden mehrerer MedikationsInformationen)

Beispiele

Valides Beispiel für das Profil MedikationsListe:

{
    "resourceType": "List",
    "id": "ExampleISiKMedikationsListe",
    "meta": {
        "profile":  [
            "https://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsListe"
        ]
    },
    "code": {
        "coding":  [
            {
                "system": "http://terminology.hl7.org/CodeSystem/list-example-use-codes",
                "code": "medications"
            }
        ]
    },
    "status": "current",
    "mode": "working",
    "subject": {
        "reference": "Patient/PatientinMusterfrau"
    },
    "encounter": {
        "reference": "Encounter/Fachabteilungskontakt"
    },
    "date": "2021-07-04",
    "entry":  [
        {
            "date": "2021-07-01",
            "item": {
                "reference": "MedicationStatement/ExampleISiKMedikationsInformation1"
            }
        },
        {
            "date": "2021-07-04",
            "item": {
                "reference": "MedicationStatement/ExampleISiKMedikationsInformation2"
            }
        }
    ]
}

Beispiel für eine Medikationsliste zur Behandlung von Morbus Parkinson (vgl. auch die vollständige Darstellung unter MedikationsInformation):

{
    "resourceType": "List",
    "id": "ExampleISiKMedikationsListeParkinson",
    "meta": {
        "profile":  [
            "https://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsListe"
        ]
    },
    "code": {
        "coding":  [
            {
                "system": "http://terminology.hl7.org/CodeSystem/list-example-use-codes",
                "code": "medications"
            }
        ]
    },
    "status": "current",
    "mode": "working",
    "subject": {
        "reference": "Patient/PatientinMusterfrau"
    },
    "encounter": {
        "reference": "Encounter/Fachabteilungskontakt"
    },
    "date": "2024-02-20",
    "entry":  [
        {
            "date": "2024-02-20",
            "item": {
                "reference": "MedicationStatement/ExampleISiKMedikationsInformationParkinson1"
            }
        },
        {
            "date": "2024-02-20",
            "item": {
                "reference": "MedicationStatement/ExampleISiKMedikationsInformationParkinson2"
            }
        },
        {
            "date": "2024-02-20",
            "item": {
                "reference": "MedicationStatement/ExampleISiKMedikationsInformationParkinson3"
            }
        },
        {
            "date": "2024-02-20",
            "item": {
                "reference": "MedicationStatement/ExampleISiKMedikationsInformationParkinson4"
            }
        },
        {
            "date": "2024-02-20",
            "item": {
                "reference": "MedicationStatement/ExampleISiKMedikationsInformationParkinson5"
            }
        }
    ]
}

Interaktionen

Für die Ressource List 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]/List?_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]/List?code=http://terminology.hl7.org/CodeSystem/list-example-use-codes|medications

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

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

    Beispiele:

    GET [base]/List?date=2022-03-21

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

  4. Der Suchparameter "encounter" MUSS unterstützt werden:

    Beispiele:

    GET [base]/List?encounter=Encounter/123

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

  5. Der verkettete Suchparameter "encounter.identifier" MUSS unterstützt werden:

    Beispiele:

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

    GET [base]/List?encounter.identifier=7567867

    Use Case Zusammenhang: Um bei einem wiederkehrenden Patienten eine Verwechslung des Falls und damit eine falsche Medikation 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".

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

    Beispiele:

    GET [base]/List?item=MedicationStatement/131415

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

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

    Beispiele:

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

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

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

    Beispiele:

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

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

    Use Case Zusammenhang: Um bei der Medikationsliste eine Verwechslung 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".

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

    Beispiele:

    GET [base]/List?status=current

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