ISiK Basis Implementierungsleitfaden
Version 6.0.0-rc - ballot

CapabilityStatement: CapabilityStatement für Rolle AufbaustrukturRolle

Official URL: https://gematik.de/fhir/isik/CapabilityStatement/ISiKCapabilityStatementAufbaustrukturRolle Version: 6.0.0-rc
Active as of 2026-04-02 Computable Name: ISiKCapabilityStatementAufbaustrukturRolle

Dieses CapabilityStatement beschreibt alle Interaktionen, die ein System unterstützen MUSS, welches diese Rolle implementiert.

Die CapabilityStatements in dieser Spezifikation stellen die Anforderungen seitens der gematik dar (kind = requirements). Zur Unterscheidung von Anforderungen, die erfüllt werden MÜSSEN gegenüber jenen, die erfüllt werden KÖNNEN, wird die CapabilityStatement-Expectation-Extension mit den möglichen Werten SHALL (=MUSS) und MAY (=KANN) verwendet.

CapabilityStatement für die Rolle ISiKCapabilityStatementAufbaustrukturRolle. Diese Rolle stellt Interaktionen zur Abfrage von Informationen zur Aufbaustruktur bereit. Die Aufbaustruktur umfasst die Organisationseinheiten, Standorte und deren Zuordnungen.

CapabilityStatement für Rolle AufbaustrukturRolle

  • Implementation Guide Version: 6.0.0-rc
  • FHIR Version: 4.0.1
  • Supported Formats: application/fhir+xml, application/fhir+json
  • Published on: 2026-04-02
  • Published by: gematik GmbH

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

SHALL Support the Following Implementation Guides

  • https://gematik.de/fhir/isik/ImplementationGuide/ISiK-Basismodul

FHIR RESTful Capabilities

Mode: server

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRSUCSearches_include_revincludeOperations
OrganizationSupported Profiles
  ISiKOrganisation
  ISiKOrganisationFachabteilung		YY_id, _count, _has, _tag, _lastUpdated, identifier, active, type, name, address, partof, endpoint
LocationSupported Profiles
  ISiKStandort
  ISiKStandortRaum
  ISiKStandortBettenstellplatz		YYY_id, _count, _has, _tag, _lastUpdated, identifier, address, operational-status, organization, partof, near, characteristic
Core FHIR Resource
Organization
Reference Policy
Interaction summary
  • SHALL support
    read

    Die Ressource Organization MUSS unterstützt werden, da sie notwendig ist zur Abbildung der Aufbaustruktur und insbesondere zur Ausgabe von Angaben zu Fachbereichen.

    search-type

    Die REST-Interaktion search MUSS implementiert werden, um die Suche nach Organisationseinheiten, Fachbereichen und Stationen zu ermöglichen.

Supported Profiles

ISiKOrganisation
ISiKOrganisationFachabteilung

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Beispiel: GET [base]/[Resourcetype]?_id=103270 Anwendungshinweis: Der Parameter _id wird selten alleinstehend verwendet, da sich zum Abruf einer Ressource anhand der id die READ-Interaktion besser anbietet. Der Parameter kann jedoch verwendet werden, um den Abruf einer Ressource bspw. mit einem _include weiterer Ressourcen zu verbinden, z.B. zum Abruf eines Encounters in Verbindung mit dem zugehörigen Patienten: GET [base]/Encounter?_id=103270&_include=Encounter:patient Weitere Details siehe FHIR-Kernspezifikation, Abschnitt Parameters for all resources. Dieser Suchparameter ist für die Umsetzung des IHE PDQm Profils verpflichtend.

SHALL_countnumber

Beispiel: GET [base]/[Resourcetype]?_count=100 Anwendungshinweis: Weitere Details siehe FHIR-Kernspezifikation, Abschnitt Page Count.

SHALL_lastUpdateddate

