DH-221 Metering data request – supplier
Event description
A supplier retrieves metering data for which it has rights from Datahub.
If a supplier requests metering data for an accounting point using the DH-221 process with the supplier process role (DDQ), Datahub will only return data permitted by the agreement situation. If the supplier has an authorization from the customer that entitles it to access metering data for a longer period, Datahub will not return this data in response to the DH-221 process. If the supplier wishes to retrieve metering data for the period allowed by the authorization, they must use the DH-223 process and the service provider process role (ESC).
Parties
Supplier
Datahub
Important considerations for event handling
If metering data is requested at a higher resolution than the resolution stored in Datahub, the status of the value is set to the weakest status within the time step.
If time series are requested as sum values and output values have one or more (not all) values with status ‘missing’, the sum value will have status ‘partially missing’.
Event processing in Datahub
Step | Description |
Unit and/or time step conversion | Modification of a unit and/or time step from an internal Datahub unit to a unit and time step requested by the supplier. If the time step is not specified, the request will return time series in the time step that it is stored in Datahub. |
Asynchronous data retrieval | Metering data retrieval is implemented asynchronously due to the large amount of data. Datahub prioritizes synchronous calls over the request, and metering data retrieval is processed in the background. The duration of processing depends on the amount of data retrieved. At the end of processing, the response message is returned asynchronously to the party’s message queue. |
Return of information
Party | Description | Message |
|---|---|---|
Supplier | The metering data for the requested metering points or rejection of the request. Only the metering data for which the party has rights will be returned. The results of the request are returned in messages of which each contains at most 10 000 metering time series and each metering time series contains at most 10 000 time series values. Depending on the amount of requested data, there may be one or several messages to be returned. |
Validation rules
Please see Datahub Validation Rules for a more thorough list.
Rule | Error code | Note |
|---|---|---|
When all metering points are part of the query, the query period is at most 7 days. | EC-MDM-RMV-201 |
|
The query unit is an energy unit. | EC-MDM-RMV-001 |
|
The query period is not in the future or more than 6 years in the past. |
|
|
|
|
|
Please observe that the list is not complete. | ||