Billing data for balancing group settlement, …

START_ABR_BK (NB)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (2):

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "BILANZIERUNG": [
      {
        "aggregationsverantwortung": "UENB",
        "bilanzkreis": "bilanzkreis",
        "datenqualitaet": "ERWARTETE_DATEN",
        "detailsPrognosegrundlage": [
          "SLP_SEP"
        ],
        "gueltigkeitszeitraum": {
          "zeitraumId": 0
        },
        "jahresverbrauchsprognose": {
          "einheit": "W",
          "wert": 0
        },
        "lastprofile": [
          {
            "bezeichnung": "bezeichnung",
            "einspeisung": true,
            "profilart": "ART_STANDARDLASTPROFIL",
            "profilschar": "profilschar",
            "tagesparameter": {
              "dienstanbieter": "dienstanbieter",
              "herausgeber": "herausgeber",
              "klimazone": "klimazone",
              "temperaturmessstelle": "temperaturmessstelle"
            },
            "verfahren": "SYNTHETISCH"
          }
        ],
        "prognosegrundlage": "WERTE",
        "temperaturarbeit": {
          "einheit": "W",
          "wert": 0
        },
        "zeitreihentyp": "EGS"
      }
    ],
    "MARKTLOKATION": [
      {
        "bilanzierungsgebiet": "bilanzierungsgebiet",
        "datenqualitaet": "ERWARTETE_DATEN",
        "gueltigkeitszeitraum": {
          "zeitraumId": 0
        },
        "marktlokationsId": "marktlokationsId",
        "marktrollen": [
          {
            "marktrolle": "NB",
            "rollencodenummer": "rollencodenummer"
          }
        ],
        "regelzone": "regelzone",
        "energierichtung": "AUSSP"
      }
    ],
    "VERWENDUNGSZEITRAUM": [
      {
        "datenqualitaet": "ERWARTETE_DATEN",
        "verwendungAb": "2024-08-25T15:00:00Z",
        "verwendungBis": "2024-08-25T15:00:00Z",
        "zeitraumId": 0
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "pruefidentifikator": "55126",
    "sparte": "STROM",
    "transaktionsgrund": "transaktionsgrund",
    "transaktionsgrundergaenzung": "transaktionsgrundergaenzung"
  },
  "zusatzdaten": {
    "eventname": "START_ABR_BK",
    "prozessId": "prozessId"
  }
}'

START_ABR_BK (NB) › Request Body

The body of this call — one column per admissible Prüfidentifikator. A value in the column means the field belongs to that Prüfidentifikator: Must where the schema requires it, otherwise May.

