E Anlage 24 EFM_Anh 1_vHGS_PH05-A1_RMV-EFS_v1.6_190415_MVU 200122.pdf

[Seite 1]

Anlage 24 Anhang 1

vHGS eTicket RheinMain

Pflichtenheft

PH 05 Systemspezifikation

Anhang 1: RMV-EFS

Erstellt für

Version: 1.6 Datum: 15.04.2019 Dok-Ref.: PH 05-A1 Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx

[Seite 2]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Versionshistorie

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 1 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 3]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Verteiler

Hinweis zum Urheberrecht

Copyright von Cubic Transportation Systems (Deutschland) GmbH 2010 - 2019. Alle Rechte vorbehalten.

Das Urheberrecht an dieser Arbeit ist Eigentum von Cubic Transportation Systems (Deutschland) GmbH.

Vertraulichkeitsvermerk

Diese Arbeit wurde für das Projekt vHGS des RMV für die rms im Rahmen des eTicket RheinMain ver- fasst und vorgelegt. Alle Inhalte sind vertraulich zu behandeln.

Diese Arbeit unterliegt den zwischen rms und Cubic vereinbarten Nutzungsregelungen gem. §3 und der Vertraulichkeitsregelungen gem. §19 (2) des „Vertrages für ein verbundweites mandantenfähiges Hinter- grundsystem eTicket RheinMain (vHGS)“ vom 07.10.2009.

Über den vertraglich zugelassenen Umfang hinaus darf diese Arbeit ohne die vorherige schriftliche Zu- stimmung von Cubic Transportation Systems (Deutschland) GmbH (weder vollständig noch in Auszügen) verändert, vervielfältigt, veröffentlicht oder an Dritte weitergegeben oder für andere Zwecke, als für jene, für die sie vorgelegt wurde, verwendet werden.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 2 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 4]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Inhalt

1 Grundlagen ........................................................................................................................ 5 2 Datenstrukturen zum RMV EFS ........................................................................................ 7 2.1 Berechtigung ................................................................................................................ 7 2.2 Transaktionstypspezifische Daten .............................................................................. 13 2.2.1 Ausgabetransaktion ............................................................................................ 13 2.2.2 Rückgabetransaktion........................................................................................... 13 2.2.3 Fahrttransaktion .................................................................................................. 14 2.2.4 Sperrtransaktion .................................................................................................. 15 3 Basisobjekt BerechtigungTarifbereichZusatz ............................................................... 16 4 Hinweise zur Verwendung der Attribute ........................................................................ 18 4.1 Produkt-ID und RMV-Sortenschlüssel ........................................................................ 18 4.2 KVP-Agentur: KVP-Schlüssel, Berechtigung-ID, Vertriebspartner-ID und Transaktionsoperator-ID ....................................................................................................... 18 4.3 DL-Agentur: DL-Schlüssel und Transaktionsoperator-ID ............................................ 18 4.4 Allgemeine Transaktionsdaten ................................................................................... 19 4.4.1 logTransaktionsOperator_ID ............................................................................... 19 4.4.2 logTerminal_ID .................................................................................................... 19 4.4.3 logTransaktionsOrt_ID ........................................................................................ 20 4.4.4 logTransaktionsTyp ............................................................................................. 21 5 RMV-Verkaufsdatenmeldung .......................................................................................... 23 5.1 Einleitung ................................................................................................................... 23 5.2 Stammdatenpflege im vHGS ...................................................................................... 23 5.3 Abbildung auf die RMV-Verkaufsdatenmeldung ......................................................... 25 5.4 Besonderheiten der Vertriebskanäle .......................................................................... 29 5.4.1 Personalbediente Verkaufsstelle ......................................................................... 29 5.4.2 Stationäre Verkaufsautomaten ............................................................................ 29 5.4.3 Mobile Verkaufsgeräte ........................................................................................ 30 5.4.4 eOnline Ticketserver und Handy Ticketserver ..................................................... 30 5.4.5 Webshop ............................................................................................................. 31 5.4.6 Aktionsmanagement ........................................................................................... 31 5.4.7 Vertragsprodukte (Abonnements, …) .................................................................. 32 5.4.8 Massenpersonalisierer ........................................................................................ 32 6 KA Spezifikation .............................................................................................................. 34 6.1 Abstimmung mit dem Standardisierungsprozess ........................................................ 34

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 3 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 5]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

6.2 Ergänzungen zum KA Baukasten „Produktspezifische Attribute/Berechtigung Tarifbereich“ ......................................................................................................................... 34 6.3 Ergänzungen zu den KA Codelisten ........................................................................... 37 6.3.1 Ergänzungen zu TerminalTyp_CODE ................................................................. 37 6.3.2 Ergänzungen zu OrtsTyp_CODE ........................................................................ 38 6.3.3 Ergänzungen zu BezahlArt_CODE ...................................................................... 38

Referenzen

[KA_SPEC_BOM] Hauptdokument mit Basisobjektmodell (BOM) VDV KA KG, Version 1.3.0, Juni 2014 [KA_SPEC_NM] Spezifikation Nutzermedium VDV KA KG, Version Version 1.3.0, Juni 2014 [RMV_DATHB] Anlage 17, RMV-Datenhandbuch, Datenlieferungen und –strukturen für die Partner des RMV RMV, Version 3.38.40, 29.08.2017

Hinweis zur verwendeten KA Spezifikation: Die KA Version 1.3.0 ist die im eTicket RheinMain angewendete KA Version.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 4 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 6]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

1 Grundlagen

Die nachfolgende Abbildung zeigt die allgemeine logische Struktur der Daten an der Schnittstel- le Nutzermedium-Terminal:

Abbildung 1: Datenstruktur KA-Nutzermedium

Die Datenstruktur für eine EFM-Berechtigung setzt sich zusammen aus:

• dem Eintrag im Applikationsverzeichnis, der sich wiederum zusammensetzt aus

− Verzeichniseintrag – systemspezifischer Teil Enthält einen Zeiger auf die separaten Daten der Berechtigung. Der Zeiger wird vom Terminal für den Datenzugriff verwendet.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 5 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 7]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

− Verzeichniseintrag – Berechtigung – Statischer Teil Enthält Identifikationsdaten (Berechtigung-ID, EFMProdukt-ID, …) und zeitliche Gültig- keit.

− Verzeichniseintrag – Berechtigung – Dynamischer Teil Enthält den Status und die Synchronnummer.

• den separaten Daten der Berechtigung, die sich wiederum zusammensetzen aus

− Separate Daten – Berechtigung – statischer Teil Enthält produktspezifische Attribute zur tariflichen Beschreibung der Berechtigung (z.B. räumliche Gültigkeit, Fahrgasttyp, …).

− Separate Daten – Berechtigung – dynamischer Teil (Transaktionsdaten) Der dynamische Teil beinhaltet den letzten, für die Berechtigung durchgeführten, Transaktionsdatensatz. Der Transaktionsdatensatz enthält produktspezifische Attribute, insbesondere auch die so genannten Nutzertarifparameter.

− Separate Daten – Berechtigung – Schlüsselversionen Bezeichnet die für die MAC-Sicherung der Transaktionen verwendeten Schlüsselversi- onen.

