Webhilfe des Marktstammdaten­registers

Das Testsystem erreichen Sie unter der URL https://test.marktstammdatenregister.de/MaStRApi

Weiterhin steht das Vorschausystem des Marktstammdatenregisters unter https://vorschau.marktstammdatenregister.de/MaStRApi zur Verfügung. Das Vorschausystem gibt insbesondere den Marktakteuren, die über einen Webdienst mit dem MaStR kommunizieren, die Möglichkeit anstehende Änderungen am Webdienst vorab zu implementieren und zu testen. Marktakteure, die das Vorschausystem und den Webdienst verwenden möchten, können sich über das Kontaktformular mit dem Betreff „Zugangsdaten Vorschausystem“ melden, um Zugangsdaten zu erhalten.

Sie erhalten Sie WSDL-Datei für den Webdienst auf dieser Seite.

Webdienst-Benutzer können im Test-Webdienst über das Test-Webportal eigenständig angelegt und verwaltet werden.

Die Authentifizierung erfolgt über einen Webdienst-Key, welcher dem Webdienstbenutzer zugewiesen ist. Ein Zertifikat wird nicht benötigt. Der Transportkanal ist SSL verschlüsselt. Beachten Sie, dass wir nur TLS 1.2-Verbindungen akzeptieren!

Die erste WSDL beinhaltete Default-Faults, da diese Datei automatisch generiert wurde. Die aktuelle (und zukünftige WSDLs) werden durch einen anderen Prozess generiert und enthalten keine Faults. Informationen zu den Faults können Sie dem Schnittstellendokument entnehmen. Sie finden dies auf unserer Informationsseite.

Nein, es handelt sich um eine reine Machine-to-Machine Serviceschnittstelle.

Ja, die WSDL Datei kann mit jedem Soap-Tool konsumiert werden. Bei SoapUI ist mindestens die Version 5.3 zu empfehlen, da es ansonsten Probleme mit der SSL- bzw. TSL-Version geben könnte. Auch andere Alterniven, wie Postmann, sind möglich.

Bitte prüfen Sie die Einstellungen Ihres Proxyservers. Beachten Sie auch, dass Ihr Tool eine HTTPS-Verbindung auf Basis von TLS 1.2 aufbauen muss. Alle anderen Anfragen werden aus Sicherheitsgründen abgewiesen.

Die Dienstbeschreibung besteht aus einer WSDL- und mehreren XSD-Schemadateien. Die letzteren werden in der Regel bei der Verarbeitung der WSDL-Datei nachgeladen. Erfolgt dies nicht oder nicht vollständig, können Sie die Dateien aus dem ZIP-Archiv oder manuell vom Server laden.

Bitte nutzen Sie bei svcutil nicht die Option "Datacontractonly", da diese fehlerhaft arbeitet. Bei einem Aufruf von svcutil ohne diese Option erhalten Sie diese Fehlermeldungen nicht.

Die Versionierung erfolgt über den Namespace. Vergleichen Sie hierzu im Konzept das Kapitel 4.2 "Versionierung der Webdienste".

Bitte wenden Sie sich in diesem Fall mit diesem Code an unseren Support für eine weitere Klärung.

Insbesondere den Netzbetreibern werden Funktionen angeboten, um ihre Netzbetreiberprüfungen realisieren zu können.

Der Webdienst steht zusätzlich jedem (registrierten) Benutzer zur Verfügung, um öffentliche Daten abzurufen oder eigene Daten zu verwalten.

Die Funkion GetLokaleUhrzeit ist die einzige Funktion, für die keine Authentifizierung erforderlich ist. Sie dient im Wesentlichen dazu, die Verbindung zwischen Client und Server zu testen. Für alle anderen Webdienst-Funktionen ist eine Authentifizierung des Benutzers erforderlich. Dies erfolgt durch die Übermittlung eines Webdienst-Key des Webdienst-Benutzers.

Ein registrierter Webdienst-Benutzer kann pro Tag 50.000 Aufrufe an den Webdienst übermitteln. Ein solches Tageskontingent gilt für Benutzer von Netzbetreibern nicht.

Im Marktstammdatenregister befinden sich Kataloge. Diese Kataloge beschreiben Attribute von Objekten. Die Kataloge sind dabei statisch oder dynamisch.

Statische Kataloge sind Kataloge, die sich im laufenden Betrieb nicht ändern. Sie sind fest im System hinterlegt und werden lediglich bei neuen Release-Versionen aktualisiert. So ein Katalog ist z.B. die Spannungsebene oder das Bundesland.

Dynamische Kataloge sind Kataloge, die sich im laufenden Betrieb ändern können. Nur wenige Kataloge sind dynamisch, wie z.b. der Hersteller einer Windkraftanlage.

