Skip to main content
An energy volume record contains metered energy data for a specific MaBiS-Zaehlpunkt, received via MSCONS messages. Each record covers one settlement month and contains interval-level values at the resolution specified by the MSCONS message.

Key fields

FieldDescription
mabis_zp_idThe MaBiS-Zaehlpunkt identifier linking this data to an Aggregation Object
data_statusMaBiS data status — pruefdaten (preliminary check data) or abrechnungsdaten (final billing data)
resolutionInterval resolution: PT15M (quarter-hourly), PT30M (half-hourly), or PT60M (hourly)
unitEnergy unit: KWH or MWH
categoryMSCONS category classifying the type of energy measurement

Data status

StatusGermanMeaning
pruefdatenPrüfdatenPreliminary data for review, may be revised
abrechnungsdatenAbrechnungsdatenFinal billing data, used for definitive settlement

Versioning

Multiple energy volume records can exist for the same MaBiS-ZP and settlement month. Each MSCONS message creates a new record identified by mscons_message_id and message_date. The most recent record represents the current state.

Response model for energy volume records.

bilanzierungsmonat
string
required

Settlement month (YYYY-MM-DD)

category
string
required

MSCONS category

data_status
string
required

MaBiS data status: pruefdaten, abrechnungsdaten

interval_count
integer
required

Number of intervals

mabis_zp_id
string
required

MaBiS-Zählpunkt ID

message_date
string
required

Message timestamp (ISO datetime)

mscons_message_id
string
required

MSCONS message ID (version)

period_end
string
required

Period end (ISO datetime)

period_start
string
required

Period start (ISO datetime)

resolution
string
required

Resolution: PT15M, PT30M, PT60M

total_kwh
number
required

Total energy in kWh

uid
string
required

Energy volume UID

unit
string
required

Unit: KWH, MWH

aggregation_object_uid
string | null

Linked aggregation object UID