− Separate Daten – Berechtigung – Ausgabetransaktionskennung Enthält die Nm-Transaktion-ID der Ausgabetransaktion der Berechtigung. Die separaten Daten der Berechtigung enthalten produktspezifische Attribute. D.h. die Län- ge der Datenstrukturen ist variabel und der Inhalt ist produktspezifisch. Die KA-Spezifikation bietet einen Baukasten typischer Attribute und mit dem Referenz-EFS, Referenz-WEB, usw. auch Beispiele, wie sich typische Produkte abbilden lassen.

• dem Infotext Enthält eine statische Kurzbeschreibung der Berechtigung in lesbarer Form.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 6 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 8]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

2 Datenstrukturen zum RMV EFS

Die nachfolgenden Tabellen zeigen die Datenstrukturen zum RMV-EFS. Die Zeilen der Tabellen sind dabei wie folgt farblich hinterlegt:

2.1 Berechtigung Die nachfolgende Datenstruktur zeigt die komplette Datenstruktur „Berechtigung“ für den RMV EFS beginnend mit dem „Verzeichniseintrag“ und endend mit dem „Infotext“.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 7 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 9]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 8 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 10]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

1 RMV Tarifzonen werden als KA Ort_ID kodiert mit OrtDomaene_ID = Org-ID des RMV, OrtTyp =16, OrtNummer = Tarifgebietsnummer.

2 RMV Haltestellen werden als KA Ort_ID kodiert mit OrtDomaene_ID = Org-ID des RMV, OrtTyp =200, OrtNummer = Infopool-Haltestellennummer.

3 Sogenannte Druckpreisstufe

4 Sogenannter Drucksortenschlüssel

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 9 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 11]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

5 Im Rahmen der eTicket RheinMain KVP-Agentur verwenden die Vertriebspartner (Verkehrsunterneh- men, ggf. LNO) einen gemeinsamen KVP-Schlüssel und daher eine gemeinsame kvp_ID in der berBe- rechtigung_ID. Im Attribut berVertriebspartner_ID wird die Identität des im Rahmen der KVP-Agentur handelnden Vertriebspartners dauerhaft dokumentiert.

6 Werte für POB/PEB und Werteinheiten werden relevant, wenn derartige Produkte als Bezahlberechti- gungen eingeführt werden. Eine Differenzierung nach Kreditkartenanbietern (Master, Visa, …) wird bis auf weiteres nicht genutzt.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 10 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 12]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

7 Bezeichnung vereinheitlicht (mit Unterstrich vor ‚ID‘).

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 11 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 13]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

8 In den Kommandobeschreibungen für das Nutzermedium und für das SAM wird dieser MAC als MAC TR bezeichnet, vgl. Abschnitt 3.6.3 in [KA_SPEC_NM].

9 Die Länge des Infotextes wird nur für die Berechtigungen mit variabler Länge benutzt. Er ist bei der Ausgabe der Applikation, der Kundendaten und des WES durch das Terminal mit "blanks" (ASCII printab- le text) zu füllen, wenn keine explizit anderen Informationen eingetragen werden.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 12 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 14]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Tabelle 1: Datenstruktur Berechtigung RMV-EFS

2.2 Transaktionstypspezifische Daten Folgende Nutzermedium-Terminal-Transaktionstypen sind in der KA Spezifikation für Berechti- gungen vom Typ EFS definiert.

• Ausgabetransaktion

• Rückgabetransaktion

• Fahrttransaktion (für EFS: Entwertung, Kontrolle)

• Sperrtransaktion (Sperren und Entsperren) Die transaktionstypspezifischen Daten sind durch die KA Spezifikation vorgegeben. Anmerkung: Es gibt gemäß KA Spezifikation keine produktspezifischen Daten pro Transaktions- typ sondern nur eine Datenstruktur „Transaktion Produktspezifischer Teil“, die für alle Transak- tionstypen gleich ist. Der RMV-EFS verwendet keine produktspezifischen Transaktionsdaten, die Datenstruktur „Transaktion Produktspezifischer Teil“ ist immer leer.

2.2.1 Ausgabetransaktion Siehe Tabelle 1: Datenstruktur Berechtigung RMV-EFS, Teilstruktur „Struktur Separate Daten – Berechtigung RMV EFS – Dynamischer Teil“ mit den darin enthaltenen Strukturen „Allgemeine Transaktionsdaten“, „Transaktion Produktspezifischer Teil“, „Ausgabe Berechtigung Daten“ und „Statusaenderung – Berechtigung“.

2.2.2 Rückgabetransaktion

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 13 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 15]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Tabelle 2: Rückgabetransaktion Berechtigung RMV-EFS

2.2.3 Fahrttransaktion

Tabelle 3: Fahrttransaktion Berechtigung RMV-EFS

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 14 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 16]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Tabelle 4: Allgemeine Fahrttransaktionsdaten

2.2.4 Sperrtransaktion

Tabelle 5: Sperrtransaktion – Berechtigung

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 15 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 17]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

3 Basisobjekt BerechtigungTarifbereichZusatz

Zur Übermittlung zusätzlicher, die Berechtigungsausgabe betreffender Daten, die jedoch nicht in dem EFS auf dem Nutzermedium gespeichert werden, stellt die KA Spezifikation das Basis- objekt BerechtigungTarifbereichZusatz bereit, das im TXABER sowie im TXAAUFBER verwen- det wird. Der BerechtigungTarifbereichZusatz wird als ein ‚hexBinary‘ in das entsprechende Attribut der XML-Struktur des TXABER eingetragen. Der Inhalt (die in dem hexBinary enthaltenen Daten- elemente) ist gemäß KA Spezifikation produktspezifisch, im RMV wird für alle RMV-EFS der gleiche BerechtigungTarifbereichZusatz verwendet. Die nachfolgende Tabelle zeigt den Inhalt (die in dem hexBinary enthaltenen Datenelemente) des BerechtigungTarifbereichZusatz für den RMV-EFS.

10 Für den Sonderfall, dass mit einem Fahrzeug unter einer öffentlichen Linienbezeichnung mehr als ein Streckenabschnitt befahren wird, die unterschiedlichen Linienbündel zuzuordnen sind, sind diese Stre- ckenabschnitte jeweils über unterschiedliche Linienobjekte (Linie_ID) zu kennzeichnen.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 16 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 18]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Tabelle 6: Datenstruktur BerechtigungTarifbereichZusatz für RMV-EFS

In der XML-Datenstruktur ist das Attribut berechtigungTarifbereichZusatz im TXABER und im TXAAUFBER als „nillable“ (=“true“) deklariert. Dazu wird folgendes festgelegt:

• In einem aus der Ausgabe eines RMV-EFS resultierenden TXABER ist das Attribut berech- tigungTarifbereichZusatz immer mit der oben spezifizierten Datenstruktur gefüllt, unter Be- achtung der Vorgaben in der Spalte „Anmerkung“ zur Zulässigkeit von ‚0‘-Werten.

• In einem Aktionsauftrag TXAAUFBER zur Ausgabe eines RMV-EFS ist das Attribut berech- tigungTarifbereichZusatz nie mit der oben spezifizierten Datenstruktur gefüllt.

