Trigger Events

POST

/inbound

OperationId:inbound

Triggert den Versand von EDIFACT Nachrichten an Marktpartner durch die MACO APP. Die Anfrage wird identifiziert durch den Eventnamen z.B. START_LIEFERBEGINN. 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

{
    "stammdaten": {
        "MARKTLOKATION": [
            {
                "boTyp": "MARKTLOKATION",
                "versionStruktur": "1",
                "marktlokationsId": "57685676748",
                "sparte": "STROM",
                "energierichtung": "AUSSP",
                "erforderlichesProduktpaket": [
                    {
                        "produktpaketId": 1,
                        "produkt": [
                            {
                                "produktCode": "9991000002082",
                                "wertedetails": "11Y0-0000-0077-K"
                            },
                            {
                                "produktCode": "9991000002008",
                                "codeProdukteigenschaft": "9991000002115"
                            }
                        ],
                        "umsetzungsgradvorgabe": "ZUORDNUNG_NUR_WENN_PRODUKTPAKET_UMSETZBAR"
                    }
                ],
                "marktlokationsTyp": [
                    {
                        "typ": "STANDARD_MARKTLOKATION"
                    }
                ],
                "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"
            }
        ],
        "NETZNUTZUNGSVERTRAG": [
            {
                "boTyp": "VERTRAG",
                "versionStruktur": "1",
                "vertragsart": "NETZNUTZUNGSVERTRAG",
                "sparte": "STROM",
                "vertragskonditionen": {
                    "haushaltskunde": true
                }
            }
        ],
        "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": "V567345345",
                                "exRefWert": "V567345345"
                            }
                        ]
                    }
                ],
                "korrespondenzpartner": {
                    "boTyp": "GESCHAEFTSPARTNER",
                    "versionStruktur": "1",
                    "name1": "Glöppel",
                    "gewerbekennzeichnung": false,
                    "partneradresse": {
                        "postleitzahl": "41515",
                        "ort": "Grevenbroich",
                        "strasse": "Bahnstraße",
                        "hausnummer": "49",
                        "landescode": "DE"
                    }
                },
                "enFG": [
                    {
                        "grundlageVerringerungUmlagen": "ERFUELLT_VORAUSSETZUNG_NACH_ENFG",
                        "grund": [
                            "ENFG_ELEKTRISCH_ANGETRIEBENE_WAERMEPUMPEN"
                        ]
                    }
                ]
            }
        ]
    },
    "transaktionsdaten": {
        "transaktionsgrund": "E03",
        "transaktionsgrundergaenzung": "ZW4",
        "transaktionsgrundergaenzungBefristeteAnmeldung": "E03",
        "sparte": "STROM",
        "ausfuehrungsdatum": "2025-04-02T22:00:00Z",
        "absender": {
            "rollencodenummer": "9904000000005",
            "rollencodetyp": "BDEW"
        },
        "empfaenger": {
            "rollencodenummer": "9900936000002",
            "rollencodetyp": "BDEW"
        },
        "beteiligterMarktpartner": {
            "rollencodenummer": "9900936000002",
            "rollencodetyp": "BDEW"
        },
        "vertragsbeginn": "2025-10-31T23:00:00Z",
        "vertragsende": "2025-10-31T23:00:00Z",
        "endezumtermin": "2025-10-31T23:00:00Z"
    },
    "zusatzdaten": {
        "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
        "eventname": "ECS_LIEFERBEGINN"
    }
}

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

Stammdatenänderung vom Messstellenbetreiber (verantwortlich)

Authentifizierung