Add feature soap api GetListeFreigegebeneEinheiten

[FlorianK13]

With the soap api method GetListeFreigegebeneEinheiten, basic units could be filled with all units where the API account has special reading access. This is interesting for unit owners or for grid operators.

[FlorianK13]

The API does not seem to work as expected. Using GetListeFreigegebeneEinheiten does not give you any units even though your account has registered an own PV system.

I have contacted BNetzA to ask them if this is intentional, let's see when they reply.

Here is the text (in German) that I have sent:

Sehr geehrte Damen und Herren, ich habe eine Frage zum Webdienst, genauer zur Soap API Funktion GetListeFreigegebeneEinheiten: Mein Verständnis dieser Funktion ist folgende: Wenn der registrierte User erweiterte Zugriffsrechte auf eine Anlage hat, zum Beispiel auf eine PV-Anlage im eigenen Besitz, dann sollte die Funktion GetListeFreigegebeneEinheiten die MaStR-Nummer dieser Anlage zurückgeben. Dies funktioniert bei mir aber nicht. GetListeAlleEinheiten funktioniert, somit funktioniert auch der API-Key. Wenn ich die Anlage direkt abfrage, also beispielsweise mit GetEinheitSolar, dann bekomme ich ebenfalls alle Daten (inklusive Standort etc) zu sehen und nicht nur die öffentlich zugänglichen. Der verwendete API-Key hat also eine Leseberechtigung für diese Anlage. Können Sie mir hier weiterhelfen? Habe ich evtl die Funktion GetListeFreigegebeneEinheiten falsch verstanden?

[FlorianK13]

I received the following answer:

Bitte nutzen Sie zum Abrufen der Einheiten Ihres Marktakteurs die Funktion GetGefilterteListeStromErzeuger. Im Request ist dann enthalten: mod:apiKeybitte eintragen</mod:apiKey> mod:marktakteurMastrNummerABR946978927485</mod:marktakteurMastrNummer> mod:AnlagenbetreiberMastrNummerABR946978927485</mod:AnlagenbetreiberMastrNummer> Die Beschreibung der Funktion "GetListeFreigegebeneEinheiten" wird angepasst, da diese den Marktakteuren/Netzbetreibern mit Datenfreigaben zur Verfügung steht. Geplant ist, eine separate Funktion anzubieten, um die eigenen Einheiten abzurufen. Diese kann jedoch frühestens mit der WSDL im Frühjahr 2023 bereitgestellt werden.

This will make the development of the desired feature a little harder.

[FlorianK13]

A nice feature in general, but right now it cannot be tested. I'll close the issue for now.