Interface and system documentation

Actors on the Finnish electricity retail market will mainly use the Datahub system through technical interfaces. The Datahub project will publish interface specifications including message descriptions on this page. The target group of the material is primarily system developers that implement Datahub integration in their own applications.

The interface specifications will be updated as the Datahub implementation project proceeds. The project will inform about updates separately through the datahub news.

Datahub External Interface Specification 1.0
The Datahub External Interface Specification document describes the technical implementation of the Datahub B2B SOAP interface. The document is intended as a guide for application developers and / or integration experts who implement the integration between the external system associated with the Datahub.
Datahub Fingrid Schemas 1.7
The schema descriptions of the Datahub-system.
Important to notice about the schemas
The following changes in the process documentation are not yet in the published shemas.
Accounting point type value  AG03="Production unit’s own consumption" moved to Accounting point subtype information.
Accounting points attribute "Property accounting point" named to Accounting point subtype with values AQ01="Normal", AQ02="Property accounting point" and AQ03="Production unit’s own consumption"
A new attribute has been added to accounting point characteristics, "Metering time step", that is not yet in the published schema. This part of the changes needed for 15-minutes balance settlement. This is temporal accuracy of metering data that is reported to accounting point.
From the message F04 -Structural data, agreement data field "Contract start date" has been removed. The schema still requires the element <ContractStart> so it is mandatory. The element can be freely filled with any time-stamp value because it is not used even though it is mandatory.
Release Notes Datahub 0.1
The document includes the release notes for the Fingrid Datahub version 0.1 (Stage 1, release 1). The document describes the implemented functionalities and known deviations and defects in the release. Release includes a B2B message interface using SOAP and a web browser GUI portal.