Allergie/Unverträglichkeit (AllergyIntolerance)


Motivation

Die Möglichkeit, auf eine Übersicht der Allergien und Unverträglichkeiten eines Patienten zuzugreifen, ist eine wichtige Funktionen im klinischen Behandlungsablauf. Dies gilt insbesondere, aber nicht ausschließlich, im Bereich der Arzneimitteltherapiesicherheit. Motivierender Use-Case zur Einführung dieser Profile ist die Arzneitmitteltherapiesicherheit im Krankenhaus - AMTS.

In FHIR werden Allergien und Unverträglichkeiten mit der AllergyIntolerance-Ressource repräsentiert.


Kompatibilität

Für das Profil ISiKAllergieUnvertraeglichkeit wird eine Kompatibilität mit folgenden Profilen angestrebt; allerdings kann nicht sichergestellt werden, dass Instanzen, die gegen ISiKAllergieUnvertraeglichkeit valide sind, auch valide sind gegen:

Hinweise zu Inkompatibilitäten können über die Portalseite gemeldet werden.


Profil

NameCanonical
ISiKAllergieUnvertraeglichkeithttps://gematik.de/fhir/isik/StructureDefinition/ISiKAllergieUnvertraeglichkeit

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
identifierΣ0..*Identifier
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uri
versionΣ0..1string
codeS Σ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uri
versionΣ0..1string
codeS Σ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
typeS Σ0..1codeBinding
categoryS Σ0..*codeBinding
criticalityS Σ0..1codeBinding
id0..1string
extensionI0..*Extension
snomed-ctS Σ1..1ISiKSnomedCTCoding
id0..1string
extensionI0..*Extension
systemS Σ1..1uriFixed Value
versionΣ0..1string
codeS Σ1..1code
displayS Σ0..1string
userSelectedΣ0..1boolean
id0..1string
extensionI0..*Extension
systemS Σ1..1uriFixed Value
versionS Σ1..1string
codeS Σ1..1code
displayS Σ0..1string
userSelectedΣ0..1boolean
textS Σ0..1string
patientS Σ I1..1Reference(Patient)
encounterS I0..1Reference(Encounter)
onsetPeriodPeriod
onsetRangeRange
onsetDateTimeS0..1dateTime
onsetAgeS0..1Age
onsetStringS0..1string
recordedDateS0..1dateTime
id0..1string
extensionI0..*Extension
referenceS Σ I0..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayS Σ0..1string
id0..1string
extensionI0..*Extension
referenceS Σ I0..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayS Σ0..1string
lastOccurrence0..1dateTime
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
referenceS Σ I0..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayS Σ0..1string
authorReferenceReference(Practitioner | Patient | RelatedPerson | Organization)
timeS Σ0..1dateTime
textS Σ1..1markdown
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
substance0..1CodeableConcept
id0..1string
extensionI0..*Extension
snomed-ctS Σ0..1ISiKSnomedCTCoding
textS Σ0..1string
description0..1string
onset0..1dateTime
severityS0..1codeBinding
id0..1string
extensionI0..*Extension
snomed-ctS Σ0..1ISiKSnomedCTCoding
textS Σ0..1string
note0..*Annotation


Terminology Bindings


Anmerkungen zu den Must-Support-Feldern

FeldnameKurzbeschreibung
AllergyIntolerance.clinicalStatusklinischer Status
AllergyIntolerance.verificationStatusVerifikationsstatus
AllergyIntolerance.typeType (Allergie oder Unverträglichkeit)
AllergyIntolerance.categoryKategorie
AllergyIntolerance.criticalityKritikalität
AllergyIntolerance.codeBenennung der Allergie/Unverträglichkeit
AllergyIntolerance.patientPatient (Referenz)
AllergyIntolerance.encounterAufenthalt, bei dem die Allergie/Unverträglichkeit festgestellt wurde (nicht notwendigerweise der aktuelle Aufenthalt)
AllergyIntolerance.onset[x]Beginn-Zeitpunkt
AllergyIntolerance.recorderPerson/Rolle, die die Information dokumentiert
AllergyIntolerance.asserterPerson/Rolle, die die Allergie/Unverträglichkeit festgestellt hat
AllergyIntolerance.reactionUnerwünschte Reaktion
AllergyIntolerance.reaction.manifestationManifestation der Reaktion
AllergyIntolerance.reaction.severitySchweregrad der Reaktion
AllergyIntolerance.reaction.exposureRouteExpositionsweg

Interaktionen

