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. MaLo-Ident
  • Ü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
    • 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. MaLo-Ident

MaloIdent Anfrage auslösen

POST
/inbound
OperationId:START_MALOIDENT
START_MALOIDENT
Triggert den Versand einer MaloIdent Anfrage via API-Webdienst an den Netzbetreiber durch die MaloIdent APP. Die Anfrage wird identifiziert durch den Eventnamen START_MALOIDENT. Zusätzlich ist eine eindeutige ID prozessId aus dem Backend mit zu übergeben, mit der die spätere Antwort vom Netzbetreiber 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": {
        "MARKTLOKATION": [
            {
                "boTyp": "MARKTLOKATION",
                "versionStruktur": "1",
                "marktlokationsId": "57685676748",
                "energierichtung": "AUSSP",
                "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"
            }
        ],
        "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"
                            }
                        ]
                    }
                ]
            }
        ]
    },
    "transaktionsdaten": {
        "ausfuehrungsdatum": "2023-08-02T22:00:00Z",
        "absender": {
            "rollencodenummer": "9904000000005"
        },
        "empfaenger": {
            "rollencodenummer": "9900936000002"
        }
    },
    "zusatzdaten": {
        "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
        "eventname": "START_MALOIDENT"
    }
}

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
Übersicht
Next
Identifizierung der MaLo