MACO APP | MALO Ident
SchnittstellenFachliche Dokumentation
SchnittstellenFachliche Dokumentation
  1. MaLo-Ident
  • MaLo-Ident
    • Übersicht
    • MaloIdent Anfrage auslösen
      POST
    • Identifizierung der MaLo
      POST
    • Stammdaten der identifiz. MaLo
      GET
    • Prozessdaten aktualisieren
      POST
  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