Stammdatenänderung vom Netzbetreiber (verantwortlich)

POST

/inbound

TRIGGER

OperationId:START_VERSAND_SDAE

Triggert den Versand von Stammdatenänderungen vom verantwortlichen Netzbetreiber an Marktpartner durch die MACO APP. Die Anfrage wird identifiziert durch den Eventnamen START_VERSAND_SDAE. 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

Examples

556155561655617

{
  "stammdaten": {
    "VERWENDUNGSZEITRAUM": [
      {
        "boTyp": "VERWENDUNGSZEITRAUM",
        "versionStruktur": "1",
        "verwendungAb": "2025-04-02T22:00:00Z",
        "zeitraumId": 1,
        "datenqualitaet": "GUELTIGE_DATEN"
      }
    ],
    "NETZLOKATION": [
      {
        "boTyp": "NETZLOKATION",
        "versionStruktur": "1",
        "netzlokationsId": "E1688117482",
        "sparte": "STROM",
        "zeitraumId": 1,
        "datenqualitaet": "DATEN",
        "marktrollen": [
          {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "marktrolle": "MSB",
            "rollencodenummer": "9904446000007",
            "rollencodetyp": "BDEW",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER"
          }
        ]
      }
    ]
  },
  "transaktionsdaten": {
    "sparte": "STROM",
    "transaktionsgrund": "ZX8",
    "absender": {
      "rollencodenummer": "9900321000005",
      "rollencodetyp": "BDEW"
    },
    "empfaenger": {
      "rollencodenummer": "9903790000002",
      "rollencodetyp": "BDEW"
    }
  },
  "zusatzdaten": {
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
    "eventname": "START_VERSAND_SDAE"
  }
}

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

Abrechnungsdaten Bilanzkreisabrechnung versenden

Einrichtung der Konfigurationen aufgrund einer Zuordnung eines LF zu einer MaLo oder Tranche