Lieferende von Lieferant an Netzbetreiber - MACO APP

Abmeldung / Beendigung der Zuordnung - Lieferende von LF an NB

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

vertragsende

string <date-time>

optional

Datum Vertragsende / DTM+93 | EDIFACT: SG4.IDE+24.DTM+93

absender

object

required

vertragsbeginn

string <date-time>

optional

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

kategorie

string

required

sparte

string

required

stammdaten

object

required

NETZNUTZUNGSVERTRAG

array [object {3}]

optional

MARKTLOKATION

array [object {2}]

optional

TRANCHE

array [object {1}]

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

string

required

Name des Events

Default:

START_LIEFERENDE

Examples

Lieferende verbr. MaLo StromLieferende erzeug. MaLo Strom

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

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