Read balancing

GET

https://mock.macoapp.de

/getAccountingBasic

Reading a balancing using LocationId (Parameter1) at the point in time (Parameter3)

query Parameters

Structure (BO4E)	Description	Format
`parameter1`*	Location ID · Example: 74018657187 · Default: 74018657187	string
`parameter2`*	Location type · Example: MALO · Default: MALO	string `MALO`, `MELO`, `NELO` `TECHNISCHE_RESSOURCE`, `STEUERBARE_RESOURCE`, `TRANCHE`
`parameter3`*	Date (valid from) or key date if parameter4 is not set · Example: 2024-06-28T12:18:00Z · Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$	string (date-time)
`parameter4`*	Date (Valid until) · Example: 2024-06-28T12:18:00Z · Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$	string (date-time)
`command`	Corresponds to the operationId of this interface. This operation ID corresponds to the command in the Camunda connector process. If the backend provides a generic endpoint, this command can be used to define which operation is to be executed.	string

Read balancing › Responses

Successful reading of the balancing

Array of: object — the response is a list of these objects, not a single object. Every entry has this structure:

Structure (BO4E)	Description	Format
`boTyp`*	Type of the BO	string `ANSPRECHPARTNER`, `AVIS`, `ENERGIEMENGE` `GESCHAEFTSOBJEKT`, `GESCHAEFTSPARTNER`, `MARKTLOKATION`, `MARKTTEILNEHMER`, `MESSLOKATION`, `ZAEHLER`, `KOSTEN`, `TARIF`, `PREISBLATT`, `PREISBLATTNETZNUTZUNG`, `PREISBLATTMESSUNG`, `PREISBLATTUMLAGEN`, `PREISBLATTDIENSTLEISTUNG`, `PREISBLATTKONZESSIONSABGABE`, `ZEITREIHE`, `LASTGANG`, `HANDELSUNSTIMMIGKEIT`, `ANFRAGE`, `AUFTRAG`, `STATUSMITTEILUNG`, `BERECHNUNGSFORMEL`, `RECHNUNG`, `BILANZIERUNG`, `NETZNUTZUNGSVERTRAG`, `MESSSTELLENBETRIEBSVERTRAG`, `ENERGIELIEFERVERTRAG`, `SPERRAUFTRAG`, `ANGEBOT`, `TRANCHE`, `KOMMUNIKATIONSDATEN`, `ZAEHLZEITDEFINITION`, `SCHALTZEITDEFINITION`, `LEISTUNGSKURVENDEFINITION`, `NETZLOKATION`, `STEUERBARE_RESSOURCE`, `TECHNISCHE_RESSOURCE`, `AD_HOC_STEUERKANAL`, `LOKATIONSBUENDEL`, `WERTE_NACH_TYP2`, `REKLAMATION`, `STATUSBERICHT`, `VERTRAG`, `BILANZKREIS`, `VERWENDUNGSZEITRAUM`, `TARIFINFO`, `SUMMENZEITREIHE`
`versionStruktur`*	versionStruktur	string
`marktlokationsId`	Which market location these balancing data apply to. Reference to an ID of a market location LOC Z16 RFF Z18 PI 55690 55060 55043 55168 55169 55238 55239 55074 55075 55076 55065 55066 55195 55196 55201 55202	string
`aggregationsverantwortung`	Aggregation responsibility, to whom the balancing is assigned. CCI 6 PI 55043 55168 55169 55195 55196 55223 55224	string `UENB`, `VNB`
`zeitreihentyp`	Time series type Aggregated time series type Z21 CCI 15 Z21 PI 55670 55671 55074 55075 55076 55065 55066 55196 MSCONS Time series type	string
`prognosegrundlage`	Forecast basis; this information is used to derive the balancing procedure mentioned in the processes. PI 55013 55613 55614 55126 55156 55674 55675 55672 55673 55628 55634 55035 55095 55060 55043 55168 55169 55195 55196 CAV Z38 ORDERS PI 17120 Gas UTILMD Forecast basis already exchanged ZB0 Forecast based on values valid ZB1 Forecast based on profiles valid CCI ZB0 PI 44139 44142	string `WERTE`, `PROFILE`
`bilanzierungsbeginn`	Start of the assignment of a MaLo, tranche to the balancing group. DTM 158 55238 55239 55062 55064 55065 55066 55071 55195 55196 55223 55224 55197 55199 55203 55204 55205 55209 55210 55211	string (date-time)
`bilanzierungsende`	End of the assignment of a MaLo, tranche to the balancing group. DTM 159 55240 55241 55242 55243 55063 55064 55065 55066 55072 55195 55196 55223 55224 55198 55200 55206 55207 55208 55212 55213 55214	string (date-time)
`bilanzkreis`	Balancing group or the account on which the balancing is carried out. CCI Z19 PI 55613 55614 55126 55156 55674 55675 55672 55673 55670 55671 55074 55075 55076 55065 55066 55195 55196	string
`fallgruppenzuordnung`	Case group assignment according to GABi Gas GABi- SLP customers analytical method - Exit SLPana GABi- SLP customers synthetic method - Exit SLPsyn CCI Z17 PI 44123 44156 44157 44001 44002 44013 44014 44019 44020 44021 44035 44103 44104	string `GABI_RLMmT`, `GABI_RLMoT`, `GABI_RLMNEV`
temperaturarbeit	Customer value TLP, specification of the specific energy for a daily-parameter-dependent market location as a numeric value, of the adjusted electrical energy of a daily-parameter-dependent market location. Also includes joint metering - SLP and TLP-. QTY Z10 PI 55672 55673 55628 55634 55035 55095 55060 55065 55066 QTY 265 PI 55013 55126 55156 55672 55673 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066 QTY Z08 PI 55013 55126 55156 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066	object
`wert`	Value quantity specification	number (float)
`einheit`	Unit of measurement	string `W`, `WH`, `KW` `KWH`, `KVARH`, `MW`, `MWH`, `STUECK`, `KUBIKMETER`, `STUNDE`, `TAG`, `MONAT`, `JAHR`, `PROZENT`, `ANZAHL`, `VAR`, `KVAR`, `VARH`, `KWHK`, `Z16`, `KWT`, `WATT_PRO_QUADRATMETER`, `METER_PRO_SEKUNDE`
`startdatum`	startdatum	string (date-time)
`enddatum`	enddatum	string (date-time)
jahresverbrauchsprognose	Customer value TLP, specification of the specific energy for a daily-parameter-dependent market location as a numeric value, of the adjusted electrical energy of a daily-parameter-dependent market location. Also includes joint metering - SLP and TLP-. QTY Z10 PI 55672 55673 55628 55634 55035 55095 55060 55065 55066 QTY 265 PI 55013 55126 55156 55672 55673 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066 QTY Z08 PI 55013 55126 55156 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066	object
`wert`	Value quantity specification	number (float)
`einheit`	Unit of measurement	string `W`, `WH`, `KW` `KWH`, `KVARH`, `MW`, `MWH`, `STUECK`, `KUBIKMETER`, `STUNDE`, `TAG`, `MONAT`, `JAHR`, `PROZENT`, `ANZAHL`, `VAR`, `KVAR`, `VARH`, `KWHK`, `Z16`, `KWT`, `WATT_PRO_QUADRATMETER`, `METER_PRO_SEKUNDE`
`startdatum`	startdatum	string (date-time)
`enddatum`	enddatum	string (date-time)
kundenwert	Customer value TLP, specification of the specific energy for a daily-parameter-dependent market location as a numeric value, of the adjusted electrical energy of a daily-parameter-dependent market location. Also includes joint metering - SLP and TLP-. QTY Z10 PI 55672 55673 55628 55634 55035 55095 55060 55065 55066 QTY 265 PI 55013 55126 55156 55672 55673 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066 QTY Z08 PI 55013 55126 55156 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066	object
`wert`	Value quantity specification	number (float)
`einheit`	Unit of measurement	string `W`, `WH`, `KW` `KWH`, `KVARH`, `MW`, `MWH`, `STUECK`, `KUBIKMETER`, `STUNDE`, `TAG`, `MONAT`, `JAHR`, `PROZENT`, `ANZAHL`, `VAR`, `KVAR`, `VARH`, `KWHK`, `Z16`, `KWT`, `WATT_PRO_QUADRATMETER`, `METER_PRO_SEKUNDE`
`startdatum`	startdatum	string (date-time)
`enddatum`	enddatum	string (date-time)
verbrauchsaufteilung	Customer value TLP, specification of the specific energy for a daily-parameter-dependent market location as a numeric value, of the adjusted electrical energy of a daily-parameter-dependent market location. Also includes joint metering - SLP and TLP-. QTY Z10 PI 55672 55673 55628 55634 55035 55095 55060 55065 55066 QTY 265 PI 55013 55126 55156 55672 55673 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066 QTY Z08 PI 55013 55126 55156 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066	object
`wert`	Value quantity specification	number (float)
`einheit`	Unit of measurement	string `W`, `WH`, `KW` `KWH`, `KVARH`, `MW`, `MWH`, `STUECK`, `KUBIKMETER`, `STUNDE`, `TAG`, `MONAT`, `JAHR`, `PROZENT`, `ANZAHL`, `VAR`, `KVAR`, `VARH`, `KWHK`, `Z16`, `KWT`, `WATT_PRO_QUADRATMETER`, `METER_PRO_SEKUNDE`
`startdatum`	startdatum	string (date-time)
`enddatum`	enddatum	string (date-time)
`wahlrechtPrognosegrundlage`	Right to choose the forecast basis (true = right to choose lies with the supplier)	string `DURCH_LF`, `DURCH_LF_NICHT_GEGEBEN`, `NICHT_WEGEN_GROSSEN_VERBRAUCHS` `NICHT_WEGEN_EIGENVERBRAUCH`, `NICHT_WEGEN_TAGES_VERBRAUCH`, `NICHT_WEGEN_ENWG`
`grundWahlrechtPrognosegrundlage`	Right to choose the forecast basis (true = right to choose lies with the supplier)	string `DURCH_LF`, `DURCH_LF_NICHT_GEGEBEN`, `NICHT_WEGEN_GROSSEN_VERBRAUCHS` `NICHT_WEGEN_EIGENVERBRAUCH`, `NICHT_WEGEN_TAGES_VERBRAUCH`, `NICHT_WEGEN_ENWG`
`abwicklungsmodell`	Settlement model; on the basis of this information it is derived for the balancing whether the Malo is balanced with the assigned balancing group in model 1 ZE9 or whether the energy quantity of the Malo is handed over as NGZ in model 2 ZF0 into an adjacent balancing area. CAV ZA2 PI 55628 55634 55043 55168 55169	string `MODELL_1_BILANZIERUNG_AN_MARKTLOKATION`, `MODELL_2_BILANZIERUNG_IM_BILANZIERUNGSGEBIET`
vorjahresverbrauch*	Customer value TLP, specification of the specific energy for a daily-parameter-dependent market location as a numeric value, of the adjusted electrical energy of a daily-parameter-dependent market location. Also includes joint metering - SLP and TLP-. QTY Z10 PI 55672 55673 55628 55634 55035 55095 55060 55065 55066 QTY 265 PI 55013 55126 55156 55672 55673 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066 QTY Z08 PI 55013 55126 55156 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066	object
`wert`	Value quantity specification	number (float)
`einheit`	Unit of measurement	string `W`, `WH`, `KW` `KWH`, `KVARH`, `MW`, `MWH`, `STUECK`, `KUBIKMETER`, `STUNDE`, `TAG`, `MONAT`, `JAHR`, `PROZENT`, `ANZAHL`, `VAR`, `KVAR`, `VARH`, `KWHK`, `Z16`, `KWT`, `WATT_PRO_QUADRATMETER`, `METER_PRO_SEKUNDE`
`startdatum`	startdatum	string (date-time)
`enddatum`	enddatum	string (date-time)
`datenqualitaet`	Data quality	string `ERWARTETE_DATEN`, `IM_SYSTEM_VORHANDENE_DATEN`, `INFORMATIVE_DATEN` `GUELTIGE_DATEN`, `KEINE_DATEN`, `IM_SYSTEM_KEINE_DATEN_VORHANDEN`, `KEINE_DATEN_ERWARTET`, `DIFFERENZ_DATEN`, `DIFFERENZ_ERWARTETE_DATEN`, `DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN`
gueltigkeitszeitraum	Validity period	object
`zeiteinheit`	not in use	string `SEKUNDE`, `MINUTE`, `STUNDE` `VIERTEL_STUNDE`, `TAG`, `WOCHE`, `MONAT`, `QUARTAL`, `HALBJAHR`, `JAHR`
`dauer`	Time span, value	integer
`startdatum`	Date from DTM Z25 Use of the data from DTM 163 Processing, start date/time DTM 155 Invoicing period, start date DTM Z42 Provisional billing period start	string (date-time)
`enddatum`	Date from DTM Z26 Use of the data until DTM164 Processing, end date/time DTM 156 Invoicing period, end date DTM Z43 Provisional billing period end	string (date-time)
`einheit`	not in use	string `SEKUNDE`, `MINUTE`, `STUNDE` `VIERTEL_STUNDE`, `TAG`, `WOCHE`, `MONAT`, `QUARTAL`, `HALBJAHR`, `JAHR`
`ableseZeitraum`	Periodic meter reading of the NB DTM 752 PI 44113 44140 44142 44043 44168 44169 44060	string
`abrechnungsZeitraum`	Date on which the grid usage settlement of the NB takes place DTM Z21 PI 44112 44139 44142 44002 44013 44014 44035	string
`zeitraumText`	Period text	string
`zeitraumId`	Reference to period ID RFF Z46 PI 25001	integer
lastprofile[ ]	Standardised profile - profile designation CCI Z02	object[]
`bezeichnung`	Name of the profile. Only codes from the valid list of profile definitions of the respective NB and the associated balancing area may be entered. CAV ABC PI 55613 55614 55126 55156 55672 55673 55628 55634 55035 55095 55043 55168 55169 55065 55066 55073 55195 55196 55223 55224 MSCONS LOC Z04	string
`verfahren`	Procedure - specific properties	string `SYNTHETISCH`, `ANALYTISCH`
`profilart`	Standard load profile CCI Z02 PI 55613 55614 55126 55156 55628 55634 55035 55043 55168 55169 55065 55066 55073 55195 55196 55223 55224 ORDERS PI 17201	string `ART_STANDARDLASTPROFIL`, `ART_TAGESPARAMETERABHAENGIGES_LASTPROFIL`, `ART_LASTPROFIL`
`profilschar`	Code for the profile set, name of the profile set. CAV COD PI 55126 55156 55672 55673 55035 55095 55073 MSCONS LOC Z06 PI 13011	string
`einspeisung`	Standard feed-in profile CCI Z04 PI 55672 55673 55628 55634 55095 55043 55168 55169 55065 55066 55073 55224 ORDERS PI 17201 Z05 day-parameter-dependent feed-in profile PI 55672 55673 55628 55634 55095 55043 55169 55065 55066 55073 ORDERS PI 17201	boolean
`herausgeber`	Issuer of the load profile 89 Assigned by the trader (here grid operator) 293 DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.)	string
`referenzprofilbezeichnung`	Code of the reference profile CAV COD PI 55672 55673 55628 55634 55095 55043 55168 55169 55065 55066 55073	string
`referenzprofil`	Referenzprofil	string
`profiltyp`	Profile type	string `SLP_SEP`, `TLP_TEP`, `TEP` `GEWERBE_ALLGEMEIN`, `GEWERBE_WERKTAGS_8_18_UHR`, `GEWERBE_MIT_STARKEM_BIS_UEBERWIEGENDEM_VERBRAUCH_IN_DEN_ABENDSTUNDEN`, `GEWERBE_DURCHLAUFEND`, `GEWERBE_LADEN_FRISEUR`, `GEWERBE_BAECKEREI_MIT_BACKSTUBE`, `GEWERBE_WOCHENENDBETRIEB`, `LANDWIRTSCHAFTSBETRIEBE_ALLGEMEIN`, `LANDWIRTSCHAFTSBETRIEBE_MIT_MILCHWIRTSCHAFT_NEBENERWERBS_TIERZUCHT`, `LANDWIRTSCHAFT_OHNE_MILCHVIEH`, `HAUSHALT`, `BANDLAST`, `UNTERBRECHBARE_VERBRAUCHSEINRICHTUNG`, `HEIZWAERMESPEICHER`, `STRASSENBELEUCHTUNG`, `PHOTOVOLTAIK_MARKTLOKATION`, `BLOCKHEIZKRAFTWERK`, `SONSTIGE_VERBRAUCHENDE_MARKTLOKATION`, `SONSTIGE_ERZEUGENDE_MARKTLOKATION`, `E_MOBILITAET_LADEPUNKT_IM_OEFFENTLICHEN_BEREICH`, `E_MOBILITAET_LADEPUNKT_EINES_HAUSHALTS`, `E_MOBILITAET_LADEPUNKT_EINES_GEWERBES`
`normierungsfaktor`	Normierungsfaktor	string `NORMIERUNGSFAKTOR_1_000_000_KWH_A`, `NORMIERUNGSFAKTOR_300_KWH_K`, `NORMIERUNGSFAKTOR_1_000_000_KW`
`begrenzungskonstante`	Begrenzungskonstante	string `BEGRENZUNGSKONSTANTE_0`, `BEGRENZUNGSKONSTANTE_1`
tagesparameter	Climate zone / temperature measuring point - for the temperature measuring point, the ID and the provider from the EDI@Energy code list are specified.	object
`klimazone`	Climate zone of the daily parameter (currently daily parameter) CCI ZA0 PI 55126 55156 55672 55673 55035 55095 55043 55168 55169 55073	string
`temperaturmessstelle`	Temperature measuring point Measuring point of the daily parameter (currently temperature is the only permitted daily parameter) CCI Z99 PI 55126 55156 55672 55673 55035 55095 55043 55168 55169 55073	string
`dienstanbieter`	Service provider based on the EDI@Energy code list	string
`herausgeber`	Issuer of the ID PI 55126 55156 55672 55673 55035 55095 55043 55168 55169 55073	string `NB`, `BDEW`, `TUM`
tagesmitteltemperatur	—	object
`berechnungTagesmitteltemperatur`	Berechnungsmethode	string `24H_MITTELWERT`, `VOM_ANBIETER_ZUR_VERFUEGUNG_GESTELLTE_AEQUIVALENTE_TAGESMITTELTEMPERATUR`, `AEQUIVALENTE_TAGESMITTELTEMPERATUR`
`anteilA`	Anteil A	number (float)
`anteilB`	Anteil B	number (float)
`anteilC`	Anteil C	number (float)
`anteilD`	Anteil D	number (float)
`begrenzungstemperatur`	Begrenzungstemperatur	string
lastprofileBilanzierungsbeteiligter[ ]	Load profiles of the balancing participant	object[]
`bezeichnung`	Name of the profile. Only codes from the valid list of profile definitions of the respective NB and the associated balancing area may be entered. CAV ABC PI 55613 55614 55126 55156 55672 55673 55628 55634 55035 55095 55043 55168 55169 55065 55066 55073 55195 55196 55223 55224 MSCONS LOC Z04	string
`verfahren`	Procedure - specific properties	string `SYNTHETISCH`, `ANALYTISCH`
`profilart`	Standard load profile CCI Z02 PI 55613 55614 55126 55156 55628 55634 55035 55043 55168 55169 55065 55066 55073 55195 55196 55223 55224 ORDERS PI 17201	string `ART_STANDARDLASTPROFIL`, `ART_TAGESPARAMETERABHAENGIGES_LASTPROFIL`, `ART_LASTPROFIL`
`profilschar`	Code for the profile set, name of the profile set. CAV COD PI 55126 55156 55672 55673 55035 55095 55073 MSCONS LOC Z06 PI 13011	string
`einspeisung`	Standard feed-in profile CCI Z04 PI 55672 55673 55628 55634 55095 55043 55168 55169 55065 55066 55073 55224 ORDERS PI 17201 Z05 day-parameter-dependent feed-in profile PI 55672 55673 55628 55634 55095 55043 55169 55065 55066 55073 ORDERS PI 17201	boolean
`herausgeber`	Issuer of the load profile 89 Assigned by the trader (here grid operator) 293 DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.)	string
`referenzprofilbezeichnung`	Code of the reference profile CAV COD PI 55672 55673 55628 55634 55095 55043 55168 55169 55065 55066 55073	string
`referenzprofil`	Referenzprofil	string
`profiltyp`	Profile type	string `SLP_SEP`, `TLP_TEP`, `TEP` `GEWERBE_ALLGEMEIN`, `GEWERBE_WERKTAGS_8_18_UHR`, `GEWERBE_MIT_STARKEM_BIS_UEBERWIEGENDEM_VERBRAUCH_IN_DEN_ABENDSTUNDEN`, `GEWERBE_DURCHLAUFEND`, `GEWERBE_LADEN_FRISEUR`, `GEWERBE_BAECKEREI_MIT_BACKSTUBE`, `GEWERBE_WOCHENENDBETRIEB`, `LANDWIRTSCHAFTSBETRIEBE_ALLGEMEIN`, `LANDWIRTSCHAFTSBETRIEBE_MIT_MILCHWIRTSCHAFT_NEBENERWERBS_TIERZUCHT`, `LANDWIRTSCHAFT_OHNE_MILCHVIEH`, `HAUSHALT`, `BANDLAST`, `UNTERBRECHBARE_VERBRAUCHSEINRICHTUNG`, `HEIZWAERMESPEICHER`, `STRASSENBELEUCHTUNG`, `PHOTOVOLTAIK_MARKTLOKATION`, `BLOCKHEIZKRAFTWERK`, `SONSTIGE_VERBRAUCHENDE_MARKTLOKATION`, `SONSTIGE_ERZEUGENDE_MARKTLOKATION`, `E_MOBILITAET_LADEPUNKT_IM_OEFFENTLICHEN_BEREICH`, `E_MOBILITAET_LADEPUNKT_EINES_HAUSHALTS`, `E_MOBILITAET_LADEPUNKT_EINES_GEWERBES`
`normierungsfaktor`	Normierungsfaktor	string `NORMIERUNGSFAKTOR_1_000_000_KWH_A`, `NORMIERUNGSFAKTOR_300_KWH_K`, `NORMIERUNGSFAKTOR_1_000_000_KW`
`begrenzungskonstante`	Begrenzungskonstante	string `BEGRENZUNGSKONSTANTE_0`, `BEGRENZUNGSKONSTANTE_1`
tagesparameter	Climate zone / temperature measuring point - for the temperature measuring point, the ID and the provider from the EDI@Energy code list are specified.	object
`klimazone`	Climate zone of the daily parameter (currently daily parameter) CCI ZA0 PI 55126 55156 55672 55673 55035 55095 55043 55168 55169 55073	string
`temperaturmessstelle`	Temperature measuring point Measuring point of the daily parameter (currently temperature is the only permitted daily parameter) CCI Z99 PI 55126 55156 55672 55673 55035 55095 55043 55168 55169 55073	string
`dienstanbieter`	Service provider based on the EDI@Energy code list	string
`herausgeber`	Issuer of the ID PI 55126 55156 55672 55673 55035 55095 55043 55168 55169 55073	string `NB`, `BDEW`, `TUM`
tagesmitteltemperatur	—	object
`berechnungTagesmitteltemperatur`	Berechnungsmethode	string `24H_MITTELWERT`, `VOM_ANBIETER_ZUR_VERFUEGUNG_GESTELLTE_AEQUIVALENTE_TAGESMITTELTEMPERATUR`, `AEQUIVALENTE_TAGESMITTELTEMPERATUR`
`anteilA`	Anteil A	number (float)
`anteilB`	Anteil B	number (float)
`anteilC`	Anteil C	number (float)
`anteilD`	Anteil D	number (float)
`begrenzungstemperatur`	Begrenzungstemperatur	string
`detailsPrognosegrundlage`[ ]	Profile type	string[] `SLP_SEP`, `TLP_TEP`, `TEP` `GEWERBE_ALLGEMEIN`, `GEWERBE_WERKTAGS_8_18_UHR`, `GEWERBE_MIT_STARKEM_BIS_UEBERWIEGENDEM_VERBRAUCH_IN_DEN_ABENDSTUNDEN`, `GEWERBE_DURCHLAUFEND`, `GEWERBE_LADEN_FRISEUR`, `GEWERBE_BAECKEREI_MIT_BACKSTUBE`, `GEWERBE_WOCHENENDBETRIEB`, `LANDWIRTSCHAFTSBETRIEBE_ALLGEMEIN`, `LANDWIRTSCHAFTSBETRIEBE_MIT_MILCHWIRTSCHAFT_NEBENERWERBS_TIERZUCHT`, `LANDWIRTSCHAFT_OHNE_MILCHVIEH`, `HAUSHALT`, `BANDLAST`, `UNTERBRECHBARE_VERBRAUCHSEINRICHTUNG`, `HEIZWAERMESPEICHER`, `STRASSENBELEUCHTUNG`, `PHOTOVOLTAIK_MARKTLOKATION`, `BLOCKHEIZKRAFTWERK`, `SONSTIGE_VERBRAUCHENDE_MARKTLOKATION`, `SONSTIGE_ERZEUGENDE_MARKTLOKATION`, `E_MOBILITAET_LADEPUNKT_IM_OEFFENTLICHEN_BEREICH`, `E_MOBILITAET_LADEPUNKT_EINES_HAUSHALTS`, `E_MOBILITAET_LADEPUNKT_EINES_GEWERBES`

