Zur Unterstützung

... bei der Programmierung der Schnittstelle für das Marktstammdatenregister stellen wir Ihnen auf dieser Internetseite einige Informationen zur Verfügung.

Unter dem folgenden Link können Sie auf die Dienstbeschreibung des Webdienstes als WSDL-Datei inkl. XSD-Schema zugreifen:
Erklärung:
  • WSDL – Web Services Description Language – ist eine plattform-, programmiersprachen- und protokollunabhängige Beschreibungssprache für Netzwerkdienste.
  • XSD – XML Schema – beschreibt in einer komplexen Schemasprache Datentypen, einzelne XML-Schema-Instanzen (Dokumente) und Gruppen solcher Instanzen, zum Beispiel eine WSDL-Datei.
Die Beschreibung der Testumgebung kann als Konzept des Webdienstes und Objektdefinition hier heruntergeladen werden:

Weitere Informationen

... können Sie unserer automatisch generierten API Dokumentation entnehmen. Nützliche, auf Ihre Entwicklungsumgebung bezogene Hinweise finden sie hier:

  • Für Microsoft.NET:
    Bitte wählen Sie im Visual Studio "Service Referenz hinzufügen" und geben Sie die im ZIP-Archiv hinterlegte WSDL-Datei an. Alternativ können Sie auch das Util "svcutil.exe Api.svc?wsdl" verwenden.
  • Für JAVA:
    Bitte schauen Sie auf folgende Dokumentation, um Hilfe bei der Erstellung eines Clients zu erhalten: Oracle Dokumentation
  • Für PHP:
    Bitte schauen Sie auf folgende Dokumentation, um Hilfe bei der Erstellung eines Clients zu erhalten: PHP Manual
Die Prozessbeschreibung der Netzbetreiberprüfung über den Webservice können Sie den folgenden Dokumenten entnehmen:
Antworten auf häufig gestellte Fragen zur Funktionalität des Webservices finden sie hier.

Allgemeine Hinweise und Antworten zum Marktstammdatenregister finden zu unter www.bundesnetzagentur.de/mastr-faq.

FAQs

Testsystem
Das Testsystem dient zur Vorstellung der technischen Umsetzung des Webdienstes, jedoch NICHT einer fachlichen Bearbeitung und Beurteilung von Daten. Das Testsystem stellt KEINE Produktivdaten zur Verfügung, lediglich unveränderliche Beispiel-Datensätze. Für jede aufgerufene Funktion liefert der Testserver eine Antwort mit technisch plausiblen Testdaten.
Mit dem Beginn der öffentlichen Testphase entfällt die Notwendigkeit einer Authentifizierung. Das Testsystem steht jedem interessierten Nutzer zur Verfügung.
Nein. Die Antworten des Testservers beinhalten ausschließlich statische Testdaten, die nicht manipuliert werden können. Einige Antworten werden zufällig ausgegeben, sodass der mehrmalige Aufruf derselben Funktion zu unterschiedlichen Ergebnissen führen kann. Komplexe Prozesse, wie die Netzbetreiberprüfung, können unter fachlichen Aspekten nicht getestet werden.
Fehler, die die technische Funktionalität des Webdienstes betreffen, können unter der unten angegebenen E-Mail-Adresse gemeldet werden. Fragen und Fehlermeldungen zur konkreten Realisierung Ihres Clients können vom Support des MaStR nicht berücksichtigt werden.
Allgemeine Fragen
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.
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.
Mit dem Start des Webdienstes werden insbesondere den Netzbetreibern Funktionen angeboten, um Netzbetreiberprüfungen realisieren zu können. Künftig wird der Webdienst jedem (registrierten) Benutzer zur Verfügung stehen, 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 API-Key.
Ein registrierter API-Benutzer kann pro Tag 10.000 Aufrufe an den Webdienst übermitteln. Ein solches Tageskontingent gilt für Benutzer von Netzbetreibern nicht.
Technische Fragen
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.
Marktakteure
Einheiten und Anlagen
Es handelt sich um ein Freitextfeld, um weitere Informationen zu einer Adresse zu erfassen.
Netzbetreiberprüfung
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.

Kontakt

Weitere Fragen zur Funktionalität des Webdienstes richten Sie bitte an:

E-Mail: service@marktstammdatenregister.de

Wir bitten um Ihr Verständnis, dass unser Support-Team bei Fragestellungen zur Framework-spezifischen Umsetzung bzw. konkreten Programmierung oder Implementierung Ihres Clients in bestehende Systeme keine Unterstützung leisten kann.

Impressum

Bundesnetzagentur für Elektrizität, Gas, Telekommunikation, Post und Eisenbahnen

Verantwortlich
Peter Stratmann
Redaktion
Hans-Jürgen Adams
Adresse
Tulpenfeld 4
53113 Bonn
Kontakt
Telefon: 0 228 14-3333
Fax: 0 228 14-3334
E-Mail: service@marktstammdatenregister.de

