Breadcrumbs

Administrationshandbuch (Anbindung Marktstammdatenregister)

Installation

  • Das Modul C12EVI_MASTR muss aktiv sein, die Lizenz ist freizuschalten

  • Der Prozess “MaStR: Anlageninformationen abrufen” muss veröffentlicht sein

  • Die unternehmensindividuellen Zugangsdaten müssen gepflegt werden. Hierzu steht der Prozess “MaStR: Credentials initialisieren” (C12MaStRInitCredentials) zur Verfügung.

Zugangsdaten hinterlegen

Der Prozess zur Hinterlegung der Anmeldedaten kann ausgehend von der Hauptnavigation gestartet werden. Falls Sie den Prozess gerade erst veröffentlicht haben, kann es notwendig sein, sich einmal neu am Client anzumelden.

grafik-20251126-134118.png


Es öffnet sich eine Maske zur Eingabe der MaStR-Nummer sowie des API-Keys.

grafik-20251126-134300.png

Mit Fortsetzen des Prozesses werden die Anmeldedaten in den Credentials in der Datenbank gespeichert. Falls Sie die Anmeldedaten bereits hinterlegt haben und diese Aktualisieren wollen, verwenden sie ebenfalls diesen Prozess und ersetzen sie die bisherigen Daten einfach mit den neuen.

Skriptbibliothek

  • SC12MASTRUTILS

Prozesse

  • MaStR: Anlageninformationen abrufen (C12MaStR_GetInstallationInformation)

  • MaStR: Credentials initialisieren (C12MaStR_InitCredentials)

Globale Variablen

  • C0MaStRBaseURL
    2026.4
    Um die Verbindung zum Marktstammdatenregister herzustellen, muss die URL zum gewünschten Server in der globalen Variablen "C0MaStRBaseURL" hinterlegt werden.
    Beispiel: https://test.marktstammdatenregister.de

Services

GetEinheitWind

methodURL: Anlage

Action: GetEinheitWind

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:anl="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle/Anlage" xmlns:mod="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle">
   <soap:Header/>
   <soap:Body>
      <anl:GetEinheitWindRequest>
         <mod:apiKey>string</mod:apiKey>
         <mod:marktakteurMastrNummer>string</mod:marktakteurMastrNummer>
         <mod:einheitMastrNummer>string</mod:einheitMastrNummer>
      </anl:GetEinheitWindRequest>
   </soap:Body>
</soap:Envelope>

GetEinheitBiomasse

methodURL: Anlage

Action: GetEinheitBiomasse

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:anl="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle/Anlage" xmlns:mod="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle">
   <soap:Header/>
   <soap:Body>
      <anl:GetEinheitBiomasseRequest>
         <mod:apiKey>string</mod:apiKey>
         <mod:marktakteurMastrNummer>string</mod:marktakteurMastrNummer>
         <mod:einheitMastrNummer>string</mod:einheitMastrNummer>
      </anl:GetEinheitBiomasseRequest>
   </soap:Body>
</soap:Envelope>

GetEinheitWasser

methodURL: Anlage

Action: GetEinheitWasser

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:anl="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle/Anlage" xmlns:mod="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle">
   <soap:Header/>
   <soap:Body>
      <anl:GetEinheitWasserRequest>
         <mod:apiKey>string</mod:apiKey>
         <mod:marktakteurMastrNummer>string</mod:marktakteurMastrNummer>
         <mod:einheitMastrNummer>string</mod:einheitMastrNummer>
      </anl:GetEinheitWasserRequest>
   </soap:Body>
</soap:Envelope>

GetEinheitGeothermieGrubengasDruckentspannung

methodURL: Anlage

Action: GetEinheitGeothermieGrubengasDruckentspannung

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:anl="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle/Anlage" xmlns:mod="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle">
   <soap:Header/>
   <soap:Body>
      <anl:GetEinheitGeothermieGrubengasDruckentspannungRequest>
         <mod:apiKey>string</mod:apiKey>
         <mod:marktakteurMastrNummer>string</mod:marktakteurMastrNummer>
         <mod:einheitMastrNummer>string</mod:einheitMastrNummer>
      </anl:GetEinheitGeothermieGrubengasDruckentspannungRequest>
   </soap:Body>
</soap:Envelope>

GetAnlageEegWind

methodURL: Anlage

Action: GetAnlageEegWind

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:anl="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle/Anlage" xmlns:mod="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle">
   <soap:Header/>
   <soap:Body>
      <anl:GetAnlageEegWindRequest>
         <mod:apiKey>string</mod:apiKey>
         <mod:marktakteurMastrNummer>string</mod:marktakteurMastrNummer>
         <mod:eegMastrNummer>string</mod:eegMastrNummer>
      </anl:GetAnlageEegWindRequest>
   </soap:Body>
</soap:Envelope>

GetAnlageEegSolar

methodURL: Anlage

Action: GetAnlageEegSolar

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:anl="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle/Anlage" xmlns:mod="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle">
   <soap:Header/>
   <soap:Body>
      <anl:GetAnlageEegSolarRequest>
         <mod:apiKey>string</mod:apiKey>
         <mod:marktakteurMastrNummer>string</mod:marktakteurMastrNummer>
         <mod:eegMastrNummer>string</mod:eegMastrNummer>
      </anl:GetAnlageEegSolarRequest>
   </soap:Body>
</soap:Envelope>

GetAnlageEegBiomasse

methodURL: Anlage

Action: GetAnlageEegBiomasse

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:anl="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle/Anlage" xmlns:mod="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle">
   <soap:Header/>
   <soap:Body>
      <anl:GetAnlageEegBiomasseRequest>
         <mod:apiKey>string</mod:apiKey>
         <mod:marktakteurMastrNummer>string</mod:marktakteurMastrNummer>
         <mod:eegMastrNummer>string</mod:eegMastrNummer>
      </anl:GetAnlageEegBiomasseRequest>
   </soap:Body>