• In einem aus der Ausführung eines Aktionsauftrages resultierenden TXABER können mit Ausnahme des Attributes appInstanz_ID alle Attribute des Basisobjektes BerechtigungTarif- bereichZusatz mit ‚0‘ gefüllt sein.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 17 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 19]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

4 Hinweise zur Verwendung der Attribute

4.1 Produkt-ID und RMV-Sortenschlüssel Die Produkt-IDs werden vom PV, d.h. dem RMV, festgelegt. Die Vergabe von Produkt-IDs orientiert sich an den Erfordernissen des eTicket-Systems. Die Produkt-ID wird bei der Berechtigungsausgabe in das Attribut prodProdukt_ID (in der Struk- tur „Verzeichniseintrag – Berechtigung – Statischer Teil“) eingetragen. Der für das RMV-Tarifmodul, das RMV-Kontrollmodul und für Abrechnungs- und Statistikpro- zesse maßgebliche RMV-Sortenschlüssel wird bei der Berechtigungsausgabe in das Attribut efsSortenschluessel (in der Struktur „Separate Daten – Berechtigung RMV EFS – Statischer produktspezifischer Teil“) eingetragen.

4.2 KVP-Agentur: KVP-Schlüssel, Berechtigung-ID, Vertriebspartner-ID und Transaktionsoperator-ID Im Rahmen der eTicket RheinMain KVP-Agentur verwenden die Vertriebspartner (Verkehrsun- ternehmen, ggf. LNO) eine gemeinsame KVP-Schlüsselkonfiguration, die über die Org-ID der KVP-Agentur referenziert wird. Als Org-ID der KVP-Agentur wird die Org-ID des RMV verwendet. Die Org-ID der KVP-Agentur wird bei der Berechtigungsausgabe als kvp_ID in die Berechti- gung_ID eingetragen. Die Berechtigung_ID wird im Attribut berBerechtigung_ID (in der Struktur „Verzeichniseintrag – Berechtigung – Statischer Teil“) eingetragen. Im Attribut berVertriebspartner_ID (in der Struktur „Separate Daten – Berechtigung RMV EFS – Statischer produktspezifischer Teil“) wird die Org-ID des im Rahmen der KVP-Agentur handeln- den Vertriebspartners eingetragen. Im Attribut logTransaktionsOperator_ID (Struktur „Allgemeine Transaktionsdaten“) der jeweili- gen KVP-Transaktion (Ausgabetransaktion, Rückgabetransaktion, Sperrtransaktion) wird die Org-ID des jeweils im Rahmen der KVP-Agentur handelnden Vertriebspartners eingetragen. Das in der Struktur „Statusaenderung – Berechtigung“ enthaltene Attribut berBerechtigung_ID wird mit dem Wert aus dem gleichnamigen Attribut der Struktur „Verzeichniseintrag – Berechti- gung – Statischer Teil“ gefüllt.

4.3 DL-Agentur: DL-Schlüssel und Transaktionsoperator-ID Im Rahmen der eTicket RheinMain DL-Agentur verwenden die Partner (Verkehrsunternehmen, ggf. LNO) eine gemeinsame DL-Schlüsselkonfiguration, die über die Org-ID der DL-Agentur referenziert wird. Als Org-ID der DL-Agentur wird die Org-ID des RMV verwendet. Im Attribut logTransaktionsOperator_ID (Struktur „Allgemeine Transaktionsdaten“) der jeweili- gen DL-Transaktion (Fahrttransaktion, Sperrtransaktion) wird die Org-ID des im Rahmen der DL-Agentur handelnden Partners eingetragen.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 18 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 20]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Das in der Struktur „Statusaenderung – Berechtigung“ enthaltene Attribut berBerechtigung_ID wird mit dem Wert aus dem gleichnamigen Attribut der Struktur „Verzeichniseintrag – Berechti- gung – Statischer Teil“ gefüllt.

4.4 Allgemeine Transaktionsdaten

4.4.1 logTransaktionsOperator_ID Im Attribut logTransaktionsOperator_ID wird die Org-ID des jeweils handelnden RMV-Partners eingetragen. Vgl. Abschnitt 4.2 und 4.3. Dies ist insbesondere auch von einem Massenpersonalisierer zu beachten, der im Auftrag der RMV-Partner Chipkarten ausfertigt.

4.4.2 logTerminal_ID Im Attribut logTerminal_ID wird eine Terminal_ID eingetragen, die sich aus terminalOwner_ID, terminalTyp und terminalNummer zusammensetzt. Als terminalOwner_ID ist die jeweilige Org-ID des Verkehrsunternehmens einzusetzen. Das Verkehrsunternehmen ist damit auch verantwortlich für die Pflege der Terminal_IDs für seine Terminals, d.h. insbesondere auch die Vergabe eindeutiger Terminalnummern. Relevante Terminaltypcodes sind 11: 2 = Verkaufsautomat12 3 = Kontrollterminal (mobil, personalbedient) 6 = Einstiegskontrollgerät/Entwerter 13 = Terminal beim Massenpersonalisierer 14 = Terminal in Vertriebs- oder Servicestelle (personalbedient) 15 = Fahrerterminal (Verkauf und Kontrolle) 16 = Handy Ticketserver 17 = eOnline Ticketserver 18 = Verkaufsautomat mobil (kundenbedient) 19 = Verkaufs- und Kontrollterminal mobil (personalbedient) Die Terminaltypcodes haben Auswirkungen auf die Auswertung der von den Terminals geliefer- ten Daten über Berechtigungsausgaben, insbesondere die Aufbereitung dieser Daten für die RMV-Verkaufsdatenmeldung.

11 Die Codewerte 17, 18 und 19 sind neu vorgeschlagene Codewerte, die in den KA-Standard aufge- nommen werden sollen.

12 Im eTicket RheinMain wird dieser Terminaltyp für stationäre (kundenbediente) Verkaufsautomaten verwendet. Für mobile (kundenbediente) Verkaufsautomaten soll der neue Codewert 18 verwendet wer- den. Mobile Verkaufsautomaten sind insbesondere solche, die in Fahrzeugen montiert sind. Stationäre Verkaufsautomaten sind insbesondere solche, die an Haltestellen aufgestellt sind.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 19 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 21]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

