Organisation (Organization)

Die nachfolgenden Festlegungen spezifizieren die Abbildung von Minimalanforderungen für die Bereitstellung von Daten zur Aufbauorganisation im Rahmen von ISiK.


Motivation

Die Abbildung der Aufbauorganisation eines Krankenhauses dient der Festlegung von Zuständigkeiten und (Entscheidungs-)Verantwortungen von Organisationseinheiten (z.B. Fachkliniken, Fachabteilungen und -bereichen etc.) in strukturierter Form.

In FHIR wird die Organisation (Organization) vom Standort (Location) eindeutig abgegrenzt.

Die Erfassung der Organisation in strukturierter Form ermöglicht u.a.:

  • Zuweisungen von Diensten an bestimmte Bereiche der Aufbauorganisation im Rahmen des Terminmanagements
  • Die Raum- und Betten-Belegung in strukturierter Form (interdisziplinär)

Auch die Erfassung des Krankenhauses als Ganzem ist relevant. Entsprechend fokussieren die folgenden Profile zur Organisation auf das Krankenhaus als Ganzes und die Fachabteilung als Organisation.


Normativer Status und Bestätigung

Diese Profile MÜSSEN im Rahmen der Bestätigung NICHT unterstützt werden. Falls ein Profil unterstützt wird, SOLLEN die hier definierten Festlegungen greifen.


Kompatibilität

Für das Profil ISiKOrganisation wurde bis zum Zeitpunkt der Veröffentlichung kein Abgleich der Kompatibilität zu anderen Profilen (der KBV und der Medizininformatik-Initiative) durchgeführt.


FHIR-Profil

Das Profil ISiKOrganisation soll auch ein Krankenhaus als Ganzes abbilden können:

NameCanonical
ISiKOrganisationhttps://gematik.de/fhir/isik/StructureDefinition/ISiKOrganisation
activeS Σ ?!0..1boolean
nameS Σ I0..1string
aliasS0..*string
telecomS I0..*ContactPoint
partOfS Σ I0..1Reference(Organization)
endpointS I0..*Reference(Endpoint)

Folgende FHIRPath-Constraints sind im Profil zu beachten:

keyseverityhumanexpression
address-cnt-2or3-charwarningThe content of the country element (if present) SHALL be selected EITHER from ValueSet ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2 OR MAY be selected from ISO Country Alpha-3 Value Set http://hl7.org/fhir/ValueSet/iso3166-1-3, IF the country is not specified in value Set ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2.country.empty() or (country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-2') or country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-3'))
address-cnt-2or3-charwarningThe content of the country element (if present) SHALL be selected EITHER from ValueSet ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2 OR MAY be selected from ISO Country Alpha-3 Value Set http://hl7.org/fhir/ValueSet/iso3166-1-3, IF the country is not specified in value Set ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2.country.empty() or (country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-2') or country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-3'))

Terminology Bindings

PathNameStrengthURL
Organization.typeorganization-typerequiredhttp://hl7.org/fhir/ValueSet/organization-type
Organization.typehe-d.de/ValueSets/IHEXDShealthcareFacilityTypeCoderequiredhttp://ihe-d.de/ValueSets/IHEXDShealthcareFacilityTypeCode
Organization.typedkgev/Fachabteilungsschluessel-erweitertrequiredhttp://fhir.de/ValueSet/dkgev/Fachabteilungsschluessel-erweitert

Das Profil ISiKOrganisationFachabteilung soll eine einzelne Fachabteilung abbilden:

NameCanonical
ISiKOrganisationFachabteilunghttps://gematik.de/fhir/isik/StructureDefinition/ISiKOrganisationFachabteilung
activeS Σ ?!0..1boolean
nameS Σ I0..1string
aliasS0..*string
telecomS I0..*ContactPoint
partOfS Σ I0..1Reference(Organization)
endpointS I0..*Reference(Endpoint)

Folgende FHIRPath-Constraints sind im Profil zu beachten:

keyseverityhumanexpression
address-cnt-2or3-charwarningThe content of the country element (if present) SHALL be selected EITHER from ValueSet ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2 OR MAY be selected from ISO Country Alpha-3 Value Set http://hl7.org/fhir/ValueSet/iso3166-1-3, IF the country is not specified in value Set ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2.country.empty() or (country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-2') or country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-3'))
address-cnt-2or3-charwarningThe content of the country element (if present) SHALL be selected EITHER from ValueSet ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2 OR MAY be selected from ISO Country Alpha-3 Value Set http://hl7.org/fhir/ValueSet/iso3166-1-3, IF the country is not specified in value Set ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2.country.empty() or (country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-2') or country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-3'))

Terminology Bindings

PathNameStrengthURL
Organization.typedkgev/Fachabteilungsschluessel-erweitertrequiredhttp://fhir.de/ValueSet/dkgev/Fachabteilungsschluessel-erweitert
Organization.typehe-d.de/ValueSets/IHEXDSpracticeSettingCoderequiredhttp://ihe-d.de/ValueSets/IHEXDSpracticeSettingCode

