Basisprofil für ISiKLebensZustand Observation

Motivation

Viele medizinischen Entscheidungen benötigen Informationen zu den Lebensumständen eines Patienten. Hierzu gehören eine aktuelle Schwangerschaft, Raucherstatus sowie der Alkoholabususstatus. Motivierender Use-Case zur Einführung dieser Profile ist die Arzneitmitteltherapiesicherheit im Krankenhaus - AMTS.

In FHIR werden Untersuchungen, bzw. Beobachtungen als Observation-Ressource repräsentiert.

Dieses Profil ist eine generische, ISiK-spezifische Observation für die Abbildung von Lebenszuständen.
Die folgenden Profile vom Typ Observation sind spezifische Profile im oben genannten Sinn:

Kompatibilität

Für Schwangerschaftsstatus & Erwarteter Geburtstermin wird eine Kompatibilität mit folgenden IPS Profilen angestrebt:

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

Bestätigungsrelevanz

VerbindlichkeitSHALL

Metadaten

Canonicalhttps://gematik.de/fhir/isik/StructureDefinition/ISiKLebensZustand
Statusactive
Version4.0.1
Basishttp://hl7.org/fhir/StructureDefinition/Observation

Inhalt

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
identifierΣ0..*Identifier
basedOnΣ I0..*Reference(CarePlan | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | ServiceRequest)
partOfΣ I0..*Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy)
statusS Σ ?!1..1codeBinding
categoryS0..*CodeableConceptBinding
id0..1string
extensionI0..*Extension
snomed-ctS Σ0..*ISiKSnomedCTCoding
loincS Σ1..*ISiKLoincCoding
textΣ0..1string
id0..1string
extensionI0..*Extension
referenceS Σ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
focusΣ I0..*Reference(Resource)
id0..1string
extensionI0..*Extension
referenceS Σ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
effectiveDateTimedateTime
effectivePeriodPeriod
issuedΣ0..1instant
performerΣ I0..*Reference(Practitioner | PractitionerRole | Organization | CareTeam | Patient | RelatedPerson)
valueQuantityQuantity
valueCodeableConceptCodeableConcept
valueStringstring
valueBooleanboolean
valueIntegerinteger
valueRangeRange
valueRatioRatio
valueSampledDataSampledData
valueTimetime
valueDateTimedateTime
valuePeriodPeriod
dataAbsentReasonI0..1CodeableConceptBinding
interpretation0..*CodeableConceptBinding
note0..*Annotation
bodySite0..1CodeableConcept
method0..1CodeableConcept
specimenI0..1Reference(Specimen)
deviceI0..1Reference(Device | DeviceMetric)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
lowI0..1SimpleQuantity
highI0..1SimpleQuantity
type0..1CodeableConceptBinding
appliesTo0..*CodeableConcept
ageI0..1Range
text0..1string
hasMemberΣ I0..*Reference(Observation | QuestionnaireResponse | MolecularSequence)
derivedFromΣ I0..*Reference(DocumentReference | ImagingStudy | Media | QuestionnaireResponse | Observation | MolecularSequence)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
codeΣ1..1CodeableConcept
valueQuantityQuantity
valueCodeableConceptCodeableConcept
valueStringstring
valueBooleanboolean
valueIntegerinteger
valueRangeRange
valueRatioRatio
valueSampledDataSampledData
valueTimetime
valueDateTimedateTime
valuePeriodPeriod
dataAbsentReasonI0..1CodeableConceptBinding
interpretation0..*CodeableConceptBinding
referenceRange0..*see (referenceRange)
<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="ISiKLebensZustand" />
    <url value="https://gematik.de/fhir/isik/StructureDefinition/ISiKLebensZustand" />
    <version value="4.0.1" />
    <name value="ISiKLebensZustand" />
    <title value="ISiKLebensZustand" />
    <status value="active" />
    <experimental value="false" />
    <date value="2024-11-25" />
    <publisher value="gematik GmbH" />
    <description value="Basisprofil f&#252;r ISiKLebensZustand Observation \n\n### Motivation\n\nViele medizinischen Entscheidungen ben&#246;tigen Informationen zu den Lebensumst&#228;nden eines Patienten. Hierzu geh&#246;ren eine aktuelle Schwangerschaft, Raucherstatus sowie der Alkoholabususstatus.\nMotivierender Use-Case zur Einf&#252;hrung dieser Profile ist die [Arzneitmitteltherapiesicherheit im Krankenhaus - AMTS](https://simplifier.net/guide/isik-medikation-v4/ImplementationGuide-markdown-UebergreifendeUseCases-AMTS).\n\nIn FHIR werden Untersuchungen, bzw. Beobachtungen als [`Observation`](https://hl7.org/fhir/R4/observation.html)-Ressource repr&#228;sentiert.\n\nDieses Profil ist eine generische, ISiK-spezifische Observation f&#252;r die Abbildung von Lebenszust&#228;nden.  \nDie folgenden Profile vom Typ `Observation` sind spezifische Profile im oben genannten Sinn:  \n* {{pagelink:Schwangerschaftsstatus-Profil}}\n* {{pagelink:ErwarteterEntbindungstermin-Profil}}\n* {{pagelink:Stillstatus-Profil}} \n* {{pagelink:AlkoholAbusus-Profil}} \n* {{pagelink:RaucherStatus-Profil}} \n\n### Kompatibilit&#228;t\n\nF&#252;r Schwangerschaftsstatus &amp; Erwarteter Geburtstermin wird eine Kompatibilit&#228;t mit folgenden **IPS** Profilen angestrebt:\n* [IPS Resource Profile: Observation - Pregnancy: EDD](https://hl7.org/fhir/uv/ips/STU1.1/StructureDefinition-Observation-pregnancy-edd-uv-ips.html). \n* [IPS Resource Profile: Observation - Pregnancy: status](https://hl7.org/fhir/uv/ips/STU1.1/StructureDefinition-Observation-pregnancy-status-uv-ips.html)\n\nHinweise zu Inkompatibilit&#228;ten k&#246;nnen &#252;ber die [Portalseite](https://service.gematik.de/servicedesk/customer/portal/16) gemeldet werden." />
    <fhirVersion value="4.0.1" />
    <kind value="resource" />
    <abstract value="false" />
    <type value="Observation" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Observation" />
    <derivation value="constraint" />
    <differential>
        <element id="Observation.status">
            <path value="Observation.status" />
            <short value="Status" />
            <comment value="Bedeutung: Der Status MUSS insbesondere zur Differenzierung von abgeschlossenen, \n  vorl&#228;ufigen oder korrigierten Beobachtungen angegeben werden.   \n  **WICHTIGER Hinweis f&#252;r Implementierer:**    \n  * Alle server-seitigen Implementierungen M&#220;SSEN in der Lage sein, \n  die systemintern m&#246;glichen Statuswerte korrekt in FHIR abzubilden, mindestens jedoch &#39;final&#39;.\n  * Alle client-seitigen Implementierungen M&#220;SSEN in der Lage sein, s&#228;mtliche Status-Codes zu interpretieren und dem Anwender in angemessener Form darstellen zu k&#246;nnen, \n  beispielsweise durch Ausblenden/Durchstreichen von Ressourcen mit dem status `entered-in-error` und Ausgrauen von Ressourcen, die einen Plan- oder Entwurfs-Status haben." />
            <mustSupport value="true" />
        </element>
        <element id="Observation.category">
            <path value="Observation.category" />
            <short value="Kategorie" />
            <comment value="Bedeutung: Kategorie-Code, der die Untersuchung kategorisiert." />
            <mustSupport value="true" />
        </element>
        <element id="Observation.code">
            <path value="Observation.code" />
            <short value="Code" />
            <comment value="Bedeutung: Code, der die Untersuchung repr&#228;sentiert und kodiert." />
            <mustSupport value="true" />
        </element>
        <element id="Observation.code.coding">
            <path value="Observation.code.coding" />
            <slicing>
                <discriminator>
                    <type value="pattern" />
                    <path value="system" />
                </discriminator>
                <rules value="open" />
            </slicing>
            <comment value="Motivation: Jede Lebenszustanduntersuchung MUSS einen LOINC Code enthalten, SnomedCT ist optional" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="Observation.code.coding:snomed-ct">
            <path value="Observation.code.coding" />
            <sliceName value="snomed-ct" />
            <min value="0" />
            <max value="*" />
            <type>
                <code value="Coding" />
                <profile value="https://gematik.de/fhir/isik/StructureDefinition/ISiKSnomedCTCoding" />
            </type>
            <mustSupport value="true" />
        </element>
        <element id="Observation.code.coding:loinc">
            <path value="Observation.code.coding" />
            <sliceName value="loinc" />
            <min value="1" />
            <max value="*" />
            <type>
                <code value="Coding" />
                <profile value="https://gematik.de/fhir/isik/StructureDefinition/ISiKLoincCoding" />
            </type>
            <mustSupport value="true" />
        </element>
        <element id="Observation.subject">
            <path value="Observation.subject" />
            <short value="Patientenbezug" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="Observation.subject.reference">
            <path value="Observation.subject.reference" />
            <short value="Patienten-Link" />
            <comment value="Die Verlinkung auf eine Patienten-Ressource dient der technischen Zuordnung der Dokumentation \n    zu einem Patienten und erm&#246;glicht wichtige API-Funktionen wie verkettete Suche, (Reverse-)Include etc." />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="Observation.encounter">
            <path value="Observation.encounter" />
            <short value="Aufenthaltsbezug" />
            <mustSupport value="true" />
        </element>
        <element id="Observation.encounter.reference">
            <path value="Observation.encounter.reference" />
            <short value="Encounter-Link" />
            <comment value="Die Verlinkung auf eine Encounter-Ressource dient der technischen Zuordnung der Dokumentation zu einem Aufenthalt \n    und erm&#246;glicht wichtige API-Funktionen wie verkettete Suche, (Reverse-)Include etc." />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="Observation.effective[x]">
            <path value="Observation.effective[x]" />
            <short value="Zeitpunkt/-raum der Beobachtung" />
            <comment value="Bedeutung: Klinisch relevanter Zeitpunkt/Zeitspanne f&#252;r die Observation." />
            <min value="1" />
            <type>
                <code value="dateTime" />
            </type>
            <type>
                <code value="Period" />
            </type>
            <mustSupport value="true" />
        </element>
        <element id="Observation.value[x]">
            <path value="Observation.value[x]" />
            <short value="Wert der Beobachtung" />
            <comment value="Bedeutung: Erfasster Wert der Observation." />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="Observation.hasMember">
            <path value="Observation.hasMember" />
            <comment value="Bedeutung: Weitere Observation, die mit dieser Observation gemeinsam zu betrachten ist." />
        </element>
        <element id="Observation.component">
            <path value="Observation.component" />
            <comment value="Bedeutung: Bei Vitalparametern, die aus mehreren Einzelnen Messpunkten bestehen (Blutdruck, EKG, GCS), werden die gemessenen Einzelwerte jeweils mit einem separaten LOINC-Code in Observation.component.code versehen und der entsprechende Messwert in Observation.component.value erfasst." />
        </element>
    </differential>
