Abbildung_und_Kontrolle_von_eTickets_im_Westfalen-Tarif_V2.4.4_final.pdf

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Abbildung und Kontrolle von eTickets im Westfalen-Tarif

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 1 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Inhaltsverzeichnis

Abbildungsverzeichnis ................................................................................................4

Tabellenverzeichnis ....................................................................................................5

0 Dokumentenverwaltung ....................................................................................7

0.1 Änderungsübersicht .............................................................................................. 7

0.2 Definition projektspezifischer Begriffe ...................................................................... 9

0.3 Referenzdokumente .............................................................................................. 9

1 Einleitung ....................................................................................................... 11

2 Abbildung eAbo auf Basis TLV-EFS ................................................................... 11

2.1 Attribute statisch produktspezifischer Teil ............................................................... 11 2.1.1 Definition des räumlichen Geltungsbereichs (TAG „0xDC Liste“) ........................... 13 2.1.2 Räumliche Struktur des Westfalentarifs ............................................................ 13 2.1.3 Belegung der TAGs ....................................................................................... 14 2.1.4 Platzbetrachtungen und optionale Namenskürzungen, Beispiele ........................... 16 2.2 Transaktionen ................................................................................................... 18 2.2.1 Berechtigungsausgabe (TXABER) .................................................................... 18 2.2.2 Kontrolltransaktion (TXEBER) ......................................................................... 18 2.2.3 Berechtigung zurücknehmen (TXRBER) ............................................................ 18 2.2.4 Berechtigung sperren (TXSNAWB) ................................................................... 18 2.2.5 Berechtigung entsperren (TXSNAWB) .............................................................. 18 2.3 Kontrolle .......................................................................................................... 18 2.3.1 Daten auf den Kontrollgeräten (DLT) ............................................................... 19 2.3.2 Ausgangsgrößen .......................................................................................... 20 2.3.2.1 Prüfung der räumlichen Gültigkeit ............................................................. 20 2.3.2.2 Prüfung des zeitlichen Gültigkeit ............................................................... 21 2.3.3 Prüfung der Kontrollregeln ............................................................................. 21 3 Abbildung WT-POB auf Basis Referenz AFB ...................................................... 23

3.1 Attribute der Berechtigung ................................................................................... 23

3.2 Transaktionen ................................................................................................... 24 3.2.1 Berechtigungsausgabe (NM-Transaktionsdaten für TXABER) ................................ 24 3.2.2 Fahrttransaktion / CI (NM-Transaktionsdaten für TXEBER) .................................. 25 3.2.3 Kontrolltransaktion (NM-Transaktionsdaten für TXEBER) ..................................... 27 3.2.4 Berechtigung zurücknehmen (NM-Transaktionsdaten für TXRBER) ........................ 27 3.2.5 Berechtigung sperren (NM-Transaktionsdaten für TXSNAWB) ............................... 28 3.2.6 Berechtigung entsperren (NM-Transaktionsdaten für TXSNAWA) .......................... 28 3.2.7 Tarifparameter ändern (TXAEBER) .................................................................. 28 3.2.8 Nutzertarifparameter ändern (TXAENBER) ........................................................ 28 3.3 Kontrolle des POB-Tarifs ...................................................................................... 28

4 Abbildung WT-WEB auf Basis Referenz WEB ..................................................... 30

4.1 Attribute der Berechtigung ................................................................................... 30

4.2 Transaktionen ................................................................................................... 31 4.2.1 Berechtigungsausgabe (NM-Transaktionsdaten für TXABER) ................................ 31 4.2.2 Aufbuchung (NM-Transaktionsdaten für TXEBER) ............................................... 32 4.2.3 Leistungserfassung / CI (Fahrt) (NM-Transaktionsdaten für TXEBER) .................... 34 4.2.4 Kontrolltransaktion (NM-Transaktionsdaten für TXEBER) ..................................... 37 4.2.5 Berechtigung zurücknehmen (NM-Transaktionsdaten für TXRBER) ........................ 37 4.2.6 Berechtigung sperren (NM-Transaktionsdaten für TXSNAWB) ............................... 37 4.2.7 Berechtigung entsperren (NM-Transaktionsdaten für TXSNAWB) .......................... 37

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 2 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

4.2.8 Tarifparameter ändern (TXAEBER) .................................................................. 38 4.2.9 Nutzertarifparameter ändern (TXAENBER) ........................................................ 38 4.3 Kontrolle des WEB-Tarifs ..................................................................................... 38

5 Westfälisches (WTB) Produktmodul ................................................................. 39

5.1 Produkte........................................................................................................... 39 5.1.1 Templates ................................................................................................... 40 5.1.2 Tariffenster ................................................................................................. 40 5.1.3 Ticketarten ................................................................................................. 40 5.1.4 Preisstufen .................................................................................................. 44 5.1.5 Organisationen ............................................................................................ 45 5.1.6 Tarife ......................................................................................................... 46 5.1.7 Währungen ................................................................................................. 46 5.1.8 Tickets ....................................................................................................... 47 5.1.9 Preise......................................................................................................... 48 5.1.10 Zeitfenster ............................................................................................... 49 5.2 Räumliche Struktur ............................................................................................ 50 5.2.1 Kooperationsräume ...................................................................................... 50 5.2.2 Kreise ........................................................................................................ 51 5.2.3 Flächentypen ............................................................................................... 51 5.2.4 Flächen ...................................................................................................... 52 5.2.5 Relationen .................................................................................................. 53 5.2.6 Ticketsortimente .......................................................................................... 55 5.2.7 Geltungsbereiche ......................................................................................... 56 5.3 WT-Kontrollregeln .............................................................................................. 58 5.3.1 Zeitliche Gültigkeit ....................................................................................... 58 5.3.1.1 Tag-Typen ............................................................................................ 58 5.3.1.2 Feiertags- und Ferienkalender .................................................................. 60 5.3.2 Mitnahmeregeln ........................................................................................... 61 5.3.3 Räumliche Gültigkeit ..................................................................................... 62 5.3.3.1 Relationsnummern ................................................................................. 62 5.3.3.2 Ortnummern ......................................................................................... 62 5.3.4 Kontrollgruppen und Regeln ........................................................................... 63 5.3.4.1 Kontrollgruppen ..................................................................................... 63 5.3.4.2 Kontrollgruppen_Kontrollregeln ................................................................ 64 5.3.4.3 Kontrollregeln ........................................................................................ 64 5.4 Haltestellen ....................................................................................................... 65

5.5 Ergänzende Beschreibung zum technischen Aufbau des WT-PKM ................................ 66 5.5.1 Eindeutiger Schlüssel der Datenelemente ......................................................... 66 5.5.1.1 Produkte ............................................................................................... 66 5.5.1.2 Räumliche Struktur ................................................................................. 67 5.5.1.3 Kontrollregeln ........................................................................................ 68 5.5.2 Beziehungen zwischen Datenelementen ........................................................... 68 5.5.3 WT-PKM als ER-Diagramm dargestellt .............................................................. 70 6 Erläuterungen zum Vertriebs- und Kontrollprozess ........................................... 71

6.1 Vertriebsprozess auf Basis des WT-PKM ................................................................. 71 6.1.1 Relationsbezogener Vertriebsprozess ............................................................... 71 6.1.1.1 Auswahl der Relation .............................................................................. 71 6.1.1.1.1 Ermittlung der Start- und Ziel-Flächen ................................................... 71 6.1.1.1.2 Ermittlung der Fahrwege für die Relation ................................................ 72 6.1.1.1.3 Suche mit übergeordneten Start- und Zielvorgaben .................................. 73 6.1.1.1.4 Ermittlung des Geltungsbereichs ........................................................... 73 6.1.1.2 Von der Relation zum Ticket ..................................................................... 74 6.1.1.2.1 Ermittlung der Relationsnummer ........................................................... 74

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 3 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

6.1.1.2.2 Ermittlung der Ortnummern ................................................................. 74 6.1.1.2.3 Ermittlung des Ticketsortiments für den Fahrweg einer Relation ................. 75 6.1.1.2.4 Ermittlung der Tickets eines Ticketsortiments .......................................... 75 6.1.1.2.5 Ermittlung Geltungsbereich für Tickets mit anderer „PreisstufeNummer“ ...... 76 6.1.1.2.6 Ermittlung des EAV-Codes.................................................................... 77 6.2 Kontrollprozess auf Basis des WT-PKM ................................................................... 77 6.2.1 Ermittlung der Kontrollregeln ......................................................................... 77 6.2.2 Ermittlung der räumlichen Gültigkeit ............................................................... 79 7 Weitere Schnittstellen zur Weitergabe des Tarifs ............................................. 80

7.1 Access-Schnittstelle ............................................................................................ 80 7.1.1 Klassisch .................................................................................................... 81 7.1.1.1 Fahrausweisart ...................................................................................... 81 7.1.1.2 Preisstufe.............................................................................................. 82 7.1.1.3 Fahrausweis .......................................................................................... 82 7.1.1.4 Tarif ..................................................................................................... 82 7.1.1.5 Währung............................................................................................... 83 7.1.1.6 Preis .................................................................................................... 83 7.1.1.7 Kooperationsraum .................................................................................. 83 7.1.1.8 Kreis .................................................................................................... 84 7.1.1.9 Gemeinde ............................................................................................. 84 7.1.1.10 Tarifbereich ........................................................................................... 84 7.1.1.11 Zone .................................................................................................... 85 7.1.1.12 Zonenweg ............................................................................................. 85 7.1.1.13 Ueberzone ............................................................................................ 86 7.1.1.14 Sonderfahrausweis ................................................................................. 86 7.1.2 Erweitert .................................................................................................... 87 7.1.2.1 Tariffenster ........................................................................................... 88 7.1.2.2 Haltestelle............................................................................................. 88 7.1.2.3 HaltestelleZone ...................................................................................... 88 7.2 Excel-Schnittstelle .............................................................................................. 89 7.2.1 Tabellenblatt: Ticketarten .............................................................................. 89 7.2.2 Tabellenblatt: Tarifgebiete ............................................................................. 90 7.2.3 Tabellenblatt: Tarifzonen ............................................................................... 90 7.2.4 Tabellenblatt: Relationen ............................................................................... 91

Abbildungsverzeichnis

Abbildung 1: Gültigkeitsprüfungen gem. [KUSCH] 4.3.2........................................................ 19 Abbildung 2: WT-PKM als ER-Diagramm ............................................................................. 71 Abbildung 3: Ermittlung der Fahrwege einer Relation anhand Start- und Ziel-Flaeche ................ 72 Abbildung 4: Rückfallebenen für Start- und Zielvorgaben ...................................................... 73 Abbildung 5: Ermittlung der Geltungsbereiche für den Fahrweg einer Relation .......................... 74 Abbildung 6: Ermittlung der Ticketdaten eines Ticketsortiments ............................................. 75 Abbildung 7: Bildung des EAV-Codes aus EAV-Basis-Codes.................................................... 77 Abbildung 8: Beispiel für die Bildung des EAV-Codes aus EAV-Basis-Codes ............................... 77 Abbildung 9: Ermittlung der Kontroll- und Mitnahmeregeln .................................................... 78 Abbildung 10: „Liste originärer Geltungsbereich“ (TAG 0xDC) ................................................ 79 Abbildung 11: Ermittlung der Ticketdaten eines Ticketsortimentes .......................................... 80 Abbildung 12: Access-Export Datenmodell klassisch ............................................................. 81 Abbildung 13: Erweiterte Access-Schnittstelle ..................................................................... 87

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 4 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabellenverzeichnis

