Identifikation einer Marktlokation - MACO APP

Prozess zur Identifikation einer Marktlokation beim Netzbetreiber anstoßen.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

stammdaten

object

required

Informationscontainer für Stammdaten, die zur Identifizierung genutzt werden

MARKTLOKATION

array [object {5}]

required

TRANCHE

array [object {1}]

optional

MESSLOKATION

array [object {1}]

optional

ZAEHLER

array [object {1}]

optional

ENERGIELIEFERVERTRAG

array [object {2}]

optional

transaktionsdaten

object

required

Informationscontainer für Daten zum Vorgang und beteiligten Marktpartnern

ausfuehrungsdatum

string

required

Zeitpunkt zu dem die Identifikation stattfinden soll in angegeben in Zeitzone UTC. (umgerechnet muss dieser Zeitpunkt ein Tagesbeginn 00:00 Uhr gesetzlicher deutscher Zeit sein) | Format YYYY-MM-DD'T'HH:mm:ss'Z' | Mapping auf identificationDateTime

Example:

2023-08-02T22:00:00Z

Match pattern:

20(\\d{2}(\\-(0[13578]|1[02])\\-(0[1-9]|[12]\\d|3[01])|\\-02\\-(0[1-9]|1\\d|2[0-8])|\\-(0[469]|11)\\-(0[1-9]|[12]\\d|30))|([02468][048]|[13579][26])\\-02\\-(29))T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\dZ

absender

object

required

Eigene ILN und Rollencodetyp

empfaenger

object

required

ILN und Rollencodetyp des Netzbetreibers, an den die Identanfrage gestellt werden soll

zusatzdaten

object

required

Informationscontainer zur Identifikation des Prozesses

prozessId

string

required

Id des Dokuments / Beleges im Backend. Wird genutzt um die Antwort zuzuordnen.

Example:

00505688-E4A2-1EDF-A0C2-C81842E2515E

eventname

enum<string>

required

Name des Events

Allowed value:

START_MALOIDENT

Default:

START_MALOIDENT

Examples

MaximumMinimum

{
  "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

Erfolgsmeldung auf Prozessdaten API Aufruf

businessKey

string <uuid>

required

Einzigartige Kennung des Geschäftsprozesses

message

string

required

Nachricht mit Details zum ausgelösten Even

Example:

received event XXXXXXXXXXXX with id at 2024-08-08T12:58:22Z and started process with businessKey 4c7170ed-3518-41ee-8582-39ab65b00107

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