PersonImGesundheitsberuf (Practitioner)


Motivation

PersonImGesundheitsberuf können alle denkbaren medizinischen Fachexperten sein, ohne eine Rolle zu spielen. 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.


Kompatibilität

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:

Hinweise zu Inkompatibilitäten können über die Portalseite gemeldet werden..


Profil

idS Σ0..1System.String
useΣ ?!0..1codeBindingFixed Value
typeΣ1..1CodeableConceptBindingPattern
systemΣ1..1uriFixed Value
valueΣ I1..1string
periodΣ I0..1Period
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
displayΣ1..1string
useΣ ?!0..1codeBindingFixed Value
typeΣ1..1CodeableConceptBindingPattern
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
displayΣ1..1string
useΣ ?!0..1codeBinding
typeΣ1..1CodeableConceptBindingPattern
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
activeΣ0..1boolean
useS Σ ?!1..1codeBindingFixed Value
textΣ0..1string
namenszusatzI0..1Extension(string)
nachnameI0..1Extension(string)
vorsatzwortI0..1Extension(string)
givenS Σ1..*string
prefix-qualifierI0..*Extension(code)
suffixΣ0..*string
periodΣ I0..1Period
useS Σ ?!1..1codeBindingFixed Value
textΣ0..1string
namenszusatzI0..1Extension(string)
nachnameI0..1Extension(string)
vorsatzwortI0..1Extension(string)
givenΣ0..0string
suffixΣ0..*string
periodΣ I0..1Period
systemΣ I1..1codeBinding
valueΣ1..1string
useΣ ?!0..1codeBinding
rankΣ0..1positiveInt
periodΣ I0..1Period
StadtteilS I0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingFixed Value
textΣ0..1string
StrasseS I0..1Extension(string)
HausnummerS I0..1Extension(string)
AdresszusatzS I0..1Extension(string)
PostfachI0..0Extension(string)
cityS Σ1..1string
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ1..1stringBinding
startΣ I0..1dateTime
endΣ I0..1dateTime
StadtteilI0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingFixed Value
textΣ0..1string
StrasseI0..0Extension(string)
HausnummerI0..0Extension(string)
AdresszusatzI0..0Extension(string)
PostfachS I0..1Extension(string)
cityS Σ1..1string
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ1..1stringBinding
startΣ I0..1dateTime
endΣ I0..1dateTime
extensionI0..0Extension
url1..1System.StringFixed Value
valueCodingCoding
Data-Absent-ReasonS I0..1Extension(code)
photoI0..*Attachment
identifier0..*Identifier
codingΣ1..*CodingBinding
textΣ0..1string
periodI0..1Period
issuerI0..1Reference(Organization)
communication0..*CodeableConceptBinding


Constraints

Folgende FHIRPath-Constraints sind im Profil zu beachten:

keyseverityhumanexpression
prac-de-1errorDie amtliche Differenzierung der Geschlechtsangabe 'other' darf nur gefüllt sein, wenn das Geschlecht 'other' angegeben istgender='other' or gender.extension('http://fhir.de/StructureDefinition/gender-amtlich-de').empty()

Terminology Bindings

PathNameStrengthURL
Practitioner.qualification.code.codingKBV_VS_Base_Practitioner_Specialitypreferredhttps://fhir.kbv.de/ValueSet/KBV_VS_Base_Practitioner_Speciality

Anmerkungen zu den Must-Support-Feldern

Practitioner.identifier:ANR

Bedeutung: 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.name:name

Bedeutung: 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.address:Strassenanschrift

Bedeutung: Straßenanschrift. Ist die Adresse bekannt, unter der ein Arzt erreichbar ist, MUSS sie bereitgestellt werden.

Practitioner.address:Postfach

Bedeutung: Postfachanschrift. Ist die Postfachadresse bekannt, unter der ein Arzt erreichbar ist, MUSS sie bereitgestellt werden.

Practitioner.gender

Bedeutung: Administratives Geschlecht. Ist das Geschlecht des Arztes bekannt, MUSS es bereitgestellt werden.

Practitioner.birthDate

Bedeutung: Geburtsdatum. Ist das Geburtsdatum des Arztes bekannt, MUSS es bereitgestellt werden.

Practitioner.qualification

