Kündigungsprozess zwischen Lieferanten - MACO APP

Prozess zur Kündigung zwischen Lieferanten im Auftrag des Endkunden anstoßen

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

55016 - LFN an LFA - Kündigung

transaktionsdaten

object

required

vertragsende

string <date-time>

optional

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

freitext

string

optional

absender

object

required

empfaenger

object

required

endezumtermin

string <date-time>

optional

Kündigungsdatum / DTM+471 | EDIFACT: SG4.IDE+24.DTM+471

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 {1}]

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

enum<string>

required

Name des Events

Allowed value:

START_KUENDIGUNG

Default:

START_KUENDIGUNG

Examples

Kündigung Strom DTM+93Kündigung Strom DTM+471

{
  "stammdaten": {
    "MARKTLOKATION": [
      {
        "boTyp": "MARKTLOKATION",
        "versionStruktur": "1",
        "marktlokationsId": "50754496000",
        "sparte": "STROM"
      }
    ]
  },
  "transaktionsdaten": {
    "transaktionsgrund": "E03",
    "transaktionsgrundergaenzung": "ZW4",
    "sparte": "STROM",
    "absender": {
      "boTyp": "MARKTTEILNEHMER",
      "versionStruktur": "1",
      "rollencodenummer": "9903526000002",
      "rollencodetyp": "BDEW"
    },
    "empfaenger": {
      "boTyp": "MARKTTEILNEHMER",
      "versionStruktur": "1",
      "rollencodenummer": "9979052000006",
      "rollencodetyp": "BDEW"
    },
    "kategorie": "E35",
    "vertragsende": "2025-10-31T23:00:00Z"
  },
  "zusatzdaten": {
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
    "eventname": "START_KUENDIGUNG"
  }
}

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