Hinweise der MTS-K zur Nutzung des MDM und zur Meldung von Grund- und Preisdaten sowie Beschwerden (Stand: 28. Juni 2013)

Transkript

1 Hinweise der MTS-K zur Nutzung des MDM und zur Meldung von Grund- und Preisdaten sowie Beschwerden (Stand: 28. Juni 2013) Für die Übermittlung der Grund- und Preisdaten sowie der Beschwerden arbeitet die Markttransparenzstelle für Kraftstoffe (MTS-K) mit dem Mobilitäts Daten Marktplatz (MDM) der Bundesanstalt für Straßenwesen zusammen. Allgemeine Hinweise zur Nutzung des MDM finden sich auf der Internetseite des MDM unter: und hilfe.mdm-portal.de In diesem Dokument werden außerdem Hinweise zur Nutzung des MDM für die MTS-K gegeben. Ferner werden Einzelangaben der Grund- und Preisdaten konkretisiert. Dieses Dokument dient der laufenden Information der meldepflichtigen Unternehmen, der Preismelder und der Anbieter von Verbraucher-Informationsdiensten (im Folgenden: Nutzer des MDM). Es ist vorgesehen, das Dokument zu ergänzen, wenn sich weitere relevante Hinweise insbesondere durch Rückfragen von Nutzern ergeben. Hinweise zur Nutzung des MDM Für die Nutzung des MDM für die Zwecke der MTS-K ist einmalig ein Registrierungsprozess beim MDM zu durchlaufen ( Alle dafür erforderlichen Dokumente wie Handbücher und technische Spezifikationen des MDM sowie das Datenmodell und die Schemadateien für die MTS-K finden sich unter Außerdem sind von Meldepflichtigen und Preismeldern Publikationen zu Grund- und Preisdaten bzw. von Verbraucher-Informationsdiensten Publikationen zu Beschwerden anzulegen (siehe Abschnitt Anbindung an den MDM ). Für die Subskription dieser Publikationen sieht der MDM grundsätzlich die Beteiligung des Datengebers und des Datennehmers vor. Für die Grund- und Preisdaten wird eine Vereinfachung dieser Beteiligung angestrebt. Beschwerden werden nur von der MTS-K subskribiert. Im Rahmen des Registrierungsprozesses (MDM-Benutzerhandbuch Kap. 2.1) sind Angaben zum Nutzer des MDM (Organisationsname, Adresse, Ansprechpartner) zu machen. Einige dieser Angaben sind von anderen Nutzern des MDM einsehbar. Außerdem werden die von Meldepflichtigen und Preismeldern an den MDM übermittelten Grund- und Preisdaten direkt den von der MTS-K zugelassenen Anbietern von Verbraucher-Informationsdiensten zum Abruf bereitgestellt. Jede Meldung von Grundund Preisdaten kann also dem Datengeber zugeordnet werden. Falls ein Meldepflichtiger seine Identität bei der Meldung von Grund- und Preisdaten nicht offenlegen möchte (und sich seine Identität nicht ohnehin aus dem Namen oder der Marke seiner Tankstellen ergibt), kann sich der Meldepflichtige für die Übermittlung der Daten an den MDM auch anderer Organisationen bedienen, die dies als so genannte Preismelder für ihn tun. Diese Preismelder können beispielsweise externe Dienstleister oder Tochtergesellschaften sein. 1

2 Beispiel: Der Meldepflichtige Mustermann-Tank betreibt Tankstellen teilweise unter der Marke Mustermann-Tank sowie teilweise als weiße Tankstellen. Für die Meldung der Grund- und Preisdaten der unter Mustermann-Tank betriebenen Tankstellen registriert sich das Unternehmen selbst beim MDM. Für die weißen Tankstellen registriert sich die Tochtergesellschaft Weiß-Tank und nimmt die Aufgabe des Preismelders für das Unternehmen Mustermann-Tank wahr. Der MDM sieht keine persistente Speicherung der gemeldeten Grund- und Preisdaten sowie der Beschwerden vor. Deswegen ist es erforderlich, dass ein Nutzer des MDM immer eine vollständige Publikation übermittelt, wenn sich einzelne oder mehrere Angaben geändert haben, d.h. ein Meldepflichtiger oder ein Preismelder muss immer Informationen für alle in dieser Publikation zusammengefassten Tankstellen senden, auch wenn sich nur Angaben zu einer Tankstelle verändert haben. Insbesondere für Meldepflichtige oder Preismelder mit einer großen Anzahl an Tankstellen besteht auch die Möglichkeit, mehrere Publikationen anzulegen. Die einzelnen Publikationen können sich beispielsweise auf geographische Teile des Tankstellennetzes beziehen. Änderungen einzelner oder mehrerer Angaben erfordern dann nur die Übermittlung der vollständigen Publikation für die Tankstellen des betroffenen Teilnetzes. Die Markttransparenzstelle für Kraftstoffe behält sich zur Lastbegrenzung eine Beschränkung der Anzahl der Publikationen pro Meldepflichtigen oder Preismelder vor. Außerdem ist wegen der nicht-persistenten Speicherung der gemeldeten Grund- und Preisdaten mindestens eine Meldung von Grund- und Preisdaten pro Woche erforderlich. Anbindung an den MDM Für die Nutzung des MDM für die MTS-K liefern die Meldepflichtigen Ihre Daten über eine SOAP-Schnittstelle an den MDM. Diese Schnittstelle ist in der Technischen Schnittstellenbeschreibung des MDM in Kapitel "Publisher Push SOAP (DATEX II)" beschrieben. Daneben steht für die Datenabholung durch Verbraucher-Informationsdienste die SOAP-Schnittstelle gemäß Kapitel "SOAP-Client PULL (DATEX II)" sowie alternativ HTTPS gemäß Kapitel "HTTPS-Client PULL (DATEX II)" zur Verfügung. Für die Nutzung des MDM für die MTS-K ist die Anlage verschiedener Publikationen beim MDM erforderlich: o Publikation über Grunddaten o o Publikation über Preisdaten Publikation über Beschwerden Es können auch Publikationen angelegt werden, die nur vom Datengeber zu Testzwecken subskribiert werden. Da jeder dieser drei Publikationstypen ein anderes Datenschema referenziert, muss auch jeweils eine andere Schnittstellenspezifikation (WSDL) verwendet werden. 2

3 1. Anlegen einer Publikation (MDM-Benutzerhandbuch Kap ) a. Meldepflichtige bzw. Preismelder: Allgemein Name Beschreibung Gültig von Gültig bis Recherchierbar Vertragsfrei Gültigkeit Datenart Format Protokoll Anlieferungsmodus Aktualisierungsintervall Qualitätssicherung Geographischer Raum Bezeichnung Datei auswählen Referenzdateien Vertragsentwurf Dateischema URL Allgemein Name Beschreibung Gültig von Grunddaten Organisationsname (ggf. weitere Angabe, falls mehrere Publikationen pro Organisation) Grunddaten Organisationsname (ggf. weitere Detailinformation, falls mehrere Publikationen pro Organisation) (Datum wird automatisch generiert) Nein (Häkchen entfernen) Ja (Rahmenbedingungen vgl. 47k GWB und MTS-K-VO) (Häkchen setzen) MTS-K Grunddaten DATEX II SOAP PUSH_ON_OCCURENCE Ereignisbasiert Bundeskartellamt BKartA-georef.xml (siehe Anhang) /PetrolStationPublication.xsd Preisdaten Organisationsname (ggf. weitere Angabe, falls mehrere Publikationen pro Organisation) Preisdaten Organisationsname (ggf. weitere Detailinformation, falls mehrere Publikationen pro Organisation) (Datum wird automatisch generiert) 3

4 Gültig bis Recherchierbar Vertragsfrei Gültigkeit Datenart Format Protokoll Anlieferungsmodus Aktualisierungsintervall Qualitätssicherung Geographischer Raum Bezeichnung Datei auswählen Referenzdateien Vertragsentwurf Dateischema URL Nein (Häkchen entfernen) Ja (Rahmenbedingungen vgl. 47k GWB und MTS-K-VO) (Häkchen setzen) MTS-K Preisdaten DATEX II SOAP PUSH_ON_OCCURENCE Ereignisbasiert Bundeskartellamt BKartA-georef.xml (siehe Anhang) /FuelPricePublication.xsd b. Verbraucher-Informationsdienste: Allgemein Name Beschreibung Gültig von Gültig bis Recherchierbar Vertragsfrei Gültigkeit Datenart Format Protokoll Anlieferungsmodus Aktualisierungsintervall Qualitätssicherung Geographischer Raum Bezeichnung Datei auswählen Referenzdateien Beschwerden Organisationsname Beschwerden Organisationsname (Datum wird automatisch generiert) Nein (Häkchen entfernen) Ja (Rahmenbedingungen vgl. 47k GWB und MTS-K-VO) (Häkchen setzen) MTS-K Beschwerden DATEX II SOAP PUSH_ON_OCCURENCE Ereignisbasiert Bundeskartellamt BKartA-georef.xml (siehe Anhang) 4

5 Vertragsentwurf Dateischema URL /ComplaintPublication.xsd 2. Anpassung der WSDL-Dateien Die WSDL-Dateien (Push.wsdl und Pull.wsdl) sind in Version 2.1 unter abrufbar. Zurzeit steht dort jedoch nur nach Anmeldung bereits die Version 2.2 zur Verfügung, die auf das aktuellste DATEX-II-Schema referenziert. Beide Versionen sind nutzbar, da in den WSDL-Dateien unabhängig von der aktuellen DATEX-II-Version auf die MTS-K- Schemata (als Level-C-Erweiterung in DATEX II) verwiesen werden muss. Aufgrund der Verwendung einer DATEX II Level C-Erweiterung darf im MTS-K Schema, entsprechend der Regelungen durch den DATEX II-Standard, nicht der native DATEX II Level A Namensraum verwendet werden. Die DATEX II WSDL- Dateien sind also dementsprechend anzupassen, was weiter unten detailliert beschrieben wird. Die über abrufbare WSDL-Datei ist in diesem Sinne ebenfalls nicht zu verwenden. Für jede der unterschiedlichen Publikationen muss die WSDL-Datei angepasst werden: a. Datengeber (Push.wsdl) Für den Datengeber ist die Push.wsdl zu verwenden. Folgende Anpassungen sind entsprechend der Schemadatei und dem Datenmodell vorzunehmen: Da es sich um eine Level C-Erweiterung handelt, muss der xmlns:d2ns auf geändert werden. Beim Import der entsprechenden Schema-Datei (PetrolStationPublication.xsd / FuelPricePublication.xsd / ComplaintPublication.xsd) ist jeweils der targetnamespace auf zu setzen und die schemalocation individuell anzupassen. Die schemalocation ist im MDM-Portal abgelegt. Dafür ist die Detailansicht der zuvor angelegten Publikationen aufzurufen. Unter Dateischema ist die entsprechende URL einzusehen. Ebenso ist die soap:adress individuell anzupassen. Dazu ist für die location eine individuelle URL anzugeben. Diese finden sich ebenfalls in der Detailansicht der zuvor angelegten Publikation. Eine grundsätzlich angepasste Push.wsdl ist im Anhang beigefügt. Die verschiedenen URL-Angaben sind noch individuell anzupassen. b. Datennehmer (Pull.wsdl) Während für Datengeber die Verwendung des Push Modus obligatorisch ist, können Datennehmer zwischen diesem und dem Pull Modus wählen. Die Nutzung des Push 5

6 Modus erfolgt für Datennehmer auf eigene Verantwortung. Für die Pull.wsdl sind entsprechende Anpassungen vorzunehmen. Eine grundsätzlich angepasste Pull.wsdl ist im Anhang beigefügt. Die verschiedenen URL-Angaben sind noch individuell anzupassen. Hinweise zu den Meldungen Grunddaten Für jede einzelne Tankstelle muss vom Meldepflichtigen eine eindeutige Nummer in Form eines Globally Unique Identifier (GUID) erzeugt werden (vgl. Die Angabe der grundsätzlichen Öffnungszeiten erfolgt über die Grunddaten. Abweichende Öffnungszeiten (beispielsweise an Feiertagen) können in der Vorwoche über die Grunddaten oder aktuell über die Preisdaten übermittelt werden. Bei Änderungen der Grunddaten ist deren Übermittlung in der Vorwoche der Änderung erforderlich. Beispiel: Grunddaten, die nicht vor Sonntag, Uhr, der 30. KW übermittelt wurden, werden erst für die 32. KW berücksichtigt. Preisdaten Preise für die Kraftstoffsorten E5, E10 und Diesel ohne Rabatte in Euro (nicht Eurocent) mit drei Nachkommastellen getrennt durch einen Punkt ohne Angabe der Währung (Beispiel: 1.539). Pro Tankstelle und Sorte nur ein Preis (insbesondere bei Diesel der Preis für PKW-Diesel und nicht für LKW-Diesel). Änderungszeitpunkt: Zeitpunkt, ab dem der nächste Tankkunde den geänderten Preis zahlen müsste. Beispiel: Um Uhr erhält die Tankstelle die Information, dass um Uhr der Preis geändert werden soll. Um Uhr wir der Preis am Preismast geändert. Um Uhr wird der Preis im Kassensystem geändert und der geänderte Preis erfolgreich an die Zapfsäulen übermittelt. Änderungszeitpunkt: Uhr. Beispiel: Um Uhr erhält die Tankstelle die Information, dass um Uhr der Preis geändert werden soll. Um Uhr wir der Preis am Preismast geändert. Um Uhr wird der Preis im Kassensystem geändert und der geänderte Preis an die Zapfsäulen übermittelt. Da alle Zapfsäulen belegt sind, kann der geänderte Preis erst ab Uhr an den Zapfsäulen umgesetzt werden. Änderungszeitpunkt: Uhr (da ab Uhr der nächste Kunde den geänderten Preis zahlen muss). Anmerkung: Die Übermittlung des Änderungszeitpunkts ist zunächst freigestellt. Dies lässt jedoch die Verpflichtung zur Meldung von Preisänderungen innerhalb von fünf Minuten nach dem Änderungszeitpunkt unberührt. 6

7 Beschwerden Wöchentliche Gesamtmeldung aller bei einem Verbraucher-Informationsdienst eingegangenen Beschwerden zu Grund- und Preisdaten in einer Beschwerdedatei. Übermittlung der Gesamtmeldung jeden Montag für die Vorwoche (Beschwerdezeitraum Montag bis Sonntag der Vorwoche). Auch Fehlanzeigen (Leermeldungen) sind erforderlich. Beschwerdemeldungen werden nur von der MTS-K subskribiert. Technischer Ansprechpartner Koordinator für technische Fragen zur MTS-K bzw. Nutzung des MDM für die MTS-K: Leo Kulozik, Tel.: 0228/ , Mail: 7

8 Anhang Georeferenz Bundeskartellamt (BKartA-georef.xml) <mdm:georef xmlns:mdm=" xmlns:xsi=" xsi:schemalocation=" MDM-Georef.xsd"> <mdm:anchor lat=" " long=" "/> <mdm:polygon> </mdm:polygon> </mdm:georef> 8

9 Angepasste Datei: Push.wsdl <?xml version="1.0" encoding="utf-8"?> <definitions xmlns=" xmlns:soap=" xmlns:soapbind=" xmlns:http=" xmlns:xs=" xmlns:mime=" xmlns:tns=" xmlns:d2ns=" name="supplierpush" targetnamespace=" <documentation> Version May 2012 This document describes the DATEX II Push Service with WSDL 1.1 This wsdl document is the reference with which each DATEX II Push Web Service has to be built Refer </documentation> <types> <xs:schema targetnamespace=" <xs:import namespace=" schemalocation=" <!-- Die "schemalocation" MUSS INDIVIDUELL ANGEPASST werden auf das zur Publikation passende Schema (PetrolStationPublication.xsd, FuelPricePublication.xsd, ComplaintPublication.xsd). Die einzutragende URL findet sich auf dem MDM in den Details zu einer Publikation unter "Dateischema" - "URL" --> </xs:schema> </types> <message name="suppliermessage"> <part name="body" element="d2ns:d2logicalmodel"/> </message> <message name="outputmessage"> <part name="body" element="d2ns:d2logicalmodel"/> </message> <porttype name="supplierpushinterface"> <operation name="putdatex2data"> <input message="tns:suppliermessage"/> <output message="tns:outputmessage"/> </operation> </porttype> <binding name="supplierpushsoapbinding" type="tns:supplierpushinterface"> <soap:binding style="document" transport=" <operation name="putdatex2data"> <soap:operation soapaction=" style="document"/> <input> <soapbind:body parts="body" use="literal"/> </input> <output> <soapbind:body use="literal"/> </output> </operation> </binding> <service name="supplierpushservice"> 9

10 <port name="supplierpushsoapendpoint" binding="tns:supplierpushsoapbinding"> <soap:address location=" <!-- Die "location" MUSS INDIVIDUELL ANGEPASST werden auf den zur Publikation gehörenden Endpunkt. Die einzutragende URL (die auch die Publikations-ID enthält) findet sich auf dem MDM in den Details zu einer Publikation unter "URL" --> </port> </service> </definitions> 10

11 Angepasste Datei: Pull.wsdl <?xml version="1.0" encoding="utf-8"?> <definitions xmlns=" xmlns:soap=" xmlns:soapbind=" xmlns:http=" xmlns:xs=" xmlns:mime=" xmlns:tns=" xmlns:d2ns=" name="clientpull" targetnamespace=" <documentation> Version May 2013 This document describes the DATEX II Pull Service with WSDL 1.1 This wsdl document is the reference with which each DATEX II Web Service has to be built Refer </documentation> <types> <xs:schema targetnamespace=" <xs:import namespace=" schemalocation=" <!-- Die "schemalocation" MUSS INDIVIDUELL ANGEPASST werden auf das zur Publikation passende Schema (PetrolStationPublication.xsd, FuelPricePublication.xsd, ComplaintPublication.xsd). Die einzutragende URL findet sich auf dem MDM in den Details zu einer Publikation unter "Dateischema" - "URL" --> </xs:schema> </types> <message name="inputmessage"/> <message name="exchangemessage"> <part name="body" element="d2ns:d2logicalmodel"/> </message> <porttype name="clientpullinterface"> <operation name="getdatex2data"> <input message="tns:inputmessage"/> <!-- This version of the DATEX II Pull service doesn't use any input message but its declaration is here mandatory for a few Web Service frameworks--> <output message="tns:exchangemessage"/> </operation> </porttype> <binding name="clientpullsoapbinding" type="tns:clientpullinterface"> <soap:binding style="document" transport=" <operation name="getdatex2data"> <soap:operation soapaction=" style="document"/> <input> <soapbind:body use="literal"/> </input> <output> <soapbind:body parts="body" use="literal"/> </output> </operation> </binding> <service name="clientpullservice"> 11

12 <port name="clientpullsoapendpoint" binding="tns:clientpullsoapbinding"> <soap:address location=" <!-- Die "location" MUSS INDIVIDUELL ANGEPASST werden auf den zur Subskription gehörenden Endpunkt. Die einzutragende URL wird beim Anlegen einer Subskription mitgeteilt bzw. findet sich auch auf dem MDM in den Details zu einer Subskription --> </port> </service> <!-- This version of the DATEX II Pull service doesn't use any input message but its declaration is here mandatory for a few Web Service frameworks--> </definitions> 12