Für die Ressource AllergyIntolerance MUSS die REST-Interaktion "READ" 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]/AllergyIntolerance?_id=test

    Anwendungshinweise: Weitere Informationen zur Suche nach "_id" finden sich in der FHIR-Basisspezifikation - Abschnitt "Parameters for all resources".

  2. Der Suchparameter "clinical-status" MUSS unterstützt werden:

    Beispiele:

    GET [base]/AllergyIntolerance?clinical-status=active

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

    Dieser Suchparameter ist für die Umsetzung des IHE QEDm Profils verpflichtend.

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

    Beispiele:

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

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

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

    Beispiele:

    GET [base]/AllergyIntolerance?onset=2015-01-01T12:00:23Z+02:00

    Anwendungshinweise: Weitere Informationen zur Suche nach "AllergyIntolerance.onset[x]" finden sich in der FHIR-Basisspezifikation - Abschnitt "Date Search".

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

    Beispiele:

    GET [base]/AllergyIntolerance?date=2015-01-01T12:00:23Z+02:00

    Anwendungshinweise: Weitere Informationen zur Suche nach "AllergyIntolerance.recordedDate" finden sich in der FHIR-Basisspezifikation - Abschnitt "Date Search".

  6. Der Suchparameter "category" KANN unterstützt werden:

    Beispiele:

    GET [base]/AllergyIntolerance?category=environment

  7. Der Suchparameter "type" KANN unterstützt werden:

    Beispiele:

    GET [base]/AllergyIntolerance?type=allergy


Verkettete Suchparameter (Chaining und Reverse Chaining)

Für Suchparameter vom Typ 'Reference' MÜSSEN die Festlegungen für Chaining und Reverse Chaining verpflichtend implementiert werden. Chaining und Reverse Chaining MUSS für alle Suchparameter über alle Ebenen und Datenobjekte hinweg (potentiell in Kombination) unterstützt werden.

Alle zu unterstützenden verketteten Suchparameter auf den entsprechenden Referenzen sind im CapabilityStatement unter CapabilityStatement.rest.resource.searchInclude bzw. CapabilityStatement.rest.resource.searchRevInclude angegeben. Siehe CapabilityStatement

Weitere Informationen und Beispiele zur Suche nach verketteten Parametern finden sich in diesem IG unter Suchparameter und in der FHIR-Basisspezifikation im Abschnitt "Chained Parameters" und im Abschnitt "Reverse Chaining".

Die verketteten Suchparameter des Profils AllergyIntolerance hängen wie folgt mit den festgelegten Anwendungsfällen (Use Cases) zusammen:

  1. Der verkette Suchparameter AllergyIntolerance:patient unterstüzt den Anwendungsfall:

    Um für einen Patienten eindeutig die zugehörigen Allergien und Intoleranzen identifizieren zu können und eine Fehlbehandlung auszuschließen.

  2. Der verkette Suchparameter AllergyIntolerance:encounter unterstüzt den Anwendungsfall:

    Um einem Kontakt eindeutig als Ursprung einer Allergie-Diagnose zuordnen zu können.


Beispiel

Valides Beispiel Allergie/Unverträglichkeit:

{
    "resourceType": "AllergyIntolerance",
    "id": "ISiKAllergieUnvertraeglichkeitBeispiel1",
    "meta": {
        "profile":  [
            "https://gematik.de/fhir/isik/StructureDefinition/ISiKAllergieUnvertraeglichkeit"
        ]
    },
    "clinicalStatus": {
        "coding":  [
            {
                "code": "active",
                "system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical"
            }
        ]
    },
    "verificationStatus": {
        "coding":  [
            {
                "code": "confirmed",
                "system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-verification"
            }
        ]
    },
    "type": "allergy",
    "category":  [
        "environment"
    ],
    "criticality": "low",
    "code": {
        "coding":  [
            {
                "code": "256262001",
                "system": "http://snomed.info/sct",
                "display": "Betula pendula pollen"
            }
        ]
    },
    "patient": {
        "reference": "Patient/PatientinMusterfrau"
    },
    "onsetDateTime": "1987",
    "recordedDate": "2011-05-12",
    "recorder": {
        "display": "Dr. Martin Mustermann"
    },
    "asserter": {
        "display": "Dr. Berta Beispiel"
    },
    "note":  [
        {
            "authorReference": {
                "reference": "Practitioner/PractitionerWalterArzt"
            },
            "time": "2024-02-20T14:34:12+01:00",
            "text": "Patientin berichtet von einer leichten Verschlimmerung in den letzten 3 Jahren."
        }
    ],
    "reaction":  [
        {
            "manifestation":  [
                {
                    "coding":  [
                        {
                            "code": "162367006",
                            "system": "http://snomed.info/sct",
                            "display": "Sneezing symptom"
                        }
                    ]
                }
            ],
            "severity": "moderate",
            "exposureRoute": {
                "coding":  [
                    {
                        "code": "14910006",
                        "system": "http://snomed.info/sct",
                        "display": "Inspiration"
                    }
                ]
            }
        }
    ]
}