</StructureDefinition>
{
    "resourceType": "StructureDefinition",
    "id": "ISiKLebensZustand",
    "url": "https://gematik.de/fhir/isik/StructureDefinition/ISiKLebensZustand",
    "version": "4.0.1",
    "name": "ISiKLebensZustand",
    "title": "ISiKLebensZustand",
    "status": "active",
    "experimental": false,
    "date": "2024-11-25",
    "publisher": "gematik GmbH",
    "description": "Basisprofil für ISiKLebensZustand Observation \n\n### Motivation\n\nViele medizinischen Entscheidungen benötigen Informationen zu den Lebensumständen eines Patienten. Hierzu gehören eine aktuelle Schwangerschaft, Raucherstatus sowie der Alkoholabususstatus.\nMotivierender Use-Case zur Einführung dieser Profile ist die [Arzneitmitteltherapiesicherheit im Krankenhaus - AMTS](https://simplifier.net/guide/isik-medikation-v4/ImplementationGuide-markdown-UebergreifendeUseCases-AMTS).\n\nIn FHIR werden Untersuchungen, bzw. Beobachtungen als [`Observation`](https://hl7.org/fhir/R4/observation.html)-Ressource repräsentiert.\n\nDieses Profil ist eine generische, ISiK-spezifische Observation für die Abbildung von Lebenszuständen.  \nDie folgenden Profile vom Typ `Observation` sind spezifische Profile im oben genannten Sinn:  \n* {{pagelink:Schwangerschaftsstatus-Profil}}\n* {{pagelink:ErwarteterEntbindungstermin-Profil}}\n* {{pagelink:Stillstatus-Profil}} \n* {{pagelink:AlkoholAbusus-Profil}} \n* {{pagelink:RaucherStatus-Profil}} \n\n### Kompatibilität\n\nFür Schwangerschaftsstatus & Erwarteter Geburtstermin wird eine Kompatibilität mit folgenden **IPS** Profilen angestrebt:\n* [IPS Resource Profile: Observation - Pregnancy: EDD](https://hl7.org/fhir/uv/ips/STU1.1/StructureDefinition-Observation-pregnancy-edd-uv-ips.html). \n* [IPS Resource Profile: Observation - Pregnancy: status](https://hl7.org/fhir/uv/ips/STU1.1/StructureDefinition-Observation-pregnancy-status-uv-ips.html)\n\nHinweise zu Inkompatibilitäten können über die [Portalseite](https://service.gematik.de/servicedesk/customer/portal/16) gemeldet werden.",
    "fhirVersion": "4.0.1",
    "kind": "resource",
    "abstract": false,
    "type": "Observation",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Observation",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "Observation.status",
                "path": "Observation.status",
                "short": "Status",
                "comment": "Bedeutung: Der Status MUSS insbesondere zur Differenzierung von abgeschlossenen, \n  vorläufigen oder korrigierten Beobachtungen angegeben werden.   \n  **WICHTIGER Hinweis für Implementierer:**    \n  * Alle server-seitigen Implementierungen MÜSSEN in der Lage sein, \n  die systemintern möglichen Statuswerte korrekt in FHIR abzubilden, mindestens jedoch 'final'.\n  * Alle client-seitigen Implementierungen MÜSSEN in der Lage sein, sämtliche Status-Codes zu interpretieren und dem Anwender in angemessener Form darstellen zu können, \n  beispielsweise durch Ausblenden/Durchstreichen von Ressourcen mit dem status `entered-in-error` und Ausgrauen von Ressourcen, die einen Plan- oder Entwurfs-Status haben.",
                "mustSupport": true
            },
            {
                "id": "Observation.category",
                "path": "Observation.category",
                "short": "Kategorie",
                "comment": "Bedeutung: Kategorie-Code, der die Untersuchung kategorisiert.",
                "mustSupport": true
            },
            {
                "id": "Observation.code",
                "path": "Observation.code",
                "short": "Code",
                "comment": "Bedeutung: Code, der die Untersuchung repräsentiert und kodiert.",
                "mustSupport": true
            },
            {
                "id": "Observation.code.coding",
                "path": "Observation.code.coding",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "pattern",
                            "path": "system"
                        }
                    ],
                    "rules": "open"
                },
                "comment": "Motivation: Jede Lebenszustanduntersuchung MUSS einen LOINC Code enthalten, SnomedCT ist optional",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "Observation.code.coding:snomed-ct",
                "path": "Observation.code.coding",
                "sliceName": "snomed-ct",
                "min": 0,
                "max": "*",
                "type":  [
                    {
                        "code": "Coding",
                        "profile":  [
                            "https://gematik.de/fhir/isik/StructureDefinition/ISiKSnomedCTCoding"
                        ]
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "Observation.code.coding:loinc",
                "path": "Observation.code.coding",
                "sliceName": "loinc",
                "min": 1,
                "max": "*",
                "type":  [
                    {
                        "code": "Coding",
                        "profile":  [
                            "https://gematik.de/fhir/isik/StructureDefinition/ISiKLoincCoding"
                        ]
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "Observation.subject",
                "path": "Observation.subject",
                "short": "Patientenbezug",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "Observation.subject.reference",
                "path": "Observation.subject.reference",
                "short": "Patienten-Link",
                "comment": "Die Verlinkung auf eine Patienten-Ressource dient der technischen Zuordnung der Dokumentation \n    zu einem Patienten und ermöglicht wichtige API-Funktionen wie verkettete Suche, (Reverse-)Include etc.",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "Observation.encounter",
                "path": "Observation.encounter",
                "short": "Aufenthaltsbezug",
                "mustSupport": true
            },
            {
                "id": "Observation.encounter.reference",
                "path": "Observation.encounter.reference",
                "short": "Encounter-Link",
                "comment": "Die Verlinkung auf eine Encounter-Ressource dient der technischen Zuordnung der Dokumentation zu einem Aufenthalt \n    und ermöglicht wichtige API-Funktionen wie verkettete Suche, (Reverse-)Include etc.",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "Observation.effective[x]",
                "path": "Observation.effective[x]",
                "short": "Zeitpunkt/-raum der Beobachtung",
                "comment": "Bedeutung: Klinisch relevanter Zeitpunkt/Zeitspanne für die Observation.",
                "min": 1,
                "type":  [
                    {
                        "code": "dateTime"
                    },
                    {
                        "code": "Period"
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "Observation.value[x]",
                "path": "Observation.value[x]",
                "short": "Wert der Beobachtung",
                "comment": "Bedeutung: Erfasster Wert der Observation.",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "Observation.hasMember",
                "path": "Observation.hasMember",
                "comment": "Bedeutung: Weitere Observation, die mit dieser Observation gemeinsam zu betrachten ist."
            },
            {
                "id": "Observation.component",
                "path": "Observation.component",
                "comment": "Bedeutung: Bei Vitalparametern, die aus mehreren Einzelnen Messpunkten bestehen (Blutdruck, EKG, GCS), werden die gemessenen Einzelwerte jeweils mit einem separaten LOINC-Code in Observation.component.code versehen und der entsprechende Messwert in Observation.component.value erfasst."
            }
        ]
    }
}

Constraints/Invarianten

Terminology-Bindings