ISiKMedikationsListe (List)
ISiK Medikationsliste
Dieses Profil ermöglicht die Zusammenführung einzelner MedikationsInformationen eines Patienten in ISiK Szenarien.
Bestätigungsrelevanz
Verbindlichkeit | SHALL |
---|
Metadaten
Canonical | https://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsListe |
---|---|
Status | active |
Version | 4.0.3 |
Basis | http://hl7.org/fhir/StructureDefinition/List |
Inhalt
ISiKMedikationsListe (List) | I | List | |
id | Σ | 0..1 | string |
meta | Σ | 0..1 | Meta |
implicitRules | Σ ?! | 0..1 | uri |
language | 0..1 | codeBinding | |
text | 0..1 | Narrative | |
contained | 0..* | Resource | |
extension | I | 0..* | Extension |
modifierExtension | ?! I | 0..* | Extension |
identifier | 0..* | Identifier | |
status | S Σ ?! | 1..1 | codeBinding |
mode | S Σ ?! | 1..1 | codeBinding |
title | Σ | 0..1 | string |
code | S Σ | 1..1 | CodeableConcept |
id | 0..1 | string | |
extension | I | 0..* | Extension |
coding | S Σ | 1..* | Coding |
medications | S Σ | 1..* | CodingPattern |
id | 0..1 | string | |
extension | I | 0..* | Extension |
system | S Σ | 1..1 | uriPattern |
version | Σ | 0..1 | string |
code | S Σ | 1..1 | codePattern |
display | S Σ | 0..1 | string |
userSelected | Σ | 0..1 | boolean |
text | Σ | 0..1 | string |
subject | S Σ | 1..1 | Reference(Patient) |
id | 0..1 | string | |
extension | I | 0..* | Extension |
reference | S Σ I | 1..1 | string |
type | Σ | 0..1 | uriBinding |
identifier | Σ | 0..1 | Identifier |
display | Σ | 0..1 | string |
encounter | S | 0..1 | Reference(Encounter) |
id | 0..1 | string | |
extension | I | 0..* | Extension |
reference | S Σ I | 1..1 | string |
type | Σ | 0..1 | uriBinding |
identifier | Σ | 0..1 | Identifier |
display | Σ | 0..1 | string |
date | S Σ | 0..1 | dateTime |
source | Σ | 0..1 | Reference(Practitioner | PractitionerRole | Patient | Device) |
orderedBy | 0..1 | CodeableConceptBinding | |
note | 0..* | Annotation | |
entry | S I | 0..* | BackboneElement |
id | 0..1 | string | |
extension | I | 0..* | Extension |
modifierExtension | Σ ?! I | 0..* | Extension |
flag | 0..1 | CodeableConcept | |
deleted | ?! I | 0..1 | boolean |
date | S | 0..1 | dateTime |
item | S | 1..1 | Reference(MedicationStatement) |
id | 0..1 | string | |
extension | I | 0..* | Extension |
reference | S Σ I | 1..1 | string |
type | Σ | 0..1 | uriBinding |
identifier | Σ | 0..1 | Identifier |
display | Σ | 0..1 | string |
emptyReason | I | 0..1 | CodeableConceptBinding |
<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ö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" /> <differential> <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" /> <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ü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" /> <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ü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ü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)" /> <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
Element | Staerke | ValueSet |
---|---|---|
List.mode | required | https://gematik.de/fhir/isik/ValueSet/MedikationsListeListModeVS |
Anmerkungen zu Must-Support-Feldern
Feldname | Kurzbeschreibung | Hinweise |
---|---|---|
List.status | (Aktualitäts-)Status der Liste | Begründung des Must-Support: Erforderliche Angabe im FHIR-Standard |
List.mode | Listenmodus | 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.code | Art 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.subject | Referenz auf den Patienten | Begründung des Must-Support: Basisinformation |
List.subject.reference | ||
List.encounter | Referenz auf den Abteilungskontakt | Begründung des Must-Support: Basisinformation im Krankenhaus-Kontext |
List.encounter.reference | ||
List.date | Erstellungsdatum der Liste | Begründung des Must-Support: Basisinformation |
List.entry | Listeneintrag | |
List.entry.date | Datum des Listeneintrags | Begründung des Must-Support: Nachvollziehbarkeit
|
List.entry.item | Referenz auf die MedikationsInformation | Begründung des Must-Support: Basisinformation (eigentlicher Zweck der Liste ist das Verbinden mehrerer MedikationsInformationen) |
List.entry.item.reference |
Interaktionen
Interaktion | Verbindlichkeit |
---|---|
create | SHALL |
read | SHALL |
update | SHALL |
search-type | SHALL |
Parameter | Typ | Verbindlichkeit |
---|---|---|
_id | token | SHALL |
code | token | SHALL |
date | date | SHALL |
encounter | reference | SHALL |
item | reference | SHALL |
patient | reference | SHALL |
status | token | SHALL |
(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:
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".
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".
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".
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".
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".
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".
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".
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".
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 |
id : ExampleISiKMedikationsListe |
meta |
profile : https://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsListe |
status : current |
mode : working |
code |
coding |
system : http://terminology.hl7.org/CodeSystem/list-example-use-codes |
code : medications |
subject |
reference : Patient/PatientinMusterfrau |
encounter |
reference : Encounter/Fachabteilungskontakt |
date : 2021-07-04 |
entry |
date : 2021-07-01 |
item |
reference : MedicationStatement/ExampleISiKMedikationsInformation1 |
entry |
date : 2021-07-04 |
item |
reference : MedicationStatement/ExampleISiKMedikationsInformation2 |
<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
List |
id : ExampleISiKMedikationsListeParkinson |
meta |
profile : https://gematik.de/fhir/isik/StructureDefinition/ISiKMedikationsListe |
status : current |
mode : working |
code |
coding |
system : http://terminology.hl7.org/CodeSystem/list-example-use-codes |
code : medications |
subject |
reference : Patient/PatientinMusterfrau |
encounter |
reference : Encounter/Fachabteilungskontakt |
date : 2024-02-20 |
entry |
date : 2024-02-20 |
item |
reference : MedicationStatement/ExampleISiKMedikationsInformationParkinson1 |
entry |
date : 2024-02-20 |
item |
reference : MedicationStatement/ExampleISiKMedikationsInformationParkinson2 |
entry |
date : 2024-02-20 |
item |
reference : MedicationStatement/ExampleISiKMedikationsInformationParkinson3 |
entry |
date : 2024-02-20 |
item |
reference : MedicationStatement/ExampleISiKMedikationsInformationParkinson4 |
entry |
date : 2024-02-20 |
item |
reference : MedicationStatement/ExampleISiKMedikationsInformationParkinson5 |
<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" } } ] }