4.4.3 logTransaktionsOrt_ID Im Attribut logTransaktionsOrt_ID wird eine Ort_ID eingetragen, die sich aus OrtDomaene_ID, OrtTyp und OrtNummer zusammensetzt. Die zu verwendende Form der Ort_ID ist abhängig von der Art des Terminals. Personalbediente Verkaufsstelle (pVks) online am vHGS oder mit Offline-Verkaufsgerät, d.h. TerminalTyp = 14 (Terminal in Vertriebs- oder Servicestelle (personalbedient)): Personalbediente Verkaufsstellen sind häufig (aber nicht immer) an/in einer Haltestelle an- gesiedelt. Andererseits gibt es auch personalbediente Verkaufsstellen, die abseits einer Hal- testelle angesiedelt sind. Personalbediente Verkaufsstellen an Haltestellen verwenden: OrtTyp = 200 (Haltestelle) OrtDomaene_ID = Org-ID des RMV OrtNummer = Infopool-Haltestellennummer Personalbediente Verkaufsstellen abseits von Haltestellen verwenden: OrtTyp = 11 (Verkaufsstelle) OrtDomaene_ID = Org-ID des Verkehrsunternehmens OrtNummer = vom Verkehrsunternehmen vergebene Nummer Hinweis: Zur Erzeugung der RMV-Verkaufsdatenmeldung ist in der Stammdatenverwaltung des vHGS zu den personalbedienten Verkaufsstellen der Amtliche Gemeindeschlüssel (AGS) zu konfigurieren. Terminals in Fahrzeugen, d.h. TerminalTyp = 6 (Einstiegskontrollgerät/Entwerter) oder 15 (Fah- rerterminal (Verkauf und Kontrolle)) oder 18 (Verkaufsautomat mobil (kundenbedient)): OrtTyp = 213 (im Fahrzeug der Haltestelle)13 OrtDomaene_ID = Org-ID des RMV OrtNummer = Infopool-Haltestellennummer14 Mobile personalbediente Kontroll-/Verkaufsgeräte, d.h. TerminalTyp = 3 (Kontrollterminal mobil, personalbedient) oder 19 (Verkaufs- und Kontrollterminal mobil (personalbedient)): OrtTyp = 213 (im Fahrzeug der Haltestelle) OrtDomaene_ID = Org-ID des RMV OrtNummer = Infopool-Haltestellennummer14 Ausnahme: Einsatz des Geräts außerhalb des Fahrzeugs an einer Haltestelle (z.B. Kontrolle am Bahnsteig). Dann Verwendung des OrtTyp = 200 (Haltestelle). Stationäre Verkaufsautomaten, d.h. TerminalTyp = 2 (Verkaufsautomat): OrtTyp = 200 (Haltestelle)

13 Der Codewert 213 ist ein neu vorgeschlagener Codewert, der in den KA-Standard aufgenommen wer- den soll.

14 Kann das Gerät (in Verbindung mit dem OrtTyp=213) die Infopool-Haltestellennummer des aktuellen Standortes nicht ermitteln, muss vom Gerät stattdessen für das Attribut OrtNummer der Wert „0“ einge- tragen werden. Die Verwendung des ‚0‘-Werts stellt lediglich eine technische Rückfallebene dar. Im Re- gelfall muss die Infopool-Haltestellennummer geliefert werden.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 20 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 22]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

OrtDomaene_ID = Org-ID des RMV OrtNummer = Infopool-Haltestellennummer Sonderfall: Ein Verkaufsautomat kann auch abseits einer Haltestelle aufgestellt sein. Für diesen Fall wird von dem Terminal OrtTyp = 11 (Verkaufsstelle) OrtDomaene_ID = Org-ID des Verkehrsunternehmens OrtNummer = vom Verkehrsunternehmen vergebene Nummer verwendet. Zur Erzeugung der RMV-Verkaufsdatenmeldung ist in der Stammdatenverwal- tung des vHGS zu dieser Verkaufsstelle zusätzlich der Amtliche Gemeindeschlüssel (AGS) zu konfigurieren. Massenpersonalisierer, d.h. TerminalTyp = 13 (Terminal beim Massenpersonalisierer): OrtTyp = 201 OrtDomaene_ID = Org-ID des Massenpersonalisierers OrtNummer = Vergabe durch Massenpersonalisierer Aktionsmanagement: Bei Ausführung des Aktionsauftrags: logTransaktionsOrt_ID des Terminals, das die Aktion ausführt. Ticketserver, d.h. TerminalTyp = 16 (Handy Ticketserver) oder 17 (eOnline Ticketserver): OrtTyp = 21515 (Ticketserver) OrtDomaene_ID = Org-ID des Verkehrsunternehmens OrtNummer = vom Verkehrsunternehmen vergebene Nummer Ticketserver werden als zentrale Vertriebsinfrastruktur des jeweiligen Verkehrsunterneh- mens behandelt. Dies gilt im Sinne des mandantenfähigen Systems vHGS auch dann, wenn es sich physisch um den gleichen Server handelt. Anmerkung: Da der Ticketserver als „zentrale Vertriebsinfrastruktur“ betrachtet wird, wird in der Verkaufsdatenmeldung des RMV kein AGS erwartet. Die „OrtTyp“-Codes haben Auswirkungen auf die Auswertung der von den Terminals gelieferten Daten über Berechtigungsausgaben, insbesondere bei der Aufbereitung dieser Daten für die RMV-Verkaufsdatenmeldung.

4.4.4 logTransaktionsTyp Relevante Transaktionstypcodes sind: 1 = Ausgabetransaktion 2 = Entwertung als Option für Fahrkarten, die eine Entwertung vor bzw. während der Fahrt benötigen 20 = Sperrtransaktion 21 = Entsperrtransaktion

15 Der Codewert 215 ist ein neu vorgeschlagener Codewert, der in den KA-Standard aufgenommen wer- den soll.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 21 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 23]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

25 = Rückgabetransaktion 27 = Kontrolle 37 = Ausgabe EFS über Aktionsliste 38 = Entsperrtransaktion EFS über Aktionsliste 39 = Rückgabetransaktion EFS über Aktionsliste

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 22 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 24]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

5 RMV-Verkaufsdatenmeldung

5.1 Einleitung Die im Zusammenhang mit der Berechtigungsausgabe erzeugten Daten müssen die folgenden Informationsbedürfnisse befriedigen:

• Tarifparameter der Fahrkarte, insbesondere im Hinblick auf die (automatisierte) Kontrolle

• Verkaufsvorgang (wer, wo, wann)

• RMV-Verkaufsdatenmeldung. Grundsätzlich (im Sinne einer Richtlinie) wurde bei der Festlegung der Datenelemente dabei wie folgt vorgegangen: Tarifparameter werden in dem statischen Teil der Berechtigung (Struktur „Verzeichniseintrag – Berechtigung – Statischer Teil“) auf dem Nutzermedium gespeichert. Für Vorgangsinformationen werden die (standardisierten) Attribute der Transaktionsdaten der Be- rechtigung auf dem Nutzermedium herangezogen. Zusätzliche Informationen für die RMV- Verkaufsmeldung werden durch den BerechtigungTarifbereichZusatz bereitgestellt. Die Zuordnung des Verkaufsdatensatzes zu einer Abrechnungskennung und ggf. einem Loka- len Linienbündel erfolgt im Hintergrundsystem, gestützt auf dort gepflegte Stammdaten. Ebenso erfolgt die ggf. erforderliche Angabe eines AGS im Hintergrundsystem, gestützt auf dort ge- pflegte Stammdaten.

5.2 Stammdatenpflege im vHGS Folgende Stammdaten sind im vHGS von der übergeordneten fachlichen Betriebsführung zu pflegen:

• Unternehmen (KA Org_ID, RMV Unternehmenskennung) • RMV Verkaufstechnik-IDs mit Zuordnung zu KA Terminaltypcodes.16

