ISiKMedikationsListe (List)

Dieses Profil ermöglicht die Zusammenführung einzelner MedikationsInformationen eines Patienten in ISiK Szenarien.

Bestätigungsrelevanz

VerbindlichkeitSHALL

Metadaten

Canonicalhttps://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsListe
Statusactive
Version4.0.3
Basishttp://hl7.org/fhir/StructureDefinition/List

Inhalt

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
<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="ISiKMedikationsListe" />
    <url value="https://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsListe" />
    <version value="4.0.3" />
    <name value="ISiKMedikationsListe" />
    <title value="ISiK Medikationsliste" />
    <status value="active" />
    <experimental value="false" />
    <date value="2025-03-17" />
    <publisher value="gematik GmbH" />
    <description value="Dieses Profil erm&#246;glicht die Zusammenf&#252;hrung einzelner MedikationsInformationen eines Patienten in ISiK Szenarien." />
    <fhirVersion value="4.0.1" />
    <kind value="resource" />
    <abstract value="false" />
    <type value="List" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/List" />
    <derivation value="constraint" />
    <differential>
        <element id="List.status">
            <path value="List.status" />
            <short value="(Aktualit&#228;ts-)Status der Liste" />
            <comment value="Begr&#252;ndung des Must-Support: Erforderliche Angabe im FHIR-Standard" />
            <mustSupport value="true" />
        </element>
        <element id="List.mode">
            <path value="List.mode" />
            <short value="Listenmodus" />
            <comment value="Begr&#252;ndung des Must-Support: Erforderliche Angabe im FHIR-Standard\n\n  Beispiel: eingelesene Medikationspl&#228;ne werden als snapshot repr&#228;sentiert. Kontinuierlich fortgeschriebene Listen, z.B. im Rahmen der hausinternen Behandlung, sind als &#39;working&#39; codiert." />
            <mustSupport value="true" />
            <binding>
                <strength value="required" />
                <valueSet value="https://gematik.de/fhir/isik/ValueSet/MedikationsListeListModeVS" />
            </binding>
        </element>
        <element id="List.code">
            <path value="List.code" />
            <short value="Art der Liste." />
            <comment value="Begr&#252;ndung des Must-Support: Dient der Differenzierung zu anderen Listen.\n\n  Hinweis: Es ist mindestens ein Coding mit dem Code &#39;medications&#39; anzugeben. Weitere Codes, z.B. im Kontext anderer Spezifikationen oder Hauscodierungen sind zul&#228;ssig." />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="List.code.coding">
            <path value="List.code.coding" />
            <slicing>
                <discriminator>
                    <type value="pattern" />
                    <path value="$this" />
                </discriminator>
                <rules value="open" />
            </slicing>
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="List.code.coding:medications">
            <path value="List.code.coding" />
            <sliceName value="medications" />
            <min value="1" />
            <max value="*" />
            <patternCoding>
                <system value="http://terminology.hl7.org/CodeSystem/list-example-use-codes" />
                <code value="medications" />
            </patternCoding>
            <mustSupport value="true" />
        </element>
        <element id="List.code.coding:medications.system">
            <path value="List.code.coding.system" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="List.code.coding:medications.code">
            <path value="List.code.coding.code" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="List.code.coding:medications.display">
            <path value="List.code.coding.display" />
            <mustSupport value="true" />
        </element>
        <element id="List.subject">
            <path value="List.subject" />
            <short value="Referenz auf den Patienten" />
            <comment value="Begr&#252;ndung des Must-Support: Basisinformation" />
            <min value="1" />
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Patient" />
            </type>
            <mustSupport value="true" />
        </element>
        <element id="List.subject.reference">
            <path value="List.subject.reference" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="List.encounter">
            <path value="List.encounter" />
            <short value="Referenz auf den Abteilungskontakt" />
            <comment value="Begr&#252;ndung des Must-Support: Basisinformation im Krankenhaus-Kontext" />
            <mustSupport value="true" />
        </element>
        <element id="List.encounter.reference">
            <path value="List.encounter.reference" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="List.date">
            <path value="List.date" />
            <short value="Erstellungsdatum der Liste" />
            <comment value="Begr&#252;ndung des Must-Support: Basisinformation" />
            <mustSupport value="true" />
        </element>
        <element id="List.entry">
            <path value="List.entry" />
            <short value="Listeneintrag" />
            <mustSupport value="true" />
        </element>
        <element id="List.entry.date">
            <path value="List.entry.date" />
            <short value="Datum des Listeneintrags" />
            <comment value="Begr&#252;ndung des Must-Support: Nachvollziehbarkeit\n\n    Hinweis: nur zul&#228;ssig im Listenmodus &#39;working&#39;" />
            <mustSupport value="true" />
        </element>
        <element id="List.entry.item">
            <path value="List.entry.item" />
            <short value="Referenz auf die MedikationsInformation" />
            <comment value="Begr&#252;ndung des Must-Support: Basisinformation (eigentlicher Zweck der Liste ist das Verbinden mehrerer MedikationsInformationen)" />
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/MedicationStatement" />
            </type>
            <mustSupport value="true" />
        </element>
        <element id="List.entry.item.reference">
            <path value="List.entry.item.reference" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
    </differential>