Tabelle 1: Abkürzungen .................................................................................................... 9 Tabelle 2: Referenzdokumente ......................................................................................... 10 Tabelle 3: TLV-EFS relevante Attribute gem. [BOM_TLV_EFS] ................................................ 12 Tabelle 4: Typdefinitionen zum TAG “0xDC Liste“ ................................................................ 14 Tabelle 5: TAGs und Flächentypen .................................................................................... 15 Tabelle 6: [SPEC-NM] Tabelle 5-82 Separate Daten Berechtigung AFB Statischer produktspezifischer Teil ................................................................................................... 23 Tabelle 7: Vertragsvarianten der POB-Produkte ................................................................... 23 Tabelle 8: [SPEC-NM] Tabelle 5-50 „Transaktion produktspezifischer Teil – Referenz AFB“ .......... 25 Tabelle 9: [SPEC_NM] Tabelle 5-50 Datenstruktur „Transaktion Produktspezifischer Teil – Referenz AFB“ ............................................................................................................................ 25 Tabelle 10: [SPEC_NM] Tabelle 5-46 Datenstruktur „Allgemeine Fahrttransaktionsdaten“ ........... 27 Tabelle 11: [SPEC-NM] Tabelle 5-85 „Separate Daten - Berechtigung Referenz WEB - Statischer produktspezifischer Teil“ ................................................................................................. 30 Tabelle 12: [SPEC-NM] Tabelle 5-51 „Transaktion produktspezifischer Teil – Referenz WEB“ ....... 31 Tabelle 13: [SPEC_NM] Tabelle 5-51 „Transaktion Produktspezifischer Teil – Referenz WEB“ ....... 32 Tabelle 14: Tabelle 5-46 Datenstruktur „Allgemeine Fahrttransaktionsdaten“ ........................... 34 Tabelle 15: [SPEC_NM] Tabelle 5-51 Datenstruktur „Transaktion Produktspezifischer Teil – Referenz WEB“ .............................................................................................................. 35 Tabelle 16: [SPEC_NM] Tabelle 5-46 Datenstruktur „Allgemeine Fahrttransaktionsdaten“ ........... 36 Tabelle 17: Templates .................................................................................................... 40 Tabelle 18: Tariffenster ................................................................................................... 40 Tabelle 19: Ticketarten ................................................................................................... 44 Tabelle 20: Preisstufen.................................................................................................... 45 Tabelle 21: Organisationen .............................................................................................. 46 Tabelle 22: Tarife ........................................................................................................... 46 Tabelle 23: Währungen ................................................................................................... 47 Tabelle 24: Tickets ......................................................................................................... 48 Tabelle 25: Preise .......................................................................................................... 49 Tabelle 26: Zeitfenster .................................................................................................... 50 Tabelle 27: Kooperationsräume ........................................................................................ 51 Tabelle 28: Kreise .......................................................................................................... 51 Tabelle 29: Flaechentypen ............................................................................................... 52 Tabelle 30: Flaechen....................................................................................................... 53 Tabelle 31: Relationen .................................................................................................... 55 Tabelle 32: Ticketsortimente ............................................................................................ 56 Tabelle 33: Geltungsbereiche ........................................................................................... 57 Tabelle 34: Zuordnung TagNummern zu TagTyp_Name ........................................................ 58 Tabelle 35: TagNummern ................................................................................................ 59 Tabelle 36: TagTypen ..................................................................................................... 59 Tabelle 37: TagTypen_Tage ............................................................................................. 60 Tabelle 38: Feiertage_Ferien ........................................................................................... 60 Tabelle 39: Mitnahmeregeln ............................................................................................. 61 Tabelle 40: Relationsnummern ......................................................................................... 62 Tabelle 41: Ortnummern ................................................................................................. 63 Tabelle 42: Kontrollgruppen ............................................................................................. 63 Tabelle 43: Kontrollgruppen_Kontrollregel .......................................................................... 64 Tabelle 44: Kontrollregeln ............................................................................................... 65 Tabelle 45: Haltestelle .................................................................................................... 66 Tabelle 46: Steuerung Datenversorgung Kontrollsysteme über Attribut „Typ_Hinterlegung“ ........ 80 Tabelle 47: Fahrausweisart .............................................................................................. 82 Tabelle 48: Preisstufe ..................................................................................................... 82 Tabelle 49: Fahrausweis .................................................................................................. 82 Tabelle 50: Tarif ............................................................................................................ 82 Tabelle 51: Währung ...................................................................................................... 83 Tabelle 52: Preis ............................................................................................................ 83

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 5 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 53: Kooperationsraum .......................................................................................... 83 Tabelle 54: Kreis ............................................................................................................ 84 Tabelle 55: Gemeinde ..................................................................................................... 84 Tabelle 56: Tarifbereich .................................................................................................. 85 Tabelle 57: Zone ............................................................................................................ 85 Tabelle 58: Zonenweg .................................................................................................... 86 Tabelle 59: Ueberzone .................................................................................................... 86 Tabelle 60: Sonderfahrausweis ......................................................................................... 87 Tabelle 61: Tariffenster ................................................................................................... 88 Tabelle 62: Haltestelle .................................................................................................... 88 Tabelle 63: Haltestelle-Zone ............................................................................................ 89 Tabelle 64: Ticketarten ................................................................................................... 90 Tabelle 65: Tarifgebiete .................................................................................................. 90 Tabelle 66: Tarifzonen .................................................................................................... 91 Tabelle 67: Relationen .................................................................................................... 92

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 6 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

0 Dokumentenverwaltung

0.1 Änderungsübersicht

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 7 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 8 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

0.2 Definition projektspezifischer Begriffe

Es gelten zusätzlich die spezifischen Begriffe aus dem VDV-KA Glossar (siehe [Glossar]).

Tabelle 1: Abkürzungen

0.3 Referenzdokumente

Grundsätzlich gelten alle Dokumente der VDV-Kernapplikation (VDV-KA). Die Dokumente der VDV-

KA-Spezifikationen können auf der Website der VDV eTicket Service GmbH & Co. KG kostenlos

herunterladen werden:

Link: http://oepnv.eticket-deutschland.de/produkte-und-services/vdv-kernapplikation/

Im Folgenden werden daher nur die im Kontext dieses Dokumentes besonders relevanten Doku-

mente der VDV-Kernapplikation noch mal explizit erwähnt.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 9 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Die Dokumente, welche durch KCM und KCEFM heraus gegeben werden, können auf der

Website des KCEFM (www.kcefm.de) herunter geladen werden.

Tabelle 2: Referenzdokumente

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 10 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

1 Einleitung

Dieses Dokument ist eine Weiterentwicklung des Dokumentes „Abbildung und Kontrolle von eTi-

ckets im Münsterland-Tarif_V1.2“, welches den Tarif beschränkt auf das Münsterland definiert hat.

Zur Einführung der Westfälischen Tarifdatenbank (WTB) wird ein westfalenweit gültiger Tarif defi-

niert mit einem einheitlichen Produktmodul.

Die Erklärungen zur Verwendung der Transaktionen stammen aus dem WT-Tariffenster und sind

nicht unbedingt in allen Tariffenstern des Westfalentarifs gültig.

Bei der Einführung des Elektronischen Fahrgeldmanagements (EFM) für Produkte des Münsterland-

Tarifs auf der Basis der VDV-Kernapplikation kommen zurzeit die Berechtigungsarten EFS, POB und

WEB auf Chipkarten zur Anwendung.

In diesem Dokument wird beschrieben, mit welchen Inhalten die Statischen Produktspezifischen

Teile der Berechtigungen, die Transaktion Produktspezifischen Teile der einzelnen Transaktionsda-

tensätze und die Allgemeinen Fahrtransaktionsdaten gefüllt werden und an Hand welcher Kriterien

eine Kontrolle durchzuführen ist. Weiterhin wird das Produktmodul des Westfalentarifs der WTB

beschrieben, mit dessen Hilfe die Produktbeschreibungen zum KVP und DL übertragen werden. Die

Realisierung des Handy-Tickets in Münster ist nicht Bestandteil dieses Dokuments.

Die WTB versteht sich als Datengrundlage für den Verkauf von Tickets im Westfalentarif. Die ei-

gentlichen Vertriebsprozesse werden durch die WTB nicht vorgegeben! Zur besseren Verständlich-

keit werden jedoch in Kapitel 6 Anhaltspunkte und Klarstellungen zu den Themen Preisfindung und

Netztickets gegeben.

2 Abbildung eAbo auf Basis TLV-EFS

Als EFS wird der TLV-EFS (siehe [BOM_TLV_EFS], [CR126], [CR141]) verwendet. Er erlaubt eine

flexible, TAG-gesteuerte Nutzung des produktspezifischen Teils. Nur so ist eine Beschreibung der

tlw. sehr umfangreichen, räumlichen Geltungsbereiche möglich.

In den Verzeichniseintrag – Berechtigung – Statischer Teil wird die Produktnummer des jeweiligen

Produktes (es gibt diverse eAbos) und als prodKeyOrganisation_ID die 5000 (Bundeseinheitlicher

Erfassungsschlüssel) geschrieben.

2.1 Attribute statisch produktspezifischer Teil

Nachfolgend werden die Attribute einer Berechtigung im TLV-EFS, wie er in der Datenstruktur „Se-

parate Daten – Berechtigung Referenz EFS – Statischer produktspezifischer Teil“ (TAG 0x85) ver-

wendet wird, aufgelistet und erläutert. Die Darstellung ist reduziert auf die Strukturen, welche zur

Verwendung im WT besonders erklärt werden müssen.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 11 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 3: TLV-EFS relevante Attribute gem. [BOM_TLV_EFS]

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 12 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

2.1.1 Definition des räumlichen Geltungsbereichs (TAG „0xDC Liste“) In der Struktur „Liste“ (TAG 0xDC) im statischen, produktspezifischen Teil des EFS wird der räumli-

che Geltungsbereich der Berechtigung angegeben. Dieser wird über eine so genannte Fahrtrelation

(kurz: Relation, früher: Zonenweg) beschrieben, die sich aus einer Menge von Tarifgebieten und

Zonen zusammensetzt.

2.1.2 Räumliche Struktur des Westfalentarifs Der Tarifraum des Westfalentarifs ist strukturiert in die hierarchischen Ebenen

 Kooperationsraum

 Kreis

 Fläche (Tarifgebiet, Cityzone, Zone)

Dementsprechend werden 5-stellige Zonennummern nach folgendem Schema gebildet:

 1. Ziffer: Kooperationsraum (Werte: 0 -9)

 2. Ziffer: Kreis (Werte: 1 – 9)

 3. - 5. Ziffer: Fläche (Werte: 000 – 999)

Die bislang verwendete Nummernkreissystematik, in der die „0“ in der 5. Ziffer immer

ein Tarifgebiet bezeichnet, welches die restlichen Zonen (>= 1) der gleichen Gemeinde

umfasst, gilt NICHT mehr!

Gleichwohl können und werden Tarifgebiete zurzeit teilweise in der WTB weiterhin mit der Null in

der 5. Ziffer bezeichnet (auf Grund einer Absprache auf Westfalenebene).

Jede Fläche, die in einer anderen Fläche enthalten ist, bekommt eine Referenz auf die übergeord-

nete Fläche zugeordnet. Daher bekommen Zonen eine Referenz auf Tarifgebiete beispielsweise

zugeordnet. Diese Referenzen werden über das Produktmodul mitgeliefert.

Beispiele:

 55000: Tarifgebiet Münster/gesamt (Flächentyp: Tarifgebiet), keine übergeordnete Flä- che  55011: Zone Münster/St. Mauritz, übergeordnete Fläche: 55000  gehört zum Tarifge- biet 55000  55024: Zone Münster/Gremmendorf, übergeordnete Fläche: 55000  gehört zum Tarif- gebiet 55000

Fiktive Beispiele:  61480: Beispiel-Tarifgebiet (Flächentyp: Tarifgebiet)  61451: Beispiel-Zone, übergeordnete Fläche 61480  gehört zum Tarifgebiet 61480  61452: Beispiel-Cityzone (Flächentyp: Cityzone), übergeordnete Fläche 61480  gehört zum Tarifgebiet 61480  61460: Beispiel-Zone, übergeordnete Fläche 61452  gehört zur Cityzone 61452

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 13 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Die Zonennummern werden als Ortnummer im Sinne der KA verwendet.

2.1.3 Belegung der TAGs Für den normalen, räumlichen Geltungsbereich wird das TAG 0xDC „Liste originärer Geltungsbe-

reich“ genutzt. Um alternative, räumliche Geltungsbereiche abbilden zu können, wie sie beispiels-

weise beim Schülerticket ab 14 Uhr (Netz ML, Netz Übergang ML/RL und Netz RL) existieren, wird

zusätzlich noch ein TAG 0xD9 „Liste alternativer Geltungsbereich“ in den EFS geschrieben werden,

der grundsätzlich dem Tag 0xDC entspricht und in Tabelle 3 nicht gesondert dargestellt ist.

Für die Tags 0xDC und 0xD9 sind Stand Mai 2012 die folgenden Varianten definiert, mit denen

auch Hierarchieebenen bei den räumlichen Gültigkeiten realisiert werden können:

Tabelle 4: Typdefinitionen zum TAG “0xDC Liste“

Im TLV-EFS des WT wird die Variante B mit Ortsnummern vom Typ INT3 verwendet. Es besteht

allerdings kein Zusammenhang zwischen der Codierung des Tags und der Flächentypnummer!

Vertriebssysteme verwenden grundsätzlich immer Typ-Definition 0x05, wobei Bestandssysteme

auch Typ-Definition 0x06 verwenden dürfen (Investitionsschutz).

Grundsätzlich stehen bei der Variante B in einem TAG Liste hinter der Relationsnummer nur Ort-

nummern gleichen Typs; dieser wird in das Feld „Typ-Definition“ geschrieben. Folgende Ausprä-

gungen des räumlichen Geltungsbereichs können auftreten:

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 14 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 5: TAGs und Flächentypen

In der rechtesten Spalte „Länge (Bytes)“ steht die erste 2 für TAG und Länge, die 1 für die Typ-

Definition, die nachfolgende 2 für die Organisation_ID und die feste 3 für die Relationsnummer. N

