Was ist die Webdienst-Benutzer-Rolle?
Standardmäßig kann jeder Betreiber seine eigene Anlage im MaStR-Portal registrieren. Für Dienstleister (Installateure, Softwareanbieter) bietet die BNetzA eine spezielle Webdienst-Benutzer-Rolle an. Diese erlaubt den programmatischen Zugriff auf die SOAP-API und die Registrierung im Auftrag beliebig vieler Betreiber.
Die Rolle muss einmalig beim MaStR-Serviceteam der BNetzA beantragt werden. Nach Freischaltung erhält der Dienstleister einen API-Key, der für alle Anfragen benötigt wird.
Vollmachtspflicht für Dienstleister
Wer als Dienstleister Anlagen für Dritte anmeldet, handelt faktisch als Bevollmächtigter des Betreibers. Die BNetzA verlangt, dass Dienstleister Vollmachten archivieren. Im Streitfall — etwa wenn ein Betreiber bestreitet, eine Anmeldung beauftragt zu haben — ist die Vollmacht der einzige Schutz des Dienstleisters.
MarktstammPro archiviert Vollmachten pro Anlage und Betreiber und stellt eine Vollmachtsvorlage zur Verfügung.
Versionsmanagement der API
Die BNetzA aktualisiert die API-Version regelmäßig. Beim Wechsel von einer Hauptversion auf die nächste (z.B. V25 → V26) müssen Felder, Enumerationen und Endpunkte aktualisiert werden. Wer die API selbst integriert, muss diese Migrationen eigenständig durchführen. MarktstammPro übernimmt alle Versionsmigrationen zentral — Nutzer registrieren weiter wie gewohnt, ohne von API-Änderungen zu erfahren.