</soap:Envelope>

GetEinheitEegWasser

methodURL: Anlage

Action: GetAnlageEegWasser

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:anl="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle/Anlage" xmlns:mod="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle">
   <soap:Header/>
   <soap:Body>
      <anl:GetAnlageEegWasserRequest>
         <mod:apiKey>string</mod:apiKey>
         <mod:marktakteurMastrNummer>string</mod:marktakteurMastrNummer>
         <mod:eegMastrNummer>string</mod:eegMastrNummer>
      </anl:GetAnlageEegWasserRequest>
   </soap:Body>
</soap:Envelope>

GetAnlageEegGeothermieGrubengasDruckentspannung

methodURL: Anlage

Action: GetAnlageEegGeothermieGrubengasDruckentspannung

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:anl="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle/Anlage" xmlns:mod="https://www.marktstammdatenregister.de/Services/Public/1_2/Modelle">
   <soap:Header/>
   <soap:Body>
      <anl:GetAnlageEegGeothermieGrubengasDruckentspannungRequest>
         <mod:apiKey>string</mod:apiKey>
         <mod:marktakteurMastrNummer>string</mod:marktakteurMastrNummer>
         <mod:eegMastrNummer>string</mod:eegMastrNummer>
      </anl:GetAnlageEegGeothermieGrubengasDruckentspannungRequest>
   </soap:Body>
</soap:Envelope>

Mapping

Der Abruf der Daten wird über die Aktionsbox auf der Anlage (Installation) gestartet. Der Prozess ruft dann in Abhängigkeit der Sparte der Anlage den bzw. die entsprechenden Services auf.

Sparte

Services

Photovoltaik

GetEinheitSolar, GetAnlageEegSolar

Wasser

GetEinheitWasser, GetAnlageEegWasser

Die empfangenen Daten werden wie folgt auf EVI-Felder gemapped und gespeichert. Ist kein EVI-Feld hinterlegt, kann der Kunde hier ein C2-Feld hinterlegen. Die Daten werden auf die Anlage (Installation), von der aus der Prozess gestartet wurde, sowie das zugehörige Anschlussobjekt (Location, LocationPk.Installation) geschrieben.

MaStR-Feld

Service

Datentyp

EVI-Feld

DatumLetzteAktualisierung

GetEinheit*

DateTime (yyyy-MM-dd'T'hh:mm:ss.SSSSSSSXXX)

C12MaStRUpdDate.Installation

AnlagenbetreiberMastrNummer

GetEinheit*

String

C12MaStROpKey.Installation

Land

GetEinheit*

https://www.marktstammdatenregister.de/MaStRHilfe/files/webdienst/Funktionen_MaStR_Webdienste_V23.2.112.html#laendereinheitenenum

CountryKey.Location

Bundesland

GetEinheit*

https://www.marktstammdatenregister.de/MaStRHilfe/files/webdienst/Funktionen_MaStR_Webdienste_V23.2.112.html#bundeslaendereinheitenenum

State.Location

Postleitzahl

GetEinheit*

String

ZIP.Location

Gemarkung

GetEinheit*

String

SubDistrict.Location

FlurFlurstuecknummern

GetEinheit*

String

Parcel.Location

Strasse

GetEinheit*

String

Street.Location

Hausnummer.Wert

GetEinheit*

String

StreetNumber.Location

Ort

GetEinheit*

String

City.Location

Laengengrad

GetEinheit*

Double

Lng.Location

Breitengrad

GetEinheit*

Double

Lat.Location

Inbetriebnahmedatum

GetEinheit*

Date (yyyy-MM-dd)

InstallDate.Installation

Energietraeger

GetEinheit*

https://www.marktstammdatenregister.de/MaStRHilfe/files/webdienst/Funktionen_MaStR_Webdienste_V23.2.112.html#energietraegerenum

-

NameStromerzeugungseinheit

GetEinheit*

String

-

Bruttoleistung

GetEinheit*

Double

C12TotalPower.Installation

EinheitBetriebsstatus

GetEinheit*

none - Leerschlüssel
InPlanung - 01 In Umsetzung
InBetrieb - 02 Aktiv
VoruebergehendStillgelegt - 03 Beendet
EndgueltigStillgelegt - 03 Beendet

InstStatusKey.Installation

Nabenhoehe

GetEinheitWind

Decimal

-

Rotordurchmesser

GetEinheitWind

Decimal

-

Hersteller.Wert

GetEinheitWind

String

-

Typenbezeichnung

GetEinheitWind

String

-

Hauptbrennstoff

GetEinheitBiomasse

https://www.marktstammdatenregister.de/MaStRHilfe/files/webdienst/Funktionen_MaStR_Webdienste_V23.2.112.html#biomassebrennstoffenum

-

AnlagenschluesselEeg

GetAnlage*

String

EEGInstKey.Installation

Ablauf

grafik-20240417-142208.png
Technisches Modell “MaStR: Anlageninformationen abrufen”

  • Start ausgehend von einer Anlage (Installation) per Aktionsboxeintrag "Öffentliche Daten abrufen" im Ordner "Marktstammdatenregister"

  • Startet den Prozess C12MaStR_GetInstallationInformation, sofern das Modul aktiv ist

  • Prozess ruft die Skriptbibliotheksmethode SC12MaStRUtils.processInstallation auf

  • Die weitere Verarbeitung erfolgt in der Skriptbibliothek

  • Die Anlage wird aktualisiert, das Anschlussobjekt wird aktualisiert