Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Finding one or more Organization

Most FHIR Organization in the eHealth Infrastructure are automatically created and updated as described in Organization import and synchronization . Most organisations including municipal ones are imported from the Health Organisation Registry (SOR), but for municipal organisations, separate FHIR Organization resources are created as result of importing from the municipal KOMBIT system STS-ORG. Depending on how municipal organisations are registered in SOR and STS-ORG, this can lead to duplicate FHIR Organization for municipal organisations.

In the table below, the different types of organisations and their use is shown. General use covers use at login and as security context, use as modifier-role (owner, co-author) and in intended audience of Telemedicine Packages, use when assigning managing organisations, and unless otherwise stated, in transformations to/from CDA documents (see https://ehealth-dk.atlassian.net/wiki/spaces/EDTW/pages/538935313/Behind+the+Scenes#Sharing-through-Registering-Documents-in-National-Document-Sharing-Infrastructure ).

...

Type

...

Source

...

Use

...

Regional

...

SOR

...

General

...

General Practitioner

...

SOR

...

General

...

Municipal

...

SOR

...

In CDA documents

...

Other

...

SOR

...

General

...

Municipal

...

STS-ORG

...

General, except in CDA documents

...

SSL Organization

...

Manual

...

Limited

Finding a Municipal Organization

Finding one or more CareTeam

...

Info

When finding Organization, the origin and use must be taken into account.

Finding all sub Organization in an Organization Tree

Retrieving an Organization and its entire Organization tree of sub Organization can be performed as an Organization Search that utilizes the :iterate modifier:

GET <base-url>/fhir/Organization?_id=<ID>&_revinclude:iterate=Organization:partof

Info

Example request for finding the entire Organization Tree under Organization/123

GET <base-url>/fhir/Organization?_id=123&_revinclude:iterate=Organization:partof

To retrieve an Organization and only immediate sub Organization of an Organization, use:

GET <base-url>/fhir/Organization?_id=<ID>&_revinclude=Organization:partof

Finding all parent Organization

Retrieving an Organization and all its parent Organization transitively, can be performed as an Organization Search that utilizes the :iterate modifier:

GET <base-url>/fhir/Organization?_id=<ID>&_include:iterate=Organization:partof

Info

Example request for finding all parents transitively of Organization/123

GET <base-url>/fhir/Organization?_id=123&_include:iterate=Organization:partof

To retrieve an Organization and only its immediate parent Organization , use:

GET <base-url>/fhir/Organization?_id=<ID>&_include=Organization:partof

Finding all parent and sub Organization in an Organization Tree

The above searches can be combined to retrieve all parents transitively and all sub Organization under an Organization:

GET <base-url>/fhir/Organization?_id=<ID>&_revinclude:iterate=Organization:partof&_include:iterate=Organization:partof

Finding all top-level OrganizationEnhed in an Organization Tree

To retrieve all top-level OrganizationEnhed, use:

GET <base-url>/Organization?active=true&source=STS-ORG&partof:missing=true

Finding a Municipal Organization

See example operations here

Finding one or more CareTeam

See example operations here

Finding one or more Practitioner

See example operations here