Structure (BO4E)	Description	Format	55126	55613	55672	55674
stammdaten*	—	object	Muss	Muss	Muss	Muss
BILANZIERUNG[ ]	—	object[]	Kann	Kann	Kann	Kann
`aggregationsverantwortung`00010	Aggregation responsibility	string	Kann		Kann
`UENB`			Kann		Kann
`VNB`			Kann		Kann
`bilanzkreis`00020	Balancing group	string	Kann	Kann	Kann	Kann
`datenqualitaet`00030	Data quality	string	Kann	Kann	Kann
`ERWARTETE_DATEN`			Kann	Kann	Kann
`IM_SYSTEM_VORHANDENE_DATEN`			Kann	Kann	Kann
`INFORMATIVE_DATEN`			Kann	Kann	Kann
`GUELTIGE_DATEN`			Kann	Kann	Kann
`KEINE_DATEN`			Kann	Kann	Kann
`IM_SYSTEM_KEINE_DATEN_VORHANDEN`			Kann	Kann	Kann
`KEINE_DATEN_ERWARTET`			Kann	Kann	Kann
`DIFFERENZ_DATEN`			Kann	Kann	Kann
`DIFFERENZ_ERWARTETE_DATEN`			Kann	Kann	Kann
`DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN`			Kann	Kann	Kann
`detailsPrognosegrundlage`[ ]00040	Profile type	string[]	Kann	Kann	Kann
`SLP_SEP`			Kann	Kann	Kann
`TLP_TEP`			Kann	Kann	Kann
`TEP`			Kann	Kann	Kann
`GEWERBE_ALLGEMEIN`			Kann	Kann	Kann
`GEWERBE_WERKTAGS_8_18_UHR`			Kann	Kann	Kann
`GEWERBE_MIT_STARKEM_BIS_UEBERWIEGENDEM_VERBRAUCH_IN_DEN_ABENDSTUNDEN`			Kann	Kann	Kann
`GEWERBE_DURCHLAUFEND`			Kann	Kann	Kann
`GEWERBE_LADEN_FRISEUR`			Kann	Kann	Kann
`GEWERBE_BAECKEREI_MIT_BACKSTUBE`			Kann	Kann	Kann
`GEWERBE_WOCHENENDBETRIEB`			Kann	Kann	Kann
`LANDWIRTSCHAFTSBETRIEBE_ALLGEMEIN`			Kann	Kann	Kann
`LANDWIRTSCHAFTSBETRIEBE_MIT_MILCHWIRTSCHAFT_NEBENERWERBS_TIERZUCHT`			Kann	Kann	Kann
`LANDWIRTSCHAFT_OHNE_MILCHVIEH`			Kann	Kann	Kann
`HAUSHALT`			Kann	Kann	Kann
`BANDLAST`			Kann	Kann	Kann
`UNTERBRECHBARE_VERBRAUCHSEINRICHTUNG`			Kann	Kann	Kann
`HEIZWAERMESPEICHER`			Kann	Kann	Kann
`STRASSENBELEUCHTUNG`			Kann	Kann	Kann
`PHOTOVOLTAIK_MARKTLOKATION`			Kann	Kann	Kann
`BLOCKHEIZKRAFTWERK`			Kann	Kann	Kann
`SONSTIGE_VERBRAUCHENDE_MARKTLOKATION`			Kann	Kann	Kann
`SONSTIGE_ERZEUGENDE_MARKTLOKATION`			Kann	Kann	Kann
`E_MOBILITAET_LADEPUNKT_IM_OEFFENTLICHEN_BEREICH`			Kann	Kann	Kann
`E_MOBILITAET_LADEPUNKT_EINES_HAUSHALTS`			Kann	Kann	Kann
`E_MOBILITAET_LADEPUNKT_EINES_GEWERBES`			Kann	Kann	Kann
`prognosegrundlage`00050	Forecast basis	string	Kann	Kann	Kann	Kann
`WERTE`			Kann	Kann	Kann	Kann
`PROFILE`			Kann	Kann	Kann	Kann
`zeitreihentyp`00060	Time series type	string	Kann	Kann	Kann	Kann
`EGS`			Kann	Kann	Kann	Kann
`LGS`			Kann	Kann	Kann	Kann
`NZR`			Kann	Kann	Kann	Kann
`SES`			Kann	Kann	Kann	Kann
`SLS`			Kann	Kann	Kann	Kann
`TES`			Kann	Kann	Kann	Kann
`TLS`			Kann	Kann	Kann	Kann
`SLS_TLS`			Kann	Kann	Kann	Kann
`SES_TES`			Kann	Kann	Kann	Kann
gueltigkeitszeitraum	—	object	Kann	Kann	Kann
`zeitraumId`00070	zeitraumId	integer	Kann	Kann	Kann
jahresverbrauchsprognose	—	object	Kann	Kann	Kann
`einheit`00080	Unit: measurands that can be determined by measurement or by specification	string	Kann	Kann	Kann
`W`			Kann	Kann	Kann
`WH`			Kann	Kann	Kann
`KW`			Kann	Kann	Kann
`KWH`			Kann	Kann	Kann
`KVARH`			Kann	Kann	Kann
`MW`			Kann	Kann	Kann
`MWH`			Kann	Kann	Kann
`STUECK`			Kann	Kann	Kann
`KUBIKMETER`			Kann	Kann	Kann
`STUNDE`			Kann	Kann	Kann
`TAG`			Kann	Kann	Kann
`MONAT`			Kann	Kann	Kann
`JAHR`			Kann	Kann	Kann
`PROZENT`			Kann	Kann	Kann
`ANZAHL`			Kann	Kann	Kann
`VAR`			Kann	Kann	Kann
`KVAR`			Kann	Kann	Kann
`VARH`			Kann	Kann	Kann
`KWHK`			Kann	Kann	Kann
`Z16`			Kann	Kann	Kann
`KWT`			Kann	Kann	Kann
`wert`00090	Value	number (float)	Kann	Kann	Kann
lastprofile[ ]	—	object[]	Kann	Kann	Kann
`bezeichnung`00100	Additional designation, e.g. Zählwerk_Wirkarbeit.	string	Kann	Kann	Kann
`einspeisung`00110	Feed-in indicator	boolean	Kann	Kann	Kann
`profilart`00120	Profile category	string	Kann	Kann	Kann
`ART_STANDARDLASTPROFIL`			Kann	Kann	Kann
`ART_TAGESPARAMETERABHAENGIGES_LASTPROFIL`			Kann	Kann	Kann
`ART_LASTPROFIL`			Kann	Kann	Kann
`profilschar`00130	Profile set of the profile	string	Kann		Kann
`verfahren`00140	Profiling method	string	Kann	Kann	Kann
`SYNTHETISCH`			Kann	Kann	Kann
`ANALYTISCH`			Kann	Kann	Kann
tagesparameter	—	object	Kann		Kann
`dienstanbieter`00150	dienstanbieter	string	Kann		Kann
`herausgeber`00160	Issuer of the load profile	string	Kann		Kann
`klimazone`00170	klimazone	string	Kann		Kann
`temperaturmessstelle`00180	temperaturmessstelle	string	Kann		Kann
`referenzprofilbezeichnung`00190	Designation of the reference profile	string			Kann
temperaturarbeit	—	object	Kann		Kann
`einheit`00200	Unit: measurands that can be determined by measurement or by specification	string	Kann		Kann
`W`			Kann		Kann
`WH`			Kann		Kann
`KW`			Kann		Kann
`KWH`			Kann		Kann
`KVARH`			Kann		Kann
`MW`			Kann		Kann
`MWH`			Kann		Kann
`STUECK`			Kann		Kann
`KUBIKMETER`			Kann		Kann
`STUNDE`			Kann		Kann
`TAG`			Kann		Kann
`MONAT`			Kann		Kann
`JAHR`			Kann		Kann
`PROZENT`			Kann		Kann
`ANZAHL`			Kann		Kann
`VAR`			Kann		Kann
`KVAR`			Kann		Kann
`VARH`			Kann		Kann
`KWHK`			Kann		Kann
`Z16`			Kann		Kann
`KWT`			Kann		Kann
`wert`00210	Value	number (float)	Kann		Kann
MARKTLOKATION[ ]*	—	object[]	Muss	Muss	Muss	Muss
`bilanzierungsgebiet`00220	Balancing area to which the grid area is assigned - in the case of an electricity grid.	string	Kann	Kann	Kann	Kann
`datenqualitaet`00230	Data quality	string	Kann	Muss	Kann	Muss
`ERWARTETE_DATEN`			Kann	Muss	Kann	Muss
`IM_SYSTEM_VORHANDENE_DATEN`			Kann	Muss	Kann	Muss
`INFORMATIVE_DATEN`			Kann	Muss	Kann	Muss
`GUELTIGE_DATEN`			Kann	Muss	Kann	Muss
`KEINE_DATEN`			Kann	Muss	Kann	Muss
`IM_SYSTEM_KEINE_DATEN_VORHANDEN`			Kann	Muss	Kann	Muss
`KEINE_DATEN_ERWARTET`			Kann	Muss	Kann	Muss
`DIFFERENZ_DATEN`			Kann	Muss	Kann	Muss
`DIFFERENZ_ERWARTETE_DATEN`			Kann	Muss	Kann	Muss
`DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN`			Kann	Muss	Kann	Muss
`marktlokationsId`00240	Identification number of a market location at which energy is either consumed or generated	string	Kann	Kann	Kann	Kann
`regelzone`00250	for EDIFACT mapping	string	Kann		Kann
`energierichtung`*00260	Indicates whether energy is fed in or drawn (fed out).	string	Muss	Muss	Muss	Muss
`AUSSP`			Muss	Muss	Muss	Muss
`EINSP`			Muss	Muss	Muss	Muss
gueltigkeitszeitraum	—	object	Kann	Kann	Kann	Kann
`zeitraumId`00270	zeitraumId	integer	Kann	Kann	Kann	Kann
marktrollen[ ]	—	object[]	Kann	Kann	Kann	Kann
`marktrolle`00280	Indicates the designation of the market role in free text.	string	Kann	Kann	Kann	Kann
`NB`			Kann	Kann	Kann	Kann
`LF`			Kann	Kann	Kann	Kann
`MSB`			Kann	Kann	Kann	Kann
`MSBA`			Kann	Kann	Kann	Kann
`GMSB`			Kann	Kann	Kann	Kann
`MDL`			Kann	Kann	Kann	Kann
`DL`			Kann	Kann	Kann	Kann
`BKV`			Kann	Kann	Kann	Kann
`BKO`			Kann	Kann	Kann	Kann
`UENB`			Kann	Kann	Kann	Kann
`KUNDE-SELBST-NN`			Kann	Kann	Kann	Kann
`MGV`			Kann	Kann	Kann	Kann
`EIV`			Kann	Kann	Kann	Kann
`RB`			Kann	Kann	Kann	Kann
`KUNDE`			Kann	Kann	Kann	Kann
`INTERESSENT`			Kann	Kann	Kann	Kann
`KN`			Kann	Kann	Kann	Kann
`UBA`			Kann	Kann	Kann	Kann
`BIKO`			Kann	Kann	Kann	Kann
`ESA`			Kann	Kann	Kann	Kann
`rollencodenummer`00290	Specifies the code value of the market role.	string	Kann	Kann	Kann	Kann
`netzebene`00300	Grid level at which the energy is drawn. For electricity, the voltage level of the supply; for gas, the pressure level. Example electricity: low voltage Example gas: low pressure.	string		Kann		Kann
`NSP`				Kann		Kann
`MSP`				Kann		Kann
`HSP`				Kann		Kann
`HSS`				Kann		Kann
`MSP_NSP_UMSP`				Kann		Kann
`HSP_MSP_UMSP`				Kann		Kann
`HSS_HSP_UMSP`				Kann		Kann
`HD`				Kann		Kann
`MD`				Kann		Kann
`ND`				Kann		Kann
`umspannung`00310	Grid level	string		Kann		Kann
`NSP`				Kann		Kann
`MSP`				Kann		Kann
`HSP`				Kann		Kann
`HSS`				Kann		Kann
`MSP_NSP_UMSP`				Kann		Kann
`HSP_MSP_UMSP`				Kann		Kann
`HSS_HSP_UMSP`				Kann		Kann
`HD`				Kann		Kann
`MD`				Kann		Kann
`ND`				Kann		Kann
VERWENDUNGSZEITRAUM[ ]*	—	object[]	Muss	Muss	Muss	Muss
`datenqualitaet`*00320	Data quality	string	Muss	Muss	Muss	Muss
`ERWARTETE_DATEN`			Muss	Muss	Muss	Muss
`IM_SYSTEM_VORHANDENE_DATEN`			Muss	Muss	Muss	Muss
`INFORMATIVE_DATEN`			Muss	Muss	Muss	Muss
`GUELTIGE_DATEN`			Muss	Muss	Muss	Muss
`KEINE_DATEN`			Muss	Muss	Muss	Muss
`IM_SYSTEM_KEINE_DATEN_VORHANDEN`			Muss	Muss	Muss	Muss
`KEINE_DATEN_ERWARTET`			Muss	Muss	Muss	Muss
`DIFFERENZ_DATEN`			Muss	Muss	Muss	Muss
`DIFFERENZ_ERWARTETE_DATEN`			Muss	Muss	Muss	Muss
`DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN`			Muss	Muss	Muss	Muss
`verwendungAb`*00330	verwendungAb	string (date-time)	Muss	Muss	Muss	Muss
`verwendungBis`00340	verwendungBis	string (date-time)	Kann	Kann	Kann	Kann
`zeitraumId`*00350	zeitraumId	integer	Muss	Muss	Muss	Muss
TRANCHE[ ]	—	object[]			Kann	Kann
`bilanzkreis`00360	Balancing group	string			Kann	Kann
`datenqualitaet`00370	Data quality	string			Kann	Kann
`ERWARTETE_DATEN`					Kann	Kann
`IM_SYSTEM_VORHANDENE_DATEN`					Kann	Kann
`INFORMATIVE_DATEN`					Kann	Kann
`GUELTIGE_DATEN`					Kann	Kann
`KEINE_DATEN`					Kann	Kann
`IM_SYSTEM_KEINE_DATEN_VORHANDEN`					Kann	Kann
`KEINE_DATEN_ERWARTET`					Kann	Kann
`DIFFERENZ_DATEN`					Kann	Kann
`DIFFERENZ_ERWARTETE_DATEN`					Kann	Kann
`DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN`					Kann	Kann
`tranchenId`00380	tranchenId	string			Kann	Kann
gueltigkeitszeitraum	—	object			Kann	Kann
`zeitraumId`00390	zeitraumId	integer			Kann	Kann
marktrollen[ ]	—	object[]				Kann
`marktrolle`00400	Indicates the designation of the market role in free text.	string				Kann
`NB`						Kann
`LF`						Kann
`MSB`						Kann
`MSBA`						Kann
`GMSB`						Kann
`MDL`						Kann
`DL`						Kann
`BKV`						Kann
`BKO`						Kann
`UENB`						Kann
`KUNDE-SELBST-NN`						Kann
`MGV`						Kann
`EIV`						Kann
`RB`						Kann
`KUNDE`						Kann
`INTERESSENT`						Kann
`KN`						Kann
`UBA`						Kann
`BIKO`						Kann
`ESA`						Kann
`rollencodenummer`00410	Specifies the code value of the market role.	string				Kann
transaktionsdaten*	—	object	Muss	Muss	Muss	Muss
`pruefidentifikator`00420	Determined dynamically in the event process (basis for the decision: energierichtung, marktrolle). A value supplied by the sender is ignored. Check identifiers possible in the topic — 55126, 55613, 55672, 55674.	—	Kann	Kann	Kann	Kann
`sparte`*00430	Contains information about the division	string	Muss	Muss	Muss	Muss
`STROM`			Muss	Muss	Muss	Muss
`GAS`			Muss	Muss	Muss	Muss
`FERNWAERME`			Muss	Muss	Muss	Muss
`NAHWAERME`			Muss	Muss	Muss	Muss
`WASSER`			Muss	Muss	Muss	Muss
`ABWASSER`			Muss	Muss	Muss	Muss
`transaktionsgrund`*00440	The transaction reason describes the business transaction for the category in more detail / UTILMD STS+7++###+ZW4+E03	string	Muss	Muss	Muss	Muss
`transaktionsgrundergaenzung`*00450	Supplement to the transaction reason / UTILMD STS+7++E01+###+E03	string	Muss	Muss	Muss	Muss
absender*	—	object	Muss	Muss	Muss	Muss
`rollencodenummer`00460	Specifies the code value of the market role.	string	Kann	Kann	Kann	Kann
empfaenger*	—	object	Muss	Muss	Muss	Muss
`marktrolle`00470	Indicates the designation of the market role in free text.	string	Kann	Kann	Kann	Kann
`NB`			Kann	Kann	Kann	Kann
`LF`			Kann	Kann	Kann	Kann
`MSB`			Kann	Kann	Kann	Kann
`MSBA`			Kann	Kann	Kann	Kann
`GMSB`			Kann	Kann	Kann	Kann
`MDL`			Kann	Kann	Kann	Kann
`DL`			Kann	Kann	Kann	Kann
`BKV`			Kann	Kann	Kann	Kann
`BKO`			Kann	Kann	Kann	Kann
`UENB`			Kann	Kann	Kann	Kann
`KUNDE-SELBST-NN`			Kann	Kann	Kann	Kann
`MGV`			Kann	Kann	Kann	Kann
`EIV`			Kann	Kann	Kann	Kann
`RB`			Kann	Kann	Kann	Kann
`KUNDE`			Kann	Kann	Kann	Kann
`INTERESSENT`			Kann	Kann	Kann	Kann
`KN`			Kann	Kann	Kann	Kann
`UBA`			Kann	Kann	Kann	Kann
`BIKO`			Kann	Kann	Kann	Kann
`ESA`			Kann	Kann	Kann	Kann
`rollencodenummer`00480	Specifies the code value of the market role.	string	Kann	Kann	Kann	Kann
zusatzdaten*	—	object	Muss	Muss	Muss	Muss
`eventname`*00490	—	string	Muss	Muss	Muss	Muss
`prozessId`*00500	—	string	Muss	Muss	Muss	Muss

