Kontakt/Fall (Encounter)

Motivation

Informationen über die Kontakte des Patienten entlang seines Behandlungspfades im Krankenhaus sind ein wichtiger Bestandteil des einrichtungsinternen Datenaustausches. Sie ermöglichen die Unterscheidung von stationären und ambulanten sowie aufgenommenen und entlassenen Patienten. Weiterhin ist aus den Kontaktinformationen der aktuelle Aufenthaltsort des Patienten (Fachabteilung, Station, Bettplatz) ermittelbar. Klinische Ressourcen werden in FHIR durch Verlinkung auf die Encounter-Ressource in einen Kontext zum Einrichtungskontakt gestellt. Dieser Kontext ist wichtig für die Steuerung von Zugriffsberechtigungen und Abrechnungsprozessen.

Am Beginn der meisten klinischen Workflows steht die Auswahl des Fallkontextes. Dies geschieht bspw. durch Suchen der Encounter-Ressource anhand von Eigenschaften wie Aufnahmenummer, Fallart oder Aufnahmedatum. Daraufhin werden die zutreffenden Suchergebnisse angezeigt und der gewünschte Einrichtungskontakt ausgewählt.

Kompatibilität

Dieses Profil basiert auf dem Profil KontaktGesundheitseinrichtung der Medizininformatik-Initiative.

Instanzen, die gegen ISiKKontaktGesundheitseinrichtung valide sind, sind auch valide gegen

Profil

Canonical URL: https://gematik.de/fhir/ISiK/StructureDefinition/ISiKKontaktGesundheitseinrichtung

idS Σ1..1System.String
url1..1System.StringFixed Value
valueCodingCoding
url1..1System.StringFixed Value
valueCodingCoding
url1..1System.StringFixed Value
valueCodingCoding
url1..1System.StringFixed Value
useΣ ?!0..1codeBinding
systemS Σ1..1uri
versionΣ0..1string
codeS Σ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
systemΣ1..1uri
valueΣ1..1string
periodΣ0..1Period
assignerΣ0..1Reference(Organization)
statusS Σ ?!1..1codeBinding
status1..1codeBinding
period1..1Period
classS Σ1..1CodingBinding
class1..1CodingBinding
period1..1Period
KontaktebeneS Σ0..1CodeableConceptBinding
KontaktArtS Σ1..1CodeableConceptBinding
FachabteilungsschluesselS Σ0..1CodingBinding
textΣ0..1string
priority0..1CodeableConcept
referenceS Σ1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
episodeOfCareΣ0..*Reference(EpisodeOfCare)
basedOn0..*Reference(ServiceRequest)
typeΣ0..*CodeableConceptBinding
period0..1Period
individualΣ0..1Reference(Practitioner| PractitionerRole| RelatedPerson)
appointmentΣ0..*Reference(Appointment)
startS Σ1..1dateTime
endS Σ0..1dateTime
length0..1DurationBinding
reasonCodeΣ0..*CodeableConceptBinding
reasonReferenceΣ0..*Reference(Condition| Procedure| Observation| ImmunizationRecommendation)
referenceΣ1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
useS1..1CodeableConceptBinding
rankS0..1positiveInt
account0..*Reference(Account)
preAdmissionIdentifier0..1Identifier
origin0..1Reference(Location| Organization)
admitSourceS1..1CodeableConceptBinding
reAdmission0..1CodeableConcept
dietPreference0..*CodeableConcept
specialCourtesy0..*CodeableConceptBinding
specialArrangement0..*CodeableConceptBinding
destination0..1Reference(Location| Organization)
EntlassungsgrundS0..1Extension(Complex)
codingΣ0..*Coding
textΣ0..1string
referenceΣ0..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayS Σ1..1string
status0..1codeBinding
physicalType0..1CodeableConcept
period0..1Period
referenceΣ0..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayS Σ1..1string
partOfS0..1Reference(Encounter)

Link Simplifier Profil Übersicht

Folgende FHIRPath-Constraints sind im Profil zu beachten:

