Administrationshandbuch (EVI-MASTR)

Installation

Das Modul C12EVI_MASTR ist zu importieren
- die Lizenz ist freizuschalten
Der Prozess “MaStR: Anlageninformationen abrufen” muss veröffentlicht sein
Zugangsdaten müssen gepflegt werden (Prozess MaStR: Credentials initialisieren)

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