gibt die Anzahl der zusätzlichen Ortnummern an. Die Anzahl kann zwischen 0 (nur Relationsnum-

mer) und 8 (Relationsnummer und 8 Ortnummern) liegen. Folglich variiert die Länge des gesamten

TAGs „Liste“ zwischen 8 und 32.

Als erste Nummer wird immer eine Relationsnummer eingetragen. Bei Relationen, die aus maximal

8 verschiedenen Tarifgebieten oder Flächen (Start-, Ziel- und Zonen des Geltungsbereiches) beste-

hen, werden zusätzlich die Ortnummern mit in den TAG „Liste“ des TLV-EFS geschrieben. Die Prü-

fung durch ein Kontrollsystem erfolgt nur anhand der Relationsnummer, falls die zugehörigen Ort-

nummern im Kontrollsystem gespeichert sind. Andernfalls werden die Ortnummern aus dem TLV-

EFS verwendet.

Daher müssen alle Relationen, die mit der „Typ_Hinterlegung“ „R“ (also > 8 Ortnummern) gekenn-

zeichnet sind, auf das Kontrollsystem übertragen werden. Relationen mit der „Typ_Hinterlegung“

„K“ (<= 8 Ortnummern) müssen nicht auf das Kontrollsystem übertragen werden. Falls der räumli-

che Gültigkeitsbereich einer kurzen Relation seitens des Tariffensters geändert wurde, so wird die

Relationsnummer mit der „Typ_Hinterlegung“ „A“ gekennzeichnet und muss dann auch auf das

Kontrollsystem übertragen werden.

Auf diese Weise sind Änderungen an Geltungsbereichen möglich, ohne das Nutzermedium neu be-

schreiben zu müssen!

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 15 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

2.1.4 Platzbetrachtungen und optionale Namenskürzungen, Beispiele Für die Sektion „Separate Daten EFS - Statisch produktspezifischer Teil“ stehen maximal 96 Bytes

zur Verfügung. Davon werden für den ersten, statischen Teil „Grundlegende Daten“ (TAG 0xDA)

fest 19 Bytes verbraucht.

Die restlichen 77 Bytes stehen dann noch für die variablen TAGs „Fahrgast“ (0xDB) und „Liste“

(0xDC) zur Verfügung.

Die Länge des TAGs „Fahrgast“ kann zwischen 8 und 29 Bytes variieren:

 2 Bytes für TAG und Länge

 1 Byte für das Geschlecht

 4 Bytes für das Geburtsdatum

 Mindestens 1 und höchstens 22 Bytes für die Namensinformation

Nachname und Vorname werden ohne Trennzeichen aneinandergehängt und bei

langen Namen auf 22 Zeichen verkürzt (abgeschnitten).

Das bedeutet, dass für die TAGs „Liste“ noch 48 bis 69 Bytes zur Verfügung stehen. Jedes TAG

„Liste“ besteht fest aus 5 Bytes (TAG, Länge, Typ und Organisation_ID des PV). Für die 5-stelligen

Nummern (INT3) in „Liste Flächen-IDs“ bleiben also noch 43 – 64 Bytes, da sind 14 – 21 Num-

mern.

Falls nur der normale, räumliche Geltungsbereich in den EFS geschrieben wird, können die 22 Zei-

chen für den Namen immer ausgeschöpft werden, da ein TAG „Liste“ maximal 32 Bytes lang ist.

Wird jedoch noch ein zweites TAG „Liste“ für den alternativen, räumlichen Geltungsbereich benö-

tigt, können im Extremfall 2 x 32 = 64 Bytes erforderlich sein; in diesem Falle bleiben für das TAG

„Fahrgast“ nur noch 13 Bytes, was bedeutet, dass der Name auf 6 Zeichen verkürzt werden muss.

Zur Verdeutlichung werden einige Beispiele aufgelistet für die verschiedenen Konstellationen. Es

werden nur die vollständigen TAGs „Fahrgast“ und „Liste“ aufgeführt, da der Rest von der Länge

her statisch ist:

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 16 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 17 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Anmerkungen:

 In der Längenangabe (Len) eines TAGs sind die beiden Bytes für das TAG selbst

und dessen Länge nicht enthalten.

 Das Geburtsdatum (Geb-Datum) beansprucht 4 Bytes.

 Für jede Nummer (Ort- oder Relationsnummer) in „Flächen-IDs“ werden 3 Bytes

verwendet. Die Leerzeichen zwischen den Nummern dienen nur der besseren Les-

barkeit, werden aber nicht in den EFS geschrieben.

 In den letzten vier Fällen existiert jeweils ein alternativer, räumlicher Geltungsbe-

reich; die beiden TAGs „Liste“ stehen dann im EFS direkt hintereinander.

 Der letzte Fall wäre typisch für die bestehende GoCard: der normale räumliche

Gültigkeitsbereich würde vollständig in den EFS passen, der alternative wäre ein

Netz (VGM oder VRL) und würde entsprechend über eine reine Relationsnummer

angegeben.

2.2 Transaktionen

Es werden nur Transaktionen betrachtet, in denen WT-Spezifika abgebildet werden. Da der Trans-

aktion Produktspezifische Teil beim TLV EFS nicht genutzt wird (Länge = 0), sind hier keine WT-

Spezifika vorhanden.

2.2.1 Berechtigungsausgabe (TXABER) Die in TXABER verwendete NM-Transaktion ist gem. [SPEC_NM] Tabelle 5-37 zu erzeugen.

2.2.2 Kontrolltransaktion (TXEBER) Die in TXEBER verwendete NM-Transaktion ist gem. [SPEC_NM] Tabelle 5-32 zu erzeugen.

2.2.3 Berechtigung zurücknehmen (TXRBER) Die in TXRBER verwendete NM-Transaktion ist gem. [SPEC_NM] Tabelle 5-40 zu erzeugen.

2.2.4 Berechtigung sperren (TXSNAWB) Die in TXSNAWB verwendete NM-Transaktion ist gem. [SPEC_NM] Tabelle 5-34 zu erzeugen.

2.2.5 Berechtigung entsperren (TXSNAWB) Die in TXSNAWB verwendete NM-Transaktion ist gem. [SPEC_NM] Tabelle 5-34 zu erzeugen.

2.3 Kontrolle

Nachfolgend werden die Details des Kontrollprozesses beschrieben, in dem die Verprobung der

gelieferten Ausgangsgrößen mit den im EFS stehenden Daten sowie den in den Kontrollgeräten

hinterlegten Kontrollregeln und Relationsnummern stattfindet.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 18 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Die Gültigkeitsprüfung ist entsprechend [KUSCH] 4.3.2 bzw. [SYSLH_DLRT] umzusetzen.

Abbildung 1: Gültigkeitsprüfungen gem. [KUSCH] 4.3.2

2.3.1 Daten auf den Kontrollgeräten (DLT) Das Produktmodul wird vollständig an die Hintergrundsysteme der Kontrollgeräte übergeben. Fol-

gende Daten des Produktmoduls müssen auf den Kontrollgeräten verfügbar sein:

 Zulässige Tickets, bestehend aus

o Organisation_ID des PV

o Produktnummer

o Preisstufennummer

o Verweis auf Kontrollregeln (falls vorhanden)

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 19 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

 Kontrollregeln, bestehend aus

o Kontrollgruppen mit allen abhängigen Daten

Alle Daten aus den Tabellen Kontrollgruppen, Kontrollregeln, Mitnahmere-

geln, TagTypen und TagTyp_Tage

o Kalendertage

Daten aus Tabelle Feiertage_Ferien

o Relationsnummern

o Liste der zugehörigen Ortnummern, jeweils mit Flächentypnummer

2.3.2 Ausgangsgrößen Die Kontrollgeräte erhalten für die Prüfung die aktuelle Zeit und die aktuelle Position wie folgt:

 Zeitpunkt: Datum und Uhrzeit

Anhand des Datums lassen sich der Wochentag und damit die Tagnummer (1 – 7)

bestimmen. Über den Kalender (Tabelle Kalendertag) kann zusätzlich ermittelt

werden, ob weitere Tagnummern (z.B. 8, 9) hinzukommen.

 Position

Über IBIS werden die Zonennummer (vierstellige Zahl) und die Haltestellen-ID

geliefert.

2.3.2.1 Prüfung der räumlichen Gültigkeit Die aktuelle Position wird gegen die Angaben zur räumlichen Gültigkeit, die im produktspezifischen

Teil des EFS steht, verprobt, und zwar jeweils für die aktuelle und die nächste Haltestelle. Dabei

sind zwei Fälle zu unterscheiden:

 Relationsnummer ist nicht mit Ortnummern im Kontrollsystem hinterlegt

Prüfung, ob die Position zu einer der im TLV_EFS stehenden Ortnummern passt

 Relationsnummer ist mit Ortnummern im Kontrollsystem hinterlegt

Ermittlung der Ortnummern, die zu der Relationsnummer hinterlegt sind, und Prü-

fung, ob die Position zu einer dieser Ortnummern passt

Die Prüfung, ob eine Position zu einer Ortnummern „passt“, geschieht wie folgt:

 Jede Ortnummer besteht aus 5 Ziffern (3 Bytes). Der im TAG Liste vorstehende

Flächentyp gibt an, wie die Ortnummer zu prüfen ist:

o Fläche

Die 4 Ziffern ab Position 2 der Ortnummer müssen mit der Zone überein-

stimmen.

Bsp.: Zone 5011 passt zu Ortnummer 55011

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 20 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

o Tarifgebiet

Sofern die zu prüfende Fläche ein Tarifgebiet ist, müssen die Ortnummern

übereinstimmen. Ist die zu prüfende Fläche kein Tarifgebiet, dann muss

dieser Fläche eine übergeordnete Fläche zugeordnet sein, deren Orts-

nummer passt. Diese Prüfung der übergeordneten Flächen muss ggf. so-

lange wiederholt werden, bis man auf der höchsten Ebene, dem Tarifge-

biet, angekommen ist, welches keine übergeordnete Fläche besitzt (Zo-

neCityzoneTarifgebiet).

Für die Tarifzonen der aktuellen und der nächsten Haltestelle wird überprüft, ob deren Ortnummer

oder die Ortnummer der mittels Feld FlaechenNummerUebergeordnet adressierten übergeordneten

Cityzone bzw. Tarifgebiet im räumlichen Geltungsbereich der Berechtigung enthalten ist.

2.3.2.2 Prüfung des zeitlichen Gültigkeit Im EFS steht ein Gültigkeitszeitraum, der durch die beiden Datumsfelder „berGueltigkeitsbeginn“

und „berGueltigkeitsende“ im „Verzeichniseintrag – Berechtigung – Statischer Teil“ angegeben

wird. Liegt der aktuelle Zeitpunkt (Datum + Uhrzeit) nicht in diesem Zeitraum, so ist die Berechti-

gung nicht gültig.

Hinweis: Der Gültigkeitszeitraum kann über mehrere Jahre gehen (z.B. bei Abos), kann aber auch

nur eine Gültigkeitsdauer von N Minuten (z.B. 90 Minuten bei Einzeltickets) umfassen.

2.3.3 Prüfung der Kontrollregeln Beim Kontrollvorgang müssen die Kontrollgeräte nach erfolgreicher Prüfung auf den Gültigkeitszeit-

raum und räumliche Gültigkeit (stehen im EFS) alle Kontrollregeln abarbeiten, die für das gefunde-

ne Produkt und den aktuellen Zeitpunkt gelten. Die automatisierte Prüfung ist dann erfolgreich

abgeschlossen, wenn alle für den Zeitpunkt geltenden Kontrollregeln vom Typ „U“, die automati-

siert prüfbar sind (Pruefungsmodus = „A“), nicht verletzt worden sind.

Ist für einen Fahrausweis eine Kontrollgruppe angegeben, so sind aus dieser Menge von Kontrollre-

geln nur die anzuwenden, bei denen

 eine der Tagnummern des TagTyps (TagTypName) gleich einer der ermittelten

Tagnummern ist

 keine der Tagnummern des Ausschluss-TagTyps (TagTypNameAusschluss) gleich

einer der ermittelten Tagnummern ist (Bsp.: Wenn die Kontrollregel nicht an Fei-

ertagen gelten soll, muss ein Ausschluss-TagTyp angegeben werden, der die Tag-

nummer 8 enthält.)

 das Zeitfenster (Uhrzeit_von – Uhrzeit_bis) den aktuellen Zeitpunkt einschließt

Einen Sonderfall stellen die Kontrollregeln vom Typ „R“ dar: diese müssen auch überprüft werden,

falls die Prüfung des räumlichen Gültigkeitsbereichs fehlgeschlagen ist (Bsp.: Ein SchülerTicket ist

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 21 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

nach 14 Uhr für das gesamte Netz gültig.), da diese den Gültigkeitsbereich evtl. erweitern.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 22 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

3 Abbildung WT-POB auf Basis Referenz AFB

