ECS Steuerprozess Lieferbeginn - MACO APP

Anmeldung Steuerprozess LW24 Strom (MaloIdent, Kündigung & Anmeldung)

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

Informationscontainer für Stammdaten, die zur Identifizierung genutzt werden

MARKTLOKATION

array [object {5}]

required

TRANCHE

array [object {1}]

optional

MESSLOKATION

array [object {1}]

optional

ZAEHLER

array [object {1}]

optional

ENERGIELIEFERVERTRAG

array [object {2}]

optional

NETZNUTZUNGSVERTRAG

array [object {2}]

optional

transaktionsdaten

object

required

Informationscontainer für Daten zum Vorgang und beteiligten Marktpartnern

ausfuehrungsdatum

string

required

Zeitpunkt zu dem die Identifikation stattfinden soll in angegeben in Zeitzone UTC. (umgerechnet muss dieser Zeitpunkt ein Tagesbeginn 00:00 Uhr gesetzlicher deutscher Zeit sein) | Format YYYY-MM-DD'T'HH:mm:ss'Z'

Example:

2023-08-02T22:00:00Z

Match pattern:

20(\d{2}(\-(0[13578]|1[02])\-(0[1-9]|[12]\d|3[01])|\-02\-(0[1-9]|1\d|2[0-8])|\-(0[469]|11)\-(0[1-9]|[12]\d|30))|([02468][048]|[13579][26])\-02\-(29))T([01]\d|2[0-3]):[0-5]\d:[0-5]\dZ

absender

object

required

Eigene ILN und Rollencodetyp

empfaenger

object

required

ILN und Rollencodetyp des Netzbetreibers, an den die Identanfrage gestellt werden soll

beteiligterMarktpartner

object

optional

Identifiziert den LFA an den die Kündigung gesendet werden soll. Ist das Feld leer, wird keine Kündigung ausgelöst

vertragsbeginn

string

optional

Datum zur Anmeldung des Lieferbeginn (DTM+92) angegeben in Zeitzone UTC. (umgerechnet muss dieser Zeitpunkt ein Tagesbeginn 00:00 Uhr gesetzlicher deutscher Zeit sein) | Format YYYY-MM-DD'T'HH:mm:ss'Z' | Mapping auf identificationDateTime

Example:

2023-08-02T22:00:00Z

Match pattern:

20(\d{2}(\-(0[13578]|1[02])\-(0[1-9]|[12]\d|3[01])|\-02\-(0[1-9]|1\d|2[0-8])|\-(0[469]|11)\-(0[1-9]|[12]\d|30))|([02468][048]|[13579][26])\-02\-(29))T([01]\d|2[0-3]):[0-5]\d:[0-5]\dZ

vertragsende

string

optional

Kündigung zum fixen Termin (DTM+93) angegeben in Zeitzone UTC. (umgerechnet muss dieser Zeitpunkt ein Tagesbeginn 00:00 Uhr gesetzlicher deutscher Zeit sein) | Format YYYY-MM-DD'T'HH:mm:ss'Z' | Mapping auf identificationDateTime

Example:

2023-08-02T22:00:00Z

Match pattern:

20(\d{2}(\-(0[13578]|1[02])\-(0[1-9]|[12]\d|3[01])|\-02\-(0[1-9]|1\d|2[0-8])|\-(0[469]|11)\-(0[1-9]|[12]\d|30))|([02468][048]|[13579][26])\-02\-(29))T([01]\d|2[0-3]):[0-5]\d:[0-5]\dZ

endezumtermin

string

optional

Kündigung zum nächstmöglichen Termin (DTM+471) ab diesem Zeitpunkt angegeben in Zeitzone UTC. (umgerechnet muss dieser Zeitpunkt ein Tagesbeginn 00:00 Uhr gesetzlicher deutscher Zeit sein) | Format YYYY-MM-DD'T'HH:mm:ss'Z'

Example:

2023-08-02T22:00:00Z

Match pattern:

20(\d{2}(\-(0[13578]|1[02])\-(0[1-9]|[12]\d|3[01])|\-02\-(0[1-9]|1\d|2[0-8])|\-(0[469]|11)\-(0[1-9]|[12]\d|30))|([02468][048]|[13579][26])\-02\-(29))T([01]\d|2[0-3]):[0-5]\d:[0-5]\dZ

transaktionsgrund

string

required

Transaktionsgrund, der in Anmeldung gesendet werden soll : E01 Ein-/Auszug (Umzug) / E03 Wechsel

Example:

E03

transaktionsgrundergaenzung

string

required

Transaktionsgrundergaenzung der Anmeldung: ZW3 Erzeugende Marktlokation / ZW4 Verbrauchende Marktlokation / ZW5 Tranche / ZW6 Pauschale Marktlokation / ZW7 Gemessene Marktlokation / ZAP ruhende Marktlokation

Example:

ZW4

transaktionsgrundergaenzungBefristeteAnmeldung

string

optional

Transaktionsgrundergaenzung befristete Anmeldung: E01 Ein-/Auszug (Umzug) / E03 Wechsel

Example:

E01

sparte

string

required

zusatzdaten

object

