Settlement (Abrechnung)

Create a Bilanzkreis (real or virtual)

Creates a balance group definition. Real BKs map to MaBiS interfaces. Virtual BKs aggregate multiple MeLos for internal settlement.

post/api/bilanzkreis

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/bilanzkreis
  • Auth: none declared

Query parameters

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Request body

idstring required
namestring required
type'real' | 'virtual_energy_sharing' | 'virtual_mieterstrom' | 'virtual_arealnetz' | 'virtual_vpp' required
participantsobject[] required
gridOperatorMastrIdstring
validFromstring
validTostring
metadataobject
tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "id": "bk_es_test",
  "name": "Energy Sharing Test-Quartier",
  "type": "virtual_energy_sharing",
  "participants": [
    {
      "meloId": "BK_TEST_PV",
      "role": "producer",
      "share": 1
    },
    {
      "meloId": "BK_TEST_CONSUMER",
      "role": "consumer",
      "share": 1
    }
  ],
  "gridOperatorMastrId": "SNB935578300972",
  "validFrom": "2026-01-01",
  "validTo": "2026-12-31",
  "metadata": {
    "source": "manual"
  }
}

Response

Successful response

object required

Changes

No recorded changes to this operation across all 2 revisions of this API.