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

Lieferbeginn

POST
/inbound
OperationId:START_LIEFERBEGINN
Prozess zur Anmeldung einer erzeugenden oder verbrauchenden Marktlokation.

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": "50754496000",
                "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"
                    }
                ]
            }
        ],
        "NETZNUTZUNGSVERTRAG": [
            {
                "boTyp": "VERTRAG",
                "versionStruktur": "1",
                "vertragsart": "NETZNUTZUNGSVERTRAG",
                "sparte": "STROM",
                "vertragskonditionen": {
                    "haushaltskunde": true
                }
            }
        ],
        "ENERGIELIEFERVERTRAG": [
            {
                "boTyp": "VERTRAG",
                "versionStruktur": "1",
                "vertragsart": "ENERGIELIEFERVERTRAG",
                "sparte": "STROM",
                "vertragspartner2": [
                    {
                        "boTyp": "GESCHAEFTSPARTNER",
                        "versionStruktur": "1",
                        "anrede": "Herr",
                        "name1": "Glöppel",
                        "name2": "Walter",
                        "gewerbekennzeichnung": false,
                        "geschaeftspartnerrolle": [
                            "KUNDE"
                        ]
                    }
                ],
                "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": "E01",
        "transaktionsgrundergaenzung": "ZW4",
        "sparte": "STROM",
        "vertragsbeginn": "2025-10-31T23:00:00Z",
        "absender": {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "rollencodenummer": "9903526000002",
            "rollencodetyp": "BDEW"
        },
        "empfaenger": {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "rollencodenummer": "9900683000008",
            "rollencodetyp": "BDEW"
        },
        "kategorie": "E01"
    },
    "zusatzdaten": {
        "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
        "eventname": "START_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
Kündigungsprozess zwischen Lieferanten
Next
Lieferende von Lieferant an Netzbetreiber