required

Informationscontainer zur Identifikation des Prozesses

prozessId

string

required

Id des Dokuments / Beleges im Backend.

Example:

00505688-E4A2-1EDF-A0C2-C81842E2515E

eventname

enum<string>

required

Name des Events

Allowed value:

ECS_LIEFERBEGINN

Default:

ECS_LIEFERBEGINN

Examples

MaximumMin Kdg u AnmMin Anm

{
  "stammdaten": {
    "MARKTLOKATION": [
      {
        "boTyp": "MARKTLOKATION",
        "versionStruktur": "1",
        "marktlokationsId": "57685676748",
        "sparte": "STROM",
        "energierichtung": "AUSSP",
        "erforderlichesProduktpaket": [
          {
            "produktpaketId": 1,
            "produkt": [
              {
                "produktCode": "9991000002082",
                "wertedetails": "11Y0-0000-0077-K"
              },
              {
                "produktCode": "9991000002008",
                "codeProdukteigenschaft": "9991000002115"
              }
            ],
            "umsetzungsgradvorgabe": "ZUORDNUNG_NUR_WENN_PRODUKTPAKET_UMSETZBAR"
          }
        ],
        "marktlokationsTyp": [
          {
            "typ": "STANDARD_MARKTLOKATION"
          }
        ],
        "lokationsadresse": {
          "postleitzahl": "12117",
          "ort": "Berlin",
          "strasse": "Reinhardtstraße",
          "hausnummer": "32",
          "adresszusatz": "Ausbau",
          "landescode": "DE"
        },
        "katasterinformation": {
          "gemarkung_flur": "Musterstadt",
          "flurstueck": "123",
          "flurstueckNummer": "456"
        },
        "geokoordinaten": {
          "breitengrad": "52.5200",
          "laengengrad": "13.4050",
          "ostwert": "123456",
          "nordwert": "654321",
          "zone": "UTMZone31",
          "hochwert": "1234567",
          "rechtswert": "7654321"
        }
      }
    ],
    "TRANCHE": [
      {
        "boTyp": "TRANCHE",
        "versionStruktur": "1",
        "tranchenId": "57685676742"
      }
    ],
    "MESSLOKATION": [
      {
        "boTyp": "MESSLOKATION",
        "versionStruktur": "1",
        "messlokationsId": "DE00014545768S0000000000000003054"
      }
    ],
    "ZAEHLER": [
      {
        "boTyp": "ZAEHLER",
        "versionStruktur": "1",
        "zaehlernummer": "1SM-8465929523"
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "versionStruktur": "1",
        "vertragsart": "NETZNUTZUNGSVERTRAG",
        "sparte": "STROM",
        "vertragskonditionen": {
          "haushaltskunde": true
        }
      }
    ],
    "ENERGIELIEFERVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "versionStruktur": "1",
        "vertragsart": "ENERGIELIEFERVERTRAG",
        "vertragspartner2": [
          {
            "boTyp": "GESCHAEFTSPARTNER",
            "versionStruktur": "1",
            "anrede": "Prof.Dr.",
            "name1": "Becker",
            "name2": "Michael",
            "gewerbekennzeichnung": false,
            "geschaeftspartnerrolle": [
              "KUNDE"
            ],
            "externeReferenzen": [
              {
                "exRefName": "Kundennummer beim Altlieferanten",
                "exRefWert": "V567345345"
              }
            ]
          }
        ],
        "korrespondenzpartner": {
          "boTyp": "GESCHAEFTSPARTNER",
          "versionStruktur": "1",
          "name1": "Glöppel",
          "gewerbekennzeichnung": false,
          "partneradresse": {
            "postleitzahl": "41515",
            "ort": "Grevenbroich",
            "strasse": "Bahnstraße",
            "hausnummer": "49",
            "landescode": "DE"
          }
        },
        "enFG": [
          {
            "grundlageVerringerungUmlagen": "ERFUELLT_VORAUSSETZUNG_NACH_ENFG",
            "grund": [
              "ENFG_ELEKTRISCH_ANGETRIEBENE_WAERMEPUMPEN"
            ]
          }
        ]
      }
    ]
  },
  "transaktionsdaten": {
    "transaktionsgrund": "E03",
    "transaktionsgrundergaenzung": "ZW4",
    "transaktionsgrundergaenzungBefristeteAnmeldung": "E03",
    "sparte": "STROM",
    "ausfuehrungsdatum": "2025-04-02T22:00:00Z",
    "absender": {
      "rollencodenummer": "9904000000005",
      "rollencodetyp": "BDEW"
    },
    "empfaenger": {
      "rollencodenummer": "9900936000002",
      "rollencodetyp": "BDEW"
    },
    "beteiligterMarktpartner": {
      "rollencodenummer": "9900936000002",
      "rollencodetyp": "BDEW"
    },
    "vertragsbeginn": "2025-10-31T23:00:00Z",
    "vertragsende": "2025-10-31T23:00:00Z",
    "endezumtermin": "2025-10-31T23:00:00Z"
  },
  "zusatzdaten": {
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
    "eventname": "ECS_LIEFERBEGINN"
  }
}

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