Im Webdienst sind alle statischen Kataloge als Enumerationen hinterlegt und in der WSDL fest integriert. Diese Kataloge besitzen keine ID. Die Angabe der ID erfolgt hier nur als Hinweis. In dem jeweiligen Objekt wird bei dem entsprechenden Attribut auch keine ID hinterlegt, sondern das entsprechende Item der Enumeraton.

Im folgenden Fall ist HOCHSPANNUNG ein Item der Enumeration "SpannungsebeneEnum":

<Netzanschlusspunkt>
<Spannungsebene>Hochspannung</Spannungsebene>
</Netzanschlusspunkt>


Bei den dynamischen Katalogen werden hingegen nur die IDs in den entsprechenden Attributen hinterlegt. Diese dynamischen Attribute können Sie über die Basisfunktionen im Webdienst abfragen und somit den Inhalt auslesen. Diese Kataloge müssen Sie in Ihrem System hinterlegen, um die Informationen an den Objekten auswerten zu können.

Im folgenden Beispiel ist 1234 die ID des Items "Hersteller ABC" aus dem Katalog "Hersteller".

Z.B.:

<Windeinheit>
<Hersteller>1234</Hersteller>
</Windeinheit>

Die WSDL-Datei beinhaltet nicht alle Servicebeschreibungen. Diese sind in extra Dateien ausgelagert.

Bei der Generierung der Proxies werden diese Dateien üblicherweise nachgeladen, sodass die Informationen zur Proxygenerierung vorhanden sind. Wenn keine Verbindung zum Internet besteht, fehlen die Basistypen und die Servicetypen, was Ihren Fehler erklärt.

Bei Ihnen scheint daher dieses Nachladen nicht zu funktionieren. Bitte prüfen Sie daher die Funktion zur Generierung des Proxies und ob Ihr Serversystem eine Verbindung zum Internet hat.

Oft hilf es, diese Generierung nicht online sondern offline auszuführen, da die restlichen Dateien so nicht aus dem Internet geladen werden, sondern von einem lokalen Verzeichnis.

Sie bekommen alle Offline-Dateien in dem entsprechenden ZIP-Archiv .

Gemeint ist die Version eines Objektes, welche über den Parameter "LetzteAenderung" identifiziert wird. Eine Objektversion ist mit einer Version eines Objektes nur dann gleich, wenn der Parameter "LetzteAenderung" gleich ist.

Mit der Deltafunktion lassen sich bei allen Listen nur die Objekte abrufen, die sich ab dem angegebenen Datum geändert haben oder neu entstanden sind.

Im Fall eines Fault wird nicht ein HTTP-Code 200 gesendet, sondern ein entsprechender Fehlercode. Das Verhalten muss in Ihrer Implementierung berücksichtigt werden.

Beispiele für Fault HTTP-Codes:

Soapenv:Receiver.ZugriffVerweigert403 Soapenv:Receiver.ZugriffVerweigertFalscherMarktakteur403 Soapenv:Receiver.ZugriffPruefungVerweigert403 Soapenv:Receiver.QuotaUeberschritten403 Soapenv:Receiver.ZugriffVerweigertNichtZustaendigerNetzbetreiber403 Soapenv:Receiver.NichtGefunden404 Soapenv:Receiver.EinheitNichtGefunden404 Soapenv:Receiver.MarktakteurNichtGefunden404 Soapenv:Receiver.MarktakteurUnbekannt404 Soapenv:Receiver.KatalogwertUnbekannt404 Soapenv:Receiver.KeineLokationAngegeben400 Soapenv:Receiver.EinheitTypFalsch400 Soapenv:Receiver.Wertefehler400 Soapenv:Receiver.EinheitDerPruefungFalsch400 Soapenv:Receiver.ProzessschrittNichtMoeglich400 Soapenv:Receiver.ProzessNichtAbschliessbar400 Soapenv:Receiver.ObjektVersionUngueltig400 Soapenv:Receiver.ProzessschrittKorrekturNichtMöglich400 Soapenv:Receiver.WerteGesperrt423 Soapenv:Receiver.FunktionGesperrt423 Soapenv:Receiver.AllgemeinerFehler500

Es handelt sich um die Region des Marktakteurs auf der Ebene von NUTS-II.

Es handelt sich um ein Freitextfeld, um weitere Informationen zu einer Adresse zu erfassen.

Diese Funktionen stehen Netzbetreibern zur Verfügung, die zu einer Netzbetreiberprüfung aufgefordert wurden.

Stellt ein Netzbetreiber fest, dass die Daten eines der durch ihn zu prüfenden Objekte fehlerhaft sind, kann er den Dateninhaber (Anlagenbetreiber) mittels eines Korrekturvorschlags zur Korrektur seiner Daten auffordern.

Der Status der Netzbetreiberprüfung gibt an, in welchem Schritt sich der zugehörige Ticketprozess befindet.