Die Ausgabe der Berechtigung für den WT-POB Tarif erfolgt auf der Basis Referenz-AFB (siehe

[SPEC-NM]) mit der Produktnummer 9002 (siehe [ANW_PROD] 3.4), dem Erfassungsschlüssel

5000 und der PV_ID des WT. Da bei POB-Produkten verschiedene nachgelagerte Abrechnungsvari-

anten möglich sind, werden diese über ein Kennzeichen in die Berechtigung (Attribut afbPreisPara-

meter) geschrieben.

3.1 Attribute der Berechtigung

Produktnummer: 9002

Tabelle 6: [SPEC-NM] Tabelle 5-82 Separate Daten Berechtigung AFB Statischer produktspezifischer

Teil

Aktuell vorgesehen sind die Vertragsvarianten „Tagesbestpreis“, „Tagesbestpreis Hamm“ und

„Flexabonnement“. Sie werden in der Berechtigung über das Attribut afbPreisParameter gesteuert.

Tabelle 7: Vertragsvarianten der POB-Produkte

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 23 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Die Abrechnungsvarianten werden z.Z. von den Stadtwerken Münster wie folgt angewendet:

 Tagesbestpreis

Dem Kunden werden zunächst Einzeltickets berechnet. Übersteigt die Summe eines Be-

triebstages den Preis eines Tagestickets, ist der Preis eines Tagestickets statt der Einzelti-

ckets für den Betriebstag zu berechnen.

 Flexabonnement

Der Kunde besitzt ein zeitbegrenztes Abo und kann ab der gewählten Zeitgrenze bis Be-

triebsschluss ohne Mehrkosten fahren. Für CIs außerhalb seines Abos wird ihm pro Be-

triebstag einmal ein Betrag zusätzlich berechnet. Übersteigt die Summe aller Kosten den

Preis eines Monatsabos, wird dem Kunden nur der Preis eines Monatsabos in Rechnung ge-

stellt.

Hinweis: TXAEBER ist aktuell in der KA fehlerhaft spezifiziert und kann in der Version nicht 1.1.09

verwendet werden, da kein Bezug zur Berechtigung hergestellt ist. Als Konsequenz hieraus ge-

schieht die Änderung der Abrechnungsvariante über Rücknahme der POB und der Ausgabe einer

neuen Berechtigung mit geänderter Abrechnungsvariante. Dieser Fehler wurde durch den CR 134

korrigiert, der ab Version 1.3 verpflichtend ist.

3.2 Transaktionen

Es werden nur Transaktionen betrachtet, in denen WT-Spezifika abgebildet werden.

3.2.1 Berechtigungsausgabe (NM-Transaktionsdaten für TXABER)

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 24 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 8: [SPEC-NM] Tabelle 5-50 „Transaktion produktspezifischer Teil – Referenz AFB“

3.2.2 Fahrttransaktion / CI (NM-Transaktionsdaten für TXEBER) Beim CI wird durch den Validator geprüft, ob bereits ein gültiger CI als letzte Transaktion auf dem

NM eingetragen ist. Im negativen Fall oder auf Anforderung des Nutzers wird eine Fahrttransaktion

TXEBER geschrieben. Dieser, beim CI erzeugte TXEBER ist gemäß [Spec_HD_BOM], Tabelle 6-37

mit dem NM Transaktionstyp_CODE [16] zu versehen.

Tabelle 9: [SPEC_NM] Tabelle 5-50 Datenstruktur „Transaktion Produktspezifischer Teil – Referenz

AFB“

Struktur/Attribut TAG Bytes Inhalt

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 25 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Kontrolle

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 26 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Kontrolle Tabelle 10: [SPEC_NM] Tabelle 5-46 Datenstruktur „Allgemeine Fahrttransaktionsdaten“

Die Durchführung eines CI auf Basis einer POB wird im WT-Tarif nach folgendem Verfahren reali- siert:

1. Ermittlung ob gültige Berechtigung mit Produktnummer 9002 auf NM vorhanden ist
2. Ermittlung der Abrechnungsvariante aus dem Feld afbPreisParameter der Berechtigung 9002
3. Ermittlung eines internen Produktes (Kontrollprodukt), welches im Produktmodul definiert ist. Die Ermittlung erfolgt über die beiden Attribute Produktnummer (9002) und Abrech- nungsvariante (siehe 2.)
4. Codierung der Produktnummer und Preisstufennummer des Kontrollproduktes und Speiche- rung im Feld afbLogDynamischeRabattParameter im produktspez. Teil der TXEBER (Tabelle 9).
5. Ermittlung der Ortsnummer der Haltestelle über Produktmodul und Speichern der Ortnum- mer und des aktuellen Zeitstempels in der Datenstruktur „Allgemeine Fahrttransaktionsda- ten“ (Tabelle 10)
6. Speichern der CI-TXEBER als letzte Transaktion der POB.

Beim Fehlerhandling ist folgendes zu beachten: Sofern das Schreiben des CI auf das NM fehlerhaft war, wird ein TXTRANSABBRUCH vom DLT er- zeugt. Hierbei gibt es zwei Fallunterscheidungen: a. Das Schreiben des CI auf dem NM hat grundsätzlich nicht funktioniert: In diesem Fall wird ein TXTRANSABBRUCH erzeugt b. Die finale Bestätigung, dass der CI geschrieben, ist ausgeblieben („OK“ nach Send Receipt fehlt oder ist fehlerhaft) : In diesem Fall wird ein TXEBER und ein TXTRANSABBRUCH er- zeugt

Hinweis: Beim Fahrgasthinweis „Ticket erneut vorhalten“ am DLT soll TXTRANSABBRUCH nicht erzeugt werden, außer es wurden bereits Zähler verändert, die zur Vollständigkeitsprüfung der Transaktionen herangezogen werden (SAMSeqNummer oder berLogSeqNummer).

3.2.3 Kontrolltransaktion (NM-Transaktionsdaten für TXEBER) Gemäß [Spec_HD_BOM], Tabelle 6-37 wird bei einer Kontrolle im Gegensatz zu einem CI eine

Transaktion TXEBER mit dem NM Transaktionstyp_CODE [59] erzeugt.

Die Transaktion ist gem. [SPEC_NM] Tabelle 5-32 zu erzeugen, alle produktspezifischen Teile der

letzten Transaktion sind unverändert zu übernehmen, nur die „Allgemeinen Transaktionsdaten“ und

die berLogSeqNummer in den „Allgemeinen Fahrttransaktionsdaten“ werden angepasst (siehe

[SYSLH_RTDL]). Als logTransaktionsTyp.code ist der Wert 27 (Kontrolle nach CI) zu verwenden.

Wenn die letzte Transaktion keine „Allgemeinen Fahrttransaktionsdaten“ enthält, sind diese ent-

sprechend [SysLH_RTDL] zu gestalten.

3.2.4 Berechtigung zurücknehmen (NM-Transaktionsdaten für TXRBER) Die Transaktion mit dem Transaktionstyp-Code 0xf9 und NM Transaktionstyp_CODE [25] ist gem.

[SPEC_NM] Tabelle 5-40 zu erzeugen, alle produktspezifischen Teile der letzten Transaktion sind

unverändert zu übernehmen, nur die „Allgemeinen Transaktionsdaten“ werden angepasst (siehe

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 27 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

[SYSLH_RTDL]).

3.2.5 Berechtigung sperren (NM-Transaktionsdaten für TXSNAWB) Die Transaktion ist gem. [SPEC_NM] Tabelle 5-34 mit Transaktionstyp_CODE [47] zu erzeugen,

alle produktspezifischen Teile der letzten Transaktion sind unverändert zu übernehmen, nur die

„Allgemeinen Transaktionsdaten“ werden angepasst (siehe [SYSLH_RTDL]).

3.2.6 Berechtigung entsperren (NM-Transaktionsdaten für TXSNAWA) Die Transaktion ist gem. [SPEC_NM] Tabelle 5-34 mit Transaktionstyp_CODE [51] zu erzeugen,

alle produktspezifischen Teile der letzten Transaktion sind unverändert zu übernehmen, nur die

„Allgemeinen Transaktionsdaten“ werden angepasst (siehe [SYSLH_RTDL]).

3.2.7 Tarifparameter ändern (TXAEBER) Mit der TXAEBER Transaktion wird die Änderung der Abrechnungsart einer Berechtigung durch den

KVP an den PV gemeldet.

Diese Funktion wird bei POB im WT-Tarif derzeit nicht unterstützt. Die Änderung der Tarifparame-

ter geschieht über Rücknahme der Berechtigung und Ausgabe einer neuen Berechtigung.

Hinweis: TXAEBER ist aktuell in Version 1.109 fehlerhaft spezifiziert, wurde aber durch den CR 134

korrigiert, der ab Version 1.3 verpflichtend ist.

3.2.8 Nutzertarifparameter ändern (TXAENBER) Das Ändern der Nutzertarifparameter wird derzeit im WT nicht genutzt.

3.3 Kontrolle des POB-Tarifs

Die Definition des POB-Tarifs des WT ist eine spezielle Ausprägung, die es im Tariffenster des WT

im Moment nicht zulässt, POB anderer Organisationen als des WT zu unterstützen. Das liegt daran,

dass aktuell keine Clearing-Verträge mit anderen Primär-KVP existieren, über die Fahrten von Ti-

ckets anderer Organisationen abgerechnet werden können, bzw. keine Anbindung an eine Clearing-

stelle umgesetzt ist.

Deshalb ist bei 9002 immer zu prüfen, ob es von der Organisation_ID.organisationsNummer 77

ausgegeben wurde.

Die Kontrolle eines CI zu POB erfolgt immer über die letzte Transaktion der POB. Die tarifliche Gül-

tigkeit eines CI wird folgendermaßen festgestellt:

1. Ermittlung, ob auf NM gültige Berechtigung mit Produktnummer 9002 und Organisati-

on_ID.organisationsNummer 77 (WT) vorliegt.

2. Prüfen, ob in der letzten Transaktion der POB im Feld afbLogDynamischeRabattParameter

ein Verweis auf ein Kontrollprodukt gespeichert ist (siehe Tabelle 9)

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 28 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

3. Ermittlung des Zeitpunktes eines CI aus dem Feld logTransaktionsZeitpunkt der Struktur

„Fahrtabschnittstransaktion – Fahrtbeginn“ (siehe Tabelle 10)

4. Bei ermittelbarem Verweis auf Kontrollprodukt: Ermittlung der Gültigkeit eines CI über

Kontrollprodukt und Zeitstempel mit Hilfe der Kontrollregeln des Produktmoduls.

5. Wenn kein gültiger CI vorgefunden wird:

 Erzeugung neuer CI

6. Wenn gültiger CI vorgefunden wird:

 Anzeigen Restlaufzeit der Gültigkeit. Auf manuell signalisierten Wunsch des Nutzers hin

erfolgt ein neuer CI

 Bei nicht gewünschtem neuem CI folgt Erzeugung eines Kontrollnachweises (TXEBER,

3.2.3).

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 29 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

4 Abbildung WT-WEB auf Basis Referenz WEB

Die Ausgabe der Berechtigung für den WT-POB-Tarif erfolgt auf der Basis Referenz-WEB (siehe

[SPEC-NM]) mit der Produktnummer 9003 (siehe [ANW_PROD] 3.4), dem Erfassungsschlüssel

5902 und der PV_ID des WT.

4.1 Attribute der Berechtigung

Produktnummer: 9003

Tabelle 11: [SPEC-NM] Tabelle 5-85 „Separate Daten - Berechtigung Referenz WEB - Statischer pro-

duktspezifischer Teil“

Sofern für NM Pfand kassiert wird, ist der Pfandbetrag mit der Ausgabe der WEB in das Datenele-

ment webMinimumBetrag des statisch produktspezifischen Teils einzutragen.

Beim WEB-Tarif gibt es keine Abrechnungsvarianten, sodass in der Berechtigung keine WT-

spezifischen Vertrags- / Abrechnungsvarianten gespeichert werden müssen.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 30 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Hinweis: TXAEBER ist aktuell in der KA fehlerhaft spezifiziert und kann in der Version nicht 1.1.09

verwendet werden, da kein Bezug zur Berechtigung hergestellt ist. Als Konsequenz hieraus ge-

schieht die Änderung der Abrechnungsvariante über Rücknahme der POB und der Ausgabe einer

neuen Berechtigung mit geänderter Abrechnungsvariante. Dieser Fehler wurde durch den CR 134

korrigiert, der ab Version 1.3 verpflichtend ist.

4.2 Transaktionen

Es werden nur Transaktionen betrachtet, in denen WT-Spezifika abgebildet werden.

4.2.1 Berechtigungsausgabe (NM-Transaktionsdaten für TXABER) Produktnummer: 9003

Tabelle 12: [SPEC-NM] Tabelle 5-51 „Transaktion produktspezifischer Teil – Referenz WEB“

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 31 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

4.2.2 Aufbuchung (NM-Transaktionsdaten für TXEBER) Die Transaktion ist gem. [SPEC_NM] Tabelle 5-32 zu erzeugen, alle produktspezifischen Teile der