Rechtliche Hinweise

  1. Alle Angaben dieses Internetangebotes wurden sorgfältig geprüft. Wir bemühen uns, das Informationsangebot aktuell und inhaltlich richtig sowie vollständig anzubieten. Dennoch ist das Auftreten von Fehlern nicht völlig auszuschließen. Eine Garantie für die Vollständigkeit, Richtigkeit und letzte Aktualität kann daher nicht übernommen werden. Dies gilt ebenso für die jederzeitige Verfügbarkeit der zum Abruf bereitgehaltenen und angezeigten Inhalte.
  2. Die Bundesnetzagentur kann das Internetangebot nach eigenem Ermessen jederzeit ohne Ankündigung verändern und/oder seinen Betrieb einstellen. Sie ist nicht verpflichtet, Inhalte dieser Website zu aktualisieren.
  3. Die zum Abruf bereitgehaltenen Informationen sowie die mit Darstellungs- und Analysewerkzeugen generierten und angezeigten Ergebnisse dienen ausschließlich zur Information der Besucher des Internetangebots der Bundesnetzagentur. Sie stellen keine Beratung oder sonstige Empfehlung dar.
  4. An allen Seiten dieses Internetauftritts einschließlich Layout, Quelltext, Software und deren Inhalten besitzt die Bundesnetzagentur das Urheberrecht und sonstige Schutzrechte. Urheberrechtshinweise und Markenbezeichnungen dürfen weder verändert noch beseitigt werden. Die auf der Internetseite verwendeten Daten in den Formaten .xls und .csv stehen, falls nicht anders gekennzeichnet, unter der Datenlizenz Deutschland – Namensnennung – Version 2.0. Alle darüber hinausgehenden Handlungen bedürfen einer vorherigen schriftlichen Zustimmung der Bundesnetzagentur.
  5. Der Abruf der bereitgehaltenen Informationen darf nur in einer Art und Weise geschehen, die die Nutzung des Internetangebots durch die übrigen Besucher nicht beeinträchtigt.
  6. Die Bundesnetzagentur übernimmt keine Verantwortung für die Inhalte und die Verfügbarkeit von Websites Dritter, die über externe Links dieses Informationsangebotes erreicht werden. Die Verantwortlichkeit für diese fremden Inhalte liegt alleine bei dem Anbieter, der die Inhalte bereithält. Die Bundesnetzagentur vermittelt lediglich den Zugang zur Nutzung dieser Inhalte.
  7. Die Bundesnetzagentur distanziert sich ausdrücklich von allen Inhalten, die möglicherweise straf- oder haftungsrechtlich relevant sind oder gegen die guten Sitten verstoßen.

Datenschutz

  1. Die Bundesnetzagentur nimmt den Schutz Ihrer personenbezogenen Daten sehr ernst. Sie haben das Recht zu wissen, wann welche Daten erhoben werden und wie sie verwendet werden. Wir haben technische und organisatorische Maßnahmen getroffen, die sicherstellen, dass die Vorschriften über den Datenschutz sowohl von uns, als auch von unserem externen Dienstleister beachtet werden.
  2. Im Zuge der Weiterentwicklung dieser Webseiten und der Implementierung neuer Technologien können auch Änderungen dieser Datenschutzerklärung erforderlich werden. Daher wird empfohlen, sich diese Datenschutzerklärung ab und zu erneut durchzulesen.
  3. Auf bestimmten Seiten des Internetangebots kommen Cookies zum Einsatz, die bis zum Ende der Sitzung gültig sind. Die meisten Browser sind so eingestellt, dass sie Cookies automatisch akzeptieren und speichern. Sie können das Speichern von Cookies jedoch deaktivieren oder Ihren Browser so einstellen, dass Cookies nur für die Dauer der jeweiligen Verbindung zum Internet gespeichert werden.
  4. Das Online-Angebot kann Links zu Webseiten anderer Anbieter enthalten. Die Bundesnetzagentur hat keinen Einfluss darauf, dass diese Anbieter die Datenschutzbestimmungen einhalten.
  5. Die Bundesnetzagentur unterliegt den Bestimmungen des Bundesdatenschutzgesetzes (BDSG) und des Telemediengesetzes (TMG). Personenbezogene Daten werden unter strikter Wahrung dieser Bestimmungen verarbeitet. Insbesondere werden personenbezogene Daten nicht unbefugt an Dritte weitergegeben und nur für die der Bundesnetzagentur gesetzlich zugewiesenen Aufgaben verwendet.
Für weitere Informationen in Bezug auf die Behandlung von personenbezogenen Daten steht Ihnen der Datenschutzbeauftragte der Bundesnetzagentur zur Verfügung.


Sonstige Regelungen

Auf die vorliegenden Nutzungsbedingungen sowie das Verhältnis zwischen Ihnen und der Bundesnetzagentur findet ausschließlich deutsches Recht Anwendung.Die Bundesnetzagentur behält sich vor, die vorliegenden Nutzungsbedingungen jederzeit mit Wirkung für die Zukunft zu ändern.


Bildnachweise

Soweit nicht anders angegeben: ©Bundesnetzagentur


Copyright

©2017 Bundesnetzagentur für Elektrizität, Gas, Telekommunikation, Post und Eisenbahnen; Pressestelle

Die Inhalte des Internetauftritts stehen, soweit nicht anders gekennzeichnet, unter der Creative Commons Namensnennung-Keine Bearbeitung 3.0 Deutschland Lizenz.

Stand: 1.5.2017