ISiK-enc-1warningAbgeschlossene Kontakte sollten einen End-Zeitpunkt angebenstatus = 'finished' implies period.end.exists()

Weitere Hinweise zu den Abgrenzungen der Begrifflichkeiten Fall und Kontakt finden sie unter Deutsche Basisprofile - Abschnitt Ambulanter/stationärer Fall / Kontakt (Encounter).

Anmerkungen zu den Must-Support Feldern

Encounter.status

Bedeutung: Der Status MUSS insbesondere zur Differenzierung von abgeschlossenen und derzeitig noch aktiven Kontakten angegeben werden. Alle in einem System möglichen Status-Werte müssen über FHIR korrekt repräsentiert werden können, mindestens jedoch die Status-Werte, "in-progress", "finished" und "cancelled".

Alle in einem System möglichen Status-Werte müssen über FHIR korrekt repräsentiert werden können, mindestens jedoch der Status-Wert, "completed". Dessen korrekte Abbildung wird im Rahmen des Bestätigungsverfahrens überprüft.

Hinweise: Siehe Beschreibung in der FHIR Kernspezifikation

Encounter.class

Bedeutung: Alle Encounter MÜSSEN eindeutig kategorisiert werden können, sodass eine Filterung pro Typ möglich ist.

Hinweise: Verpflichtende Kodierung per HL7 v3 Value Set ActEncounterCode um eine internationale Kompatibilität aufrecht zu erhalten.

Encounter.type

Bedeutung: Angabe des Typ des Kontaktes. Alle Möglichkeiten eines Einrichtungskontaktes nach SGB V sind vorhanden.

Encounter.subject

Bedeutung: Ein Patientenbezug des Falls MUSS stets zum Zwecke der Nachvollziehbarkeit und Datenintegrität vorliegen.

Encounter.period

Bedeutung: Der Rahmen des Kontaktes MUSS zur zeitlichen Einordnung angeben werden.

Hinweise: Es ist der FHIRPath Constraint ISiK-enc-1 zu beachten. Siehe JSON Repräsentation FHIR Profil ISiK Encounter.

Encounter.location

Bedeutung: Falls Details zum Ort, an dem der Kontakt stattfindet, vorliegen, KÖNNEN diese in einer beliebigen Detailtiefe angegeben werden.

Encounter.serviceProvider

Bedeutung: Falls Details zur verantwortlichen Organisationeinheit vorliegen, KÖNNEN diese in einer beliebigen Detailtiefe angegeben werden.

Interaktionen

Für die Ressource Encounter 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]/Encounter?_id=103270

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

  2. Der Suchparameter "identifier" MUSS unterstützt werden:

    Beispiele

    GET [base]/Encounter?identifier=http://test.krankenhaus.de/fhir/sid/fallnr|123456

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

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

    Beispiele

    GET [base]/Encounter?status=finished

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

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

    Beispiele

    GET [base]/Encounter?class=IMP

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

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

    Beispiele

    GET [base]/Encounter?type=http://fhir.de/CodeSystem/kontaktart-de|stationaer

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

  6. Der Suchparameter "subject" MUSS unterstützt werden:

    Beispiele:

    GET [base]/Encounter?subject=Patient/123

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

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

    Beispiele:

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

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

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

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

    Beispiele:

    GET [base]/Encounter?date=lt2020-26-10

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

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

  9. Der Suchparameter "location" KANN unterstützt werden:

    Beispiele:

    GET [base]/Encounter?location=Location/test

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

  10. Der Suchparameter "partOf" KANN unterstützt werden:

    Beispiele:

    GET [base]/Encounter?part-of=Encounter/test

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

  11. Der Suchparameter "service-provider" KANN unterstützt werden:

    Beispiele:

    GET [base]/Encounter?service-provider=Organization/test

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

  12. Der Suchparameter "_profile" KANN unterstützt werden:

    Beispiele:

    GET [base]/Encounter?_profile=https://gematik.de/fhir/ISiK/StructureDefinition/ISiKKontaktGesundheitseinrichtung

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

