Berechnungsformel lesen - MACO APP

Lesen des Berechnunungsformel einer Lokation (Parameter1) vom Typ (Parameter2 - default MALO) zum Stichtag (Parameter3)

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

parameter1

string

required

LokationsId

Default:

74018657187

Example:

parameter2

enum<string>

required

LokationsTyp

Allowed values:

MALOMELONELOTECHNISCHE_RESSOURCESTEUERBARE_RESOURCETRANCHE

Default:

MALO

Example:

MALO

parameter3

string <date-time>

required

Datum (Gültig ab) oder Stichtag, wenn parameter4 nicht gesetzt

Example:

Match pattern:

^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$

parameter4

string <date-time>

optional

Datum (Gültig bis)

Example:

Match pattern:

^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$

command

string

optional

Entspricht der operationId dieser Schnittstelle. Diese Operation Id entspricht dem Command im Camunda Konnektor Prozess. Wenn das Backend einen generischen Endpunkt bereitstellt, kann dieses Command gentutzt werden um zu definieren welche Operation ausgeführt werden soll.

Example:

SAP_LESEN_BRECHNUNGSFORMEL_BASIS

Responses

🟢200OK

application/json

Erfolgreiches Lesen der Berechnunungsformel

Body

boTyp

enum<string>

required

Typ des BO

Allowed values:

ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO

versionStruktur

string

required

versionStruktur

Default:

beginndatum

string <date-time>

optional

Der inklusive Zeitpunkt ab dem die Berechnungsformel gültig ist

notwendigkeit

enum<string>

optional

Beschreibt ob eine Berechnungsformel notwendig ist

Allowed values:

BERECHNUNGSFORMEL_NOTWENDIGBERECHNUNGSFORMEL_MUSS_ANGEFRAGT_WERDENBERECHNUNGSFORMEL_TRIVIALBERECHNUNGSFORMEL_NICHT_NOTWENDIG

lieferrichtung

enum<string>

optional

The UTILTS 'Lieferrichtung der Marktlokation' is contained in the marktlokations-bo also the relation between Berechnungsformel↔ Marktlokation is modelled as 'link'

Allowed values:

AUSSPEINSP

rechenschrittId

integer

optional

ID des Rechenschritts [1 - 99999]

rechenschritt

object (Rechenschritt)

optional

rechenschrittBestandteilId

integer

optional

rechenschrittBestandteilId

referenzRechenschrittId

integer

optional

referenzRechenschrittId

operation

enum<string>

optional

Mit dieser Aufzählung können arithmetische Operationen festgelegt werden

Allowed values:

ADDITIONSUBTRAKTIONDIVISIONDIVIDENDMULTIPLIKATIONPOSITIVWERT

verlustfaktorTrafo

number <float>

optional

verlustfaktorTrafo

verlustfaktorLeitung

number <float>

optional

verlustfaktorLeitung

aufteilungsfaktorEnergiemenge

number <float>

optional

aufteilungsfaktorEnergiemenge

messlokationsId

string

optional

messlokationsId

energieflussrichtung

enum<string>

optional

Spezifiziert die Energierichtung einer Markt- und/oder Messlokation

Allowed values:

AUSSPEINSP

rechenschritte

array[object (Rechenschritt) {8}]

optional

Eine Berechnungsformel enthält, falls sie notwendig ist, einen oder mehrere Berechnungschritte, die hier rekursiv abgebildet werden.

rechenschrittBestandteilId

integer

optional

rechenschrittBestandteilId

referenzRechenschrittId

integer

optional

referenzRechenschrittId

operation

enum<string>

optional

Mit dieser Aufzählung können arithmetische Operationen festgelegt werden

Allowed values:

ADDITIONSUBTRAKTIONDIVISIONDIVIDENDMULTIPLIKATIONPOSITIVWERT

verlustfaktorTrafo

number <float>

optional

verlustfaktorTrafo

verlustfaktorLeitung

number <float>

optional

verlustfaktorLeitung

aufteilungsfaktorEnergiemenge

number <float>

optional

aufteilungsfaktorEnergiemenge

messlokationsId

string

optional

messlokationsId

energieflussrichtung

enum<string>

optional

Spezifiziert die Energierichtung einer Markt- und/oder Messlokation

Allowed values:

AUSSPEINSP

verwendungszweck

array[object (Verwendungszweck) {2}]

optional

Verwendungszweck der Werte

marktrolle

enum<string>

optional

Diese Rollen kann ein Marktteilnehmer einnehmen

Allowed values:

NBLFMSBMSBAGMSBMDLDLBKVBKOUENBKUNDE-SELBST-NNMGVEIVRBKUNDEINTERESSENTKNUBABIKOESA

zweck

array[string]

optional

zweck

Allowed values:

NETZNUTZUNGSABRECHNUNGBILANZKREISABRECHNUNGMEHRMINDERMENGENABRECHNUNGENDKUNDENABRECHNUNGUEBERMITTLUNG_AN_DAS_HKNRBLINDARBEITSABRECHNUNGERMITTLUNG_AUSGEGLICHENHEIT_BILANZKREISBLINDARBEITABRECHNUNG_BETRIEBSFUEHRUNGES_LIEGT_KEIN_VERWENDUNGSZWECK_VOR

gueltigkeitszeitraum

object (Zeitraum)

optional

Gültigkeitszeitraum der Werte

zeiteinheit

enum<string>

optional

Zeiteinheit

Allowed values:

SEKUNDEMINUTESTUNDEVIERTEL_STUNDETAGWOCHEMONATQUARTALHALBJAHRJAHR

dauer

integer

optional

dauer

startdatum

string <date-time>

optional

startdatum

enddatum

string <date-time>

optional

enddatum

einheit

enum<string>

optional

Zeiteinheit

Allowed values:

SEKUNDEMINUTESTUNDEVIERTEL_STUNDETAGWOCHEMONATQUARTALHALBJAHRJAHR

ableseZeitraum

string

optional

ableseZeitraum

abrechnungsZeitraum

string

optional

abrechnungsZeitraum

zeitraumText

string

optional

zeitraumText

zeitraumId

integer

optional

zeitraumId

Example

{
  "boTyp": "BERECHNUNGSFORMEL",
  "versionStruktur": "1",
  "gueltigkeitszeitraum": {
    "zeitraumId": 1,
    "startdatum": "2025-02-28T23:00:00Z"
  },
  "notwendigkeit": "BERECHNUNGSFORMEL_NOTWENDIG",
  "rechenschrittId": 1,
  "rechenschritte": [
    {
      "rechenschrittBestandteilId": 1,
      "operation": "ADDITION",
      "messlokationsId": "DE0009697056900614312080040415222",
      "energieflussrichtung": "AUSSP"
    },
    {
      "rechenschrittBestandteilId": 1,
      "operation": "ADDITION",
      "messlokationsId": "DE0009697056900614312080040415333",
      "energieflussrichtung": "AUSSP"
    }
  ]
}

🟠400Bad Request

🟠422Parameter Error