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 |
Use GET /mabis/clearing-calendar to compute the exact MaBiS deadlines (Werktag-based) for any settlement month before creating a clearing period.
