Skip to main content
This guide explains the MaBiS settlement process end-to-end. It covers what happens after schedules are submitted, how clearing works, and what your integration needs to handle at each phase.

​
What is MaBiS?

MaBiS (Marktregeln für die Durchführung der Bilanzkreisabrechnung Strom) is the German framework governing how balance responsible parties (BRPs) settle their energy accounts with Transmission System Operators (TSOs). It defines the rules for measuring what actually happened on the grid, comparing it to what was declared in schedules, and settling any differences. The Settlement Management API implements this process, handling EDIFACT message exchange (MSCONS, PRICAT, UTILMD, IFTSTA) and providing structured access to clearing data.

​
The clearing cycle

Each settlement month goes through a structured process with deadlines calculated in working days (Werktage) after month end:

​
Key milestones

MilestoneTimingWhat happens
ErstaufschlagM+10/12 WTFirst aggregation summaries (SZR) are published by the TSO
Clearing startM+11/13 WTTSO/DSO begin sending MSCONS settlement data
Preliminary billingM+18 WTFirst complete settlement figures available
Objection windowM+18 to M+30 WTBRPs can file objections against disputed values
Final billingM+42 WTDefinitive settlement — no further changes
Use GET /mabis/clearing-calendar to compute exact dates for any settlement month.

​
Settlement flow

​
1. Create a clearing period

Before receiving settlement data, create a Clearing Period for the balance group and month: 
POST /mabis/clearing-periods
{
  "bilanzkreis_eic": "11XEXAMPLE-BKV-A",
  "bilanzierungsmonat": "2026-01-01"
}
The platform computes MaBiS deadlines automatically based on the clearing calendar.

​
2. Receive settlement data

As MSCONS messages arrive from the TSO/DSO, the platform parses them and stores daily Clearing Settlement records. Each record contains raw interval values for one day. Track message flow via GET /mabis/clearing-periods/{uid}/messages — you’ll see MSCONS (metering data), PRICAT (prices), UTILMD (registrations), and IFTSTA (status reports).

​
3. Review and calculate imbalance

Once settlement data is available, calculate the Imbalance for the clearing period: 
GET /mabis/clearing-periods/{uid}/imbalance
This compares your scheduled energy against actual metered energy for each day, applies reBAP Control Energy Prices, and returns the total financial impact.

​
4. File objections if needed

If settlement values are wrong, file an Objection within the objection window (M+18 to M+30 WT): 
POST /mabis/clearing-periods/{uid}/objections
{
  "objection_type": "volume",
  "disputed_values": {
    "date": "2026-01-15",
    "interval": 42,
    "our_value_mwh": 1.5,
    "tso_value_mwh": 1.8
  },
  "reason": "Metering data does not match our records"
}
The TSO will respond with acceptance or rejection via UTILMD.

​
5. Validate before deadline

Before each deadline, validate data completeness: 
GET /mabis/clearing-periods/{uid}/validate
This checks that all expected settlement days have data, message counts are consistent, and no data gaps exist.

​
Imbalance calculation

Imbalance is the core financial metric in MaBiS settlement. It represents the difference between what you declared (scheduled) and what actually happened (metered). Per interval: 
imbalance = actual_energy - scheduled_energy
Financial impact: 
cost = imbalance × reBAP_price
A positive imbalance means actual exceeded scheduled (more consumption or less generation than declared) — you buy the difference at the reBAP price. A negative imbalance means scheduled exceeded actual — you sell the surplus at the reBAP price. The reBAP is a uniform price across all control areas (regelzonenübergreifend), updated quarter-hourly. It can be significantly higher or lower than market prices, creating a strong incentive for accurate scheduling.

​
Aggregation objects

Aggregation objects (MaBiS-Zaehlpunkte) are virtual metering points that group physical meters for settlement purposes. They bridge the gap between physical metering infrastructure and the abstract balance group structure used for settlement. Each aggregation object has:
  • A type (BAS, FPE, FPI, SLP, RLM) defining what kind of energy data it aggregates
  • A TSO area and DSO linking it to the grid topology
  • A balance group EIC associating it with your Bilanzkreis
  • A validity period defining when the registration is active
The API receives aggregation object registrations via UTILMD messages and exposes them through GET /mabis/aggregation-objects.

​
The clearing calendar

MaBiS deadlines are based on working days — weekends and German public holidays are excluded. This makes exact deadline computation non-trivial. The clearing calendar endpoint handles this: 
GET /mabis/clearing-calendar?bilanzierungsmonat=2026-01-01
The response includes all phase boundaries and the current_phase field indicating where the month currently stands in the process. See Clearing Calendar for the full field reference.

​
Monthly summary

For a consolidated view of energy and costs per aggregation object, use the monthly summary: 
GET /mabis/energy-volumes/{mabis_zp_id}/monthly-summary
This combines Energy Volume data with Control Energy Price data to produce a Monthly Summary with total energy, total cost, and average price.
See the Settlement Management API Overview for a quick reference of all endpoints and the clearing lifecycle diagram.