letzten Transaktion sind zu übernehmen. Die Datenelemente zu den Werteinheiten müssen jedoch

angepasst werden. Die „Allgemeinen Transaktionsdaten“ und die berLogSeqNummer in den „Allge-

meinen Fahrttransaktionsdaten“ werden angepasst (siehe [SYSLH_RTDL]). Wenn die letzte Trans-

aktion keine „Allgemeinen Fahrttransaktionsdaten“ enthält, sind diese entsprechend SysLH_RTDL

zu gestalten.

Dieser beim Aufbuchen erzeugte TXEBER wird gemäß [Spec_HD_BOM], Tabelle 6-37 mit dem NM

Transaktionstyp_CODE [91] versehen.

Tabelle 13: [SPEC_NM] Tabelle 5-51 „Transaktion Produktspezifischer Teil – Referenz WEB“

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 32 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 33 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Kontrolle

Tabelle 14: Tabelle 5-46 Datenstruktur „Allgemeine Fahrttransaktionsdaten“

4.2.3 Leistungserfassung / CI (Fahrt) (NM-Transaktionsdaten für TXEBER) Beim CI wird durch den Validator geprüft, ob bereits ein gültiger CI als letzte Transaktion auf dem

NM eingetragen ist. Im negativen Fall wird bei ausreichendem Guthaben der WEB eine Fahrttrans-

aktion TXEBER geschrieben. Dieser beim CI erzeugte TXEBER ist gemäß [Spec_HD_BOM], Tabelle

6-37 mit dem NM Transaktionstyp_CODE [16] zu versehen.

In der ersten Ausbaustufe wird beim WT automatisch beim CI ein „90-Minuten-Ticket, Preisstufe 0“

gespeichert. Die Menge der verbrauchten WE wird im Attribut webLogAbbuchung gespeichert, der

Restwert der WEB wird im Attribut webLogWertVerbleibend vermerkt.

Bei nicht ausreichendem Guthaben wird das NM abgewiesen.

Produktnummer: 9003

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 34 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 15: [SPEC_NM] Tabelle 5-51 Datenstruktur „Transaktion Produktspezifischer Teil – Referenz

WEB“

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 35 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Kontrolle

Tabelle 16: [SPEC_NM] Tabelle 5-46 Datenstruktur „Allgemeine Fahrttransaktionsdaten“

Die Durchführung eines CI in Verbindung mit einer WEB wird im WT-Tarif nach folgendem Verfah- ren realisiert:

1. Ermittlung, ob gültige Berechtigung mit Produktnummer 9003 auf NM vorhanden ist
2. Ermittlung eines internen Produktes (Kontrollprodukt), welches im Produktmodul definiert ist. Die Ermittlung erfolgt über die Produktnummer (9003)
3. Codierung der Produktnummer und Preisstufennummer des Kontrollproduktes und Speiche- rung im Feld afbLogDynamischeRabattParameter im produktspez. Teil der neuen CI- Transaktion TXEBER (Tabelle 15).
4. Ermittlung der Ortsnummer der Haltestelle über Produktmodul und Speichern der Ortnum- mer und des aktuellen Zeitstempels in der Datenstruktur „Allgemeine Fahrttransaktionsda- ten“ (Tabelle 16)
5. Speichern der CI-TXEBER als letzte Transaktion in der WEB.
6. Reduktion des WEB-Wertes um den Preis des Kontrollproduktes Beim Fehlerhandling ist folgendes zu beachten:

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 36 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Sofern das Schreiben des CI auf das NM fehlerhaft war, wird ein TXTRANSABBRUCH vom DLT er- zeugt.

Hierbei gibt es zwei Fallunterscheidungen:

c. Das Schreiben des CI auf dem NM hat grundsätzlich nicht funktioniert: In diesem Fall wird ein TXTRANSABBRUCH erzeugt d. Die finale Bestätigung, dass der CI geschrieben, ist ausgeblieben („OK“ nach Send Receipt fehlt oder ist fehlerhaft) : In diesem Fall wird ein TXEBER und ein TXTRANSABBRUCH er- zeugt

Hinweis: Beim Fahrgasthinweis „Ticket erneut vorhalten“ am DLT soll TXTRANSABBRUCH nicht

erzeugt werden, außer es wurden bereits Zähler verändert, die zur Vollständigkeitsprüfung der

Transaktionen herangezogen werden (SAMSeqNummer oder berLogSeqNummer).

4.2.4 Kontrolltransaktion (NM-Transaktionsdaten für TXEBER) Gemäß [Spec_HD_BOM], Tabelle 6-37 wird bei einer Kontrolle im Gegensatz zu einem CI eine

Transaktion TXEBER mit dem NM Transaktionstyp_CODE [59] erzeugt.

Die Transaktion ist gem. [SPEC_NM] Tabelle 5-32 zu erzeugen, alle produktspezifischen Teile der

letzten Transaktion sind unverändert zu übernehmen, nur die „Allgemeinen Transaktionsdaten“ und

die berLogSeqNummer in den „Allgemeinen Fahrttransaktionsdaten“ werden angepasst (siehe

[SYSLH_RTDL]). Als logTransaktionsTyp.code ist der Wert 27 (Kontrolle nach CI) zu verwenden.

Wenn die letzte Transaktion keine „Allgemeinen Fahrttransaktionsdaten“ enthält, sind diese ent-

sprechend SysLH_RTDL zu gestalten.

4.2.5 Berechtigung zurücknehmen (NM-Transaktionsdaten für TXRBER) Die Transaktion ist gem. [SPEC_NM] Tabelle 5-40 zu erzeugen, alle produktspezifischen Teile der

letzten Transaktion sind unverändert zu übernehmen, nur die „Allgemeinen Transaktionsdaten“

werden angepasst (siehe [SYSLH_RTDL]).

Bei Auflösung des WEB-Vertrages wird die Berechtigung vom NM zurückgenommen. Das gesamte

Restguthaben incl. Mindestbetrag wird dem Nutzer erstattet. Die Rücknahme einer WEB-

Berechtigung darf nur durch den Vertrag führenden KVP erfolgen!

4.2.6 Berechtigung sperren (NM-Transaktionsdaten für TXSNAWB) Die Transaktion ist gem. [SPEC_NM] Tabelle 5-34 zu erzeugen, alle produktspezifischen Teile der

letzten Transaktion sind unverändert zu übernehmen, nur die „Allgemeinen Transaktionsdaten“

werden angepasst (siehe [SYSLH_RTDL]).

4.2.7 Berechtigung entsperren (NM-Transaktionsdaten für TXSNAWB) Die Transaktion ist gem. [SPEC_NM] Tabelle 5-34 zu erzeugen, alle produktspezifischen Teile der

letzten Transaktion sind unverändert zu übernehmen, nur die „Allgemeinen Transaktionsdaten“

werden angepasst (siehe [SYSLH_RTDL]).

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 37 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

4.2.8 Tarifparameter ändern (TXAEBER) Das Ändern der Tarifparameter wird derzeit im WT-Tarif nicht unterstützt, da es keine änderbaren

Tarifparameter gibt.

4.2.9 Nutzertarifparameter ändern (TXAENBER) Das Ändern der Nutzertarifparameter wird derzeit im WT-Tarif nicht genutzt.

4.3 Kontrolle des WEB-Tarifs

Die Definition des WEB-Tarifs der WestfalenTarif GmbH ist eine spezielle Ausprägung, die es im

Tariffenster der WestfalenTarif GmbH im Moment nicht zulässt, WEB anderer Primär-KVP als der

WestfalenTarif GmbH zu unterstützen. Das liegt daran, dass aktuell keine Clearing-Verträge mit

anderen Organisationen existieren, über die Fahrten von Tickets anderer Organisationen abgerech-

net werden können, bzw. keine Anbindung an eine Clearingstelle umgesetzt ist.

Die Kontrolle eines CI zu WEB erfolgt immer über die letzte Transaktion der WEB. Die tarifliche

Gültigkeit eines CI wird im folgendermaßen festgestellt:

1. Ermittlung, ob auf NM gültige Berechtigung mit Produktnummer 9003 und Organisati-

on_ID.organisationsNummer 77 (WT) vorliegt.

2. Prüfen, ob in der letzten Transaktion der WEB im Feld afbLogDynamischeRabattParameter

ein Verweis auf ein Kontrollprodukt gespeichert ist (siehe Tabelle 15)

3. Ermittlung des Zeitpunktes eines CI aus dem Feld logTransaktionsZeitpunkt der Struktur

„Fahrtabschnittstransaktion – Fahrtbeginn“ (siehe Tabelle 16)

4. Bei ermittelbarem Verweis auf Kontrollprodukt, Ermittlung der Gültigkeit eines CI über Kon-

trollprodukt und Zeitstempel mit Hilfe der Kontrollregeln des Produktmoduls.

5. Wenn kein gültiger CI vorgefunden wird:

 Erzeugung neuer CI

6. Wenn gültiger CI vorgefunden wird:

 Anzeigen Restlaufzeit der Gültigkeit. Auf manuell signalisierten Wunsch des Nutzers hin

