Identifizierung der MaLo

POST

/identifyMarketlocation

IDENTIFIZIERUNG

OperationId:LESEN_MALOIDENT_BASIS

LESEN_MALOIDENT_BASIS

Übergibt die Daten zur Identifikation aller Marktlokationen gemäß Prozessbeschreibung, sowie aller Informationen zur Durchführung des EBD E_0594.

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 {7}]

required

TRANCHE

array [object {3}]

optional

MESSLOKATION

array [object {3}]

optional

ZAEHLER

array [object {3}]

optional

ENERGIELIEFERVERTRAG

array [object {4}]

optional

transaktionsdaten

object

required

Informationscontainer für Daten zum Vorgang und beteiligten Marktpartnern

vorgangsnummer

string

required

Externe Transaktions-Id zur eindeutigen Identifikation der Anfrage der MaLo-ID der Marktlokation des sendenden Marktpartners. | Format $UUID RFC4122 | Mapping auf [header] transactionId

Example:

f81d4fae-7dec-11d0-a765-00a0c91e6bf6

nachrichtendatum

string

optional

Zeitpunkt an dem der Aufruf erstellt wurde in Zeitzone UTC - falls der Wert aus dem Backend nicht befüllt ist, wird die MaloIdent Lösung das Datum zum Zeitpunkt des Empfang befüllen. | Format YYYY-MM-DD'T'HH:mm:ss'Z' | Mapping auf [header] creationDateTime

Example:

2023-08-01T12:30: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

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

idempodenzschluessel

string

optional

Initiale Vorgangsnummer (Format

UU I D RFC 4122) z u r A n g ab e d es I d e m p o d e n zsc h l \overset{u}{¨} sse l im F a ll ee in es R e t ry a u s d e m B a c k e n d ∣ F or ma t

UUID RFC4122 | Mapping auf [header] initialTransactionId

Example:

f81d4fae-7dec-11d0-a765-00a0c91e6bf6

absender

object

required

Eigene ILN und Rollencodetyp

empfaenger

object

required

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

Example

{
  "stammdaten": {
    "MARKTLOKATION": [
      {
        "boTyp": "MARKTLOKATION",
        "versionStruktur": "1",
        "marktlokationsId": "12345678901",
        "energierichtung": "AUSSP",
        "lokationsadresse": {
          "postleitzahl": "76229",
          "ort": "Karlsruhe",
          "strasse": "Greschbachstrasse",
          "hausnummer": "3",
          "adresszusatz": "",
          "landescode": "DE"
        }
      }
    ]
  },
  "transaktionsdaten": {
    "ausfuehrungsdatum": "2024-11-07T23:00:00Z"
  }
}

Responses

🟢200OK

application/json

Erfolg | Success

Body

Schema für die Basis-Antwort der Maloident-Identifizierung. Das Ergebnis ist die Grundlage für die EBD Prüfung

maloIdentDaten

array [object {13}]

required

Liste von Treffern der Maloident-Suche

lokationsId

string

required

Die ID der Marktlokation

Example:

74018657187

trefferMaloid

boolean

required

Gibt an, ob primäres Trefferkriterium MaloId ein Treffer war. Die Übereinstimmung der MaLo-ID liegt vor, wenn die vollständige, 11-stellige Zeichenkette übereinstimmt.

trefferTrancheId

boolean

required

Gibt an, ob primäres Trefferkriterium TrancheId ein Treffer war. Die Prüfung ist für jede angegebene Tranchen-ID durchzuführen. Die Übereinstimmung der Tranchen-ID liegt vor, wenn die vollständige 11-stellige Zeichenkette übereinstimmt.

trefferAdresse1

boolean

required

-Gibt an, ob primäres Trefferkriterium Adresse1 ein Treffer war Die zu prüfende Adresse der Marktlokation besteht aus Straße, Hausnummer/Hausnummernergänzung, PLZ, Ort und Ländercode. · Bei Marktlokationen ohne zugeordnete Adressdaten kann zudem über das Tupel bestehend aus Gemarkung, Flurnummer und Flurstücknummer identifiziert werden. · Es kann auch eine Identifizierung über geographische Koordinaten erfolgen. Bei der Adressprüfung gelten die folgenden Regeln: · Die Zeichenketten „straße“, „str.“ oder „strasse“ am Ende eines Straßennamens werden durch einen Stern „*“ ersetzt, um damit alle Straßen zu finden, deren Name mit den links vom Stern stehenden Buchstaben beginnen. Der Stern gilt somit als Platzhalter.

trefferKundennummer

boolean

required

Gibt an, ob primäres Trefferkriterium Kundennummer ein Treffer war. Übermittelt wird die Kundennummer des LFA. Die Übereinstimmung der Kundennummer liegt vor, wenn die Zeichenkette der Kundennummer, wie sie dem Kunden mitgeteilt wurde übereinstimmt.

trefferName

boolean

required