• RMV Sortenschlüssel und Gattungsart der als eTicket angebotenen Tarifprodukte des RMV17 Folgende Stammdaten sind im vHGS vom jeweiligen RMV-Vertriebspartner zu pflegen.

• Linienbündel (RMV Linienbündelbezeichnung, Typ regional/lokal, Abrechnungskennung). Die zu verwendenden Linienbündel und Abrechnungskennungen sind (bzw. werden) vom Verkehrsunternehmen mit dem RMV/LNO abgestimmt. Neben den „realen“ Linienbündeln können dies ggf. auch „virtuelle“ Linienbündel sein.

16 Im Falle des KA Terminaltypcodes 14 ist der KA Terminaltypcode zwei möglichen RMV Verkaufstech- nik-IDs zugeordnet.

17 In Anbetracht der zunächst (Systemstart) überschaubaren Anzahl von Tarifprodukten, die als eTicket vertrieben werden, wird im vHGS lediglich ein GUI zur Eingabe dieser Daten realisiert. Mit der Einführung zusätzlicher Produktgruppen soll diese ggf. durch eine Importfunktion ergänzt werden. Die Details (Da- tenformat, Schnittstellentechnologie) sind im Zusammenhang mit der Beauftragung einer derartigen Sys- temerweiterung mit dem RMV abzustimmen.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 23 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 25]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Virtuelle Linien und Linienbündel können zur Zuordnung von Verkäufen/Einnahmen ver- wendet werden, für die der Bezug zu einer realen Linie (einer von den Fahrzeugen des Ver- kehrsunternehmens bedienten Haltestellenfolge) nicht gegeben ist. Dies ist insbesondere bei Verkäufen/Einnahmen aus Vertragsprodukten (Abonnements, CleverCard) sowie dem Vertrieb über Aktionsmanagement und Ticketserver („Webshop“) der Fall. Bei der Stammdatenkonfiguration für Verkaufs-/Servicestellen (pVks) und Webshops sollen immer virtuelle Linienbündel verwendet werden. Ein reales Linienbündel kann reale Linien und virtuelle Linien enthalten. Ein virtuelles Linienbündel kann nur virtuelle Linien enthalten. Eine reale Linie gehört immer zu einem realen Linienbündel. Wenn eine virtuelle Linie (bspw. bei Verkauf mit mobilem Gerät an einer Haltestelle, siehe auch Kap. 5.4.3) eindeutig einem realen Linienbündel zugeordnet werden kann, muss diese Zuordnung erfolgen. Wenn diese eindeutige Zuordnung nicht möglich ist, dann muss die vir- tuelle Linie einem virtuellen Linienbündel zugeordnet werden.

• Linien (KA Linie_ID, RMV- Linienbezeichnung, …), mit Zuordnung zu Linienbündel

• Terminals mit TerminalTyp 14 (Terminal in Vertriebs- oder Servicestelle, (personalbedient)): − Zuordnung zu RMV Verkaufstechnik-ID18

− Zuordnung zu Linienbündel

− Für Vertriebs-/Servicestellen, die den OrtTyp 200 (Haltestelle) verwenden: Ort mit OrtTyp 200

− Für Vertriebs-/Servicestellen, die den OrtTyp 11 (Verkaufsstelle) verwenden: Ort mit OrtTyp 11 sowie AGS • Terminals mit TerminalTyp 2 (Verkaufsautomat)19:

− Zuordnung zu Linienbündel

− Für Verkaufsautomaten, die den OrtTyp 200 (Haltestelle) verwenden: Ort mit OrtTyp 200

− Für Verkaufsautomaten, die den OrtTyp 11 (Verkaufsstelle) verwenden: Ort mit OrtTyp 11 sowie AGS

• Terminals mit TerminalTyp 16 (Handy Ticketserver) oder 17 (eOnline Ticketserver),

− Zuordnung zu Linienbündel − Ort mit OrtTyp 215 (Ticketserver)20

18 Der RMV unterscheidet (insbesondere vor dem Hintergrund der Datenversorgungsmöglichkeiten) zwi- schen Verkaufstechnik-ID 17 = „EFM Terminal in Vertriebs- oder Servicestelle“ und Verkaufstechnik-ID 19 = „EFM Busdrucker“. Anders als bei anderen KA Terminaltypcodes ergibt sich die RMV Verkaufstech- nik-ID nicht eindeutig aus einer zentral von der übergeordneten fachlichen Betriebsführung gepflegten eindeutigen Zuordnung zwischen KA Terminaltypcode und RMV Verkaufstechnik-ID.

19 stationär, kundenbedient

20 Der Codewert 215 ist ein neu vorgeschlagener Codewert, der in den KA-Standard aufgenommen wer- den soll.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 24 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 26]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Terminals, die Haltestelle und Linie liefern (Terminals in Fahrzeugen, mobile personalbediente Kontroll-/Verkaufsgeräte) müssen nicht im vHGS gepflegt werden. Haltestellen müssen im vHGS nur insoweit gepflegt werden, als sie für die Stammdatenkonfigu- ration der Terminaltypen 2 und 14 verwendet werden. Linienverläufe müssen nicht im vHGS gepflegt werden. Für den Sonderfall, dass unter einer öffentlichen Linienbezeichnung zwei (oder mehr) Stre- ckenabschnitte befahren werden, die verschiedenen Linienbündeln zugeordnet sind, wird dies über zwei (oder mehr) Linienobjekte abgebildet, die jeweils genau einem Linienbündel zugeord- net sind. In der Stammdatenverwaltung des Bordrechners/Verkaufsgeräts wird dafür gesorgt, dass „während der Fahrt“ von der einen Linie zur anderen Linie übergegangen wird, ohne dass sich der dem Fahrgast angezeigte Linienbezeichner verändert. Der Umschaltzeitpunkt kann richtungsabhängig sein, so dass die Haltestelle, an der sich die Linienbündel überlappen, ab- hängig von der Anfahrtrichtung dem einen oder dem anderen Linienbündel zugerechnet wird.

5.3 Abbildung auf die RMV-Verkaufsdatenmeldung Die nachfolgende Tabelle bezieht sich auf die Verkaufsdatenmeldung, wie sie in [RMV_DATHB] definiert ist. Abkürzungen:

• RMV-EFS = Datenstruktur „Berechtigung“ für den RMV-EFS einschließlich Ausgabetransak- tion, wie sie in Abschnitt 2.1 definiert ist.

