Skip to main content
Skip table of contents

Bearbeitung von Balkonkraftwerken

Meldungen zu Balkonkraftwerken werden über die MaStR-Schnittstelle importiert.

Zur Prüfung der neu angemeldeten Balkonkraftwerke werden die NBP (Netzbetreiberprüfung)-Tickets aus dem Marktstammdatenregister (MaStR) abgerufen. Für jedes Ticket wird ein TINA-Projekt analog der Anmeldung Eigenerzeugungsanlagen erzeugt.

Die Werte aus den MaStR-Services in die JSON-Struktur des Services ag.itc.createGeneratingUnit überführt, so dass die weitere Verarbeitung größtenteils analog dem Prozess der Anmeldung Eigenerzeugungsanlagen erfolgt.

Gruppe Balkonkraftwerke

Neu eingegangene Projekte erscheinen bei Mitarbeitenden, die der Gruppe BALKONKRAFTWERKE angehören im Benachrichtigungsmenü. Im Feld Projektgruppe eines Projektes wird ebenfalls die Gruppe BALKONKRAFTWERKE hinterlegt.

Die Benachrichtigungen können bei Bedarf deaktiviert werden (siehe Benachrichtigungen deaktivieren).

Import

MaStR-Services

Folgende Services aus dem MaStR werden hierzu aufgerufen:

GetListeMeineNetzbetreiberpruefungen

  • Über den Parameter datumAb können sowohl neue Tickets als auch geänderte Einheiten/Anlagen selektiert werden

  • AbgeschlosseneTicketprozesseEinschliessen=false, damit abgeschlossene Tickets nicht mehr selektiert werden

  • Alle im MaStR angemeldete Balkonkraftwerke, unabhängig vom Inbetriebnahmedatum (damit auch z.B. Inbetriebnahmen aus 2023) werden über die Schnittstelle bzw. dem Prozess verarbeitet

  • Die SEE-Nr. wird über GetListeMeineNetzbetreiberpruefungen.ListeNetzbetreiberpruefungen.verknuepfteEinheit.MaStRNummer ermittelt → für Service GetEinheitSolar

  • Die ABR-Nr. wird über GetListeMeineNetzbetreiberpruefungen.ListeNetzbetreiberpruefungen.anlagenbetreiberMastrNummer ermittelt → für Service GetMarktakteur

  • Für den Fall Balkonkraftwerk wird immer nur ein Projekt an der entsprechenden Anlage erzeugt.
    Sollte zu einer SEE-Nr. (C12SEENr.Installation) schon eine Anlage inkl. Projekt vorhanden sein, wird das Projekt immer aktualisiert

GetEinheitSolar

  • Über einheitMastrNummer wird die SEE-Nr. übergeben

GetMarktakteur

  • Über mastrNummer wird die ABR-Nr. übergeben

Feldmapping

Bezeichnung in MaStR-Export

MaStR-API-Feld

Ziel JSON-Attribute

TINA-Feld-Oberfläche

TINA-Feld-intern

Anmerkung

Bsp. 1 MaStR-Export

Bsp. 2 MaStR-Export

Betriebsstatus

GetEinheitSolar.EinheitBetriebsstatus.AnlagenBetriebsStatusEnum=InBetrieb

Filter: in Betrieb,
"Endgültig stillgelegt" wird derzeit nicht berücksichtigt

In Betrieb

In Betrieb

Systemstatus

GetEinheitSolar.EinheitSystemstatus.AnlagenSystemStatusEnum=Aktiv

Filter: Aktiviert

Aktiviert

Aktiviert

NBP-Status

GetListeMeineNetzbetreiberpruefungen.ListeNetzbetreiberpruefunge.status=Ungeprueft

Filter: Ungeprüft

Geprüft

Datenkorrektur erforderlich

Lage der Einheit

GetEinheitSolar.Lage=SteckerfertigeSolaranlage

Filter: Steckerfertige Solaranlage (sog. Balkonkraftwerk)

Steckerfertige Solaranlage (sog. Balkonkraftwerk)

Steckerfertige Solaranlage (sog. Balkonkraftwerk)

project.mediaType

Sparte

C12Medium.Project

fest POWER

