MACO APP | DOC
FUM 10 / 25
  • FUM 10 / 25
  • FUM 04 / 25
SchnittstellenProzessdokumentationenBO4E Geschäftsobjekte
SchnittstellenProzessdokumentationenBO4E Geschäftsobjekte
FUM 10 / 25
  • FUM 10 / 25
  • FUM 04 / 25
  1. Einzelansicht LF
  • Übersicht
  • Änderungsprotokoll Schnittstellen
  • Fehlercodes
  • Geschäftsobjekte
  • Trigger (MACO APP)
    • Einzelansicht LF
      • ECS Steuerprozess Lieferbeginn
        POST
      • Identifikation einer Marktlokation
        POST
      • Kündigungsprozess zwischen Lieferanten
        POST
      • Lieferbeginn
        POST
      • Lieferende von Lieferant an Netzbetreiber
        POST
      • Stammdatenänderung vom Lieferanten (verantwortlich)
        POST
    • Einzelansicht NB
      • Anfrage zur Beendigung der Zuordnung des LFA zur Marktlokation bzw. Tranche
      • Aufhebung der Zuordnung des LFZ zur Marklokation bzw. Tranche versenden
      • Beendigung der Zuordnung des LFA zur Marklokation bzw. Tranche
      • Abrechnungsdaten Netznutzungsabrechnung versenden
      • Abrechnungsdaten Bilanzkreisabrechnung versenden
      • Stammdatenänderung vom Netzbetreiber (verantwortlich)
      • Einrichtung der Konfigurationen aufgrund einer Zuordnung eines LF zu einer MaLo oder Tranche
      • Übermittlung der Berechnungsformel
      • Wiederherstellung Anschlussnutzung nach LB
      • Lieferende von Netzbetreiber an Lieferant
      • Ersatz-/Grundversorgung
    • Einzelansicht MSB
      • Stammdatenänderung vom Messstellenbetreiber (verantwortlich)
    • Trigger Events
      POST
    • Authentifizierung
      POST
  • BO4E Lesen (Backend)
    • Avis lesen
    • Berechnungsformel lesen
    • Bilanzierung lesen
    • Energieliefervertrag lesen
    • Energiemengen aus Abrechnungskontext lesen
    • Lastgangs einer Lokation lesen
    • Zählerstand einer Lokation lesen
    • Kommunikationsdaten des Serviceanbieters lesen
    • Lokationsbündel lesen
    • Marktlokation lesen
    • Messlokation lesen
    • Messstellenbetriebsvertrag lesen
    • Netzlokation lesen
    • Netznutzungsvertrag lesen
    • Steuerbare Ressource lesen
    • Technische Ressource lesen
    • Tranche lesen
    • Zähler lesen
  • Prozessdaten lesen (Backend)
    • Zuordnungsemächtigung lesen
  • Prozessdaten LF (Backend)
    • Prozessdaten aktualiseren
    • Prozessdaten erstellen
  • Prozessdaten NB (Backend)
    • Prozessdaten aktualiseren
    • Prozessdaten erstellen
  • Prozessdaten MSB (Backend)
    • Prozessdaten aktualiseren
    • Prozessdaten erstellen
  • MaloIdent LF (Backend)
    • Prozessdaten aktualisieren
    • Identifikation einer Marktlokation
  • MaloIdent NB (Backend)
    • Identifizierung der MaLo
    • Stammdaten der identifiz. MaLo
  • Obsolet
    • Verwendungszeitraum einer Marktlokation ermitteln
    • Absenderdaten lesen
    • Empfängerdaten lesen
  • MaLo-Ident
    • Übersicht
    • MaloIdent Anfrage auslösen
      POST
    • Identifizierung der MaLo
      POST
    • Stammdaten der identifiz. MaLo
      GET
    • Prozessdaten aktualisieren
      POST
  • MCS Eingang (MACO APP)
    • Empfang einer Marktnachricht
  1. Einzelansicht LF

ECS Steuerprozess Lieferbeginn

POST
/inbound
OperationId:ECS_LIEFERBEGINN
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

Examples
{
    "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

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
Previous
Einzelansicht LF
Next
Identifikation einer Marktlokation