• Zusatzdaten = Datenstruktur „BerechtigungTarifbereichZusatz“für den RMV-EFS, wie sie in Abschnitt 3 definiert ist. Die Abbildungsvorschriften sind gültig für den Verkauf von Fahrkarten mit unmittelbar anschlie- ßender Ausgabe der Berechtigung auf das Nutzermedium. Für Berechtigungsausgaben über das Aktionsmamagement oder Massenpersonalisierer sowie für Vertragsprodukte (Abonne- ments, CleverCard, …) gelten abweichende Regeln.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 25 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 27]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 26 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 28]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 27 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 29]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Fehlerbehandlung Wenn bei der Erstellung der Verkaufsdatensätze seitens des vHGS festgestellt wird, dass erfor- derliche Daten aus dem TXABER fehlen oder sich nicht korrekt über die Stammdatenverwal- tung ableiten lassen, werden diese in eine gesonderte Liste „Problem-Verkaufsdatenmeldung“ geschrieben und an die VU/Vertriebspartner geliefert, sodass eine klare Trennung und einfache Nachbearbeitung seitens des VU/Vertriebspartner erfolgen kann und nicht fehlerhaft an den RMV weitergeleitet wird.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 28 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 30]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Hinweis: Ggf. wird ein TXABER bereits beim Import in das vHGS abgewiesen. Insbesondere dann, wenn er nicht der KA Spezifikation entspricht oder für die Speicherung in der vHGS- Datenbank unverzichtbare Pflichtattribute nicht gefüllt bzw.mit fehlerhaften Werten gefüllt sind. Das sendende System erhält zu jedem abgewiesenen TXABER-Datensatz einen TXA- Datensatz. Die technische Betriebsführung des vHGS wird die Häufigkeit des Abweisens von Transaktionsdatensätzen (insbes. auch TXABER) beobachten und bei gehäuftem Auftreten die Ursachen näher untersuchen.

5.4 Besonderheiten der Vertriebskanäle

5.4.1 Personalbediente Verkaufsstelle In der RMV-Verkaufsdatenmeldung wird für Verkäufe personalbedienter Verkaufsstellen stets der AGS angegeben. Für Terminals vom Typ 14 (Terminal in Vertriebs- oder Servicestelle (per- sonalbedient)) muss daher in den Stammdaten des vHGS eine Zuordnung zu einem AGS hin- terlegt sein. Sofern die personalbediente Verkaufsstelle einer Haltestelle zugeordnet ist, er- scheint die Haltestellennummer im Attribut logTransaktionsOrt_ID und wird in das Feld Starthal- testelle der RMV-Verkaufsdatenmeldung übernommen.

5.4.1.1 Personalbediente Online-Verkaufsstelle Personalbediente „Online-Verkaufsstellen“ sind Verkaufsstellen mit Online-Verbindung zum vHGS (pVks im Sinne der Definition des vHGS-Lastenhefts). Für die Online-Verkaufsstelle ist keine lokale Konfiguration von Terminal_ID und Ort_ID erfor- derlich. Die Konfiguration erfolgt in der Stammdatenverwaltung des vHGS. Die Online-Verkaufsstelle ist nicht auf die Übermittlung ihrer Verkaufsdaten an das vHGS per TXABER angewiesen. Auch bei der Online-Verkaufsstelle wird durch die Nutzermedium- Terminal-Transaktion eine Datenstruktur „Berechtigung“ einschließlich Ausgabetransaktion er- zeugt. Die Daten des BerechtigungTarifbereichZusatz können direkt in die Datenbank eingetra- gen werden.

5.4.1.2 Personalbediente Offline-Verkaufsstellen Personalbediente „Offline-Verkaufsstellen“ sind Verkaufsstellen ohne Online-Verbindung zum vHGS (keine pVks im Sinne der Definition des vHGS-Lastenhefts). Offline-Verkaufsstellen kön- nen unterschiedliche technische Ausprägungen haben, vom „Busdrucker“ über autonome PC- Arbeitsplatzsysteme bis zu Arbeitsplatzsystemen, die online an ein HGS des Verkehrsunter- nehmens angeschlossen sind. Die Terminals der Offline-Verkaufsstellen müssen durch das Verkehrsunternehmen so konfigu- riert sein, dass sie in den Transaktionsdaten Terminal_IDs und Ort_IDs gemäß den Vorgaben in Abschnitt 4.4 liefern. Zusätzlich müssen die Terminals der Offline-Verkaufsstellen auch in den Stammdaten des vHGS konfiguriert werden.

5.4.2 Stationäre Verkaufsautomaten Stationäre Verkaufsautomaten sind im Regelfall an Haltestellen aufgestellt und liefern im Attri- but logTransaktionsOrt_ID die Haltestellennummer. Diese Haltestellennummer wird in das Feld Starthaltestelle der RMV-Verkaufsdatenmeldung übernommen. Als Sonderfall gibt es jedoch auch stationäre Verkaufsautomaten abseits von Haltestellen, die im Attribut logTransaktionsOrt_ID eine Verkaufsstellennummer liefern. Für diese Verkaufsauto-

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 29 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 31]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

maten muss in den Stammdaten des vHGS eine Zuordnung zu einem AGS hinterlegt sein. Die- ser AGS wird in der Verkaufsdatenmeldung eingetragen.

5.4.3 Mobile Verkaufsgeräte Mobile Verkaufsgeräte sind: Fahrerterminals („Busdrucker“), Verkaufsautomaten im Fahrzeug, mobile Geräte des Kontroll-/Servicepersonals. Von Mobilen Verkaufsgeräten wird erwartet, dass sie im BerechtigungTarifbereichZusatz die Linie und Richtung liefern, der der Verkauf zuzuordnen ist. Beim Einsatz eines mobilen Geräts des Kontroll-/Servicepersonals für Verkauf außerhalb des Fahrzeugs an einer Haltestelle muss dafür gesorgt werden, dass im BerechtigungTarifbereich- Zusatz dennoch eine Linie geliefert wird. Für einen derartigen Sonderfall sollte das Gerät den OrtTyp 200 (Haltestelle) verwenden und eine virtuelle Linie.21 Die verwendete Linie wird im At- tribut efsLinie_ID des BerechtigungTarifbereichZusatz übermittelt, so dass eine Zuordnung der Verkäufe zu einem (virtuellen) Linienbündel und Abrechnungskennung möglich ist.

5.4.4 eOnline Ticketserver und Handy Ticketserver Die Vertriebskanäle “eOnline Ticketserver” und “Handy Ticketserver” sind hier berücksichtigt, weil sie zukünftig ggf. eine Rolle spielen werden. Beim Verfahren mit einem “eOnline Ticketserver” kauft der Fahrgast die Fahrkarte über das Internet (Webshop) und die Fahrkarte wird als EFS über ein am PC des Fahrgasts angeschlos- senes Kartenlesegerät auf das Nutzermedium des Fahrgasts ausgegeben. Beim Verfahren mit einem “Handy Ticketserver” kauft der Fahrgast die Fahrkarte mit Hilfe sei- nes Handys in der auf Handys zugeschnittenen Version des Webshops und die Fahrkarte wird als EFS auf das Handy (Nutzermedium) des Fahrgasts ausgegeben.22 In beiden Verfahren führt der Ticketserver mit dem Nutzermedium eine Berechtigungsausgabe durch und kann anschließend einen TXABER mit RMV-EFS (einschließlich Ausgabetransakti- on) und BerechtigungTarifbereichZusatz liefern. Sofern bei der Bestellung des Tickets vom Fahrgast die Angabe einer Starthaltestelle (ggf. zu- sätzlich zu den für die Tarifberechnung erforderlichen Angaben) erfragt wird, soll diese im Attri- but efsStartort_ID des BerechtigungTarifbereichZusatz eingetragen werden. Sofern weder der BerechtigungTarifbereichZusatz noch die Tarifparameter des RMV-EFS eine Haltestelle als Startort (efsStartort_ID) enthalten, bleibt das Feld Starthaltestelle in der Ver- kaufsdatenmeldung leer. Das Feld AGS wird nicht gefüllt.