Beispiel: Suche nach allen Patienten-Ressourcen, die seit dem 1. Januar neu angelegt oder geändert wurden:
GET [base]/Patient?_lastUpdated=ge2026-01-01
Beispiel: Suche nach allen Observations eines Patienten im Zeitraum einer Stunde:
GET [base]/Observation?_lastUpdated=ge2026-03-05T10:20:10.423+02:00&_lastUpdate=lt2026-03-05T11:20:10.423+02:00&patient=Patient/12345
Anwendungshinweis:
Dieser Suchparameter dient dem Datenabgleich zwischen Systemen und ist auch für die patientenübergreifende Suche zugelassen. Server können die Anfrage mit einer OperationOutcome-Ressource und dem Fehlercode too-costly beantworten, wenn das vom Client gewählte Zeitfenster oder die Treffermenge zu groß ist und die Durchführhung der Suchanfrage das System unverhältnismäßig stark belasten würde. Weitere Details siehe FHIR-Kernspezifikation, Abschnitt _lastUpdated.

SHALLidentifiertoken

Beispiel:
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
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

SHALLactivetoken

Beispiel:
GET [base]/Organization?active=true GET [base]/Organization?active=false
Anwendungshinweis:
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 Details siehe FHIR-Kernspezifikation.

SHALLtypetoken

Beispiel:
GET [base]/Organization?type=dept
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

SHALLnamestring

Beispiel:
GET [base]/Organization?name=FA-Gynäkologie
GET [base]/Organization?name=GYN
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

SHALLpartofreference

Begründung: Die Suche nach übergeordneten Organisationseinheiten (z.B. Zugehörigkeit einer Station zu einem Fachbereich) ist eine zentrale Anforderung für die Abbildung der Aufbaustruktur. Beispiel:
GET [base]/Organization?partof:identifier=260120196
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

MAY_hasstring

Beispiel: Suche nach allen Patienten, die eine Observation mit dem Code '1234-5' haben GET [base]/Patient?_has:Observation:patient:code=1234-5 Beispiel: Suche nach allen Encountern, bei denen die Diagnose 'A12.3' gestellt wurde GET [base]/Encounter?_has:Condition:encounter:code=A12.3 Anwendungshinweis: Weitere Details siehe FHIR-Kernspezifikation, Abschnitt Reverse Chaining.

MAY_tagtoken

Beispiel: GET [base]/[Resourcetype]?_tag=https://example.org/codes|needs-review Anwendungshinweis: Weitere Details siehe FHIR-Kernspezifikation, Abschnitt Parameters for all resources sowie Abschnitt Tags.

MAYaddressstring

Beispiel:
GET [base]/Organization?address=Berlin
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

MAYendpointreference

Beispiel:
GET [base]/Organization?endpoint:identifier=123456
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

 
Core FHIR Resource
Location
Reference Policy
Interaction summary
  • SHALL support
    read

    Begründung: Die REST-Interaktion read muss implementiert werden, um einzelne Ressourcen abzurufen.

    search-type

    Begründung: Die REST-Interaktion search muss implementiert werden, um Ressourcen nach bestimmten Kriterien zu suchen.

  • SHOULD support
    update

    Sofern die Ressourcen zum Standort unterstützt werden, SOLL die REST-Interaktion update implementiert werden. Diese dient insbesondere dem Synchronisieren des Status (Location.operationalStatus) der abgeleiteten Ressourcen ISiKStandortRaum und ISiKStandortBettenstellplatz - u.a. zur Kennzeichnung als 'Frei', 'Besetzt', 'Kontaminiert', 'Isoliert', in 'Reinigung' etc.

Supported Profiles