Beispiele

Valides Minimalbeispiel für das Profil ISiKKontaktGesundheitseinrichtung:

<Encounter xmlns="http://hl7.org/fhir">
    <id value="encounter" />
    <meta>
        <profile value="https://gematik.de/fhir/ISiK/StructureDefinition/ISiKKontaktGesundheitseinrichtung" />
    </meta>
    <extension url="http://fhir.de/StructureDefinition/Aufnahmegrund">
        <extension url="ErsteUndZweiteStelle">
            <valueCoding>
                <system value="http://fhir.de/CodeSystem/dkgev/AufnahmegrundErsteUndZweiteStelle" />
                <code value="01" />
                <display value="Krankenhausbehandlung, vollstation&#228;r" />
            </valueCoding>
        </extension>
        <extension url="DritteStelle">
            <valueCoding>
                <system value="http://fhir.de/CodeSystem/dkgev/AufnahmegrundDritteStelle" />
                <code value="0" />
                <display value="Anderes" />
            </valueCoding>
        </extension>
        <extension url="DritteStelle">
            <valueCoding>
                <system value="http://fhir.de/CodeSystem/dkgev/AufnahmegrundVierteStelle" />
                <code value="1" />
                <display value="Normalfall" />
            </valueCoding>
        </extension>
    </extension>
    <identifier>
        <type>
            <coding>
                <system value="http://terminology.hl7.org/CodeSystem/v2-0203" />
                <code value="VN" />
            </coding>
        </type>
        <system value="https://test.krankenhaus.de/fhir/sid/fallnr" />
        <value value="0123456789" />
    </identifier>
    <status value="finished" />
    <class>
        <system value="http://terminology.hl7.org/CodeSystem/v3-ActCode" />
        <code value="IMP" />
    </class>
    <type>
        <coding>
            <system value="http://fhir.de/CodeSystem/kontaktart-de" />
            <code value="operation" />
        </coding>
    </type>
    <type>
        <coding>
            <system value="http://fhir.de/CodeSystem/Kontaktebene" />
            <code value="versorgungsstellenkontakt" />
        </coding>
    </type>
    <serviceType>
        <coding>
            <system value="http://fhir.de/CodeSystem/dkgev/Fachabteilungsschluessel" />
            <code value="0100" />
        </coding>
    </serviceType>
    <subject>
        <reference value="Patient/test" />
    </subject>
    <period>
        <start value="2021-02-12" />
        <end value="2021-02-13" />
    </period>
    <diagnosis>
        <condition>
            <reference value="Condition/test" />
        </condition>
        <use>
            <coding>
                <system value="http://terminology.hl7.org/CodeSystem/diagnosis-role" />
                <code value="CC" />
                <display value="Hauptdiagnose" />
            </coding>
        </use>
    </diagnosis>
    <hospitalization>
        <admitSource>
            <coding>
                <system value="http://fhir.de/CodeSystem/dgkev/Aufnahmeanlass" />
                <code value="E" />
            </coding>
        </admitSource>
        <dischargeDisposition>
            <extension url="http://fhir.de/StructureDefinition/Entlassungsgrund">
                <extension url="ErsteUndZweiteStelle">
                    <valueCoding>
                        <system value="http://fhir.de/CodeSystem/dkgev/EntlassungsgrundErsteUndZweiteStelle" />
                        <code value="01" />
                        <display value="Behandlung regul&#228;r beendet" />
                    </valueCoding>
                </extension>
                <extension url="DritteStelle">
                    <valueCoding>
                        <system value="http://fhir.de/CodeSystem/dkgev/EntlassungsgrundDritteStelle" />
                        <code value="1" />
                        <display value="arbeitsf&#228;hig entlassen" />
                    </valueCoding>
                </extension>
            </extension>
        </dischargeDisposition>
    </hospitalization>
    <location>
        <location>
            <display value="Krankenhaus XYZ" />
        </location>
    </location>
    <serviceProvider>
        <display value="Fachabteilung XYZ" />
    </serviceProvider>
</Encounter>