​BfArM Digitale Anwendungen - Local Development build (v3.0.2-RC1) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

HIIS – Use Cases

The returned id values of resources must not be stored on external systems, as they may change in new versions of the API. Instead, the identifier values stored in the resources must be used.

Depending on the software used, URL encoding of parameters may be required, for example HiisId%7C00123 instead of HiisId|00123.

The results returned by the API are paginated in accordance with FHIR®. The total number of results across all pages is available in the meta.total element. The FHIR® server uses a default page size of 20 elements. Further pages are linked via the link element. The number of results per page can be set using the _count parameter.

Retrieval of Medical Aid Interfaces

Search for a Medical Aid Interface by HIIS ID

Description

This use case describes the search for a medical aid interface (profile HiisDeviceDataRecorderDefinition) by the unique HIIS ID.

Standard Flow

1. Search request with the HIIS ID as identifier parameter
2. HIIS API returns the found medical aid interface entry

API Request

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?identifier=https://fhir.bfarm.de/Identifier/HiisId|{HIIS-ID}&_profile=https://fhir.bfarm.de/StructureDefinition/HiisDeviceDataRecorderDefinition

Example (HIIS ID "00123"):

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?identifier=https://fhir.bfarm.de/Identifier/HiisId|00123&_profile=https://fhir.bfarm.de/StructureDefinition/HiisDeviceDataRecorderDefinition

Search for Medical Aid Interface Entries by MIV Set URL

Description

This use case describes the search for medical aid interface entries (profile HiisDeviceDataRecorderDefinition) that support a specific MIV Set (Mandatory Interoperable Value Set). The MIV Set is referenced via the extension HiisDeviceDefinitionMivSet.

Standard Flow

1. Search request with the MIV Set as filter criterion
2. HIIS API returns the found medical aid interface directory entries

API Request

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisDeviceDataRecorderDefinition&miv-set={MIV-Set-Reference}

Example (MIV Set URL "https://gematik.de/fhir/hddt/ValueSet/hddt-miv-continuous-glucose-measurement"):

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisDeviceDataRecorderDefinition&miv-set=https://gematik.de/fhir/hddt/ValueSet/hddt-miv-continuous-glucose-measurement

The search uses the custom search parameter miv-set, which accesses the nested extension HiisDeviceDefinitionMivSet.extension[mivSet].valueReference.

Search for Medical Aid Interface Entries by Manufacturer Name

Description

This use case describes the search for medical aid interface entries (profile HiisDeviceDataRecorderDefinition) based on the manufacturer name. The manufacturer is referenced via manufacturerReference.

Standard Flow

1. Search request with the manufacturer name as filter criterion
2. HIIS API returns the found medical aid interface entries

API Request

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisDeviceDataRecorderDefinition&manufacturer-name={Manufacturer-Name}

Example (manufacturer name "TechMed Solutions"):

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisDeviceDataRecorderDefinition&manufacturer-name=TechMed%20Solutions

For substring search (LIKE search), the modifier :contains can be used:

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisDeviceDataRecorderDefinition&manufacturer-name:contains=TechMed

The search uses the custom search parameter manufacturer-name, which accesses manufacturerReference.display.

Search for Medical Aid Interface Entries by Medical Aid Interface Name

Description

This use case describes the search for medical aid interface entries (profile HiisDeviceDataRecorderDefinition) based on the medical aid interface name. The name is located in deviceName with type model-name.

Standard Flow

1. Search request with the medical aid interface name as filter criterion
2. HIIS API returns the found medical aid interface entries

API Request

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisDeviceDataRecorderDefinition&device-name={Medical-Aid-Interface-Name}

Example (medical aid interface name "DataConnect Interface"):

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisDeviceDataRecorderDefinition&device-name=DataConnect%20Interface

For substring search (LIKE search), the modifier :contains can be used:

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisDeviceDataRecorderDefinition&device-name:contains=DataConnect

The search uses the custom search parameter device-name, which accesses DeviceDefinition.deviceName.where(type='model-name').name.

Retrieval of All Medical Aid Interfaces Supporting a Specific Medical Aid

Description

This use case describes the retrieval of all medical aid interface entries (profile HiisDeviceDataRecorderDefinition) that support a specific medical aid (profile HiisPersonalHealthDeviceDefinition). It is assumed that the medical aid has already been determined by a previous search and the internal id is known. The relationship is established via the extension DeviceDefinitionLink with the complex extension relatedDevice, where relation.valueCoding.code = "supports" must hold.

Standard Flow

1. Call of the $supporting-interfaces operation with the internal id of the previously determined medical aid

API Request

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition/{id}/$supporting-interfaces

Example (internal id "1"):

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition/1/$supporting-interfaces

This operation returns a bundle of type searchset with all medical aid interface resources (HiisDeviceDataRecorderDefinition) that support this medical aid. The operation searches all medical aid interfaces and returns only those where the extension DeviceDefinitionLink contains a reference to the requested medical aid and relation.valueCoding.code = "supports" holds.

The operation does not use pagination.

Retrieval of Medical Aid Interface Endpoints

Retrieval of All Endpoints Linked to a Medical Aid Interface

Description