ISiKStandort
ISiKStandortRaum
ISiKStandortBettenstellplatz

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Beispiel: GET [base]/[Resourcetype]?_id=103270 Anwendungshinweis: Der Parameter _id wird selten alleinstehend verwendet, da sich zum Abruf einer Ressource anhand der id die READ-Interaktion besser anbietet. Der Parameter kann jedoch verwendet werden, um den Abruf einer Ressource bspw. mit einem _include weiterer Ressourcen zu verbinden, z.B. zum Abruf eines Encounters in Verbindung mit dem zugehörigen Patienten: GET [base]/Encounter?_id=103270&_include=Encounter:patient Weitere Details siehe FHIR-Kernspezifikation, Abschnitt Parameters for all resources. Dieser Suchparameter ist für die Umsetzung des IHE PDQm Profils verpflichtend.

SHALL_countnumber

Beispiel: GET [base]/[Resourcetype]?_count=100 Anwendungshinweis: Weitere Details siehe FHIR-Kernspezifikation, Abschnitt Page Count.

SHALL_lastUpdateddate

Beispiel: Suche nach allen Patienten-Ressourcen, die seit dem 1. Januar neu angelegt oder geändert wurden:
GET [base]/Patient?_lastUpdated=ge2026-01-01
Beispiel: Suche nach allen Observations eines Patienten im Zeitraum einer Stunde:
GET [base]/Observation?_lastUpdated=ge2026-03-05T10:20:10.423+02:00&_lastUpdate=lt2026-03-05T11:20:10.423+02:00&patient=Patient/12345
Anwendungshinweis:
Dieser Suchparameter dient dem Datenabgleich zwischen Systemen und ist auch für die patientenübergreifende Suche zugelassen. Server können die Anfrage mit einer OperationOutcome-Ressource und dem Fehlercode too-costly beantworten, wenn das vom Client gewählte Zeitfenster oder die Treffermenge zu groß ist und die Durchführhung der Suchanfrage das System unverhältnismäßig stark belasten würde. Weitere Details siehe FHIR-Kernspezifikation, Abschnitt _lastUpdated.

SHALLidentifiertoken

Beispiel:
GET [base]/Location?identifier=http://fhir.krankenhaus.example|260120196
GET [base]/Location?identifier=345678975
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

SHALLcharacteristictoken

Begründung: Die Suche nach Stationen ist notwendig und wird über diesen Suchparameter ermöglicht.

    **Beispiel:**    
    `GET [base]/Location?characteristic=http://terminology.hl7.org/CodeSystem/location-physical-type|wa` 
    **Anwendungshinweis:**   
    Weitere Details siehe [FHIR-Kernspezifikation](https://hl7.org/fhir/R4/search.html#token).
MAY_hasstring

Beispiel: Suche nach allen Patienten, die eine Observation mit dem Code '1234-5' haben GET [base]/Patient?_has:Observation:patient:code=1234-5 Beispiel: Suche nach allen Encountern, bei denen die Diagnose 'A12.3' gestellt wurde GET [base]/Encounter?_has:Condition:encounter:code=A12.3 Anwendungshinweis: Weitere Details siehe FHIR-Kernspezifikation, Abschnitt Reverse Chaining.

MAY_tagtoken

Beispiel: GET [base]/[Resourcetype]?_tag=https://example.org/codes|needs-review Anwendungshinweis: Weitere Details siehe FHIR-Kernspezifikation, Abschnitt Parameters for all resources sowie Abschnitt Tags.

MAYaddressstring

Beispiel:
GET [base]/Location?address=Berlin
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

MAYoperational-statustoken

Beispiel:
GET [base]/Location?operational-status=Unoccupied
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

MAYorganizationreference

Beispiel:
GET [base]/Location?organization=AbteilungAllgemeinchirurgieOrganisationBeispiel
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

MAYpartofreference

Beispiel zur Suche nach Standort-Zugehörigkeit eines Raums (Zu welcher Abteilung gehört dieser Raum?):
[base]/Location?partof=RaumStandortBeispiel
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

MAYnearspecial

Beispiel zur Suche nach Standort nahe (100m) Koordinaten:
GET [base]/Location?near=52.525851|13.37774|100|m
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.