> ## 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.

# Settlement Management API Overview

> MaBiS clearing periods, settlements, objections, and energy volumes

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:

```mermaid theme={null}
%%{init: {'theme': 'base'}}%%
flowchart LR
    subgraph phase1["Erstaufschlag"]
        erst("M+10 WT\nBG-SZR published")
    end
    subgraph phase2["Clearing"]
        clear("M+13 WT\nClearing starts")
        prelim("M+18 WT\nPreliminary billing")
    end
    subgraph phase3["Objection Window"]
        objection("M+18 to M+30 WT\nObjections allowed")
    end
    subgraph phase4["Final"]
        final("M+42 WT\nFinal settlement")
    end
    phase1 --> phase2
    phase2 --> phase3
    phase3 --> phase4
```

## Core concepts

* **[Clearing Period](/api-reference/settlement-management/models/clearing-period)**: One settlement month for a balance group, tracking status and deadlines.
* **[Clearing Settlement](/api-reference/settlement-management/models/clearing-settlement)**: Daily MSCONS metering data from the TSO/DSO.
* **[Objection](/api-reference/settlement-management/models/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        |

<Tip>
  Read the [Clearing & Settlement Flow](/api-reference/settlement-management/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.
</Tip>