Aufhebung der Zuordnung des LFZ zur Marklokation bzw. Tranche versenden - MACO APP

Triggert den Versand von Aufhebung der Zuordnung des LFZ zur Marklokation bzw. Tranche an Marktpartner durch die MACO APP. Die Anfrage wird identifiziert durch den Eventnamen AUFH_ZUK_ZUORDNUNG. 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

transaktionsdaten

object

required

absender

object

required

vertragsbeginn

string <date-time>

required

Datum Vertragsbeginn / DTM+92 | EDIFACT: SG4.IDE+24.DTM+92

empfaenger

object

required

transaktionsgrundergaenzung

string

required

Ergänzung zum Transaktionsgrund / UTILMD STS+7++E01+###+E03 | EDIFACT: SG4.IDE+24.STS+7

transaktionsgrund

string

required

Der Transaktionsgrund beschreibt den Geschäftsvorfall zur Kategorie genauer / UTILMD STS+7++###+ZW4+E03 | EDIFACT: SG4.IDE+24.STS+7

sparte

string

required

stammdaten

object

required

MARKTLOKATION

array [object {2}]

optional

TRANCHE

array [object {2}]

optional

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_AUFH_ZUK_ZUORDNUNG

Default:

START_AUFH_ZUK_ZUORDNUNG

Example

{
  "stammdaten": {
    "MARKTLOKATION": [
      {
        "boTyp": "MARKTLOKATION",
        "versionStruktur": "1",
        "marktlokationsId": "57685676748",
        "sparte": "STROM",
        "energierichtung": "AUSSP",
        "marktlokationsTyp": [
          {
            "typ": "STANDARD_MARKTLOKATION"
          }
        ]
      }
    ]
  },
  "transaktionsdaten": {
    "transaktionsgrund": "ZG5",
    "transaktionsgrundergaenzung": "ZW4",
    "sparte": "STROM",
    "absender": {
      "rollencodenummer": "9904000000005",
      "rollencodetyp": "BDEW"
    },
    "empfaenger": {
      "rollencodenummer": "9900936000002",
      "rollencodetyp": "BDEW"
    },
    "beteiligterMarktpartner": {
      "boTyp": "MARKTTEILNEHMER",
      "versionStruktur": "1",
      "geschaeftspartnerrolle": "LIEFERANT",
      "rollencodenummer": "9900936000002",
      "rollencodetyp": "BDEW"
    },
    "kategorie": "E02",
    "vertragsbeginn": "2025-10-31T23:00:00Z",
    "vertragsende": "2025-10-31T23:00:00Z"
  },
  "zusatzdaten": {
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
    "eventname": "START_AUFH_ZUK_ZUORDNUNG"
  }
}

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