Übermittlung der Berechnungsformel - MACO APP

Triggert den Versand der Berechnungsformel nach Abschluss des Lieferbeginn an den Lieferant oder als Einzelevent an den Messstellenbetreiber durch die MACO APP. Die Anfrage wird identifiziert durch den Eventnamen START_BERECHNUNGSFORMEL. 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

Examples

25001 Marktlokation / Z4125001 Netzlokation / Z4025001 Marktlokation / Z3425001 Marktlokation / Z33 / Addition 2 Messlokationen

{
    "stammdaten": {
        "VERWENDUNGSZEITRAUM": [
            {
                "boTyp": "VERWENDUNGSZEITRAUM",
                "versionStruktur": "1",
                "zeitraumId": 1,
                "datenqualitaet": "GUELTIGE_DATEN",
                "verwendungAb": "2025-02-28T23:00:00Z"
            }
        ],
        "BERECHNUNGSFORMEL": [
            {
                "boTyp": "BERECHNUNGSFORMEL",
                "versionStruktur": "1",
                "gueltigkeitszeitraum": {
                    "zeitraumId": 1,
                    "startdatum": "2025-02-28T23:00:00Z"
                },
                "notwendigkeit": "BERECHNUNGSFORMEL_NICHT_NOTWENDIG"
            }
        ]
    },
    "transaktionsdaten": {
        "sparte": "STROM",
        "absender": {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "marktrolle": "NB",
            "gewerbekennzeichnung": true,
            "rollencodenummer": "9900683000008",
            "rollencodetyp": "BDEW"
        },
        "empfaenger": {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "marktrolle": "LF",
            "gewerbekennzeichnung": true,
            "rollencodenummer": "9979052000006",
            "rollencodetyp": "BDEW"
        },
        "lokationsId": "50754496000",
        "lokationsTyp": "MALO"
    },
    "zusatzdaten": {
        "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
        "eventname": "START_BERECHNUNGSFORMEL"
    }
}

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