</StructureDefinition>
{
    "resourceType": "StructureDefinition",
    "id": "ISiKMedikationsListe",
    "url": "https://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsListe",
    "version": "4.0.3",
    "name": "ISiKMedikationsListe",
    "title": "ISiK Medikationsliste",
    "status": "active",
    "experimental": false,
    "date": "2025-03-17",
    "publisher": "gematik GmbH",
    "description": "Dieses Profil ermöglicht die Zusammenführung einzelner MedikationsInformationen eines Patienten in ISiK Szenarien.",
    "fhirVersion": "4.0.1",
    "kind": "resource",
    "abstract": false,
    "type": "List",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/List",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "List.status",
                "path": "List.status",
                "short": "(Aktualitäts-)Status der Liste",
                "comment": "Begründung des Must-Support: Erforderliche Angabe im FHIR-Standard",
                "mustSupport": true
            },
            {
                "id": "List.mode",
                "path": "List.mode",
                "short": "Listenmodus",
                "comment": "Begründung des Must-Support: Erforderliche Angabe im FHIR-Standard\n\n  Beispiel: eingelesene Medikationspläne werden als snapshot repräsentiert. Kontinuierlich fortgeschriebene Listen, z.B. im Rahmen der hausinternen Behandlung, sind als 'working' codiert.",
                "mustSupport": true,
                "binding": {
                    "strength": "required",
                    "valueSet": "https://gematik.de/fhir/isik/ValueSet/MedikationsListeListModeVS"
                }
            },
            {
                "id": "List.code",
                "path": "List.code",
                "short": "Art der Liste.",
                "comment": "Begründung des Must-Support: Dient der Differenzierung zu anderen Listen.\n\n  Hinweis: Es ist mindestens ein Coding mit dem Code 'medications' anzugeben. Weitere Codes, z.B. im Kontext anderer Spezifikationen oder Hauscodierungen sind zulässig.",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "List.code.coding",
                "path": "List.code.coding",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "pattern",
                            "path": "$this"
                        }
                    ],
                    "rules": "open"
                },
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "List.code.coding:medications",
                "path": "List.code.coding",
                "sliceName": "medications",
                "min": 1,
                "max": "*",
                "patternCoding": {
                    "system": "http://terminology.hl7.org/CodeSystem/list-example-use-codes",
                    "code": "medications"
                },
                "mustSupport": true
            },
            {
                "id": "List.code.coding:medications.system",
                "path": "List.code.coding.system",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "List.code.coding:medications.code",
                "path": "List.code.coding.code",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "List.code.coding:medications.display",
                "path": "List.code.coding.display",
                "mustSupport": true
            },
            {
                "id": "List.subject",
                "path": "List.subject",
                "short": "Referenz auf den Patienten",
                "comment": "Begründung des Must-Support: Basisinformation",
                "min": 1,
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/Patient"
                        ]
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "List.subject.reference",
                "path": "List.subject.reference",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "List.encounter",
                "path": "List.encounter",
                "short": "Referenz auf den Abteilungskontakt",
                "comment": "Begründung des Must-Support: Basisinformation im Krankenhaus-Kontext",
                "mustSupport": true
            },
            {
                "id": "List.encounter.reference",
                "path": "List.encounter.reference",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "List.date",
                "path": "List.date",
                "short": "Erstellungsdatum der Liste",
                "comment": "Begründung des Must-Support: Basisinformation",
                "mustSupport": true
            },
            {
                "id": "List.entry",
                "path": "List.entry",
                "short": "Listeneintrag",
                "mustSupport": true
            },
            {
                "id": "List.entry.date",
                "path": "List.entry.date",
                "short": "Datum des Listeneintrags",
                "comment": "Begründung des Must-Support: Nachvollziehbarkeit\n\n    Hinweis: nur zulässig im Listenmodus 'working'",
                "mustSupport": true
            },
            {
                "id": "List.entry.item",
                "path": "List.entry.item",
                "short": "Referenz auf die MedikationsInformation",
                "comment": "Begründung des Must-Support: Basisinformation (eigentlicher Zweck der Liste ist das Verbinden mehrerer MedikationsInformationen)",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/MedicationStatement"
                        ]
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "List.entry.item.reference",
                "path": "List.entry.item.reference",
                "min": 1,
                "mustSupport": true
            }
        ]
    }
}

Constraints/Invarianten

Terminology-Bindings

ElementStaerkeValueSet
List.moderequiredhttps://gematik.de/fhir/isik/ValueSet/MedikationsListeListModeVS

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.code.coding
List.code.coding:medications
List.code.coding:medications.system
List.code.coding:medications.code
List.code.coding:medications.display
List.subjectReferenz auf den Patienten

Begründung des Must-Support: Basisinformation

List.subject.reference
List.encounterReferenz auf den Abteilungskontakt

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

List.encounter.reference
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)

List.entry.item.reference

Interaktionen

InteraktionVerbindlichkeit
createSHALL
readSHALL
updateSHALL
search-typeSHALL
ParameterTypVerbindlichkeit
_idtokenSHALL
codetokenSHALL
datedateSHALL
encounterreferenceSHALL
itemreferenceSHALL
patientreferenceSHALL
statustokenSHALL

(Reverse-)Include

Include
List:patient; List:encounter; List:item

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

Beispiele

ExampleISiKMedikationsListe

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

ExampleISiKMedikationsListeParkinson

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

Command 'pagelink' could not render: Page not found.
):

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