This use case describes the retrieval of all endpoint entries (profile HiisDeviceDataRecorderEndpoint) that are linked to a specific medical aid interface (profile HiisDeviceDataRecorderDefinition). It is assumed that the medical aid interface has already been determined by a previous search and the internal id is known. The link is established via the extension HiisDeviceDataRecorderEndpointLink, which is defined on the medical aid interface and references the endpoints.

Standard Flow

1. Call of the $endpoints operation with the internal id of the previously determined medical aid interface

API Request

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition/{id}/$endpoints

Example (internal id "1"):

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition/1/$endpoints

This operation returns a bundle of type searchset with all endpoint resources (HiisDeviceDataRecorderEndpoint) that are referenced in the extension HiisDeviceDataRecorderEndpointLink of the medical aid interface.

The operation does not use pagination.

Retrieval of Medical Aids

Search for Medical Aid Entries by MIV Set URL

Description

This use case describes the search for medical aid entries (profile HiisPersonalHealthDeviceDefinition) that support a specific MIV Set (Mandatory Interoperable Value Set). The MIV Set is referenced via the extension HiisDeviceDefinitionMivSet.

Standard Flow

1. Search request with the MIV Set as filter criterion
2. HIIS API returns the found medical aid entries

API Request

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisPersonalHealthDeviceDefinition&miv-set={MIV-Set-Reference}

Example (MIV Set URL "https://gematik.de/fhir/hddt/ValueSet/hddt-miv-continuous-glucose-measurement"):

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisPersonalHealthDeviceDefinition&miv-set=https://gematik.de/fhir/hddt/ValueSet/hddt-miv-continuous-glucose-measurement

The search uses the custom search parameter miv-set, which accesses the nested extension HiisDeviceDefinitionMivSet.extension[mivSet].valueReference.

Search for Medical Aid Entries by Manufacturer Name

Description

This use case describes the search for medical aid entries (profile HiisPersonalHealthDeviceDefinition) based on the manufacturer name. The manufacturer is referenced via manufacturerReference.

Standard Flow

1. Search request with the manufacturer name as filter criterion
2. HIIS API returns the found medical aid entries

API Request

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisPersonalHealthDeviceDefinition&manufacturer-name={Manufacturer-Name}

Example (manufacturer name "HealthDevice Corp"):

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisPersonalHealthDeviceDefinition&manufacturer-name=HealthDevice%20Corp

For substring search (LIKE search), the modifier :contains can be used:

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisPersonalHealthDeviceDefinition&manufacturer-name:contains=HealthDevice

The search uses the custom search parameter manufacturer-name, which accesses manufacturerReference.display.

Search for Medical Aid Entries by Device Name

Description

This use case describes the search for medical aid entries (profile HiisPersonalHealthDeviceDefinition) based on the device name. The name is located in deviceName with type model-name.

Standard Flow

1. Search request with the device name as filter criterion
2. HIIS API returns the found medical aid entries

API Request

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisPersonalHealthDeviceDefinition&device-name={Device-Name}

Example (device name "Health Monitor 2000"):

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisPersonalHealthDeviceDefinition&device-name=Health%20Monitor%202000

For substring search (LIKE search), the modifier :contains can be used:

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisPersonalHealthDeviceDefinition&device-name:contains=Health

The search uses the custom search parameter device-name, which accesses DeviceDefinition.deviceName.where(type='model-name').name.

Combined Search for Medical Aid Entries by Device Name, Model Number, or Device Type Code

Description

This use case describes the combined search for medical aid entries (profile HiisPersonalHealthDeviceDefinition) based on device name (deviceName with type model-name), model number (modelNumber), or device type code (type). The search queries all three fields simultaneously.

Standard Flow

1. Search request with search term for device name, model number, or type code
2. HIIS API returns the found medical aid entries

API Request

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisPersonalHealthDeviceDefinition&device-search={Search-Term}

Example (search term "HMX-2000"):

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisPersonalHealthDeviceDefinition&device-search=HMX-2000

For substring search (LIKE search), the modifier :contains can be used:

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HiisPersonalHealthDeviceDefinition&device-search:contains=HMX

The search uses the custom search parameter device-search, which accesses DeviceDefinition.deviceName.where(type='model-name').name | DeviceDefinition.modelNumber | DeviceDefinition.type.coding.code.

Retrieval of All Medical Aids Supported by a Specific Medical Aid Interface

Description

This use case describes the retrieval of all medical aid entries (profile HiisPersonalHealthDeviceDefinition) that are supported by a specific medical aid interface (profile HiisDeviceDataRecorderDefinition). It is assumed that the medical aid interface has already been determined by a previous search and the internal id is known. The relationship is established via the extension DeviceDefinitionLink with the complex extension relatedDevice, where relation.valueCoding.code = "supports" must hold.

Standard Flow

1. Call of the $supported-devices operation with the internal id of the previously determined medical aid interface

API Request

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition/{id}/$supported-devices

Example (internal id "1"):

GET https://hiis.bfarm.de/api/fhir/v3.0/DeviceDefinition/1/$supported-devices

This operation returns a bundle of type searchset with all supported medical aid resources (HiisPersonalHealthDeviceDefinition). The operation searches the extension DeviceDefinitionLink of the medical aid interface and returns only the medical aids where relation.valueCoding.code = "supports" holds.

The operation does not use pagination.