21 Das Gerät sollte zwei Betriebsarten haben: „Einsatz im Fahrzeug“ und „Einsatz an Haltestelle“. Beim Umschalten in die Betriebsart „Einsatz an Haltestelle“ wird der OrtTyp entsprechend umgestellt und die vorkonfigurierte virtuelle Linie eingestellt. Sofern das Gerät die exakte Linienangabe (manuelle Eingabe) für die jeweilige Berechtigungsausgabe unterstützt, kann auch diese angegeben werden. Die Haltestelle wird eingegeben, sofern diese nicht aus Ortungsinformation bzw. einer anderen Bezugsquelle bereits bekannt ist.

22 Das derzeitig im RMV existierende Handy-Ticket fällt nicht unter diese Betrachtung, da dort keine elekt- ronisch prüfbaren EFS ausgegeben werden.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 30 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 32]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

5.4.5 Webshop Über den Webshop (meinRMV mit Zuordnung der Bestellungen zu Mandanten des vHGS) be- stellte Fahrkarten werden über das Aktionsmanagement (Kunde hat bereits eine geeignete Chipkarte) oder den Massenpersonalisierer bzw. die VU-eigene Personalisierungsstelle (Kunde hat noch keine geeignete Chipkarte) ausgeliefert. Die Verkaufsdatenmeldung erfolgt aus den Vorgangsdaten des Kaufvorgangs, basierend auf den Bestelldaten aus dem Webshop. Die Ver- kaufsdatenmeldung wird aus den Daten gefüllt, wie sie in den Vorgangsdaten des vHGS einge- tragen sind. Der aus der Ausfertigung des EFS (Aktionsmanagement, Massenpersonalisierer, VU-eigenes Terminal) resultierende TXABER ist für die Verkaufsdatenmeldung nicht relevant. Für jeden Mandanten des vHGS wird in den Stammdaten des vHGS eine spezielle Vertriebs- stelle „Webshop“ eingerichtet. Es wird die gleiche RMV Verkaufstechnik ID wie für “eOnline Ti- cketserver” verwendet.

5.4.6 Aktionsmanagement Für die Verkaufsdatenmeldung ist nicht das Ereignis „Berechtigungsausgabe auf das Nutzer- medium“, sondern das Ereignis „Beauftragung der Berechtigungsausgabe“ relevant, da dies der Zeitpunkt ist, an dem die Rechtsverbindlichkeit des Zahlungsanspruchs gegen den Kunden ent- steht. Die Verkaufsdatenmeldung wird aus den Daten gefüllt, wie sie in den Vorgangsdaten der Aktionsbeauftragung (insbesondere dem TXAAUFBER (Aktionsauftrag Berechtigungsausgabe)) eingetragen sind. Der aus der Ausführung der Aktion am Terminal resultierende TXABER (mit logTransaktionsTyp 37 = Ausgabe EFS über Aktionsliste) ist für die Verkaufsdatenmeldung nicht relevant. Die Erstellung von Aktionsaufträgen an Offline-Terminals ist nicht vorgesehen. Da die Aktions- beauftragung online erfolgt, ist das vHGS nicht auf Übermittlung von Daten per TXAAUFBER angewiesen. Bei der Aktionsbeauftragung wird im vHGS ein entsprechender Vorgangsdatensatz erstellt, der mit dem TXAAUFBER verknüpft ist. Dabei werden

• … die Tarifparameter des auszugebenden EFS im BerechtigungTarifbereich (Datenstruktur „Separate Daten – Berechtigung RMV EFS – Statischer produktspezifischer Teil“) des TXA- AUFBER eingetragen - zusammen mit dem Vorgangsdatensatz in der vHGS-Datenbank.

• … die Attributwerte für berTarifversion, berSubventionLang, efsStartort_ID, efsZielort_ID, wie sie für den BerechtigungTarifbereichZusatz definiert sind (siehe Abschnitt 3) bestimmt und zusammen mit dem Vorgangsdatensatz in der vHGS-Datenbank gespeichert. Der Be- rechtigungTarifbereichZusatz des TXAAUFBER wird nicht gefüllt, da die Attributwerte für die Ausführung der Aktion nicht relevant sind. Die Erstellung des Verkaufsdatenmeldung-Datensatzes erfolgt aus dem Vorgangsdatensatz des vHGS. Gegenüber der Abbildungsvorschrift in Abschnitt 5.3 gelten folgende Abweichungen:

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 31 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 33]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

5.4.7 Vertragsprodukte (Abonnements, …) Für die Verkaufsdatenmeldung ist nicht das Ereignis „Berechtigungsausgabe auf das Nutzer- medium“, sondern der Bestellweg (Verkaufsort/Verkaufstechnik) sowie das Erstellen der Forde- rung gegenüber dem Kunden (Preis) relevant. Die hierfür im Detail geltenden Regeln werden an anderer Stelle behandelt. Der aus der Ausgabe des mit dem Vertrag verbundenen EFS auf das Nutzermedium resultierende TXABER ist für die Verkaufsdatenmeldung nicht relevant. Als Bestellweg wir der Ort der Erfassung des Abo-Antrags gewertet. Dies sind

• Personalbediente Online-Verkaufsstellen („pVks“, siehe 5.4.1.1)

• Aboverwaltung („Abo-Center“) Für jeden Mandanten des vHGS wird in den Stammdaten des vHGS eine spezielle Ver- triebsstelle „Aboverwaltung“ eingerichtet. Es wird die gleiche RMV Verkaufstechnik ID wie für “Personalbediente Online-Verkaufsstelle (pVks)” verwendet.

• Webshop (siehe 5.4.5)

5.4.8 Massenpersonalisierer Ein Massenpersonalisierer soll im eTicket RheinMain insbesondere zur Ausfertigung von Chip- karten für Vertragskunden (Abonnement, CleverCard, …) eingesetzt werden. Da Vertragspro- dukte in Bezug auf die Verkaufsdatenmeldung anders behandelt werden (siehe vorheriger Ab- schnitt) verbleibt der Fall zu betrachten, dass der Kunde eine Chipkarte mit einer ersten Fahr- karte bestellt hat, die nicht zu den Vertragsprodukten zählt, also z. B. eine Monatskarte. Für die Verkaufsdatenmeldung ist dabei nicht das Ereignis „Berechtigungsausgabe auf das Nutzermedium“, sondern das Ereignis „Bestellung der Fahrkarte“ relevant, da dies der Zeitpunkt ist, an dem die Rechtsverbindlichkeit des Zahlungsanspruchs gegen den Kunden entsteht. Die Verkaufsdatenmeldung wird aus den Daten gefüllt, wie sie in den Vorgangsdaten der Fahrkar- tenbestellung (zusammen mit der Bestellung einer Chipkarte) eingetragen sind. Der aus der

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 32 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 34]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Ausführung der Berechtigungsausgabe beim Massenpersonalisierer resultierende Transakti- onsdatensatz ist für die Verkaufsdatenmeldung nicht relevant. Die Erstellung des Verkaufsdatenmeldung-Datensatzes erfolgt analog dem Vorgehen beim Ak- tionsmanagement aus dem Vorgangsdatensatz des vHGS.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 33 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 35]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

