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.

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

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)

Services

GetEinheitWind

methodURL: Anlage

Action: GetEinheitWind

CODE

<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

CODE

<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

CODE

<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

CODE

<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

CODE

<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

CODE

<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

CODE

<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

CODE

<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

CODE

<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

*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