Organisation (Organization)


Kompatibilität

Diese Profile ist mit dem KBV_PR_Base_Organization Profil sowie dem KBV_PR_MIO_ULB_Organization Profil kompatibel.

FHIR-Profil

NameCanonical
IsipOrganizationhttps://gematik.de/fhir/isip/v1/Basismodul/StructureDefinition/IsipOrganization
idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
InstitutionskennzeichenS Σ I0..1IdentifierIknr
BetriebsstaettennummerS Σ I0..1IdentifierBsnr
TelematikIdS Σ I0..1IdentifierTelematikId
activeS Σ ?!0..1boolean
typeS Σ1..*CodeableConceptBinding
nameS Σ I1..1string
alias0..*string
id0..1string
extensionI0..*Extension
systemS Σ I1..1codeBinding
valueS Σ1..1string
useS Σ ?!1..1codeBinding
rankΣ0..1positiveInt
periodΣ I0..1Period
id0..1string
StadtteilI0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingPattern
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 Σ I1..1stringBinding
id0..1string
extensionI0..*Extension
startΣ I0..1dateTime
endΣ I0..1dateTime
id0..1string
StadtteilI0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingPattern
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 Σ I1..1stringBinding
id0..1string
extensionI0..*Extension
startΣ I0..1dateTime
endΣ I0..1dateTime
partOfΣ I0..1Reference(Organization)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
purpose0..1CodeableConceptBinding
name0..1HumanName
telecomI0..*ContactPoint
address0..1Address
endpointI0..*Reference(Endpoint)

Terminology Bindings

PathNameStrengthURL
Organization.typeKBV_VS_MIO_ULB_Type_Of_Facilityrequiredhttps://fhir.kbv.de/ValueSet/KBV_VS_MIO_ULB_Type_Of_Facility
Organization.telecom.systemkontaktartenrequiredhttps://gematik.de/fhir/isip/v1/Basismodul/ValueSet/kontaktarten

Anmerkungen zu Must-Support-Feldern

Organization.identifier:Institutionskennzeichen

Bedeutung: Institutskennzeichen der Organisation

Hinweise: Siehe Beschreibung der Deutschen Basisprofile

Organization.identifier:Betriebsstaettennummer

Bedeutung: Betriebsstättennummer der Organisation

Hinweise: Siehe Beschreibung der Deutschen Basisprofile

Organization.identifier:TelematikId

Bedeutung: Telematik-ID der Organisation

Hinweise: Siehe Beschreibung der Deutschen Basisprofile

Organization.active

Bedeutung: Indikator "Organizationdatensatz ist in aktiver Benutzung"

Hinweise: Siehe Beschreibung in der FHIR Kernspezifikation

Organization.type

Bedeutung: Typ der Organisation

Organization.name

Bedeutung: Name der Organisation"

Organization.telecom

Bedeutung: Kontaktmöglichkeit der Organisation

Organization.address

Bedeutung: Adresse der Organisation

Interaktionen

Für die Ressource Organization MUSS die REST-Interaktion "READ" implementiert werden.

Für die Ressource Organization KANN die REST-Interaktion "POST" implementiert werden. Diese Interaktion dient für die Vorabübermittelung von (unverifizierten und/oder unvollständigen) Organizationenstammdaten.

  • Das bestätigungsrelevante System SOLLTE die übermittelte Organization-Ressource löschen oder als inaktiv kennzeichnen, insoweit Geschäftsregeln oder andere Gründe dazu führen, dass die Organization-Ressource nicht permanent im System angelegt wird (z.B. keine Bestätigung durch die Anwender*in des Systems oder keine Aufnahme der Organization*in).

Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Kombination:

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

    Beispiele:

    GET [base]/Organization?_id=103270

    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]/Organization?identifier=https://gematik.de/fhir/sid/telematik-id|1234567890

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

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

    Beispiele:

    GET [base]/Organization?type=http://snomed.info/sct|42665001

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

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

    Beispiele:

    GET [base]/Organization?name=Haus%20am%20See

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

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

    Beispiele:

    GET [base]/Organization?active=true

    Anwendungshinweise: Weitere Informationen zur Suche nach "Patient.active" finden sich in der FHIR-Basisspezifikation - Abschnitt "Token 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".

Beispiele

Valides Minimalbeispiel Patient:

{
    "resourceType": "Organization",
    "id": "ExampleIsipOrganization",
    "meta": {
        "profile":  [
            "https://gematik.de/fhir/isip/v1/Basismodul/StructureDefinition/IsipOrganization"
        ]
    },
    "identifier":  [
        {
            "system": "https://gematik.de/fhir/sid/telematik-id",
            "value": "1234567890"
        }
    ],
    "active": true,
    "name": "Haus am See",
    "type":  [
        {
            "coding":  [
                {
                    "code": "42665001",
                    "system": "http://snomed.info/sct",
                    "display": "Nursing home (environment)"
                }
            ]
        }
    ],
    "address":  [
        {
            "type": "both",
            "line":  [
                "Musterweg 2",
                "3. Etage"
            ],
            "_line":  [
                {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName",
                            "valueString": "Musterweg"
                        },
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber",
                            "valueString": "2"
                        }
                    ]
                },
                {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator",
                            "valueString": "3. Etage"
                        }
                    ]
                }
            ],
            "city": "Musterhausen",
            "postalCode": "98764",
            "country": "DE"
        },
        {
            "type": "postal",
            "line":  [
                "Postfach 8 15"
            ],
            "_line":  [
                {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-postBox",
                            "valueString": "Postfach 8 15"
                        }
                    ]
                }
            ],
            "city": "Musterhausen",
            "postalCode": "98764",
            "country": "DE"
        }
    ]
}