6 KA Spezifikation

6.1 Abstimmung mit dem Standardisierungsprozess Der RMV-EFS wurde auf Basis des Entwurfs in der Version 1.0 dieses Pflichtenhefts von RMS, RMV und Cubic mit der VDV KA KG sowie den Erstellern des KA CR 093 („TLV-EFS“) einge- hend diskutiert und abgestimmt. Im Zuge dieser Abstimmung wurde einvernehmlich festgestellt, dass weder der in der KA Spezifikation beschriebene Referenz-EFS noch der im KA CR 093 beschriebene „TLV-EFS“ alle Anforderungen des RMV und des Projekts eTicket RheinMain abdecken. Es wurde weiterhin festgestellt, dass die Spezifikation des RMV-EFS in der hier vor- liegenden Form mit den Designgrundsätzen der KA im Einklang steht. Die von der KA Spezifikation 1.107 teilweise abweichende Namensgebung der Attribute im pro- duktspezifischen Teil des RMV-EFS folgt entsprechenden Vorschlägen der VDV KA KG. Die VDV KA KG beabsichtigt, diese Namensgebungen über einen CR in den Standard aufzuneh- men. Die im produktspezifischen Teil des RMV-EFS enthaltenen Attribute, die keine Entsprechung im so genannten „Baukasten“ der [KA_SPEC_BOM] haben, wurden mit der VDV KA KG abge- stimmt und sollen über einen CR in den Standard aufgenommen werden. Gleiches gilt für die Erweiterung der Codelisten.

6.2 Ergänzungen zum KA Baukasten „Produktspezifische Attribu- te/Berechtigung Tarifbereich“ Für die Abbildung der Datenelemente (Attribute) des „RMV EFS“ sowie des „Basisobjekt be- rechtigungTarifbereichZusatz“ werden folgende Ergänzungen zum „Baukasten- BerechtigungTarifbereich“ vorgeschlagen.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 34 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 36]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Definitionen und Kürzungsregel für efsFahrgastNameVornameKurz Ein Name besteht aus Vor- und Nachname. Vor- und Nachname bestehen ggf. aus mehreren Namensbestandteilen, jedoch mindestens aus einem Namensbestandteil. Namensbestandteile bestehen aus Buchstaben und können durch Leerzeichen oder Bindestri- che voneinander getrennt sein.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 35 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 37]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

Trenner zwischen Vor- und Nachname Zur Unterscheidung von Vor- und Nachname werden beide Teile durch das "@" Zeichen vonei- nander getrennt. Beispiel: Eva-Maria Alexandra Tanja Manuela@Gräfin von Konstantinopolus Anzahl der Zeichen =61. Kürzungsregeln Zur Maskierung und Speicherung eines Namens werden folgende Kürzungsregeln angewendet:

• Die Namensbestandteile werden jeweils nur mit dem ersten und letzten Buchstaben einge- tragen. Die Anzahl der Buchstaben zwischen dem ersten und dem letzten Buchstaben wird durch die entsprechende Zahl ersetzt, wenn der Namensbestandteil mehr als zwei Buchsta- ben aufweist. Zahlen größer 9 werden durch eine 0 dargestellt23, Beispiel: Eva-Maria Alexandra Tanja Manuela@Gräfin von Konstantinopolus wird zu E1a-M3a A7a T3a M5a@G4n v1n K0s Anzahl der Zeichen = 31.

• Alle enthaltenen Leerzeichen und Bindestriche werden aus dem Namen entfernt. Beispiel: E1a-M3a A7a T3a M5a@G4n v1n K0s (Anzahl der Zeichen = 31) wird zu E1aM3aA7aT3aM5a@G4nv1nK0s (Anzahl der Zeichen = 25)

• Weist der Vorname mehrere Namensbestandteile auf, dann werden, beginnend mit dem letzten Bestandteil, Bestandteile solange verworfen, bis die vom PV bei der Definition der Datenstruktur, in der das Attribut efsFahrgastNameVornameKurz eingesetzt wird, festgeleg- te maximale Länge erreicht bzw. unterschritten wird. Es muss im Vornamen mindestens ein Namensbestandteil erhalten bleiben. Wurden Bestandteile verworfen, dann wird dies durch ein "" vor dem „@“ gekennzeichnet. Beispiel: Wenn die maximale Länge bei 20 Zeichen liegt: E1aM3aA7aT3aM5a@G4nv1nK0s (Anzahl der Zeichen = 25) wird zu E1aM3aA7a@G4nv1nK0s (Anzahl der Zeichen = 20)

• Weist der Nachname mehrere Namensbestandteile auf, dann werden, beginnend mit dem ersten Bestandteil, Bestandteile des Namens solange verworfen, bis die maximale vom PV vorgegebene Länge erreicht bzw. unterschritten wird. Wurden Bestandteile verworfen, dann wird dies durch ein "*" nach dem „@“ gekennzeichnet. Damit ist eine Kürzung von Vornamen und Namen auf minimal 9 Zeichen möglich: Beispiel:

23 Bei mehr als 9 Buchstaben zwischen dem ersten und letzten Buchstaben ist dies vom Prüfpersonal ohnehin nicht auf einen Blick erfassbar. Demgegenüber ist die stets gleiche Darstellung mit genau einer Ziffer für das Prüfpersonal hilfreich bei der schnellen Erfassung der angezeigten Information.

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 36 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 38]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

E1a*@K0s Anzahl der Zeichen = 9. Anzeige des gekürzten Namens Die Anzeige des Namens kann auf verschiedene Weise erfolgen: In Form der Rohdaten: E1aM3aA7a@G4nv1nK0s In aufbereiteter Form: E_a M_a A_a*@G_n v_n K_s oder E_a M___a A_______a*@G____n v_n K__________s oder Vorname: E_a M_a A_a* Nachname: G_n v_n K_s oder Vorname: E_a M___a A_______a* Nachname: G____n v_n K__________s oder G____n v_n K__________s, E_a M___a A_______a* In welcher Weise die Anzeige erfolgt, ist vom DL festzulegen. Die Festlegung der Anzeigeform erfolgt dann im Zusammenhang mit der Beauftragung der je- weiligen Gerätehersteller.

6.3 Ergänzungen zu den KA Codelisten

6.3.1 Ergänzungen zu TerminalTyp_CODE

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 37 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich

[Seite 39]

Anlage 24 Anhang 1 vHGS eTicket RheinMain

Pflichtenheft

6.3.2 Ergänzungen zu OrtsTyp_CODE

6.3.3 Ergänzungen zu BezahlArt_CODE

Die oben genannten Codes sind Codes der EN1545 Codeliste, die in der KA sichtbar gemacht werden sollen: 7 = Invoicing 14 = Voucher

Datei: vHGS_PH05-A1_RMV-EFS_v1.6.docx Seite 38 Dok-Ref.: PH 05-A1 Version: 1.6 Datum: 15.04.2019 Cubic Transportation Systems (Deutschland) GmbH, Vertraulich