erfolgt ein neuer CI

 Bei nicht gewünschtem neuen CI folgt Erzeugung eines Kontrollnachweises (TXEBER,

3.2.3

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 38 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

5 Westfälisches (WTB) Produktmodul

Der PV (des Westfalentarifs) sowie die einzelnen Tariffenster des Westfalentarifs definieren die zu

verkaufenden und zu prüfenden Produkte, die Gültigkeit der Produkte und legen die Relationen im

Tarifgebiet fest. Diese Definitionen werden über eine Schnittstelle zu den jeweils angeschlossenen

KVP übertragen.

Mit dem Produktmodul werden prinzipiell folgende Typen von Produkten versorgt:

 Produkte, die als eTickets des PV WTB ausgegeben werden

 Produkte, die nur geprüft werden

eTickets anderer PVs, z.B. NRW-weit gültige eTickets

 Produkte, die auf herkömmliche Art verkauft werden

Die PV-Daten werden als XML-Datei basierend auf den Basistypen der Schemata aus [ST_KIT] und

http://www.w3.org/2001/XMLSchema (Präfix: xs) geliefert.

Das Produktmodul wird mit all seinem Elementen und Attributen ausführlich beschrieben, die zuge-

hörige XSD-Datei zur formalen Definition der XML-Strukturen kann zur Verfügung gestellt werden.

Das Datenmodell der WTB-Anwendung wird nicht dargestellt.

In den nachfolgenden Tabellen wird in der zweiten Spalte „Typ (Länge), Pflichtfeld, Index, Refe-

renz“ nach dem Datentyp angegeben, ob es sich um ein Pflichtfeld („P“) handelt und ob das Feld

einen eindeutigen Wert besitzen muss, ggf. in Kombination mit weiteren Feldern („E1“ – die mit

„E1“ gekennzeichneten Felder des Abschnitts bilden gemeinsam einen eindeutigen Schlüssel, ande-

re Feldes eines Abschnittes können auch weitere eindeutige Schlüssel bilden, die entsprechenden

Felder sind dann mit „E2“ oder „E3“ gekennzeichnet). Zusätzlich wird in dieser Spalte ausgewiesen,

wenn es sich um einen Fremdschlüssel handelt und auf welchen Abschnitt dieser referenziert. Falls

der Attributname von dem des Fremdschlüssels abweicht, wird dieser in Klammern mit aufgeführt.

Das „Löschen“ von Datensätzen in der WTB wird intern durch das Setzen eines Aktiv-Kennzeichens

auf false abgebildet. Die „gelöschten“ Datensätze werden in das Produktmodul exportiert und dort

über das Attribut „KennzAktiv“ gekennzeichnet.

5.1 Produkte

Der PV (WTB) versorgt die KVPs mit Produktinformationen. Dieses geschieht über eine XML-

Schnittstelle, deren Aufbau in den folgenden Abschnitten definiert wird. Die Daten werden durch

die WTB online als Download allen eingerichteten Benutzern aus den Tariffenstern zur Verfügung

gestellt.

Hinweis: Leere bzw. Attribute mit Wert NULL werden nicht ins XML exportiert.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 39 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

5.1.1 Templates

Tabelle 17: Templates

5.1.2 Tariffenster

Tabelle 18: Tariffenster

5.1.3 Ticketarten

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 40 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 41 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 42 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 43 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 19: Ticketarten

5.1.4 Preisstufen

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 44 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 20: Preisstufen

5.1.5 Organisationen

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 45 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 21: Organisationen

5.1.6 Tarife

Tabelle 22: Tarife

5.1.7 Währungen

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 46 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 23: Währungen

5.1.8 Tickets

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 47 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 24: Tickets

5.1.9 Preise

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 48 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 25: Preise

5.1.10 Zeitfenster Zeitfenster können für POB-Produkte angegeben werden. Sie definieren die Bedingungen, die er-

füllt sein müssen, damit für einen Check-In eine Einzelfahrt berechnet wird.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 49 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 26: Zeitfenster

5.2 Räumliche Struktur

Das Tarifgebiet ist in verschiedene Einheiten wie Kooperationsräume, Kreise und Tarifgebiete, City- zonen, Zonen etc. unterteilt. Die Struktur der vom PV gelieferten Informationen hierzu wird in den folgenden Abschnitten definiert.

5.2.1 Kooperationsräume

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 50 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 27: Kooperationsräume

5.2.2 Kreise

Tabelle 28: Kreise

5.2.3 Flächentypen Typen von Flächen, z.B. können dies sein:

 Z – Zonen  C - Cityzonen  G - Tarifgebiet.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 51 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 29: Flaechentypen Es gibt verschiedene Kurzstreckentarife, die nicht im PKM und den anderen Schnittstellen ab- gebildet werden können. Maßgeblich sind die aktuell gültigen Tarifbestimmungen des West- falenTarifs, in denen die Kurzstreckenreglungen beschrieben werden.

5.2.4 Flächen Eine Fläche ist ein abstrakter Begriff, dessen jeweilige konkrete Ausgestaltung durch den Flächen- typ definiert wird.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 52 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 30: Flaechen

5.2.5 Relationen

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 53 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 54 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 31: Relationen

5.2.6 Ticketsortimente Tickets, die für eine Relation verkauft werden dürfen.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 55 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 32: Ticketsortimente

5.2.7 Geltungsbereiche Zuordnung von Flächen, in denen ein Kunde mit der angegebenen Relation zusätzlich zu Start und

Zielfläche fahren darf.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 56 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 33: Geltungsbereiche

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 57 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

5.3 WT-Kontrollregeln

Mit Einführung des EFS besteht die Möglichkeit, die Gültigkeit von Fahrscheinen automatisiert zu

prüfen. Hierzu definiert der PV zu den Produkten Kontrollregeln, die

 zeitliche Gültigkeiten wie z.B. „zwischen 05:00 Uhr und 07:59 Uhr ungültig“

 räumliche Gültigkeiten wie z.B. „gültig in Zone XY“

 sonstige Gültigkeiten wie z.B. „Fahrradmitnahme erlaubt“

festlegen, nach denen Validatoren oder EBE-Prüfgeräte die Karten prüfen können.

Im Folgenden wird der Inhalt festgelegt, der über die Schnittstelle vom PV übernommen wird.

5.3.1 Zeitliche Gültigkeit Fahrausweise können mit zeitlichen Gültigkeiten versehen werden. Das kann sowohl bedeuten,

dass sie z.B. montags bis freitags oder nur am Wochenende gelten. Ebenso gibt es Ausnahmen zu

Feiertagen. Die Struktur dieser Informationen wird im Folgenden definiert.

Praktisch wird bei automatisch prüfbarem Inhalt nicht der Zeitraum „gültig von … bis“ in den Kon-

trollregeln beschrieben sondern umgekehrt. Das bedeutet, es werden ungültige Zeiträume defi-

niert. Alle hiervon nicht berührten Zeiträume sind bzgl. dieser Eigenschaft als gültig anzuerkennen.

5.3.1.1 Tag-Typen Tag Typen setzen sich zusammen aus einem Namen und einer Menge von Tagen, zu denen eine

Kontrollregel eine Eigenschaft definiert.

Die Tag-Typen sind ein Konstrukt, um die „wochentagsbezogene“ Gültigkeit abzubilden. Ein Tag-

Typ umfasst ein oder mehrere Wochentage, wobei neben den eigentlichen Tagen (TagNummer: 1 –

Mo, 2 – Di, ... 7 – So) auch noch Feiertage (8) und Ferientage (9) hinzugenommen werden. Auf

diese Weise lassen sich flexibel z.B. folgende Tag-Typen konstruieren:

Tabelle 34: Zuordnung TagNummern zu TagTyp_Name

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 58 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Über die Schnittstelle geliefert werden folgende beiden Strukturen:

Tabelle 35: TagNummern

Tabelle 36: TagTypen

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 59 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 37: TagTypen_Tage

5.3.1.2 Feiertags- und Ferienkalender Für Feiertage und Ferienzeiten wird dieser NRW-Kalender geführt. Der zu einem Tarif relevante Teil

des Kalenders wird auf die Kontrollgeräte übertragen und ermöglicht die Überprüfung von Kontroll-

regeln, die z.B. an die besonderen Tagnummern wie 8 (Feiertag) und 9 (Ferientag) geknüpft sind.

Tabelle 38: Feiertage_Ferien

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 60 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

5.3.2 Mitnahmeregeln Mitnahmeregeln definieren, wie viel Objekte mitgenommen werden dürfen.

Tabelle 39: Mitnahmeregeln

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 61 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

5.3.3 Räumliche Gültigkeit Relationsnummern beschreiben die räumliche Gültigkeit eines Fahrausweises. Sie umfassen belie-

big viele Ortnummern; diese werden als Listen auf die Kontrollgeräte geladen.

5.3.3.1 Relationsnummern

Tabelle 40: Relationsnummern

5.3.3.2 Ortnummern

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 62 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 41: Ortnummern

5.3.4 Kontrollgruppen und Regeln

5.3.4.1 Kontrollgruppen Eine Kontrollgruppe definiert eine Menge von einzelnen Kontrollregeln.

Tabelle 42: Kontrollgruppen

Einer Kontrollgruppe werden Kontrollregeln zugeordnet.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 63 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

5.3.4.2 Kontrollgruppen_Kontrollregeln

Tabelle 43: Kontrollgruppen_Kontrollregel

5.3.4.3 Kontrollregeln Kontrollregeln definieren die Inhalte, die zu prüfen sind.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 64 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 44: Kontrollregeln

5.4 Haltestellen

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 65 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 45: Haltestelle

Die Haltestellendaten werden nur informativ im Produktmodul mitgeliefert. Da weder die Vollstän-

digkeit noch die Aktualität der Daten gewährleistet ist, wird deren Verwendung in operativen Sys-

temen nicht empfohlen!

5.5 Ergänzende Beschreibung zum technischen Aufbau des WT-PKM

Ergänzend liefert dieses Kapitel eine kompakte und übersichtliche Darstellung der eindeutigen

Schlüssel und der Beziehungen zwischen den Datenelementen. Die Darstellung soll ein schnelles

Verständnis für den Aufbau und die Funktionsweise des WT-PKM fördern.

5.5.1 Eindeutiger Schlüssel der Datenelemente

Die Benennung der Abschnitte und Elemente in der XML-Struktur basiert primär auf Einzahl und

Mehrzahl. Teilweise musste aufgrund der Besonderheiten der deutschen Sprache von diesem An-

satz abgewichen werden. Betreffende Stellen sind in der folgenden Darstellung gelb hervorgeho-

ben. In einer Zeile sind die Attribute eines Elements aufgeführt, die zusammen einen eindeutigen

Schlüssel bilden. Aus fachlichen Gründen können für ein Element auch mehrere Schlüssel (E1, E2,

…) existieren.

5.5.1.1 Produkte

Templates > Template

E1: TemplateBez

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 66 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tariffensterliste > Tariffenster:

E1: TariffensterCode

Ticketarten > Ticketart:

E1: TicketartCode

E2: ProduktNummer - OrganisationID - Abrechnungsvariante

Preisstufen > Preisstufe:

E1: PreisstufeCode

E2: PreisstufeNummer

Tarife > Tarif:

E1: TarifCode

Waehrungen > Waehrung:

E1: WaehrungCode

E2: WaehrungNr

Ticketliste > Ticket:

E1: TicketartCode - PreisstufeCode

Preise > Preis:

E1: TicketartCode - PreisstufeCode -TarifCode - WaehrungCode

Zeitfensterliste > Zeitfenster:

E1: TicketartCode - ZeitpunktVon - ZeitpunktBis - OderGruppe - TagTypName

5.5.1.2 Räumliche Struktur

Kooperationsraeume > Kooperationsraum:

E1: KooperationsraumCode

Kreise > Kreis:

E1: KooperationsraumCode - KreisCode

Flaechentypen > Flaechentyp:

E1: FlaechentypCode

E2: FlaechentypNummer

Flaechen > Flaeche:

E1: FlaechenNummer

E2: OrtNummer - OrganisationID

Relationen > Relation:

E1: RelationBez

E2: Relationsnummer

Ticketsortimente > Ticketsortiment:

E1: RelationBez - TicketartCode

Geltungsbereiche > Geltungsbereich:

E1: RelationBez – GeltungsbereichFlaecheLfnr

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 67 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

5.5.1.3 Kontrollregeln

TagNummern > TagNummer:

E1: TagNummer

E2: TagNummerBez

TagTypen > TagTyp:

E1: TagTypName

TagTypen_Tage > TagTyp_Tage:

E1: TagTypName - TagNummer

Feiertage_Ferien > Kalendertag:

E1: OrganisationID - TagVon – TagBis - TagNummer

Mitnahmeregeln > Mitnahmeregel:

E1: MitnahmeregelName

Relationsnummern > Relationsnummer:

E1: Relationsnummer - OrganisationID

Ortnummern > Ortnummer:

E1: Relationsnummer - OrganisationIDRelNr - Ortnummer - OrganisationID

Kontrollgruppen > Kontrollgruppe:

E1: KontrollgruppeName

Kontrollgruppen_Kontrollregeln > Kontrollgruppe_Kontrollregel:

E1: KontrollgruppeName - KontrollregelName

Kontrollregeln > Kontrollregel:

E1: KontrollregelName

5.5.2 Beziehungen zwischen Datenelementen

Aufgrund der Attributnamen von Fremd- und Primärschlüssel sind nicht alle Beziehungen zwischen

den Datenelemente auf den ersten Blick erkennbar. Die folgenden Anmerkungen sollten für ein

besseres Verständnis des unter 5.5.3 dargestellten ER-Diagramm des WT-PKM sorgen und auch auf

– aus Gründen der Übersicht – nicht dargestellte Beziehungen hinweisen:

Relation  Relationsnummer:

Da das Relation-Element nur das Attribut Relationsnummer als Fremdschlüssel zum Verweis auf

das Relationsnummer-Element hat und nicht über ein Attribut OrganisationsID verfügt, wurde im

ER-Diagramm des WT-PKM der eindeutige Schlüssel des Relationsnummer-Elements „nur“ aus

dem Attribut Relationsnummer gebildet.

Das Attribut OrganisationsID der Relationsnummer –Elemente sollte ohnehin immer auf 77 ste-

hen.

Da das Attribut Relationsnummer für das Relation-Element den zweiten eindeutigen Schlüssel

(E2) bildet, muss das Attribut Relationsnummer auch ohne Attribut OrganisationsID für das Re-

lationsnummer-Element eindeutig sein.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 68 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Aktuell ist im WestfalenTarif die OrganisationsID für Relationsnummern immer die 77.

Relation  Preisstufe:

Ein Relation-Element verweist über das Attribut PreisstufeNummerHaupt auf den zweiten eindeu-

tigen Schlüssel (E2) über das Attribut PreisstufeNummer eines Preissufe-Elements. Diese Bezie-

hung ist aus Gründen der Übersicht nicht im Diagramm dargestellt.

Haltestelle  Zonen:

Ein Haltestelle-Element kann mehreren Zone-Elementen zugeordnet sein. Daher besteht zwi-

schen Haltestelle-Elementen und Zonen-Elementen eine n-m–Beziehung, die in einer Datenbank

als Verbindungstabelle über die Attribute HaltestelleID und ZonenNummer abgebildet werden

kann und im ER-Diagramm des WT-PKM entsprechend dargestellt ist.

Zu beachten ist, dass das Zonen-Element mit dem Attribut ZonenNummer auf das Attribut Flaeche-

Nummer des Flaeche-Elements verweist. Allerdings ist nicht sichergestellt, dass für jedes Zonen-

Element ein Flaeche-Element und für jedes Flaeche-Element eine Zonen-Element vorhanden ist.

Diese Beziehung ist aus Gründen der Übersicht nicht im Diagramm dargestellt.

Ticketart  Medientyp:

Einem Ticketart-Element können mehrere Medientyp-Elemente zugeordnet sein. Daher besteht

zwischen Ticketart-Elementen und Medientyp-Elementen eine n-m–Beziehung, die in einer Da-

tenbank als Verbindungstabelle über die Attribute MedientypNummer und TickartartCode abgebil-

det werden kann.

Ticketart  Ticketart:

Ein Ticketart-Element verweist über die Attribute KontrollTicketartCode, EinzelfahrtTicke-

tartCode, TagesmaxTicketartCode, MonatsGrundTicketartCode, MonatsMaxTicketartCode und

VorgaengerTicketartCode auf sich selbst. Diese Beziehung ist aus Gründen der Übersicht nicht im

Diagramm abgebildet.

Ticketart  Preisstufe:

Ein Ticketart-Element verweist über das Attribut KontrollPreisstufeCode auf ein Preisstufe-

Element. Diese Beziehung ist aus Gründen der Übersicht nicht im Diagramm dargestellt.

Flaeche, Kalendertag, Ortnummer, Relationsnummer, Tarif, Ticketart  Organisation

Die Elemente Flaeche, Kalendertag, Ortnummer, Relationsnummer, Tarif, Ticketart können mit

ihrem Attribut OrganisationID nicht auf das Element Organisation verweisen, da das Attribut

OrganisationID für das Element Organisation keinen eindeutigen Schlüssel bildet. Daher ist das

Element Organisation ohne Beziehungen dargestellt.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 69 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

5.5.3 WT-PKM als ER-Diagramm dargestellt

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 70 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Abbildung 2: WT-PKM als ER-Diagramm

6 Erläuterungen zum Vertriebs- und Kontrollprozess

Der WestfalenTarif wird in der „Westfälischen Tarifdatenbank“ (WTB) gepflegt und daraus allen

beteiligten Verkehrsunternehmen als WestfalenTarif-Produkt- und Kontrollmodul (WT-PKM) in Form

einer XML-Datei zur Verfügung gestellt. Das WT-PKM dient primär der Versorgung von Vertriebs-

und Kontrollsystemen mit tariflichen Daten, macht aber keine Vorgaben zu den eigentlichen Ver-

triebs- und Kontrollprozessen. Das WT-PKM aus der WTB basiert auf einem proprietärem Format

und entspricht nicht dem mit VDV-KA-Version 1.4 standardisierten Produkt- und Kontrollmodul.

Dieses Kapitel beschreibt pragmatisch, wie Vertriebs- und den Kontrollprozesse auf Basis des West-

falenTarif-Produkt- und Kontrollmoduls (WT-PKM) in den entsprechenden Systemen umgesetzt

werden kann.

6.1 Vertriebsprozess auf Basis des WT-PKM

Der Vertriebsprozess kann mit der Auswahl des Fahrweges (relationsbezogen) oder der Ticketart

(produkt- bzw. gattungsbezogen) beginnen.

6.1.1 Relationsbezogener Vertriebsprozess Beim relationsbezogenen Vertriebsprozess wird zunächst der Fahrweg ausgewählt und anschlie-

ßend die verkaufbaren Tickets aus dem zugehörigen Ticketsortiment ermittelt.

6.1.1.1 Auswahl der Relation

6.1.1.1.1 Ermittlung der Start- und Ziel-Flächen Die Ermittlung der Start- und Ziel-Flächen kann anhand der Flächen oder anhand von Haltestellen

erfolgen.

Das Attribut „FlaechenNummer“ der „Flaeche“-Elemente ist mit der Zonen-Nummer gefüllt, wobei

die Fläche auch ein Tarifgebiet sein kann. Der Gültigkeitszeitraum der „Flaeche“-Elemente ist im-

mer anhand der Attribute „gueltigVon“ und „gueltigBis“ auszuwerten. Das WT-PKM enthält schon

jetzt einige „Flaeche“-Elemente, deren Gültigkeit bis zum 01.08.2017 abgelaufen sein wird. Die

Bezeichnungen der abgelaufenen „Flaeche“-Elemente im Attribut „FlaecheBez“ sind zum Teil wenig

aussagekräftig.

Das Attribut „TariffensterCode“ im „Flaeche“-Element ist für den Vertriebsprozess nicht relevant. Es

gibt lediglich darüber Auskunft, welcher User (Tariffenster) das „Flaeche“-Element in der WTB ver-

waltet.

Die Verwendung der mit dem WT-PKM gelieferten Daten in den „Haltestelle“-Elementen z.B. für die

Ermittlung der Start- und Ziel-Flächen anhand von Haltestellen, wird – aufgrund der häufigen Än-

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 71 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

derungen - nicht empfohlen. Welche Haltestellendaten hierfür verwendet werden, liegt in der Ver-

antwortung der Verkehrsunternehmen. Eine zentrale Stelle, an der die Haltestellendaten im Gebiet

des WestfalenTarifs zusammen laufen, ist das EFA-System.

6.1.1.1.2 Ermittlung der Fahrwege für die Relation Mit den Start- und Ziel-Flächen werden die „Relation“-Elemente nach geeigneten Fahrwegen gefil-

tert.

Abbildung 3: Ermittlung der Fahrwege einer Relation anhand Start- und Ziel-Flaeche

Da die Relationen nur in einer Richtung gespeichert sind, wird primär mit

Start-Fläche = Attribut „ZonenNummerStart“ und Ziel-Fläche = Attribut „ZonenNummerZiel“

gesucht.

Weiterhin gelten auch Relationen in Gegenrichtung mit

Ziel-Fläche = Attribut „ZonenNummerStart“ und Start-Fläche = Attribut „ZonennNummerZiel“

für die das Attribut „GiltNichtInGegenrichtung“ nicht gesetzt ist.

Im Vertriebsprozess dürfen nur gültige „Relation“-Elemente berücksichtigt werden, was durch Aus-

wertung des Attributes „gueltigBis“ zu überprüfen ist.

Aufgrund von Mehrfachtarifierungen können für eine Start-Ziel-Relation mehrere Fahrwege gefun-

den werden. Die Anzeige kann in diesem Fall anhand des Attributs „Anzeigereihenfolge“ sortiert

werden.

Das Attribut „PreisstufeNummerHaupt“ gibt die Preisstufe des Fahrweges einer Relation an. Dem

Ticketsortiment des Fahrweges einer Relation können aber Produkte zugeordnet sein, deren Gel-

tungsbereich über den des Fahrweges hinausgeht und deren Preisstufe so über der Preisstufe der

Relation liegt. In diesen Fällen muss für die Ticketausstellung der zum teureren Produkt gehörende

größere Geltungsbereich ermittelt und verwendet werden (siehe 6.1.1.2.5), damit der Fahrgast

auch das nutzen kann, wofür er bezahlt hat.

Anhand des Attributs „TariffensterCode“ des „Relation“-Elements kann aus dem Attribut „EavCode“

des zugehörigen „Tariffenster“-Elements die erste Stelle des EAV-Codes ermittelt werden (siehe

6.1.1.2.6). Weiterhin gibt das Attribut „TariffensterCode“ darüber Auskunft, welcher User (Tarif-

fenster) das „Relation“-Element in der WTB verwaltet.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 72 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Das Attribut „MeldeCode“ der „Relation“-Elemente wird zur Ergänzung der Einnahmemeldung und

nicht zur Anzeige oder Ausdruck auf den Vertriebsterminals benötigt. Daher genügt es das Attribut

„MeldeCode“ in die Vertriebshintergrundsysteme zu übernehmen und anhand der Relationsnummer

des verkauften Fahrweges der Einnahmemeldung hinzuzufügen.

Werden keine Fahrwege für die Relation gefunden, muss mit übergeordneten Start- und Zielvorga-

ben gesucht werden (siehe 6.1.1.1.2). Wird dann auch nichts gefunden, handelt es sich nicht um

eine Relation des WestfalenTarifs und kann nicht verkauft werden.

6.1.1.1.3 Suche mit übergeordneten Start- und Zielvorgaben

Wenn der Vertriebsprozess nicht zum gesuchten Ticket geführt hat, kann dies daran liegen, dass

das gesuchte Ticket nicht in der angefragten Relation verfügbar ist. In diesem Fall kann die Suche

mit übergeordneten Flächen für Start und Ziel erneut gestartet werden.

Folgenden Kombinationen könnten dabei zielführend sein:

Abbildung 4: Rückfallebenen für Start- und Zielvorgaben

Durch das WT-PKM wird nicht vorgegeben, mit welcher Granularität die Suche begonnen und mit

welchen weiteren „Vergröberungen“ sie fortzuführen ist. Insbesondere die Suche nach Netzrelatio-

nen ist regional sehr unterschiedlich und wird nicht durch das WT-PKM gesteuert. Hierzu muss der

Verkäufer im Zweifelsfall über die erforderlichen Netzkenntnisse verfügen oder andere Strategien

zur Anwendung kommen, die außerhalb des WT-PKM liegen.

Ein automatischer Ansatz wird dadurch erschwert, dass die „Flaeche“-Elemente zwar ein Attribut

„FlaechenNummerUebergeordnet“ haben, sich damit aber keine vollständige Flächen-Hierarchie

aufbauen lässt, da nicht jede Fläche einer anderen eindeutig untergeordnet ist.

6.1.1.1.4 Ermittlung des Geltungsbereichs Die „Geltungsbereich“-Elemente werden mit dem Attribut „RelationsBez“ des Fahrwegs einer Rela-

tion ermittelt. Für die Geltungsbereiche, die anzuzeigen sind, ist das Attribut „Druckkennzeichen“

gesetzt. Die anzuzeigenden Geltungsbereiche sind über das Attribut „Prioritaet“ zu sortieren. Die

Bezeichnungen für die Geltungsbereiche sind den zugeordneten „Flaeche“-Elementen zu entneh-

men.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 73 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Abbildung 5: Ermittlung der Geltungsbereiche für den Fahrweg einer Relation

6.1.1.2 Von der Relation zum Ticket

6.1.1.2.1 Ermittlung der Relationsnummer

Für die Einnahmemeldung und die Erstellung elektronsicher Tickets (TLV-EFS) nach dem VDV-KA-

Standard (Chipkarte und Barcode) ist die Relationsnummer des Fahrwegs einer Relation erforder-

lich. Die Relationsnummer steht im Attribut „Relationsnummer“ der „Relation“-Elemente und ent-

spricht im VDV-KA-Standard der Raumnummer.

6.1.1.2.2 Ermittlung der Ortnummern

Die für die Erstellung elektronischer Tickets (TLF-EFS) erforderlichen Ortnummern werden mit den

Attributen „Relationsnummer“ und „OrganisationID“ des „Relationsnummer“-Elements eines Fahr-

wegs aus den „Ortnummer“-Elementen ermittelt.

Da bei der Abbildung im Tag „0xDC – Liste originärer Geltungsbereich“ eines elektronischen Tickets

die Relationsnummer und die Ortnummern zur gleichen OrganisationID gehören müssen, haben

auch die Attribute „OrganisationIDRelNr“ und „OrganisationID“ aller „Ortnummer“-Elemente immer

den gleichen Wert.

Die alternative Ermittlung der Ortnummern nebst OrganisationID für den Fahrweg einer Relation

aus den „Flaeche“-Elementen, die über die Attribute „ZonenNummerStart“ und „ZonenNummerZiel“

mit dem „Relation“-Element sowie über das Attribut „ZonenNummer“ mit den zum „Relation“-

Element gehörenden „Geltungsbereich“-Elementen verbunden sind, führt zum gleichen Ergebnis

wie aus den „Ortnummer“-Elementen.

Für den Vertriebsprozess sind die „Ortnummer“-Elemente (Ortnummern je Relationsnummer) da-

mit redundant.

Die Anzahl der „Ortnummer“-Elemente (Ortnummern je Relationsnummer) ist immer größer als die

Anzahl der „Geltungsbereich“-Elemente (Flächen zwischen Start und Ziel einer Relation), da in den

Ortnummern auch die „Flaeche“-Elemente von Start bzw. Ziel und (später) auch historische Kons-

tellationen stecken, die nicht mehr aktiv verkauft werden, aber noch auf Chipkarten unterwegs sein

können.

Da die Ortnummern nur bei Relationen, die aus maximal 8 verschiedenen Tarifgebieten oder Flä-

chen (Start-, Ziel- und Flächen des Geltungsbereiches) bestehen, in das elektronische Ticket (TLF-

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 74 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

EFS) geschrieben werden, muss nicht das komplette WT-PKM auf die (mobile) Vertriebsinfrastruk-

tur übertragen werden:

• Für den Verkauf von Papierfahrschienen und elektronischer Tickets ist nur der Teil der Gel-

tungsbereiche erforderlich, der für den Aufdruck gebraucht wird. Dieser lässt sich je Relati-

on vorberechnen.

• Für den Verkauf von elektronischen Tickets ist zusätzlich die Geltungsbereiche (oder Ort-

nummern) für die kurzen Relationen mit bis zu 8 Flächen erforderlich.

6.1.1.2.3 Ermittlung des Ticketsortiments für den Fahrweg einer Relation

Mit dem Attribut „RelationsBez“ des Fahrwegs einer Relation werden die für den Fahrweg verfügba-

ren „Ticketsortiment“-Elemente ermittelt, die auf die verkaufbaren Tickets verweisen.

6.1.1.2.4 Ermittlung der Tickets eines Ticketsortiments

Mit den Attributen „TicketartCode“ und „PreisstufeCode“ aus den „Ticketsortiment“-Elementen wer-

den die für den Fahrweg zugelassenen „Ticket“-Elemente ermittelt.

Abbildung 6: Ermittlung der Ticketdaten eines Ticketsortiments

Bei den referenzierten „Ticket“-Elementen ist auf deren Gültigkeitszeitraum (Attribute „gueltigVon“

/ „gueltigBis“) zu achten. Der Gültigkeitszeitraum erstreckt sich immer über ganze Kalendertage.

Aus den „Ticket“-Elementen lassen sich Angaben zur Gültigkeitsdauer (z.B. für Einzel- und 4er-

Tickets) und den Kontrollregeln ermitteln (über die Elemente „Kontrollgruppe“ und „Kontrollgrup-

pe_Kontrollregeln“ – siehe 6.2.1). Auch die Auswertung der Kontrollregeln kann im Vertrieb rele-

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 75 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

vant sein, wenn z.B. ein 9-Uhr-Ticket wochentags nicht für Fahrten vor 9 Uhr angeboten werden

soll.

Jedem Ticket ist über das Attribut „TicketartCode“ ein „Ticketarten“-Element und über das Attribut

„PreisstufenCode“ ein „Preisstufe“-Elemente zugeordnet. Das „Preis“-Element wird über die Kombi-

nation aus den Attributen „TicketartCode“ und „TicketartCode“ des „Ticket“-Elemente sowie dem

Attribut „Waehrungscode“ aus dem „Waehrung“-Element und dem Attribut „TarifCode“ aus dem

„Tarif“-Element für die gesuchte Tarifperiode und Tarifversion des WT-PKM ermittelt .

Auch die für die Einnahmemeldung erforderlichen Attribute „gueltigVon“ [Tarifstand - Erster Gültig-

keitstag eines Tarifes] und „TarifCode“ [Tarifversion - Differenzierung unterschiedlicher Tarifversio-

nen eines Tarifstandes] sind im „Tarif“-Element enthalten.

Jedes WT-PKM enthält immer nur einen Tarif.

Das Attribut „TariffensterCode“ in den Elementen „Ticket“, „Ticketart“, „Preis“ und „Kontrollregel“

sind für den Vertriebsprozess nicht relevant. Sie geben lediglich darüber Auskunft, welcher User

(Tariffenster) diese Elemente in der WTB verwaltet.

Die Gültigkeitszeiträume (Attribute „gueltigVon“ / „gueltigBis“) der „Ticketart“-, „Preisstufe“- und

„Tarif“-Elemente müssen nicht überprüft werden, da der Gültigkeitszeitraum des „Ticket“-

Elementes aus diesen von der WTB automatisch abgeleitet wurde.

Besonderheit bei alternativen Zonenwegen: Wenn im Attribut „ZonenwegAlternativ“ des „Ti-

cketart“-Elements der Wert „P“ steht, musst bei elektronischen Tickets (TLV-EFS) ein alternativer

Geltungsbereich (siehe 2.1.3) eingetragen werden. Da in Abhängigkeit vom Ticket ggf. mehrere

alternative Geltungsbereiche zur Auswahl stehen, müssen diese vom vertreibenden Verkehrsunter-

nehmen bei den Kunden erfragt werden.

Ist eine gewünschte Ticketart für die ausgewählte Relation nicht verfügbar, so muss in einer „über-

geordneten“ Relation auf Tarifgebiets- oder Netzebene gesucht werden (siehe 6.1.1.1.3).

6.1.1.2.5 Ermittlung Geltungsbereich für Tickets mit anderer „PreisstufeNummer“

Für Tickets deren Preisstufe („Preisstufe“-Element, Attribut „PreisstufeNummer“) von der Preisstufe

der Relation (Attribut „PreisstufeNummerHaupt“ im „Relation“-Element) abweicht, muss für die

Ticketausstellung der zum Produkt gehörende Geltungsbereich ermittelt werden.

Wenn beim „Ticketsortiment“-Element das Attribut „RelationsnummerProduktsuche“ gefüllt ist,

kann die darin gesetzte Relationsnummer verwendet werden, um damit

• den Geltungsbereich für den Ticketaufdruck aus den Elementen „Relation“, „Geltungsbe-

reich“ und „Flaeche“ sowie

• die Ortnummern zu bestimmen, die in ein elektronisches Ticket (TLV-EFS) zu schreiben

sind (siehe 2.1.3)

Optional kann das Attribut „RelationsnummerProduktsuche“ im Vertriebsprozess auch zum Sprung

in die verknüpfte (Netz-)Relation und dem zugehörigen Ticketsortiment verwendet werden.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 76 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Wenn das Attribut „RelationsnummerProduktsuche“ bei anderer „PreisstufeNummer“ nicht gefüllt

ist, muss im Vertriebsprozess auf eine (Netz-)Relation zurückgegangen werden (siehe 6.1.1.1.3),

um den zum Produkt gehörende Geltungsbereich zu ermitteln.

6.1.1.2.6 Ermittlung des EAV-Codes

Die „Ticketsortiment“-Elemente enthalten im Attribut „EavCode“ den vollständigen fünfstelligen

EAV-Code, der für die Einnahmemeldung erforderlich ist.

Beim WT-PKM mit EAV-Basis-Codes sind zusätzlich zum Attribut „EavCode“ in den „Ticketsorti-

ment“-Elementen auch die Attribute „EavCode“ in den Elementen „Ticketart“ und „Preisstufe“ mit

den EAV-Basis-Codes gefüllt. Zusammen mit dem Attribute „EavCode“ des „Tariffenster“-Elements

der Relation (siehe 5.2.5 Relationen ) kann der 5-stellige EAV-Code wie folgt zusammengesetzt

werden:

Abbildung 7: Bildung des EAV-Codes aus EAV-Basis-Codes

Beispiel:

Abbildung 8: Beispiel für die Bildung des EAV-Codes aus EAV-Basis-Codes

Bei Verwendung der EAV-Basis-Codes kann der vorgenerierte EAV-Code im Attribute „EavCode“ der

„Ticketsortiment“-Elemente ignoriert werden.

Damit sollten alle für den Vertrieb erforderlichen Informationen zu den verfügbaren Tickets einer

Relation vorliegen und sowohl die Ticketausstellung als auch die Einnahmemeldung möglich sein.

6.2 Kontrollprozess auf Basis des WT-PKM

6.2.1 Ermittlung der Kontrollregeln

Mit der Produktnummer aus dem „Verzeichniseintrag – Berechtigung – Statischer Teil“ eines elekt-

ronischen Tickets (TLV-EFS) wird das „Ticketart“-Element ermittelt. Mit dem Attribut „Ticketart-

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 77 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Code“ des „Ticketart“-Elements lassen sich die zugehörigen „Ticket“-Elemente für die verschiede-

nen Preisstufen bestimmen.

Das Attribut „KontrollgruppeName“ des „Ticket“-Elements führt zum zugehörigen „Kontrollgruppe“-

Element und den zugehörigen „Kontrollgruppe_Kontrollregel“-Elementen, die wiederum über das

Attribut „KontrollregelName“ auf die „Kontrollregel“-Elemente verweisen.

Abbildung 9: Ermittlung der Kontroll- und Mitnahmeregeln

Der zeitliche Gültigkeitszeitraum an einem Tag ist durch die Attribute „UhrzeitVon“ und „UhrzeitBis“

im „Kontrollregel“-Element angegeben. An welchen Tagen die Kontrollregel gilt bzw. nicht ange-

wendet werden darf, ist dem zugehörigen Element „TagTyp“ zu entnehmen, das über die Attribute

„TagTypName“ bzw. „TagTypNameAusschluss“ der Kontrollregel referenziert ist.

Am „TagTyp“-Element sind über das Attribut „TagTypName“ ein oder mehre „TagTyp_Tag“-

Elemente gebunden, die wiederum über das Attribut „TagNummer“ auf „Tagnummer“-Elemente

und „Kalendertag“-Elemente (Abschnitt „Feiertage_Ferien“) verweisen.

Das Attribut „MitnahmeregelName“ des „Kontrollregel“-Elements verweist auf das „Mitnahmeregel“-

Element.

Weitere Informationen zu den Kontrollregeln des WT-PKM Abschnitt 5.3.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 78 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

6.2.2 Ermittlung der räumlichen Gültigkeit

In der „Liste originärer Geltungsbereich“ (TAG 0xDC) eines elektronischen Tickets (TLV-EFS) ste-

hen die Organisations_ID und die Liste-Flaeche_IDs:

Quelle: Technische Spezifikation der VDV-KA „Anlage 1 BOM_TLV_EFS“ Abbildung 10: „Liste originärer Geltungsbereich“ (TAG 0xDC)

Die Organisations_ID in der „Liste originärer Geltungsbereich“ von Berechtigungen des Westfalen-

Tarifs ist immer 77.

Im WestfalenTarif enthält der erste Eintrag der Liste-Flaeche_IDs die Relationsnummer, die im

VDV-KA-Standard der Raumnummer entspricht. Wenn die Liste-Flaeche_IDs nur die Relations-

nummer enthält, lassen sich die Ortnummern aus der Datenversorgung des Kontrollsystems ermit-

teln. Auf das Kontrollsystem müssen aber nur die Ortnummern für Relationsnummern übertragen

werden, deren Geltungsbereich sich nach der Ausgabe von Berechtigungen geändert hat oder für

Relationsnummer, deren Ortnummern aufgrund des Umfangs nicht in der Liste-Fläche_IDs im

elektronischen Ticket gespeichert werden.

Die Datenversorgung der Kontrollsysteme wird über das Attribut „Typ_Hinterlegung“ im „Relations-

nummer“-Element gesteuert. Die möglichen Ausprägungen sind in der folgenden Tabelle darge-

stellt.

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 79 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 46: Steuerung Datenversorgung Kontrollsysteme über Attribut „Typ_Hinterlegung“

Für die Kontrolle von elektronischen Tickets müssen also nur die Ortnummern für die langen (Attri-

but „Typ_Hinterlegung“ = R) und die geänderten Relationsnummer (Attribut „Typ_Hinterlegung“ =

A) auf die Kontrollsysteme übertragen werden.

Abbildung 11: Ermittlung der Ticketdaten eines Ticketsortimentes

Für eine sprechende Darstellung der Ortnummern kann das Attribut „FlaecheBez“ aus dem Element

„Flaeche“ über die Ortnummer zusammen mit der OrganisationID ermittelt werden.

Wenn das Attribut „KontrollregelTyp“ des „Kontrollregel“-Element den Eintrag „R“ für „Änderung

der räumlichen Gültigkeit“ enthält, ist die räumliche Gültigkeit am TAG 0xD9 „Liste alternativer

Geltungsbereich“ (statt am TAG 0xDC „Liste originärer Geltungsbereich“) zu überprüfen, dessen

Aufbau grundsätzlich dem Tag 0xDC entspricht.

7 Weitere Schnittstellen zur Weitergabe des Tarifs

Es besteht die Möglichkeit, Teile des Westfalen-Tarifs neben dem beschriebenen PKM auch als MS-

Access accdb oder als MS-Excel-Datei geliefert zu bekommen. Der Aufbau dieser Schnittstellen wird

im Folgenden definiert.

7.1 Access-Schnittstelle

Als Schnittstelle im Access-Format sind zwei Formate definiert:

 Klassisch: nur die Inhalte, die bereits über die alte Tarifzentrale MLT/RLT geliefert wurden

 Erweitert: die klassischen Inhalte erweitert z.B. um Haltestellen und Historisierungen

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 80 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

7.1.1 Klassisch Der Aufbau der Tabellen mit den Beziehungen ist in der folgenden Abbildung dargestellt.

Abbildung 12: Access-Export Datenmodell klassisch

Die Felder und Datentypen werden im Folgenden definiert:

7.1.1.1 Fahrausweisart WTB: Ticketart

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 81 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 47: Fahrausweisart

7.1.1.2 Preisstufe

Tabelle 48: Preisstufe

7.1.1.3 Fahrausweis WTB: Ticket

Tabelle 49: Fahrausweis

7.1.1.4 Tarif

Tabelle 50: Tarif

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 82 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

7.1.1.5 Währung

Tabelle 51: Währung

7.1.1.6 Preis

Tabelle 52: Preis

7.1.1.7 Kooperationsraum

Tabelle 53: Kooperationsraum

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 83 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

7.1.1.8 Kreis

Tabelle 54: Kreis

7.1.1.9 Gemeinde Die Gemeinde ist eine spezielle Tabelle, die in der WTB nicht mehr vorhanden ist. Um die Kompati-

bilität zu bestehenden Systemen zu behalten, wird die Gemeinde-Tabelle beim Erzeugen der Ac-

cess-Schnittstelle künstlich erzeugt.

Tabelle 55: Gemeinde

7.1.1.10 Tarifbereich WTB: nicht vorhanden

Abbildung und Kontrolle von eTickets im Westfalen- © IT-P GmbH Seite 84 Tarif_V2.4.4_final.docx

Abbildung und Kontrolle von (((eTickets Version: 2.4.4 Stand: 31.10.2018 im Westfalen-Tarif

Tabelle 56: Tarifbereich

7.1.1.11 Zone WTB: Fläche