PersonImGesundheitsberuf (Practitioner)
ISiKPersonImGesundheitsberuf
Dieses Profil ermöglicht die Abbildung von Personen, die in Gesundheitsberufen tätig sind, in ISiK-Szenarien.
Motivation
Das Profil ISIKPersonImGesundheitsberuf bildet Personen ab, die als medizinische Leistungserbringer oder Fachexperten tätig sind. In den ISiK-FHIR-Profilen können PersonImGesundheitsberuf bspw. als Ausführende einer Prozedur auftreten, im Element performer der Procedure-Ressource, oder als Person, die eine Diagnose stellt, im Element asserter der Condition-Ressource.
In FHIR werden PersonImGesundheitsberuf mit der Practitioner-Ressource
repräsentiert.
Für das Profil ISIKPersonImGesundheitsberuf wird Kompatibilität mit den folgenden Profilen angestrebt. Es kann jedoch nicht sichergestellt werden, dass Instanzen, die gegen ISIKPersonImGesundheitsberuf valide sind, auch gegen diese Profile validieren:
- Profil KBV_PR_Base_Practitioner der KBV-Basisprofile.
- Profil HiGHmed_IC_Practitioner, Medizininformatik-Initiative - HiGHmed Use Case Infection Control der Medizininformatik-Initiative
- Profil TIPractitioner der gematik
Hinweise zu Inkompatibilitäten können über die Portalseite gemeldet werden.
Bestätigungsrelevanz
| Verbindlichkeit | SHALL |
|---|
Metadaten
| Canonical | https://gematik.de/fhir/isik/StructureDefinition/ISiKPersonImGesundheitsberuf |
|---|---|
| Status | active |
| Version | 5.2.0 |
| Basis | http://hl7.org/fhir/StructureDefinition/Practitioner |
Inhalt
| ISiKPersonImGesundheitsberuf (Practitioner) | C | PractitionerImpose | |
| id | S Σ | 0..1 | id |
| meta | Σ | 0..1 | Meta |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| versionId | Σ | 0..1 | id |
| lastUpdated | Σ | 0..1 | instant |
| source | Σ | 0..1 | uri |
| profile | Σ | 0..* | canonical(StructureDefinition) |
| security | Σ | 0..* | CodingBinding |
| tag | Σ | 0..* | Coding |
| implicitRules | Σ ?! | 0..1 | uri |
| language | 0..1 | codeBinding | |
| text | 0..1 | Narrative | |
| contained | 0..* | Resource | |
| extension | C | 0..* | Extension |
| modifierExtension | ?! C | 0..* | Extension |
| identifier | S Σ | 1..* | Identifier |
| Arztnummer | S Σ | 0..* | IdentifierLanrPattern |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| use | Σ ?! | 0..1 | codeBindingFixed Value |
| type | Σ | 1..1 | CodeableConceptBindingPattern |
| system | Σ | 1..1 | uriFixed Value |
| value | Σ C | 1..1 | string |
| period | Σ C | 0..1 | Period |
| assigner | Σ C | 0..1 | Reference(Organization) |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| reference | Σ C | 0..1 | string |
| type | Σ | 0..1 | uriBinding |
| identifier | Σ | 0..1 | Identifier |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| use | Σ ?! | 0..1 | codeBinding |
| type | Σ | 0..1 | CodeableConceptBinding |
| system | Σ | 1..1 | uriFixed Value |
| value | Σ | 1..1 | string |
| period | Σ C | 0..1 | Period |
| assigner | Σ C | 0..1 | Reference(Organization) |
| display | Σ | 1..1 | string |
| EFN | S Σ | 0..1 | IdentifierEfnPattern |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| use | Σ ?! | 0..1 | codeBindingFixed Value |
| type | Σ | 1..1 | CodeableConceptBindingPattern |
| system | Σ | 1..1 | uriFixed Value |
| value | Σ | 1..1 | string |
| period | Σ C | 0..1 | Period |
| assigner | Σ C | 0..1 | Reference(Organization) |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| reference | Σ C | 0..1 | string |
| type | Σ | 0..1 | uriBinding |
| identifier | Σ | 0..1 | Identifier |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| use | Σ ?! | 0..1 | codeBinding |
| type | Σ | 0..1 | CodeableConceptBinding |
| system | Σ | 1..1 | uriFixed Value |
| value | Σ | 1..1 | string |
| period | Σ C | 0..1 | Period |
| assigner | Σ C | 0..1 | Reference(Organization) |
| display | Σ | 1..1 | string |
| TelematikId | S Σ | 0..1 | IdentifierTelematikIdPattern |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| use | Σ ?! | 0..1 | codeBinding |
| type | Σ | 1..1 | CodeableConceptBindingPattern |
| system | Σ | 1..1 | uriFixed Value |
| value | Σ | 1..1 | string |
| period | Σ C | 0..1 | Period |
| assigner | Σ C | 0..1 | Reference(Organization) |
| Mitarbeiterkennzeichen | Σ | 0..1 | IdentifierPattern |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| use | Σ ?! | 0..1 | codeBinding |
| type | Σ | 1..1 | CodeableConceptBindingPattern |
| system | Σ | 0..1 | uri |
| value | Σ | 0..1 | string |
| period | Σ C | 0..1 | Period |
| assigner | Σ C | 0..1 | Reference(Organization) |
| active | Σ | 0..1 | boolean |
| name | S Σ | 1..* | HumanName |
| Name | S Σ C | 1..1 | HumannameDeBasisPattern |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| use | S Σ ?! | 1..1 | codeBindingFixed ValuePattern |
| text | Σ | 0..1 | string |
| family | S Σ | 1..1 | string |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| namenszusatz | C | 0..1 | Extension(string) |
| nachname | C | 0..1 | Extension(string) |
| vorsatzwort | C | 0..1 | Extension(string) |
| value | 0..1 | System.String | |
| given | S Σ | 1..* | string |
| prefix | S Σ | 0..* | string |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| prefix-qualifier | C | 0..1 | Extension(code) |
| value | 0..1 | System.String | |
| suffix | Σ | 0..* | string |
| period | Σ C | 0..1 | Period |
| Geburtsname | Σ C | 0..1 | HumannameDeBasisPattern |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| use | S Σ ?! | 1..1 | codeBindingFixed ValuePattern |
| text | Σ | 0..1 | string |
| family | Σ | 1..1 | string |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| namenszusatz | C | 0..1 | Extension(string) |
| nachname | C | 0..1 | Extension(string) |
| vorsatzwort | C | 0..1 | Extension(string) |
| value | 0..1 | System.String | |
| given | Σ | 0..0 | string |
| prefix | Σ | 0..0 | string |
| suffix | Σ | 0..* | string |
| period | Σ C | 0..1 | Period |
| telecom | Σ C | 0..* | ContactPoint |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| system | Σ C | 1..1 | codeBinding |
| value | Σ | 1..1 | string |
| use | Σ ?! | 0..1 | codeBinding |
| rank | Σ | 0..1 | positiveInt |
| period | Σ C | 0..1 | Period |
| address | S Σ | 0..* | Address |
| Strassenanschrift | S Σ C | 0..* | AddressDeBasisPattern |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| Stadtteil | S C | 0..1 | Extension(string) |
| use | Σ ?! | 0..1 | codeBinding |
| type | S Σ | 1..1 | codeBindingPattern |
| text | Σ | 0..1 | string |
| line | S Σ | 1..3 | string |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| Strasse | S C | 0..1 | Extension(string) |
| Hausnummer | S C | 0..1 | Extension(string) |
| Adresszusatz | S C | 0..1 | Extension(string) |
| Postfach | C | 0..0 | Extension(string) |
| value | 0..1 | System.String | |
| city | S Σ | 1..1 | string |
| district | Σ | 0..0 | string |
| state | Σ | 0..1 | stringBinding |
| postalCode | S Σ | 1..1 | string |
| country | S Σ | 1..1 | stringBinding |
| period | Σ C | 0..1 | Period |
| Postfach | S Σ C | 0..* | AddressDeBasisPattern |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| Stadtteil | C | 0..1 | Extension(string) |
| use | Σ ?! | 0..1 | codeBinding |
| type | S Σ | 1..1 | codeBindingPattern |
| text | Σ | 0..1 | string |
| line | S Σ | 1..3 | string |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| Strasse | C | 0..0 | Extension(string) |
| Hausnummer | C | 0..0 | Extension(string) |
| Adresszusatz | C | 0..0 | Extension(string) |
| Postfach | S C | 0..1 | Extension(string) |
| value | 0..1 | System.String | |
| city | S Σ | 1..1 | string |
| district | Σ | 0..0 | string |
| state | Σ | 0..1 | stringBinding |
| postalCode | S Σ | 1..1 | string |
| country | S Σ | 1..1 | stringBinding |
| period | Σ C | 0..1 | Period |
| gender | S Σ | 0..1 | codeBinding |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| Geschlecht-Administrativ | S C | 0..1 | Extension(Coding) |
| id | 0..1 | string | |
| extension | C | 0..0 | Extension |
| url | 1..1 | uriFixed Value | |
| value[x] | S C | 1..1 | Binding |
| valueCoding | Coding | ||
| value | 0..1 | System.String | |
| birthDate | Σ | 0..1 | date |
| photo | C | 0..* | Attachment |
| qualification | 0..* | BackboneElement | |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| modifierExtension | Σ ?! C | 0..* | Extension |
| identifier | 0..* | Identifier | |
| code | 1..1 | CodeableConcept | |
| period | C | 0..1 | Period |
| issuer | C | 0..1 | Reference(Organization) |
| communication | 0..* | CodeableConceptBinding |
Constraints/Invarianten
| Name | Schweregrad | Beschreibung | Ausdruck |
|---|---|---|---|
| prac-de-1 | error | Die amtliche Differenzierung der Geschlechtsangabe 'other' darf nur gefüllt sein, wenn das Geschlecht 'other' angegeben ist | gender='other' or gender.extension('http://fhir.de/StructureDefinition/gender-amtlich-de').empty() |
Terminology-Bindings
Anmerkungen zu Must-Support-Feldern
| Feldname | Kurzbeschreibung | Hinweise |
|---|---|---|
| Practitioner.id | serverseitige, interne ID des Datensatzes | bedingtes Pflichtfeld/bedingtes MS: Alle von einem Server bereitgestellten Ressourcen MÜSSEN über eine |
| Practitioner.identifier | Eindeutiger Identifier der Person | |
| Practitioner.identifier:Arztnummer | Lebenslange Arztnummer | Im Krankenhaus ist die lebenslange Arztnummer der Ärzte bekannt und MUSS zur eindeutigen Identifikation eines Arztes bereitgestellt werden. Hinweise: Siehe Beschreibung der Deutschen Basisprofile Während die Deutschen Basisprofile hier die Abkürzung LANR verwenden, ist im KBV-Kontext das Akronym ANR gebräuchlich. Die Bezeichnung des Slices hat jedoch keinerlei Auswirkungen auf die Kompatibilität. |
| Practitioner.identifier:EFN | Einheitliche Fortbildungsnummer für Ärzte in Deutschland | In einzelnen KIS wird keine EFN geführt, da sie aus Compliance-Gründen ausschließlich in HR-Systemen vorgehalten wird. Eine fehlende EFN soll im Testsystem daher als warningOnly bewertet werden. |
| Practitioner.identifier:TelematikId | Telematik-ID | Begründung MS: Zur Verknüpfung der Practitioner-Instanz mit Diensten der Telematikinfrastruktur SOLL die Telematik-ID des HBA angegeben werden. |
| Practitioner.name | Namen der Person | |
| Practitioner.name:Name | Vollständiger Name | Der Name der Person im Gesundheitsberuf MUSS in konkreten Anwendungen angezeigt werden können. Es MUSS möglich sein, nach diesem Namen zu suchen. |
| Practitioner.name:Name.use | Verwendungszweck | Hier ist stets der Wert |
| Practitioner.name:Name.family | Nachname | Vollständiger Nachname bzw. Familienname der Person, einschließlich Namensvorsätze und -zusätze. Begründung Pflichtfeld: Ein offizieller Name ist nur zulässig, wenn der Nachname und mindestens ein Vorname angegeben sind. |
| Practitioner.name:Name.given | Kann mehrfach verwendet werden, um den Rufnamen sowie weitere Vornamen, Mittelnamen oder Mittel-Initialen abzubilden. Begründung Pflichtfeld: Ein offizieller Name ist nur zulässig, wenn der Nachname und mindestens ein Vorname angegeben sind. | |
| Practitioner.name:Name.prefix | Präfix | Präfix, z. B. akademischer Titel oder militärischer Rang |
| Practitioner.name:Geburtsname.use | ||
| Practitioner.address | Zur Unterscheidung von Postfach- und Straßenadressen, zur getrennten Angabe von Straßenname und Hausnummer sowie zur Angabe von Stadtteilen können Implementierungen die im deutschen Basisprofil zur Addresse (http://fhir.de/StructureDefinition/address-de-basis) beschriebenen Erweiterungen unterstützen. Diese Differenzierungen sind im Rahmen dieser Spezifikation jedoch nicht verpflichtend. | |
| Practitioner.address:Strassenanschrift | Straßenanschrift | Ist eine Adresse bekannt, unter der die Person im Gesundheitsberuf erreichbar ist, MUSS sie bereitgestellt werden. Diese kann zur Unterscheidung von Personen herangezogen werden. Die Ausdifferenzierung der Adresse in die Adressbestandteile erfolgt in Hinblick auf eine einheitliche Verwendung von Adressen. |
| Practitioner.address:Strassenanschrift.extension:Stadtteil | ||
| Practitioner.address:Strassenanschrift.type | ||
| Practitioner.address:Strassenanschrift.line | ||
| Practitioner.address:Strassenanschrift.line.extension:Strasse | ||
| Practitioner.address:Strassenanschrift.line.extension:Hausnummer | ||
| Practitioner.address:Strassenanschrift.line.extension:Adresszusatz | ||
| Practitioner.address:Strassenanschrift.city | ||
| Practitioner.address:Strassenanschrift.postalCode | ||
| Practitioner.address:Strassenanschrift.country | ||
| Practitioner.address:Postfach | Postfachanschrift | Ist eine Adresse bekannt, unter der die Person im Gesundheitsberuf erreichbar ist, MUSS sie bereitgestellt werden. Diese kann zur Unterscheidung von Personen herangezogen werden. Die Ausdifferenzierung der Adresse in die Adressbestandteile erfolgt in Hinblick auf eine einheitliche Verwendung von Adressen. |
| Practitioner.address:Postfach.type | ||
| Practitioner.address:Postfach.line | ||
| Practitioner.address:Postfach.line.extension:Postfach | ||
| Practitioner.address:Postfach.city | ||
| Practitioner.address:Postfach.postalCode | ||
| Practitioner.address:Postfach.country | ||
| Practitioner.gender | Administratives Geschlecht | Ist das Geschlecht der Person im Gesundheitsberuf bekannt, MUSS es bereitgestellt werden. Für die Angabe 'divers' ist in Practitioner.gender der FHIR-Code |
| Practitioner.gender.extension:Geschlecht-Administrativ | ||
| Practitioner.gender.extension:Geschlecht-Administrativ.value[x] |
Interaktionen
Für die Ressource Practitioner MÜSSEN die REST-Interaktionen "READ" und "SEARCH" (search-type) implementiert werden.
Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Kombination:
Der Suchparameter "_id" MUSS unterstützt werden:
Beispiele:
GET [base]/Practitioner?_id=1234567890Anwendungshinweise: Weitere Informationen zur Suche nach "_id" finden sich in der FHIR-Basisspezifikation - Abschnitt "Parameters for all resources".
Der Suchparameter "identifier" MUSS unterstützt werden:
Beispiele:
GET [base]/Practitioner?identifier=42Anwendungshinweise: Weitere Informationen zur Suche nach "Practitioner.identifier" finden sich in der FHIR-Basisspezifikation - Abschnitt "Token Search".
Der Suchparameter "given" MUSS unterstützt werden:
Beispiele:
GET [base]/Practitioner?given=HeidiAnwendungshinweise: Weitere Informationen zur Suche nach "Practitioner.name.given" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".
Der Suchparameter "family" MUSS unterstützt werden:
Beispiele:
GET [base]/Practitioner?family=AlpenzauberAnwendungshinweise: Weitere Informationen zur Suche nach "Practitioner.name.family" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".
Der Suchparameter "name" KANN unterstützt werden:
Beispiele:
GET [base]/Practitioner?name=HeidiGET [base]/Practitioner?name=AlpenzauberAnwendungshinweise: Weitere Informationen zur Suche nach "Practitioner.name" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".
Der Suchparameter "address" KANN unterstützt werden:
Beispiele:
GET [base]/Practitioner?address=BerlinAnwendungshinweise: Weitere Informationen zur Suche nach "Practitioner.address" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".
Der Suchparameter "gender" KANN unterstützt werden:
Beispiele:
GET [base]/Practitioner?gender=femaleAnwendungshinweise: Weitere Informationen zur Suche nach "Practitioner.gender" finden sich in der FHIR-Basisspezifikation - Abschnitt "Token Search".
Beispiele
Beispiel:
| Practitioner |
| id : PractitionerWalterArzt |
| meta |
| source : http://krankenhaus.de |
| profile : https://gematik.de/fhir/isik/StructureDefinition/ISiKPersonImGesundheitsberuf |
| identifier |
| type |
| coding |
| system : http://terminology.hl7.org/CodeSystem/v2-0203 |
| code : LANR |
| system : https://fhir.kbv.de/NamingSystem/KBV_NS_Base_ANR |
| value : 123456789 |
| identifier |
| type |
| coding |
| system : http://terminology.hl7.org/CodeSystem/v2-0203 |
| code : DN |
| system : http://fhir.de/sid/bundesaerztekammer/efn |
| value : 123456789123456 |
| active : True |
| name |
| use : official |
| text : Walter Arzt |
| family : Arzt |
| extension |
| url : http://hl7.org/fhir/StructureDefinition/humanname-own-name |
| value : Arzt |
| given : Walter |
| name |
| use : maiden |
| text : Gross |
| family : Gross |
| extension |
| url : http://hl7.org/fhir/StructureDefinition/humanname-own-name |
| value : Gross |
| address |
| type : both |
| line : Schmiedegasse 16 |
| extension |
| url : http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber |
| value : 16 |
| extension |
| url : http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName |
| value : Schmiedegasse |
| city : Potsdam |
| postalCode : 14469 |
| country : DE |
| gender : male |
| birthDate |
| extension |
| url : http://hl7.org/fhir/StructureDefinition/data-absent-reason |
| value : masked |
| qualification |
| code |
| coding |
| system : http://snomed.info/sct |
| version : http://snomed.info/sct/900000000000207008/version/20200131 |
| code : 309343006 |
| display : Physician (occupation) |