Example Responses

[
  {
    "boTyp": "BILANZIERUNG",
    "versionStruktur": "1",
    "marktlokationsId": "50754496000",
    "gueltigkeitszeitraum": {
      "zeitraumId": null,
      "startdatum": null,
      "enddatum": null
    },
    "datenqualitaet": null,
    "lastprofile": [
      {
        "bezeichnung": "XYZ",
        "profilschar": null,
        "verfahren": "SYNTHETISCH",
        "einspeisung": false,
        "tagesparameter": {
          "klimazone": null,
          "temperaturmessstelle": null,
          "dienstanbieter": null,
          "herausgeber": null
        },
        "profilart": "ART_STANDARDLASTPROFIL",
        "herausgeber": "NB",
        "referenzprofilbezeichnung": "XYZ"
      }
    ],
    "lastprofileBilanzierungsbeteiligter": [
      {
        "bezeichnung": "ZYX",
        "profilschar": null,
        "verfahren": "SYNTHETISCH",
        "einspeisung": false,
        "tagesparameter": {
          "klimazone": null,
          "temperaturmessstelle": null,
          "dienstanbieter": null,
          "herausgeber": null
        },
        "profilart": "ART_STANDARDLASTPROFIL",
        "herausgeber": "NB"
      }
    ],
    "bilanzierungsbeginn": "0001-01-01T00:00:00Z",
    "bilanzierungsende": "2025-10-31T23:00:00Z",
    "bilanzkreis": "11Y0-0000-0076-N",
    "jahresverbrauchsprognose": {
      "wert": 2300,
      "einheit": "KWH"
    },
    "vorjahresverbrauch": {
      "wert": 2500,
      "einheit": "KWH"
    },
    "temperaturarbeit": {
      "wert": null,
      "einheit": null
    },
    "kundenwert": {
      "wert": 2550,
      "einheit": "KWH"
    },
    "verbrauchsaufteilung": {
      "wert": null,
      "einheit": null
    },
    "zeitreihentyp": "SLS",
    "aggregationsverantwortung": "VNB",
    "prognosegrundlage": "PROFILE",
    "detailsPrognosegrundlage": [
      "SLP_SEP"
    ],
    "wahlrechtPrognosegrundlage": "DURCH_LF",
    "fallgruppenzuordnung": null,
    "prioritaet": "1",
    "grundWahlrechtPrognosegrundlage": "DURCH_LF",
    "abwicklungsmodell": "MODELL_1_BILANZIERUNG_AN_MARKTLOKATION",
    "datenDerBeteiligtenMarktrolle": [
      {
        "marktlokationsId": "50754496000",
        "lastprofile": [
          {
            "bezeichnung": "H0",
            "profilschar": null,
            "verfahren": "SYNTHETISCH",
            "tagesparameter": {
              "klimazone": null,
              "temperaturmessstelle": null,
              "dienstanbieter": null,
              "herausgeber": null
            },
            "einspeisung": false,
            "profilart": "ART_STANDARDLASTPROFIL",
            "herausgeber": "NB"
          }
        ],
        "jahresverbrauchsprognose": {
          "wert": 2300,
          "einheit": "KWH"
        },
        "temperaturarbeit": {
          "wert": null,
          "einheit": null
        },
        "bilanzkreis": "11Y0-0000-0076-N",
        "bilanzkreisAn": "11Y0-0000-0076-N",
        "bilanzkreisVon": "11Y0-0000-0077-N",
        "zeitreihentyp": "SLS",
        "aggregationsverantwortung": "VNB",
        "prognosegrundlage": "PROFILE",
        "detailsPrognosegrundlage": [
          "SLP_SEP"
        ]
      }
    ]
  }
]