project.orderTypeKey

Projektart

TypeKey.Project

fest EA (Erzeugungsanlage)

project.orderTypeKeyDetail

Projektart-Detail

C12TypeKeyDet.Project

fest BKW (Balkonkraftwerk)

project.projectStatusKey

Status

ProjectstatusKey.Project

fest 10

GetEinheitSolar.Zaehlernummer

project.meterNo

Messeinrichtung (Zähklernr.)

MeterNo.MeasuringDevice über C12MeDePk.Project

Postleitzahl

GetEinheitSolar.Postleitzahl

project.locations.postalCode

PLZ

ZIP.Location

64331

64354

Ort

GetEinheitSolar.Ort

project.locations.city

Ort

City.Location

Weiterstadt

Reinheim

Straße

GetEinheitSolar.Strasse

project.locations.street

Straße

Street.Location

Rappmühlstraße

Hochstraße

Hausnummer

wenn GetEinheitSolar.Hausnummer.NichtVorhanden=false: 
dann: .Wert
sonst: leer

project.locations.houseNo

Hausnummer

StreetNumber.Location

35 e

17

Adresszusatz

GetEinheitSolar.Adresszusatz

project.locations.houseNoAffix

Haus-Nr. Zusatz

StreetNumberAddition.Location

wenn GetEinheitSolar.Adresszusatz gefüllt, wird eine Aktivität erzeugt

Das JSON-Objekt activity wird am Objekt project.activities hinterlegt

Gemarkung

GetEinheitSolar.Gemarkung

project.locations.localSubdistrict

Gemarkung

SubDistrict.Location

Flurstück

GetEinheitSolar.FlurFlurstuecknummern

project.locations.parcelNumber

Flurstücknummer

ParcelNumber.Location

im MaStR Flur + Flst.

MaStR-Nr. der Einheit

GetListeMeineNetzbetreiberpruefungen.ListeNetzbetreiberpruefungen.verknuepfteEinheit.MaStRNummer

project.locations.location.installations.installation.seeNo

SEE-Nummer

C12SEENr.Installation

ID zum Identifizieren, wenn die Anlage mehrfach (z.B. nach Korrektur) erneut nach TINA übertragen wird

SEE982544496238

SEE905914154132

Inbetriebnahmedatum der Einheit

GetEinheitSolar.Inbetriebnahmedatum

project.locations.location.installations.installation.commissionDate

Inbetriebnahme

InstallDate.Installation

29.10.2020

11.11.2020

MaStR-Nr. der EEG-Anlage

GetEinheitSolar.EegMastrNummer

project.locations.location.installations.installation.eegInstallationKey

EEG Anlagenschlüssel

EEGInstKey.Installation

EEG995307128376

EEG936034755763

project.locations.location.installations.installation.installationState

Anlagenstatus

InstStatusKey.Installation

fest: AKTIV

project.locations.location.installations.installation.mediaType

Produktart

ProducttypeKey .Installation

fest: PV

project.locations.location.installations.installation.meteringConcept

Messkonzept

C12MeasuringCon.Installation

leer, ist übersteuerbar

Einspeisungsart

GetEinheitSolar.Einspeisungsart

project.locations.location.installations.installation.feedInType

Einspeiseart

C12FeedInType.Installation

Mapping GetEinheitSolar.Einspeisungsart → C12FeedInType.Installation:

  • TeileinspeisungEigenverbrauch: SELBST

  • Volleinspeisung: VOLL

  • None: <leer>

Fernsteuerbarkeit der Einheit durch einen Netzbetreiber

FernsteuerbarkeitNb

project.locations.location.installations.installation.feedInManag

Einspeisemanagement

C12FeedInManag.Installation

wenn GetEinheitSolar.FernsteuerbarkeitNb = false:

  • dann NR (nicht regelbar)

  • sonst leer bzw. "?"

project.locations.location.installations.installation.feedInSym

Symmetrisch

C12FeedInSym.Installation

fest: FALSE

project.locations.location.installations.installation.feedInSelling

Veräußerungsform der Einspeisung

C12FeedInSell.Installation

fest: VOGV (Vermarktung ohne gesetzliche Vergütung)

Registrierungsdatum der Einheit

