Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.engrate.io/llms.txt

Use this file to discover all available pages before exploring further.

A clearing settlement contains one day’s metering data within a Clearing Period. The data originates from MSCONS messages sent by the TSO or DSO, containing quarter-hourly metered energy values.

​
Structure

Each settlement record contains:
  • date — the specific delivery day within the settlement month
  • values — raw interval data from the MSCONS message, structure varies by message type and data category
A complete clearing period for a 31-day month will have 31 settlement records, one per day.

​
Data flow

Settlement data arrives via EDIFACT MSCONS messages. The platform parses these messages and stores the interval values per day. The raw values are preserved as received — use the imbalance calculation endpoint to compare scheduled versus actual energy.

A Clearing Settlement representing one day's settlement data within a clearing period, containing raw MSCONS interval values.

​
clearing_period_uid
string
required

Parent Clearing Period identifier.

​
created_ts
string
required

ISO 8601 datetime when this record was created.

Example:

"2026-02-20T08:00:00+00:00"

​
date
string
required

Settlement date in ISO 8601 format.

Example:

"2026-01-15"

​
last_modified_ts
string
required

ISO 8601 datetime of the most recent update.

Example:

"2026-02-20T08:00:00+00:00"

​
uid
string
required

Unique identifier for this settlement record.

Example:

"d6e7f8a9-b0c1-4d2e-8f3a-4b5c6d7e8f9a"

​
values
Values · object
required

Raw interval values from the MSCONS message. Structure varies by message type.