Interaktionen

Sofern die Ressourcen zur Organisation unterstützt werden, SOLL die REST-Interaktion "READ" implementiert werden.

Interaktionen zur Organisation werden derzeit für das Bestätigungsverfahren nicht festgelegt.

Auf folgende Suchparameter sei aufgrund der Relevanz hingewiesen - diese SOLLEN (in Einzelfällen KÖNNEN) implementiert werden, falls die oben genannten Ressourcen unterstützt werden:

  1. Der Suchparameter "identifier" SOLL unterstützt werden:

    Beispiele:

    GET [base]/Organization?identifier=http://fhir.de/sid/arge-ik/iknr|260120196

    GET [base]/Organization?identifier=http://fhir.de/StructureDefinition/identifier-bsnr|345678975

    GET [base]/Organization?identifier=345678975

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

  2. Der Suchparameter "active" SOLL unterstützt werden:

    Beispiele:

    GET [base]/Organization?active=true

    GET [base]/Organization?active=false

    Anwendungshinweise: Insbesondere für die Suche nach Daten historischer Organisationsstrukturen - z.B. nach Schließung, Zusammenlegung von Fachabteilungen etc. - erscheint es erforderlich nach Ressourcen nicht aktiver Organisationseinheiten suchen zu können. Weitere Informationen zur Suche nach "Organization.active" finden sich in der FHIR-Basisspezifikation - Abschnitt "Token Search".

  3. Der Suchparameter "type" SOLL unterstützt werden:

    Beispiele:

    GET [base]/Organization?type=dept

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

  4. Der Suchparameter "name" SOLL unterstützt werden (dies gilt auch für das Element .alias):

    Beispiele:

    GET [base]/Organization?name=FA-Gynäkologie

    GET [base]/Organization?name=GYN

    Anwendungshinweise: Weitere Informationen zur Suche nach "Organization.name" und "Organization.alias" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".

  5. Der Suchparameter "partof" in Kombination mit einem identifier-Modifier SOLL unterstützt werden :

    Beispiele:

    GET [base]/Organization?partof:identifier=260120196

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

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

    Beispiele

    GET [base]/Organization?address=Berlin

    Anwendungshinweise: Weitere Informationen zur Suche nach "Organization.address" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".

  7. Der Suchparameter "endpoint" in Kombination mit einem identifier-Modifier KANN unterstützt werden:

    Beispiele:

    GET [base]/Organization?endpoint:identifier=123456

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

Anmerkungen zu Must-Support-Feldern

Zu beachten sind die die Comment-Felder der einzelnen (Sub-)Elemente im Profil.


Beispiele

Valides Minimalbeispiel eines Krankenhauses:

{
    "resourceType": "Organization",
    "id": "KrankenhausOrganisationBeispiel",
    "meta": {
        "profile":  [
            "https://gematik.de/fhir/isik/StructureDefinition/ISiKOrganisation"
        ]
    },
    "identifier":  [
        {
            "system": "http://fhir.de/sid/arge-ik/iknr",
            "value": "260120196"
        },
        {
            "system": "https://fhir.kbv.de/NamingSystem/KBV_NS_Base_BSNR",
            "value": "345678975"
        },
        {
            "system": "https://gematik.de/fhir/sid/telematik-id",
            "value": "1234567890"
        }
    ],
    "name": "Uniklinik Entenhausen"
}

Valides Minimalbeispiel einer Fachabteilung:

{
    "resourceType": "Organization",
    "id": "AbteilungAllgemeinchirurgieOrganisationBeispiel",
    "meta": {
        "profile":  [
            "https://gematik.de/fhir/isik/StructureDefinition/ISiKOrganisationFachabteilung"
        ]
    },
    "identifier":  [
        {
            "type": {
                "coding":  [
                    {
                        "code": "225746001",
                        "system": "http://snomed.info/sct"
                    }
                ]
            },
            "system": "https://fhir.krankenhaus.example/sid/OrgaID",
            "value": "123456"
        },
        {
            "system": "https://gematik.de/fhir/sid/telematik-id",
            "value": "1234567890"
        }
    ],
    "type":  [
        {
            "coding":  [
                {
                    "code": "dept",
                    "system": "http://terminology.hl7.org/CodeSystem/organization-type"
                }
            ]
        },
        {
            "coding":  [
                {
                    "code": "1500",
                    "system": "http://fhir.de/CodeSystem/dkgev/Fachabteilungsschluessel-erweitert",
                    "display": "Allgemeine Chirurgie"
                }
            ]
        }
    ],
    "name": "Allgemeinchirurgie",
    "partOf": {
        "reference": "Organization/KrankenhausOrganisationBeispiel"
    }
}