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
extensionC0..*Extension
modifierExtension?! C0..*Extension
identifier0..*Identifier
statusS Σ ?!1..1codeBinding
modeS Σ ?!1..1codeBinding
titleΣ0..1string
id0..1string
extensionC0..*Extension
id0..1string
extensionC0..*Extension
systemS Σ1..1uriPattern
versionΣ0..1string
codeS Σ1..1codePattern
displayS Σ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
id0..1string
extensionC0..*Extension
referenceS Σ C1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
id0..1string
extensionC0..*Extension
referenceS Σ C1..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
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
flag0..1CodeableConcept
deleted?! C0..1boolean
dateS0..1dateTime
id0..1string
extensionC0..*Extension
referenceS Σ C1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
emptyReasonC0..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-04-08" />
<publisher value="gematik GmbH" />
<description value="Dieses Profil ermöglicht die Zusammenfü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" />
<element id="List.status">
<path value="List.status" />
<short value="(Aktualitäts-)Status der Liste" />
<comment value="Begrü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ü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 value="true" />
<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ü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 value="1" />
<mustSupport value="true" />
</element>
<element id="List.code.coding">
<path value="List.code.coding" />
<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="*" />
<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ündung des Must-Support: Basisinformation" />
<min value="1" />
<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ü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ü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ündung des Must-Support: Nachvollziehbarkeit\n\n Hinweis: nur zulässig im Listenmodus 'working'" />
<mustSupport value="true" />
</element>
<element id="List.entry.item">
<path value="List.entry.item" />
<short value="Referenz auf die MedikationsInformation" />
<comment value="Begründung des Must-Support: Basisinformation (eigentlicher Zweck der Liste ist das Verbinden mehrerer MedikationsInformationen)" />
<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-04-08",
"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",
"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": {
{
"type": "pattern",
"path": "$this"
}
],
"rules": "open"
},
"min": 1,
"mustSupport": true
},
{
"id": "List.code.coding:medications",
"path": "List.code.coding",
"sliceName": "medications",
"min": 1,
"max": "*",
"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",
"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",
"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" />
<profile value="https://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsListe" />
</meta>
<status value="current" />
<mode value="working" />
<system value="http://terminology.hl7.org/CodeSystem/list-example-use-codes" />
<code value="medications" />
</coding>
</code>
<reference value="Patient/PatientinMusterfrau" />
</subject>
<reference value="Encounter/Fachabteilungskontakt" />
</encounter>
<date value="2021-07-04" />
<date value="2021-07-01" />
<reference value="MedicationStatement/ExampleISiKMedikationsInformation1" />
</item>
</entry>
<date value="2021-07-04" />
<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"
},
"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" />
<profile value="https://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsListe" />
</meta>
<status value="current" />
<mode value="working" />
<system value="http://terminology.hl7.org/CodeSystem/list-example-use-codes" />
<code value="medications" />
</coding>
</code>
<reference value="Patient/PatientinMusterfrau" />
</subject>
<reference value="Encounter/Fachabteilungskontakt" />
</encounter>
<date value="2024-02-20" />
<date value="2024-02-20" />
<reference value="MedicationStatement/ExampleISiKMedikationsInformationParkinson1" />
</item>
</entry>
<date value="2024-02-20" />
<reference value="MedicationStatement/ExampleISiKMedikationsInformationParkinson2" />
</item>
</entry>
<date value="2024-02-20" />
<reference value="MedicationStatement/ExampleISiKMedikationsInformationParkinson3" />
</item>
</entry>
<date value="2024-02-20" />
<reference value="MedicationStatement/ExampleISiKMedikationsInformationParkinson4" />
</item>
</entry>
<date value="2024-02-20" />
<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"
},
"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"
}
}
]
}