GetEinheitSolar.Registrierungsdatum

project.locations.location.installations.installation.registerDateMaStR

Datum der Registrierung im MaStR
Bisher kein Feld in TINA, nur im JSON aus Kundenportal im Attribut registerDateMaStR

16.03.2021

11.11.2020

Bruttoleistung der Einheit

GetEinheitSolar.Bruttoleistung

project.locations.location.installations.installation.modulePowerTotal

Gesamtleistung Module

C12PvPower.Installation

Bruttoleistung der Einheit

GetEinheitSolar.Bruttoleistung

project.locations.location.installations.installation.modulePowerMaStR

Gesamtleistung Module aus MaStR

C12PvPowerMaStR.Installation

Zugeordnete Wechselrichterleistung

GetEinheitSolar.zugeordneteWirkleistungWechselrichter

project.locations.location.installations.installation.powerTotal

Gesamtwirkleistung

C12TotalPower.Installation

project.projectParties.projectParty.type

fest: ANLAGENBETREIBER

Personenart

GetMarktakteur.Personenart

project.projectParties.projectParty.customerProfile.customerType

Gp-Typ

PersontypeKey.Customer

MarktakteurAnrede

GetMarktakteur.MarktakteurAnrede

Nachname/Firma

wenn GetMarktakteur.Personenart=NatuerlichePerson: dann: GetMarktakteur.MarktakteurNachname,
sonst: GetMarktakteur.Firmenname

project.projectParties.projectParty.customerProfile.name1

GP-Firma/Name

Name1.Customer

Vorname

wenn GetMarktakteur.Personenart=NatuerlichePerson:
dann: GetMarktakteur.MarktakteurVorname,
sonst: leer

project.projectParties.projectParty.customerProfile.name2

GP-Zusatz1/Vorname

Name2.Customer

E-Mail

Wenn GetMarktakteur.Email gefüllt:
dann: GetMarktakteur.Email,
sonst: GetMarktakteur.EmailVMav

project.projectParties.projectParty.customerProfile.email

GP-E-Mail

Email.Customer

Die eingetragene E-Mail-Adresse wird zunächst gegen das Feld GetMarktakteur.email geprüft. Ist das Datenfeld leer, erfolgt eine 2. Prüfung auf GetMarktakteur.EmailVMav.

Land

GetMarktakteur.Land

project.projectParties.projectParty.addresse.country

GP-Postadresse-Land

CountryKey.Address

PLZ

GetMarktakteur.Postleitzahl

project.projectParties.projectParty.addresse.postalCode

GP-Postadresse-PLZ

ZIPKey.Address

Ort

GetMarktakteur.Ort

project.projectParties.projectParty.addresse.city

GP-Postadresse-Ort

City.Address

Straße

GetMarktakteur.Strasse

project.projectParties.projectParty.addresse.street

GP-Postadresse-Straße

Street.Address

Hausnummer

GetMarktakteur.Hausnummer

project.projectParties.projectParty.addresse.houseNo

GP-Postadresse-Hausnummer

StreetNumber.Address

Adresszusatz

GetMarktakteur.Adresszusatz

project.projectParties.projectParty.addresse.houseNoAffix

GP-Postadresse-Hausnummerergänzung

StreetNumberAddition.Address

Telefon

Wenn GetMarktakteur.Telefon gefüllt:
dann: GetMarktakteur.Telefon,
sonst: GetMarktakteur.TelefonnummerVMav

project.projectParties.projectParty.customerProfile.phoneNoBase

GP-Standard-Telekom-Rufnummer (Festnetz)

PhoneNoBase.Telecom

Logik siehe Gp-E-Mail

Titel

GetMarktakteur.MarktakteurTitel

project.projectParties.projectParty.contactProfile.title

Default-AP-Namenstitel

AcademicTitle.ContactPerson

Achtung: contactProfile noch nicht Verwendung.
Siehe Kommentar bei Objekt projectParty

Logiken für die Erzeugung der Projekte und zugehörigen Daten

