PersonImGesundheitsberuf (Practitioner)
ISiKPersonImGesundheitsberuf
Dieses Profil ermöglicht die Nutzung von in Gesundheitsberufen tätigen Personen in ISiK Szenarien.
Motivation
Das Profil ISIKPersonImGesundheitsberuf bildet alle denkbaren medizinischen Leistungserbringer und Fachexperten ab. In den ISiK-FHIR-Profilen können PersonImGesundheitsberuf bspw. als Ausführende einer Prozedur auftreten, im Element performer der Procedure Ressource, oder als die 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 eine Kompatibilität mit folgenden Profilen angestrebt; allerdings kann nicht sichergestellt werden, dass Instanzen, die gegen ISIKPatient valide sind, auch valide sind gegen:
- Profil KBV_PR_Base_Practitioner der KBV Basisprofile.
- Profil HiGHmed_IC_Practitioner, MI 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.1.0 |
| Basis | http://hl7.org/fhir/StructureDefinition/Practitioner |
Inhalt
| ISiKPersonImGesundheitsberuf (Practitioner) | C | Practitioner | |
| id | S Σ | 0..1 | string |
| 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 | Σ | 0..1 | Period |
| assigner | Σ | 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 | Σ | 0..1 | Period |
| assigner | Σ | 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 | Σ | 0..1 | Period |
| assigner | Σ | 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 | Σ | 0..1 | Period |
| assigner | Σ | 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 | Σ | 0..1 | Period |
| assigner | Σ | 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 | Σ | 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 | Σ | 0..1 | Period |
| telecom | Σ | 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 | Σ | 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 | Σ | 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 | Σ | 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 | 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 | 0..1 | Period | |
| issuer | 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 bestimmten KIS wird keine EFN geführt, da diese aus Compliance-Gründen getrennt in HR-Systemen vorgehalten wird (Hinweis kam von Stakeholder), daher soll der entsprechende Test im Test-System mit "warningOnly" ausgegeben werden. |
| Practitioner.identifier:TelematikId | Telematik-ID | Begründung MS: Zur Verknüpfung der Patient Instanz mit Diensten der Telematik Infrastruktur SOLL die ID mit angegeben sein. |
| Practitioner.name | Namen der Person | |
| Practitioner.name:Name | Vollständiger Name | Der Name des Arztes MUSS in konkreten Anwendungen angezeigt werden können. Es MUSS nach dem Namen des Arztes gesucht werden können. |
| Practitioner.name:Name.use | ||
| Practitioner.name:Name.family | ||
| Practitioner.name:Name.given | ||
| Practitioner.name:Name.prefix | ||
| Practitioner.name:Geburtsname.use | ||
| Practitioner.address | In order to differentiate between post box addresses and physical addresses, street names and house numbers, and to add city district names, vendors can opt to support the extensions as suggested in the German Address Base Profile http://fhir.de/StructureDefinition/address-de-basis. Such differentiations are however not required within the scope of this specification. | |
| Practitioner.address:Strassenanschrift | Straßenanschrift | Ist die Adresse bekannt, unter der ein Arzt 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 die Postfachadresse bekannt, unter der ein Arzt 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 | Ist das Geschlecht des Arztes bekannt, MUSS es bereitgestellt werden. Eine korrekte Kodierung des Geschlechtseintrags 'divers' MUSS per GenderOtherDE-Extension unterstüzt werden. | Geschlecht der Person |
| Practitioner.gender.extension:Geschlecht-Administrativ | ||
| Practitioner.gender.extension:Geschlecht-Administrativ.value[x] |
Interaktionen
Für die Ressource Practitioner MUSS die REST-Interaktion "READ" 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
Valides Minimalbeispiel:
| 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) |