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 NB
  • Ü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
        POST
      • Aufhebung der Zuordnung des LFZ zur Marklokation bzw. Tranche versenden
        POST
      • Beendigung der Zuordnung des LFA zur Marklokation bzw. Tranche
        POST
      • Abrechnungsdaten Netznutzungsabrechnung versenden
        POST
      • Abrechnungsdaten Bilanzkreisabrechnung versenden
        POST
      • Stammdatenänderung vom Netzbetreiber (verantwortlich)
        POST
      • Einrichtung der Konfigurationen aufgrund einer Zuordnung eines LF zu einer MaLo oder Tranche
        POST
      • Übermittlung der Berechnungsformel
        POST
      • Wiederherstellung Anschlussnutzung nach LB
        POST
      • Lieferende von Netzbetreiber an Lieferant
        POST
      • Ersatz-/Grundversorgung
        POST
    • 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 NB

Ersatz-/Grundversorgung

POST
/inbound
OperationId:START_EOG
Prozess zur Anmeldung von Ersatz-/Grundversorgung starten.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Example
{
    "stammdaten": {
        "ENERGIELIEFERVERTRAG": [
            {
                "vertragspartner2": [
                    {
                        "name1": "string",
                        "name3": "string",
                        "name4": "string",
                        "geschaeftspartnerrolle": "KUNDE",
                        "name2": "string",
                        "anrede": "string"
                    }
                ],
                "korrespondenzpartner": {
                    "name3": "string",
                    "name4": "string",
                    "partneradresse": {
                        "landescode": "AC",
                        "ortsteil": "string",
                        "hausnummer": "string",
                        "ort": "string",
                        "postleitzahl": "string",
                        "strasse": "string",
                        "postfach": "string"
                    },
                    "name1": "string",
                    "anrede": "string",
                    "name2": "string"
                },
                "enFG": [
                    {
                        "grundlageVerringerungUmlagen": "string",
                        "grund": "string"
                    }
                ],
                "vertragsart": "ENERGIELIEFERVERTRAG"
            }
        ],
        "NETZNUTZUNGSVERTRAG": [
            {
                "vertragspartner2": [
                    {
                        "name1": "string",
                        "anrede": "string",
                        "geschaeftspartnerrolle": "KUNDE",
                        "name3": "string",
                        "name4": "string",
                        "name2": "string"
                    }
                ],
                "korrespondenzpartner": {
                    "partneradresse": {
                        "postfach": "string",
                        "ortsteil": "string",
                        "postleitzahl": "string",
                        "ort": "string",
                        "landescode": "AC",
                        "strasse": "string",
                        "hausnummer": "string"
                    },
                    "name2": "string",
                    "anrede": "string",
                    "name4": "string",
                    "name3": "string",
                    "name1": "string"
                },
                "vertragskonditionen": {
                    "haushaltskunde": true
                },
                "vertragsart": "NETZNUTZUNGSVERTRAG"
            }
        ],
        "MARKTLOKATION": [
            {
                "marktlokationsId": "string",
                "datenqualitaet": "ERWARTETE_DATEN",
                "hausverwalter": {
                    "partneradresse": {
                        "ortsteil": "string",
                        "landescode": "AC",
                        "strasse": "string",
                        "postfach": "string",
                        "postleitzahl": "string",
                        "hausnummer": "string",
                        "ort": "string"
                    },
                    "name1": "string",
                    "name4": "string",
                    "anrede": "string",
                    "gewerbekennzeichnung": true,
                    "name2": "string",
                    "name3": "string"
                },
                "lokationsadresse": {
                    "landescode": "AC",
                    "zusatzInformation": {
                        "zusatz4": "string",
                        "zusatz1": "string",
                        "zusatz2": "string",
                        "zusatz5": "string",
                        "zusatz3": "string"
                    },
                    "ortsteil": "string",
                    "postleitzahl": "string",
                    "strasse": "string",
                    "hausnummer": "string",
                    "ort": "string",
                    "postfach": "string"
                },
                "eigentuemer": {
                    "name3": "string",
                    "name4": "string",
                    "name2": "string",
                    "name1": "string",
                    "partneradresse": {
                        "strasse": "string",
                        "postfach": "string",
                        "ort": "string",
                        "postleitzahl": "string",
                        "hausnummer": "string",
                        "landescode": "AC",
                        "ortsteil": "string"
                    },
                    "gewerbekennzeichnung": true,
                    "anrede": "string",
                    "boTyp": "string",
                    "versionStruktur": "string"
                },
                "marktrollen": [
                    {
                        "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
                        "weiterverpflichtet": true,
                        "marktrolle": "NB",
                        "rollencodenummer": "string",
                        "boTyp": "string",
                        "versionStruktur": "string"
                    }
                ],
                "sperrstatus": "ENTSPERRT",
                "netzebene": "NSP"
            }
        ],
        "NETZLOKATION": [
            {
                "marktrollen": [
                    {
                        "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
                        "rollencodenummer": "string",
                        "marktrolle": "NB",
                        "boTyp": "string",
                        "versionStruktur": "string"
                    }
                ],
                "netzlokationsId": "string",
                "datenqualitaet": "string"
            }
        ],
        "STEUERBARE_RESSOURCE": [
            {
                "ressourcenId": "string",
                "marktrollen": [
                    {
                        "marktrolle": "NB",
                        "rollencodenummer": "string",
                        "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
                        "boTyp": "string",
                        "versionStruktur": "string"
                    }
                ],
                "datenqualitaet": "string"
            }
        ],
        "BILANZIERUNG": [
            {
                "prognosegrundlage": "WERTE",
                "temperaturarbeit": {
                    "wert": {},
                    "einheit": "W"
                },
                "jahresverbrauchsprognose": {
                    "einheit": "W",
                    "wert": {}
                },
                "detailsPrognosegrundlage": [
                    [
                        "SLP_SEP"
                    ]
                ],
                "datenqualitaet": "string"
            }
        ],
        "MESSLOKATION": [
            {
                "marktrollen": [
                    {
                        "weiterverpflichtet": true,
                        "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
                        "rollencodenummer": "string",
                        "marktrolle": "NB",
                        "boTyp": "string",
                        "versionStruktur": "string"
                    }
                ],
                "messlokationsId": "string",
                "datenqualitaet": "string"
            }
        ],
        "TECHNISCHE_RESSOURCE": [
            {
                "ressourcenId": "string"
            }
        ]
    },
    "transaktionsdaten": {
        "vertragsende": "2019-08-24T14:15:22Z",
        "transaktionsgrundergaenzungBefristeteAnmeldung": "string",
        "empfaenger": {
            "rollencodetyp": "BDEW",
            "rollencodenummer": "string",
            "marktrolle": "string",
            "boTyp": "string",
            "versionStruktur": "string"
        },
        "anfragereferenznummer": "string",
        "absender": {
            "rufnummern": [
                {
                    "nummerntyp": "RUF_ZENTRALE",
                    "rufnummer": {}
                }
            ],
            "rollencodenummer": "string",
            "ansprechpartner": {
                "eMailAdresse": "string",
                "nachname": "string"
            },
            "rollencodetyp": "BDEW",
            "marktrolle": "string",
            "boTyp": "string",
            "versionStruktur": "string"
        },
        "transaktionsgrund": "string",
        "transaktionsgrundergaenzung": "string",
        "vertragsbeginn": "2019-08-24T14:15:22Z",
        "sparte": "string"
    },
    "zusatzdaten": {
        "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
        "eventname": "START_EOG"
    }
}

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
Lieferende von Netzbetreiber an Lieferant
Next
Stammdatenänderung vom Messstellenbetreiber (verantwortlich)