Anschlussobjekt

  • Leerzeichen aus GetEinheitSolar.Hausnummer.Wert werden Suchen entfernt

  • Alphanumerische Zeichen werden in lowercase umgewandelt
    In SAP ist in der Hausnummer kein Leerzeichen und klein vorhanden (z.B. „12b“). Im MaStR wird „12 B“ gepflegt. In diesem Fall würde die Adresse gefunden werden. Sollte in SAP „12 B“ vorhanden sein, wird die Adresse nicht gefunden.

  • Ausnahme bei der Prüfung ist der Straßenname: Hier wird str. mit straße gleichgesetzt

    • Im MaStR wird die Straße ausgeschrieben

    • In SAP ist die Straße abgekürzt mit Str

  • Es werden alle gefundenen Anschlussobjekte dem Projekt zugeordnet

  • Das Anschlussobjekt wird erzeugt, wenn das Feld Flurstück gefüllt ist oder die Adresse nicht gefunden wird (über PLZ + Ort + Straße + Hausnummer). TINA legt temporär ein neues Anschlussobjekt (ohne SAP-AO-Nr.) an. Die Klärung bzgl. des Anschlussobjektes muss durch die Fachabteilung manuell erfolgen.

Messeinrichtung

  • Es wird nach einer Messeinrichtung, deren Zählernummer exakt mit der übergebenen Zählernummer übereinstimmt, gesucht

  • Bei genau einem Treffer wird diese Messeinrichtung dem Projekt zugeordnet

  • Kann die Messeinrichtung nicht eindeutig anhand der Zählernummer identifiziert werden, muss eine manuelle Zuordnung durch den Anwender erfolgen

  • Eine Prüfung, ob der Zähler in dem am Projekt verknüpften Anschlussobjekt vorhanden bzw. eingebaut ist, erfolgt aktuell nicht

Geschäftspartner (Anlagenbetreiber) verknüpfen

Die Identifizierung erfolgt analog zur Geschäftspartneridentifizierung für Klein- und Mittelanlagen.

Konnte der Geschäftspartner anhand der übergebenen Daten nicht eindeutig identifiziert werden, ist eine manuelle Prüfung und Identifikation des Geschäftspartners erforderlich.

Anlagen

Zu dem Projekt wird aus den Werten aus dem MaStR eine Anlage der Sparte PV erzeugt.

Automatische Prüfungen

Für eingegangene Projekte für Balkonkraftwerke erfolgen diverse Prüfungen im Hintergrund (Skriptbibliotheksmethode SC14ProjectUtils.checkBKWProject).

Wenn mindestens eine der nachfolgenden Prüfungen fehlschlagen wird eine Aktivität erzeugt

  • Gesamtmodulleistung (C12PvPower.Installation) <= 2 kWp

  • Gesamtwirkleistung (C12TotalPower.Installation) <= 0,8 kW

  • Einspeiseart (C12FeedInType.Installation) == SELBST (Selbstverbrauch)

  • Einspeisemanagement (C12FeedInManag.Installation) == NR (nicht regelbar) „?“ bzw. wenn das Feld leer ist, ist die Prüfung ebenfalls nicht erfüllt bzw. negativ

  • Mit Rücklaufsperre (= Zählernummer kleiner oder gleich 7 Stellen)

  • Nachname des Anlagenbetreibers muss mit dem Netznutzer übereinstimmen (über Zählernummer → Anlage → Anlagenkonto (Versorgungsstatus aktiv) → Geschäftspartner)

  • Bestandsanlage vorhanden (über Anschlussobjekt keine weitere Anlage der Sparte PV oder Serviceart (ISU_ServArt.Installation) = SEIN (Einspeisung))

Die Aktivität ist wie folgt aufgebaut

Feld

Wert

Betreff

Sprachvariable C14CheckBKW.Activity.Subject

Beschreibung

Auflistung der fehlgeschlagenen Prüfungen, zusammengesetzt aus Sprachvariablen

  • C14CheckBKW.Activity.Text

  • C14CheckBKW.CustomerName

  • C14CheckBKW.FeedInManag

  • C14CheckBKW.FeedInType

  • C14CheckBKW.MeterBackstop

  • C14CheckBKW.PvPower

  • C14CheckBKW.TotalPower

Art

AUFGABE

Beginn

<NOW>

Ende

<NOW>

Priorität

B

