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

Stammdatenänderung vom Lieferanten (verantwortlich)

POST
/inbound
OperationId:START_VERSAND_SDAE
Triggert den Versand von Stammdatenänderungen vom verantwortlichen Lieferanten an Marktpartner durch die MACO APP. Die Anfrage wird identifiziert durch den Eventnamen START_VERSAND_SDAE. Zusätzlich ist eine eindeutige ID prozessId aus dem Backend mit zu übergeben, mit der die spätere Antwort vom Marktpartner wieder an das Backend übergeben werden kann.

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",
                        "anrede": "string",
                        "geschaeftspartnerrolle": "KUNDE",
                        "name4": "string",
                        "exRefName": "Kundennummer beim Lieferanten",
                        "name2": "string",
                        "exRefWert": "string"
                    }
                ],
                "korrespondenzpartner": {
                    "partneradresse": {
                        "ortsteil": "string",
                        "hausnummer": "string",
                        "landescode": "AC",
                        "ort": "string",
                        "strasse": "string",
                        "postfach": "string",
                        "postleitzahl": "string"
                    },
                    "name3": "string",
                    "name4": "string",
                    "name2": "string",
                    "name1": "string",
                    "anrede": "string"
                },
                "enFG": [
                    {
                        "grund": [
                            "PREIS_RECHENREGEL_FALSCH"
                        ],
                        "grundlageVerringerungUmlagen": "ERFUELLT_VORAUSSETZUNG_NACH_ENFG"
                    }
                ],
                "gueltigkeitszeitraum": {
                    "zeitraumId": 0
                },
                "datenqualitaet": "ERWARTETE_DATEN",
                "vertragsart": "ENERGIELIEFERVERTRAG"
            }
        ],
        "MARKTLOKATION": [
            {
                "marktlokationsId": "string",
                "datenqualitaet": "ERWARTETE_DATEN",
                "gueltigkeitszeitraum": {
                    "zeitraumId": 0
                },
                "foerderungsLand": "string"
            }
        ],
        "NETZNUTZUNGSVERTRAG": [
            {
                "vertragskonditionen": {
                    "haushaltskunde": true
                },
                "vertragsart": "NETZNUTZUNGSVERTRAG"
            }
        ],
        "VERWENDUNGSZEITRAUM": [
            {
                "verwendungBis": "2019-08-24T14:15:22Z",
                "datenqualitaet": "ERWARTETE_DATEN",
                "verwendungAb": "2019-08-24T14:15:22Z",
                "zeitraumId": 0
            }
        ]
    },
    "transaktionsdaten": {
        "dokumentennummer": "string",
        "kategorie": "PROZESSDATENBERICHT",
        "absender": {
            "rufnummern": [
                {
                    "rufnummer": {},
                    "nummerntyp": "RUF_ZENTRALE"
                }
            ],
            "rollencodenummer": "string",
            "ansprechpartner": {
                "nachname": "string",
                "eMailAdresse": "string"
            },
            "rollencodetyp": "BDEW"
        },
        "nachrichtendatum": "2019-08-24T14:15:22Z",
        "nachrichtenreferenznummer": "string",
        "empfaenger": {
            "rollencodetyp": "BDEW",
            "rollencodenummer": "string"
        },
        "transaktionsgrundergaenzung": "string",
        "pruefidentifikator": "string",
        "transaktionsgrund": "string",
        "vorgangsnummer": "string"
    },
    "zusatzdaten": {
        "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
        "eventname": "START_VERSAND_SDAE"
    }
}

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 Lieferant an Netzbetreiber
Next
Einzelansicht NB