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

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
id0..1string
id0..1string
extensionI0..*Extension
url1..1uriFixed Value
valueCodingCoding
id0..1string
extensionI0..*Extension
url1..1uriFixed Value
valueCodingCoding
id0..1string
extensionI0..*Extension
url1..1uriFixed Value
valueCodingCoding
url1..1uriFixed Value
modifierExtension?! I0..*Extension
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uriPattern
versionΣ0..1string
codeS Σ1..1codePattern
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
systemΣ1..1uri
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
statusS Σ ?!1..1codeBinding
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
status1..1codeBinding
periodI1..1Period
classS Σ1..1CodingBinding
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
class1..1CodingBinding
periodI1..1Period
KontaktebeneS Σ0..1CodeableConceptBindingPattern
KontaktArtS Σ0..1CodeableConceptBindingPattern
id0..1string
extensionI0..*Extension
FachabteilungsschluesselS Σ0..1CodingBindingPattern
textΣ0..1string
priority0..1CodeableConcept
id0..1string
extensionI0..*Extension
referenceS Σ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
episodeOfCareΣ I0..*Reference(EpisodeOfCare)
basedOnI0..*Reference(ServiceRequest)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
typeΣ0..*CodeableConceptBinding
periodI0..1Period
individualΣ I0..1Reference(Practitioner | PractitionerRole | RelatedPerson)
appointmentΣ I0..*Reference(Appointment)
id0..1string
extensionI0..*Extension
startS Σ I1..1dateTime
endS Σ I0..1dateTime
lengthI0..1Duration
reasonCodeΣ0..*CodeableConceptBinding
reasonReferenceΣ I0..*Reference(Condition | Procedure | Observation | ImmunizationRecommendation)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
referenceS Σ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
useS1..1CodeableConceptBinding
rankS0..1positiveInt
accountI0..*Reference(Account)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
preAdmissionIdentifier0..1Identifier
originI0..1Reference(Location | Organization)
admitSourceS0..1CodeableConceptBinding
reAdmission0..1CodeableConcept
dietPreference0..*CodeableConcept
specialCourtesy0..*CodeableConceptBinding
specialArrangement0..*CodeableConceptBinding
destinationI0..1Reference(Location | Organization)
id0..1string
EntlassungsgrundS I0..1Extension(Complex)
codingΣ0..*Coding
textΣ0..1string
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayS Σ1..1string
status0..1codeBinding
physicalType0..1CodeableConcept
periodI0..1Period
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayS Σ1..1string
partOfS I0..1Reference(Encounter)

Link Simplifier Profil Übersicht

Folgende FHIRPath-Constraints sind im Profil zu beachten:

keyseverityhumanexpression
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". Deren 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 verpflichtend.

  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 verpflichtend.

  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:

{
    "resourceType": "SearchParameter",
    "id": "CarePlan-encounter",
    "extension":  [
        {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
            "valueCode": "trial-use"
        }
    ],
    "url": "http://hl7.org/fhir/SearchParameter/CarePlan-encounter",
    "version": "4.0.1",
    "name": "encounter",
    "status": "draft",
    "experimental": false,
    "date": "2019-11-01T09:29:23+11:00",
    "publisher": "Health Level Seven International (Patient Care)",
    "contact":  [
        {
            "telecom":  [
                {
                    "system": "url",
                    "value": "http://hl7.org/fhir"
                }
            ]
        },
        {
            "telecom":  [
                {
                    "system": "url",
                    "value": "http://www.hl7.org/Special/committees/patientcare/index.cfm"
                }
            ]
        }
    ],
    "description": "Encounter created as part of",
    "code": "encounter",
    "base":  [
        "CarePlan"
    ],
    "type": "reference",
    "expression": "CarePlan.encounter",
    "xpath": "f:CarePlan/f:encounter",
    "xpathUsage": "normal",
    "target":  [
        "Encounter"
    ]
}