[Seite 1]
Anlage 24 Anhang 8
Statische Berechtigung RMV-EFS
Spezifikation Datenlayout
Version: 1.15 Datum: 01.07.2024 Dok-Ref.: StatBer_RMV-EFS Datei: StatBer_RMV-EFS_v1.15.docx
[Seite 2]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
Versionshistorie
| Ver- | Anlass | Bearbeiter | Datum | ||
|---|---|---|---|---|---|
| sion | |||||
| 0.1 | Ersterstellung | 05.11.2013 | |||
| 0.2 | Überarbeitung und Vervollständigung. Version zur Abstimmung mit RMV. | 11.03.2014 | |||
| 1.0 | Änderung terminalOwnerID von (36, RMV) auf (6187, OVB). Erläuterung zum Sub-CA Zertifikat in Kap. 3 er- gänzt. Version zum Start des Produktivbetriebs | 19.05.2014 | |||
| 1.1 | Geändert wurden die folgenden Felder: - berGueltigkeitsbeginn - berGueltigkeitsende - efsFahrgastNameVorname - efsFahrgastGeschlecht - efsFahrgastGeburtsdatum - efsStartort_ID | 11.03.2016 | |||
| 1.2 | Geändert wurden die folgenden Felder: - berGueltigkeitsende - efsFahrgastNameVornameKurz | 24.05.2016 | |||
| 1.3 | Geändert wurden die folgenden Felder: - berGueltigkeitsbeginn - efsPreisstufe | 27.06.2016 | |||
| 1.4 | Geändert wurden die folgenden Felder: - berGueltigkeitsende | 25.01.2018 | |||
| 1.5. | Seite 7, 8: Die Felder ortNummer und OrtsTyp wa- ren fälschlicherweise vertauscht. Dies wurde nun korrigiert. | 15.02.2018 | |||
| 1.6 | Änderungen bei berGültigkeitsbeginn und -ende aufgrund Einführung Zeitkarten sowie bei logTrans- aktionsZeitpunkt Referenzierte KA-Spezifikationen auf KA Version 1.3.0 geändert. Inhaltlich bedeutet dies für das For- mat der Statischen Berechtigung keine Änderung gegenüber der bislang referenzierten Version 1.107 zzgl. KA CR 133. Text der Einleitung aktualisiert. | 20.08.2018 | |||
| 1.7 | Ergänzung Kapitel zum TXASTBER und dem darin enthaltenen BerechtigungTarifbereichZusatz. | 15.03.2019 |
Datei: StatBer_RMV-EFS_v1.15.docx Seite 1 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024 Cubic Transportation Systems, Vertraulich
[Seite 3]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
| 1.8 | Anpassungen im Rahmen der Umstellung auf den Online VDL Änderung OrgID der OVB 6187 auf OrgID der Rhein-Main-Verkehrsverbund Servicegesellschaft mbH 6335. Anpassung der OrgIDs für die Testsysteme. | 08.10.2020 | |
|---|---|---|---|
| Dokument-Referenz ergänzt. Versionsnummer des Dokuments bleibt 1.8. | 05.07.2021 | ||
| 1.9 | Änderung des Felds efsFahrgastGeschlecht; Ergänzung des Geschlecht_CODE=3 für „divers“ | 04.08.2021 | |
| 1.10 | Änderungen aufgrund von „RMV 9326 CR-144 Mo- tics Backend“ – „Gültigkeitsbeginn im Vorverkauf“ & „Definition Gültigkeitsende in EFS/STB“ | Cubic | 05.08.2021 |
| 1.11 | Kommentare entfernt. Änderungen akzeptiert. zeit- karteStbRefBerId wurde entfernt. | Cubic | 04.10.2022 |
| 1.12 | Kleine formale Korrekturen | Cubic | 05.10.2022 |
| 1.13 | Anpassung Spalten berGueltigkeitsbeginn, berGuel- tigkeitsende, logTransaktionsZeitpunkt, Korrektur benennung sceId“. | Cubic | 01.11.2022 |
| 1.14 | Änderung Datenelement efsFahrgastGeschlecht zu „0x00“ (keine Angabe). Änderung Datenelement efsFahrgastNameVorna- meKurz zu „Anwendung Kürzungsregel 1“. Korrektur Datenelement logTransaktionsOrt_ID.ort- DomaeneID zu „Org-ID des Verkehrsunterneh- mens“. Korrektur Datenelement Length „Separate Daten – Berechtigung RMV EFS – Statischer produktspezifi- scher Teil“ zu Wert=„0x44 (*variabel)“ mit Anmer- kung. Ergänzung in Anmerkung zu Datenelementen „Länge sceId (vorher ID_MG)“ und „sceId (vorher ID_MG)“. Ergänzung Anmerkung zur „Summe“ am Ende von Tabelle 1: Datenstruktur „RMV Statische Berechti- gung“ | rms | 13.10.2023 |
| 1.15 | Aufnahme RMV-In/Out Fahrtberechtigung. | rms | 01.07.2024 |
Datei: StatBer_RMV-EFS_v1.15.docx Seite 2 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024 Cubic Transportation Systems, Vertraulich
[Seite 4]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
Hinweis zum Urheberrecht
Copyright von Cubic Transportation Systems (Deutschland) GmbH 2013 - 2024. Alle Rechte vor- behalten. Das Urheberrecht an dieser Arbeit ist Eigentum von Cubic Transportation Systems (Deutschland) GmbH.
Vertraulichkeitsvermerk
Diese Arbeit wurde für den RMV und die rms für das Projekt vHGS im Rahmen des eTicket RheinMain sowie für das Projekt RMV Handyticket verfasst und vorgelegt. Alle Inhalte sind ver- traulich zu behandeln. Diese Arbeit unterliegt den zwischen RMV bzw. rms und Cubic bzgl. der oben genannten Projekte vertraglich vereinbarten Nutzungsregelungen und Vertraulichkeitsbestimmungen. Über den vertraglich zugelassenen Umfang hinaus darf diese Arbeit ohne die vorherige schriftli- che Zustimmung von Cubic Transportation Systems (Deutschland) GmbH (weder vollständig noch in Auszügen) verändert, vervielfältigt, veröffentlicht oder an Dritte weitergegeben oder für andere Zwecke, als für jene, für die sie vorgelegt wurde, verwendet werden.
Datei: StatBer_RMV-EFS_v1.15.docx Seite 3 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024 Cubic Transportation Systems, Vertraulich
[Seite 5]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
Inhalt
1 Einleitung ........................................................................................................................... 5 2 RMV-EFS als Statische Berechtigung .............................................................................. 6 3 Gesamtdatenstruktur und Barcodeformat ..................................................................... 17 4 TXASTBER – BerechtigungTarifbereichZusatz ............................................................. 18
Referenzen
[KA_SPEC_BOM] Hauptdokument mit Basisobjektmodell (BOM) VDV KA KG, Version 1.3.0, Juni 2014 [KA_SPEC_NM] Spezifikation Nutzermedium VDV KA KG, Version 1.3.0, Juni 2014 [KA_SPEC_STB] Spezifikation Statischer Berechtigungen VDV KA KG, Version 1.3.0, Juni 2014 [RMV_DATHB] Anlage 17, RMV-Datenhandbuch, Datenlieferungen und -strukturen für die Partner des RMV RMV, Version 3.45.06, 22.08.2022 [VHGS_PH05-A1] vHGS eTicket RheinMain, Pflichtenheft PH05 Anhang 1, RMV-EFS Cubic, Version 1.8, 01.07.2024
Hinweis zur verwendeten KA Spezifikation: Die KA Version 1.3.0 ist die im eTicket RheinMain angewendete KA Version. Fehlerkorrekturen der nachfolgenden Versionen der KA-Spezifikation sind berücksichtigt. Die für die KA Version 1.11.0 erwartete Änderung (KA CR 335) der Bedeutung des GE- SCHLECHT-Code 3 ist berücksichtigt.
Datei: StatBer_RMV-EFS_v1.15.docx Seite 4 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024 Cubic Transportation Systems, Vertraulich
[Seite 6]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
1 Einleitung
Dieses Dokument beschreibt die Datenstruktur für RMV-Fahrkarten als Statische Berechtigung und deren Darstellung als 2D-Barcode gemäß KA Spezifikation [KA_SPEC-STB]. Dieses Dokument bildet die Grundlage für die Erzeugung der Barcodes durch den Ticketserver des RMV HandyTickets und ggf. weitere Systeme, die RMV-Fahrkarten als Statische Berechti- gung / 2D-Barcode ausgeben. Dieses Dokument soll die Hersteller von Kontrollgeräten in die Lage versetzen, den Barcode zu dekodieren und automatisch für die Kontrolle der Fahrtberechtigung auszuwerten. Die Spezifikation des Datenlayouts stützt sich auf die für das eTicket RheinMain in [VHGS_PH05- A1] spezifizierten Datenstrukturen „RMV-EFS“ und „RMV-TLV-EFS-D-Ticket“ für KA-konforme elektronische Fahrtberechtigungen auf Chipkarten (und anderen adäquaten KA-Nutzermedien).
Datei: StatBer_RMV-EFS_v1.15.docx Seite 5 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024 Cubic Transportation Systems, Vertraulich
[Seite 7]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
2 RMV-EFS als Statische Berechtigung
Die nachfolgende Datenstruktur zeigt die komplette Datenstruktur der Statischen Berechtigung basierend auf dem RMV EFS aus [VHGS_PH05- A1]. Die grün hinterlegten Zeilen enthalten die produktspezifischen Teile (die den „RMV-EFS“ strukturell von anderen EFS unterscheiden). Die produktspezifischen Teile der „RMV Statische Berechtigung“ entsprechen in ihrer Struktur exakt denen des „RMV-EFS“ aus [VHGS_PH05-A1]. In der Spalte „Statische Berechtigung sind die Besonderheiten bei der Kodierung als Statische Berechtigung für das RMV HandyTicket beschrie- ben.
| Datenelement | Wert | Codierung | Länge | Anmerkung | Statische Berechtigung | |||||
|---|---|---|---|---|---|---|---|---|---|---|
| (Bytes) | (RMV HandyTicket) | |||||||||
| berBerechtigung_ID | Struktur „Berechtigung_ID“ | 6 | Referenz-ID für KKVP-NM-MAC Enthält neben der Berechtigungsnummer die Org-ID des KVP. Im Falle der eTicket Rhein- Main KVP-Agentur ist dies die Org-ID des RMV als Repräsentant der Agentur. | |||||||
| berechtigungNummer | Die Berechtigungsnummer ist innerhalb ei- nes mit dem eTicket RheinMain abgestimm- ten Nummernkreises zu verwenden. Die Berechtigungsnummer und die Ticket-ID des Handtickets sind über die ein-eindeutige Abbildungsregel verknüpft. | |||||||||
| Organisation_ID | ReferenceNumberTwo (Organisation_ID) | = 36, RMV | ||||||||
| prodProdukt_ID | Struktur „EFMProdukt_ID“ | 4 | Referenz-ID für KPV-NM-MAC Enthält neben der Produktnummer die Org- ID des RMV als PV. Produktnummern wer- den vom RMV festgelegt. | |||||||
| produktNummer | Die Produktnummer wird durch die vom Han- dyticketserver verwendete Tarifauskunft ge- liefert. | |||||||||
| Organisation_ID | ReferenceNumberTwo (Organisation_ID) | = 36, RMV |
Datei: StatBer_RMV-EFS_v1.15.docx Cubic Transportation Systems, Vertraulich Seite 6 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024
[Seite 8]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
| Datenelement | Wert | Codierung | Länge | Anmerkung | Statische Berechtigung | ||||
|---|---|---|---|---|---|---|---|---|---|
| (Bytes) | (RMV HandyTicket) | ||||||||
| berGueltigkeitsbeginn | DateTimeCompact | 4 | Einzelfahrkarte und Kurzstrecke: Datum und Uhrzeit des Kaufs. Für die Anzeige bei der Kontrolle gilt: Datum und Uhrzeit, z.B. „01.07.2016, 14:00 Uhr“ Tageskarte (1, 2, 3 Tage), Gruppentages- karte (1, 2, 3 Tage), Hessenticket: Datum und Uhrzeit des Kaufs.1 Für die Anzeige bei der Kontrolle gilt: Datum ohne Uhrzeit, z.B. „01.07.2016“. Wochen- und Monatskarten: Datum und Uhrzeit des Kaufs. Für die Anzeige in der Kontrolle gilt: Datum ohne Uhrzeit, z.B. „01.08.2022“. Jahreskarten: Datum ist entweder der erste Kalendertag des Kaufmonats oder der erste Kalendertag des folgenden Kalendermonats (Kundenent- scheid). Uhrzeit ist immer „00:00:02“. Für die Anzeige in der Kontrolle gilt: Allein das Datum, z.B. „01.08.2022“. Wochen-, Monats- und Jahreskarten mit täg- licher Aktualisierung des Gültigkeitsbeginns: Datum mit Uhrzeit 00:00:02 |
1 Tageskarten werden im Handyticket derzeit ausschließlich zur sofortigen Nutzung verkauft. Sofern ein Vorverkauf unterstützt wird, ist als Gültigkeitsbeginn das vom Käufer gewählte Datum mit Uhrzeit 00:00:02 einzusetzen.
Datei: StatBer_RMV-EFS_v1.15.docx Cubic Transportation Systems, Vertraulich Seite 7 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024
[Seite 9]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
| Datenelement | Wert | Codierung | Länge | Anmerkung | Statische Berechtigung | ||||
|---|---|---|---|---|---|---|---|---|---|
| (Bytes) | (RMV HandyTicket) | ||||||||
| Am ersten Tag des Gültigkeitszeitraums ent- spricht das Datum dem Startdatum der Wo- chen-/Monats-/Jahreskarte, am Folgetag wird das Datum um 1 erhöht, usw. Für die Anzeige bei der Kontrolle gilt: Datum ohne Uhrzeit, z.B. „01.02.2019“ an Tag 1, „02.02.2019“ an Tag 2 usw. Vorverkauf nur für Zeitkarten (inklusive Ta- geskarte) Der vom Fahrgast ausgewählte Tag für das Gültigkeitsbeginn des Tickets im Vorverkauf, ist auf den ausgewählten Kalendertag mit Zeitstempel „00:00:02“ zu setzen. Ausnahme bildet die Jahreskarte (siehe berGueltigkeits- beginn Jahreskarte). Beispiel: Kunde wählt im Vorverkaufsprozess 06.12.2028 aus berGueltigkeitsbeginn == 06.12.2028 00:00:02 RMV-In/Out Fahrtberechtigung: Datum und Uhrzeit des Kunden-Check-in. | |||||||||
| berGueltigkeitsende | DateTimeCompact | 4 | Einzelfahrkarte und Kurzstrecke: [NULL]; diese haben kein Gültigkeitsende Für alle anderen Produkte: Das Gültigkeitsende soll auf das über die Ta- rifdaten definierte Gültigkeitsende + „23:59:58“ Uhr am letzten Gültigkeitstag ge- setzt werden. Beispiel: Gültigkeitsende aus den Tarifdaten für Tagesfahrkarte 06.12.2028 berGueltigkeitsende == 06.12.2028 23:59:58 |
Datei: StatBer_RMV-EFS_v1.15.docx Cubic Transportation Systems, Vertraulich Seite 8 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024
[Seite 10]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
| Datenelement | Wert | Codierung | Länge | Anmerkung | Statische Berechtigung | ||||
|---|---|---|---|---|---|---|---|---|---|
| (Bytes) | (RMV HandyTicket) | ||||||||
| Monatskarten: gültig bis einschließlich glei- cher Kalendertag des Folgemonat + „23:59:58“ Uhr; Beispiele: - Beginn 01.08.2028 → Ende 01.09.2028 23:59:58 - Beginn 30.08.2028 → Ende 30.09.2028, 23:59:58; - Beginn 31.08.2028 → Ende 30.09.2028, 23:59:58 Siehe auch Hinweise im Anschluss an diese Tabelle. Die Umsetzung der Regelung, dass Zeitkar- ten inklusive der Tageskarte bis 5 Uhr des Folgetages des letzten Gültigkeitstages gül- tig zu prüfen sind, wird durch das Kontroll- modul übernommen. Jahreskarte Bar: berGueltigkeitsende = berGueltigkeitsbeginn + 12 Monate - 1 Tag. Beispiel: Kauf am 31.08.2022 mit Gültigkeitsbeginn 01.09.2022 führt zum berGueltigkeitsende =31.08.2023 23:59:58. RMV-In/Out Fahrtberechtigung: Datum und Uhrzeit des Kunden-Check-in + 8 Stunden. Nur noch kontrollrelevant: |
Datei: StatBer_RMV-EFS_v1.15.docx Cubic Transportation Systems, Vertraulich Seite 9 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024
[Seite 11]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
| Datenelement | Wert | Codierung | Länge | Anmerkung | Statische Berechtigung | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| (Bytes) | (RMV HandyTicket) | ||||||||||||||||
| Tageskarten: bis 05:00 Uhr des Folgetages des letzten Gültigkeitstags; d.h. für eine 1-Tageskarte: Datum des Gül- tigkeitsbeginns + 1, 05:00:00; d.h. für eine 2-Tageskarte: Datum des Gül- tigkeitsbeginns + 2, 05:00:00; für eine 3-Tageskarte: Datum des Gültig- keitsbeginns + 3, 05:00:00; Wochenkarten: bis 05:00 Uhr des Folgeta- ges des letzten Gültigkeitstags; d.h. Datum des Gültigkeitsbeginns + 7, 05:00:00 Siehe auch Hinweise im Anschluss an diese Tabelle. | |||||||||||||||||
| Tag „Separate Daten – Be- | 0x85 | Octet String(SIZE(1)) | 1 | ||||||||||||||
| rechtigung – Statischer pro- | |||||||||||||||||
| duktspezifischer Teil“ | |||||||||||||||||
| Length „Separate Daten – Be- | 0x44 | Octet String(SIZE(1)) | 1 | *Bei Nutzung von Motics (Tag 0xD6): muss | |||||||||||||
| rechtigung RMV EFS – Stati- | (*varia- | der Wert „0x44“ dynamisch angepasst wer- | |||||||||||||||
| scher produktspezifischer Teil“ | bel) | den [0x46 + variable Länge Element sceID]. | |||||||||||||||
| Tag sceId (vorher ID_MG) | Tag sceId (vorher ID_MG) | 0xD6 | 0xD6 | 1 | Bei Nutzung von Motics (vormals VDV-Bar- | ||||||||||||
| code mobile+): muss das Datenelement | |||||||||||||||||
| SCE_ID in der Struktur „Separate Daten – | |||||||||||||||||
| Berechtigung – Statischer produktspezifi- | |||||||||||||||||
| scher Teil“ als erstes enthalten sein. Beim | |||||||||||||||||
| TLV EFS ist hierfür das Tag 0xD6 zu ver- | |||||||||||||||||
| wenden. Bei anderen Strukturen muss der | |||||||||||||||||
| PV entsprechende Definitionen erstellen und | |||||||||||||||||
| das Tag 0xD6 als erstes in der Struktur an- | |||||||||||||||||
| ordnen (KA STB-SPEC_V1100). | |||||||||||||||||
| Länge sceId (vorher ID_MG) | 1 | Bei Nutzung von Motics. |
Datei: StatBer_RMV-EFS_v1.15.docx Cubic Transportation Systems, Vertraulich Seite 10 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024
[Seite 12]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
| Datenelement | Wert | Codierung | Länge | Anmerkung | Statische Berechtigung | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| (Bytes) | (RMV HandyTicket) | |||||||||||||
| sceId (vorher ID_MG) | OctetString | variabel | variabel | Bei Nutzung von Motics: Wert wird aus der | ||||||||||
| App beim Kauf und bei der RMV-In/Out | ||||||||||||||
| Fahrtberechtigung beim Kunden-Check-in | ||||||||||||||
| an das HGS übergeben. | ||||||||||||||
| efsStartort_ID | Struktur „Ort_ID“ | 6 | Startort, Zielort und ViaOrt beschreiben die | RMV-In/Out Fahrtberechtigung: Festlegung auf „9980“, da im gesamten RMV-Verbundgebiet ohne Übergangstarife gültig. | ||||||||||
| räumliche Gültigkeit der Fahrkarte. | ||||||||||||||
| Für Zeitkarten und die RMV-In/Out Fahrtbe- | ||||||||||||||
| rechtigung ist der Startort ein Tarifgebiet.2 | ||||||||||||||
| Für Einzelfahrkarten und Kurzstrecke ist der | ||||||||||||||
| Startort eine Haltestelle.3 | ||||||||||||||
| OrtsTyp | INT1 | Der KA OrtsTyp_CODE wird durch den Han- | ||||||||||||
| (OrtsTyp_CODE) | dyticketserver eingesetzt. | |||||||||||||
| ortNummer | INT3 (ReferenceNumberThree) | INT3 | Die Ortnummer wird vom Tarifauskunftssys- | |||||||||||
| (ReferenceNumberThree) | tem geliefert. Für Ortnummern vom Ortstyp | |||||||||||||
| „Haltestelle“wird die einzusetzende RMV In- | ||||||||||||||
| fopool-Haltestellennummer vom Handyti- | ||||||||||||||
| cketserver aus der vom Tarifauskunftssys- | ||||||||||||||
| tem gelieferten Nummer extrahiert. | ||||||||||||||
| Organisation_ID | ReferenceNumberTwo | = 36, RMV | = 36, RMV | |||||||||||
| (Organisation_ID) | ||||||||||||||
| efsZielort_ID | Struktur „Ort_ID“ | Struktur „Ort_ID“ | 6 | Der Zielort ist ein Tarifgebiet. | RMV-In/Out Fahrtberechtigung: Festlegung auf „9980“, da im gesamten RMV-Verbundgebiet ohne Übergangstarife gültig. | |||||||||
| Ausnahme: Für Kurzstrecken soll der Zielort | ||||||||||||||
| eine Haltestelle sein-. | ||||||||||||||
| Zur Kodierung von Tarifgebieten und Halte- | ||||||||||||||
| stellen siehe efsStartOrt_ID. | ||||||||||||||
| OrtsTyp | INT1 | Siehe efsStartOrt_ID. | ||||||||||||
| (OrtsTyp_CODE) |
2 RMV Tarifzonen werden als KA Ort_ID kodiert mit OrtDomaene_ID = Org-ID des RMV, OrtTyp =16, OrtNummer = Tarifgebietsnummer.
3 RMV Haltestellen werden als KA Ort_ID kodiert mit OrtDomaene_ID = Org-ID des RMV, OrtTyp =200, OrtNummer = Infopool-Haltestellennummer.
Datei: StatBer_RMV-EFS_v1.15.docx Cubic Transportation Systems, Vertraulich Seite 11 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024
[Seite 13]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
| Datenelement | Wert | Codierung | Länge | Anmerkung | Statische Berechtigung | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| (Bytes) | (RMV HandyTicket) | |||||||||||||||||||
| ortNummer | INT3 | Siehe efsStartOrt_ID. | Siehe efsStartOrt_ID. | |||||||||||||||||
| (ReferenceNumberThree) | ||||||||||||||||||||
| Organisation_ID | ReferenceNumberTwo | Siehe efsStartOrt_ID. | ||||||||||||||||||
| (Organisation_ID) | ||||||||||||||||||||
| efsViaOrte_ID1 | Struktur „Ort_ID“ | Struktur „Ort_ID“ | 6 | Der Via-Ort ist ein Tarifgebiet. | RMV-In/Out Fahrtberechtigung: Festlegung auf „0“, da im gesamten RMV- Verbundgebiet ohne Übergangstarife gültig. | |||||||||||||||
| Ausnahme: Für Kurzstrecke soll der Via-Ort | ||||||||||||||||||||
| eine Haltestelle sein. | ||||||||||||||||||||
| Es wird der gemäß RMV-Tarifsystem für die | ||||||||||||||||||||
| Fahrkarte charakteristische Via-Ort eingetra- | ||||||||||||||||||||
| gen. | ||||||||||||||||||||
| Zur Kodierung von Tarifgebieten und Halte- | ||||||||||||||||||||
| stellen siehe efsStartOrt_ID. | ||||||||||||||||||||
| OrtsTyp | INT1 | Siehe efsStartOrt_ID. | ||||||||||||||||||
| (OrtsTyp_CODE) | ||||||||||||||||||||
| ortNummer | INT3 | Siehe efsStartOrt_ID. | ||||||||||||||||||
| (ReferenceNumberThree) | ||||||||||||||||||||
| Organisation_ID | ReferenceNumberTwo | Siehe efsStartOrt_ID. | ||||||||||||||||||
| (Organisation_ID) | ||||||||||||||||||||
| efsLinie_ID | Struktur “Linie_ID” | Struktur “Linie_ID” | 4 | Nur relevant für Einzelfahrkarten und Tages- | ||||||||||||||||
| karten, die im Fahrzeug verkauft werden. An- | ||||||||||||||||||||
| gabe der Linie als Hilfsinformation für Fahr- | ||||||||||||||||||||
| kartenkontrolle. | ||||||||||||||||||||
| Option für eventuelle zukünftige linienbezo- | ||||||||||||||||||||
| genen Fahrkarten. | ||||||||||||||||||||
| linienNummer | ReferenceNumberTwo | = 0x00, keine Angabe | ||||||||||||||||||
| linieDomaeneID | linieDomaeneID | ReferenceNumberTwo | = 0x00, keine Angabe | = 0x00, keine Angabe | ||||||||||||||||
| (Organisation_ID) | ||||||||||||||||||||
| efsRichtung.code | INT1 (Richtung_CODE) | INT1 | 1 | Nur relevant für Einzelfahrkarten und Tages- | = 0x00, keine Angabe | |||||||||||||||
| (Richtung_CODE) | karten, die im Fahrzeug verkauft werden. An- | |||||||||||||||||||
| gabe der Richtung, in der die efsLinie_ID be- | ||||||||||||||||||||
| fahren wird bzw. werden darf. | ||||||||||||||||||||
| Richtung_CODE: 2 = hin, 3 = rück |
Datei: StatBer_RMV-EFS_v1.15.docx Cubic Transportation Systems, Vertraulich Seite 12 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024
[Seite 14]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
| Datenelement | Wert | Codierung | Länge | Anmerkung | Statische Berechtigung | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| (Bytes) | (RMV HandyTicket) | ||||||||||||||||
| efsPreisstufe | ReferenceNumberOne | 1 | 1 | RMV-Druckpreisstufe | |||||||||||||
| efsPreisLang | Amount(16777215) | 3 | Preis in Euro-Cent, inkl. Mehrwertsteuer. | ||||||||||||||
| efsMehrwertsteuer | INT2 | 2 | Mehrwertsteuersatz als ganze Zahl mit der | Bsp.: 700 = 7% | |||||||||||||
| Einheit 0,01%. | |||||||||||||||||
| efsSortenschluessel | ReferenceNumberThree | 3 | RMV-Sortenschlüssel | RMV-Sortenschlüssel | |||||||||||||
| berVertriebspartner_ID | berVertriebspartner_ID | ReferenceNumberTwo (Organisation_ID) | 2 | Organisation_ID | = 6335, Rhein-Main-Verkehrsverbund Ser- vicegesellschaft mbH | ||||||||||||
| des ausgebenden Vertriebspartners – iden- | |||||||||||||||||
| tisch mit dem Transaktionsoperator der Aus- | |||||||||||||||||
| gabetransaktion.4 | |||||||||||||||||
| efsFahrgastNameVorname- | PrintableString(25) | 25 | Anwendung Kürzungsregel 1, 25 Zeichen | ||||||||||||||
| Kurz | |||||||||||||||||
| efsFahrgastGeschlecht | efsFahrgastGeschlecht | BitString(8) | 1 | Geschlecht_CODE | = 0x00, keine Angabe | ||||||||||||
| (Geschlecht_CODE) | |||||||||||||||||
| efsFahrgastGeburtsdatum | Datef | 4 | Tag, Monat und Jahr (DD.MM.YYYY) | ||||||||||||||
| efsFahrgastTyp.code | efsFahrgastTyp.code | INT1 (KundenTyp_CODE) | INT1 | 1 | 1 | KundenTyp_CODE Als Option für zukünftige Nutzung. | KundenTyp_CODE | = 0x01, Erwachsener | |||||||||
| (KundenTyp_CODE) | Als Option für zukünftige Nutzung. | = 0x02, Kind | |||||||||||||||
| Abhängig von der gekauften Fahrkarte. | |||||||||||||||||
| efsVerkehrsmittelKatego- rie.code | INT1 | 1 | TransportmittelKategorie_CODE Als Option für zukünftige Nutzung. | = 0x00, keine Angabe | = 0x00, keine Angabe | ||||||||||||
| (TransportmittelKatego- | |||||||||||||||||
| rie_CODE) | |||||||||||||||||
| efsServiceklasse.code | INT1 (ServiceKlasse_CODE) | INT1 | 1 | ServiceKlasse_CODE | = 0x00, keine Angabe | ||||||||||||
| (ServiceKlasse_CODE) | Als Option für zukünftige Nutzung. |
4 Im Rahmen der eTicket RheinMain KVP-Agentur verwenden die Vertriebspartner (Verkehrsunternehmen, ggf. LNO) einen gemeinsamen KVP-Schlüssel und daher eine gemeinsame kvp_ID in der berBerechtigung_ID. Im Attribut berVertriebspartner_ID wird die Identität des im Rahmen der KVP-Agentur handelnden Vertriebspartners dauerhaft dokumentiert.
Datei: StatBer_RMV-EFS_v1.15.docx Cubic Transportation Systems, Vertraulich Seite 13 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024
[Seite 15]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
| Datenelement | Wert | Codierung | Länge | Anmerkung | Statische Berechtigung | |||||
|---|---|---|---|---|---|---|---|---|---|---|
| (Bytes) | (RMV HandyTicket) | |||||||||
| berBezahlArt.code | INT1 (BezahlArt_CODE) | 1 | 1 | BezahlArt_CODE Relevante Werte: 0 = keine Angabe, bar = 1, Kreditkarte = 3, Lastschrift = 6, ec-cash = 17, Geldkarte = 24,5 | 0 = RMV-In/Out Fahrtberechtigung | |||||
| 3 = Kreditkarte | ||||||||||
| 6 = Lastschrift | ||||||||||
| 24 = Geldkarte, GiroGo | ||||||||||
| 28 = Mobilfunkrechnung | ||||||||||
| logTransaktionsOperator_ID | ReferenceNumberTwo | 2 | Organisation_ID Für die Ausgabetransaktion ist der hier ein- getragene Wert identisch mit dem Attribut „berVertriebspartner_ID” (siehe oben) | = 6335, Rhein-Main-Verkehrsverbund Ser- vicegesellschaft mbH | ||||||
| logTerminal_ID | Struktur „Terminal_ ID“ | 5 | ||||||||
| terminalTyp | 16 = Handyticket-Server | |||||||||
| terminalNummer | ReferenceNumberTwo | Im RMV HandyTicket = 1 | ||||||||
| terminalOwnerID | ReferenceNumberTwo (Organisation_ID) | Im RMV HandyTicket = 6335, Rhein-Main- Verkehrsverbund Servicegesellschaft mbH | ||||||||
| logTransaktionsZeitpunkt | DateTimeCompact | 4 | Zeitstempel des Tickets. Bei Einzel- und Tageskarten entspricht dies dem Kaufzeitpunkt. Bei Wochen-/Monatskarten-/Jahreskarten entspricht dies dem Erzeugungszeitpunkt des für den Geltungstag aktualisierten Ti- ckets. Bei RMV-In/Out Fahrtberechtigungen ent- spricht dies dem Zeitpunkt des Kunden- Check-in. | |||||||
| logTransaktionsOrt_ID 6 | Struktur „Ort_ID“ | 6 |
5 Werte für POB/PEB und Werteinheiten werden relevant, wenn derartige Produkte als Bezahlberechtigungen eingeführt werden. Eine Differenzierung nach Kreditkartenanbietern (Master, Visa, …) wird bis auf weiteres nicht genutzt.
6 Bezeichnung vereinheitlicht (mit Unterstrich vor ‚ID‘).
Datei: StatBer_RMV-EFS_v1.15.docx Cubic Transportation Systems, Vertraulich Seite 14 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024
[Seite 16]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
| Datenelement | Wert | Codierung | Länge | Anmerkung | Statische Berechtigung | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| (Bytes) | (RMV HandyTicket) | |||||||||||||
| ortTyp | INT1 (OrtsTyp_CODE) | Im RMV HandyTicket = 215, Ticketserver | ||||||||||||
| ortNummer | INT3 (ReferenceNumberThree) | Im RMV HandyTicket = 1 | ||||||||||||
| ortDomaeneID | ReferenceNumberTwo (Organisation_ID) | Ticketserver werden als zentrale Vertriebs- infrastruktur des jeweiligen Verkehrsunter- nehmens behandelt. Dies gilt im Sinne des mandantenfähigen Systems auch dann, wenn es sich physisch um den gleichen Ser- ver handelt. Siehe auch VHGS_PH05-A1, Kap 4.4.3. | Org-ID des Verkehrsunternehmens Im RMV HandyTicket = 6335, Rhein-Main- Verkehrsverbund Servicegesellschaft mbH | |||||||||||
| Tag „Transaktion Produktspe- | 0x8a | Octet String(SIZE(1)) | 1 | |||||||||||
| zifischer Teil“ | ||||||||||||||
| Length „Transaktion Produkt- | 0x00 | Octet String(SIZE(1)) | 1 | Keine produktspezifischen Transaktionsda- | ||||||||||
| spezifischer Teil – RMV- EFS“ | ten für RMV-EFS | |||||||||||||
| berProdLogSAMSeqNummer | ReferenceNumberFour | 4 | Es handelt sich hierbei um den Wert des Nutzungs-Sequenz-Zählers zu dem unten re- ferenzierten Masterkey MKPV-NM-MAC des SAM, der sich in den letzten 4 Byte des ent- sprechenden Rekords des EF_Schlüssel- Info befindet, siehe KA SAM-Spec. Dieser Wert wird vom SAM eingetragen. | |||||||||||
| Version KPv-NM-MAC | Octet String(SIZE(1)) | 1 | Version des abgeleiteten Schlüssels KPv-NM- MAC Dieser Wert wird vom SAM eingetragen. | |||||||||||
| NM_Transaktion_ID | Struktur NM_Transak- tion_ID | 7 | ||||||||||||
| samSequenznummer | Es handelt sich hierbei um den Wert im EF_Transaktionszähler des ausgebenden SAM, der vom SAM bei der Ausgabe einge- tragen wird, siehe KA SAM-Spec. | |||||||||||||
| SAM_ID.samNummer | Es handelt sich hierbei um die letzten 3 Byte im EF_SAM-ID des ausgebenden SAM, die bei der Ausgabe vom SAM eingetragen wer- den, siehe KA SAM-Spec. |
Datei: StatBer_RMV-EFS_v1.15.docx Cubic Transportation Systems, Vertraulich Seite 15 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024
[Seite 17]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
| Datenelement | Wert | Codierung | Länge | Anmerkung | Statische Berechtigung | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| (Bytes) | (RMV HandyTicket) | ||||||||||||||||
| Füllbytes | OctetString | 0 | 0 | Hier sind für Statische Berechtigung ggf. | Für den RMV-EFS sind keine Füllbytes not- wendig, da die Gesamtlänge über 111 Bytes liegt. | Für den RMV-EFS sind keine Füllbytes not- | |||||||||||
| Füllbytes einzufügen, so dass eine Gesamt- | wendig, da die Gesamtlänge über 111 Bytes | ||||||||||||||||
| länge von mindestens 111 Bytes erreicht | liegt. | ||||||||||||||||
| wird. | |||||||||||||||||
| Kennung (ASCII) | VDV | ASCII | 3 | Fester Wert gemäß [KA_SPEC_STB] | |||||||||||||
| Version | VersionNumberExtended | 2 | '0001 0011 0000 0000' B = KA 1.3.00 | ||||||||||||||
| Summe: 124 | Summe ohne Tag 0xD6 (sceId). Mit Tag 0xD6 (sceId): + 2 + variable Länge des Attributs sceId. |
Tabelle 1: Datenstruktur „RMV Statische Berechtigung“
Die oben angegebenen Werte für Org-IDs beziehen sich auf das Produktionssystem (KA Sec-Level 3). Im Testsystem (KA Sec-Level 1) werden folgende ID verwendet:
• RMV Org.-ID: 35059 (anstatt der 36 auf Produktion)
• Rhein-Main-Verkehrsverbund Servicegesellschaft mbH Org.ID: 10118 (anstatt der 6335 auf Produktion) Hinweis zu dem täglich vorrückenden berGueltigkeitsbeginn bei Wochen-/Monats-/Jahreskarten:
• Die Datenstruktur enthält kein Attribut, aus dem der Beginn der Wochen-/Monatskarte ablesbar ist. Bei Wochenkarten kann aus dem berGuel- tigkeitsende eindeutig rückwärtsgerechnet werden. Bei Monatskarten ist dies nicht in jedem Fall möglich (Bsp.: sowohl ein Startdatum 30.08. als auch ein Startdatum 31.08. liefern ein berGueltigkeitsende 01.10. 05:00 Uhr).
• Die begleitenden Daten des Handytickets sollten das Startdatum und das Enddatum der gekauften Wochen-/Monats-/Jahreskarte enthalten, so dass diese dem Kunden angezeigt werden können. Das Enddatum ist hier so anzugeben, wie es der dem Kunden bekannten Produktbe- schreibung entspricht, d.h. ohne die Karenzzeit bis zum Ende des „Fahrplantags“. D.h. bei Wochenkarten ist Enddatum = Startdatum + 6 und bei Monatskarten Enddatum = Tageszahl des Startdatums im Folgemonat (sofern der Folgemonat weniger Tage hat als die Tageszahl des Startdatum: Monatsletzter des Folgemonats).
Datei: StatBer_RMV-EFS_v1.15.docx Cubic Transportation Systems, Vertraulich Seite 16 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024
[Seite 18]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
3 Gesamtdatenstruktur und Barcodeformat
Für die Form der Gesamtdatenstruktur wird die „Variante 2“ aus Kapitel 4.3 der [KA_SPEC_STB] verwendet. D.h. den signierten statischen Berechtigungsdaten wird ein Zertifikat über den ver- wendeten Signaturschlüssel des SAMs und der CAR des Zertifikats beigestellt. Dieses Zertifikat ist seinerseits beglaubigt durch das Zertifikat einer Sub-CA der KA. Damit das Kontrollgerät dem mit dem Barcode mitgelieferten Zertifikat vertrauen kann, muss es die Beglaubigung prüfen. Dazu muss das Zertifikat der Sub-CA in dem Kontrollgerät vorliegen. Das Zertifikat der Sub-CA über den RMV angefordert werden. Die Länge der Datenstruktur „RMV Statische Berechtigung“ (siehe Kapitel 2) beträgt 124 Bytes. Das sind 13 Bytes mehr als die minimale Länge von 111 Bytes gemäß [KA_SPEC_STB]. Die Länge der Gesamtdatenstruktur der signierten statischen Berechtigung mit Sicherheitsmerk- malen beträgt somit 365 Bytes. Gemäß [KA_SPEC_STB] kann diese Gesamtdatenstruktur als 2D-Barcode im „Regelformat“ ko- diert werden. Das Regelformat ist in [KA_SPEC_STB] wie folgt definiert:
| Datenkapazität (binär in Byte) | Erlaubte Darstellungsgrößen (Seitenlänge des gesamten 2D Barcode-Symbols) | Layers | Module |
|---|---|---|---|
| 394 | 26,8 mm – 50,0 mm | 13 | 71x71 |
Datei: StatBer_RMV-EFS_v1.15.docx Seite 17 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024 Cubic Transportation Systems, Vertraulich
[Seite 19]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
4 TXASTBER – BerechtigungTarifbereichZusatz
Die Ausgabe einer statischen Berechtigung soll mit dem Datensatz TXASTBER gemäß [KA_SPEC_STB] gemeldet werden. Die im TXASTBER enthaltene Datenstruktur BerechtigungTarifbereichZusatz wird für statische Berechtigungen im RMV wie folgt gefüllt:
| Datenelement | Wert | Codierung | Länge | Anmerkung | ||
|---|---|---|---|---|---|---|
| (Bytes) | ||||||
| berTarifversion | PrintableString(5) | 5 | Versionskennung entsprechend Vorgabe des RMV Die beim Verkauf angewandte Tarifversion. Attribut ist immer zu füllen. | |||
| berSubventionLang | Amount(16777215) | 3 | Im nominalen Verkaufspreis (efs- PreisLang) enthaltener Subventi- onsbetrag. Attribut ist immer zu füllen. | |||
| efsStartort_ID | Struktur „Ort_ID“ | 6 | a) Vom Kunden angegebener Startort. Dieser kann vom tariflich relevanten Startort abweichen. b) Vom Tarifrechner gelieferte Ta- rifzone zu der im EFS eingetrage- nen Start-Haltestelle. Wenn keine Angabe: mit ‚0‘ füllen. | |||
| efsZielort_ID | Struktur „Ort_ID“ | 6 | a) Vom Kunden angegebener Zielort. Dieser kann vom tariflich relevanten Zielort abweichen. b) Vom Tarifrechner gelieferte Ta- rifzone zu der im EFS eingetrage- nen Ziel-Haltestelle. Wenn keine Angabe: mit ‚0‘ füllen. | |||
| efsLinie_ID | Struktur „Linie_ID“ | 4 | Nur relevant beim Verkauf im Fahrzeug. Linie7, auf der der Verkauf statt- gefunden hat. Wenn keine Angabe: mit ‚0‘ füllen. | |||
| efsRichtung.code | INT1 (Richtung_CODE) | 1 | Ergänzung zu der Angabe in efs- Linie_ID. Wenn keine Angabe: mit ‚0‘ füllen. |
7 Für den Sonderfall, dass mit einem Fahrzeug unter einer öffentlichen Linienbezeichnung mehr als ein Streckenabschnitt befahren wird, die unterschiedlichen Linienbündel zuzuordnen sind, sind diese Strecken- abschnitte jeweils über unterschiedliche Linienobjekte (Linie_ID) zu kennzeichnen.
Datei: StatBer_RMV-EFS_v1.15.docx Seite 18 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024 Cubic Transportation Systems, Vertraulich
[Seite 20]
Statische Berechtigung RMV EFS
Spezifikation Datenlayout
| Datenelement | Wert | Codierung | Länge | Anmerkung | ||
|---|---|---|---|---|---|---|
| (Bytes) | ||||||
| berFahrt_ID | Struktur „Fahrt_ID“ | 5 | Nur relevant beim Verkauf im Fahrzeug. ID der Fahrt, auf der der Verkauf stattgefunden hat. Einschränkung des Wertebe- reichs für berFahrt_ID.fahrtNum- mer auf 0 … 999.999. Wenn keine Angabe: mit ‚0‘ füllen. | |||
| zeitkarteStbRefBerId | Struktur „Berechtigung_ID“ | 6 | ID der ersten STB, die für eine Zeitkarte ausgestellt wurde.8 |
Tabelle 2: Datenstruktur BerechtigungTarifbereichZusatz für RMV-STB
Unterschiede zu dem für RMV-EFS spezifizierten BerechtigungTarifbereichZusatz:
• Attribut „appInstanz_ID“ entfernt, da es für STB nicht anwendbar ist.
• Attribut „zeitkarteStbRefBerId“ ergänzt.
8 Für Zeitkarten mit mehrtägiger Gültigkeit (z.B. Wochenkarten), die als Statische Berechtigung ausgege- ben werden, wird im RMV täglich eine neue STB erzeugt und dem Kunden bereitgestellt. Über das Attribut zeitkarteStbRefBerId können diese „Tagesabschnitte“ im Hintergrundsystem verkettet werden.
Datei: StatBer_RMV-EFS_v1.15.docx Seite 19 Dok-Ref.: StatBer_RMV-EFS Version: 1.15 Datum: 01.07.2024 Cubic Transportation Systems, Vertraulich