json

application/json

Keys and mapping Read remittance advice

Read balancing

GET

https://mock.macoapp.de

/getAccountingBasic

Reading a balancing using LocationId (Parameter1) at the point in time (Parameter3)

query Parameters

Structure (BO4E)	Description	Format
`parameter1`*	Location ID · Example: 74018657187 · Default: 74018657187	string
`parameter2`*	Location type · Example: MALO · Default: MALO	string `MALO`, `MELO`, `NELO` `TECHNISCHE_RESSOURCE`, `STEUERBARE_RESOURCE`, `TRANCHE`
`parameter3`*	Date (valid from) or key date if parameter4 is not set · Example: 2024-06-28T12:18:00Z · Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$	string (date-time)
`parameter4`*	Date (Valid until) · Example: 2024-06-28T12:18:00Z · Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$	string (date-time)
`command`	Corresponds to the operationId of this interface. This operation ID corresponds to the command in the Camunda connector process. If the backend provides a generic endpoint, this command can be used to define which operation is to be executed.	string

Read balancing › Responses

Successful reading of the balancing

Array of: object — the response is a list of these objects, not a single object. Every entry has this structure:

Structure (BO4E)	Description	Format
`boTyp`*	Type of the BO	string `ANSPRECHPARTNER`, `AVIS`, `ENERGIEMENGE` `GESCHAEFTSOBJEKT`, `GESCHAEFTSPARTNER`, `MARKTLOKATION`, `MARKTTEILNEHMER`, `MESSLOKATION`, `ZAEHLER`, `KOSTEN`, `TARIF`, `PREISBLATT`, `PREISBLATTNETZNUTZUNG`, `PREISBLATTMESSUNG`, `PREISBLATTUMLAGEN`, `PREISBLATTDIENSTLEISTUNG`, `PREISBLATTKONZESSIONSABGABE`, `ZEITREIHE`, `LASTGANG`, `HANDELSUNSTIMMIGKEIT`, `ANFRAGE`, `AUFTRAG`, `STATUSMITTEILUNG`, `BERECHNUNGSFORMEL`, `RECHNUNG`, `BILANZIERUNG`, `NETZNUTZUNGSVERTRAG`, `MESSSTELLENBETRIEBSVERTRAG`, `ENERGIELIEFERVERTRAG`, `SPERRAUFTRAG`, `ANGEBOT`, `TRANCHE`, `KOMMUNIKATIONSDATEN`, `ZAEHLZEITDEFINITION`, `SCHALTZEITDEFINITION`, `LEISTUNGSKURVENDEFINITION`, `NETZLOKATION`, `STEUERBARE_RESSOURCE`, `TECHNISCHE_RESSOURCE`, `AD_HOC_STEUERKANAL`, `LOKATIONSBUENDEL`, `WERTE_NACH_TYP2`, `REKLAMATION`, `STATUSBERICHT`, `VERTRAG`, `BILANZKREIS`, `VERWENDUNGSZEITRAUM`, `TARIFINFO`, `SUMMENZEITREIHE`
`versionStruktur`*	versionStruktur	string
`marktlokationsId`	Which market location these balancing data apply to. Reference to an ID of a market location LOC Z16 RFF Z18 PI 55690 55060 55043 55168 55169 55238 55239 55074 55075 55076 55065 55066 55195 55196 55201 55202	string
`aggregationsverantwortung`	Aggregation responsibility, to whom the balancing is assigned. CCI 6 PI 55043 55168 55169 55195 55196 55223 55224	string `UENB`, `VNB`
`zeitreihentyp`	Time series type Aggregated time series type Z21 CCI 15 Z21 PI 55670 55671 55074 55075 55076 55065 55066 55196 MSCONS Time series type	string
`prognosegrundlage`	Forecast basis; this information is used to derive the balancing procedure mentioned in the processes. PI 55013 55613 55614 55126 55156 55674 55675 55672 55673 55628 55634 55035 55095 55060 55043 55168 55169 55195 55196 CAV Z38 ORDERS PI 17120 Gas UTILMD Forecast basis already exchanged ZB0 Forecast based on values valid ZB1 Forecast based on profiles valid CCI ZB0 PI 44139 44142	string `WERTE`, `PROFILE`
`bilanzierungsbeginn`	Start of the assignment of a MaLo, tranche to the balancing group. DTM 158 55238 55239 55062 55064 55065 55066 55071 55195 55196 55223 55224 55197 55199 55203 55204 55205 55209 55210 55211	string (date-time)
`bilanzierungsende`	End of the assignment of a MaLo, tranche to the balancing group. DTM 159 55240 55241 55242 55243 55063 55064 55065 55066 55072 55195 55196 55223 55224 55198 55200 55206 55207 55208 55212 55213 55214	string (date-time)
`bilanzkreis`	Balancing group or the account on which the balancing is carried out. CCI Z19 PI 55613 55614 55126 55156 55674 55675 55672 55673 55670 55671 55074 55075 55076 55065 55066 55195 55196	string
`fallgruppenzuordnung`	Case group assignment according to GABi Gas GABi- SLP customers analytical method - Exit SLPana GABi- SLP customers synthetic method - Exit SLPsyn CCI Z17 PI 44123 44156 44157 44001 44002 44013 44014 44019 44020 44021 44035 44103 44104	string `GABI_RLMmT`, `GABI_RLMoT`, `GABI_RLMNEV`
temperaturarbeit	Customer value TLP, specification of the specific energy for a daily-parameter-dependent market location as a numeric value, of the adjusted electrical energy of a daily-parameter-dependent market location. Also includes joint metering - SLP and TLP-. QTY Z10 PI 55672 55673 55628 55634 55035 55095 55060 55065 55066 QTY 265 PI 55013 55126 55156 55672 55673 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066 QTY Z08 PI 55013 55126 55156 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066	object
`wert`	Value quantity specification	number (float)
`einheit`	Unit of measurement	string `W`, `WH`, `KW` `KWH`, `KVARH`, `MW`, `MWH`, `STUECK`, `KUBIKMETER`, `STUNDE`, `TAG`, `MONAT`, `JAHR`, `PROZENT`, `ANZAHL`, `VAR`, `KVAR`, `VARH`, `KWHK`, `Z16`, `KWT`, `WATT_PRO_QUADRATMETER`, `METER_PRO_SEKUNDE`
`startdatum`	startdatum	string (date-time)
`enddatum`	enddatum	string (date-time)
jahresverbrauchsprognose	Customer value TLP, specification of the specific energy for a daily-parameter-dependent market location as a numeric value, of the adjusted electrical energy of a daily-parameter-dependent market location. Also includes joint metering - SLP and TLP-. QTY Z10 PI 55672 55673 55628 55634 55035 55095 55060 55065 55066 QTY 265 PI 55013 55126 55156 55672 55673 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066 QTY Z08 PI 55013 55126 55156 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066	object
`wert`	Value quantity specification	number (float)
`einheit`	Unit of measurement	string `W`, `WH`, `KW` `KWH`, `KVARH`, `MW`, `MWH`, `STUECK`, `KUBIKMETER`, `STUNDE`, `TAG`, `MONAT`, `JAHR`, `PROZENT`, `ANZAHL`, `VAR`, `KVAR`, `VARH`, `KWHK`, `Z16`, `KWT`, `WATT_PRO_QUADRATMETER`, `METER_PRO_SEKUNDE`
`startdatum`	startdatum	string (date-time)
`enddatum`	enddatum	string (date-time)
kundenwert	Customer value TLP, specification of the specific energy for a daily-parameter-dependent market location as a numeric value, of the adjusted electrical energy of a daily-parameter-dependent market location. Also includes joint metering - SLP and TLP-. QTY Z10 PI 55672 55673 55628 55634 55035 55095 55060 55065 55066 QTY 265 PI 55013 55126 55156 55672 55673 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066 QTY Z08 PI 55013 55126 55156 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066	object
`wert`	Value quantity specification	number (float)
`einheit`	Unit of measurement	string `W`, `WH`, `KW` `KWH`, `KVARH`, `MW`, `MWH`, `STUECK`, `KUBIKMETER`, `STUNDE`, `TAG`, `MONAT`, `JAHR`, `PROZENT`, `ANZAHL`, `VAR`, `KVAR`, `VARH`, `KWHK`, `Z16`, `KWT`, `WATT_PRO_QUADRATMETER`, `METER_PRO_SEKUNDE`
`startdatum`	startdatum	string (date-time)
`enddatum`	enddatum	string (date-time)
verbrauchsaufteilung	Customer value TLP, specification of the specific energy for a daily-parameter-dependent market location as a numeric value, of the adjusted electrical energy of a daily-parameter-dependent market location. Also includes joint metering - SLP and TLP-. QTY Z10 PI 55672 55673 55628 55634 55035 55095 55060 55065 55066 QTY 265 PI 55013 55126 55156 55672 55673 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066 QTY Z08 PI 55013 55126 55156 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066	object
`wert`	Value quantity specification	number (float)
`einheit`	Unit of measurement	string `W`, `WH`, `KW` `KWH`, `KVARH`, `MW`, `MWH`, `STUECK`, `KUBIKMETER`, `STUNDE`, `TAG`, `MONAT`, `JAHR`, `PROZENT`, `ANZAHL`, `VAR`, `KVAR`, `VARH`, `KWHK`, `Z16`, `KWT`, `WATT_PRO_QUADRATMETER`, `METER_PRO_SEKUNDE`
`startdatum`	startdatum	string (date-time)
`enddatum`	enddatum	string (date-time)
`wahlrechtPrognosegrundlage`	Right to choose the forecast basis (true = right to choose lies with the supplier)	string `DURCH_LF`, `DURCH_LF_NICHT_GEGEBEN`, `NICHT_WEGEN_GROSSEN_VERBRAUCHS` `NICHT_WEGEN_EIGENVERBRAUCH`, `NICHT_WEGEN_TAGES_VERBRAUCH`, `NICHT_WEGEN_ENWG`
`grundWahlrechtPrognosegrundlage`	Right to choose the forecast basis (true = right to choose lies with the supplier)	string `DURCH_LF`, `DURCH_LF_NICHT_GEGEBEN`, `NICHT_WEGEN_GROSSEN_VERBRAUCHS` `NICHT_WEGEN_EIGENVERBRAUCH`, `NICHT_WEGEN_TAGES_VERBRAUCH`, `NICHT_WEGEN_ENWG`
`abwicklungsmodell`	Settlement model; on the basis of this information it is derived for the balancing whether the Malo is balanced with the assigned balancing group in model 1 ZE9 or whether the energy quantity of the Malo is handed over as NGZ in model 2 ZF0 into an adjacent balancing area. CAV ZA2 PI 55628 55634 55043 55168 55169	string `MODELL_1_BILANZIERUNG_AN_MARKTLOKATION`, `MODELL_2_BILANZIERUNG_IM_BILANZIERUNGSGEBIET`
vorjahresverbrauch*	Customer value TLP, specification of the specific energy for a daily-parameter-dependent market location as a numeric value, of the adjusted electrical energy of a daily-parameter-dependent market location. Also includes joint metering - SLP and TLP-. QTY Z10 PI 55672 55673 55628 55634 55035 55095 55060 55065 55066 QTY 265 PI 55013 55126 55156 55672 55673 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066 QTY Z08 PI 55013 55126 55156 55628 55634 55035 55095 55060 55043 55168 55169 55065 55066	object
`wert`	Value quantity specification	number (float)
`einheit`	Unit of measurement	string `W`, `WH`, `KW` `KWH`, `KVARH`, `MW`, `MWH`, `STUECK`, `KUBIKMETER`, `STUNDE`, `TAG`, `MONAT`, `JAHR`, `PROZENT`, `ANZAHL`, `VAR`, `KVAR`, `VARH`, `KWHK`, `Z16`, `KWT`, `WATT_PRO_QUADRATMETER`, `METER_PRO_SEKUNDE`
`startdatum`	startdatum	string (date-time)
`enddatum`	enddatum	string (date-time)
`datenqualitaet`	Data quality	string `ERWARTETE_DATEN`, `IM_SYSTEM_VORHANDENE_DATEN`, `INFORMATIVE_DATEN` `GUELTIGE_DATEN`, `KEINE_DATEN`, `IM_SYSTEM_KEINE_DATEN_VORHANDEN`, `KEINE_DATEN_ERWARTET`, `DIFFERENZ_DATEN`, `DIFFERENZ_ERWARTETE_DATEN`, `DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN`
gueltigkeitszeitraum	Validity period	object
`zeiteinheit`	not in use	string `SEKUNDE`, `MINUTE`, `STUNDE` `VIERTEL_STUNDE`, `TAG`, `WOCHE`, `MONAT`, `QUARTAL`, `HALBJAHR`, `JAHR`
`dauer`	Time span, value	integer
`startdatum`	Date from DTM Z25 Use of the data from DTM 163 Processing, start date/time DTM 155 Invoicing period, start date DTM Z42 Provisional billing period start	string (date-time)
`enddatum`	Date from DTM Z26 Use of the data until DTM164 Processing, end date/time DTM 156 Invoicing period, end date DTM Z43 Provisional billing period end	string (date-time)
`einheit`	not in use	string `SEKUNDE`, `MINUTE`, `STUNDE` `VIERTEL_STUNDE`, `TAG`, `WOCHE`, `MONAT`, `QUARTAL`, `HALBJAHR`, `JAHR`
`ableseZeitraum`	Periodic meter reading of the NB DTM 752 PI 44113 44140 44142 44043 44168 44169 44060	string
`abrechnungsZeitraum`	Date on which the grid usage settlement of the NB takes place DTM Z21 PI 44112 44139 44142 44002 44013 44014 44035	string
`zeitraumText`	Period text	string
`zeitraumId`	Reference to period ID RFF Z46 PI 25001	integer
lastprofile[ ]	Standardised profile - profile designation CCI Z02	object[]
`bezeichnung`	Name of the profile. Only codes from the valid list of profile definitions of the respective NB and the associated balancing area may be entered. CAV ABC PI 55613 55614 55126 55156 55672 55673 55628 55634 55035 55095 55043 55168 55169 55065 55066 55073 55195 55196 55223 55224 MSCONS LOC Z04	string
`verfahren`	Procedure - specific properties	string `SYNTHETISCH`, `ANALYTISCH`
`profilart`	Standard load profile CCI Z02 PI 55613 55614 55126 55156 55628 55634 55035 55043 55168 55169 55065 55066 55073 55195 55196 55223 55224 ORDERS PI 17201	string `ART_STANDARDLASTPROFIL`, `ART_TAGESPARAMETERABHAENGIGES_LASTPROFIL`, `ART_LASTPROFIL`
`profilschar`	Code for the profile set, name of the profile set. CAV COD PI 55126 55156 55672 55673 55035 55095 55073 MSCONS LOC Z06 PI 13011	string
`einspeisung`	Standard feed-in profile CCI Z04 PI 55672 55673 55628 55634 55095 55043 55168 55169 55065 55066 55073 55224 ORDERS PI 17201 Z05 day-parameter-dependent feed-in profile PI 55672 55673 55628 55634 55095 55043 55169 55065 55066 55073 ORDERS PI 17201	boolean
`herausgeber`	Issuer of the load profile 89 Assigned by the trader (here grid operator) 293 DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.)	string
`referenzprofilbezeichnung`	Code of the reference profile CAV COD PI 55672 55673 55628 55634 55095 55043 55168 55169 55065 55066 55073	string
`referenzprofil`	Referenzprofil	string
`profiltyp`	Profile type	string `SLP_SEP`, `TLP_TEP`, `TEP` `GEWERBE_ALLGEMEIN`, `GEWERBE_WERKTAGS_8_18_UHR`, `GEWERBE_MIT_STARKEM_BIS_UEBERWIEGENDEM_VERBRAUCH_IN_DEN_ABENDSTUNDEN`, `GEWERBE_DURCHLAUFEND`, `GEWERBE_LADEN_FRISEUR`, `GEWERBE_BAECKEREI_MIT_BACKSTUBE`, `GEWERBE_WOCHENENDBETRIEB`, `LANDWIRTSCHAFTSBETRIEBE_ALLGEMEIN`, `LANDWIRTSCHAFTSBETRIEBE_MIT_MILCHWIRTSCHAFT_NEBENERWERBS_TIERZUCHT`, `LANDWIRTSCHAFT_OHNE_MILCHVIEH`, `HAUSHALT`, `BANDLAST`, `UNTERBRECHBARE_VERBRAUCHSEINRICHTUNG`, `HEIZWAERMESPEICHER`, `STRASSENBELEUCHTUNG`, `PHOTOVOLTAIK_MARKTLOKATION`, `BLOCKHEIZKRAFTWERK`, `SONSTIGE_VERBRAUCHENDE_MARKTLOKATION`, `SONSTIGE_ERZEUGENDE_MARKTLOKATION`, `E_MOBILITAET_LADEPUNKT_IM_OEFFENTLICHEN_BEREICH`, `E_MOBILITAET_LADEPUNKT_EINES_HAUSHALTS`, `E_MOBILITAET_LADEPUNKT_EINES_GEWERBES`
`normierungsfaktor`	Normierungsfaktor	string `NORMIERUNGSFAKTOR_1_000_000_KWH_A`, `NORMIERUNGSFAKTOR_300_KWH_K`, `NORMIERUNGSFAKTOR_1_000_000_KW`
`begrenzungskonstante`	Begrenzungskonstante	string `BEGRENZUNGSKONSTANTE_0`, `BEGRENZUNGSKONSTANTE_1`
tagesparameter	Climate zone / temperature measuring point - for the temperature measuring point, the ID and the provider from the EDI@Energy code list are specified.	object
`klimazone`	Climate zone of the daily parameter (currently daily parameter) CCI ZA0 PI 55126 55156 55672 55673 55035 55095 55043 55168 55169 55073	string
`temperaturmessstelle`	Temperature measuring point Measuring point of the daily parameter (currently temperature is the only permitted daily parameter) CCI Z99 PI 55126 55156 55672 55673 55035 55095 55043 55168 55169 55073	string
`dienstanbieter`	Service provider based on the EDI@Energy code list	string
`herausgeber`	Issuer of the ID PI 55126 55156 55672 55673 55035 55095 55043 55168 55169 55073	string `NB`, `BDEW`, `TUM`
tagesmitteltemperatur	—	object
`berechnungTagesmitteltemperatur`	Berechnungsmethode	string `24H_MITTELWERT`, `VOM_ANBIETER_ZUR_VERFUEGUNG_GESTELLTE_AEQUIVALENTE_TAGESMITTELTEMPERATUR`, `AEQUIVALENTE_TAGESMITTELTEMPERATUR`
`anteilA`	Anteil A	number (float)
`anteilB`	Anteil B	number (float)
`anteilC`	Anteil C	number (float)
`anteilD`	Anteil D	number (float)
`begrenzungstemperatur`	Begrenzungstemperatur	string
lastprofileBilanzierungsbeteiligter[ ]	Load profiles of the balancing participant	object[]
`bezeichnung`	Name of the profile. Only codes from the valid list of profile definitions of the respective NB and the associated balancing area may be entered. CAV ABC PI 55613 55614 55126 55156 55672 55673 55628 55634 55035 55095 55043 55168 55169 55065 55066 55073 55195 55196 55223 55224 MSCONS LOC Z04	string
`verfahren`	Procedure - specific properties	string `SYNTHETISCH`, `ANALYTISCH`
`profilart`	Standard load profile CCI Z02 PI 55613 55614 55126 55156 55628 55634 55035 55043 55168 55169 55065 55066 55073 55195 55196 55223 55224 ORDERS PI 17201	string `ART_STANDARDLASTPROFIL`, `ART_TAGESPARAMETERABHAENGIGES_LASTPROFIL`, `ART_LASTPROFIL`
`profilschar`	Code for the profile set, name of the profile set. CAV COD PI 55126 55156 55672 55673 55035 55095 55073 MSCONS LOC Z06 PI 13011	string
`einspeisung`	Standard feed-in profile CCI Z04 PI 55672 55673 55628 55634 55095 55043 55168 55169 55065 55066 55073 55224 ORDERS PI 17201 Z05 day-parameter-dependent feed-in profile PI 55672 55673 55628 55634 55095 55043 55169 55065 55066 55073 ORDERS PI 17201	boolean
`herausgeber`	Issuer of the load profile 89 Assigned by the trader (here grid operator) 293 DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.)	string
`referenzprofilbezeichnung`	Code of the reference profile CAV COD PI 55672 55673 55628 55634 55095 55043 55168 55169 55065 55066 55073	string
`referenzprofil`	Referenzprofil	string
`profiltyp`	Profile type	string `SLP_SEP`, `TLP_TEP`, `TEP` `GEWERBE_ALLGEMEIN`, `GEWERBE_WERKTAGS_8_18_UHR`, `GEWERBE_MIT_STARKEM_BIS_UEBERWIEGENDEM_VERBRAUCH_IN_DEN_ABENDSTUNDEN`, `GEWERBE_DURCHLAUFEND`, `GEWERBE_LADEN_FRISEUR`, `GEWERBE_BAECKEREI_MIT_BACKSTUBE`, `GEWERBE_WOCHENENDBETRIEB`, `LANDWIRTSCHAFTSBETRIEBE_ALLGEMEIN`, `LANDWIRTSCHAFTSBETRIEBE_MIT_MILCHWIRTSCHAFT_NEBENERWERBS_TIERZUCHT`, `LANDWIRTSCHAFT_OHNE_MILCHVIEH`, `HAUSHALT`, `BANDLAST`, `UNTERBRECHBARE_VERBRAUCHSEINRICHTUNG`, `HEIZWAERMESPEICHER`, `STRASSENBELEUCHTUNG`, `PHOTOVOLTAIK_MARKTLOKATION`, `BLOCKHEIZKRAFTWERK`, `SONSTIGE_VERBRAUCHENDE_MARKTLOKATION`, `SONSTIGE_ERZEUGENDE_MARKTLOKATION`, `E_MOBILITAET_LADEPUNKT_IM_OEFFENTLICHEN_BEREICH`, `E_MOBILITAET_LADEPUNKT_EINES_HAUSHALTS`, `E_MOBILITAET_LADEPUNKT_EINES_GEWERBES`
`normierungsfaktor`	Normierungsfaktor	string `NORMIERUNGSFAKTOR_1_000_000_KWH_A`, `NORMIERUNGSFAKTOR_300_KWH_K`, `NORMIERUNGSFAKTOR_1_000_000_KW`
`begrenzungskonstante`	Begrenzungskonstante	string `BEGRENZUNGSKONSTANTE_0`, `BEGRENZUNGSKONSTANTE_1`
tagesparameter	Climate zone / temperature measuring point - for the temperature measuring point, the ID and the provider from the EDI@Energy code list are specified.	object
`klimazone`	Climate zone of the daily parameter (currently daily parameter) CCI ZA0 PI 55126 55156 55672 55673 55035 55095 55043 55168 55169 55073	string
`temperaturmessstelle`	Temperature measuring point Measuring point of the daily parameter (currently temperature is the only permitted daily parameter) CCI Z99 PI 55126 55156 55672 55673 55035 55095 55043 55168 55169 55073	string
`dienstanbieter`	Service provider based on the EDI@Energy code list	string
`herausgeber`	Issuer of the ID PI 55126 55156 55672 55673 55035 55095 55043 55168 55169 55073	string `NB`, `BDEW`, `TUM`
tagesmitteltemperatur	—	object
`berechnungTagesmitteltemperatur`	Berechnungsmethode	string `24H_MITTELWERT`, `VOM_ANBIETER_ZUR_VERFUEGUNG_GESTELLTE_AEQUIVALENTE_TAGESMITTELTEMPERATUR`, `AEQUIVALENTE_TAGESMITTELTEMPERATUR`
`anteilA`	Anteil A	number (float)
`anteilB`	Anteil B	number (float)
`anteilC`	Anteil C	number (float)
`anteilD`	Anteil D	number (float)
`begrenzungstemperatur`	Begrenzungstemperatur	string
`detailsPrognosegrundlage`[ ]	Profile type	string[] `SLP_SEP`, `TLP_TEP`, `TEP` `GEWERBE_ALLGEMEIN`, `GEWERBE_WERKTAGS_8_18_UHR`, `GEWERBE_MIT_STARKEM_BIS_UEBERWIEGENDEM_VERBRAUCH_IN_DEN_ABENDSTUNDEN`, `GEWERBE_DURCHLAUFEND`, `GEWERBE_LADEN_FRISEUR`, `GEWERBE_BAECKEREI_MIT_BACKSTUBE`, `GEWERBE_WOCHENENDBETRIEB`, `LANDWIRTSCHAFTSBETRIEBE_ALLGEMEIN`, `LANDWIRTSCHAFTSBETRIEBE_MIT_MILCHWIRTSCHAFT_NEBENERWERBS_TIERZUCHT`, `LANDWIRTSCHAFT_OHNE_MILCHVIEH`, `HAUSHALT`, `BANDLAST`, `UNTERBRECHBARE_VERBRAUCHSEINRICHTUNG`, `HEIZWAERMESPEICHER`, `STRASSENBELEUCHTUNG`, `PHOTOVOLTAIK_MARKTLOKATION`, `BLOCKHEIZKRAFTWERK`, `SONSTIGE_VERBRAUCHENDE_MARKTLOKATION`, `SONSTIGE_ERZEUGENDE_MARKTLOKATION`, `E_MOBILITAET_LADEPUNKT_IM_OEFFENTLICHEN_BEREICH`, `E_MOBILITAET_LADEPUNKT_EINES_HAUSHALTS`, `E_MOBILITAET_LADEPUNKT_EINES_GEWERBES`