Gibt an, ob primäres Trefferkriterium Name ein Treffer war. Der zu prüfende Name besteht bei natürlichen Personen aus dem Vor- und Nachnamen. Bei juristischen Personen aus dem Namen der Firma. Mindestens folgende Gegebenheiten sollten abgefangen werden: · Identifikation durch Vertauschen von Vor- und Nachnamen · Identifikation aus dem String "Vor- und Nachname" gegen jeweils Vor- und Nachname in beide Richtungen (z.B. für Kunden, die im Vor- und Nachnamen jeweils einen kompletten Namen eingetragen haben (Wohngemeinschaften)) · Angabe der Firmenbezeichnung wird gegen Vor- und Nachnamen sowie dem kompletten String aus "Vor- und Nachname" verglichen. · Angabe der Kundennummer wird gegen die Kundennummer des LFA verglichen. · Identifikation aus dem String "Vor- und Nachname" gegen jeweils Vor- und Nachname in beide Richtungen (z.B. für Kunden, die im Vor- und Nachnamen jeweils einen kompletten Namen eingetragen haben (Wohngemeinschaften)) · Angabe der Firmenbezeichnung wird gegen Vor- und Nachnamen sowie dem kompletten String aus "Vor- und Nachname" verglichen.

trefferGeraetenummer

boolean

required

Gibt an, ob primäres Trefferkriterium Gerätenummer ein Treffer war. Die Prüfung ist für jede angegebene Gerätenummer durchzuführen. - Es sind alle Geräte vom Typ kME, mME und Smart-Meter-Gateways mit der übergebenen Gerätenummer zu suchen. - Die Reihenfolge der Zeichen in der Gerätenummer ist wichtig. - Bei einer Prüfung der Gerätenummer ist es wichtig, dass die Reihenfolge der Zeichen identisch ist. - Die Prüfung ist case-sensitiv. - Zusätzlich sind schließende Nullen ebenfalls zu ignorieren. - Dabei sind für jeden Zeichen in der Reihenfolge folgende Regeln zu beachten: - Zusammen mit schließenden Nullen werden auch alle Zeichen in der Reihenfolge berücksichtigt. - Eine Identifizierung soll auch erfolgen, wenn ein Marktpartner einen Zähler/Gateway sendet, der bereits im Rahmen eines Gerätewechsels innerhalb der letzten 36 Monate ausgetauscht wurde (Ausnahme Netzbetreiberwechsel). - Die Übereinstimmung einer Gerätenummer liegt vor, wenn alle Zeichen in genannter Reihenfolge mit der aufgebrachten Nummer auf dem Gerät identisch sind. - Gegebenenfalls im System vorhandene Prä- und Suffixe sind zu ignorieren.

trefferMeloid

boolean

required

Gibt an, ob primäres Trefferkriterium MeloId ein Treffer war. Die Prüfung ist für jede angegebene MeLo-ID durchzuführen. Die Übereinstimmung der MeLo-ID liegt vor, wenn die vollständige 33-stellige Zeichenkette übereinstimmt.

trefferAdresse2

boolean

required

Gibt an, ob sekundäres Trefferkriterium zweite Adresse ein Treffer war. Ermittlung, ob ermittelte Malo alle Adressidentifizierungsparameter erfüllt (Vollständige Adrressprüfung)

trefferMakorelevant

boolean

required

Gibt an, ob sekundäres Trefferkriterium Makorelevanz ein Treffer war. Ermittlung, ob ermittelte Malo an der Mako teilnimmt

trefferStillgelegt

boolean

required

Gibt an, ob sekundäres Trefferkriterium Stilllegungsstatus ein Treffer war. Ermittlung, ob ermittelte Malo stillgelegt ist.

trefferNetzgebiet

boolean

required

Gibt an, ob sekundäres Trefferkriterium Netzgebiet ein Treffer war. Ermittlung, ob ermittelte Malo zum Selektionszeitpunkt einem Netz zugeordnet ist, welches durch eine Serviceanbieter mit Kennzeichen „eigener Service“ versorgt wird.

trefferNetzgebiet3KJ

boolean

required

Gibt an, ob sekundäres Trefferkriterium 3KJ-Netzgebiet ein Treffer war.Ermittlung, ob ermittelte Malo zum innerhalb der letzten 3 KJ einem Netz zugeordnet ist oder war, welches durch eine Serviceanbieter mit Kennzeichen „eigener Service“ versorgt wird.

Example

{
  "maloIdentDaten": [
    {
      "lokationsId": "74018657187",
      "trefferMaloid": true,
      "trefferTrancheId": false,
      "trefferAdresse1": true,
      "trefferKundennummer": false,
      "trefferName": false,
      "trefferGeraetenummer": false,
      "trefferMeloid": false,
      "trefferAdresse2": true,
      "trefferMakorelevant": true,
      "trefferStillgelegt": false,
      "trefferNetzgebiet": true,
      "trefferNetzgebiet3KJ": true
    }
  ]
}

🟠400Bad Request

Identifikation einer Marktlokation

Stammdaten der identifiz. MaLo