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. Prozessdaten MSB (Backend)
  • Übersicht
  • Änderungsprotokoll Schnittstellen
  • Fehlercodes
  • Geschäftsobjekte
  • Trigger (MACO APP)
    • Einzelansicht LF
      • ECS Steuerprozess Lieferbeginn
      • Identifikation einer Marktlokation
      • Kündigungsprozess zwischen Lieferanten
      • Lieferbeginn
      • Lieferende von Lieferant an Netzbetreiber
      • Stammdatenänderung vom Lieferanten (verantwortlich)
    • 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
    • Authentifizierung
  • 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
      POST
    • Prozessdaten erstellen
      POST
  • 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. Prozessdaten MSB (Backend)

Prozessdaten erstellen

POST
/createProcessData
OperationId:ERSTELLEN_PROZESSDATEN
Verbuchung von Daten aus Marktprozesen im Backend

Request

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

Body Params application/json

Example
{
    "stammdaten": {
        "BILANZIERUNG": [
            {
                "bilanzkreis": "Test2312312",
                "boTyp": "BILANZIERUNG",
                "jahresverbrauchsprognose": {
                    "einheit": "KWH",
                    "wert": 2000
                },
                "lastprofile": [
                    {
                        "bezeichnung": "H00",
                        "einspeisung": false,
                        "herausgeber": "NB",
                        "profilart": "ART_STANDARDLASTPROFIL",
                        "verfahren": "SYNTHETISCH"
                    }
                ],
                "versionStruktur": "1"
            }
        ],
        "ENERGIELIEFERVERTRAG": [
            {
                "boTyp": "VERTRAG",
                "enFG": [
                    {
                        "grundlageVerringerungUmlagen": "KEINE_ANGABE"
                    }
                ],
                "korrespondenzpartner": {
                    "boTyp": "GESCHAEFTSPARTNER",
                    "gewerbekennzeichnung": false,
                    "name1": "Test2312312",
                    "partneradresse": {
                        "landescode": "DE",
                        "ort": "Dummyort",
                        "postleitzahl": "00000",
                        "strasse": "Dummystrasse"
                    },
                    "versionStruktur": "1"
                },
                "sparte": "STROM",
                "versionStruktur": "1",
                "vertragsart": "ENERGIELIEFERVERTRAG",
                "vertragspartner2": [
                    {
                        "anrede": "Dr.",
                        "boTyp": "GESCHAEFTSPARTNER",
                        "geschaeftspartnerrolle": [
                            "KUNDE"
                        ],
                        "gewerbekennzeichnung": false,
                        "name1": "Mustermann",
                        "name2": "Max",
                        "versionStruktur": "1"
                    }
                ]
            }
        ],
        "MARKTLOKATION": [
            {
                "boTyp": "MARKTLOKATION",
                "energierichtung": "AUSSP",
                "marktlokationsId": "50074561192",
                "sparte": "STROM",
                "versionStruktur": "1"
            }
        ],
        "MESSLOKATION": [
            {
                "ablesekartenempfaenger": {
                    "boTyp": "GESCHAEFTSPARTNER",
                    "geschaeftspartnerrolle": [
                        "ABLESEKARTENEMPFAENGER"
                    ],
                    "gewerbekennzeichnung": true,
                    "name1": "Test2312312",
                    "partneradresse": {
                        "landescode": "DE",
                        "ort": "Dummyort",
                        "postleitzahl": "11111",
                        "strasse": "Dummyweg"
                    },
                    "versionStruktur": "1"
                },
                "boTyp": "MESSLOKATION",
                "sparte": "STROM",
                "versionStruktur": "1"
            }
        ],
        "NETZNUTZUNGSVERTRAG": [
            {
                "boTyp": "VERTRAG",
                "gemeinderabatt": 0,
                "sparte": "STROM",
                "versionStruktur": "1",
                "vertragsart": "NETZNUTZUNGSVERTRAG",
                "vertragsbeginn": "2024-12-31T23:00:00Z",
                "vertragskonditionen": {
                    "haushaltskunde": true,
                    "netznutzungsvertrag": "LIEFERANTEN_NB",
                    "netznutzungszahler": "LIEFERANT"
                }
            }
        ]
    },
    "transaktionsdaten": {
        "absender": {
            "ansprechpartner": {
                "boTyp": "ANSPRECHPARTNER",
                "eMailAdresse": "max@mustermann.de",
                "nachname": "Max Mustermann",
                "rufnummern": [
                    {
                        "nummerntyp": "RUF_ZENTRALE",
                        "rufnummer": "+12345678902"
                    },
                    {
                        "nummerntyp": "FAX_DURCHWAHL",
                        "rufnummer": "+12345678910"
                    },
                    {
                        "nummerntyp": "RUF_DURCHWAHL",
                        "rufnummer": "+12345678901"
                    },
                    {
                        "nummerntyp": "MOBIL_NUMMER",
                        "rufnummer": "+12345678903"
                    }
                ],
                "versionStruktur": "1"
            },
            "boTyp": "MARKTTEILNEHMER",
            "rollencodenummer": "9903790000002",
            "rollencodetyp": "BDEW",
            "versionStruktur": "1"
        },
        "bilanzkreis": [
            {
                "bezeichnung": "Test2312312"
            }
        ],
        "datenaustauschreferenz": "114622",
        "dokumentennummer": "933588BGM",
        "empfaenger": {
            "boTyp": "MARKTTEILNEHMER",
            "rollencodenummer": "9900321000005",
            "rollencodetyp": "BDEW",
            "versionStruktur": "1"
        },
        "identifikationslogik": "Z12",
        "kategorie": "E01",
        "nachrichtendatum": "2024-04-01T10:57:00Z",
        "nachrichtenreferenznummer": "S933588",
        "pruefidentifikator": "55001",
        "sparte": "STROM",
        "transaktionsgrund": "E03",
        "vorgangsnummer": "ABC488710359"
    },
    "zusatzdaten": {}
}

Responses

🟢200OK
application/json
Erfolgreiche Verbuchung von Daten aus Marktprozesen im Backend
Body

Example
{}
🟠422Parameter Error
Previous
Prozessdaten aktualiseren
Next
Prozessdaten aktualisieren