Status

O

Delegiert von

<REST-USER der den Service ausführt>

Delegiert an Gruppe

BALKONKRAFTWERKE

Aktivität mit

<leer>

Prozesse

Die Bearbeitung der Balkonkraftwerke erfolgt über die Aktionsbox der Projekte. Hier gibt es Überschneidungen mit den Prozessen für die Anmeldung von Klein- und Mittelanlagen.

Projekt annehmen/übernehmen

Aktiv, wenn der aktuell angemeldete Benutzer nicht im Feld „Akt. Bearbeiter” (C12CurrentEmployee.Project) hinterlegt ist

Registrierung abschließen

Immer inaktiv, nicht in Verwendung für Balkonkraftwerke

Anschlussobjekt identifizieren

Prozess: Anschlussobjekt identifizieren (C14IdentifyLocation)

Der Prozessablauf ist identisch zu Anschlussobjekt identifizieren für Eigenerzeugungsanlagen

Aktiv, wenn nicht genau ein Anschlussobjekt am Projekt verknüpft ist

Zähler identifizieren

Prozess: Messeinrichtung identifizieren (C14IdentifyMeasuringDevice)

Der Prozessablauf ist identisch zu Zähler identifizieren für Eigenerzeugungsanlagen

Aktiv, wenn das Feld Messeinrichtung (C12MeDePk.Project) im Projekt leer ist

Geschäftspartner identifizieren

Prozess: Geschäftspartner identifizieren (C14IdentifyCustomer)

Der Prozessablauf ist identisch zu Geschäftspartner identifizieren für Eigenerzeugungsanlagen

Aktiv, wenn das Flag „Identifizierung Geschäftspartner abgeschlossen“ (C12IdentCuCompl.Project) nicht gesetzt ist.  

Projekt in Korrektur setzen

Immer inaktiv, nicht in Verwendung für Balkonkraftwerke

E-Mail Korrektur BKW

Prozess: E-Mail Korrektur BKW (C14MailBKW)

Aktiv, wenn Projektstatus < 60 (Netzzusage) UND Projektart-Details (C12TypeKeyDet.Project) = BKW, sonst inaktiv.

Ermöglicht die Erstellung einer E-Mail an den Anlagenbetreiber, für den Fall, dass der Projektbearbeiter Klärungen durchführen möchte.

Es wird vor Erstellung der E-Mail sichergestellt, dass genau ein Anschlussobjekt mit dem Projekt verknüpft ist. Andernfalls kann die Aktion nicht gestartet werden.

Konfiguration der Absenderadresse

Für den Versand der E-Mails kann über die Skriptbibliotheksmethode SC14ProjectUtils.getMailTemplateBKW die E-Mail-Konfiguration eines Gruppenpostfachs hinterlegt werden. Im Standard ist hier die mit dem System ausgelieferte E-Mail-Konfiguration C14EXTERNALMAIL_BKW hinterlegt. Soll diese verwendet werden, ist sie durch den Systemadministrator zu pflegen.

Konfiguration der E-Mail

Über die Skriptbibliotheksmethode SC14ProjectUtils.createBKWMailActivity kann die Gestaltung der Aktivität, welch die Basis für die zu versendende E-Mail bildet, beeinflusst werden. Der Text sowie der Betreff der E-Mail lassen sich über die Sprachvariablen C14MailBKW.Subject und C14MailBKW.Text individualisieren.

Netz-Zusage

Prozess: Netzzusage (C14NetConfirmation)

Aktiv, wenn folgende Aktionen inaktiv sind: 

  • Anschlussobjekt identifizieren 

  • Zähler identifizieren 

  • Geschäftspartner identifizieren 

UND der Projektstatus 20, 40 oder 50 ist

  • Der Status des Projekts wird auf 60 (Netzzusage/Einspeisegenehmigung erteilt) gesetzt

  • Das Datum der Netzzusage (C12GridAccept.Project) wird auf das aktuelle Datum gesetzt

  • Es wird keine Status-E-Mail an den Anlagenbetreiber versendet und kein Dokument für die Netzzusage erzeugt

Netz-Absage

Immer inaktiv, nicht in Verwendung für Balkonkraftwerke

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.