Specification of health data transfer from devices to DiGA (§ 374a SGB V)
| Official URL: https://gematik.de/fhir/hddt/OperationDefinition/hddt-cgm-summary-operation | Version: 0.1.0 | |||
| Draft as of 2025-10-27 | Computable Name: HddtCgmSummaryOperation | |||
The $hddt-cgm-summary operation is defined on the Observation resource type.
It allows clients to request CGM summary data filtered by effective period, and optionally include related device context (Device, DeviceMetric).
Use cases supported by this operation include:
Input Parameters:
effectivePeriodStart (dateTime, optional): Lower bound of the observation effective period.effectivePeriodEnd (dateTime, optional): Upper bound of the observation effective period.related (boolean, optional): If true, the response bundle also contains related Device and DeviceMetric resources.Output Parameter:
result (Reference, required): A Bundle conforming to profile HddtCgmSummary profile containing all matching CGM Observations and, if requested, their related devices.Error handling (OperationOutcome):
MSG_PARAM_UNKNOWN: Returned when an unsupported input parameter is used.MSG_PARAM_INVALID: Returned when a parameter value is invalid (e.g., bad date format).MSG_NO_MATCH: Returned when no matching observations are found.MSG_BAD_SYNTAX: Returned when the request is malformed.| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | effectivePeriodStart | 0..1 | dateTime | Start of effective period | ||
| IN | effectivePeriodEnd | 0..1 | dateTime | End of effective period | ||
| IN | related | 0..1 | boolean | If true, include related Device and DeviceMetric in the result bundle | ||
| OUT | result | 1..1 | Reference (Bundle – HDDT CGM Summary Report) | Result bundle (HTTP 200 OK) containing summary data of measurements and optionally related resources |