Bedeutung: Ärztliche Qualifikation(en). Es MÜSSEN die Qualifikationen des Arztes bereitgestellt werden, um nach Ärzten einer Qualifikation zu suchen oder sie bspw. in Dokumenten anzuzeigen.


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:

  1. Der Suchparameter "_id" MUSS unterstützt werden:

    Beispiele:

    GET [base]/Practitioner?_id=1234567890

    Anwendungshinweise: Weitere Informationen zur Suche nach "_id" finden sich in der FHIR-Basisspezifikation - Abschnitt "Parameters for all resources".

  2. Der Suchparameter "identifier" MUSS unterstützt werden:

    Beispiele:

    GET [base]/Practitioner?identifier=42

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

  3. Der Suchparameter "given" MUSS unterstützt werden:

    Beispiele:

    GET [base]/Practitioner?given=Heidi

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

  4. Der Suchparameter "family" MUSS unterstützt werden:

    Beispiele:

    GET [base]/Practitioner?family=Alpenzauber

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

  5. Der Suchparameter "name" KANN unterstützt werden:

    Beispiele:

    GET [base]/Practitioner?name=Heidi

    GET [base]/Practitioner?name=Alpenzauber

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

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

    Beispiele:

    GET [base]/Practitioner?_profile=<https://gematik.de/fhir/isik/v3/Basismodul/StructureDefinition/ISiKPersonImGesundheitsberuf>

    Anwendungshinweise: Weitere Informationen zur Suche nach "_profile" finden sich in der FHIR-Basisspezifikation - Abschnitt "Parameters for all resources".

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

    Beispiele:

    GET [base]/Practitioner?address=Berlin

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

  8. Der Suchparameter "gender" KANN unterstützt werden:

    Beispiele:

    GET [base]/Practitioner?gender=female

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


Beispiele

Valides Minimalbeispiel PersonImGesundheitsberuf:

{
    "resourceType": "Practitioner",
    "id": "PractitionerWalterArzt",
    "meta": {
        "source": "http://krankenhaus.de",
        "profile":  [
            "https://gematik.de/fhir/isik/v3/Basismodul/StructureDefinition/ISiKPersonImGesundheitsberuf"
        ]
    },
    "name":  [
        {
            "use": "official",
            "text": "Walter Arzt",
            "family": "Arzt",
            "_family": {
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/StructureDefinition/humanname-own-name",
                        "valueString": "Arzt"
                    }
                ]
            },
            "given":  [
                "Walter"
            ]
        },
        {
            "use": "maiden",
            "text": "Gross",
            "family": "Gross",
            "_family": {
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/StructureDefinition/humanname-own-name",
                        "valueString": "Gross"
                    }
                ]
            }
        }
    ],
    "identifier":  [
        {
            "type": {
                "coding":  [
                    {
                        "code": "LANR",
                        "system": "http://terminology.hl7.org/CodeSystem/v2-0203"
                    }
                ]
            },
            "system": "https://fhir.kbv.de/NamingSystem/KBV_NS_Base_ANR",
            "value": "123456789"
        },
        {
            "type": {
                "coding":  [
                    {
                        "code": "DN",
                        "system": "http://terminology.hl7.org/CodeSystem/v2-0203"
                    }
                ]
            },
            "system": "http://fhir.de/sid/bundesaerztekammer/efn",
            "value": "123456789123456"
        }
    ],
    "active": true,
    "address":  [
        {
            "type": "both",
            "line":  [
                "Schmiedegasse 16"
            ],
            "_line":  [
                {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber",
                            "valueString": "16"
                        },
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName",
                            "valueString": "Schmiedegasse"
                        }
                    ]
                }
            ],
            "city": "Potsdam",
            "postalCode": "14469",
            "country": "DE"
        }
    ],
    "gender": "male",
    "qualification":  [
        {
            "code": {
                "coding":  [
                    {
                        "version": "http://snomed.info/sct/900000000000207008/version/20200131",
                        "code": "112247003",
                        "system": "http://snomed.info/sct",
                        "display": "Medical doctor (occupation)"
                    }
                ]
            }
        }
    ],
    "_birthDate": {
        "extension":  [
            {
                "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
                "valueCode": "masked"
            }
        ]
    }
}