Example Responses

[
  {
    "boTyp": "BILANZIERUNG",
    "versionStruktur": "1",
    "marktlokationsId": "50754496000",
    "gueltigkeitszeitraum": {
      "zeitraumId": null,
      "startdatum": null,
      "enddatum": null
    },
    "datenqualitaet": null,
    "lastprofile": [
      {
        "bezeichnung": "XYZ",
        "profilschar": null,
        "verfahren": "SYNTHETISCH",
        "einspeisung": false,
        "tagesparameter": {
          "klimazone": null,
          "temperaturmessstelle": null,
          "dienstanbieter": null,
          "herausgeber": null
        },
        "profilart": "ART_STANDARDLASTPROFIL",
        "herausgeber": "NB",
        "referenzprofilbezeichnung": "XYZ"
      }
    ],
    "lastprofileBilanzierungsbeteiligter": [
      {
        "bezeichnung": "ZYX",
        "profilschar": null,
        "verfahren": "SYNTHETISCH",
        "einspeisung": false,
        "tagesparameter": {
          "klimazone": null,
          "temperaturmessstelle": null,
          "dienstanbieter": null,
          "herausgeber": null
        },
        "profilart": "ART_STANDARDLASTPROFIL",
        "herausgeber": "NB"
      }
    ],
    "bilanzierungsbeginn": "0001-01-01T00:00:00Z",
    "bilanzierungsende": "2025-10-31T23:00:00Z",
    "bilanzkreis": "11Y0-0000-0076-N",
    "jahresverbrauchsprognose": {
      "wert": 2300,
      "einheit": "KWH"
    },
    "vorjahresverbrauch": {
      "wert": 2500,
      "einheit": "KWH"
    },
    "temperaturarbeit": {
      "wert": null,
      "einheit": null
    },
    "kundenwert": {
      "wert": 2550,
      "einheit": "KWH"
    },
    "verbrauchsaufteilung": {
      "wert": null,
      "einheit": null
    },
    "zeitreihentyp": "SLS",
    "aggregationsverantwortung": "VNB",
    "prognosegrundlage": "PROFILE",
    "detailsPrognosegrundlage": [
      "SLP_SEP"
    ],
    "wahlrechtPrognosegrundlage": "DURCH_LF",
    "fallgruppenzuordnung": null,
    "prioritaet": "1",
    "grundWahlrechtPrognosegrundlage": "DURCH_LF",
    "abwicklungsmodell": "MODELL_1_BILANZIERUNG_AN_MARKTLOKATION",
    "datenDerBeteiligtenMarktrolle": [
      {
        "marktlokationsId": "50754496000",
        "lastprofile": [
          {
            "bezeichnung": "H0",
            "profilschar": null,
            "verfahren": "SYNTHETISCH",
            "tagesparameter": {
              "klimazone": null,
              "temperaturmessstelle": null,
              "dienstanbieter": null,
              "herausgeber": null
            },
            "einspeisung": false,
            "profilart": "ART_STANDARDLASTPROFIL",
            "herausgeber": "NB"
          }
        ],
        "jahresverbrauchsprognose": {
          "wert": 2300,
          "einheit": "KWH"
        },
        "temperaturarbeit": {
          "wert": null,
          "einheit": null
        },
        "bilanzkreis": "11Y0-0000-0076-N",
        "bilanzkreisAn": "11Y0-0000-0076-N",
        "bilanzkreisVon": "11Y0-0000-0077-N",
        "zeitreihentyp": "SLS",
        "aggregationsverantwortung": "VNB",
        "prognosegrundlage": "PROFILE",
        "detailsPrognosegrundlage": [
          "SLP_SEP"
        ]
      }
    ]
  }
]

json

application/json

Feedback on the documentation

Feedback on the documentation

Read balancing

Read balancing

query Parameters

Read balancing › Responses

Read balancing

Read balancing

query Parameters

Read balancing › Responses