Übermittlung der Berechnungsformel - MACO APP

Triggert den Versand der Berechnungsformel nach Abschluss des Lieferbeginn an den Lieferant oder als Einzelevent an den Messstellenbetreiber durch die MACO APP. Die Anfrage wird identifiziert durch den Eventnamen START_BERECHNUNGSFORMEL. Zusätzlich ist eine eindeutige ID prozessId aus dem Backend mit zu übergeben, mit der die spätere Antwort vom Marktpartner wieder an das Backend übergeben werden kann.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

stammdaten

object

required

VERWENDUNGSZEITRAUM

array [object {4}]

required

BERECHNUNGSFORMEL

array [object {4}]

required

transaktionsdaten

object

required

absender

object

required

lokationsId

string

required

Referenz auf die Lokation / LOC | EDIFACT: SG5.IDE+24.LOC+172

empfaenger

object

required

lokationsTyp

string

required

zusatzdaten

object

required

prozessId

string

required

Id des Dokuments / Beleges im Backend. Wird genutzt um die Antwort zuzuordnen.

Example:

00505688-E4A2-1EDF-A0C2-C81842E2515E

eventname

enum<string>

required

Name des Events

Allowed value:

START_BERECHNUNGSFORMEL

Default:

START_BERECHNUNGSFORMEL

Examples

25001 Marktlokation / Z4125001 Netzlokation / Z4025001 Marktlokation / Z3425001 Marktlokation / Z33 / Addition 2 Messlokationen

{
  "stammdaten": {
    "VERWENDUNGSZEITRAUM": [
      {
        "boTyp": "VERWENDUNGSZEITRAUM",
        "versionStruktur": "1",
        "zeitraumId": 1,
        "datenqualitaet": "GUELTIGE_DATEN",
        "verwendungAb": "2025-02-28T23:00:00Z"
      }
    ],
    "BERECHNUNGSFORMEL": [
      {
        "boTyp": "BERECHNUNGSFORMEL",
        "versionStruktur": "1",
        "gueltigkeitszeitraum": {
          "zeitraumId": 1,
          "startdatum": "2025-02-28T23:00:00Z"
        },
        "notwendigkeit": "BERECHNUNGSFORMEL_NICHT_NOTWENDIG"
      }
    ]
  },
  "transaktionsdaten": {
    "sparte": "STROM",
    "absender": {
      "boTyp": "MARKTTEILNEHMER",
      "versionStruktur": "1",
      "marktrolle": "NB",
      "gewerbekennzeichnung": true,
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW"
    },
    "empfaenger": {
      "boTyp": "MARKTTEILNEHMER",
      "versionStruktur": "1",
      "marktrolle": "LF",
      "gewerbekennzeichnung": true,
      "rollencodenummer": "9979052000006",
      "rollencodetyp": "BDEW"
    },
    "lokationsId": "50754496000",
    "lokationsTyp": "MALO"
  },
  "zusatzdaten": {
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
    "eventname": "START_BERECHNUNGSFORMEL"
  }
}

Responses

🟢201Created

application/json

Erfolg | Success

Body

Erfolgsmeldung auf Prozessdaten API Aufruf

businessKey

string <uuid>

required

Einzigartige Kennung des Geschäftsprozesses

message

string

required

Nachricht mit Details zum ausgelösten Even

Example:

received event XXXXXXXXXXXX with id at 2024-08-08T12:58:22Z and started process with businessKey 4c7170ed-3518-41ee-8582-39ab65b00107

Example

{
  "businessKey": "2318a5eb-43aa-4608-9ea1-3dcf2eacc794",
  "message": "received event XXXXXXXXXXXX with id at 2024-08-08T12:58:22Z and started process with businessKey 4c7170ed-3518-41ee-8582-39ab65b00107"
}

🟠400Bad Request