Example Request Body

{
  "stammdaten": {
    "BILANZIERUNG": [
      {
        "aggregationsverantwortung": "UENB",
        "bilanzkreis": "bilanzkreis",
        "datenqualitaet": "ERWARTETE_DATEN",
        "detailsPrognosegrundlage": [
          "SLP_SEP"
        ],
        "gueltigkeitszeitraum": {
          "zeitraumId": 0
        },
        "jahresverbrauchsprognose": {
          "einheit": "W",
          "wert": 0
        },
        "lastprofile": [
          {
            "bezeichnung": "bezeichnung",
            "einspeisung": true,
            "profilart": "ART_STANDARDLASTPROFIL",
            "profilschar": "profilschar",
            "tagesparameter": {
              "dienstanbieter": "dienstanbieter",
              "herausgeber": "herausgeber",
              "klimazone": "klimazone",
              "temperaturmessstelle": "temperaturmessstelle"
            },
            "verfahren": "SYNTHETISCH"
          }
        ],
        "prognosegrundlage": "WERTE",
        "temperaturarbeit": {
          "einheit": "W",
          "wert": 0
        },
        "zeitreihentyp": "EGS"
      }
    ],
    "MARKTLOKATION": [
      {
        "bilanzierungsgebiet": "bilanzierungsgebiet",
        "datenqualitaet": "ERWARTETE_DATEN",
        "gueltigkeitszeitraum": {
          "zeitraumId": 0
        },
        "marktlokationsId": "marktlokationsId",
        "marktrollen": [
          {
            "marktrolle": "NB",
            "rollencodenummer": "rollencodenummer"
          }
        ],
        "regelzone": "regelzone",
        "energierichtung": "AUSSP"
      }
    ],
    "VERWENDUNGSZEITRAUM": [
      {
        "datenqualitaet": "ERWARTETE_DATEN",
        "verwendungAb": "2024-08-25T15:00:00Z",
        "verwendungBis": "2024-08-25T15:00:00Z",
        "zeitraumId": 0
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "pruefidentifikator": "55126",
    "sparte": "STROM",
    "transaktionsgrund": "transaktionsgrund",
    "transaktionsgrundergaenzung": "transaktionsgrundergaenzung"
  },
  "zusatzdaten": {
    "eventname": "START_ABR_BK",
    "prozessId": "prozessId"
  }
}

json

START_ABR_BK (NB) › Responses

Success | Success

Structure (BO4E)	Description	Format
`businessKey`*	Unique identifier of the business process \| Unique identifier of the business process	string (uuid)
`message`*	Message with details about the triggered event \| Message with details about the triggered event	string

Trigger-Event START_ABR_BK der Marktrolle NB.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Notes on this page

Der Aufruf geht tatsächlich an POST /inbound; das Event ergibt sich aus zusatzdaten.eventname im Rumpf. Diese Seite trennt eine von 104 Rumpfvarianten heraus, damit sie einzeln lesbar und ausprobierbar sind.

Keys and mapping Billing data for grid usage settlement, …

START_ABR_BK (NB)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (2):

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "BILANZIERUNG": [
      {
        "aggregationsverantwortung": "UENB",
        "bilanzkreis": "bilanzkreis",
        "datenqualitaet": "ERWARTETE_DATEN",
        "detailsPrognosegrundlage": [
          "SLP_SEP"
        ],
        "gueltigkeitszeitraum": {
          "zeitraumId": 0
        },
        "jahresverbrauchsprognose": {
          "einheit": "W",
          "wert": 0
        },
        "lastprofile": [
          {
            "bezeichnung": "bezeichnung",
            "einspeisung": true,
            "profilart": "ART_STANDARDLASTPROFIL",
            "profilschar": "profilschar",
            "tagesparameter": {
              "dienstanbieter": "dienstanbieter",
              "herausgeber": "herausgeber",
              "klimazone": "klimazone",
              "temperaturmessstelle": "temperaturmessstelle"
            },
            "verfahren": "SYNTHETISCH"
          }
        ],
        "prognosegrundlage": "WERTE",
        "temperaturarbeit": {
          "einheit": "W",
          "wert": 0
        },
        "zeitreihentyp": "EGS"
      }
    ],
    "MARKTLOKATION": [
      {
        "bilanzierungsgebiet": "bilanzierungsgebiet",
        "datenqualitaet": "ERWARTETE_DATEN",
        "gueltigkeitszeitraum": {
          "zeitraumId": 0
        },
        "marktlokationsId": "marktlokationsId",
        "marktrollen": [
          {
            "marktrolle": "NB",
            "rollencodenummer": "rollencodenummer"
          }
        ],
        "regelzone": "regelzone",
        "energierichtung": "AUSSP"
      }
    ],
    "VERWENDUNGSZEITRAUM": [
      {
        "datenqualitaet": "ERWARTETE_DATEN",
        "verwendungAb": "2024-08-25T15:00:00Z",
        "verwendungBis": "2024-08-25T15:00:00Z",
        "zeitraumId": 0
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "pruefidentifikator": "55126",
    "sparte": "STROM",
    "transaktionsgrund": "transaktionsgrund",
    "transaktionsgrundergaenzung": "transaktionsgrundergaenzung"
  },
  "zusatzdaten": {
    "eventname": "START_ABR_BK",
    "prozessId": "prozessId"
  }
}'

START_ABR_BK (NB) › Request Body

Structure (BO4E)	Description	Format	55126	55613	55672	55674
stammdaten*	—	object	Muss	Muss	Muss	Muss
BILANZIERUNG[ ]	—	object[]	Kann	Kann	Kann	Kann
`aggregationsverantwortung`00010	Aggregation responsibility	string	Kann		Kann
`UENB`			Kann		Kann
`VNB`			Kann		Kann
`bilanzkreis`00020	Balancing group	string	Kann	Kann	Kann	Kann
`datenqualitaet`00030	Data quality	string	Kann	Kann	Kann
`ERWARTETE_DATEN`			Kann	Kann	Kann
`IM_SYSTEM_VORHANDENE_DATEN`			Kann	Kann	Kann
`INFORMATIVE_DATEN`			Kann	Kann	Kann
`GUELTIGE_DATEN`			Kann	Kann	Kann
`KEINE_DATEN`			Kann	Kann	Kann
`IM_SYSTEM_KEINE_DATEN_VORHANDEN`			Kann	Kann	Kann
`KEINE_DATEN_ERWARTET`			Kann	Kann	Kann
`DIFFERENZ_DATEN`			Kann	Kann	Kann
`DIFFERENZ_ERWARTETE_DATEN`			Kann	Kann	Kann
`DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN`			Kann	Kann	Kann
`detailsPrognosegrundlage`[ ]00040	Profile type	string[]	Kann	Kann	Kann
`SLP_SEP`			Kann	Kann	Kann
`TLP_TEP`			Kann	Kann	Kann
`TEP`			Kann	Kann	Kann
`GEWERBE_ALLGEMEIN`			Kann	Kann	Kann
`GEWERBE_WERKTAGS_8_18_UHR`			Kann	Kann	Kann
`GEWERBE_MIT_STARKEM_BIS_UEBERWIEGENDEM_VERBRAUCH_IN_DEN_ABENDSTUNDEN`			Kann	Kann	Kann
`GEWERBE_DURCHLAUFEND`			Kann	Kann	Kann
`GEWERBE_LADEN_FRISEUR`			Kann	Kann	Kann
`GEWERBE_BAECKEREI_MIT_BACKSTUBE`			Kann	Kann	Kann
`GEWERBE_WOCHENENDBETRIEB`			Kann	Kann	Kann
`LANDWIRTSCHAFTSBETRIEBE_ALLGEMEIN`			Kann	Kann	Kann
`LANDWIRTSCHAFTSBETRIEBE_MIT_MILCHWIRTSCHAFT_NEBENERWERBS_TIERZUCHT`			Kann	Kann	Kann
`LANDWIRTSCHAFT_OHNE_MILCHVIEH`			Kann	Kann	Kann
`HAUSHALT`			Kann	Kann	Kann
`BANDLAST`			Kann	Kann	Kann
`UNTERBRECHBARE_VERBRAUCHSEINRICHTUNG`			Kann	Kann	Kann
`HEIZWAERMESPEICHER`			Kann	Kann	Kann
`STRASSENBELEUCHTUNG`			Kann	Kann	Kann
`PHOTOVOLTAIK_MARKTLOKATION`			Kann	Kann	Kann
`BLOCKHEIZKRAFTWERK`			Kann	Kann	Kann
`SONSTIGE_VERBRAUCHENDE_MARKTLOKATION`			Kann	Kann	Kann
`SONSTIGE_ERZEUGENDE_MARKTLOKATION`			Kann	Kann	Kann
`E_MOBILITAET_LADEPUNKT_IM_OEFFENTLICHEN_BEREICH`			Kann	Kann	Kann
`E_MOBILITAET_LADEPUNKT_EINES_HAUSHALTS`			Kann	Kann	Kann
`E_MOBILITAET_LADEPUNKT_EINES_GEWERBES`			Kann	Kann	Kann
`prognosegrundlage`00050	Forecast basis	string	Kann	Kann	Kann	Kann
`WERTE`			Kann	Kann	Kann	Kann
`PROFILE`			Kann	Kann	Kann	Kann
`zeitreihentyp`00060	Time series type	string	Kann	Kann	Kann	Kann
`EGS`			Kann	Kann	Kann	Kann
`LGS`			Kann	Kann	Kann	Kann
`NZR`			Kann	Kann	Kann	Kann
`SES`			Kann	Kann	Kann	Kann
`SLS`			Kann	Kann	Kann	Kann
`TES`			Kann	Kann	Kann	Kann
`TLS`			Kann	Kann	Kann	Kann
`SLS_TLS`			Kann	Kann	Kann	Kann
`SES_TES`			Kann	Kann	Kann	Kann
gueltigkeitszeitraum	—	object	Kann	Kann	Kann
`zeitraumId`00070	zeitraumId	integer	Kann	Kann	Kann
jahresverbrauchsprognose	—	object	Kann	Kann	Kann
`einheit`00080	Unit: measurands that can be determined by measurement or by specification	string	Kann	Kann	Kann
`W`			Kann	Kann	Kann
`WH`			Kann	Kann	Kann
`KW`			Kann	Kann	Kann
`KWH`			Kann	Kann	Kann
`KVARH`			Kann	Kann	Kann
`MW`			Kann	Kann	Kann
`MWH`			Kann	Kann	Kann
`STUECK`			Kann	Kann	Kann
`KUBIKMETER`			Kann	Kann	Kann
`STUNDE`			Kann	Kann	Kann
`TAG`			Kann	Kann	Kann
`MONAT`			Kann	Kann	Kann
`JAHR`			Kann	Kann	Kann
`PROZENT`			Kann	Kann	Kann
`ANZAHL`			Kann	Kann	Kann
`VAR`			Kann	Kann	Kann
`KVAR`			Kann	Kann	Kann
`VARH`			Kann	Kann	Kann
`KWHK`			Kann	Kann	Kann
`Z16`			Kann	Kann	Kann
`KWT`			Kann	Kann	Kann
`wert`00090	Value	number (float)	Kann	Kann	Kann
lastprofile[ ]	—	object[]	Kann	Kann	Kann
`bezeichnung`00100	Additional designation, e.g. Zählwerk_Wirkarbeit.	string	Kann	Kann	Kann
`einspeisung`00110	Feed-in indicator	boolean	Kann	Kann	Kann
`profilart`00120	Profile category	string	Kann	Kann	Kann
`ART_STANDARDLASTPROFIL`			Kann	Kann	Kann
`ART_TAGESPARAMETERABHAENGIGES_LASTPROFIL`			Kann	Kann	Kann
`ART_LASTPROFIL`			Kann	Kann	Kann
`profilschar`00130	Profile set of the profile	string	Kann		Kann
`verfahren`00140	Profiling method	string	Kann	Kann	Kann
`SYNTHETISCH`			Kann	Kann	Kann
`ANALYTISCH`			Kann	Kann	Kann
tagesparameter	—	object	Kann		Kann
`dienstanbieter`00150	dienstanbieter	string	Kann		Kann
`herausgeber`00160	Issuer of the load profile	string	Kann		Kann
`klimazone`00170	klimazone	string	Kann		Kann
`temperaturmessstelle`00180	temperaturmessstelle	string	Kann		Kann
`referenzprofilbezeichnung`00190	Designation of the reference profile	string			Kann
temperaturarbeit	—	object	Kann		Kann
`einheit`00200	Unit: measurands that can be determined by measurement or by specification	string	Kann		Kann
`W`			Kann		Kann
`WH`			Kann		Kann
`KW`			Kann		Kann
`KWH`			Kann		Kann
`KVARH`			Kann		Kann
`MW`			Kann		Kann
`MWH`			Kann		Kann
`STUECK`			Kann		Kann
`KUBIKMETER`			Kann		Kann
`STUNDE`			Kann		Kann
`TAG`			Kann		Kann
`MONAT`			Kann		Kann
`JAHR`			Kann		Kann
`PROZENT`			Kann		Kann
`ANZAHL`			Kann		Kann
`VAR`			Kann		Kann
`KVAR`			Kann		Kann
`VARH`			Kann		Kann
`KWHK`			Kann		Kann
`Z16`			Kann		Kann
`KWT`			Kann		Kann
`wert`00210	Value	number (float)	Kann		Kann
MARKTLOKATION[ ]*	—	object[]	Muss	Muss	Muss	Muss
`bilanzierungsgebiet`00220	Balancing area to which the grid area is assigned - in the case of an electricity grid.	string	Kann	Kann	Kann	Kann
`datenqualitaet`00230	Data quality	string	Kann	Muss	Kann	Muss
`ERWARTETE_DATEN`			Kann	Muss	Kann	Muss
`IM_SYSTEM_VORHANDENE_DATEN`			Kann	Muss	Kann	Muss
`INFORMATIVE_DATEN`			Kann	Muss	Kann	Muss
`GUELTIGE_DATEN`			Kann	Muss	Kann	Muss
`KEINE_DATEN`			Kann	Muss	Kann	Muss
`IM_SYSTEM_KEINE_DATEN_VORHANDEN`			Kann	Muss	Kann	Muss
`KEINE_DATEN_ERWARTET`			Kann	Muss	Kann	Muss
`DIFFERENZ_DATEN`			Kann	Muss	Kann	Muss
`DIFFERENZ_ERWARTETE_DATEN`			Kann	Muss	Kann	Muss
`DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN`			Kann	Muss	Kann	Muss
`marktlokationsId`00240	Identification number of a market location at which energy is either consumed or generated	string	Kann	Kann	Kann	Kann
`regelzone`00250	for EDIFACT mapping	string	Kann		Kann
`energierichtung`*00260	Indicates whether energy is fed in or drawn (fed out).	string	Muss	Muss	Muss	Muss
`AUSSP`			Muss	Muss	Muss	Muss
`EINSP`			Muss	Muss	Muss	Muss
gueltigkeitszeitraum	—	object	Kann	Kann	Kann	Kann
`zeitraumId`00270	zeitraumId	integer	Kann	Kann	Kann	Kann
marktrollen[ ]	—	object[]	Kann	Kann	Kann	Kann
`marktrolle`00280	Indicates the designation of the market role in free text.	string	Kann	Kann	Kann	Kann
`NB`			Kann	Kann	Kann	Kann
`LF`			Kann	Kann	Kann	Kann
`MSB`			Kann	Kann	Kann	Kann
`MSBA`			Kann	Kann	Kann	Kann
`GMSB`			Kann	Kann	Kann	Kann
`MDL`			Kann	Kann	Kann	Kann
`DL`			Kann	Kann	Kann	Kann
`BKV`			Kann	Kann	Kann	Kann
`BKO`			Kann	Kann	Kann	Kann
`UENB`			Kann	Kann	Kann	Kann
`KUNDE-SELBST-NN`			Kann	Kann	Kann	Kann
`MGV`			Kann	Kann	Kann	Kann
`EIV`			Kann	Kann	Kann	Kann
`RB`			Kann	Kann	Kann	Kann
`KUNDE`			Kann	Kann	Kann	Kann
`INTERESSENT`			Kann	Kann	Kann	Kann
`KN`			Kann	Kann	Kann	Kann
`UBA`			Kann	Kann	Kann	Kann
`BIKO`			Kann	Kann	Kann	Kann
`ESA`			Kann	Kann	Kann	Kann
`rollencodenummer`00290	Specifies the code value of the market role.	string	Kann	Kann	Kann	Kann
`netzebene`00300	Grid level at which the energy is drawn. For electricity, the voltage level of the supply; for gas, the pressure level. Example electricity: low voltage Example gas: low pressure.	string		Kann		Kann
`NSP`				Kann		Kann
`MSP`				Kann		Kann
`HSP`				Kann		Kann
`HSS`				Kann		Kann
`MSP_NSP_UMSP`				Kann		Kann
`HSP_MSP_UMSP`				Kann		Kann
`HSS_HSP_UMSP`				Kann		Kann
`HD`				Kann		Kann
`MD`				Kann		Kann
`ND`				Kann		Kann
`umspannung`00310	Grid level	string		Kann		Kann
`NSP`				Kann		Kann
`MSP`				Kann		Kann
`HSP`				Kann		Kann
`HSS`				Kann		Kann
`MSP_NSP_UMSP`				Kann		Kann
`HSP_MSP_UMSP`				Kann		Kann
`HSS_HSP_UMSP`				Kann		Kann
`HD`				Kann		Kann
`MD`				Kann		Kann
`ND`				Kann		Kann
VERWENDUNGSZEITRAUM[ ]*	—	object[]	Muss	Muss	Muss	Muss
`datenqualitaet`*00320	Data quality	string	Muss	Muss	Muss	Muss
`ERWARTETE_DATEN`			Muss	Muss	Muss	Muss
`IM_SYSTEM_VORHANDENE_DATEN`			Muss	Muss	Muss	Muss
`INFORMATIVE_DATEN`			Muss	Muss	Muss	Muss
`GUELTIGE_DATEN`			Muss	Muss	Muss	Muss
`KEINE_DATEN`			Muss	Muss	Muss	Muss
`IM_SYSTEM_KEINE_DATEN_VORHANDEN`			Muss	Muss	Muss	Muss
`KEINE_DATEN_ERWARTET`			Muss	Muss	Muss	Muss
`DIFFERENZ_DATEN`			Muss	Muss	Muss	Muss
`DIFFERENZ_ERWARTETE_DATEN`			Muss	Muss	Muss	Muss
`DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN`			Muss	Muss	Muss	Muss
`verwendungAb`*00330	verwendungAb	string (date-time)	Muss	Muss	Muss	Muss
`verwendungBis`00340	verwendungBis	string (date-time)	Kann	Kann	Kann	Kann
`zeitraumId`*00350	zeitraumId	integer	Muss	Muss	Muss	Muss
TRANCHE[ ]	—	object[]			Kann	Kann
`bilanzkreis`00360	Balancing group	string			Kann	Kann
`datenqualitaet`00370	Data quality	string			Kann	Kann
`ERWARTETE_DATEN`					Kann	Kann
`IM_SYSTEM_VORHANDENE_DATEN`					Kann	Kann
`INFORMATIVE_DATEN`					Kann	Kann
`GUELTIGE_DATEN`					Kann	Kann
`KEINE_DATEN`					Kann	Kann
`IM_SYSTEM_KEINE_DATEN_VORHANDEN`					Kann	Kann
`KEINE_DATEN_ERWARTET`					Kann	Kann
`DIFFERENZ_DATEN`					Kann	Kann
`DIFFERENZ_ERWARTETE_DATEN`					Kann	Kann
`DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN`					Kann	Kann
`tranchenId`00380	tranchenId	string			Kann	Kann
gueltigkeitszeitraum	—	object			Kann	Kann
`zeitraumId`00390	zeitraumId	integer			Kann	Kann
marktrollen[ ]	—	object[]				Kann
`marktrolle`00400	Indicates the designation of the market role in free text.	string				Kann
`NB`						Kann
`LF`						Kann
`MSB`						Kann
`MSBA`						Kann
`GMSB`						Kann
`MDL`						Kann
`DL`						Kann
`BKV`						Kann
`BKO`						Kann
`UENB`						Kann
`KUNDE-SELBST-NN`						Kann
`MGV`						Kann
`EIV`						Kann
`RB`						Kann
`KUNDE`						Kann
`INTERESSENT`						Kann
`KN`						Kann
`UBA`						Kann
`BIKO`						Kann
`ESA`						Kann
`rollencodenummer`00410	Specifies the code value of the market role.	string				Kann
transaktionsdaten*	—	object	Muss	Muss	Muss	Muss
`pruefidentifikator`00420	Determined dynamically in the event process (basis for the decision: energierichtung, marktrolle). A value supplied by the sender is ignored. Check identifiers possible in the topic — 55126, 55613, 55672, 55674.	—	Kann	Kann	Kann	Kann
`sparte`*00430	Contains information about the division	string	Muss	Muss	Muss	Muss
`STROM`			Muss	Muss	Muss	Muss
`GAS`			Muss	Muss	Muss	Muss
`FERNWAERME`			Muss	Muss	Muss	Muss
`NAHWAERME`			Muss	Muss	Muss	Muss
`WASSER`			Muss	Muss	Muss	Muss
`ABWASSER`			Muss	Muss	Muss	Muss
`transaktionsgrund`*00440	The transaction reason describes the business transaction for the category in more detail / UTILMD STS+7++###+ZW4+E03	string	Muss	Muss	Muss	Muss
`transaktionsgrundergaenzung`*00450	Supplement to the transaction reason / UTILMD STS+7++E01+###+E03	string	Muss	Muss	Muss	Muss
absender*	—	object	Muss	Muss	Muss	Muss
`rollencodenummer`00460	Specifies the code value of the market role.	string	Kann	Kann	Kann	Kann
empfaenger*	—	object	Muss	Muss	Muss	Muss
`marktrolle`00470	Indicates the designation of the market role in free text.	string	Kann	Kann	Kann	Kann
`NB`			Kann	Kann	Kann	Kann
`LF`			Kann	Kann	Kann	Kann
`MSB`			Kann	Kann	Kann	Kann
`MSBA`			Kann	Kann	Kann	Kann
`GMSB`			Kann	Kann	Kann	Kann
`MDL`			Kann	Kann	Kann	Kann
`DL`			Kann	Kann	Kann	Kann
`BKV`			Kann	Kann	Kann	Kann
`BKO`			Kann	Kann	Kann	Kann
`UENB`			Kann	Kann	Kann	Kann
`KUNDE-SELBST-NN`			Kann	Kann	Kann	Kann
`MGV`			Kann	Kann	Kann	Kann
`EIV`			Kann	Kann	Kann	Kann
`RB`			Kann	Kann	Kann	Kann
`KUNDE`			Kann	Kann	Kann	Kann
`INTERESSENT`			Kann	Kann	Kann	Kann
`KN`			Kann	Kann	Kann	Kann
`UBA`			Kann	Kann	Kann	Kann
`BIKO`			Kann	Kann	Kann	Kann
`ESA`			Kann	Kann	Kann	Kann
`rollencodenummer`00480	Specifies the code value of the market role.	string	Kann	Kann	Kann	Kann
zusatzdaten*	—	object	Muss	Muss	Muss	Muss
`eventname`*00490	—	string	Muss	Muss	Muss	Muss
`prozessId`*00500	—	string	Muss	Muss	Muss	Muss

Example Request Body

{
  "stammdaten": {
    "BILANZIERUNG": [
      {
        "aggregationsverantwortung": "UENB",
        "bilanzkreis": "bilanzkreis",
        "datenqualitaet": "ERWARTETE_DATEN",
        "detailsPrognosegrundlage": [
          "SLP_SEP"
        ],
        "gueltigkeitszeitraum": {
          "zeitraumId": 0
        },
        "jahresverbrauchsprognose": {
          "einheit": "W",
          "wert": 0
        },
        "lastprofile": [
          {
            "bezeichnung": "bezeichnung",
            "einspeisung": true,
            "profilart": "ART_STANDARDLASTPROFIL",
            "profilschar": "profilschar",
            "tagesparameter": {
              "dienstanbieter": "dienstanbieter",
              "herausgeber": "herausgeber",
              "klimazone": "klimazone",
              "temperaturmessstelle": "temperaturmessstelle"
            },
            "verfahren": "SYNTHETISCH"
          }
        ],
        "prognosegrundlage": "WERTE",
        "temperaturarbeit": {
          "einheit": "W",
          "wert": 0
        },
        "zeitreihentyp": "EGS"
      }
    ],
    "MARKTLOKATION": [
      {
        "bilanzierungsgebiet": "bilanzierungsgebiet",
        "datenqualitaet": "ERWARTETE_DATEN",
        "gueltigkeitszeitraum": {
          "zeitraumId": 0
        },
        "marktlokationsId": "marktlokationsId",
        "marktrollen": [
          {
            "marktrolle": "NB",
            "rollencodenummer": "rollencodenummer"
          }
        ],
        "regelzone": "regelzone",
        "energierichtung": "AUSSP"
      }
    ],
    "VERWENDUNGSZEITRAUM": [
      {
        "datenqualitaet": "ERWARTETE_DATEN",
        "verwendungAb": "2024-08-25T15:00:00Z",
        "verwendungBis": "2024-08-25T15:00:00Z",
        "zeitraumId": 0
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "pruefidentifikator": "55126",
    "sparte": "STROM",
    "transaktionsgrund": "transaktionsgrund",
    "transaktionsgrundergaenzung": "transaktionsgrundergaenzung"
  },
  "zusatzdaten": {
    "eventname": "START_ABR_BK",
    "prozessId": "prozessId"
  }
}

json

START_ABR_BK (NB) › Responses

Success | Success

Structure (BO4E)	Description	Format
`businessKey`*	Unique identifier of the business process \| Unique identifier of the business process	string (uuid)
`message`*	Message with details about the triggered event \| Message with details about the triggered event	string

Trigger-Event START_ABR_BK der Marktrolle NB.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Notes on this page

Feedback on the documentation

Feedback on the documentation

Billing data for balancing group settlement, …

START_ABR_BK (NB)

START_ABR_BK (NB) › Request Body

START_ABR_BK (NB) › Responses

Billing data for balancing group settlement, …

START_ABR_BK (NB)

START_ABR_BK (NB) › Request Body

START_ABR_BK (NB) › Responses