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
idS Σ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
IKNRS Σ I0..1Identifier-Profil für die Abbildung eines Institutionskennzeichens (IKNR)Pattern
BSNRS Σ I0..1Identifier-Profil für die Abbildung einer BetriebsstättennummerPattern
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBindingPattern
systemS Σ1..1uri
valueS Σ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
activeS Σ ?!0..1boolean
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
nameS Σ I0..1string
aliasS0..*string
telecomS I0..*ContactPoint
id0..1string
StadtteilS I0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingFixed Value
textΣ0..1string
id0..1string
StrasseS I0..1Extension(string)
HausnummerS I0..1Extension(string)
AdresszusatzS I0..1Extension(string)
PostfachI0..0Extension(string)
value0..1System.String
cityS Σ1..1string
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ1..1stringBinding
periodΣ I0..1Period
id0..1string
StadtteilS I0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingFixed Value
textΣ0..1string
id0..1string
StrasseI0..0Extension(string)
HausnummerI0..0Extension(string)
AdresszusatzI0..0Extension(string)
PostfachS I0..1Extension(string)
value0..1System.String
cityS Σ1..1string
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ1..1stringBinding
periodΣ I0..1Period
partOfS Σ I0..1Reference(Organization)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
purpose0..1CodeableConceptBinding
name0..1HumanName
telecomI0..*ContactPoint
address0..1Address
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.typeerminology.hl7.org/CodeSystem/organization-typerequiredhttp://terminology.hl7.org/CodeSystem/organization-type
Organization.typehir.de/CodeSystem/dkgev/Fachabteilungsschluessel-erweitertrequiredhttp://fhir.de/CodeSystem/dkgev/Fachabteilungsschluessel-erweitert

Das Profil ISiKOrganisationFachabteilung soll eine einzelne Fachabteilung abbilden:

NameCanonical
ISiKOrganisationFachabteilunghttps://gematik.de/fhir/isik/StructureDefinition/ISiKOrganisationFachabteilung
idS Σ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
IKNRS Σ I0..1Identifier-Profil für die Abbildung eines Institutionskennzeichens (IKNR)Pattern
BSNRS Σ I0..1Identifier-Profil für die Abbildung einer BetriebsstättennummerPattern
TelematikIDS Σ I0..1Identifier-Profil für die Telematik-IDPattern
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBindingPattern
systemS Σ1..1uri
valueS Σ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
activeS Σ ?!0..1boolean
organisationstypS Σ1..1CodeableConceptPattern
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
nameS Σ I0..1string
aliasS0..*string
telecomS I0..*ContactPoint
id0..1string
StadtteilS I0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingFixed Value
textΣ0..1string
id0..1string
StrasseS I0..1Extension(string)
HausnummerS I0..1Extension(string)
AdresszusatzS I0..1Extension(string)
PostfachI0..0Extension(string)
value0..1System.String
cityS Σ1..1string
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ1..1stringBinding
periodΣ I0..1Period
id0..1string
StadtteilS I0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingFixed Value
textΣ0..1string
id0..1string
StrasseI0..0Extension(string)
HausnummerI0..0Extension(string)
AdresszusatzI0..0Extension(string)
PostfachS I0..1Extension(string)
value0..1System.String
cityS Σ1..1string
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ1..1stringBinding
periodΣ I0..1Period
partOfS Σ I0..1Reference(Organization)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
purpose0..1CodeableConceptBinding
name0..1HumanName
telecomI0..*ContactPoint
address0..1Address
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.typehir.de/CodeSystem/dkgev/Fachabteilungsschluessel-erweitertrequiredhttp://fhir.de/CodeSystem/dkgev/Fachabteilungsschluessel-erweitert

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"
        }
    ],
    "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"
        }
    ],
    "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"
    }
}