Settlement Management API Overview - Engrate Developer Documentation

The Settlement Management API handles the complete MaBiS settlement lifecycle for German balance responsible parties (BRPs). It provides endpoints for managing clearing periods, accessing settlement data, filing objections, and calculating imbalances.

MaBiS clearing lifecycle

Each settlement month (Bilanzierungsmonat) for a balance group goes through a structured clearing process with deadlines based on working days (Werktage) after the end of the settlement month:

Core concepts

Clearing Period: One settlement month for a balance group, tracking status and deadlines.
Clearing Settlement: Daily MSCONS metering data from the TSO/DSO.
Objection: A formal dispute (Einspruch) against settlement values, filed within the objection window.
Control energy prices: reBAP prices received via PRICAT, used for imbalance cost calculation.
Aggregation objects: MaBiS-Zaehlpunkte registered via UTILMD, linking metering points to balance groups.

Key endpoints

Area	Endpoints
Clearing periods	Create, list, get summary with counts and next deadline
Settlements	List daily MSCONS records for a clearing period
Objections	List and submit objections within the clearing window
Messages	List EDIFACT messages (MSCONS, PRICAT, UTILMD, IFTSTA)
Imbalance	Calculate scheduled vs actual energy with reBAP cost
Validation	Check data completeness before submission
Control energy prices	List reBAP prices by TSO area and month
Aggregation objects	List registered MaBiS-Zaehlpunkte with status
Energy volumes	List and summarize MSCONS energy data
Clearing calendar	Compute MaBiS deadlines for any settlement month

Read the Clearing & Settlement Flow concept guide for a deep dive into how MaBiS settlement works end-to-end, from schedule submission through clearing to final billing.

⌘I