Diagnose (Condition)
ISiKDiagnose
Dieses Profil spezifiziert die Minimalanforderungen für die Bereitstellung von Informationen über die Diagnosen eines Patienten im Rahmen des Bestätigungsverfahrens der gematik.
Motivation
Die Möglichkeit, auf eine Übersicht der Diagnosen eines Patienten zuzugreifen, Patienten anhand ihrer Diagnose zu suchen oder zu prüfen, ob eine konkrete Diagnose bei einem Patienten vorliegt, sind wichtige Funktionen im klinischen Behandlungsablauf.
In FHIR werden Diagnosen mit der Condition-Ressource repräsentiert.
Da die Diagnosen in klinischen Primärsystemen in der Regel in ICD-10-codierter Form vorliegen, fordert ISiK in erster Linie diese Form des Austausches. Falls eine Diagnose zwar dokumentiert, aber noch nicht codiert wurde (z.B. wenn die Kodierung erst nach der Entlassung erfolgt), ist alternativ eine Repräsentation als Freitext-Diagnose möglich.
Kompatibilität
Für das Profil ISiKDiagnose wird eine Kompatibilität mit folgenden Profilen angestrebt; allerdings kann nicht sichergestellt werden, dass Instanzen, die gegen ISiKDiagnose valide sind, auch valide sind gegen:
- das Profil ProfileConditionDiagnose der Medizininformatik-Initative
- das Profil KBV_PR_Base_Condition_Diagnosis der KBV]
Hinweise zu Inkompatibilitäten können über die Portalseite gemeldet werden.
Bestätigungsrelevanz
| Verbindlichkeit | SHALL |
|---|
Metadaten
| Canonical | https://gematik.de/fhir/isik/StructureDefinition/ISiKDiagnose |
|---|---|
| Status | active |
| Version | 5.1.0 |
| Basis | http://hl7.org/fhir/StructureDefinition/Condition |
Inhalt
| ISiKDiagnose (Condition) | C | Condition | |
| id | S Σ | 0..1 | string |
| meta | Σ | 0..1 | Meta |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| versionId | Σ | 0..1 | id |
| lastUpdated | Σ | 0..1 | instant |
| source | Σ | 0..1 | uri |
| profile | Σ | 0..* | canonical(StructureDefinition) |
| security | Σ | 0..* | CodingBinding |
| tag | Σ | 0..* | Coding |
| implicitRules | Σ ?! | 0..1 | uri |
| language | 0..1 | codeBinding | |
| text | 0..1 | Narrative | |
| contained | 0..* | Resource | |
| extension | S C | 0..* | Extension |
| related | S C | 0..1 | Extension(Reference(Condition)) |
| modifierExtension | ?! C | 0..* | Extension |
| identifier | Σ | 0..* | Identifier |
| clinicalStatus | S Σ ?! C | 0..1 | CodeableConceptBinding |
| verificationStatus | Σ ?! C | 0..1 | CodeableConceptBinding |
| category | 0..* | CodeableConceptBinding | |
| severity | 0..1 | CodeableConceptBinding | |
| code | S Σ C | 1..1 | CodeableConcept |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| coding | S Σ | 0..* | Coding |
| ICD-10-GM | S Σ | 0..1 | ISiKICD10GMCodingPattern |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| Mehrfachcodierungs-Kennzeichen | S C | 0..1 | Extension(Coding) |
| Seitenlokalisation | S C | 0..1 | Extension(Coding) |
| Diagnosesicherheit | S C | 0..1 | Extension(Coding) |
| system | S Σ | 1..1 | uriFixed ValuePattern |
| version | S Σ | 1..1 | string |
| code | S Σ C | 1..1 | code |
| display | S Σ | 0..1 | string |
| userSelected | Σ | 0..1 | boolean |
| Alpha-ID | S Σ | 0..1 | CodingAlphaIDPattern |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| system | S Σ | 1..1 | uriFixed ValuePattern |
| version | Σ | 1..1 | string |
| code | S Σ | 1..1 | code |
| display | Σ | 0..1 | string |
| userSelected | Σ | 0..1 | boolean |
| SNOMED-CT | S Σ | 0..1 | ISiKSnomedCTCodingBindingPattern |
| Orphanet | S Σ | 0..1 | CodingPattern |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| system | S Σ | 1..1 | uriPattern |
| version | Σ | 0..1 | string |
| code | Σ | 1..1 | code |
| display | Σ | 0..1 | string |
| userSelected | Σ | 0..1 | boolean |
| text | Σ | 0..1 | string |
| bodySite | S Σ | 0..* | CodeableConcept |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| coding | S Σ | 0..* | Coding |
| snomed-ct | S Σ | 0..1 | ISiKSnomedCTCoding |
| text | Σ | 0..1 | string |
| subject | S Σ | 1..1 | Reference(Patient | Group) |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| reference | S Σ C | 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 | C | 0..* | Extension |
| reference | S Σ C | 1..1 | string |
| type | Σ | 0..1 | uriBinding |
| identifier | Σ | 0..1 | Identifier |
| display | Σ | 0..1 | string |
| onset[x] | S Σ | 0..1 | |
| onsetDateTime | S Σ | 0..1 | dateTime |
| onsetAge | S Σ | 0..1 | Age |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| Lebensphase-Beginn | C | 0..1 | Extension(CodeableConcept) |
| value | Σ | 0..1 | decimal |
| comparator | Σ ?! | 0..1 | codeBinding |
| unit | Σ | 0..1 | string |
| system | Σ C | 0..1 | uri |
| code | Σ | 0..1 | code |
| abatement[x] | S C | 0..1 | |
| abatementAge | S C | 0..1 | Age |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| Lebensphase-Ende | C | 0..1 | Extension(CodeableConcept) |
| value | Σ | 0..1 | decimal |
| comparator | Σ ?! | 0..1 | codeBinding |
| unit | Σ | 0..1 | string |
| system | Σ C | 0..1 | uri |
| code | Σ | 0..1 | code |
| abatementDateTime | S C | 0..1 | dateTime |
| recordedDate | S Σ | 1..1 | dateTime |
| recorder | Σ | 0..1 | Reference(Practitioner | PractitionerRole | Patient | RelatedPerson) |
| asserter | Σ | 0..1 | Reference(Practitioner | PractitionerRole | Patient | RelatedPerson) |
| stage | C | 0..* | BackboneElement |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| modifierExtension | Σ ?! C | 0..* | Extension |
| summary | C | 0..1 | CodeableConcept |
| assessment | C | 0..* | Reference(ClinicalImpression | DiagnosticReport | Observation) |
| type | 0..1 | CodeableConcept | |
| evidence | C | 0..* | BackboneElement |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| modifierExtension | Σ ?! C | 0..* | Extension |
| code | Σ C | 0..* | CodeableConcept |
| detail | Σ C | 0..* | Reference(Resource) |
| note | S | 0..* | Annotation |
Constraints/Invarianten
| Name | Schweregrad | Beschreibung | Ausdruck |
|---|---|---|---|
| isik-con1 | error | Falls eine kodierte Diagnose vorliegt muss angegeben werden durch welchen Kontakt diese Dokumentation erfolgte. | code.coding.exists() implies encounter.exists() |
| icd-text-1 | error | Entweder MUSS eine kodierte Diagnose vorliegen oder eine textuelle Beschreibung. Stattdessen nur Extensions hinzuzufügen (vgl. https://www.hl7.org/fhir/element.html - ele-1), ist explizit nicht erlaubt. | coding.exists().not() implies text.exists() |
Terminology-Bindings
| Element | Staerke | ValueSet |
|---|---|---|
| Condition.code.coding:SNOMED-CT | required | https://gematik.de/fhir/isik/ValueSet/DiagnosesSCT |
Anmerkungen zu Must-Support-Feldern
| Feldname | Kurzbeschreibung | Hinweise |
|---|---|---|
| Condition.id | serverseitige, interne ID des Datensatzes | bedingtes Pflichtfeld/bedingtes MS: Alle von einem Server bereitgestellten Ressourcen MÜSSEN über eine |
| Condition.extension | ||
| Condition.extension:related | Verknüpfte Diagnose | Die Deutschen Kodierrichtlinien und die 'German Modification' ermöglichen es teilweise,
ICD-10-Codierte Diagnosen miteinander zu verknüpfen ("Kreuz-Stern-Ausrufezeichen-Notation"),
diese aber dennoch wie eigenständige Diagnosen (mit jeweils eigener Diagnosesicherheit oder -Lokalisation) zu kommunizieren.
Daher ist es in Deutschland nicht möglich, dem internationalen Usus zu folgen und verknüpfte Diagnosen als postkoordinierten Code einer Condition-Ressource aufzufassen.
Statt dessen müssen sie zwei eigenständige Condition-Ressourcen abgebildet werden, die mit Hilfe der |
| Condition.clinicalStatus | klinischer Status | Begründung MS: Auch in Stufe 4 sind keine (client-seitigen) schreibenden Operationen für das Erstellen einer Condition-Ressource vorgesehen
(siehe CapabilityStatement). Das heißt, entweder führen KISe entsprechende Informationen und exponieren diese,
oder es gibt keinen pragmatischen Mechanismus (im ISIK-Kontext), um den Use Case einer zusätzlichen Annotation mittels Client zu erfüllen.
Da alle KIS-Hersteller, die sich zu Wort gemeldet haben, eine Befüllung von Condition.clinicalStatus NICHT unterstützen,
erscheint das MS nach übergreifender Definition und ein verpflichtender Testfall nicht angemessen. |
| Condition.code | Diagnose-Code | Diagnosen SOLLEN mindestens entweder mit einem der angebenen standardisierten Codier-Verfahren codiert werden.
Ist keine Codierung möglich, MUSS statt dessen eine textuelle Beschreibung der Prozedur angegeben werden. |
| Condition.code.coding | ||
| Condition.code.coding:ICD-10-GM | ||
| Condition.code.coding:ICD-10-GM.extension:Mehrfachcodierungs-Kennzeichen | ||
| Condition.code.coding:ICD-10-GM.extension:Seitenlokalisation | ||
| Condition.code.coding:ICD-10-GM.extension:Diagnosesicherheit | ||
| Condition.code.coding:Alpha-ID | ||
| Condition.code.coding:Alpha-ID.system | ||
| Condition.code.coding:Alpha-ID.code | ||
| Condition.code.coding:SNOMED-CT | ||
| Condition.code.coding:Orphanet | ||
| Condition.code.coding:Orphanet.system | ||
| Condition.bodySite | Körperstelle | Begründung MS: Harmonisierung mit KBV-Profil (KBV_PR_Base_Condition_Diagnosis) |
| Condition.bodySite.coding | ||
| Condition.bodySite.coding:snomed-ct | ||
| Condition.subject | Patientenbezug | Begründung Must-Support: Ein Patientenbezug der Diagnose MUSS stets zum Zwecke der Nachvollziehbarkeit und Datenintegrität vorliegen. |
| Condition.subject.reference | Patienten-Link | Begründung MS: Die Verlinkung auf eine Patienten-Ressource dient der technischen Zuordnung der Dokumentation zu einem Patienten und ermöglicht wichtige API-Funktionen wie verkettete Suche, (Reverse-)Include etc. Im ISik Kontext MUSS die referenzierte Ressource konform zu ISiKPatient sein. Jenseits von ISiK KÖNNEN weitere Instanzen mit anderen Profilen referenziert werden. |
| Condition.encounter | Aufenthaltsbezug | Begründung Must-Support: Ein Aufenthaltsbezug der Diagnose MUSS stets zum Zwecke der Nachvollziehbarkeit und Datenintegrität vorliegen. |
| Condition.encounter.reference | Encounter-Link | Begründung Pflichtfeld: Die Verlinkung auf eine Encounter-Ressource dient der technischen Zuordnung der Dokumentation zu einem Aufenthalt und ermöglicht wichtige API-Funktionen wie verkettete Suche, (Reverse-)Include etc.
WICHTIGER Hinweis für Implementierer: Die Zuordnung MUSS auf einen Encounter der Ebene "Abteilungskontakt" (siehe hierzu Basismodul > UseCases > Abbildung des Konstruktes "Fall") erfolgen. |
| Condition.onset[x] | Erkrankungsbeginn | Datum oder Alter/Lebensphase des Erkrankungsbeginns
Begründung MS: Die Kenntnis des Erkrankungszeitraumes ist wichtig für die korrekte Einschätzung der medizinischen Relevanz einer Erkraknung. |
| Condition.onset[x]:onsetDateTime | Erkrankungsbeginn als Datum | ''Begründung MS:** Siehe onset[x] |
| Condition.onset[x]:onsetAge | Erkrankungsbeginn als Alter | ''Begründung MS:** Siehe onset[x] |
| Condition.abatement[x] | Klinische relevanter Zeitraum Ende | Ende des klinisch relevanten Zeitraums der Diagnose |
| Condition.abatement[x]:abatementAge | Klinische relevanter Zeitraum Ende als Alter | ''Begründung MS:** Siehe abatement[x] |
| Condition.abatement[x]:abatementDateTime | Klinische relevanter Zeitraum Ende als Datum | ''Begründung MS:** Siehe abatement[x] |
| Condition.recordedDate | Dokumentationsdatum | Datum, an dem die Diagnose dokumentiert wurde. |
| Condition.note | Notizen | Ergänzende Hinweise und Anmerkungen zur Diagnose |
Interaktionen
| Interaktion | Verbindlichkeit |
|---|---|
| read | SHALL |
| search-type | SHALL |
| Parameter | Typ | Verbindlichkeit | Hinweise |
|---|---|---|---|
| _id | token | SHALL | Beispiel:
|
| _tag | token | SHALL | Beispiel:
|
| _count | number | SHALL | Beispiel:
|
| _has | string | MAY | Beispiel: Suche nach allen Patienten, die eine Observation mit dem Code '1234-5' haben
|
| clinical-status | token | SHALL | Beispiel: |
| patient | reference | SHALL | Beispiel: |
| subject | reference | MAY | Beispiel: |
| encounter | reference | SHALL | Beispiel: |
| recorded-date | date | SHALL | Beispiel: |
| related | reference | SHALL | Beispiel: |
| category | token | MAY | Beispiel: |
(Reverse-)Include
| Include | ReverseInclude |
|---|---|
| Condition:patient, Condition:subject, Condition:encounter | Encounter:diagnosis |
Beispiele
Beispiel einer Diagnose
| Condition |
| id : Example-condition-kreuz-stern-primaer |
| meta |
| profile : https://gematik.de/fhir/isik/StructureDefinition/ISiKDiagnose |
| clinicalStatus |
| coding |
| system : http://terminology.hl7.org/CodeSystem/condition-clinical |
| code : recurrence |
| code |
| coding |
| extension |
| url : http://fhir.de/StructureDefinition/icd-10-gm-mehrfachcodierungs-kennzeichen |
| value |
| system : http://fhir.de/CodeSystem/icd-10-gm-mehrfachcodierungs-kennzeichen |
| code : † |
| system : http://fhir.de/CodeSystem/bfarm/icd-10-gm |
| version : 2024 |
| code : E10.30 |
| display : Diabetes mellitus, Typ 1: Mit Augenkomplikationen: Nicht als entgleist bezeichnet |
| subject |
| reference : Patient/PatientinMusterfrau |
| encounter |
| reference : Encounter/Fachabteilungskontakt |
| recordedDate : 2021-05-24 |
| note |
| text : Beispiel für eine Anmerkung |