Upozornění: Text přílohy byl získán strojově a nemusí přesně odpovídat originálu. Zejména u strojově nečitelných smluv, kde jsme použili OCR. originál smlouvy stáhnete odsud
Příloha č. 1 – Definice pojmů ustanovení
(čl./odst.)
Pojmy definované ve Smlouvě
1
pojem 1
1
Objednatel 1
Dopravce 2.1
Smluvní strany 2.1
Smlouva 2.1
ZVS 3
Občanský zákoník 5.3
Nařízení 6.2
Veřejné služby v drážní dopravě 6.4, příloha č. 5
Doba plnění 6.4, příloha č. 5
Vlakové jednotky 7.4
Výchozí dopravní výkon 8.1
Výchozí počet vlakových jednotek 8.1
Dopravní rok 10.5.
Maximální dopravní výkon 10.6, příloha č. 5
Minimální dopravní výkon 10.7 p. a)
Skutečné tržby 10.7 p. a) iii.
Skutečná kompenzace 10.7 p. c)
KODIS 11.1
SJT 11.1
CENDIS 11.2
ODIS 11.2
IDS 11.2
BČK 13.2
BPK 13.4
mobilní aplikace ODISapka 13.5
GVD 14.1
Zákon o dráhách 14.5
NAD 16.3
TPS ODIS 21.1
Vyhláška o službách
Program
Zákon o registru smluv
Pojmy definované v příloze č. 5 Smlouvy – Výpočet kompenzace
pojem ustanovení Sml.
(čl./odst.), kde je
Dopravní výkon uveden
6.3, 6.4, 6.6, 8.2, 8.3,
Výchozí dopraní výkon 8.4, 10.7 p. a) i, 10.7
Výchozí počet vlakových jednotek
Objednaný dopravní výkon (v nadpisu čl. 6 v plurálu) p. b), c) a d),13.1,
Objednaný počet vlakových jednotek 14.1, 14.7, 15.8, 18.2
Jízdní řád
6.4, 7.7, 8.1, 8.2
Skutečná kompenzace 6.4, 7.7
Nabídková cena 6.5, 8.1, 8.2, 13.1
Výchozí cena 6.5
Aktualizovaná cena
Objednávková cena 5.1, 5.2, 6.6, 7.4, 7.5,
Skutečná cena 7.7, 13.1, 13.2, 13.3,
Finanční model
Výchozí finanční model 13.4., 13.7, 14.4,
Objednávka 14.8, 15.2, 15.5, 15.6,
Přidaný dopravní výkon
Záměna jednotky za soupravu jednotek 19.3 p. g)
Výkon ujetý záložní soupravou ODIS 5 7.2, 7.3, 7.5, 7.8, 7.9,
Výkon ujetý záložní soupravou ODIS 6
Neuskutečněný nezaviněný dopravní výkon 8.4, 10.1, 10.5
Neuskutečněný dopravní výkon v pandemii 7.3
Neuskutečněný zaviněný dopravní výkon 7.3
Cena 7.3
Hodnota odpisů plynoucích z převedení Vlakových jednotek
Změna počtu vlakových jednotek z rozhodnutí Objednatele 7.3, 8.2, 9.1, 18.10
Úhrada za použití dopravní cesty 7.3, 8.2, 10.1, 10.6
Úhrada za použití ostatní infrastruktury
Provozní režie 7.4
7.7., 9.2, 9.4
8.4, 13.1
8.4 p. a)
8.4 p. b)
8.4 p. c)
8.4 p. d)
8.4 p. e), 14.6
8.4 p. f), 14.6
8.4 p. g), 14.6
9.2, 9.4, 16.6, 16.8
9.4 p. a)
9.4 p. b)
9.4 p. c)
9.4 p. d)
9.4 p. e)
Výchozí modelový jízdní řád pro 1. Dopravní rok (AKTUALIZOVANÝ) Příloha č. 2 - Provozní koncepce
S6 Ostrava hl.n. - Frenštát pod Radhoštěm město Platí od 10. 12. 2023 do 14. 12. 2024
Číslo Tarifní Na 3100 3102 3104 3106 3108 3110 3112 3114 3116 3118 3120 3122 3124 3126 3128 3130 3132 3134 3136 3138 3140 3142 3144 3146 3148 3150 3152 3154 3156 3158
řádku km znamení ~ ! ~ ! ~ ! ~ ! ~ ~ ~ ~ ~ ! ~ ! ~ ! ~ ! ~ ! !
Název tarifního bodu km Zóna ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ $ $
16:54 17:24 17:54
16:57 17:27 17:57 ~ ~ ~ ~ ~ ~
16:59 17:29 17:59
1 Ostrava hl. n. (Ostrava uhelné n.) 0 0 1-2 04:24 04:54 05:24 05:54 06:24 06:54 07:24 07:54 08:24 09:24 10:24 11:24 12:24 12:54 13:24 13:54 14:24 14:54 15:24 15:54 16:24 17:03 17:33 18:03 18:24 $ 19:24 20:24 21:24 22:24 23:24
17:06 17:36 18:06
2 Ostrava-Stodolní 2,2 2 1-2 n 04:27 04:57 05:27 05:57 06:27 06:57 07:27 07:57 08:27 09:27 10:27 11:27 12:27 12:57 13:27 13:57 14:27 14:57 15:27 15:57 16:27 17:08 17:38 18:08 18:27 n 19:27 20:27 21:27 22:27 23:27
17:15 17:45 18:15
3 Ostrava střed 2,9 3 1-2 n 04:29 04:59 05:29 05:59 06:29 06:59 07:29 07:59 08:29 09:29 10:29 11:29 12:29 12:59 13:29 13:59 14:29 14:59 15:29 15:59 16:29 17:19 17:49 18:19 18:29 n 19:29 20:29 21:29 22:29 23:29
17:24 17:54 18:24
4 Ostrava-Kunčičky 5,6 6 1-2 X n 04:33 05:03 05:33 06:03 06:33 07:03 07:33 08:03 08:33 09:33 10:33 11:33 12:33 13:03 13:33 14:03 14:33 15:03 15:33 16:03 16:33 17:29 17:59 18:29 18:33 n 19:33 20:33 21:33 22:33 23:33
17:30 18:00 18:30
5 Ostrava-Kunčice 7,8 8 1-2 n 04:36 05:06 05:36 06:06 06:36 07:06 07:36 08:06 08:36 09:36 10:36 11:36 12:36 13:06 13:36 14:06 14:36 15:06 15:36 16:06 16:36 17:34 18:04 18:34 18:36 n 19:36 20:36 21:36 22:36 23:36
17:38 18:08 18:38
6 Ostrava-Kunčice 7,8 8 1-2 n 04:38 05:08 05:38 06:08 06:38 07:08 07:38 08:08 08:38 09:38 10:38 11:38 12:38 13:08 13:38 14:08 14:38 15:08 15:38 16:08 16:38 17:42 18:12 18:42 18:38 n 19:38 20:38 21:38 22:38 23:38
18:19
7 Vratimov 10,1 10 2-18 n 04:45 05:15 05:45 06:15 06:45 07:15 07:45 08:15 08:45 09:45 10:45 11:45 12:45 13:15 13:45 14:15 14:45 15:15 15:45 16:15 16:45 18:25 18:45 n 19:45 20:45 21:45 22:45 23:45
18:32
8 Paskov 14,3 14 2-18-50 n 04:49 05:19 05:49 06:19 06:49 07:19 07:49 08:19 08:49 09:49 10:49 11:49 12:49 13:19 13:49 14:19 14:49 15:19 15:49 16:19 16:49 18:38 18:49 n 19:49 20:49 21:49 22:49 23:49
9 Lískovec u Frýdku 19,1 19 50 n 04:54 05:24 05:54 06:24 06:54 07:24 07:54 08:24 08:54 09:54 10:54 11:54 12:54 13:24 13:54 14:24 14:54 15:24 15:54 16:24 16:54 18:54 n 19:54 20:54 21:54 22:54 23:54
10 Frýdek-Místek 22,2 22 49-50-55 n 04:59 05:29 05:59 06:29 06:59 07:29 07:59 08:29 08:59 09:59 10:59 11:59 12:59 13:29 13:59 14:29 14:59 15:29 15:59 16:29 16:59 18:59 n 19:59 20:59 21:59 22:59 23:59
11 Frýdek-Místek 22,2 22 49-50-55 n 05:00 05:30 06:00 06:30 07:00 07:30 08:00 08:30 09:00 10:00 11:00 12:00 13:00 13:30 14:00 14:30 15:00 15:30 16:00 16:30 17:00 19:00 n 20:00 21:00 22:00 23:05
12 Baška 25,4 25 49 n 05:04 05:34 06:04 06:34 07:04 07:34 08:04 08:34 09:04 10:04 11:04 12:04 13:04 13:34 14:04 14:34 15:04 15:34 16:04 16:34 17:04 19:04 n 20:04 21:04 22:04 23:09
05:38 06:08 07:38 08:08 13:38 14:08 15:38 16:08
13 Pržno 29,3 29 48-49 n 05:08 05:42 06:12 06:38 07:08 07:42 08:12 08:38 09:08 10:08 11:08 12:08 13:08 13:42 14:12 14:38 15:08 15:42 16:12 16:38 17:08 19:08 n 20:08 21:08 22:08 23:13
14 Frýdlant nad Ostravicí 32,7 32 48 05:12 # 06:19 06:42 07:12 # 08:19 08:42 09:12 10:12 11:12 12:12 13:12 # 14:19 14:42 15:12 # 16:19 16:42 17:12 19:12 n 20:12 21:12 22:12 23:17
n 06:25 # 07:19 n 08:25 n 14:25 # 15:19 n 16:25 # 17:19
15 Frýdlant nad Ostravicí 32,7 32 48 % 05:19 n 06:32 n 07:25 n 08:32 # 09:19 # 10:19 # 11:19 # 12:19 # 13:19 n 14:32 n 15:25 n 16:32 n 17:25 19:19 n 20:19 21:19 22:19 23:19
# 06:38 n 07:32 # 08:38 # 14:38 n 15:32 # 16:38 n 17:32
16 Čeladná 37,4 37 46-48 n 05:25 n 07:38 n 09:25 n 10:25 n 11:25 n 12:25 n 13:25 n 15:38 n 17:38 19:25 n 20:25 21:25 22:25 23:25
n 07:40 n 15:40 n 17:40
17 Kunčice pod Ondřejníkem 41 41 46-58 n 05:32 # 07:42 n 09:32 n 10:32 n 11:32 n 12:32 n 13:32 # 15:42 # 17:42 19:32 n 20:32 21:32 22:32 23:32
18 Frenštát pod Radhoštěm 47,3 47 57-58-59 n 05:38 n 09:38 # 10:38 n 11:38 # 12:38 n 13:38 19:38 $ 20:38 21:38 22:38 23:38
19 Frenštát pod Radhoštěm 47,3 47 57-58-59 n 05:40 n 09:40 n 11:40 n 13:40 19:40 ( 20:40 21:40 23:40
57-58-59 % 05:42
20 Frenštát pod Radhoštěm město 48,8 48 # 09:42 # 11:42 # 13:42 19:42 ( 20:42 21:42 23:42
S6 Frenštát pod Radhoštěm město - Ostrava hl.n. Platí od 10. 12. 2023 do 14. 12. 2024
Číslo Tarifní Na 3101 3103 3105 3107 3109 3111 3113 3115 3117 3119 3121 3123 3125 3127 3129 3131 3133 3135 3137 3139 3141 3143 3145 3147 3149 3151 3153 3155 3157 3159
řádku km znamení ! ! ~ ! ~ ! ~ ! ~
Název tarifního bodu km Zóna ~ ~ ~ ! ~ ! ~ ! ~ ! ! $
~ 03:48 04:18
03:50 04:20 ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
04:01 03:52 04:22
20 Frenštát pod Radhoštěm město 0 0 57-58-59 04:05 04:01 04:31 # 06:18 # 08:18 # 10:18 # 12:18 # 14:18 # 16:18 # 18:18 20:18 ( 21:18 22:18
04:10 04:05 04:35
19 Frenštát pod Radhoštěm 1,5 1 57-58-59 04:15 04:10 04:40 n 06:20 n 08:20 n 10:20 n 12:20 n 14:20 n 16:20 n 18:20 20:20 ( 21:20 22:20
04:19 04:17 04:47
18 Frenštát pod Radhoštěm 1,5 1 57-58-59 04:21 04:21 04:51 # 05:22 n 06:22 # 07:22 n 08:22 # 09:22 n 10:22 # 11:22 n 12:22 # 13:22 n 14:22 # 15:22 n 16:22 # 17:22 n 18:22 19:22 20:22 $ 21:22 22:22
04:24 04:25 04:55 n 05:31 n 07:31 n 13:31 n 15:31
17 Kunčice pod Ondřejníkem 7,8 7 46-58 04:27 04:29 04:59 n 05:35 n 06:31 n 07:35 n 08:31 n 09:31 n 10:31 n 11:31 n 12:31 n 13:35 n 14:31 n 15:35 n 16:31 n 17:31 n 18:31 19:31 20:31 n 21:31 22:31
04:29 04:31 05:01 # 05:40 # 07:40 # 13:40 # 15:40
16 Čeladná 11,4 11 46-48 04:33 04:35 05:05 05:17 05:47 n 06:35 07:17 07:47 n 08:35 n 09:35 n 10:35 n 11:35 n 12:35 13:17 13:47 n 14:35 15:17 15:47 n 16:35 n 17:35 n 18:35 19:35 20:35 n 21:35 22:35
04:40 05:10 05:21 05:51 07:21 07:51 13:21 13:51 15:21 15:51
15 Frýdlant nad Ostravicí 16,1 16 48 04:45 05:15 05:25 05:55 # 06:40 07:25 07:55 # 08:40 # 09:40 # 10:40 # 11:40 # 12:40 13:25 13:55 # 14:40 15:25 15:55 # 16:40 # 17:40 # 18:40 19:40 20:40 n 21:40 22:40
04:49 05:19 05:29 05:59 07:29 07:59 13:29 13:59 15:29 15:59
14 Frýdlant nad Ostravicí 16,1 16 48 04:51 05:21 05:31 06:01 06:17 06:47 07:31 08:01 08:17 08:47 09:47 10:47 11:47 12:47 13:31 14:01 14:17 14:47 15:31 16:01 16:17 16:47 17:17 17:47 18:47 19:47 20:47 n 21:47 22:42
04:54 05:24 05:35 06:05 07:35 08:05 13:35 14:05 15:35 16:05
13 Pržno 19,5 19 48-49 04:57 05:27 05:40 06:10 06:21 06:51 07:40 08:10 08:21 08:51 09:51 10:51 11:51 12:51 13:40 14:10 14:21 14:51 15:40 16:10 16:21 16:51 17:21 17:51 18:51 19:51 20:51 n 21:51 22:46
04:59 05:29 05:45 06:15 07:45 08:15 13:45 14:15 15:45 16:15
12 Baška 23,4 23 49 05:03 05:33 05:49 06:19 06:25 06:55 07:49 08:19 08:25 08:55 09:55 10:55 11:55 12:55 13:49 14:19 14:25 14:55 15:49 16:19 16:25 16:55 17:25 17:55 18:55 19:55 20:55 n 21:55 22:50
05:51 06:21 07:51 08:21 13:51 14:21 15:51 16:21
11 Frýdek-Místek 26,6 26 49-50-55 05:54 06:24 06:29 06:59 07:54 08:24 08:29 08:59 09:59 10:59 11:59 12:59 13:54 14:24 14:29 14:59 15:54 16:24 16:29 16:59 17:29 17:59 18:59 19:59 20:59 n 21:59 22:54
05:57 06:27 07:57 08:27 13:57 14:27 15:57 16:27
10 Frýdek-Místek 26,6 26 49-50-55 05:59 06:29 06:31 07:01 07:59 08:29 08:31 09:01 10:01 11:01 12:01 13:01 13:59 14:29 14:31 15:01 15:59 16:29 16:31 17:01 17:31 18:01 19:01 20:01 21:01 n 22:01 23:04
06:03 06:33 08:03 08:33 14:03 14:33 16:03 16:33
9 Lískovec u Frýdku 29,7 29 50 06:35 07:05 08:35 09:05 10:05 11:05 12:05 13:05 14:35 15:05 16:35 17:05 17:35 18:05 19:05 20:05 21:05 n 22:05 23:08
8 Paskov 34,5 34 2-18-50 06:40 07:10 08:40 09:10 10:10 11:10 12:10 13:10 14:40 15:10 16:40 17:10 17:40 18:10 19:10 20:10 21:10 n 22:10 23:13
7 Vratimov 38,7 38 2-18 06:45 07:15 08:45 09:15 10:15 11:15 12:15 13:15 14:45 15:15 16:45 17:15 17:45 18:15 19:15 20:15 21:15 n 22:15 23:18
6 Ostrava-Kunčice 41 40 1-2 06:49 07:19 08:49 09:19 10:19 11:19 12:19 13:19 14:49 15:19 16:49 17:19 17:49 18:19 19:19 20:19 21:19 n 22:19 23:22
5 Ostrava-Kunčice 41 40 1-2 06:51 07:21 08:51 09:21 10:21 11:21 12:21 13:21 14:51 15:21 16:51 17:21 17:51 18:21 19:21 20:21 21:21 n 22:21 23:24
4 Ostrava-Kunčičky 43,2 42 1-2 X 06:54 07:24 08:54 09:24 10:24 11:24 12:24 13:24 14:54 15:24 16:54 17:24 17:54 18:24 19:24 20:24 21:24 n 22:24 23:27
3 Ostrava střed 45,9 45 1-2 06:57 07:27 08:57 09:27 10:27 11:27 12:27 13:27 14:57 15:27 16:57 17:27 17:57 18:27 19:27 20:27 21:27 n 22:27 23:30
2 Ostrava-Stodolní 46,6 46 1-2 06:59 07:29 08:59 09:29 10:29 11:29 12:29 13:29 14:59 15:29 16:59 17:29 17:59 18:29 19:29 20:29 21:29 n 22:29 23:33
1 Ostrava hl. n. (Ostrava uhelné n.) 48,8 48 1-2 07:03 07:33 09:03 09:33 10:33 11:33 12:33 13:33 15:03 15:33 17:03 17:33 18:03 18:33 19:33 20:33 21:33 $ 22:33 23:36
! jede v pracovní dny, nejede 23.12. - 1.1.
# jede v sobotu, v neděli a ve státem uznané svátky a 27.-29.12.2023
$ nejede 24.12.2023, 31.12.2023
% jede v sobotu, v neděli a ve státem uznané svátky a 27.-29.12.2023, nejede 25.12.2023, 1.1.2024
nejede 25.12.2023, 1.1.2024
( nejede 24. 12. 2023, 31. 12. 2023 a v sobotu, kromě 30. 3. 2024, 6. 7. 2024 a 28. 9. 2024
~ vůz vhodný pro přepravu cestujících na vozíku, vybavený zvedací plošinou
ve vlaku jsou řazeny vozy 1.třídy, možnost využití příplatku ODISprima
ve stanici Frýdek-Místek nutno přestoupit (umožněno dopravci zřídit v případě potřeby pravidelný přestup mezi soupravami)
Všechny uvedené spoje jsou zajištěny soupravou sestavenou z jedné jednotky standardu ODIS 4.
Přehled spojů a výpočet výkonů - Výběrové řízení Push-Pull trať 323
Od 10. 12. 2023 do 14. 12. 2024
Linka Vlak Čas Stanice z Čas Stanice do Omezení Tarifní km Vlakové km Provozních dní Výkon
odjezdu příjezdu
S6 3100 Ostrava hl. n. (Ostrava uhelné n.) Frýdlant nad Ostravicí 84 32 32,7 369 12 066,3
S6 3101 4:24 Frýdlant nad Ostravicí 5:12 Frenštát pod Radhoštěm město 83 16 1 867,6
S6 3102 5:19 Frýdek-Místek 5:42 Ostrava hl. n. (Ostrava uhelné n.) 84 22 16,1 116 8 191,8
S6 3103 4:01 Ostrava hl. n. (Ostrava uhelné n.) 4:33 Frýdlant nad Ostravicí 80 32 8 273,1
S6 3104 4:54 Frenštát pod Radhoštěm město 5:42 Ostrava hl. n. (Ostrava uhelné n.) 80 48 22,2 369
S6 3105 3:48 Ostrava hl. n. (Ostrava uhelné n.) 5:03 Frýdlant nad Ostravicí 32 12 346,4
S6 3106 5:24 Frýdlant nad Ostravicí 6:12 Frenštát pod Radhoštěm 81 15 32,7 253 12 131,7
S6 3107 6:19 Frenštát pod Radhoštěm město 6:38 Ostrava hl. n. (Ostrava uhelné n.) 48
S6 3108 4:18 Ostrava hl. n. (Ostrava uhelné n.) 5:33 Frýdlant nad Ostravicí 80 32 48,8 253 1 722,8
5:54 Frýdlant nad Ostravicí 6:42 Ostrava hl. n. (Ostrava uhelné n.) 80 32 18 104,8
S6 3109 5:17 Ostrava hl. n. (Ostrava uhelné n.) 6:03 Frýdlant nad Ostravicí 32 32,7 371
S6 3110 6:24 Frýdlant nad Ostravicí 7:12 Frenštát pod Radhoštěm město 81 16 8 273,1
S6 3111 7:19 Frenštát pod Radhoštěm 7:42 Frýdlant nad Ostravicí 81 15 14,6 118 8 273,1
S6 3112 5:22 Frýdlant nad Ostravicí 5:40 Ostrava hl. n. (Ostrava uhelné n.) 32 12 131,7
5:47 Ostrava hl. n. (Ostrava uhelné n.) 6:33 Frýdlant nad Ostravicí 80 32 48,8 371 1 899,8
S6 3113 6:54 Frýdlant nad Ostravicí 7:42 Ostrava hl. n. (Ostrava uhelné n.) 80 32 1 722,8
S6 3114 6:17 Ostrava hl. n. (Ostrava uhelné n.) 7:03 Frýdlant nad Ostravicí 32 32,7 253 12 131,7
S6 3115 7:24 Frýdlant nad Ostravicí 8:12 Frenštát pod Radhoštěm 81 15 8 273,1
S6 3116 8:19 Frenštát pod Radhoštěm město 8:38 Frýdlant nad Ostravicí 81 16 32,7 253 8 273,1
6:18 Frýdlant nad Ostravicí 6:40 Ostrava hl. n. (Ostrava uhelné n.) 32 12 131,7
S6 3117 6:47 Ostrava hl. n. (Ostrava uhelné n.) 7:33 Frýdlant nad Ostravicí 80 32 32,7 371 1 722,8
7:54 Frýdlant nad Ostravicí 8:42 Ostrava hl. n. (Ostrava uhelné n.) 80 32 1 899,8
S6 3118 7:17 Ostrava hl. n. (Ostrava uhelné n.) 8:03 Frýdlant nad Ostravicí 32 16,1 118 12 131,7
S6 3119 8:24 Frýdlant nad Ostravicí 9:12 Frenštát pod Radhoštěm město 81 16 8 273,1
S6 3120 9:19 Frenštát pod Radhoštěm 9:42 Frýdlant nad Ostravicí 81 15 14,6 118 8 273,1
7:22 Frýdlant nad Ostravicí 7:40 Ostrava hl. n. (Ostrava uhelné n.) 32 12 131,7
S6 3121 7:47 Ostrava hl. n. (Ostrava uhelné n.) 8:33 Frýdlant nad Ostravicí 81 32 32,7 371 1 899,8
9:24 Frýdlant nad Ostravicí 10:12 Frenštát pod Radhoštěm 80 15 1 722,8
S6 3122 10:19 Frýdlant nad Ostravicí 10:38 Ostrava hl. n. (Ostrava uhelné n.) 32 32,7 253 12 131,7
8:17 Ostrava hl. n. (Ostrava uhelné n.) 9:03 Frýdlant nad Ostravicí 81 32 12 131,7
S6 3123 10:24 Frýdlant nad Ostravicí 11:12 Frenštát pod Radhoštěm město 81 16 32,7 253 1 722,8
11:19 Frenštát pod Radhoštěm město 11:42 Frýdlant nad Ostravicí 16 8 273,1
S6 3124 8:18 Frýdlant nad Ostravicí 8:40 Ostrava hl. n. (Ostrava uhelné n.) 81 32 32,7 371 12 131,7
8:47 Ostrava hl. n. (Ostrava uhelné n.) 9:33 Frýdlant nad Ostravicí 81 32 1 899,8
S6 3125 11:24 Frýdlant nad Ostravicí 12:12 Frenštát pod Radhoštěm 15 14,6 118 1 899,8
S6 3126 12:19 Frenštát pod Radhoštěm 12:38 Frýdlant nad Ostravicí 81 15 12 131,7
S6 3127 9:22 Frýdlant nad Ostravicí 9:40 Ostrava hl. n. (Ostrava uhelné n.) 81 32 16,1 118 12 131,7
9:47 Ostrava hl. n. (Ostrava uhelné n.) 10:33 Frýdlant nad Ostravicí 32 1 722,8
S6 3128 12:24 Frýdlant nad Ostravicí 13:12 Frenštát pod Radhoštěm město 80 16 32,7 371 1 722,8
13:19 Frenštát pod Radhoštěm město 13:42 Frýdlant nad Ostravicí 81 16 12 131,7
S6 3129 10:18 Frýdlant nad Ostravicí 10:40 Ostrava hl. n. (Ostrava uhelné n.) 32 32,7 253 12 131,7
S6 3130 10:47 Ostrava hl. n. (Ostrava uhelné n.) 11:33 Frýdlant nad Ostravicí 81 32 1 899,8
S6 3131 12:54 Frenštát pod Radhoštěm 13:42 Frýdlant nad Ostravicí 81 15 32,7 253 1 899,8
S6 3132 11:22 Frýdlant nad Ostravicí 11:40 Ostrava hl. n. (Ostrava uhelné n.) 32 12 131,7
11:47 Ostrava hl. n. (Ostrava uhelné n.) 12:33 Frýdlant nad Ostravicí 80 32 32,7 371 8 273,1
S6 3133 13:24 Frýdlant nad Ostravicí 14:12 Frenštát pod Radhoštěm 80 15 1 722,8
S6 3134 14:19 Frenštát pod Radhoštěm město 14:38 Frýdlant nad Ostravicí 16 16,1 118 12 131,7
S6 3135 12:18 Frýdlant nad Ostravicí 12:40 Ostrava hl. n. (Ostrava uhelné n.) 81 32 12 131,7
S6 3136 12:47 Ostrava hl. n. (Ostrava uhelné n.) 13:33 Frýdlant nad Ostravicí 81 32 14,6 118 1 722,8
13:54 Frýdlant nad Ostravicí 14:42 Ostrava hl. n. (Ostrava uhelné n.) 32 1 899,8
S6 3137 13:17 Ostrava hl. n. (Ostrava uhelné n.) 14:03 Frýdlant nad Ostravicí 80 32 32,7 371 12 131,7
S6 3138 14:24 Frýdlant nad Ostravicí 15:12 Frenštát pod Radhoštěm město 80 16 8 273,1
S6 3139 15:19 Frenštát pod Radhoštěm 15:42 Frýdlant nad Ostravicí 15 32,7 371 8 273,1
S6 3140 13:22 Frýdlant nad Ostravicí 13:40 Ostrava hl. n. (Ostrava uhelné n.) 81 32 12 131,7
13:47 Ostrava hl. n. (Ostrava uhelné n.) 14:33 Frýdlant nad Ostravicí 81 32 14,6 118 1 899,8
S6 3141 14:54 Frýdlant nad Ostravicí 15:42 Ostrava hl. n. (Ostrava uhelné n.) 32 1 722,8
S6 3142 14:17 Ostrava hl. n. (Ostrava uhelné n.) 15:03 Frýdlant nad Ostravicí 80 32 32,7 253 12 131,7
S6 3143 15:24 Frýdlant nad Ostravicí 16:12 Frenštát pod Radhoštěm 80 15 8 273,1
S6 3144 16:19 Frenštát pod Radhoštěm město 16:38 Frýdlant nad Ostravicí 16 32,7 371 8 273,1
S6 3145 14:18 Frýdlant nad Ostravicí 14:40 Ostrava hl. n. (Ostrava uhelné n.) 81 32 12 131,7
S6 3146 14:47 Ostrava hl. n. (Ostrava uhelné n.) 15:33 Frýdlant nad Ostravicí 81 32 16,1 118 1 722,8
S6 3147 15:54 Frýdlant nad Ostravicí 16:42 Ostrava hl. n. (Ostrava uhelné n.) 32 1 899,8
S6 3148 15:17 Ostrava hl. n. (Ostrava uhelné n.) 16:03 Frýdlant nad Ostravicí 80 32 16,1 118 12 131,7
S6 3149 16:24 Frýdlant nad Ostravicí 17:12 Frenštát pod Radhoštěm město 80 16 8 273,1
17:19 Frenštát pod Radhoštěm 17:42 Frýdlant nad Ostravicí 15 32,7 371 8 273,1
S6 3150 15:22 Frýdlant nad Ostravicí 15:40 Ostrava hl. n. (Ostrava uhelné n.) 81 32 12 131,7
15:47 Ostrava hl. n. (Ostrava uhelné n.) 16:33 Frýdlant nad Ostravicí 32 32,7 371 1 899,8
S6 3151 16:54 Frýdlant nad Ostravicí 17:42 Ostrava hl. n. (Ostrava uhelné n.) 80 32 1 722,8
S6 3152 16:17 Ostrava hl. n. (Ostrava uhelné n.) 17:03 Frenštát pod Radhoštěm 80 47 14,6 118 12 131,7
S6 3153 17:24 Frenštát pod Radhoštěm město 18:38 Frýdlant nad Ostravicí 16 8 273,1
S6 3154 16:18 Frýdlant nad Ostravicí 16:40 Ostrava hl. n. (Ostrava uhelné n.) 81 32 14,6 118 8 273,1
S6 3155 16:47 Ostrava hl. n. (Ostrava uhelné n.) 17:33 Frýdlant nad Ostravicí 32 17 548,3
S6 3156 17:54 Frýdlant nad Ostravicí 18:42 Ostrava hl. n. (Ostrava uhelné n.) 82 32 32,7 371 1 899,8
S6 3157 17:17 Ostrava hl. n. (Ostrava uhelné n.) 18:03 Frenštát pod Radhoštěm město 85 48 12 131,7
S6 3158 18:24 Frenštát pod Radhoštěm 19:42 Frýdlant nad Ostravicí 81 15 32,7 371 8 273,1
S6 3159 17:22 Frýdlant nad Ostravicí 17:40 Ostrava hl. n. (Ostrava uhelné n.) 32 8 273,1
17:47 Ostrava hl. n. (Ostrava uhelné n.) 18:33 Frenštát pod Radhoštěm 82 47 16,1 118 18 104,8
19:24 Frenštát pod Radhoštěm 20:38 Frenštát pod Radhoštěm město 82 1 1 722,8
20:40 Frenštát pod Radhoštěm město 20:42 Frýdlant nad Ostravicí 16 16,1 118 12 131,7
18:18 Frýdlant nad Ostravicí 18:40 Ostrava hl. n. (Ostrava uhelné n.) 85 32 17 453,7
18:47 Ostrava hl. n. (Ostrava uhelné n.) 19:33 Frenštát pod Radhoštěm město 82 48 32,7 371
20:24 Frenštát pod Radhoštěm 21:42 Ostrava hl. n. (Ostrava uhelné n.) 82 47 478,5
19:22 Ostrava hl. n. (Ostrava uhelné n.) 20:33 Frenštát pod Radhoštěm 47 32,7 253 1 899,8
21:24 Frenštát pod Radhoštěm město 22:38 Ostrava hl. n. (Ostrava uhelné n.) 48 12 131,7
20:18 Ostrava hl. n. (Ostrava uhelné n.) 21:33 Frenštát pod Radhoštěm město 48 14,6 118 18 104,8
22:24 Frenštát pod Radhoštěm město 23:42 Frenštát pod Radhoštěm 1 17 453,7
21:18 Frenštát pod Radhoštěm 21:20 Ostrava hl. n. (Ostrava uhelné n.) 47 32,7 371 17 453,7
21:22 Ostrava hl. n. (Ostrava uhelné n.) 22:33 Frýdek-Místek 22 18 104,8
23:24 Frenštát pod Radhoštěm město 23:59 Ostrava hl. n. (Ostrava uhelné n.) 48 32,7 371 18 104,8
22:18 22:54
14,6 118 478,5
17 453,7
16,1 118
8 191,8
32,7 371 18 104,8
759 319,70
32,7 253
32,7 253
32,7 371
16,1 118
14,6 118
32,7 371
32,7 253
32,7 253
32,7 371
14,6 118
16,1 118
32,7 371
32,7 253
32,7 253
32,7 371
16,1 118
14,6 118
32,7 371
32,7 253
32,7 253
47,3 371
16,1 118
32,7 371
32,7 253
32,7 253
48,8 371
14,6 118
32,7 371
47,3 369
1,5 319
16,1 118
32,7 371
48,8 371
47,3 369
47,3 369
48,8 371
48,8 371
1,5 319
47,3 369
22,2 369
48,8 371
Celkový výkon:
Vysvětlivky k omezení provozu (úseky, ke kterým se vysvětlivky vztahují, jsou vyznačeny v jízdním řádu):
+! jede v pracovní dny, nejede 23. 12. 2023 - 1. 1. 2024
+# jede v sobotu, v neděli a ve státem uznané svátky a 27.-29. 12. 2023
+$ nejede 24. 12. 2023 a 31. 12. 2023
+% jede v sobotu, v neděli a ve státem uznané svátky a 27.-29. 12. 2023, nejede 25. 12. 2023, 1. 1. 2024
+ nejede 25. 12. 2023, 1. 1. 2024
+( nejede 24. 12. 2023, 31. 12. 2023 a v sobotu, kromě 30. 3. 2024, 6. 7. 2024 a 28. 9. 2024
~ vůz vhodný pro přepravu cestujících na vozíku, vybavený zvedací plošinou
ve vlaku jsou řazeny vozy 1.třídy, možnost využití příplatku ODISprima
ve stanici Frýdek-Místek nutno přestoupit (umožněno dopravci zřídit pravidelný přestup mezi soupravami)
Kilometráž trať 323
Úsek: Ostrava hl. n. - Frenštát pod Vlakový Tarifní Zóna ODIS
Radhoštěm město kilometr kilometr
1-2
Ostrava hl. n. (Ostrava uhelné n.) 0 0 1-2
Ostrava-Stodolní 2,2 2 1-2
Ostrava střed 2,9 3 1-2
Ostrava-Kunčičky 5,6 6 1-2
Ostrava-Kunčice 7,8 8 2-18
Vratimov 10,1 10 2-18-50
Paskov 14,3 14 50
Lískovec u Frýdku 19,1 19 49-50-55
Frýdek-Místek 22,2 22 49
Baška 25,4 25 48-49
Pržno 29,3 29 48
Frýdlant nad Ostravicí 32,7 32 46-48
Čeladná 37,4 37 46-58
Kunčice pod Ondřejníkem 41 41 57-58-59
Frenštát pod Radhoštěm 47,3 47 57-58-59
Frenštát pod Radhoštěm město 48,8 48
Provoz výchozí stránka
Model výchozí (MV) stránka
MV Zaokrouhlený stránka
Index stránka
Doplněk stránka
Model aktualizovaný (MA) stránka
MA Výkon stránka
MA Vozidlo stránka
MA Fixní stránka
Objednávka stránka
Model objednávkový (MO) stránka
MO Výkon stránka
MO Vozidlo stránka
Skutečnost stránka
Skutečnost stránka
Skutečnost stránka
Kompenzace stránka
Kompenzace stránka
Kompenzace stránka
Kalendářní rok stránka
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
Příloha č. 5 – Výpočet kompenzace
VÝPOČET KOMPENZACE
Součástí Zadávací dokumentace je elektronický výpočetní nástroj, který slouží ke kalkulaci Výchozí ceny
i následnému výpočtu Cen ze Smlouvy s vybraným Dopravcem (dále jen „Finanční model“). Údaje
zadané Dopravcem do Finančního modelu jsou součástí Nabídky, využity však jsou také k návazným
výpočtům, zohledňujícím pro každý rok běhu Smlouvy:
• Indexaci Cenotvorných položek v průběhu Smlouvy;
• Doplnění Cenotvorných položek, které jsou předjímány Smlouvou, avšak jejich výše není
známa ke dni podání Nabídky;
• Odchylku každoroční Objednávky od Výchozího dopravního výkonu či Výchozího počtu
vlakových jednotek;
• Vyúčtování Skutečnosti vůči Objednávce za uplynulé období Jízdního řádu.
Tento dokument vysvětluje užité pojmy, nastavení Finančního modelu, způsob ovládání modelu ze
strany Objednatele i Dopravce a definuje vzorce použité ve Finančním modelu pro výpočet Skutečné
kompenzace.
1 POJMY
1.1 Finanční model
Finanční model je elektronický výpočetní nástroj, který slouží ke kalkulaci Výchozí ceny i následnému
výpočtu Kompenzace ze Smlouvy s vybraným Dopravcem, v závislosti na vývoji Cenotvorných položek,
Skutečných tržeb, odchylce Objednávky od Výchozího dopravního výkonu či Výchozího počtu
vlakových jednotek a konečném vyúčtování Skutečnosti vůči Objednávce. Finanční model se člení na
období platnosti Jízdních řádů, nikoliv období kalendářních roků (s výjimkou uvedenou dále). Strukturu
Finančního modelu popisuje kapitola 2.
• Výchozí finanční model slouží k jednorázovému zadání Cenotvorných položek, které vstupují
do výpočtu Ceny a podle kterých je hodnocena Nabídka. Dopravce zde zadává Cenotvorné
položky v cenové úrovni roku 2021 na celou Dobu plnění. Po celé toto období je Výchozí
finanční model založen na předpokladu Výchozího dopravního výkonu i Výchozího počtu
vlakových jednotek. Dopravce dále ve Výchozím finančním modelu uvádí variabilitu
Cenotvorných položek k dopravnímu výkonu a k vozidlům procentuálním podílem, neměnným
po celé období Smlouvy. Sestavení Výchozího finančního modelu popisuje kapitola 3.
• Aktualizovaný finanční model slouží ke každoroční valorizaci Výchozího finančního modelu
podle vývoje Cenotvorných položek na trhu prostřednictvím Indexů. Dále umožňuje doplnění
Cenotvorných položek, které jsou předjímány Smlouvou, avšak jejich výše nebyla známa ke dni
podání Nabídky nebo ji Objednatel vyloučil z Výchozího finančního modelu. Aktualizovaný
finanční model zobrazuje Cenotvorné položky v cenové úrovni roku počátku platnosti Jízdního
řádu, pro který je spočten, při uvažování Výchozího dopravního výkonu po celé období
Smlouvy. Sestavení Aktualizovaného finančního modelu popisuje kapitola 4.
• Objednávkový finanční model slouží ke každoročnímu přepočtení Aktualizovaného finančního
modelu podle Objednávky. Předmětem Objednávky je stanovení Objednaného dopravního
výkonu a Objednaného počtu vlakových jednotek. Objednávkový finanční model zobrazuje
Cenotvorné položky v cenové úrovni roku počátku platnosti Jízdního řádu, pro který je spočten,
při uvažování Objednaného dopravního výkonu a Objednaného počtu vlakových jednotek na
totožný Jízdní řád. Sestavení Objednávkového finančního modelu popisuje kapitola 5.
Stránka 1 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
Objednávka – stanovení parametrů Plnění Objednatelem pro následující období, činěné v předstihu
před zahájením platnosti nového Jízdního řádu. Objednávkou se uzpůsobuje Jízdní řád předvídaným
změnám v poptávce, provozu na trati nebo organizaci integrovaného dopravního systému.
Objednávkou může dojít ke změně rozsahu a tím i potřebě stanovení Objednávkové ceny. Objednávka
je výsledkem procesu za účasti Dopravce i Objednatele dle pravidel Smlouvy.
Skutečnost – zpětné vyhodnocení provozu na Lince, které vystihuje nepředvídané změny Objednávky
a Skutečné tržby. Vyhodnocení Skutečnosti se provádí s měsíční podrobností, na jeho základě je pak
stanovena Skutečná kompenzace.
1.2 Cenotvorné položky
Cenotvorné položky – tvoří je struktura nákladů (řádky 1 až 16) a zisku (řádek 22). V některých
případech jsou rozdělené do větší podrobnosti položek. Cenotvorné položky vycházejí z provozně a
ekonomicky odůvodnitelného základu a rozvržení v čase. Definovány jsou touto kapitolou následovně:
• 1 Trakční energie a palivo
o 1.1 Motorová nafta – spotřeba motorové nafty pro pohon a klimatizování Vozidla,
vyjádřená v nákladech na pohonné hmoty
o 1.2 Jiné – náklady na jiné zdroje trakční energie a paliva, než je motorová nafta, např.
aditiva AdBlue
• 2 Netrakční energie a palivo – energie či palivo, které nejsou spotřebovány pro pohon a
klimatizování Vozidel, jde např. o vytápění údržbářsko – opravárenského zázemí
• 3 Přímý materiál – spotřeba materiálu ze skladu spojená především s provozem a běžnou
údržbou Vozidel, spotřeba tiskopisů a materiálu pro tiskárny odbavovacích zařízení, spotřeba
nápojů poskytnutých zaměstnancům, spotřeba drobného majetku, spotřeba nákladů na nákup
zboží pro služby objednané ve Smlouvě
• 4 Opravy a údržba vozidel – opravy vyšších stupňů Vozidel v souladu s údržbářsko-
opravárenskými předpisy, zajišťovaná externě i vnitropodnikově, pravidelná kontrola Vozidel
v předepsaných intervalech, neplánované opravy Vozidel po poškození či nehodě
• 5 Odpisy dlouhodobého majetku
o 5.1 Vlakové jednotky – odpisy za Vlakové jednotky sloužící k Plnění Smlouvy,
definované převodem do majetku Dopravce podle příslušných ustanovení Smlouvy
o 5.2 Ostatní – odpisy za hnací vozidla a další majetek Dopravce (budovy, stroje a
zařízení, software) sloužící k Plnění Smlouvy, mimo Vlakové jednotky
• 6 Pronájem a leasing vozidel – náklady na zajištění Vozidel sloužících k Plnění Smlouvy formou
pronájmu či leasingu, pokud nedochází k jejich pořízení do majetku Dopravce
• 7 Mzdové náklady
o 7.1 Vlakový personál – osobní mzdové náklady za zaměstnance, kteří se přímo účastní
provozu Spojů (strojvedoucí, vlakvedoucí, průvodčí)
o 7.2 Ostatní zaměstnanci – osobní mzdové náklady za zaměstnance, kteří jsou do
provozu Spojů zapojeni nepřímým způsobem (údržbáři, mechanici, strojmistři,
pokladní, technicko-hospodářští pracovníci)
• 8 Sociální a zdravotní pojištění
o 8.1 Vlakový personál – odvody na sociálním a zdravotním pojištění za zaměstnance,
kteří se přímo účastní provozu Spojů (strojvedoucí, vlakvedoucí, průvodčí)
o 8.2 Ostatní zaměstnanci – odvody na sociálním a zdravotním pojištění za
zaměstnance, kteří jsou do provozu Spojů zapojeni nepřímým způsobem (údržbáři,
mechanici, strojmistři, pokladní, technicko-hospodářští pracovníci)
• 9 Cestovné – cestovné vyplývající ze zákoníku práce a ve výši určené ze strany veřejné správy
Stránka 2 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
• 10 Úhrada za použití dopravní cesty – náklady za použití železniční dopravní cesty vč. poplatku
za přidělení kapacity na dopravní cestě; jsou vypočteny na základě Objednávky a podmínek a
cen uvedených v Prohlášení o dráze
• 11 Úhrada za použití ostatní infrastruktury – úhrada za Zařízení služeb dle Zákona o dráhách
a příslušného Prohlášení o dráze (např. poplatek za přístup k čerpacím stanicím, poplatek za
použití odstavných kolejí, poplatek za použití veřejně přístupných prostor ve stanicích); jsou
vypočteny na základě Objednávky a podmínek a cen uvedených v Prohlášení o dráze, pokud
taková úhrada bude zavedena
• 12 Ostatní přímé náklady – náklady spojené s provozními zaměstnanci (příspěvky
zaměstnavatele na penzijní připojištění, kapitálové pojištění, ošacení, závodní stravování),
finanční náklady Vozidel (úroky), pojištění majetku, správní poplatky
• 13 Ostatní služby – náklady na služby nezařazené do výše uvedených položek; jedná se např.
o náklady na čištění, úklid a ostrahu Vozidel, nájemné za pokladny od správce železničních
stanic, provize za prodej jízdních dokladů externím prodejcem, převoz peněz, platby za
přechodné ubytování provozních zaměstnanců, telekomunikační služby, IT služby,
marketingové služby, právní služby a posudky, ostraha objektů, náhradní autobusová doprava
a další daňově uznatelné služby související se zajištěním plnění Smlouvy
• 14 Provozní režie – režijní náklady provozního charakteru, nezávislé na výši Objednávky,
spojené s poskytováním Plnění předmětné Smlouvy; jedná se např. o paušál za provoz
odbavovacího systému či jiných technologických zařízení Dopravce
• 15 Správní režie – režijní náklady správního charakteru, nezávislé na výši Objednávky, spojené
s řízením a správou Smlouvy
• 16 Poplatek KODIS – paušální náklady na zajištění činnosti koordinátora integrovaného
dopravního systému, odvozené od Dopravního výkonu
• 22 Zisk – kalkulovaný zisk Dopravce z poskytování Plnění dle Smlouvy
1.3 Cena, tržby, kompenzace
Cena znamená součet Cenotvorných položek pro příslušné období Jízdního řádu.
• Výchozí cena – součet Cenotvorných položek pro daný Jízdní řád, zadaný ve Výchozím
finančním modelu. Udává se v tisících Kč a je pro všechna období Jízdního řádu vztažena
k cenové úrovni roku 2021.
• Aktualizovaná cena – součet Cenotvorných položek pro daný Jízdní řád, spočítaných
v Aktualizovaném finančním modelu. Udává se v tisících Kč a je vždy vztažena k cenové úrovni
počátku platnosti Jízdního řádu, pro který byla spočtena.
• Objednávková cena – součet Cenotvorných položek pro daný Jízdní řád, spočítaných
v Objednávkovém finančním modelu. Udává se v tisících Kč a je vždy vztažena k cenové úrovni
počátku platnosti Jízdního řádu, pro který byla spočtena.
• Skutečná cena – Objednávková cena upravená na základě Skutečnosti o finanční ekvivalent
odchylek Skutečnosti proti Objednávce. Udává se v tisících Kč a je vždy vztažena k cenové
úrovni počátku platnosti Jízdního řádu, pro který byla spočtena.
Skutečné tržby – skutečný výnos z poskytování Plnění náležející Dopravci, získaný zpětným
vyúčtováním Skutečnosti, včetně provedeného zúčtování tržeb dle pravidel Smlouvy. Udávají se
v tisících Kč a jsou vždy vztaženy k cenové úrovni počátku platnosti Jízdního řádu, pro který byly
spočteny.
Skutečná kompenzace – kompenzace dle § 23 ZVS, k jejíž úhradě se Objednatel Dopravci zavazuje za
poskytování Plnění na základě Smlouvy. Skutečná kompenzace je vypočtena jako rozdíl Skutečné ceny
Stránka 3 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
a Skutečných tržeb. Skutečná kompenzace se udává v tisících Kč a je vždy vztažena k cenové úrovni
počátku platnosti Jízdního řádu, pro který byla spočtena.
1.4 Indexace ceny
Index – statistický ukazatel, přiřazený ke každé Cenotvorné položce, aby vystihoval její meziroční
změnu na základě vývoje cen na trhu. Index je zjišťován z veřejně publikovaných dat pro daný rok
v termínu a specifikaci určených v pravidlech Smlouvy. Pro některé Cenotvorné položky může
Objednatel zvolit výpočet bez Indexu, kdy se Cenotvorné položky Výchozího finančního modelu již dále
nevalorizují.
Cenová úroveň – soubor Indexů sloužících k přepočtu položek z Výchozího finančního modelu pro
příslušné období platnosti Jízdního řádu podle pravidel Smlouvy; vzhledem k charakteru Indexů a jejich
časovému zpoždění proti realitě nemusí odpovídat skutečné cenové úrovni daného období.
1.5 Jízdní řád a dopravní výkon
Jízdní řád – plánovaný rozsah provozu, součást grafikonu vlakové dopravy na dotčených tratích. Jízdní
řád má počátek platnosti v prosinci daného roku a ukončení platnosti v prosinci následujícího roku,
v termínech celostátní změny jízdních řádů; jeho délka tedy nemusí odpovídat kalendářnímu roku. Pro
účely této Smlouvy je délka období platnosti Jízdního řádu určující pro výpočet Kompenzace. Jízdní řád
je dále definován zejm. § 40 a násl. Zákona o drahách.
• Výchozí jízdní řád – rozsah provozu na Linkách, stanovený Objednatelem pro Výchozí finanční
model. Jízdní řád plynoucí z Objednávky pro první i další období platnosti se může odlišovat od
Výchozího jízdního řádu, což je zohledněno ve výpočtu Objednávkového finančního modelu.
Spoj – znamená jednotlivý vlak, označený v Jízdním řádu kategorií a číslem vlaku. Každý spoj je určen
svou trasou, zastavováním, časovou polohou, dobou jízdy, požadovanou přepravní kapacitou a
omezením platnosti. Spoje jsou určující pro výpočet dopravního výkonu.
Dopravní výkon – vzdálenost ujetá na jednotlivých Spojích. Pro stanovení Dopravního výkonu jsou
používány údaje provozovatele dráhy.
• Výchozí dopravní výkon – předpokládaný rozsah dopravních výkonů pro předpokládané první
období platnosti Jízdního řádu. Jde o dopravní výkon, k němuž jsou vztaženy všechny
Cenotvorné položky uvedené ve Výchozím finančním modelu a Aktualizovaném finančním
modelu. Dle pravidel Smlouvy se může Objednaný dopravní výkon odlišovat od Výchozího
dopravního výkonu již v prvním období platnosti Jízdního řádu.
• Minimální dopravní výkon – rozsah dopravního výkonu, pod který v každém období platnosti
Jízdního řádu dle Smlouvy neklesne Objednaný dopravní výkon a který si Objednatel vyhradil
ve čl. 8.1 Smlouvy.
• Maximální dopravní výkon – rozsah dopravního výkonu, nad nějž se v každém období
platnosti Jízdního řádu dle Smlouvy nezvýší Objednaný dopravní výkon a který si Objednatel
vyhradil ve čl. 8.1 Smlouvy.
• Objednaný dopravní výkon – dopravní výkon, který je Dopravce povinen splnit dle Jízdního
řádu pro příslušné období jeho platnosti.
o Objednaný dopravní výkon jednotek – dopravní výkon plánovaně zajištěný jednou
Vlakovou jednotkou, vyznačený pro jednotlivé Spoje v Jízdním řádu.
o Objednaný dopravní výkon souprav dvou jednotek – dopravní výkon plánovaně
zajištěný soupravou spřaženou ze dvou Vlakových jednotek, vyznačený pro jednotlivé
Spoje v Jízdním řádu.
Stránka 4 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
• Přidaný dopravní výkon – dopravní výkon, který Dopravce provedl na pokyn Objednatele
nad rámec původní Objednávky, typicky jde o přidání či prodloužení Spoje v Jízdním řádu
během období platnosti, či o realizaci mimořádného Spoje.
• Výkon ujetý záložní soupravou – dopravní výkon zajištěný z rozhodnutí Dopravce ve
Skutečnosti Záložní soupravou v odlišném standardu od Vlakových jednotek.
• Neuskutečněný nezaviněný dopravní výkon – dopravní výkon, který Dopravce neprovedl
na pokyn Objednatele, ač byl původně součástí Objednávky, typicky jde o ubrání či zkrácení
Spoje v Jízdním řádu během období platnosti; dále jde o dopravní výkon neuskutečněný
za okolností uvedených v § 4 odst. 1 a 3 vyhlášky č. 76/2017 Sb., o obsahu a rozsahu služeb
poskytovaných dopravci provozovatelem dráhy a provozovatelem zařízení služeb, v platném
znění (dále také jako „Vyhláška o službách“) nebo za okolností dle § 2913 odst. 2 Občanského
zákoníku, dále pak výkon vázaný na neodjetí Spoje (nebo jeho části), zajištěný náhradní
dopravou v situaci, kdy Dopravce obdržel úhradu nákladů na zajištění náhradní dopravy od
provozovatele dráhy či jiného subjektu než Objednatele.
• Neuskutečněný dopravní výkon v pandemii – dopravní výkon, jehož neuskutečnění je
vázáno na okolnosti definované ve čl. 8 odst. 3 Smlouvy.
• Neuskutečněný zaviněný dopravní výkon – dopravní výkon, který Dopravce neprovedl v
důsledku porušení svých povinností dle této Smlouvy, jde zejm. o případy odřeknutí Spoje v
části nebo v celé trase, dále pak dopravní výkon nerealizovaný z důvodu stávky zaměstnanců
Dopravce.
1.6 Vozidla a vlakové jednotky
Vozidla – vozový park určený k Plnění předmětu Smlouvy.
• Vlaková jednotka – železniční osobní vozidlo nebo provozně nedělitelná souprava vozidel
určených k Plnění předmětu Smlouvy, kterými bude standardně zajišťována doprava ve Spojích
dle Jízdního řádu. Vlaková jednotka je netrakční, vyžaduje tedy doplnění Hnacím vozidlem.
Vlakové jednotky jsou předmětem převodu do majetku Dopravce v souladu se čl. 16 Smlouvy.
• Hnací vozidlo – železniční kolejové vozidlo, které je schopné vyvíjet tažnou sílu a uvádět do
pohybu jak toto vozidlo, tak připojené Vlakové jednotky, případně Záložní soupravu.
• Záložní souprava – železniční osobní vozidlo nebo souprava vozidel, které nesplňuje standard
Vlakových jednotek, ale je možné je využít k Plnění služeb za podmínek daných Smlouvou,
není-li provozně k dispozici potřebný počet Vlakových jednotek.
Počet vlakových jednotek – celkový počet Vlakových jednotek, potřebný k zajištění dopravy dle
Jízdního řádu. Do Počtu vlakových jednotek se započítávají i záložní Vlakové jednotky stejného
standardu. Vlakové jednotky se dle Objednávky nebo na pokyn Objednatele mohou řadit do souprav
dvou Vlakových jednotek.
• Výchozí počet vlakových jednotek – stanovený počet Vlakových jednotek, kterým bude
zajišťována realizace Výchozího dopravního výkonu. Jde o počet Vlakových jednotek, vůči
kterému bude posuzována případná změna počtu vlakových jednotek v Objednávce.
• Objednaný počet vlakových jednotek – upravený počet vlakových jednotek, kterým bude
zajišťována realizace Objednaného dopravního výkonu. Případné odlišnosti od Výchozího
počtu vlakových jednotek jsou zahrnuty do Objednávky.
Záměna řazení vlakových jednotek – změna požadované kapacity Spoje proti údajům uvedeným
v Jízdním řádu Objednávky. Provádí se během období platnosti Jízdního řádu, a to jak trvalou, tak
mimořádnou změnou platnosti. Záměna se projeví ve vyúčtování Skutečnosti vůči Objednávce. Pokud
Stránka 5 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
záměna zvyšuje počet Vlakových jednotek na Spoji, uvádí se ve vyúčtování s kladným znaménkem;
pokud naopak záměna snižuje počet Vlakových jednotek na Spoji, uvádí se ve vyúčtování se záporným
znaménkem.
• Záměna jednotky za soupravu dvou jednotek – dopravní výkon, který Dopravce zajistil na
pokyn Objednatele soupravou dvou Vlakových jednotek, namísto jedné Vlakové
jednotky uvedené v Jízdním řádu Objednávky.
2 FINANČNÍ MODEL
Finanční model je vytvořen v prostředí MS Excel a skládá se ze vzájemně propojených listů. Umožňuje
zadávání dat jak Objednatelem (oranžově vyznačené buňky), tak Dopravcem (žlutě vyznačené buňky).
V různých fázích nabídkového řízení či běhu Smlouvy mohou být různé části Finančního modelu
uzamčeny k úpravám i v oblastech zadávání dat, aby se předešlo záměrnému či nechtěnému přepisu
hodnot.
Listy Finančního modelu jsou vyhotoveny ve standardní struktuře (výjimky z této struktury jsou
uvedeny dále):
• Řádky definují Cenotvorné položky (v buňkách A3:D23)
• Sloupce definují jednotlivá období platnosti Jízdního řádu (v buňkách E2:J2)
Cena (v buňkách G24:J24) je počítána jako součet Cenotvorných položek příslušného období Jízdního
řádu. Typy Cen se odlišují na jednotlivých listech.
Jednotková cena (v buňkách G26:J26) je počítána jako podíl Ceny (v buňkách G24:J24) a Dopravního
výkonu (v buňkách G25:J25). Typy jednotkové ceny se odlišují na jednotlivých listech. Jednotkové
ceny mají jen informativní charakter; do výpočtů vždy vstupují ceny vyjádřené absolutně.
Jednotková cena za Výkon (v buňkách G27:J27) je počítána jako podíl Cenotvorných položek
přiřazených na Výkon (viz níže) a Dopravního výkonu (v buňkách G25:J25). Typy jednotkových cen za
Výkon se odlišují na jednotlivých listech.
Součet Cenotvorných položek (v buňkách K3:K23) vyjadřuje celkovou výši Cenotvorných položek za
Dobu plnění Smlouvy.
Průměr Cenotvorných položek (v buňkách L3:L23) vyjadřuje aritmeticky průměrnou výši
Cenotvorných položek za Dobu plnění Smlouvy.
Přiřazení Cenotvorných položek (v buňkách M3:O23) vyjadřuje podíly, jakými je hodnota dané
Cenotvorné položka závislá na dopravním výkonu a počtu vlakových jednotek, případně zda je daná
Cenotvorná položka neměnná. Přiřazení Cenotvorných položek ovlivňuje výpočet Objednávkové ceny
a Skutečné ceny.
• Přiřazení položek na Výkon (v buňkách M3:M23) znamená, jakým podílem je Cenotvorná
položka proměnná s Dopravním výkonem; tj. při změně (zvýšení či snížení) Dopravního
výkonu se změní přímo úměrně s ním.
Stránka 6 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
• Přiřazení položek na Vozidlo (v buňkách N3:N23) znamená, jakým podílem je Cenotvorná
položka proměnná s Počtem vlakových jednotek; tj. při změně (zvýšení či snížení) Počtu
vlakových jednotek se změní přímo úměrně s ním.
• Přiřazení položek na Fixní složku (v buňkách O3:O23) znamená, jakým podílem je Cenotvorná
položka nezávislá na Dopravním výkonu a Počtu vlakových jednotek; tj. při jejich změně
(zvýšení či snížení) zůstane v absolutní částce stejná.
Meziroční rozdíl Výchozí ceny (v buňce P24) vyjadřuje maximálně dovolený růst či pokles Výchozí
ceny mezi dvěma sousedními obdobími Jízdního řádu. Meziroční rozdíl se vztahuje pouze na Výchozí
finanční model. Koeficient meziročního rozdílu stanovuje Objednatel.
Stránka 7 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
Tabulka 1: Cenotvorné položky a období Jízdního řádu
Výše Cenotvorné položky ������,��, resp. ��𝐴��,��, resp. ������,��
Číslo Pod-číslo Období Jízdního řádu j
Cenotvorné Cenotvorné
položky i položky Název rozdělené j = 1 … j = 3 … j = 6
Cenotvorné položky
i = 1 Název Cenotvorné položky i = 1.1 Motorová nafta 2021/22 2023/24 2026/27
Trakční energie a palivo i = 1.2 Jiné
i = 2
i = 3 Netrakční energie a palivo Vlakové jednotky
i = 4 Ostatní
i = 5 Přímý materiál
Vlakový personál
i = 6 Opravy a údržba vozidel i = 5.1 Ostatní zaměstnanci
i = 7 Odpisy dlouhodobého majetku i = 5.2 Vlakový personál
Ostatní zaměstnanci
i = 8 Pronájem a leasing vozidel i = 7.1
Mzdové náklady i = 7.2
i = 9 i = 8.1
i = 10 Sociální a zdravotní pojištění i = 8.2
i = 11
i = 12 Cestovné
i = 13
i = 14 Úhrada za použití dopravní cesty
i = 15 Úhrada za použití ostatní infrastruktury
i = 16
i = 22 Ostatní přímé náklady
Ostatní služby
Provozní režie
Správní režie
Poplatek KODIS
Zisk
Stránka 8 z 28
kde: Smlouva o veřejných službách v přepravě cestujících
������,�� k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
��𝐴��,��
������,�� Výše Cenotvorné položky i ve Výchozím finančním modelu pro období Jízdního řádu j
Výše Cenotvorné položky i v Aktualizovaném finančním modelu pro období Jízdního řádu j
Výše Cenotvorné položky i v Objednávkovém finančním modelu pro období Jízdního řádu j
V rámci stanovení Objednávky, záznamu Skutečnosti a výpočtu Skutečné kompenzace jsou ve Finančním modelu členěna období Jízdního řádu do
podrobnosti kalendářních měsíců. Finanční model v tomto ohledu vychází z předpokladu, že Dopravní rok je zahájen v termínu prosincové změny Jízdního
řádu. Dojde-li však k posunu zahájení Dopravního roku na jiný termín, je nutné odpovídajícím způsobem upravit členění na kalendářní měsíce v listech
Objednávka, Skutečnost a Kompenzace. Tato úprava však nebude mít dopad na výpočet celkových hodnot za jedno období Dopravního roku.
Stránka 9 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
Tabulka 2: Přiřazení Cenotvorných položek na Výkon, Vozidlo a Fixní složku
Číslo Pod-číslo Přiřazení Cenotvorné položky ����
Cenotvorné Cenotvorné
položky i Název Cenotvorné položky položky Název rozdělené ����𝑉�������� ����𝑉������������ ����𝐹��������
Trakční energie a palivo Cenotvorné položky % % %
i = 1 i = 1.1 Motorová nafta % % %
i = 1.2 Jiné % % %
i = 2 % % %
i = 3 Netrakční energie a palivo Vlakové jednotky % % %
i = 4 Ostatní % % %
i = 5 Přímý materiál % % %
Vlakový personál % % %
i = 6 Opravy a údržba vozidel i = 5.1 Ostatní zaměstnanci % % %
i = 7 Odpisy dlouhodobého majetku i = 5.2 Vlakový personál % % %
Ostatní zaměstnanci % % %
i = 8 Pronájem a leasing vozidel i = 7.1 % % %
Mzdové náklady i = 7.2 % % %
i = 9 i = 8.1 % % %
i = 10 Sociální a zdravotní pojištění i = 8.2 % % %
i = 11 % % %
i = 12 Cestovné % % %
i = 13 % % %
i = 14 Úhrada za použití dopravní cesty % % %
i = 15 Úhrada za použití ostatní infrastruktury % % %
i = 16 % % %
i = 22 Ostatní přímé náklady
Ostatní služby
Provozní režie
Správní režie
Poplatek KODIS
Zisk
Stránka 10 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
přičemž vždy platí, že:
����𝑉�������� + ����𝑉������������ + ����𝐹�������� = 1
kde:
����𝑉�������� Podíl Cenotvorné položky i proměnný s Dopravním výkonem
����𝑉������������ Podíl Cenotvorné položky i proměnný s Počtem vlakových jednotek
����𝐹�������� Podíl Cenotvorné položky i nezávislý na Dopravním výkonu a Počtu vlakových jednotek
Stránka 11 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
2.1 Výchozí provozní předpoklady
Označení listu: Provoz výchozí
Provozní parametry Výchozího dopravního výkonu a Výchozího počtu vlakových jednotek zadává
Objednatel na úvod Finančního modelu.
Na počátku listu Objednávka jsou shrnuty výchozí předpoklady pro sestavení Objednávky:
• Výchozí dopravní výkon [tis.vlkm] (v buňkách C3:F3) vstupuje přímo do Výchozího finančního
modelu (buňky G25:J25); při stanovení výše Cenotvorných položek Výchozího finančního
modelu Dopravce rovněž zohledňuje, jaká část Výchozího dopravního výkonu připadá na
vlaky vedené v jedné vlakové jednotce a vlaky vedené v soupravě dvou jednotek:
o Výchozí dopravní výkon jednotek [tis.vlkm] (v buňkách C4:F4) představuje Dopravní
výkon, který je dle Jízdního řádu v Zadávací dokumentaci zajištěn jednou Vlakovou
jednotkou
o Výchozí dopravní výkon souprav dvou jednotek [tis.vlkm] (v buňkách C5:F5)
představuje Dopravní výkon, který je dle Jízdního řádu v Zadávací dokumentaci
zajištěn soupravou dvou Vlakových jednotek
• Výchozí počet vlakových jednotek [#] (v buňkách C6:F6) je počet vlakových jednotek, kterým
bude zajišťována realizace Výchozího dopravního výkonu, včetně vozidel záložních.
3 VÝCHOZÍ CENA
3.1 Výchozí finanční model
Označení listu: Model výchozí (MV)
Výchozí finanční model slouží k jednorázovému zadání Cenotvorných položek, které vstupují do
výpočtu Cen a podle kterých je hodnocena Nabídka.
Objednatel zde provede přiřazení vybraných Cenotvorných položek [%], kde je přiřazení evidentní
z charakteru Cenotvorné položky nebo je v zájmu Objednatele tuto položku stanovit pro všechny
uchazeče (potenciální Dopravce) jednotně:
• 5.1 Odpisy dlouhodobého majetku – Vlakové jednotky
• 6 Pronájem a leasing vozidel
• 10 Úhrada za použití dopravní cesty
• 11 Úhrada za použití ostatní infrastruktury
• 14 Provozní režie
• 15 Správní režie
• 16 Poplatek KODIS
Cenotvorné položky „5.1 Odpisy dlouhodobého majetku – Vlakové jednotky“, „10 Úhrada za použití
dopravní cesty“ a „11 Úhrada za použití ostatní infrastruktury“ nebudou součástí Nabídky Dopravce
ve Výchozím finančním modelu, neboť budou doplněny Objednatelem až do Aktualizovaného
finančního modelu na základě jejich skutečné výše pro nadcházející období Jízdního řádu.
Stránka 12 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
Dopravce ve Výchozím finančním modelu zadává Cenotvorné položky v cenové úrovni roku 2021
[tis.Kč] na celou Dobu plnění, a to v zaokrouhlení na tisíce. U některých Cenotvorných položek
modelu se předpokládá konstantní průběh po Dobu plnění; v takovém případě Dopravce zadává
údaje pouze údaj prvního období (žlutě vyznačené buňky G3:G23) a zbývající období se do
příslušných řádků zkopírují automaticky. Pro zbývající Cenotvorné položky zadává Dopravce údaje pro
každé období z Doby plnění; záleží na jeho úvaze, zda budou položky v čase stálé nebo proměnné,
musí však představovat reálný odhad budoucího vývoje nákladů v průběhu času a zároveň ve
výsledné Výchozí ceně splnit podmínku meziročního rozdílu (dle koeficientu R viz dále).
Dopravce dále provede přiřazení zbývajících Cenotvorných položek [%] (buňky M3:N23) v položkách,
které nestanovil Objednatel, a to v zaokrouhlení na celá procenta:
• 1 Trakční energie a palivo
• 2 Netrakční energie a palivo
• 3 Přímý materiál
• 4 Opravy a údržba vozidel
• 5.2 Odpisy dlouhodobého majetku – Ostatní
• 7 Mzdové náklady
• 8 Sociální a zdravotní pojištění
• 9 Cestovné
• 12 Ostatní přímé náklady
• 13 Ostatní služby
• 22 Zisk
Výchozí finanční model je jediným listem Finančního modelu, kde pro Nabídku doplňuje údaje
Dopravce. Na následujících listech probíhá výpočet buď automaticky, nebo s doplněním údajů
Objednatelem.
3.1.1 Výchozí cena
��=22 ��=22
������ = ∑ [������,��] = ∑ [(������,�� ⋅ ����𝑉��������) + (������,�� ⋅ ����𝑉������������) + (������,�� ⋅ ����𝐹��������)]
��=1 ��=1
kde:
������ Výchozí cena pro období Jízdního řádu j
������,�� Výše Cenotvorné položky i ve Výchozím finančním modelu pro období Jízdního řádu j
����𝑉�������� Podíl Cenotvorné položky i proměnný s Dopravním výkonem
����𝑉������������
����𝐹�������� Podíl Cenotvorné položky i proměnný s Počtem vlakových jednotek
Podíl Cenotvorné položky i nezávislý na Dopravním výkonu a Počtu vlakových
jednotek
Stránka 13 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
Výpočet meziročního rozdílu Výchozí ceny ověří, zda jsou změny hodnot Výchozí ceny v jednotlivých
obdobích Jízdního řádu v souladu s omezením stanoveným Objednatelem pomocí koeficientu R.
������ ⋅ (1 − ��) ≤ ������+1 ≤ ������ ⋅ (1 + ��)
�� Koeficient meziročního rozdílu Výchozí ceny
������ Výchozí cena pro období Jízdního řádu j
������+1 Výchozí cena pro následující období Jízdního řádu j+1
3.1.2 Výchozí jednotková cena
������
�������� = ����
kde:
�������� Výchozí jednotková cena pro období Jízdního řádu j
������ Výchozí cena pro období Jízdního řádu j
���� Výchozí dopravní výkon
3.1.3 Výchozí jednotková cena na Výkon
��������𝑉�������� = ∑����==212[(������,�� ⋅ ����𝑉��������)]
����
kde:
��������𝑉�������� Výchozí jednotková cena na Výkon pro období Jízdního řádu j
������,�� Výše Cenotvorné položky i ve Výchozím finančním modelu pro období Jízdního řádu j
����𝑉�������� Podíl Cenotvorné položky i proměnný s Dopravním výkonem
���� Výchozí dopravní výkon
3.2 Zaokrouhlený Výchozí finanční model
Označení listu: MV Zaokrouhlený
List má jen kontrolní funkci, aby do všech výpočtů Finančního modelu skutečně vstupovaly
Dopravcem zaokrouhlené hodnoty, jak je požadováno v kapitole 3.1.
4 AKTUALIZOVANÁ CENA
4.1 Indexace Výchozího finančního modelu
Označení listu: Index
Stránka 14 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
Na tomto listu jsou shromážděny hodnoty všech Indexů potřebných k valorizaci Výchozího finančního
modelu během Doby plnění. Také jsou zde jednotlivé Indexy přiřazeny ke konkrétním Cenotvorným
položkám.
4.1.1 Definice a zadání Indexů
Do oranžově vyznačených buněk (v oblasti E3:J27) zadává Objednatel hodnoty statistických ukazatelů
(Indexů) přesně v hodnotě, jak byly získány z originálního zdroje, v souladu s definicí Indexů níže.
Nejpozději ke dni 30. 6. totožného roku se začátkem dalšího období Jízdního řádu, pro který je
připravována Objednávka, Objednatel zjistí hodnoty Indexů za předchozí rok a vyplní jimi příslušný
sloupec období Jízdního řádu. Tím bude vytvořen podklad pro aktualizaci Výchozího finančního
modelu na Cenovou úroveň roku počátku Jízdního řádu.
Pro nabídkové řízení mohou být na tomto listu Objednatelem vyplněny výchozí údaje Indexů pro
cenovou úroveň 2021 (v buňkách E3:E27) v období 2021/22, které slouží jako srovnávací hladina pro
výpočet valorizace nadcházejících období. Období 2022/23 není prakticky využito ve výpočtech
Finančního modelu, v tabulce je však uvedeno pro úplnost časové řady Indexů.
Objednatel rozhodl o přiřazení Indexů k Cenotvorným položkám podle názvu vedeného v příslušném
řádku Cenotvorné položky (v buňkách K3:K23). Vybrané cenotvorné položky nebudou v Době plnění
valorizovány pomocí Indexů (označeno „Bez indexace“ v buňkách K3:K23). V případě změny definice
Indexu na straně statistického zdroje během trvání Smlouvy se smluvní strany dohodnou na
nahrazení jiným Indexem, charakterově nejbližším původnímu Indexu.
Název Indexu Průměrné spotřebitelské ceny pohonných hmot
Statistický zdroj
Český statistický úřad
Přesný popis https://www.czso.cz/csu/czso/setreni-prumernych-cen-
vybranych-vyrobku-pohonne-hmoty-a-topne-oleje-casove-
Zdrojový rok pro Jízdní řád rady
s počátkem platnosti v roce (n) Šetření průměrných cen vybraných výrobků - pohonné hmoty
a topné oleje - časové řady
Měřící jednotka Kč/l
Průměr z týdenních hodnot za kalendářní rok
Motorová nafta
Statistický údaj pro rok (n-1)
Název Indexu Index cen průmyslových výrobců – železniční vozidla CL302
Statistický zdroj
Přesný popis Český statistický úřad
https://www.czso.cz/csu/czso/ipc_cr
Zdrojový rok pro Jízdní řád Indexy cen průmyslových výrobců podle Klasifikace produkce
s počátkem platnosti v roce (n) Bazický index (průměr roku 2015 = 100)
Měřící jednotka %
Roční průměr
Označení skupiny CL 302
Název skupiny Železniční lokomotivy a vozový park
Statistický údaj pro rok (n-1)
Stránka 15 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
Název Indexu Průměrná hrubá měsíční mzda podle odvětví – doprava a
Statistický zdroj skladování
Přesný popis
Český statistický úřad
Zdrojový rok pro Jízdní řád https://www.czso.cz/csu/czso/pmz_cr
s počátkem platnosti v roce (n)
Průměrná hrubá měsíční mzda podle odvětví
Na přepočtené počty zaměstnanců
Měřící jednotka Kč
Hodnota za Q1-Q4
Odvětví H "Doprava a skladování“
Předběžný statistický údaj pro rok (n-1)
Poznámka: předběžný statistický údaj se pro účely Smlouvy a
výpočtu Indexů považuje za dále neměnný a konečný
4.1.2 Upravený index spotřebitelských cen
Pro účely indexace Cenotvorných položek vázaných na spotřebitelskou inflaci Objednatel používá tzv.
Upravený index spotřebitelských cen, který vychází ze statistického ukazatele Indexu spotřebitelských
cen, upraveného následujícím výpočtem.
Název Indexu Index spotřebitelských cen
Statistický zdroj Český statistický úřad
Přesný popis https://www.czso.cz/csu/czso/isc_cr
Indexy spotřebitelských cen – bazický index
Zdrojový rok pro Jízdní řád Bazický index (průměr roku 2015 = 100)
s počátkem platnosti v roce (n) Měřící jednotka %
Roční průměr
Úhrn
Statistický údaj pro rok (n-1)
���������� = ����������−1 ∙ (1 + 𝑚��𝑥 [�������� − ��������−1 − 1%, 0])
��������−1
kde:
�������� Index spotřebitelských cen pro období Jízdního řádu j
��������−1 Index spotřebitelských cen pro předchozí období Jízdního řádu j-1
���������� Upravený index spotřebitelských cen pro období Jízdního řádu j
����������−1 Upravený index spotřebitelských cen pro předchozí období Jízdního řádu j-1
přičemž:
����������=1 = ��������=1
Z uvedeného vyplývá, že pro výpočet Upraveného indexu spotřebitelských cen se použije relativní
meziroční změna Indexu spotřebitelských cen snížená o jedno procento, ovšem za podmínky, že
výsledek výpočtu nabývá nezáporných hodnot.
Stránka 16 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
4.2 Doplněk Výchozího finančního modelu
Označení listu: Doplněk
Na tomto listu lze doplnit hodnoty, které v souladu se Smlouvou byly vyhrazeny jako položky
očekávané, avšak nevyčíslitelné do Nabídky (tj. nezahrnutelné do Výchozího finančního modelu).
Smlouva i Finanční model umožňují prostřednictvím listu Doplněk reagovat na následující případy:
• Hodnota odpisů plynoucích z převedení Vlakových jednotek Dopravci
• Změna Počtu vlakových jednotek z rozhodnutí Objednatele
• Poplatek „Úhrada za použití dopravní cesty“ stanovený správcem dráhy
• Poplatek „Úhrady za použití ostatní infrastruktury“ stanovený správcem dráhy
• Změna Provozní režie z rozhodnutí Objednatele
Hodnota odpisů plynoucích z převedení Vlakových jednotek Dopravci se na listu Doplněk zohlední
tak, že část jejich odpisů připadající na Dobu plnění se doplní do příslušných období Jízdního řádu,
a to u Cenotvorné položky 5 „Odpisy dlouhodobého majetku“ – část 5.1 „Vlakové jednotky“.
Změna počtu vlakových jednotek proti Výchozímu počtu vlakových jednotek se týká jak nárůstu
celkového Počtu vlakových jednotek (s kladným znaménkem nákladů), tak i jejich poklesu (se
záporným znaménkem nákladů). Vzhledem k netrakčnímu provedení Vlakových jednotek se změna
Počtu vlakových jednotek týká i příslušných hnacích vozidel, tvořících jeden provozní celek. Změna
počtu vlakových jednotek se zohlední v následujících Cenotvorných položkách:
• 5 „Odpisy dlouhodobého majetku“ – část 5.1 „Vlakové jednotky“ – pokud se mění počet
Vlakových jednotek v majetku Dopravce, vloží se část jejich odpisů připadající na změnu
Počtu vlakových jednotek do příslušných období Jízdního řádu zbývající Doby plnění;
• 5 „Odpisy dlouhodobého majetku“ – část 5.2 „Ostatní“ – pokud se mění počet hnacích
vozidel v majetku Dopravce, vloží se část jejich odpisů připadající na změnu Počtu vlakových
jednotek do příslušných období Jízdního řádu zbývající Doby plnění;
• 6 „Pronájem a leasing vozidel“ – pokud se mění počet Vlakových jednotek a/nebo hnacích
vozidel zajištěných formou pronájmu či leasingu, vloží se změna nákladů na toto zajištění do
příslušných období Jízdního řádu zbývající Doby plnění.
Poplatek „Úhrada za použití dopravní cesty“ se vypočte zvlášť pro každé nadcházející období Jízdního
řádu, podle platného Prohlášení o dráze a se zohledněním Jízdního řádu pro Objednávku. Výpočet
poplatku bude proveden před samotným uzavřením Objednávky. Výše poplatku tak vstoupí přímo do
výpočtu Aktualizovaného finančního modelu a odtud následně i Objednávkové ceny bez potřeby
dalších úprav. Případné odchylky Skutečnosti proti Objednávce už zpětně nemají vliv na výši položky
„Úhrada za použití dopravní cesty“ zadané na listu Doplněk.
V případě zavedení poplatku „Úhrada za použití ostatní infrastruktury“ bude Objednatelem
vypočtena výše úhrady dopředu pro každé období platnosti Jízdního řádu podle Objednávky, na
základě podkladů pro výpočet zveřejněných správcem dráhy. Výpočet poplatku bude proveden před
samotným uzavřením Objednávky (obdobně jako u poplatku „Úhrada za použití dopravní cesty“).
Stránka 17 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
Změna Provozní režie z rozhodnutí Objednatele odráží náklady vynaložené (s kladným znaménkem
nákladů) či ušetřené (se záporným znaménkem nákladů) z rozhodnutí Objednatele o změnách
informačního a odbavovacího systému a technologického vybavení Vlakových jednotek. Uznatelnost
a postup vyčíslení takových nákladů, vzniknou-li, budou upraveny dodatkem Smlouvy v souladu s
§222 zákona č. 134/2016 Sb., o zadávání veřejných zakázek, ve znění pozdějších předpisů.
Doplněk Výchozího finančního modelu již nepodléhá indexaci, tj. hodnota zadaná na listu Doplněk
pro dané období Jízdního řádu se přebírá do Aktualizovaného finančního modelu bez dalších úprav.
4.3 Aktualizovaný finanční model
Označení listu: Model aktualizovaný (MA)
Aktualizovaný finanční model je vypočten za účelem aktualizace Výchozího finančního modelu. Tím
se hodnoty Cenotvorných položek dostávají z jednotné cenové úrovně roku 2021 na Cenovou úroveň
příslušného roku počátku období Jízdního řádu. Aktualizace je provedena prostřednictvím:
• Indexace Výchozího finančního modelu; a
• Doplňku Výchozího finančního modelu
Indexace Výchozího finančního modelu se do Aktualizovaného finančního modelu projeví tak, že
Cenotvorná položka pro dané období Jízdního řádu z Výchozího finančního modelu je znásobena
poměrem příslušného Indexu pro dané období Jízdního řádu a Indexu pro období 2021/22.
Doplněk Výchozího finančního modelu se do Aktualizovaného finančního modelu projeví tak, že
hodnota zadaná na listu Doplněk pro dané období Jízdního řádu se přebírá bez dalších úprav.
Výsledná hodnota každé Cenotvorné položky Aktualizovaného finančního modelu je pak vypočtena
jako součet Indexace Výchozího finančního modelu a Doplňku Výchozího finančního modelu.
Aktualizovaná cena [tis.Kč] (v buňkách G24:J24) je pro každé období Jízdního řádu vztažena k Cenové
úrovni počátku období platnosti Jízdního řádu, pro který byla spočtena.
4.3.1 Aktualizovaná cena
��=22 ��=22 ����,��
��𝐴�� = ∑ [��𝐴��,��] = ∑ [(������,�� ⋅ ) + ������,�� ]
����,1
��=1 ��=1
��=22
= ∑ [(��𝐴��,�� ⋅ ����𝑉��������) + (��𝐴��,�� ⋅ ����𝑉������������) + (��𝐴��,�� ⋅ ����𝐹��������)]
��=1
kde:
��𝐴�� Aktualizovaná cena pro období Jízdního řádu j
��𝐴��,��
Výše Cenotvorné položky i v Aktualizovaném finančním modelu pro období Jízdního
������,�� řádu j
Výše Cenotvorné položky i ve Výchozím finančním modelu pro období Jízdního řádu j
Stránka 18 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
������,�� Výše Cenotvorné položky i doplněné do Výchozího finančního modelu dle pravidel
Smlouvy (tj. v listech „Doplněk“) pro období Jízdního řádu j
����,�� Index Cenotvorné položky i pro období Jízdního řádu j
����,1 Index Cenotvorné položky i pro období Jízdního řádu j = 1 (tj. Jízdní řád 2021/22)
����𝑉��������
����𝑉������������ Podíl Cenotvorné položky i proměnný s Dopravním výkonem
����𝐹��������
Podíl Cenotvorné položky i proměnný s Počtem vlakových jednotek
Podíl Cenotvorné položky i nezávislý na Dopravním výkonu a Počtu vlakových
jednotek
4.3.2 Aktualizovaná jednotková cena
��𝐴��
����𝐴�� = ����
kde:
����𝐴�� Aktualizovaná jednotková cena pro období Jízdního řádu j
��𝐴�� Aktualizovaná cena pro období Jízdního řádu j
���� Výchozí dopravní výkon
4.3.3 Aktualizovaná jednotková cena za Výkon
����𝐴��𝑉�������� = ∑����==212[(��𝐴��,�� ⋅ ����𝑉�������� )]
����
kde:
����𝐴��𝑉�������� Aktualizovaná jednotková cena za Výkon pro období Jízdního řádu j
��𝐴��,��
Výše Cenotvorné položky i v Aktualizovaném finančním modelu pro období Jízdního
řádu j
����𝑉�������� Podíl Cenotvorné položky i proměnný s Dopravním výkonem
���� Výchozí dopravní výkon
4.4 Aktualizovaný finanční model na Výkon
Označení listu: MA Výkon
Tento list vychází z Aktualizovaného finančního modelu, avšak zobrazuje pouze hodnoty
Cenotvorných položek přiřazené na Výkon. Toto přiřazení bylo provedeno násobením příslušné
Cenotvorné položky Aktualizovaného finančního modelu [tis.Kč] podílem vyjádřeným pro Výkon [%]
(v buňkách M3:M23 Výchozího finančního modelu).
Stránka 19 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
Aktualizovaný finanční model na Výkon tedy zobrazuje výši Cenotvorných položek, která je pro účely
výpočtu Objednávkového finančního modelu proměnná s Dopravním výkonem; tj. při změně (zvýšení
či snížení) Dopravního výkonu se změní přímo úměrně s ním.
4.5 Aktualizovaný finanční model na Vozidlo
Označení listu: MA Vozidlo
Tento list vychází z Aktualizovaného finančního modelu, avšak zobrazuje pouze hodnoty
Cenotvorných položek přiřazené na Vozidlo. Toto přiřazení bylo provedeno násobením příslušné
Cenotvorné položky Aktualizovaného finančního modelu [tis.Kč] podílem vyjádřeným pro Vozidlo [%]
(v buňkách N3:N23 Výchozího finančního modelu).
Aktualizovaný finanční model na Vozidlo tedy zobrazuje výši Cenotvorných položek, která je pro účely
výpočtu Objednávkového finančního modelu proměnná s Počtem vlakových jednotek; tj. při změně
(zvýšení či snížení) Počtu vlakových jednotek se změní přímo úměrně s ním.
4.6 Aktualizovaný finanční model Fixní
Označení listu: MA Fixní
Tento list vychází z Aktualizovaného finančního modelu, avšak zobrazuje pouze hodnoty
Cenotvorných položek přiřazené na Fixní složku. Toto přiřazení bylo provedeno násobením příslušné
Cenotvorné položky Aktualizovaného finančního modelu [tis.Kč] podílem vyjádřeným pro Fixní složku
[%] (v buňkách O3:O23 Výchozího finančního modelu).
Aktualizovaný finanční model Fixní tedy zobrazuje výši Cenotvorných položek, která je pro účely
výpočtu Objednávkového finančního modelu nezávislá na Dopravním výkonu a Počtu vlakových
jednotek; tj. při jejich změně (zvýšení či snížení) zůstane v absolutní částce stejná.
5 OBJEDNÁVKOVÁ CENA
5.1 Objednávka
Označení listu: Objednávka
Tento list slouží k určení parametrů Objednávky, které mají vliv na výpočet Objednávkové ceny. Na
základě údajů zadaných do tohoto listu se Aktualizovaný finanční model (založený na Výchozím
dopravním výkonu a Výchozím počtu vlakových jednotek) přepočte na Objednávkový finanční model
(založený na Objednaném dopravním výkonu a Objednaném počtu vlakových jednotek).
Na počátku listu Objednávka jsou shrnuty výchozí provozní předpoklady (viz kapitolu 2.1).
Další tabulka přináší souhrn Aktualizovaného finančního modelu, zejména pro možnost přímého
srovnání jednotkové Ceny se souhrnem Objednávkového finančního modelu, který je uveden hned
v následující tabulce. Stanovení Ceny za záměnu jednotky za soupravu dvou jednotek v buňkách
C17:F17 má vliv až na výpočet Skutečné ceny, proto odkazujeme na kapitolu 6.2.1.
Stránka 20 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
Do tabulek Objednávky dopravního výkonu se vkládají hodnoty pro každé nadcházejí období platnosti
Jízdního řádu, pro které je sestavována Objednávka. Toto období je rozděleno po kalendářních
měsících, přičemž měsíc prosinec se zde objevuje dvakrát; poprvé za část měsíce náležející k začátku
platnosti Jízdního řádu (tj. od prvního dne platnosti Jízdního řádu do konce kalendářního měsíce),
podruhé za část měsíce náležející ke konci platnosti Jízdního řádu (tj. od začátku kalendářního měsíce
do posledního dne platnosti Jízdního řádu).
Objednávka dopravního výkonu je v součtu uvedena v položce Objednaný dopravní výkon [tis.vlkm]
(v buňkách B21:E21), která se skládá ze složek:
• Objednaný dopravní výkon jednotek [tis.vlkm] (v buňkách C40:F40) představuje Dopravní
výkon, který je dle Jízdního řádu v Objednávce zajištěn jednou vlakovou jednotkou; zadává se
v rozdělení na kalendářní měsíce (v buňkách C27:F39)
• Objednaný dopravní výkon souprav dvou jednotek [tis.vlkm] (v buňkách C60:F60)
představuje Dopravní výkon, který je dle Jízdního řádu v Objednávce zajištěn soupravou dvou
vlakových jednotek; zadává se v rozdělení na kalendářní měsíce (v buňkách C47:F59)
Objednávka počtu vlakových jednotek se pro každé období platnosti Jízdního řádu zadává do
poslední tabulky na listu Objednávka (v buňkách C67:F67). Na každé období se zadává Objednaný
počet vlakových jednotek, i pro případ, že je roven Výchozímu počtu vlakových jednotek.
5.2 Objednávkový finanční model
Označení listu: Model objednávkový (MO)
Objednávkový finanční model je vypočten za účelem přizpůsobení Aktualizovaného finančního
modelu dohodnuté Objednávce, která stanovuje Objednaný dopravní výkon a Objednaný počet
vlakových jednotek. Výstupem modelu je Objednávková cena, která je platná vždy pro dané období
platnosti Jízdního řádu, pro které byla sestavena Objednávka.
Hodnota každé Cenotvorné položky v Objednávkovém finančním modelu se skládá ze tří složek:
• Složka Objednávkového finančního modelu na Výkon (viz dále);
• Složka Objednávkového finančního modelu na Vozidlo (viz dále);
• Složka Aktualizovaného finančního modelu Fixní (viz výše) – vzhledem k fixnímu charakteru je
přebírána z Aktualizovaného finančního modelu, neboť na ni nemá nastavení Objednávky vliv
Pro následující Cenotvorné položky platí zvláštní postup výpočtu Objednávkové ceny, neboť dopady
Objednávky do těchto položek byly již zohledněny v Aktualizovaném finančním modelu formou
Doplňku a nejsou tudíž řešeny smluvním přepočtem dle Objednávky jako položky ostatní. Adekvátně
tomu se u těchto položek odlišují i výpočtové vzorce v kapitole 5.2.1:
• „5 Odpisy dlouhodobého majetku“;
• „6 Pronájem a leasing vozidel“;
• „10 Úhrada za použití dopravní cesty“;
• „11 Úhrada za použití ostatní infrastruktury“.
Stránka 21 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
Další odlišností, která je patrná ve výpočtu Objednávkové ceny níže, je zacházení s variabilní složkou
cenotvorných položek vázaných na vlakový personál při řazení vlakových jednotek do souprav.
Protože variabilní náklady na zajištění vlakového personálu nerostou úměrně se zvětšováním počtu
jednotek v soupravě, zohledněna je tato skutečnost i ve výpočtu položek:
• „7.1 Mzdové náklady – Vlakový personál“;
• „8.1 Sociální a zdravotní pojištění – Vlakový personál“.
Objednávková cena [tis.Kč] je pro každé období Jízdního řádu vztažena k cenové úrovni počátku
období platnosti Jízdního řádu, pro který byly spočteny.
5.2.1 Objednávková cena
��=22 ��=22
������ = ∑ [������,��] = ∑ [������𝑉,���������� + ������𝑉,�������������� + (��𝐴��,�� ⋅ ����𝐹��������)]
��=1 ��=1
přičemž:
������𝑉,���������� = ��𝐴��,�� ⋅ ����𝑉�������� ⋅ 𝐷𝑂𝑗𝐽����𝑛𝑎+2∙𝐷𝑂𝑗𝐷𝑣�� vyjma 𝑖 = 7.1, 𝑖 = 8.1, 𝑖 = 10, 𝑖 = 11
pouze pro 𝑖 = 7.1, 𝑖 = 8.1
𝐷𝑉 𝐽����𝑛𝑎 +2∙𝐷𝑉 𝐷𝑣�� pouze pro 𝑖 = 10, 𝑖 = 11
������𝑉,���������� = ��𝐴��,�� ⋅ ����𝑉�������� ⋅ 𝐷𝑂𝑗𝐽����𝑛𝑎+𝐷𝑂𝑗𝐷𝑣��
𝐷𝑉 𝐽����𝑛𝑎 +𝐷𝑉 𝐷𝑣��
������𝑉,���������� = ��𝐴��,�� ⋅ ����𝑉��������
������𝑉,�������������� = ��𝐴��,�� ⋅ ����𝑉������������ ⋅ 𝑉𝑂𝑗 vyjma 𝑖 = 5, 𝑖 = 6
𝑉𝑉 pouze pro 𝑖 = 5, 𝑖 = 6
������𝑉,�������������� = ��𝐴��,�� ⋅ ����𝑉������������
kde:
������ Objednávková cena pro období Jízdního řádu j
������,�� Výše Cenotvorné položky i v Objednávkovém finančním modelu pro období Jízdního
řádu j
������𝑉,���������� Výše Cenotvorné položky i proměnné s Dopravním výkonem v Objednávkovém
finančním modelu pro období Jízdního řádu j
������𝑉,�������������� Výše Cenotvorné položky i proměnné s Počtem vlakových jednotek v Objednávkovém
finančním modelu pro období Jízdního řádu j
��𝐴��,�� Výše Cenotvorné položky i v Aktualizovaném finančním modelu pro období Jízdního
řádu j
����𝑉�������� Podíl Cenotvorné položky i proměnný s Dopravním výkonem
����𝑉������������ Podíl Cenotvorné položky i proměnný s Počtem vlakových jednotek
Stránka 22 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
����𝐹�������� Podíl Cenotvorné položky i nezávislý na Dopravním výkonu a Počtu vlakových
jednotek
���� 𝐽������𝑎 Výchozí dopravní výkon jednotek
���� 𝐷𝑣�� Výchozí dopravní výkon souprav dvou jednotek
������𝐽������𝑎 Objednaný dopravní výkon jednotek pro období Jízdního řádu j
������𝐷𝑣�� Objednaný dopravní výkon souprav dvou jednotek pro období Jízdního řádu j
���� Výchozí počet vlakových jednotek
������ Objednaný počet vlakových jednotek pro období Jízdního řádu j
5.2.2 Objednávková jednotková cena
������
�������� = ������
přičemž:
������ = ������𝐽������𝑎 + ������𝐷𝑣��
kde:
�������� Objednávková jednotková cena pro období Jízdního řádu j
������ Objednávková cena pro období Jízdního řádu j
������ Objednaný dopravní výkon pro období Jízdního řádu j
������𝐽������𝑎 Objednaný dopravní výkon jednotek pro období Jízdního řádu j
������𝐷𝑣�� Objednaný dopravní výkon souprav dvou jednotek pro období Jízdního řádu j
5.2.3 Objednávková jednotková cena na Výkon
��������𝑉�������� = ∑����==212[������𝑉,���������� ]
������
kde:
��������𝑉�������� Objednávková jednotková cena na Výkon pro období Jízdního řádu j
������𝑉,���������� Výše Cenotvorné položky i proměnné s Dopravním výkonem v Objednávkovém
finančním modelu pro období Jízdního řádu j
������ Objednaný dopravní výkon pro období Jízdního řádu j
Stránka 23 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
5.3 Objednávkový finanční model na Výkon
Označení listu: MO Výkon
Tento list počítá složku Objednávkového finančního modelu na Výkon pro Objednávkový finanční
model. Výše Cenotvorných položek je v něm proměnná s Dopravním výkonem; tj. reaguje na změnu
(zvýšení či snížení) Objednaného dopravního výkonu vůči Výchozímu dopravnímu výkonu, a to včetně
změn Dopravního výkonu připadajícího na vlaky vedené v jedné vlakové jednotce a vlaky vedené v
soupravě dvou jednotek.
Konkrétní postup kalkulace je definován ve vzorci výpočtu Objednávkové ceny výše.
5.4 Objednávkový finanční model na Vozidlo
Označení listu: MO Vozidlo
Tento list počítá složku Objednávkového finančního modelu na Vozidlo pro Objednávkový finanční
model. Výše Cenotvorných položek je v něm proměnná s Počtem vlakových jednotek; tj. reaguje na
změnu (zvýšení či snížení) Objednaného počtu vlakových jednotek vůči Výchozímu počtu vlakových
jednotek výkonu.
Kalkulace Cenotvorných položek v tomto listu:
• přímo přebírá hodnoty Aktualizovaného finančního model na Vozidlo pro Cenotvorné
položky „5 Odpisy dlouhodobého majetku“ a „6 Pronájem a leasing vozidel“, neboť dopady
Objednávky do těchto položek byly již zohledněny v listu Doplněk v souladu se Smlouvou; a
• přepočítává hodnoty Aktualizovaného finančního model na Vozidlo poměrem Objednaného
počtu vlakových jednotek a Výchozího počtu vlakových jednotek pro všechny ostatní
Cenotvorné položky.
Konkrétní postup kalkulace je definován ve vzorci výpočtu Objednávkové ceny výše.
6 SKUTEČNÁ KOMPENZACE
6.1 Skutečnost
Označení listu: Skutečnost
Tento list slouží k zaznamenání skutečně realizovaného Plnění proti Objednávce. Na tomto listu je
připraveno sedm tabulek pro zadání odchylek dopravního výkonu, kde se zadávají rozdíly Skutečnosti
proti Objednávce v detailu kalendářních měsíců pro následující situace:
1. Přidaný dopravní výkon [vlkm] – dopravní výkon odjetý ve Spojích nad rámec Objednávky,
dle definice v kapitole 1.5
2. Záměna jednotky za soupravu dvou jednotek [vlkm] – dopravní výkon zajištěný soupravou
dvou vlakových jednotek nad rámec Objednávky dle definice v kapitole 1.6; pokud by naopak
došlo ve Skutečnosti k vypravení jedné vlakové jednotky oproti soupravě dvou vlakových
Stránka 24 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
jednotek uvedené v Objednávce, zaznamená se do stejné tabulky dopravní výkon se
záporným znaménkem.
3. Výkon ujetý záložní soupravou ODIS 5 [vlkm] – uvede se Dopravní výkon, který byl
rozhodnutím Dopravce ve Skutečnosti zajištěn Záložní soupravou ve standardu ODIS 5.
4. Výkon ujetý záložní soupravou ODIS 6 [vlkm] – uvede se Dopravní výkon, který byl
rozhodnutím Dopravce ve Skutečnosti zajištěn Záložní soupravou ve standardu ODIS 6.
5. Neuskutečněný nezaviněný dopravní výkon [vlkm] – dopravní výkon, který je vázán na
odchylky řádného provedení Spoje definované v kapitole 1.5.
6. Neuskutečněný dopravní výkon v pandemii [vlkm] – dopravní výkon, který je vázán na
odchylky řádného provedení Spoje definované v kapitole 1.5.
7. Neuskutečněný zaviněný dopravní výkon [vlkm] – dopravní výkon, který Dopravce provedl v
rozporu s Jízdním řádem či neprovedl vůbec, dle definice v kapitole 1.5.
Do Skutečného dopravního výkonu se proti Objednanému dopravnímu výkonu přičítá Přidaný
dopravní výkon, naopak se odečítá Neuskutečněný nezaviněný dopravní výkon, Neuskutečněný
dopravní výkon v pandemii a rovněž Neuskutečněný zaviněný dopravní výkon. Výkon ujetý záložní
soupravou se pro účely vyčíslení Skutečného dopravního výkonu považuje za součást Objednávky.
6.2 Skutečná kompenzace
Označení listu: Kompenzace
Tento list slouží k vyúčtování skutečně realizovaného Plnění proti Objednávce. K vyúčtování se zde
využívají hodnoty získané z Objednávkového finančního modelu, konkrétně:
• Objednávková jednotková cena [Kč/vlkm] v buňkách C3:F3
• Objednávková jednotková cena za Výkon [Kč/vlkm] v buňkách C4:F4
• Cena za záměnu jednotky za soupravu dvou jednotek [Kč/vlkm] v buňkách C5:F5
Pro potřeby výpočtu Skutečné kompenzace v kalendářních měsících je provedeno rozdělení
Objednávkové ceny na měsíce. Vychází z Objednávkového finančního modelu. Objednávková cena je
zde rozdělena poměrem Objednaného dopravního výkonu v daném měsíci vůči Objednanému
dopravnímu výkonu za celé období Jízdního řádu.
Do následující tabulky v buňkách C26:F38 bude Objednatel zadávat Skutečné tržby náležející Dopravci
z provedeného Plnění, a to ihned po provedení jejich zúčtování v ODIS.
Finanční vyčíslení odchylek Skutečnosti proti Objednávce zde probíhá v podrobnosti pro jednotlivé
kalendářní měsíce tímto způsobem:
1. Výše nákladů za Přidaný dopravní výkon [tis.Kč] je součin Přidaného dopravního výkonu
[vlkm] v daném kalendářním měsíci a Objednávkové jednotkové ceny za Výkon [Kč/vlkm] pro
příslušné období Jízdního řádu
2. Výše nákladů za záměnu jednotky za soupravu dvou jednotek [tis.Kč] je definována pomocí
vzorce ve výpočtu Skutečné kompenzace (viz níže)
Stránka 25 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
3. Výše ušetřených nákladů za Výkon odjetý Záložní soupravou ODIS 5 je součin Výkonu
odjetého záložní soupravou ODIS 5 [vlkm] v daném kalendářním měsíci a 10 % hodnoty
Objednávkové jednotkové ceny [Kč/vlkm] pro příslušné období Jízdního řádu
4. Výše ušetřených nákladů za Výkon odjetý Záložní soupravou ODIS 6 je součin Výkonu
odjetého záložní soupravou ODIS 6 [vlkm] v daném kalendářním měsíci a 15 % hodnoty
Objednávkové jednotkové ceny [Kč/vlkm] pro příslušné období Jízdního řádu
5. Výše ušetřených nákladů za Neuskutečněný nezaviněný dopravní výkon [tis.Kč] je součin
Neuskutečněného nezaviněného dopravního výkonu [vlkm] a Objednávkové jednotkové ceny
za Výkon [Kč/vlkm] pro příslušné období Jízdního řádu
6. Výše ušetřených nákladů za Neuskutečněný dopravní výkon v pandemii [tis.Kč] je součin
Neuskutečněného dopravního výkonu v pandemii [vlkm] a Objednávkové jednotkové ceny za
Výkon [Kč/vlkm] pro příslušné období Jízdního řádu
7. Výše ušetřených nákladů za Neuskutečněný zaviněný dopravní výkon [tis.Kč] je součin
Neuskutečněného zaviněného dopravního výkonu [vlkm] a Objednávkové jednotkové ceny
[Kč/vlkm] pro příslušné období Jízdního řádu
Užití sankcí za porušení Smlouvy je nezávislé na výše uvedeném výpočtu finančních dopadů do
Skutečné kompenzace a řídí se postupy v souladu se Smlouvou.
Skutečná cena je spočtena jako součást výpočtu Skutečné kompenzace postupem uvedeným níže.
Znázorněna je v buňkách C162:F174 v jednotlivých kalendářních měsících a poté v bu%nkách
C175:F175 za celý Dopravní rok.
Skutečná kompenzace je pak rozdílem Skutečné ceny a Skutečných tržeb. V buňkách C179:F191 je
vyjádřená v jednotlivých kalendářních měsících, v buňkách C192:F192 pak souhrnně za celé období
Jízdního řádu. Mechanismus výpočtu Skutečné kompenzace probíhá každý měsíc.
6.2.1 Skutečná cena
������ = ������ + ������ ⋅ ��������𝑉�������� + ������𝐽������𝑎−𝐷𝑣�� ⋅ ��������𝐽������𝑎−𝐷𝑣�� − ������ ⋅ �������� ⋅ 0.1 − ������ ⋅ �������� ⋅ 0.15
−������ ⋅ ��������𝑉�������� − ������ ⋅ ��������𝑉�������� − ������ ⋅ ��������
přičemž:
��������𝐽������𝑎−𝐷𝑣�� ∑����==212[������𝑉,���������� ] − ������𝑉=��7��.1��,���� − ������𝑉=��8��.1��,���� − ������𝑉=��1��0��,���� − ������𝑉=��1��1��,����
������𝐽������𝑎 + 2 × ������𝐷𝑣��
=
kde:
������ Skutečná cena pro období Jízdního řádu j
������ Objednávková cena pro období Jízdního řádu j
������𝑉,����������
Výše Cenotvorné položky i proměnné s Dopravním výkonem v Objednávkovém
finančním modelu pro období Jízdního řádu j
������𝑉=��7��.1��,���� Objednávková cena položky „7.1 Mzdové náklady – Vlakový personál“
za Výkon pro období Jízdního řádu j
Stránka 26 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
������𝑉=��8��.1��,���� Objednávková cena položky „8.1 Sociální a zdravotní pojištění – Vlakový personál“
za Výkon pro období Jízdního řádu j
������𝑉=��1��0��,���� Objednávková cena položky „10 Úhrada za použití dopravní cesty“
za Výkon pro období Jízdního řádu j
������𝑉=��1��1��,���� Objednávková cena položky „11 Úhrada za použití ostatní infrastruktury“
za Výkon pro období Jízdního řádu j
�������� Objednávková jednotková cena pro období Jízdního řádu j
��������𝑉�������� Objednávková jednotková cena za Výkon pro období Jízdního řádu j
��������𝐽������𝑎−𝐷𝑣�� Cena za záměnu jednotky za soupravu dvou jednotek pro období Jízdního řádu j
������𝐽������𝑎 Objednaný dopravní výkon jednotek pro období Jízdního řádu j
������𝐷𝑣�� Objednaný dopravní výkon souprav dvou jednotek pro období Jízdního řádu j
������ Přidaný dopravní výkon v období Jízdního řádu j
������𝐽������𝑎−𝐷𝑣�� Záměna jednotky za soupravu dvou jednotek v období Jízdního řádu j
������ Výkon ujetý záložní soupravou ODIS 5 v období Jízdního řádu j
������ Výkon ujetý záložní soupravou ODIS 6 v období Jízdního řádu j
������ Neuskutečněný nezaviněný dopravní výkon v období Jízdního řádu j
������ Neuskutečněný dopravní výkon v pandemii v období Jízdního řádu j
������ Neuskutečněný zaviněný dopravní výkon v období Jízdního řádu j
6.2.2 Skutečná kompenzace
������ = ������ − ������
kde:
������ Skutečná kompenzace pro období Jízdního řádu j náležející Dopravci
������ Skutečná cena pro období Jízdního řádu j
������ Skutečné tržby pro období Jízdního řádu j
6.2.3 Skutečná jednotková kompenzace
������
�������� = ������
Stránka 27 z 28
Smlouva o veřejných službách v přepravě cestujících
k zajištění dopravní obslužnosti kraje veřejnou drážní osobní dopravou
přičemž:
������ = ������ + ������ − ������ − ������ − ������
kde:
�������� Skutečná jednotková kompenzace pro období Jízdního řádu j
������ Skutečná kompenzace pro období Jízdního řádu j náležející Dopravci
������ Skutečný dopravní výkon pro období Jízdního řádu j
������ Objednaný dopravní výkon pro období Jízdního řádu j
������ Přidaný dopravní výkon v období Jízdního řádu j
������ Neuskutečněný nezaviněný dopravní výkon v období Jízdního řádu j
������ Neuskutečněný dopravní výkon v pandemii v období Jízdního řádu j
������ Neuskutečněný zaviněný dopravní výkon v období Jízdního řádu j
6.3 Přepočet Skutečné kompenzace na kalendářní rok
Označení listu: Kalendářní rok
Na tomto listu jsou přepočteny odchylky Skutečnosti proti Objednávce a z nich vyplývající Skutečná
kompenzace z období platnosti Jízdního řádu na období kalendářního roku. Tento přepočet je
prováděn pro účely statistického vykazování Objednatele, které vyžaduje příslušnost ke kalendářnímu
roku, a nikoliv proměnlivému období Jízdního řádu.
Stránka 28 z 28
í l ílí | í l lí lí l í l líl íltlí Ilílilí íl lílí l t &%; zav/L ašl/
KUMSPGQYGSGY
Příkazní smlouva „*
na výkon činností, které vedou k efektivní organizaci
Integrovaného dopravního systému Moravskoslezského kraje
ODIS v rámci poskytování veřejných služeb v přepravě
cestujících zajišťovaných veřejnou drážní osobní dopravou
1. Moravskoslezský kraj :
Smluvní strany
se sídlem: InšBRšíjRarň &&QMQstrava lng, Radkem Pgúgiayyhůu
náměstkem hejtmana kraje
zastoupen; náměstkem hejtmana kraje
„
IC :v 70890692
DIC: QZ70890692
bankovní spojení: Ceská spořitelna, a.s.
číslo účtu: 27-1650676349/0800
něná jednat ve věcech výkonu činností:
2. Koordinátor ODIS s.r.o.
se sídlem: 28. října 3388/111, 702 00 Ostrava
zastoupena: jednateli Ing. Alešem Stejskalem a Ing. Martinem Dutkem
ICQ: 64613895
DIC: (3264613895
bankovní spojení: Ceská spořitelna, a.s.
číslo účtu: 1651582379/0800
zapsána v obchodním rejstříku vedeném Krajským soudem v Ostravě, sp. zn. C 8979
(dále jen „příkazník“)
II.
Základní ustanovení
. Tato smlouva je uzavřena dle ust. 13“ 2430 a násl. zákona č. 89/2012 Sb., občanský zákoník,
ve znění pozdějších předpisů (dále jen „občanský zákoník“), práva a povinností stran touto
smlouvou neupravená se řídí příslušnými ustanoveními občanského zákoníku.
. Smluvní strany prohlašují, že údaje uvedené v čl. I této smlouvy jsou v souladu s právní
skutečností vdobě uzavření smlouvy. Smluvní strany se zavazují, že změny dotčených
údajů oznámí bez prodlení písemně druhé smluvní straně. Při změně identifikačních údajů
smluvních stran včetně změny účtu není nutné uzavírat ke smlouvě dodatek.
. Smluvní strany prohlašují, že osoby podepisující tuto smlouvu jsou ktomuto jednání
oprávněny.
. Příkazník prohlašuje, že je odborně způsobilý kzajištění plnění svého závazku z této
smlouvy.
. Účelem smlouvy je zajištění výkonu činností, které vedou kefektivní organizaci
Integrovaného dopravního systému Moravskoslezského kraje ODIS v rámci poskytování
veřejných služeb v přepravě cestujících zajišťovaných veřejnou drážní osobní dopravou.
III.
Předmět smlouvy
Příkazník se zavazuje pro příkazce jeho jménem vykonávat činnost při organizaci
Integrovaného dopravního systému Moravskoslezského kraje ODIS v rámci poskytování
veřejných služeb v přepravě cestujících zajišťovaných veřejnou drážní osobní dopravou
(dále jen „organizace IDS“).
Příkazník je povinen pro příkazce v rámci výkonu organizace IDS zajistit zejména níže
uvedené činnosti (dále jen „činnosti“):
A/ Správa tarifů jízdného a tržeb z jízdného
tvorba, aktualizace a kontrola plnění dokumentu „Tarif ODIS“,
tvorba, aktualizace a kontrola plnění dokumentu „Smluvní přepravní podmínky
ODIS“,
tvorba podoby, vzhledu, obsahu a zabezpečení jízdního dokladu,
stanování způsobu přerozdělení vybraného jízdného u jednotlivých dopravců
poskytující službu v ODIS a rozúčtování tržeb u jednotlivých dopravců
poskytujících službu v ODIS,
provádění finančních vyrovnání za transakční údaje ze zařízení odbavovacích
a předprodejních systémů,
provádění přepravní kontroly zaměřené na dodržování přepravné-tarifních
podmínek na linkách ze strany pracovníků dopravce, odbavovacího zařízení
dopravce,
provádění kontroly řádného odbavení cestujících, a to pouze ve vztahu
ke smlouvám o veřejných službách v přepravě cestujících uzavřených v tzv. brutto
režimu,
vymáhání nedoplatků jízdného a přirážek kjízdnému spolu s příslušenstvím, a to
pouze ve vztahu ke smlouvám o veřejných službách vpřepravě cestujících
uzavřených vtzv. brutto režimu.
prodej jízdních dokladů v Dopravních infocentrech,
pověření k umožnění prodeje dlouhodobých časových jízdenek,
zpracovávání statistik a výkazů o tržbách a přepravených cestujících,
provádění školící činnosti zaměstnanců dopravců zaměřené na problematiku
Tarifu ODIS, poskytování metodické podpory dopravcům.
BI Poskytování informací a propagace ODIS
poskytování veškerých informací o ODIS na pracovištích Dopravních infocenter,
připravování a vydávání informačních a propagačních materiálů,
připravování, vydávání a dodávání jízdních řádů ODIS a dalších propagačních
materiálů dle potřeb Moravskoslezského kraje dopravcům,
stanovování, aktualizace a kontrola informačních materiálů do klaprámů a vitrín,
propagace veřejné dopravy ve školách a na zvláštních akcích z pohledu
ekonomického i z pohledu dopadu na životní prostředí.
aplikačního C/ Správa karetního a systému
zabezpečené dodávání prvků komunikace mezi kartami a zařízením tzv. SAM
modulů dopravcům,
správa kryptograňckých klíčů k bezkontaktním čipovým kartám,
obsluha a rozvoj SW Centrální správy karetního systému pro zajištění funkčnosti
jednotného odbavovacího systému,
provozování e-shopu pro objednávku bezkontaktních čipových karet, dále
ODIS pro prodej jízdného na bezkontaktní čipové karty a pro nahrání kreditu
na elektronickou peněženku bezkontaktních čipových karet a jeho aktualizace,
správa karet ODISek,
správa, aktualizace a rozvoj aplikace ODISapka,
stanovování designu bezkontaktní čipové karty ODISka,
tvorba, aktualizace a kontrola plnění dokumentu „Struktura BČK Moravskoslezské
km)/“,
tvorba, aktualizace a kontrola plnění dokumentu „Procesy MSK“,
tvorba, aktualizace a kontrola plnění dokumentu „Datová věta pro MSK“,
tvorba, aktualizace a kontrola plnění dokumentu „Ceník produktů“.
D/ Správa a kontrola provozu
ODIS sledování a vyhodnocování frekvence cestujících v systému a navrhování
ODIS opatření k zvýšení efektivity ve spolupráci s městy a obcemi, optimalizování
vedení a návaznosti linek v ODIS,
zpracovávání připomínek a podnětů od cestujících a místních samospráv,
návrh a aktualizace jízdních řádů k termínům pravidelných změn,
příprava provozních pomůcek kjízdním řádům,
provoz a rozvoj dispečinku ODIS,
správa datových kanálů dispečinku ODIS,
zabezpečení funkcionality SW Centrálního dispečinku a jeho rozvoj,
tvorba, vydávání, aktualizace a kontrola plnění dokumentu „Technická specifikace
ODIS“. vzájemné komunikace mezi vozidlem a dispečerským pracovištěm
ověřování počtu uskutečněných vlkm za jednotlivý měsíc v rámci předloženého
výkazu výkonů dopravcem a potvrzování uskutečněných výkonů dopravci,
evidence oběhů vozidel jednotlivých dopravců poskytujících službu v systému
ODIS,
tvorba, aktualizace a kontrola plnění dokumentu „Čekací doby“,
připomínkování příslušných opatření pro výluku v rámci dokumentu „Rozkaz
o výluce“,
zpracovávání výlukových pokynů.
ODIS 5! Činnosti vykonávané ve spojitosti s Technickými a provozními standardy
schvalování připravenosti dopravce na režim odbavování ve vozidlech a na režim
komunikace vozidla s dispečinkem formou ověření, zabezpečení a potvrzení
průběhu „testovacího provozu“ před zahájením provozu vybraným dopravcem,
vydávání prohlášení o shodě pro vozidla a jejich vybavení před zahájením
provozu, stanovení formy prohlášení o shodě,
evidence vozidel dle evidenčního čísla vozidla, vydávání prohlášení o shodě se
standardem příslušné kategorie vozidel v ODIS a vydávaní výjimek z plnění
standardů příslušné kategorie vozidel v ODIS,
stanovování, aktualizace a kontrola standardů vybavení vozidel provozovaných
v ODIS, vč. stanovení základních technických parametrů vozidel v ODIS,
stanovování, aktualizace a kontrola doplňkových standardů vybavení vozidel,
stanovování, aktualizace a kontrola jednotného vzhledu a umístění piktogramů
uvnitř i vně vozidel,
stanovování, aktualizace a kontrola vzhledu a obsah textu čelního, bočního
a vnitřního elektronického informačního panelu,
stanovování, aktualizace a kontrola informačních materiálů a informačních ploch
ve vozidlech,
stanovování, aktualizace a kontrola kvalitativních parametrů spojených
s provozem vozidla —klimatická pohoda, čistota a vzhled vozidel,
kontrola vzhledu jízdních řádů a informačních materiálů na informačních tabulích
—elektronických, stacionárních (vývěsných),
stanovování, aktualizace a kontrola standardu služeb poskytovaných ve stanicích
a na zastávkách —pokladní přepážky, čekárny, aj.,
stanovení, aktualizace a kontrola standardu tištěných jízdních dokladů,
stanovování, aktualizace a kontrola standardu odbavení cestujících, prodeje
jízdních dokladů a dopravních infocenter,
stanovování, aktualizace a kontrola standardu úklidu vozidel,
stanovování, aktualizace a kontrola standardu údržby vozidel,
stanovování, aktualizace a kontrola standardu organizace výluk,
stanovování, aktualizace a kontrola standardu opatření pro snížení dopadu
mimořádnosti,
stanovování, aktualizace a kontrola standardu nasazení záložních vozidel,
stanovování, aktualizace a kontrola standardu operativního řízení provozu,
F/ Vyhotovení podkladů z kontrolní činnosti
ověřování a potvrzování správnosti výsledků prováděných kontrol vyplývajících
z provozu a poskytování veřejných služeb u dopravců,
vyhotovování podkladů pro výpočet a pro následné naplnění sankčních ujednání
ze strany příkazce vyplývajících ze Smluv o poskytnutí veřejných služeb
v přepravě cestujících veřejnou drážní osobní dopravou k zajištění dopravní
obslužnosti Moravskoslezského kraje.
G/ Dopravní plánování
- připravování koncepčních dokumentů a podkladů k nim,
- spolupracování na přípravě infrastrukturních projektů se Správou železnic,
- spolupracování s ostatními objednateli veřejné dopravy (MDČR, KOVED, KIDSOK),
- navrhování, aktualizování a projednávání provozních konceptů regionální
železniční dopravy.
Příkazník se zavazuje po celou dobu trvání této smlouvy poskytovat činnosti vyplývající
ze Smluv o poskytování veřejných služeb v přepravě cestujících veřejnou drážní osobní
dopravou k zajištění dopravní obslužnosti Moravskoslezského kraje uzavřených mezi
Moravskoslezským krajem a jednotlivými dopravci.
Příkazce sezavazuje vykonávat činnosti přispívající k rozvoji veřejné drážníosobní dopravy
v Moravskoslezském kraji.
Smluvní strany prohlašují, že předmět smlouvy není plněním nemožným a že smlouvu
uzavřely po pečlivém zvážení všech možných důsledků.
IV.
Doba plnění
Příkazník zahájí výkon činností spojených s organizací IDS ihned po nabytí účinnosti této
smlouvy.
Tato smlouva se uzavírá na dobu neurčitou.
V.
Odměna
. Odměna za činnosti je stanovena dohodou smluvních stran a je hrazena poplatkem
a způsobem stanoveným dle Smluv o poskytování veřejných služeb v přepravě cestujících
veřejnou drážní osobní dopravou kzajištění dopravní obslužnosti Moravskoslezského kraje
uzavřených mezi Moravskoslezským krajem a jednotlivými dopravci a dle smluv
o spolupráci dopravce a příkazníka.
. Vodměně jsou zahrnuty veškeré náklady příkazníka nutně nebo účelně vynaložené
při plněníjeho závazku z této smlouvy včetně správních poplatků.
. Odměna je dohodnuta jako nejvýše přípustná a platí po celou dobu platnosti smlouvy.
VI.
Práva a povinnosti příkazce
Příkazce se zavazuje srozumitelnou formou předávat příkazníkovi své pokyny, a to
především (nikoli však výlučně) prostřednictvím ústní nebo písemné podoby, a k tomuto
stanovit adekvátní lhůtu na jejich zpracování.
. Příkazce může prodloužit na základě písemné či ústní žádosti příkazníka lhůtu uvedenou
v čl. VI, bod 1, této smlouvy.
Příkazce je povinen vystavit včas příkazníkovi pro vyřízení záležitostí, které vyžadují
uskutečnění právních jednáníjménem příkazce, písemně plnou moc.
VII.
Práva a povinnosti příkazníka
Příkazník je při plnění činností dle článku III. bod 2 povinen:
a) zpracovávat příkazcem zadané činnosti apředávatje příkazci vestanovené lhůtě v ústní
či písemné podobě;
b) při výkonu činností upozornit příkazce na zřejmou nesprávnost jeho pokynů, které by
mohly mít za následek vznik škody, a to ihned, když se takovou skutečnost dozvěděl.
V případě, že příkazce i přes upozornění příkazníka na splnění pokynů trvá, příkazník
neodpovídá za škodu takto vzniklou;
c) bez zbytečného odkladu předat příkazci jakékoliv věci získané pro něho při své činnosti;
d) postupovat při výkonu činností s odbornou péčí;
e) řídit se při výkonu činností pokyny příkazce a jednat v jeho zájmu;
f) bez odkladů oznámit příkazci veškeré skutečnosti, které by mohly vést ke změně
pokynů příkazce;
g) poskytovat příkazci veškeré informace, doklady apod., písemnou formou;
h) dbát při provádění činností dle této smlouvy na ochranu životního prostředía dodržovat
platné technické, bezpečnostní, zdravotní, hygienické ajiné předpisy, včetně předpisů
týkajících se ochrany životního prostředí;
Příkazník může požádat příkazce o prodloužení lhůty na zpracování jednotlivé činnosti
pouze s řádným odůvodněním.
Příkazník se zavazuje, že jakékoliv informace, které se dozvěděl v souvislosti s plněním
předmětu smlouvy nebo které jsou obsahem předmětu smlouvy, neposkytne třetím
osobám, s výjimkou poskytnutí informací týkajících se subjektů, které ktakovému
poskytnutí daly souhlas, včetně příkazce.
Příkazník nesmí bez souhlasu příkazce postoupit svá práva a povinnosti plynoucí
ze smlouvy třetí osobě.
Příkazník se může odchýlit od pokynů příkazce, jen je-Ii to nezbytné v zájmu příkazce,
a pokud nemůže včas obdržet jeho souhlas. Vžádném případě se však příkazník nesmí
od pokynů odchýlit, jestliže je to zakázáno smlouvou nebo příkazcem.
VIII.
Sankční ujednání
Příkazce je oprávněn požadovat po příkazníkovi smluvní pokuty ve výši 1.000, -- Kč denně
po dobu trvání prodlení s plněním kterékoliv z povinností příkazce specifikovaných v čl. VII
této smlouvy.
IX.
Zánik smlouvy
Příkazce je oprávněn vypovědět tuto smlouvu bez udání důvodu. Výpovědní lhůta je 6
měsíců a začíná od prvního dne měsíce následujícího po měsíci, v němž byla výpověď
doručena příkazníkovi.
Příkazce je oprávněn vypovědět tuto smlouvu bez výpovědní doby, a to zejména
v případě:
a) bylo-Ii příslušným soudem rozhodnuto o tom, že příkazník je v úpadku ve smyslu
zákona č. 182/2006 Sb., o úpadku a způsobech jeho řešení (insolvenční zákon),
ve znění pozdějších předpisů (a to bez ohledu na právní moc tohoto rozhodnutí);
b) podá-li příkazník sám na sebe insolvenční návrh.
. Výpovědítéto smlouvy ani odvoláním příkazu nenídotčeno právo oprávněné smluvnístrany
na zaplacení smluvní pokuty ani na náhradu škody vzniklé porušením smlouvy.
X.
Závěrečná ujednání
. Změnit nebo doplnit tuto smlouvu mohou smluvní strany pouze formou písemných
dodatků, které budou vzestupně číslovány, výslovně prohlášeny za dodatek této smlouvy
a podepsány oprávněnými zástupci smluvních stran.
. Tato smlouva nabývá platnosti dnem jejího podpisu oběma smluvními stranami a účinnosti
dnem jejího uveřejnění vregistru smluv podle zákona č. 340/2015 Sb., ozvláštních
podmínkách účinnosti některých smluv, uveřejňování těchto smluv a o registru smluv
(zákon o registru smluv), ve znění pozdějších předpisů. Smluvní strany se dohodly,
že uveřejnění smlouvy zajistí příkazce.
Smlouva je vyhotovena ve čtyřech stejnopisech s platností originálu, přičemž příkazce
obdrží tři a příkazník jedno vyhotovení.
Pro účely této smlouvy se pod pojmem „bez zbytečného odkladu“ dle 5 2002 občanského
zákoníku rozumí „nejpozději do 14-ti dnů“.
. Smluvní strany shodně prohlašují, že si tuto smlouvu před jejím podepsáním přečetly,
žeje uzavřena po vzájemném projednání podle jejich pravé a svobodné vůle určitě, vážně
a srozumitelně, nikoliv v tísni nebo za nápadně nevýhodných podmínek, a že se dohodly
o celém jejím obsahu, což stvrzují svými podpisy.
Příkazník bere na vědomí a výslovně souhlasí stím, že smlouva včetně příloh
a případných dodatků bude zveřejněna na oficiálních webových stránkách
Moravskoslezského kraje. Je-li příkazník fyzickou osobou, bude smlouva zveřejněna
po anonymizaci provedené v souladu se zákonem č. 101/2000 Sb., o ochraně osobních
údajů a o změně některých zákonů, ve znění pozdějších předpisů.
Doložka platnosti právního jednání dle 5 23 zákona č. 129/2000 Sb., o krajích (krajské
zřízení), ve znění pozdějších předpisů:
K uzavření této smlouvy má příkazce souhlas rady kraje udělený usnesením
Č. 19/1104 ze dne 31. 5. 2021.
V Ostravě dne: 08.11.2021 V Ostravě dne: 10. 40. ZDŠM
Ing. Radek Podstawka za příkazníka
na základě pověření za příkazníka
hejtmana kraje
Příloha č. 7
Technické a provozní standardy
ODIS
Ostrava, 2021
OBSAH
ÚVOD 1
1. Terminologie............................................................................................................................................ 1
I. STANDARD VOZIDEL ODIS......................................................................................................... 2
1. Terminologie............................................................................................................................................ 2
2. Standardy vybavení vozidel provozovaných v ODIS .......................................................................... 4
2.1 Elektronické informační panely nebo tabule .....................................................................................5
2.2 Vnitřní elektronický vizuální informační systém................................................................................6
2.3 Akustický elektronický informační systém .........................................................................................7
2.4 Dveře vozidla, místa pro kočárky a osoby s omezenou schopností pohybu ................................7
2.5 Odbavovací a prodejní zařízení ...........................................................................................................8
2.5.1 Odbavovací terminály .............................................................................................................. 8
2.5.2 Odbavovací a prodejní zařízení vlakové čety...................................................................... 12
2.6 Signalizační zařízení uvnitř vozidla ...................................................................................................15
2.7 Komunikace s dispečinky ...................................................................................................................15
2.8 Informační vitríny................................................................................................................................16
2.9 Informační piktogramy.......................................................................................................................16
2.10 Informační materiály ..........................................................................................................................16
2.11 Klimatická pohoda vozidel .................................................................................................................17
2.12 Čistota a vzhled vozidel......................................................................................................................18
2.13 Uspořádání interiéru vozidla ..............................................................................................................18
2.14 Wi-Fi......................................................................................................................................................19
3. Prohlášení o shodě ............................................................................................................................... 19
4. Evidence vozidel provozovaných v ODIS........................................................................................... 19
II. STANDARD SLUŽEB VE STANICÍCH A NA ZASTÁVKÁCH .................................................. 20
1. Pokladní přepážky ................................................................................................................................. 20
2. Čekárny .................................................................................................................................................. 20
3. WC .......................................................................................................................................................... 21
4. Úschovna zavazadel ............................................................................................................................. 22
5. Audiovizuální systém ve stanicích a zastávkách............................................................................... 22
6. Asistence při přepravě, nástup imobilních cestujících ..................................................................... 22
7. Služby na zastávkách a v neobsazených stanicích........................................................................... 23
III. STANDARD TIŠTĚNÝCH JÍZDNÍCH DOKLADŮ..................................................................... 25
1. Obsah jízdních dokladů ........................................................................................................................ 25
2. Ochrana jízdních dokladů .................................................................................................................... 25
IV. POVINNOSTI PRACOVNÍKŮ DOPRAVCE ............................................................................... 26
1. Povinnosti pracovníků dopravce ......................................................................................................... 26
Školení zaměstnanců dopravce......................................................................................................................... 26
Informační povinnosti dopravců ....................................................................................................................... 26
V. STANDARD ODBAVENÍ CESTUJÍCÍCH, PRODEJE JÍZDNÍCH DOKLADŮ A
DOPRAVNÍCH INFOCENTER .................................................................................................................. 28
1. Obsah standardu................................................................................................................................... 28
2. Odbavení cestujících............................................................................................................................. 28
2.1 Definice................................................................................................................................................. 28
3. ODISka ................................................................................................................................................... 28
4. Způsoby prodeje jízdních dokladů ...................................................................................................... 29
5. Prodej v železničních stanicích a zastávkách .................................................................................... 29
6. Prodej u vlakové čety (dále jen obsluha) .......................................................................................... 31
7. Prodej jízdenek na samoobslužných validátorech ............................................................................ 32
8. Prodej po internetu............................................................................................................................... 32
9. Prodej jízdenek mobilní aplikace ODISapka...................................................................................... 32
10. Prodej dlouhodobých časových jízdenek ........................................................................................... 32
10.1 Definice dlouhodobé časové jízdenky ..............................................................................................32
10.3 Prodej dlouhodobé časové jízdenky k on-line nosičům .................................................................33
VI. KONTROLNÍ ČINNOST ............................................................................................................... 34
VII. STANDARD ÚKLIDU VOZIDEL.................................................................................................. 35
1. Úklid vnějších povrchů vozidla ............................................................................................................ 35
1.1 Pravidelný úklid ...................................................................................................................................35
1.2 Hloubkový úklid vnějších povrchů ....................................................................................................35
2. Úklid vnitřních prostor vozidla............................................................................................................. 36
2.1 Operativní úklid ...................................................................................................................................36
2.2 Pravidelný denní úklid ........................................................................................................................36
2.3 Pravidelný týdenní úklid .....................................................................................................................36
2.4 Hloubkový úklid vnitřních prostor.....................................................................................................37
3. Evidence a kontrola úklidu vozidel ..................................................................................................... 37
3.1 Evidence úklidu vozidel ......................................................................................................................37
3.2 Kontrola úklidu vozidel .......................................................................................................................38
VIII. STANDARD ÚDRŽBY VOZIDEL ................................................................................................. 39
IX. STANDARD ORGANIZACE VÝLUK ........................................................................................... 40
X. STANDARD OPATŘENÍ PRO SNÍŽENÍ DOPADU MIMOŘÁDNOSTÍ ................................. 42
XI. STANDARD NASAZENÍ ZÁLOŽNÍCH VOZIDEL ..................................................................... 43
1. Záložní vozidlo ....................................................................................................................................... 43
XII. STANDARD OPERATIVNÍHO ŘÍZENÍ PROVOZU (PŘÍPOJE VE STANICÍCH) ............... 44
1. Dispečerský aparát Dopravce a KODIS ............................................................................................. 44
1.1 Komunikace mezi dispečinky.............................................................................................................44
1.2 Oprávnění dispečinku KODIS ............................................................................................................44
2. Přípoje ve stanicích............................................................................................................................... 44
2.1 Příprava podkladů pro operativní řízení ...........................................................................................45
2.2 Operativní řízení v praxi .....................................................................................................................45
2.3 Vyhodnocení provozu a kontrola ......................................................................................................46
SEZNAM ZKRATEK .................................................................................................................................... 47
SEZNAM PŘÍLOH....................................................................................................................................... 48
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
ÚVOD
Technické a provozní standardy Integrovaného dopravního systému
Moravskoslezského kraje ODIS (dále jen ODIS) specifikují náležitosti, které je nutné
ze strany dopravce naplnit k zajištění přepravního výkonu na území ODIS.
1. Terminologie
ODIS Integrovaný dopravní systém Moravskoslezského kraje ODIS.
KODIS Koordinátorem ODIS je na základě rozhodnutí společníků
společnost Koordinátor ODIS s.r.o. se sídlem 28. října
3388/111, 702 00 Ostrava-Moravská Ostrava, společnost
je pověřena sledováním a vyhodnocováním dodržování a plnění
Technických a provozních standardů ODIS. Společnost KODIS
provádí činnosti uvedené v dokumentu na základě pověření.
Dopravce ODIS Právnická nebo fyzická osoba, která provozuje veřejnou silniční
nebo drážní dopravu v souladu se zákonem č. 111/1994 Sb.
o silniční dopravě ve znění pozdějších předpisů, resp. zákonem
č. 266/1994 Sb. o drahách ve znění pozdějších předpisů
a provozuje autobusové, tramvajové, trolejbusové nebo vlakové
spoje na aktuálně provozovaných linkách ODIS.
Vozidlo Vozidlem pro účely těchto standardů se rozumí jednotlivé vozy
(jednotlivé vozy jednotky, samostatné vozy nebo vozy, z nichž
je složena souprava) provozované na aktuálně provozovaných
linkách ODIS.
1
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
I. STANDARD VOZIDEL ODIS
Standardy vybavení vozidel stanovují povinné vybavení vozidel provozovaných
na spojích zařazených do jednotlivých kategorií. Jejich označení tvoří pro účely
tohoto dokumentu text „ODIS“ a číslovka.
Každý ze standardů vybavení vozidel může být rozšířen o další povinné součásti,
uspořádání nebo vzhled vozidla stanovené doplňkovými standardy vybavení vozidel.
Tyto standardy jsou označeny písmeny a přidávají se k označení standardů vybavení
vozidel (např. standard ODIS 2NK)
1. Terminologie
Blacklist Soubor zablokovaných karet nebo SAM modulů.
Capping Použití platby bankovní kartou (dále jen BK), kdy skutečné
zúčtování probíhá na konci dopravního dne.
Centrální správa karetního systému Moravskoslezského kraje (dále jen CS)
Software, který zajišťuje centrální zpracování výstupních
dat ze zařízení dopravců, centrální zpracování blacklistu,
whitelistu, greenlistu a jejich distribuci do zařízení dopravců,
dále zajišťuje správu účtů karet cestujících a finanční vyrovnání
mezi dopravci.
Denylist Seznam zakázaných BK pro použití v dopravě.
GPRS Princip přenosu dat a připojení k internetu (případně jiným
sítím) pro uživatele GSM.
Greenlist Soubor zakoupených kuponů a nabitých elektronických
peněženek přes e-shop.
Klaprám Zařízení sloužící k jednoduchému a bezpečnému uchycení
informačních materiálů dohodnutých formátů.
Nadzóna Označení území se shodnými tarifními vlastnostmi zahrnujícího
více tarifních zón.
Odbavovací a prodejní zařízení
Zařízení sloužící k odbavení cestujících a k prodeji jízdních
dokladů.
ODISapka Mobilní aplikace systému ODIS, umožňující vyhledání spojení,
nákup jednotlivého jízdného a zároveň může sloužit i jako
identifikátor dlouhodobé časové jízdenky (= Virtuální ODISka)
ODISka Mezi dopravci vzájemně uznávaná bezkontaktní čipová karta
sloužící jako nosič dlouhodobých časových jízdenek uložených
v její paměti a jako nosič elektronické peněženky.
Retail Standardní platba BK na obchodním terminálu.
SAM Secure Access Module, bezpečnostní modul zajišťující
komunikaci mezi odbavovacím a prodejním zařízením
a ODISkou nebo jinou bezkontaktní čipovou kartou.
2
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
Taplist Seznam BK, které byly přiloženy k odbavovacímu zařízení.
Tokenizace Zašifrování čísla BK.
Virtuální ODISka Identifikátor dlouhodobé časové jízdenky ve formě 2D kódu,
případně komunikující prostřednictvím technologie NFC,
jedinečně svázaný s mobilním telefonem a mobilní aplikací
ODISapka
Vitrína Zařízení sloužící k jednoduchému a bezpečnému uchycení
informačních materiálů ODIS dohodnutých formátů.
Whitelist Soubor kupónů na karty ODISka nebo seznam povolených karet
ODISka nebo seznam SAM modulů nebo seznam údajů
k Virtuální ODISce (kupóny, profily, osobní údaje, fotografie)
nebo seznam údajů k BK (taplisty, kupóny, profily, osobní
údaje, fotografie)
Yellowlist Seznam jízdenek zakoupených přes samoobslužný terminál ve
vlacích.
3
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
2. Standardy vybavení vozidel provozovaných v ODIS
Vozidla zabezpečující dopravu na linkách ODIS musí být homologována dle platných
předpisů ES a ČR.
Vozidla ODIS jsou z hlediska požadavků na jejich vybavení rozdělena do kategorií
standardů:
• ODIS 4 pro vozidla železniční nasazovaná v pravidelném provozu.
• ODIS 5 pro vozidla železniční nasazovaná jako vozidla záložní: Záloha 1 –
plnohodnotná.
• ODIS 6 pro vozidla železniční nasazovaná jako vozidla záložní: Záloha 2 –
mimořádná.
Základní technické parametry vozidel jsou stanoveny v příloze č. 1 tohoto
dokumentu.
Každé vozidlo včetně výbavy provozované na některé z linek ODIS musí dopravce
zaevidovat u společnosti KODIS dle bodu I.3, přičemž společnost KODIS následně
vydá prohlášení o shodě dle tohoto dokumentu.
Vozidlům uvedeným do provozu před započetím provozování dopravy na základě
Smlouvy o veřejných službách v přepravě cestujících dle výběrových řízení
na železniční dopravce nebo přímého zadání železničního dopravce v dané oblasti
může společnost KODIS vydat výjimku z plnění standardů ODIS.
Vozidlům ve zkušebním provozu určeným k vyzkoušení jejich technických a
provozních vlastností, která nebudou v ODIS provozována déle než dva měsíce, může
společnost KODIS vydat výjimku z plnění standardů ODIS.
Výjimka z plnění standardů ODIS nesmí znemožnit řádné odbavení cestujících ve
vozidle.
V článku 2 jsou dále rozpracovány součásti standardního vybavení vozidla:
• čelní elektronický informační panel nebo tabule,
• boční elektronický informační panel nebo tabule,
• vnitřní elektronický vizuální informační systém,
• akustický elektronický informační systém,
• dveře vozidla,
• odbavovací a prodejní zařízení,
• signalizační zařízení uvnitř vozidla,
• komunikace s dispečinky,
• informační vitríny,
• informační piktogramy,
• informační materiály,
• klimatická pohoda ve vozidle,
4
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
• čistota a vzhled vozidel,
• uspořádání sedadel.
2.1 Elektronické informační panely nebo tabule
Všechny soupravy standardu ODIS 4, ODIS 5 a ODIS 6 musí být vybaveny na
svých čelech funkčním elektronickým informačním panelem umístěným v prostoru
čelního okna, případně zabudovaným v karoserii vozidla na jeho čele.
Přesný vzhled a obsah textu čelního elektronického informačního panelu je stanoven
společností KODIS. U vozidel ODIS 4, ODIS 5 a ODIS 6 je standardem uvedení
linkového označení a plného textu cílové stanice či zastávky. Linkové označení musí
být vyvedeno v maximální možné velikosti tak, aby vyplňovalo celou výšku
elektronického panelu.
Dopravce musí upravit obsah čelního panelu na základě požadavků KODIS do 30 dní
od zaslání tohoto požadavku.
Na vyžádání společnosti KODIS musí dopravce na čelním panelu zobrazit případný
doplňkový text zpřesňující trasu spoje (např. „Přes: stanice/zastávka“), bližší určení
charakteru spoje či pokračování jízdy vozidla po jiné lince.
Všechna vozidla standardu ODIS 4, ODIS 5 a ODIS 6 musí být vybavena na boku
vozidla funkčními elektronickými informačními panely umístěnými v horní části
bočních oken přes celou jeho šíři (v případě dvoupodlažní jednotky v horní části oken
spodního patra), či zabudovanými v karoserii vozidla. V bočnici jednoho vozu musí
být umístěn minimálně 1 boční elektronický panel výše uvedeného standardu.
Přesný vzhled a obsah textu bočního elektronického informačního panelu je stanoven
společností KODIS. U vozidel ODIS 4, ODIS 5 a ODIS 6 je standardem uvedení
linkového označení, plného textu cílové stanice či zastávky v horním řádku a
vybraných důležitých stanic či zastávek v trase linky ve spodním řádku. Vybrané
důležité stanice či zastávky v trase linky jsou doplněny o text „Přes:“, a to buď
samostatně jako samostatná fáze při postupném zobrazování jednotlivých vybraných
důležitých stanic či zastávek v trase linky před první z nich, nebo jako součást
běžícího textu s vybranými důležitými stanicemi či zastávkami v trase linky. Již
projeté stanice a zastávky v trase vlaku se na spodním řádku nezobrazují. Linkové
označení musí být vyvedeno v maximální možné velikosti tak, aby vyplňovalo celou
výšku elektronického panelu. V případě požadavků KODIS musí být na panelu
zobrazován i požadovaný text, např. název vlaku, případně konané akce.
Informace na elektronických informačních panelech nebo tabulích musí být vždy
aktuální a musí odpovídat platné legislativě.
Dopravce musí upravit obsah bočního panelu na základě požadavků KODIS do 30 dní
od zaslání tohoto požadavku.
Informace na elektronických informačních panelech musí být zobrazovány v barvě
žlutozelené, žluté, oranžové či bílé. V případě panelů čistě v provedení LED se jedná
o LED diody výše uvedených barev.
5
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
2.2 Vnitřní elektronický vizuální informační systém
Každé vozidlo standardu ODIS 4, ODIS 5 a ODIS 6 musí být vybaveno funkčními
vnitřními elektronickými vizuálními informačními panely. Jedná se o informační panely
tvořené LCD monitory poměru stran 32:9 (pokud to konstrukce a předpisy pro
železniční kolejová vozidla umožňují, v jiném případě je možné využít LCD monitor
s poměrem stran 16:9, přičemž tento monitor musí zobrazovat veškeré informace
dané přílohou č. 2 tohoto dokumentu, informace nejsou zobrazovány zároveň),
na němž se zobrazují informace o označení linky, cílové stanici či zastávce linky
a důležitých nácestných stanicích a zastávkách na trase linky. Dále jsou zobrazovány
informace o následující stanici či zastávce. V rámci vnitřního elektronického
informačního systému jsou zobrazovány aktuální informace o tarifní zóně a času.
Informace o tarifní zóně musí být shodné s údaji uvedenými v jízdním řádu
příslušného vlaku.
V případě, že vlak obsluhuje zastávku „na znamení“, je tato informace indikována
taktéž na vnitřním informačním panelu. Stiskne-li před příjezdem do této zastávky
cestující tlačítko signalizace, je informace o zastavení na zastávce „na znamení“
indikována taktéž na vnitřním informačním panelu textem „ZASTAVÍME“
zobrazovaným u příslušné zastávky.
Informační panely jsou umístěny tak, aby byly viditelné z každého místa kteréhokoliv
oddílu vozidla.
Technický popis zobrazování dat na vnitřních informačních panelech ve vozidlech
Trvale zobrazované údaje čerpané z palubního systému vozidla:
• číslo linky ve formátu ODIS,
• cílová stanice či zastávka spoje,
• čas příjezdu do cílové stanice či zastávky ve formátu h:mm s korekcí dle
případného aktuálního zpoždění spoje,
• aktuální čas ve formátu h:mm:ss,
• seznam nejbližších 4 stanic či zastávek, přičemž u každé stanice či zastávky
budou uvedeny
o všechny tarifní zóny příslušející k této zastávce,
o čas příjezdu do této zastávky ve formátu h:mm s korekcí
dle případného aktuálního zpoždění spoje,
o případná informace o zastávce na znamení.
Seznam nejbližších stanic či zastávek bude posunut vždy po odjezdu z okruhu
stanice či zastávky, příp. také při vjezdu do okruhu zastávky z tranzitní tarifní
zóny.
Údaje zobrazované dle potřeby (je stanoveno v zadání):
• Seznam nejvýše 6 návazných spojů stanovených linek ze stanovených
nástupišť či stanovišť nejbližší přestupní zastávky, příp. stanovených
sousedních zastávek a stanic (data mohou být skládána z několika zastávek).
Seznam přestupních zastávek, s linkami a stanovišti je stanoven společností
KODIS a bude zaslán nejpozději 1 měsíc před začátkem platnosti následujícího
6
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
jízdního řádu. Systém zobrazování informací na LCD monitoru musí být
nastaven tak, aby bylo možné vzhled softwarově upravovat.
Vzhled a přesný obsah informací a grafickou úpravu stanovuje a výjimky po dohodě
s dopravcem uděluje společnost KODIS.
Informace na elektronických informačních panelech nebo tabulích musí být vždy
aktuální.
Zobrazování informací na vnitřních informačních panelech vozidel blíže upřesňuje
příloha č. 2.
2.3 Akustický elektronický informační systém
Všechna vozidla musí být vybavena funkčním akustickým elektronickým informačním
systémem určeným pro hlášení stanic a zastávek a dalších dopravních informací
pomocí palubního počítače nebo jiného kontroléru, mikrokontroléru nebo řídící
jednotky.
Textace použitá v hlášení je jednotná pro všechny spoje standardu ODIS 4, ODIS 5
a ODIS 6. Před příjezdem do stanice či zastávky je hlášení oznámeno jednotnou
znělkou, přičemž následující hlášení se skládá z vyhlášení aktuální stanice či zastávky
ve formátu odpovídajícím textacím na vnitřním informačním panelu. Po odjezdu
ze stanice či zastávky je hlášení oznámeno jednotnou znělkou, přičemž následující
hlášení se skládá z vyhlášení textu „příští stanice“ a následující stanice či zastávky
ve formátu odpovídajícím textacím na vnitřním informačním panelu. Využití systému
k reklamnímu hlášení mimo oblast veřejné dopravy je povoleno pouze s předchozím
souhlasem společnosti KODIS.
Akustický informační systém musí cestující informovat také o následující zastávce
„na znamení“, a to vždy po výjezdu z předchozí stanice či zastávky ve formátu: „příští
stanice XY, zastávka je na znamení, pro výstup stiskněte tlačítko signalizace.“ Ve
chvíli, kdy cestující stiskne tlačítko signalizace, je tato informace přenesena ke
strojvedoucímu, v tuto chvíli se ozve hlášení ve formátu: „příští stanice XY,
zastavíme.“ Při příjezdu do zastávky je v případě nestisknutého tlačítka signalizace
cestující informován hlášením ve formátu: „zastávka XY, zastávka je na znamení.“
Ve vozidlech standardu ODIS 4, ODIS 5 a ODIS 6 musí být v případě
mimořádností zajištěno hlášení pro cestující formou vlakového rozhlasu. V případě
požadavků dispečera KODIS (prostřednictvím dispečera dopravce) je nutné zajistit
informovanost cestujících ve vlaku o aktuálním dění v dopravě a s tím souvisejícími
opatřeními.
Součástí akustického elektronického informačního systému vozidel standardů ODIS
4, ODIS 5 a ODIS 6 je i informační systém pro nevidomé.
2.4 Dveře vozidla, místa pro kočárky a osoby s omezenou schopností
pohybu
Vozidla standardu ODIS 4, ODIS 5 a ODIS 6 musí být vybavena takovým počtem
dveří, aby byla ve stanicích a zastávkách zaručena rychlá výměna cestujících.
7
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
Šířka dveří musí odpovídat obratu cestujících ve stanicích a zastávkách.
Dveře otevírá buď strojvedoucí, nebo cestující po předchozím odblokování
(poptávkové otevírání dveří). Pokud je to technicky a provozně možné, musí být
v době temperování vozidla používáno poptávkové otevírání dveří, pokud je jím
vozidlo vybaveno. Po ukončení nástupu a výstupu cestujících se dveře na základě
vyhodnocení situace samy zavřou.
Poptávkové otevírání dveří musí být nastaveno tak, aby se dveře vozidla otevřely
ve stanici či zastávce po odblokování dveří strojvedoucím i v případě, kdy bylo
tlačítko poptávkového otevírání dveří stisknuto již za jízdy vlaku.
Vozidla standardu ODIS 4, ODIS 5 a ODIS 6 musí být vybavena centrálním
zavíráním dveří. Dveře musí být za jízdy blokovány.
V provozu může být vozidlo ponecháno, nefungují-li maximálně dvoje dveře na jedné
straně soupravy. Současně musí být z každého vozidla (tj. i každého vozu soupravy)
umožněn výstup alespoň jedněmi dveřmi na každé straně vozidla.
V každém dveřním prostoru musí být umístěna samolepka s důležitými telefonními
čísly pro nouzová volání (112, 150, 155, 156 a 158) a telefonní kontakt na infolinku
ODIS.
Místa pro kočárky, jízdní kola a osoby s omezenou schopností pohybu a orientace
jsou vyznačena na stěnách vozu a na podlaze v prostoru vyhrazeného místa
piktogramy.
2.5 Odbavovací a prodejní zařízení
Odbavovací a prodejní zařízení ve vozidlech standardu ODIS 4, ODIS 5 a ODIS 6
se skládá ze dvou částí. Jedná se o:
• Odbavovací terminály umístěné vždy v nástupním prostoru vozidel kategorie
ODIS 4, ODIS 5 a ODIS 6.
• Odbavovací a prodejní zařízení vlakové čety.
2.5.1 Odbavovací terminály
Odbavovací terminály jsou umístěny vždy u každých nástupních dveří vozidla
kategorie ODIS 4, ODIS 5 a ODIS 6. V každém nástupním prostoru jsou umístěny
2 terminály (s výjimkou dveřního prostoru s plošinou pro invalidní vozík, kde
postačuje 1 terminál), přičemž minimálně 1 terminál musí být funkční. Terminály jsou
vybaveny čtečkou bezkontaktních čipových a bankovních karet. Základní komponenty
systému mohou být integrovány do libovolných celků. Zařízení musí být připraveno
pro komunikaci s elektronickými zařízeními prostřednictvím technologie NFC.
Princip odbavení cestujícího s bezkontaktní čipovou kartou ODISka či bankovní kartou
je následující:
1. Na obrazovce terminálu s dotykovou obrazovkou jsou v základním stavu
zobrazena pole s názvem „Nástupní stanice“, kterou bude moci cestující
změnit, nicméně po odbavení se opět nastaví návratově aktuální stanice.
V položce „Do“ není ve výchozím stavu vyplněna žádná stanice. Cestující může
cílovou stanici vybrat rychlou volbou jedné ze 6-ti nabízených stanic, kdy se
bude jednat o 6 cílových stanic, do kterých jsou z dané aktuální výchozí
8
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
stanice nejčastěji prodávány jízdenky, a to nejen v rámci dané trati, či
vlakového spoje, ale v rámci systému ODIS. Pokud si cestující nezvolí jednu ze
6-ti nabízených stanic, klikne do položky „Do“: vybrat stanici a terminál
nabídne písmennou klávesnici dle abecedy, kde nejdříve pod touto nabídkou
bude ještě nejprve zobrazen postupný seznam následných stanic daného
vlakového spoje. Pokud si cestující přeje cestovat jinam, vybere počáteční
písmeno názvu stanice, případně více počátečních písmen a zobrazí se názvy
stanic ODIS, odpovídající tomuto zadání. V určitých mezistaničních relacích lze
alternativně využít dvě, případně i více tras, v tomto případě se objeví
pomocné okénko „PŘES“. Nejdříve se vždy odbavuje držitel karty, následně
odbavuje spolucestující, zavazadla, psy přes další tlačítko s názvem
„Spolucestující“. Na základní obrazovce je také tlačítko „Předchozí volba“, kdy
cestující zrychleně nadefinuje cílovou (a výchozí) stanici, kterou použil pro
odbavení předchozí cestující.
2. Při přiložení bezkontaktní čipové karty ODISka s nahranou platnou
dlouhodobou časovou jízdenku či nahranou platnou jednotlivou jízdenkou
REGION dojde k zobrazení platnosti této jízdenky a úseku její platnosti.
V případě platné dlouhodobé jízdenky s platnou zónou v rámci zvolené trati, je
úsek za tuto zónu odečten z ceny jízdného dle přílohy č. 3 tohoto dokumentu.
3. Cestující navolí svou cílovou stanici v poli „Cílová stanice“ a potvrdí tlačítko
„Výdej“. V případě, že bude odbavován na kartu ODISka, není potřeba volit
jakékoli slevové jízdné, jelikož jízdné je vydáno dle platného profilu na kartě.
V případě použití BK v režimu capping, taktéž cestující nevolí slevové jízdné a
pouze provede TAP. V případě dokupované jízdenky pro spolucestujícího,
cestující provede nastavení slevy dle tarifu ODIS. V takovém případě systém
upozorní cestujícího textem na obrazovce, že je nutné taktéž vlakové četě
doložit nárok na slevu. Po navolení požadavku dojde k jeho potvrzení a
návratu zpět na výchozí obrazovku s již navolenou „Cílovou stanicí“. Po
provedení všech úkonů bude cestující vyzván k přiložení karty.
4. Při nákupu jízdného pro spolucestující cestující nejdříve odbaví sebe. Následně
po navolení „Nástupní stanice“ a „Cílové stanice“ provede navolení počtu
spolucestujících a potvrdí tlačítkem „Výdej“. Následně bude cestující vyzván
k přiložení karty. Informace o prodeji jízdních dokladů pro spolucestující bude
cestujícímu zřetelně uvedena na displeji zařízení. Informace o zakoupených
jízdenkách musí být možná v tzv. „infu“ po přiložení příslušné karty.
5. Po přiložení karty dojde k zápisu jednotlivé jízdenky pro držitele karty na
ODISku či k úkonům souvisejícím s odbavením BK. Po přiložení karty při
nákupu jízdních dokladů pro spolucestující, dojde k platbě z EP ODISky a
zápisu jízdenky do Yellowlistu nákupů, či k úkonům souvisejícím s odbavením
BK.
6. V případě požadavku na tisk daňového dokladu bude v případě ODISky nebo
BK v režimu capping tento doklad cestujícímu k dispozici ke stažení na
www.odiska.cz. V případě použití BK v režimu retail zařízení vyzve cestujícího
k zadání emailu, na který následně bude odeslán zjednodušený daňový
doklad.
9
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
Ve všech případech zařízení odbavuje cestující dle platného tarifu ODIS včetně
odlišného odbavení v jednotlivých tarifních oblastech. Funkce odbavovacího a
prodejního zařízení mohou být implementovány do standardně používaných zařízení
dopravce.
Zařízení musí obsahovat minimálně 2 SAM sockety.
Čtečka terminálu musí splňovat požadavek na akceptaci a garanci bezporuchového
a plynulého využití bankovních bezkontaktních platebních karet min. VISA
a Mastercard. Čtečka splňuje požadavek na certifikaci dle aktuální verze relevantních
standardů PCI, Paypass 3.0.x, Visa PayWave, Visa Contactless Payment Specification
verze 2.1.1. nebo vyšší.
Dále k využití bankovních platebních karet je dopravce povinen zajistit:
• Certifikovaný HW pro akceptaci EMV karet včetně všech potřebných SW licencí
EMV kernelu. HW je připravený pro nahrání platební aplikace. Dopravce musí
zajistit součinnost HW výrobce čtečky pro nahrávání platební aplikace
a případnou další implementaci. Dopravce si musí dohodnout se smluvním
zúčtovatelem platebních transakcí KODISu způsob práce s bankovní čtečkou
při odbavení ODISky a BK. Náklady na případné úpravy svých systémů pro
tuto integraci nese Dopravce.
• Datovou konektivitu čtečky (přes palubní počítač nebo přes vlastní SIM).
• Distribuci denylistu z centrálního systému dle specifikace datové věty KODIS
v aktuální verzi (dle přílohy č. 4 tohoto dokumentu) do palubního počítače a
jeho zpřístupnění v úložném prostoru palubního počítače pro čtečku platebních
karet.
• Implementaci komunikačního protokolu pro komunikaci čtečky platebních
karet a palubního počítače (dokumentaci k protokolu obdrží dopravce
po uzavření smlouvy s KODIS) a předávání vybraných dat definovaných
KODISem do transakční věty pro odbavení bankovní karty.
• Implementaci komunikačního protokolu pro komunikaci odbavovacího zařízení
s odbavovacím a prodejním zařízením vlakové čety prostřednictvím NFC
rozhraní pro předávání informací o přiložených kartách (dokumentaci
k formátu předávaných dat obdrží dopravce po uzavření smlouvy s KODIS).
• Servis čtečky a podporu pro vývoj.
• Splnění vybraných požadavků ze standardu PCI DSS v aktuální verzi na fyzické
zabezpečení čtečky a budování bezpečnostního povědomí všech zaměstnanců,
kteří přijdou do styku s platebními kartami.
• Splnění vybraných požadavků ze standardu PCI DSS v aktuální verzi (Životní
cyklus standardu PCI DSS jsou 3 roky) zejména na fyzické zabezpečení čtečky
(PCI DSS požadavek 9.x) a budování bezpečnostního povědomí (PCI DSS
požadavek 12.x) všech zaměstnanců, kteří přijdou do styku s platebními
kartami (řidiči, technici, apod.).
• Zasílání dat do clearingu MSK včetně informací o přiložení bankovní karty
dle specifikace věty KODIS v aktuální verzi dle přílohy č. 4 tohoto dokumentu.
10
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
• Dopravce uzavře smlouvu o poskytnutí licence platební aplikace s dodavatelem
poskytovatele služeb zprostředkování karetních transakcí pro odbavení
cestujících pro KODIS.
• Dopravce předá čtečky pro nahrání klíčů v bezpečném prostředí a nahrání
aplikace pro odbavení cestujících pomocí bankovní karty.
Mezi základní požadavky na zařízení patří:
• odbavení bankovní bezkontaktní platební kartou dle přílohy č. 3 a přílohy č. 5
tohoto dokumentu,
• maximální doba odbavení ODISky, která se řídí přílohou č. 6 tohoto
dokumentu,
• maximální doba odbavení BK je stejná jako maximální doba odbavení ODISky,
• odbavení cestujících dle tarifu ODIS,
• odbavení více zón na zastávce dle přílohy č. 3 při použití např. hraničních
zastávek nebo nadzón, minimální počet zón je stanoven na 3 zóny + 1
nadzónu pro každou zastávku,
• možnost tarifního odbavení i pro zónu, ve které není zastávka daného spoje
(projížděná zóna) dle přílohy č. 3,
• akceptace a kontrola nahraných dlouhodobých časových jízdenek na ODISce
dle přílohy č. 3,
• záznam dlouhodobé časové jízdenky nebo kreditu elektronické peněženky
zakoupené přes e-shop na ODISku - akceptace greenlistu,
• odmítnutí odbavení ODISky, která se nachází na blacklistu,
• pravidelná synchronizace dat (greenlist, blacklist, whitelist) se systémem CS
minimálně 1x za hodinu,
• uchovávání dat o prodeji a odbavení, včetně zasílání těchto dat minimálně 1x
denně pomocí GPRS nebo rychlejšího způsobu komunikace do CS,
• pravidelná synchronizace transakcí uložených v Yellowlistu ON-LINE se
systémem Prodejních a odbavovacích zařízení vlakových čet.
Všechny datové toky se řídí přílohou č. 4 tohoto dokumentu.
Terminologie je popsána v příloze č. 3 tohoto dokumentu.
Výstupní data obsahují minimálně následující údaje, které jsou přesně stanoveny
v příloze č. 4:
• číslo odbavovacího a prodejního zařízení,
• číslo odpočtu,
• číslo jízdenky,
• druh platby (hotovostní, bezhotovostní, dobíjení elektronické peněženky,
rozlišení dle jednotlivých druhů měn),
• druh tarifu,
11
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
• druh jízdenky (dlouhodobá, krátkodobá, jednotlivá REGION nebo MĚSTO),
• výši základní sazby,
• označení přestupní jízdenky bez základní sazby,
• číslo vlaku,
• uznané tarifní zóny na trase,
• nahrané tarifní zóny nebo nadzóny v případě prodeje jednotlivé jízdenky dle
tarifních oblastí,
• tarifní kilometry odpovídající zakoupenému jízdnímu dokladu,
• tarifní číslo nástupní zastávky dle číselníku,
• tarifní číslo výstupní zastávky dle číselníku,
• cena vč. DPH,
• DPH jízdenky,
• datum prodeje,
• čas prodeje,
• platnost dokladu,
• počáteční a konečnou výši stavu elektronické peněženky,
• číslo ODISky u každé transakce spojené s ODISkou,
2.5.2 Odbavovací a prodejní zařízení vlakové čety
Každý člen vlakové čety provádějící úkony související s odbavením cestujících musí
být vybaven odbavovacím a prodejním zařízením vlakové čety. Odbavovací a prodejní
zařízení vlakové čety je vybaveno tiskárnou jízdních dokladů a čtečkou
bezkontaktních čipových a bankovních karet. Základní komponenty systému mohou
být integrovány do libovolných celků. Zařízení musí být připraveno pro komunikaci
s elektronickými zařízeními prostřednictvím technologie NFC.
Odbavovací a prodejní zařízení vlakové čety musí být schopno přečíst a vyhodnotit
2D kód dle přílohy č. 3 a přílohy č. 7 a níže uvedených parametrů v průměrném čase
do 1000 ms od zaostření (je-li na displeji mobilního telefonu zobrazována sekvence
takových 2D kódů, pak musí zaostření probíhat pouze pro první z nich, každý další 2D
kód tedy musí být přečten průměrně do 1000 ms od zobrazení bez nutnosti dalšího
zaostření).
Typ kódu: QR kód; Korekce: 8% (Level L); Verze: 23 (109 x 109 modulů)
Dále k využití BK je dopravce povinen zajistit:
• Certifikovaný HW pro akceptaci EMV karet včetně všech potřebných SW licencí
EMV kernelu. HW je připravený pro nahrání platební aplikace. Dopravce musí
zajistit součinnost HW výrobce čtečky pro nahrávání platební aplikace
a případnou další implementaci. Dopravce si musí dohodnout se smluvním
zúčtovatelem platebních transakcí KODISu způsob práce s bankovní čtečkou
při odbavení ODISky a BK. Náklady na případné úpravy svých systémů pro
tuto integraci nese Dopravce.
12
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
• Datovou konektivitu čtečky (přes palubní počítač nebo přes vlastní SIM).
• Distribuci denylistu z centrálního systému dle specifikace datové věty KODIS
v aktuální verzi (dle přílohy č. 3) do palubního počítače a jeho zpřístupnění
v úložném prostoru palubního počítače pro čtečku platebních karet.
• Implementaci komunikačního protokolu pro komunikaci čtečky platebních
karet a palubního počítače (dokumentaci k protokolu obdrží dopravce
po uzavření smlouvy s KODIS) a předávání vybraných dat definovaných
KODISem do transakční věty pro odbavení bankovní karty.
• Implementaci komunikačního protokolu pro komunikaci odbavovacího zařízení
s revizorskou čtečkou prostřednictvím NFC rozhraní pro předávání informací
o přiložených kartách (dokumentaci k formátu předávaných dat obdrží
dopravce po uzavření smlouvy s KODIS).
• Servis čtečky a podporu pro vývoj.
• Splnění vybraných požadavků ze standardu PCI DSS v aktuální verzi na fyzické
zabezpečení čtečky a budování bezpečnostního povědomí všech zaměstnanců,
kteří přijdou do styku s platebními kartami.
• Splnění vybraných požadavků ze standardu PCI DSS v aktuální verzi (Životní
cyklus standardu PCI DSS jsou 3 roky) zejména na fyzické zabezpečení čtečky
(PCI DSS požadavek 9.x) a budování bezpečnostního povědomí (PCI DSS
požadavek 12.x) všech zaměstnanců, kteří přijdou do styku s platebními
kartami (řidiči, technici, apod.)
• Zasílání dat do clearingu MSK včetně informací o přiložení bankovní karty
dle specifikace věty KODIS v aktuální verzi dle přílohy č. 4.
• Dopravce uzavře smlouvu o poskytnutí licence platební aplikace s dodavatelem
poskytovatele služeb zprostředkování karetních transakcí pro odbavení
cestujících pro KODIS.
• Dopravce předá čtečky pro nahrání klíčů v bezpečném prostředí a nahrání
aplikace pro odbavení cestujících pomocí bankovní karty.
Mezi základní požadavky na zařízení patří:
• odbavení v hotovosti s následným vytištěním kontrolní jízdenky nebo ODISky
dle přílohy č. 3 a přílohy č. 5,
• odbavení bankovní bezkontaktní platební kartou, a to jak v režimu capping,
tak retail, s následným vytištěním kontrolní jízdenky dle přílohy č. 3 a přílohy
č. 5,
• maximální doba odbavení ODISky, která se řídí přílohou č. 6,
• maximální doba odbavení BK je stejná jako maximální doba ODISky,
• odbavení cestujících dle tarifu ODIS,
• odbavení více zón na zastávce dle přílohy č. 3 při použití např. hraničních
zastávek nebo nadzón, minimální počet zón je stanoven na 3 zóny + 1
nadzónu pro každou zastávku,
13
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
• možnost tarifního odbavení i pro zónu, ve které není zastávka daného spoje
(projížděná zóna) dle přílohy č. 3 tohoto dokumentu,
• akceptace a kontrola nahraných dlouhodobých časových jízdenek na ODISce
dle přílohy č. 3 tohoto dokumentu,
• nákup dlouhodobých časových jízdenek v hotovosti nebo z elektronické
peněženky na ODISce,
• nabití elektronické peněženky na ODISce,
• záznam dlouhodobé časové jízdenky nebo kreditu elektronické peněženky
zakoupené přes e-shop na ODISku - akceptace greenlistu,
• odmítnutí odbavení ODISky, která se nachází na blacklistu,
• pravidelná synchronizace dat (greenlist, blacklist, whitelist) se systémem CS
minimálně 1x za hodinu,
• uchovávání dat o prodeji a odbavení, včetně zasílání těchto dat minimálně 1x
denně pomocí GPRS nebo rychlejšího způsobu komunikace do CS.
• Vyčtení platných jednotlivých jízdenek ODIS nahraných na ODISce včetně
vytištění dokladu o nákupu těchto jízdních dokladů na požádání cestujících.
• Stažení whitelistů ,
• pravidelná synchronizace transakcí uložených v Yellowlistu ON-LINE se
systémem Odbavovacích terminálů,
• akceptace 2D kódů, jejich kontrola se dále řídí přílohou č. 3 tohoto
dokumentu.
Všechny datové toky se řídí přílohou č. 4 tohoto dokumentu.
Terminologie je popsána v příloze č. 3 tohoto dokumentu.
Výstupní data obsahují minimálně následující údaje, které jsou přesně stanoveny
v příloze č. 4:
• číslo odbavovacího a prodejního zařízení,
• číslo obsluhy,
• číslo odpočtu,
• číslo jízdenky,
• druh platby (hotovostní, bezhotovostní, dobíjení elektronické peněženky,
rozlišení dle jednotlivých druhů měn),
• druh tarifu,
• druh jízdenky (dlouhodobá, krátkodobá, jednotlivá REGION nebo MĚSTO),
• výši základní sazby,
• označení přestupní jízdenky bez základní sazby,
• číslo vlaku,
• uznané tarifní zóny na trase,
14
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
• nahrané tarifní zóny nebo nadzóny v případě prodeje dlouhodobé
nebo krátkodobé časové jízdenky,
• tarifní kilometry odpovídající zakoupenému jízdnímu dokladu,
• tarifní číslo nástupní zastávky dle číselníku CIS, případně dle číselníku stanic
SR 70.
• tarifní číslo výstupní zastávky dle číselníku CIS, případně dle číselníku stanic SR
70.
• cena vč. DPH,
• DPH jízdenky,
• datum prodeje,
• čas prodeje,
• platnost dokladu v případě dlouhodobé nebo krátkodobé časové jízdenky,
• počáteční a konečnou výši stavu elektronické peněženky,
• číslo ODISky u každé transakce spojené s ODISkou,
• storno jízdenky.
2.6 Signalizační zařízení uvnitř vozidla
Všechna vozidla standardu ODIS 4, ODIS 5 a ODIS 6 musí být vybavena
signalizačním zařízením umožňujícím informovat strojvedoucího či vlakovou četu o:
• požadavku cestujícího na výstup na zastávce na znamení dle bodů 2.2 a 2.3,
• požadavku cestujícího na vozíku pro invalidy na výstup na zastávce,
• požadavku rychlé pomoci (SOS tlačítko).
Ve vozidle musí být umístěn takový počet tlačítek, aby bylo zaručeno, že v blízkosti
každých dveří se bude nacházet tlačítko pro signalizaci výstupu v zastávce na
znamení. Tlačítka v blízkosti dveří musí být maximálně ve výšce 150 cm nad
podlahou vozidla. Tlačítka musí být umístěna taktéž v prostoru pro sedící cestující.
V případě, že vozidla nejsou vybavena tlačítky pro požadavek cestujících na výstup
na zastávce na znamení nebo je signalizace pro výstup v poruše, považují se všechny
zastávky za stálé, tj. žádná není na znamení.
2.7 Komunikace s dispečinky
Dopravce provozující vozidlo standardu ODIS 4, ODIS 5 a ODIS 6 musí zasílat
prostřednictvím dohodnutých komunikačních kanálů informace o provozu vlaku do
dispečinku KODIS.
Vozidla standardu ODIS 4, ODIS 5 a ODIS 6 musí být vybavena GPS pro zasílání
údajů o aktuální poloze vlaku pro upřesnění polohy vozidel v mezistaničních úsecích.
Dopravce bude zasílat kromě informací o poloze vlaku také trasu vlaku a číslo vlaku
(hnacího vozidla nebo jednotky a jednotlivých vozů soupravy). Bližší specifikace je
popsána v příloze č. 8 tohoto dokumentu.
15
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
Postup při provozování dohodnutých komunikačních kanálů a zasílání informací z GPS
se dále řídí pravidly v příslušné kapitole článku XII. Technických a provozních
standardů ODIS.
2.8 Informační vitríny
Každé vozidlo (tj. každý jednotlivý vůz soupravy) standardu ODIS 4, ODIS 5 a
ODIS 6 musí být vybaveno informačními vitrínami umožňujícími umístění alespoň 4
listů formátu A3. V těchto vitrínách jsou vždy umístěny informační materiály ODIS.
Vitrínu lze realizovat také formou klaprámů výše uvedeného formátu.
Každé vozidlo (tj. každý jednotlivý vůz soupravy) standardu ODIS 4, ODIS 5 a
ODIS 6 musí být navíc vybaveno klaprámy určenými k vyvěšení informací o
Integrovaném dopravním systému ODIS na železnici. Klaprámy musí být umístěny
v každém nástupním prostoru a jsou určeny k vyvěšení materiálu o velikosti
490 ˣ 490 mm. Zvolený formát vitrín a umístění vitrín podléhá schválení společnosti
KODIS.
Společnost KODIS obvykle zajišťuje výrobu a dodání informačních materiálů na
kontaktní adresu dopravce, dopravce je povinen zajistit jejich tisk (v případě dodání
materiálu v elektronické formě) a vyvěšení do vitrín či klaprámů v termínu nejpozději
7 dnů od dodání společností KODIS. Kontaktní adresou dopravce se pro tyto účely
rozumí místo pro doručování informačních materiálů, tato adresa musí být na území
Moravskoslezského kraje.
2.9 Informační piktogramy
Každé vozidlo standardu ODIS 4, ODIS 5 a ODIS 6 musí být vybaveno
následujícími jednotícími prvky:
a) logo ODIS (na každých dveřích vozu dle vzoru a rozměrů dodaných
společností KODIS),
b) logo Moravskoslezského kraje (na boku vozidla dle vzoru a rozměrů
dodaných Moravskoslezským krajem).
V případě požadavků KODIS a Moravskoslezského kraje budou vozidla vybavena
dalšími jednotícími prvky, jejichž vzor a rozměry budou dodány buď KODISem, anebo
Moravskoslezským krajem.
Umístění, velikost a vzhled všech piktogramů stanovuje společnost KODIS pro
jednotlivé druhy vozidel po domluvě s dopravci.
2.10 Informační materiály
Dopravce uvnitř vozidla nesmí žádné materiály vylepovat nebo jiným způsobem
upevňovat na okna nebo jiné součásti vozidla. Jakékoliv informační nebo reklamní
materiály mohou být ve vozidlech standardu ODIS 4, ODIS 5 a ODIS 6 vyvěšovány
pouze v informačních vitrínách či klaprámech.
Každé vozidlo (tj. každý jednotlivý vůz soupravy) standardu ODIS 4, ODIS 5 a
ODIS 6 je vybaveno sadou informačních materiálů umísťovaných pouze do
informačních vitrín či klaprámů určených pro vyvěšování informačních a propagačních
materiálů ODIS. Tato sada se skládá z těchto součástí:
16
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
a) výňatek z tarifu ODIS,
b) schéma sítě železniční dopravy dle pokynů společnosti KODIS,
c) aktuální informace o změnách v dopravě,
d) další dohodnuté materiály propagující veřejnou dopravu a ODIS.
Tato sada je vždy v aktuálním znění dle pokynů společnosti KODIS.
Po dohodě s dopravcem mohou být do vitrín umístěny další propagační materiály
ODIS.
V případě potřeby informování cestující veřejnosti o zavedených mimořádných
opatřeních je v zájmu lepší informovanosti povoleno umisťovat informační materiály i
mimo informační vitríny k tomu určené, a to pouze na okenní výplň interiérových
dveří (tj. dveří oddělujících nástupní prostor od oddílu s místy k sezení). Pokud
vozidlo takovým typem dveří nedisponuje, připouští se umístění na skleněné
přepážky sloužící k obdobnému účelu.
Při umístění informačních materiálů je nutné dbát na konkrétní způsob umístění a
upevnění informačního materiálu, zejména s důrazem na vodorovnou pozici horního
okraje informačního materiálu, umístění ve výšce očí dospělé osoby, způsob upevnění
informačního materiálu k podkladu a přiměřenou ochranu před poškozením
informačního materiálu při průchodu cestujících nebo posuvu dveří. Jiné, než výše
uvedené umístění mimo informační vitríny není přípustné.
Společnost KODIS obvykle zajišťuje výrobu a dodání informačních materiálů na
kontaktní adresu dopravce, dopravce je povinen zajistit jejich tisk (v případě dodání
materiálu v elektronické formě) a vyvěšení do vitrín či klaprámů v termínu nejpozději
7 dnů od dodání společností KODIS. Kontaktní adresou dopravce se pro tyto účely
rozumí místo pro doručování informačních materiálů, tato adresa musí být na území
Moravskoslezského kraje.
2.11 Klimatická pohoda vozidel
Vozidla standardu ODIS 4, ODIS 5 a ODIS 6 jsou vybavena aktivní plnohodnotnou
klimatizací, která zabezpečí udržení teploty v interiéru vozidla při běžném provozu dle
platné legislativy.
Technický stav vozidel standardu ODIS 4, ODIS 5 a ODIS 6 musí zaručovat
možnost otevření a uzavření všech oken a větracích průduchů k tomu konstrukčně
určených a možnost temperovat vozidlo. V případě vybavení vozidla klimatizační
jednotkou musí být zajištěno účinné větrání prostoru cestujících v případě její
poruchy či poškození. Vozidla nevybavená systémem pro chlazení prostoru pro
cestující musí mít minimálně 50 % bočních oken s ventilačními prostory.
Vlakové čety jsou povinny dle konstrukce vozidla umožnit temperování vozidla
v případě, že je temperování řízeno dálkově, nebo zajistit přiměřené temperování
vozidla. Pokud vlaková četa není schopna zjistit teplotu okolního vzduchu, je povinna
zahájit temperování vozidla dle svého uvážení či na žádost cestujících. V době
temperování vozidla je strojvedoucí povinen využívat přednostně poptávkové
otevírání dveří, je-li jím vozidlo vybaveno.
17
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
U vozidel vybavených aktivní plnohodnotnou klimatizací je Dopravce povinen zajistit
její funkčnost a udržovat ve vnitřních prostorech vozidla tepelnou pohodu dle
parametrů uvedených v následující tabulce:
Vnější teplota Průměrná teplota ve vozidle ve výšce 1 m nad podlahou
Pod -10 °C 17 °C – 20 °C
-10 °C až -5 °C 18 °C – 21 °C
-5 °C až 0 °C 19 °C – 22 °C
0 °C až 21 °C 19 °C – 22 °C
21 °C až 27 °C 21 °C – 24 °C
27 °C až 33 °C 23 °C – 26 °C
Více než 33 °C 25 °C – 28 °C
2.12 Čistota a vzhled vozidel
Vozidla provozovaná ve standardu ODIS 4, ODIS 5 a ODIS 6 musí být denně
uvnitř čistá. Vně čištěna musí být dle klimatických poměrů tak, aby byla vždy
zajištěna čitelnost všech povinných údajů dle norem a tohoto dokumentu a také, aby
byla zajištěna čistota vnějších tlačítek poptávkového otevírání dveří. Dopravci jsou
povinni vést průkaznou evidenci o prováděném čistění vozidel tak, aby mohla být
prováděna kontrola pracovníky společnosti KODIS.
Standard je blíže rozpracován v kapitole VII. Standard úklidu vozidel.
2.13 Uspořádání interiéru vozidla
Sedadla vozidel standardu ODIS 4, ODIS 5 a ODIS 6 musí být přednostně
uspořádána tak, aby byl sedák směrován ve směru od meziokenního sloupku k oknu.
Přednostně je tak vyžadováno uspořádání sedadel proti sobě, nežli za sebou.
Současně je upřednostňováno uspořádání sedadel kolmo na bočnici, nežli podélně.
Vozidlo musí být vybaveno taktéž policemi určenými k přepravě zavazadel
umístěnými nad sedadly. Tyto police mohou být ve vybraných případech, kdy to jinak
konstrukce vozidla neumožňuje, umístěny ve speciálním prostoru určeném pro
přepravu zavazadel v blízkosti oddílu pro cestující.
Sedadla musí být polstrovaná.
V případě jízdy v noci nebo za snížených světelných podmínek je obsluha vlaku
povinna zapnout osvětlení. Vůz s nefunkčním osvětlením nesmí být použit v případě,
že spoj jede v nočních hodinách.
Vozidel standardu ODIS 4, ODIS 5 a ODIS 6 musí být vybaveny USB porty a
zásuvkami 230 V pro nabíjení drobné elektroniky. V případě, že pro vozidlo vyplývá
povinnost vybavení zásuvkami USB a 230 V, je dopravce tato zařízení udržovat v
provozuschopném stavu.
18
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
2.14 Wi-Fi
Vozidla provozovaná ve standardu ODIS 4, ODIS 5 a ODIS 6 jsou vybavena
takovými prvky, které umožní bezplatné bezdrátové připojení uživatelů (cestujících)
pomocí Wi-Fi k síti internet.
3. Prohlášení o shodě
Veškerá vozidla, včetně vybavení, provozovaná na linkách na základě uzavřené
smlouvy mezi Objednatelem a Dopravcem podléhají procesu prohlášení o shodě
s Technickými a provozními standardy ODIS. Tato povinnost platí pro vozidla
provozovaná ve všech standardech.
Proces prohlášení o shodě především ověřuje kompatibilitu vozidla a jeho vybavení
s technickými a provozními standardy, zařízeními a systémy dosud provozovanými
v ODIS. Pokud není zajištěna úplná kompatibilita, nelze prohlášení o shodě vydat.
Přechodně lze vydat prohlášení o shodě na dobu určitou, a to podmíněně s ohledem
na zjištěné nedostatky nemající zásadní charakter ovlivňující provoz vozidla.
V průběhu výroby vozidla až do doby vystavení průkazu způsobilosti vozidla dopravce
požádá společnost KODIS o účast zástupce společnosti KODIS na kontrolních dnech
za účelem prověření souladu vozidla a jeho vybavení s Technickými a provozními
standardy a případného pořízení fotodokumentace vozidla. Pokud neshledá závady,
vydá do 15 dnů od posledního kontrolního dne prohlášení o shodě vozidla
s Technickými a provozními standardy ODIS.
V případě shledání závad nebo nesouladu vozidla nebo jeho vybavení s Technickými
a provozními standardy nebude prohlášení o shodě dopravci vydáno. Z uvedených
důvodů může být dopravci již udělené prohlášení o shodě i odebráno.
Je možné vydat hromadné prohlášení o shodě pro určitý druh vozidel a jejich
vybavení. I v případě hromadného prohlášení o shodě je však prováděna kontrola
dodržení Technických a provozních standardů a fotodokumentace vozidla.
Formu vydaných prohlášení o shodě stanovuje společnost KODIS.
V případě vozidel určených k nasazení do provozu na linkách ODIS na dobu kratší
než 2 měsíce (obvykle zkušební vozidla) je společnost KODIS oprávněna vhodným
způsobem upravit požadavky na technické vybavení těchto vozidel.
4. Evidence vozidel provozovaných v ODIS
Dopravci provozující spoje ve standardu ODIS 4, ODIS 5 a ODIS 6 jsou povinni pro
potřeby správné funkčnosti dispečinku KODIS společnost KODIS informovat o
vozidlech nově zařazovaných do provozu v rámci ODIS a o vozidlech, která z provozu
vyřazují.
Před nasazením vozidel na linky ODIS je dopravce povinen seznámit společnost
KODIS s úplností a funkčností vybavení každého vozidla, předat společnosti KODIS
v písemné nebo elektronické podobě veškeré údaje týkající se vozidla (označení
vozidla, druh vozidla, čísla hnacího vozidla nebo jednotky, apod.). Tato povinnost
platí pro vozidla provozovaná ve všech standardech. V případě změn některého
z uvedených údajů je dopravce povinen okamžitě informovat společnost KODIS.
19
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
II. STANDARD SLUŽEB VE STANICÍCH A NA
ZASTÁVKÁCH
1. Pokladní přepážky
Za účelem poskytování informací, prodeje jízdních dokladů a kontaktu s cestujícími
zřídí dopravce na základě tohoto standardu minimálně 1 pokladní přepážku
(kontaktní místo) ve stanicích Ostrava střed, Frýdek-Místek a Frýdlant nad Ostravicí.
Pokladní přepážka ve výše uvedených stanicích bude otevřena po celý týden
v minimálním rozsahu 05:00-20:00. Provozní dobu může dopravce na základě
potřeby nebo zvýšené poptávky prodloužit, rovněž lze zvýšit i počet pokladních
přepážek ve stanici.
Zřídí-li dopravce pokladní přepážku v jiné stanici než ve výše uvedených, je nutné
písemně informovat KODIS o nové pokladní přepážce a o provozní době dané
přepážky.
Každá pokladní přepážka musí být označena názvem dopravce a logem IDS ODIS a
piktogramy určujícími možnosti zakoupení jízdních dokladů. Na vývěsce je nutné
pokladní přepážku vybavit informacemi o provozní době, rozsahu poskytovaných
služeb, možnosti placení bezkontaktní platební kartou a bezkontaktní čipovou kartou
ODISka. Vývěska musí obsahovat telefonní kontakt na Dopravní infocentrum ODIS
pro případ, že by byla pokladní přepážka uzavřená.
Zaměstnanec obsluhující pokladní přepážku musí dodržovat ústrojovou kázeň
nošením uniformy. Za minimální uniformní standard se považuje nošení polokošile či
košile s logem dopravce.
Na pokladní přepážce jsou poskytovány prodejní služby veškerého sortimentu
jízdních dokladů ODIS, včetně jednotlivého jízdného. Mezi další služby patří
vystavování průkazů určených k prokazování nároku na slevy dle tarifu ODIS
a k veškerým úkonům souvisejícím s bezkontaktní čipovou kartou ODISka. Na všech
pokladních přepážkách jsou poskytovány veškeré informace o ODIS a o všech
dopravcích v ODIS, jsou zde vydávány informační materiály, resp. prodávány
materiály propagační a jsou zde cestujícím na požádání vydávána potvrzení o
zpoždění vlaku (tzv. „zpožděnky“).
V případě plánovaného uzavření pokladny (například z důvodu odstávky vody,
rekonstrukce či jiné překážky, kterou dopravce nemůže za vyvinutí maximálního úsilí
ovlivnit) informuje dopravce písemně dispečink KODIS o této skutečnosti nejpozději 7
dní před uzavřením pokladny. V případě mimořádného uzavření pokladny informuje
dopravce telefonicky dispečink KODIS nejpozději 2 hodiny od uzavření pokladní
přepážky s následným písemným doložením této skutečnosti.
2. Čekárny
Dopravce bude provozovat ve stanicích Ostrava střed, Frýdek-Místek a Frýdlant nad
Ostravicí čekárnu pro cestující, případně tuto službu zajistí u správce objektu.
Provozní doba čekárny je minimálně v rozsahu provozní doby pokladní přepážky, tj.
05:00-20:00 nebo s nejdéle otevřenou pokladnou. Vstup do čekárny je bezplatný.
20
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
Pokud dopravce bude provozovat čekárnu i v jiné stanici, než je výše uvedeno, platí
pro tuto čekárnu stejná pravidla jako pro čekárny ve výše uvedených stanicích.
V rámci možností dané stanice je upřednostňována samostatná místnost,
bezbariérová, která je v provozní době vytápěná/klimatizovaná. Teplota čekárny musí
být udržována v rozmezí min. 15 °C a max. 30 °C.
Čekárna musí být dále vybavena:
• minimálně 15 místy k sezení,
• elektronickou tabulí s aktuálními odjezdy (minimálně 6 řádků),
• informačními vitrínami o celkové ploše 8x A3 (Minimální rozměry vitrín
schvaluje KODIS s ohledem na formát informačních materiálů a vývěsek.),
• odpadkovým košem,
• staničním hlášením o odjezdech a mimořádnostech,
• v rámci čekárny musí být zřízeno dostatečné místo pro umístění invalidního
vozíku nebo dětského kočárku.
Dopravce bude při zajištění výše uvedených služeb spolupracovat se správci
příslušných objektů. Pokud se i při vyvinutí přiměřeného úsilí nepodaří dopravci
některou z požadovaných služeb zajistit z důvodu negativního stanoviska správce
objektu a tuto skutečnost Dopravce Objednateli nebo KODIS prokáže, bude od
požadavku na takovou službu ze strany Objednatele a KODIS upuštěno.
V čekárně je denně prováděn úklid (vysypání košů, mytí podlah a kontaktních ploch).
Při zjištění nečistot v rozsahu, který tyto nečistoty neumožňuje odstranit (graffiti,
nápisy, znečištění zdí, oken a dveří) neprodleně informuje dopravce o této
skutečnosti KODIS. Termín na odstranění je tři dny od podání informace. Při
neposkytnutí této informace je vůči dopravci uplatňován postup, kdy nebyl dodržován
úklid v čekárně.
O každém úklidu je proveden záznam, který obsahuje informace o uklizených
prostorech a době, kdy byl úklid prováděn. Dopravce poskytne tyto záznamy KODISu
na požádání k nahlédnutí.
3. WC
Dopravce bude provozovat WC ve stanicích Ostrava střed, Frýdek-Místek a Frýdlant
nad Ostravicí v minimálním rozsahu shodujícím se s provozní dobou pokladní
přepážky. Službu provozování WC lze smluvně zajistit u správce objektu nebo třetí
strany.
Vstup na WC musí být bezbariérový a WC musí být vybaveno přebalovacím pultem.
Na WC je prováděn každodenní úklid. Kontrola čistoty WC je prováděna každé dvě
hodiny provozní doby WC (o provedení kontroly a úklidu bude rovněž veden záznam,
který je na vyžádání KODISu poskytnut k nahlédnutí).
Dopravce bude při zajištění výše uvedené služby spolupracovat se správci příslušných
objektů. Pokud se i při vyvinutí přiměřeného úsilí nepodaří dopravci některou z
požadovaných služeb zajistit z důvodu negativního stanoviska správce objektu a tuto
21
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
skutečnost Dopravce Objednateli nebo KODIS prokáže, bude od požadavku na
takovou službu ze strany Objednatele a KODIS upuštěno.
4. Úschovna zavazadel
Dopravce bude ve stanicích Ostrava střed, Frýdek-Místek a Frýdlant nad Ostravicí
poskytovat službu úschovy zavazadel. Tuto službu lze poskytnout rovněž formou
pokladní přepážky. Rozsah poskytování této služby je poskytován minimálně
v rozsahu provozní doby pokladní přepážky.
Službu úschovy zavazadel lze zajistit formou úložných boxů. V boxech musí být
denně prováděn úklid s dezinfekcí těchto prostor.
5. Audiovizuální systém ve stanicích a zastávkách
Dopravce zajistí akustické hlášení vlaků ve stanicích u správce infrastruktury
v následujícím minimálním rozsahu:
• linka,
• směr (tj. cílová stanice),
• čas odjezdu,
• údaje o zpoždění,
• nástupiště a číslo koleje (příp. pouze koleje – dle místních zvyklostí),
• mimořádnost, výluka.
V případě výluky bude toto hlášení rozšířeno o vyloučený úsek a informaci o trase
náhradní autobusové dopravy a zastávce (případně o stanovišti) náhradní
autobusové dopravy.
Dopravce zajistí vizuální zobrazení vlaků ve stanicích u správce infrastruktury
v následujícím minimálním rozsahu:
• linka,
• směr (tj. cílová stanice),
• čas odjezdu,
• údaje o zpoždění,
• nástupiště a číslo koleje (příp. pouze koleje – dle místních zvyklostí),
• mimořádnost, výluka (postačuje textace doplněná akustickým hlášením).
V případě výluky bude, dle technických možností, zobrazována informace o
vyloučeném úseku, případně informace o zavedení náhradní autobusové dopravy.
6. Asistence při přepravě, nástup imobilních cestujících
Dopravce bude poskytovat službu asistence při přepravě, tj. zejména osobám
nevidomým, slabozrakým a matkám s kočárky. Tato služba zahrnuje asistenci při
nástupu a výstupu.
22
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
Přeprava imobilního cestujícího musí být nahlášena nejpozději do 24 hodin před
plánovanou přepravou pro zajištění služby nástupu nebo výstupu za pomocí zvedací
plošiny.
Při přepravě imobilního cestujícího zajistí dopravce nástup za pomocí zvedací plošiny
u správce infrastruktury či jiného subjektu, který plošinou disponuje za předpokladu,
že vozidlo dopravce není zvedací plošinou vybaveno nebo neumožňují-li poměry
v železniční stanici použití výklopné plošiny.
Povinnost zajištění přepravy imobilního cestujícího se vztahuje pouze na bezbariérově
přístupné stanice a zastávky dle příslušné ČSN 73 4959.
7. Služby na zastávkách a v neobsazených stanicích
Dopravce zajistí informovanost cestujících na zastávkách a v neobsazených stanicích
formou vývěsné informace v informační vitríně či klaprámu ve formátu 8x A3.
Minimální rozměry vitrín schvaluje KODIS s ohledem na formát informačních
materiálů a vývěsek. V těchto vitrínách budou základní informace následujícího
charakteru:
• název dopravce,
• logo IDS ODIS,
• informace o možnosti placení ve vozidle bezkontaktní platební kartou nebo
bezkontaktní čipovou kartou ODISka, (případně o možnostech placení na
zastávce či v neobsazené stanici, je-li tato vybavena odbavovacím zařízením),
• telefonní kontakt na Dopravní infocentrum ODIS.
• informace o IDS ODIS
• výňatek z tarifu ODIS,
• schéma sítě železniční dopravy dle pokynů společnosti KODIS,
• aktuální informace o změnách v dopravě,
• další dohodnuté materiály propagující veřejnou dopravu a ODIS,
• aktuální jízdní řád ODIS,
• informace o výlukách.
Dopravce je povinen sledovat aktuálnost uveřejněných materiálů v informačních
vitrínách či klaprámech a po ukončení platnosti vývěsky tuto vývěsku do 5 dní
odstranit (v případě oznámení o výluce do 72 hodin od ukončení výluky).
Při umístění informačních materiálů je nutné dbát na konkrétní způsob umístění a
upevnění informačního materiálu, zejména s důrazem na vodorovnou pozici horního
okraje informačního materiálu, umístění ve výšce očí dospělé osoby, způsob upevnění
informačního materiálu k podkladu a přiměřenou ochranu před poškozením
informačního materiálu. Umístění mimo informační vitríny nebo klaprámy není
přípustné (s výjimkou označení zastávky NAD).
Společnost KODIS obvykle zajišťuje výrobu a dodání informačních materiálů na
kontaktní adresu dopravce, dopravce je povinen zajistit jejich tisk (v případě dodání
materiálu v elektronické formě) a vyvěšení do vitrín či klaprámů v termínu nejpozději
23
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
7 dnů od dodání společností KODIS. Kontaktní adresou dopravce se pro tyto účely
rozumí místo pro doručování informačních materiálů, tato adresa musí být na území
Moravskoslezského kraje.
Dopravce bude při zajištění informačních vitrín a klaprámů spolupracovat se správci
příslušných objektů. Pokud se i při vyvinutí přiměřeného úsilí nepodaří Dopravci
požadované informační plochy zajistit z důvodu negativního stanoviska správce
objektu a tuto skutečnost Dopravce Objednateli nebo KODIS prokáže, bude od
požadavku ze strany Objednatele a KODIS upuštěno.
24
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
III. STANDARD TIŠTĚNÝCH JÍZDNÍCH DOKLADŮ
1. Obsah jízdních dokladů
Tištěné jízdní doklady ODIS musí obsahovat údaje dle § 5 Vyhlášky č. 175/2000 Sb.
O přepravním řádu pro veřejnou drážní a silniční osobní dopravu, dále musí
obsahovat další údaje dle následující tabulky č. 1:
Tabulka č. 1: Standard tištěných potvrzení nebo jízdních dokladů
Jednotlivé jízdenky Dlouhodobé časové
MĚSTO, REGION, jízdenky
krátkodobé časové,
24hodinové jízdenky předprodej odbavení
u vlakové
odbavení
předprodej u vlakové čety
čety
Název a logo ODIS, číslo jízdenky
Číslo linky, zaměstnance, číslo vlaku
Zařízení, kód jízdenky
Datum a čas vydání
Uznané zóny, možnosti přestupu, starý a nový
zůstatek elektronické peněženky (při platbě
ODISkou)
Zakoupené zóny, platnost časová a územní,
starý a nový zůstatek elektronické peněženky
(při platbě ODISkou)
Zelená barva označuje chtěný požadavek uvedený v levé části tabulky.
Minimální požadavky na vzhled a obsah jízdních dokladů pro celý ODIS po konzultaci
s dopravci stanoví společnost KODIS. Všechny přestupní jízdenky jsou doplněny
textem „Přestupní v ODIS po celou dobu platnosti“.
V případě použití BK formou režimu capping, bude vydáváno potvrzení o jízdě, které
bude obsahovat informativní cenu a nebude daňovým dokladem. Text potvrzení po
konzultaci s dopravci stanoví společnost KODIS.
2. Ochrana jízdních dokladů
Všechny jízdní doklady v ODIS vydané dopravci nebo jinou formou musí na sobě nést
ochranné prvky.
Papírové pásky mohou být vyrobeny z termopapíru s dobou zachování čitelnosti
všech údajů minimálně po dobu 5 let. Pásky obsahují logo ODIS, které je chráněno
ochrannou známkou společnosti KODIS.
Každý dopravce je povinen předat společnosti KODIS informace o způsobu
zabezpečení výše uvedených materiálů. Společnost KODIS je v případě zjištění jejich
nedostatečné ochrany oprávněna omezit, popř. zakázat dopravci prodej jízdních
dokladů.
Dopravce, který vydává jízdenky ODIS, musí zajistit spolehlivé ověření nároku
na slevu při prodeji jízdenky, resp. při vystavování průkazů určených k dlouhodobým
časovým jízdenkám pracovníky pokladních přepážek či dopravních infocenter.
25
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
IV. POVINNOSTI PRACOVNÍKŮ DOPRAVCE
1. Povinnosti pracovníků dopravce
Pracovníci dopravce se musí k cestujícím chovat slušně, vstřícně a citlivě a nesmějí
být na cestující hrubí. Vlaková četa případně jiný zaměstnanec dopravce je povinen
informovat cestující o všech nestandardních situacích, které během jejich přepravy
nastanou, přičemž se zejména jedná o mimořádnosti v dopravě. V takovém případě
je vlaková četa povinna co nejdříve poskytnout cestujícím informaci o přibližné délce
čekání, případně o způsobu jakým se situace bude řešit.
V zastávkách „na znamení“ zastavují vozidla určená k přepravě cestujících jen:
• nachází-li se na zastávce osoba (osoby);
• dává-li cestující ve voze návěst stisknutím tlačítka signalizačního zařízení;
• je-li v poruše informační systém vozidla,
• požádá-li cestující vlakovou četu o zastavení na zastávce.
Zastávky „na znamení“ jsou definovány platným jízdním řádem. K zastávce „na
znamení“ musí strojvedoucí přijíždět takovou rychlostí, aby dokázal vyhodnotit situaci
v zastávce a v případě potřeby řádně a bezpečně zastavit. Strojvedoucí, který projíždí
zastávkou „na znamení“ bez zastavení, musí dbát zvýšené opatrnosti.
Charakter zastávky „na znamení“ nemá vliv na povinnost dodržovat pravidelný odjezd
ze zastávky daný schváleným jízdním řádem.
Pokud vozidlo nasazené na linku obsluhující zastávku s charakterem „na znamení“
nevyhovuje minimálně jednomu z bodů uvedených v kapitole Vybavení vozidel, musí
na zastávce s charakterem „na znamení“ zastavit vždy.
Vlaková četa a strojvedoucí nesmí během pobytu ve vozidle kouřit.
Školení zaměstnanců dopravce
Všichni provozní zaměstnanci dopravce musí být proškoleni a přezkoušeni ze znalostí
ODIS.
Školení i zkoušení je možné provést i korespondenční nebo kombinovanou formou,
což znamená, že zaměstnanci obdrží informační brožury a následně odpoví
na přiložený test znalostí.
Dopravce je povinen vést a nejméně dva roky archivovat záznamy o proškolení
a výsledcích testů svých zaměstnanců o ODIS a na vyžádání je poskytnout
společnosti KODIS.
Informační povinnosti dopravců
Ve všech případech informování cestujících dopravcem o dočasných změnách
v dopravě musí být využita grafická úprava podle vzoru určeného či schváleného
jednorázově společností KODIS a informační materiál musí být průběžně kontrolován
a udržován v čitelném stavu.
26
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
Po ukončení dočasné změny v dopravě je dopravce povinen zkontrolovat odstranění
všech informačních materiálů týkajících se této změny a uvést informační plochy, do
stavu odpovídajícímu aktuálnímu vedení linek a jízdním řádům.
Dopravce je povinen na žádost společnosti KODIS zabezpečit informování cestujících
i v případě rozsáhlejších změn.
Dopravce je povinen prostřednictvím automatizovaného systému provozovaného
společností KODIS poskytovat cestujícím, případně dalším subjektům, informace
o aktuální poloze svých vozidel jedoucích na linkách ODIS.
V případě nedodržení návazností, resp. při výrazném zpoždění vlaku je dopravce
povinen informovat cestující o této změně. V případě výlukové činnosti je dopravce
povinen zajistit informování cestujících nejméně sedm dní předem, a to vyvěšením
informací v dotčených stanicích a zastávkách po celé trase linky.
Pokud dopravce provozuje webové stránky, je povinen tyto udržovat v aktuální
podobě.
Dopravce je povinen si stanovit vnitřní předpis pro vyřizování stížností. V případě
nutnosti prověřit oprávněnost stížnosti cestujících je dopravce povinen dodat
své vyjádření ke stížnosti do 15 dnů od vyzvání společností KODIS. O každé doručené
stížnosti je dopravce povinen KODIS informovat písemně spolu se zněním stížnosti a
poté se zaslanou odpovědí.
27
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
V. STANDARD ODBAVENÍ CESTUJÍCÍCH, PRODEJE
JÍZDNÍCH DOKLADŮ A DOPRAVNÍCH INFOCENTER
1. Obsah standardu
Cílem standardu je stanovit pravidla pro odbavení cestujících a prodej jízdních
dokladů. Stanovuje místa a způsoby prodeje jízdních dokladů a informační povinnosti
míst, kde jsou doklady prodávány.
2. Odbavení cestujících
2.1 Definice
Odbavovací systém
Systém zařízení nebo lidské kontroly zajišťující dodržování
tarifních podmínek, případně odčerpání elektronických peněz za
jízdné dle územního či vzdálenostního hlediska.
Odbavení cestujícího
Způsob, jakým dopravce vyřídí požadavek cestujícího cestovat,
tzn. způsob, jakým cestující zakoupí jízdenku, způsob, jakým
cestující prokazuje svůj nárok na přepravu při uzavírání
a uskutečňování přepravní smlouvy.
Odbavovací systém ODIS
Souhrn odbavovacích systémů jednotlivých dopravců, systém
je jednotně koordinován, řízen a rozvíjen společností KODIS.
Standardy vozidel ODIS jsou definovány v kapitole I.2. Standardy vybavení vozidel
provozovaných v ODIS.
3. ODISka
ODISka je vzájemně uznávaným elektronickým platebním prostředkem u dopravců
zajišťujících veřejnou osobní dopravu v rámci Integrovaného dopravního systému
Moravskoslezského kraje ODIS.
Je to bezkontaktní čipová karta, která slouží jako nosič dlouhodobých
nebo krátkodobých časových jízdenek uložených v její paměti. Dále je také pomocí
ODISky možné placení jízdného z elektronické peněženky.
V rámci ODIS rozlišujeme dva základní druhy ODISky. Jednak Osobní ODISku,
jejímž držitelem je konkrétní osoba. Na takovéto ODISce je uvedeno jméno, příjmení
a fotografie držitele. Osobní ODISka je nepřenosná což znamená, že s touto může
cestovat pouze její držitel, který však může zakoupit jízdenku z elektronické
peněženky i pro spolucestujícího, psa, zavazadla apod.
Druhým druhem je Anonymní ODISka, která neobsahuje žádná osobní data.
Na takovouto ODISku je možné zakoupit pouze přenosné dlouhodobé časové jízdné
nebo obyčejné jednotlivé jízdné, vč. jízdného pro spolucestujícího, psa, zavazadla
apod.
28
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
Každý dopravce provozující veřejnou dopravu na základě Smlouvy o veřejných
službách v přepravě cestujících k zajištění dopravní obslužnosti kraje veřejnou drážní
osobní dopravou v dané oblasti je povinen ODISku akceptovat, a to oba její výše
uvedené druhy. Standard ODISky se řídí přílohou č. 6 tohoto dokumentu.
4. Způsoby prodeje jízdních dokladů
Jízdní doklady ODIS jsou prodávány následujícími způsoby:
• v dopravních infocentrech (DI),
• prodejem ve vlaku nebo v železničních stanicích a zastávkách,
• prodejem po internetu,
• prodejem v mobilní aplikaci ODISapka,
• externími prodejci.
Dopravce je povinen zajišťovat prodej jízdních dokladů ve vozidlech a v pokladnách
vybraných železničních stanic a zastávek.
5. Prodej v železničních stanicích a zastávkách
Dopravce je povinen zajistit prodej jízdních dokladů ve vybraných železničních
stanicích a zastávkách. Dopravce v těchto stanicích a zastávkách zajišťuje prodej:
• celého sortimentu dlouhodobých časových, 24hodinových a 3denních jízdenek
dle tarifu ODIS,
• jednotlivých jízdenek ODIS,
Ve všech případech zařízení odbavuje cestující dle platného tarifu ODIS včetně
odlišného odbavení v jednotlivých tarifních oblastech.
Všechny druhy jízdného je možné uhradit v hotovosti (bankovkami i
mincemi), bezhotovostně užitím elektronické peněženky ODISky nebo bezhotovostně
užitím bankovní platební karty, a to jak v režimu capping, tak retail. Zařízení musí být
schopno komunikace s elektronickými zařízeními prostřednictvím technologie NFC.
Čtečka terminálu musí splňovat požadavek na akceptaci a garanci bezporuchového
a plynulého využití bankovních bezkontaktních platebních karet min. VISA a
Mastercard. Čtečka splňuje veškeré požadavky acquiera pro práci s bankovní
kartou min. VISA a Mastercard.
Všechny formáty datových toků se řídí dokumentem „Datová věta pro MSK“.
Terminologie je popsána v samostatném dokumentu „Procesy MSK“.
Dopravce musí akceptovat shodné podmínky pro odbavení cestujícího jednotlivou
jízdenkou prostřednictvím bezkontaktní čipové karty ODISka či bezkontaktní platební
karty s podmínkami pro zařízení určená k prodeji a akceptaci jízdních dokladů
ve vozidle dle článku 2.5 bodu 2 kapitoly I. tohoto dokumentu.
Prodej v železničních stanicích a zastávkách poskytuje také další služby, mezi které
patří:
• vystavování průkazů určených k prokazování nároku na slevy dle tarifu ODIS,
29
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
• změny profilů na kartách ODISka,
• vybrané úkony související s bezkontaktní čipovou kartou ODISka (vrácení
jízdného, reklamace aj.),
• nabití elektronické peněženky na ODISce,
• záznam dlouhodobé časové jízdenky nebo kreditu elektronické peněženky
zakoupené přes e-shop na ODISku - akceptace greenlistu,
• odmítnutí odbavení ODISky, která se nachází na blacklistu,
• pravidelná synchronizace dat (greenlist, blacklist, whitelist) se systémem CS
minimálně 1x za hodinu,
• poskytování informací o ODIS a o všech dopravcích v ODIS,
• informace o cestování v ODIS,
• vyhledávání spojení po ČR a Evropě,
• informace o změnách v dopravě,
• poskytování kompletního sortimentu informačních materiálů ODIS,
• sběrné místo pro podání podnětů od občanů (pochvaly, připomínky, stížnosti),
• poskytování informací o přepravě hendikepovaných osob,
• prodej doplňkového sortimentu a suvenýrů,
• vydávání potvrzení o zpoždění vlaku (tzv. „zpožděnky“).
Poskytování vybraných služeb je v rámci ODIS zpoplatněno, pro dopravce je v tomto
ohledu závazný „Ceník produktů a služeb BČK“.
Další ustanovení vztahující se na prodejní místa jsou uvedena v článku 1 kapitoly II.
Výjimky v provozování prodejních míst v železničních stanicích a zastávkách
stanovuje společnost KODIS.
30
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
6. Prodej u vlakové čety (dále jen obsluha)
Vozidla standardu ODIS 4, ODIS 5 a ODIS 6 jsou vybavena odbavovacím a
prodejním zařízením vlakové čety dle článku 2.5 bodu 2 kapitoly I. tohoto
dokumentu.
Odbavovací a prodejní zařízení vlakové čety zajišťuje prodej všech druhů jízdenek.
Za podmínek stanovených v aktuálně platném Tarifu ODIS a Smluvních a přepravních
podmínkách ODIS i nabití tzv. elektronické peněženky na ODISce a prodej
dlouhodobých časových jízdenek na ODISku. Vlaková četa je povinna vydat
cestujícímu vždy správnou a cenově nejvýhodnější platnou jízdenku z výchozí do
požadované cílové stanice či zastávky cestujícího. Dopravce je povinen zajistit, aby
byla všechna zařízení ve vozidle nastavena tak, aby cestující vždy obdržel správný
jízdní doklad. Uvedené platí také pro bezplatnou přepravu. Odbavovací a prodejní
zařízení není povinno vydat kontrolní doklad pro cestujícího, který se prokáže
dlouhodobou časovou jízdenkou.
Odbavovací a prodejní zařízení vlakové čety prodává minimálně celý sortiment
30denních dlouhodobých časových jízdenek za podmínek stanovených v aktuálně
platném Tarifu ODIS a Smluvních a přepravních podmínkách ODIS.
Vlaková četa je povinna být přiměřeně vybavena drobnými mincemi a bankovkami
tak, aby mohla cestujícímu prodat jízdenku, nabít elektronickou peněženku na
ODISce a navrátit příslušný obnos při obdržení bankovky v hodnotě 1000 Kč.
Příslušný přeplatek je možné vrátit taktéž formou poukázky.
Prodej jednotlivých a vybraných druhů dlouhodobých časových jízdenek provádí
odbavovací a prodejní zařízení v hotovosti (pouze odbavovací a prodejní zařízení
vlakové čety bankovkami i mincemi) nebo bezhotovostně za použití elektronické
peněženky na ODISce či bezkontaktní platební karty, a to jak v režimu capping, tak
retail.
V případě prodeje jízdného s přirážkou lze úhradit přirážku na odbavovacím a
prodejním zařízení v hotovosti nebo bezhotovostně za použití elektronické peněženky
na ODISce či bezkontaktní platební karty.
Vlaková četa vydává cestujícím jízdné bez přirážky za následujících okolností:
• Po uzavření pokladní přepážky na základě provozní doby dané přepážky.
• Při plánovaném nebo mimořádném uzavření pokladní přepážky.
• Při nemožnosti zakoupení jízdného na pokladní přepážce z důvodu technické
poruchy prodejního zařízení na pokladní přepážce.
• Při přestupu z jiného vlakového nebo autobusového spoje, kdy by nebylo
možné z důvodu zpoždění nebo mimořádnosti jízdní doklad zakoupit. Cestující
se vlakové četě prokáže jízdním dokladem z předchozího vlaku nebo autobusu,
pokud je to možné.
• Při nefunkčnosti prodejního terminálu ve vozidle.
• Pokud není vozidlo prodejním terminálem vybaveno.
31
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
7. Prodej jízdenek na samoobslužných validátorech
Vozidla standardu ODIS 4, ODIS 5 a ODIS 6 jsou vybavena odbavovacími
terminály dle článku 2.5 bodu 2 kapitoly I. tohoto dokumentu.
Prostřednictvím samoobslužných validátorů lze zakoupit jednotlivé jízdenky s úhradou
ODISkou (včetně jízdenek pro spolucestující, psy a zavazadla) nebo BK (včetně
režimu capping).
Samoobslužné validátory nejsou vybaveny tiskárnami dokladů, daňové doklady jsou
k dispozici na E-shopu ODIS.
Samoobslužné validátory zajišťují nahrávání transakcí z Greenlistu na ODISku.
8. Prodej po internetu
KODIS zajišťuje prodej jízdenek a karet ODISka po internetu. Informace o všech
nákupech na E-shopu ODIS se sdružují v CS provozované společností KODIS, jako
tzv. Greenlist, jenž je definován v příloze č. 4 tohoto dokumentu. Stažení
Greenlistu zajistí dopravci do svých odbavovacích a prodejních systémů
(především do odbavovacích a prodejních zařízení) minimálně jednou za hodinu, díky
čemuž se tyto informace umístí datově na ODISku po jejím přiložení ke čtečce. Dále
KODIS zajišťuje po internetu evidenci BK včetně slevových profilů a prodej
dlouhodobého jízdného k těmto registrovaným BK. Informace o všech nákupech na
BK na E-shopu ODIS se sdružují v CS provozované společností KODIS jako tzv.
Whitelist BK, jenž je definován v příloze č. 5 tohoto dokumentu.
9. Prodej jízdenek mobilní aplikace ODISapka
KODIS zajišťuje provoz mobilní aplikace ODISapka s možností nákupu jízdenek.
Kontrola zakoupených jízdenek je zajištěna prostřednictvím odbavovacích a
prodejních zařízení vlakové čety dle článku 2.5 bodu 2 kapitoly I. tohoto dokumentu.
10. Prodej dlouhodobých časových jízdenek
10.1 Definice dlouhodobé časové jízdenky
Dlouhodobá časová jízdenka (kupon) umožňuje cestujícím v rámci své časové a
územní platnosti využívat všechny linky ODIS.
Existují dvě základní formy dlouhodobé časové jízdenky:
a) přenosná – neumožňuje z titulu svého charakteru identifikaci majitele, prodej
je umožněn pouze na anonymní ODISku,
b) nepřenosná – prodej je umožněn na Osobní ODISku a dále je umožněn prodej
k registrované BK nebo Virtuální ODISce.
10.2 Prodej dlouhodobé časové jízdenky na ODISku
Prodejem dlouhodobé časové jízdenky ODIS se rozumí prodávání a nahrávání
elektronických kuponů na ODISku dle prokázaného a ověřeného nároku cestujícího.
Prodej elektronických kuponů dlouhodobých časových jízdenek zajišťují dopravci
či provozovatelé DI. KODIS má právo pověřit prodejem kuponů další subjekty.
32
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
10.3 Prodej dlouhodobé časové jízdenky k on-line nosičům
Prodejem dlouhodobé časové jízdenky ODIS k on-line nosičům se rozumí prodávání a
přiřazování elektronických kuponů k BK nebo k Virtuální ODISce dle prokázaného
a ověřeného nároku cestujícího.
Prodej elektronických kuponů dlouhodobých časových jízdenek k on-line nosičům
zajišťuje KODIS, případně dopravci či provozovatelé DI. KODIS má právo pověřit
prodejem kuponů další subjekty.
33
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
VI. KONTROLNÍ ČINNOST
Kontrolu týkající se dodržování Tarifu ODIS, Smluvních přepravních podmínek ODIS a
kontrolu pracovníků dopravce při prodeji jízdních dokladů provádí ve vozidlech
standardu ODIS 4, ODIS 5, ODIS 6 a na pokladních přepážkách společnost KODIS.
Společnost KODIS provádí kromě výše uvedených povinností také přepravní kontrolu,
tj. kontrolu jízdních dokladů cestujících.
Společnost KODIS provádí rovněž kontrolu Technických provozních standardů ODIS.
Zaměstnanec KODIS se za účelem kontroly prokazuje platným průkazem:
V případě shledání nedostatků bude dále postupováno na základě sankčních ujednání
dle přílohy č. 9 tohoto dokumentu.
34
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
VII. STANDARD ÚKLIDU VOZIDEL
Standard úklidu vozidel definuje minimální požadavky na četnost a rozsah provedení
úklidových prací souvisejících s provozní čistotou vozidel. Dopravce je povinen
udržovat pořádek ve vozidle po celou dobu nasazení vozidla na vlakové spoje v ODIS
a pravidelným úklidem předcházet dlouhodobému usazování nečistot. Tímto
standardem se řídí vozidla standardu ODIS 4, ODIS 5 a ODIS 6.
Dopravci je umožněno nastavit si vlastní systém úklidu vozidel, tento systém musí
být v souladu s minimálními požadavky na četnost a provedení úklidových prací
definovanými v tomto standardu.
1. Úklid vnějších povrchů vozidla
Úklid vnějších povrchů spočívá v pravidelném čistění všech povrchů vozidla dle níže
stanovených zásad.
1.1 Pravidelný úklid
S ohledem na aktuální klimatické podmínky je požadováno pravidelné čištění vnějších
povrchů, aby byly přes tyto plochy čitelné všechny elektronické informační panely
(nebo jejich alternativa v podobě cedulí), dále je vyžadována čitelnost nápisů
požadovaných zákonnými normami nebo Technickými a provozními standardy ODIS.
Typicky se jedná o logo ODIS, logo Moravskoslezského kraje, název dopravce, UIC
označení vozidla apod.
Důraz je kladen na čistotu tlačítek umístěných na dveřích či vozové skříni vozidla,
zejména v období nepříznivých povětrnostních podmínek. Tlačítka umístěná na
dveřích či vozové skříni vozidla jsou dezinfikována současně při provádění
pravidelného (týdenního) úklidu vnitřních prostor. S ohledem na vývoj hygienických a
epidemických opatření může být Objednatelem nebo KODISem požadována zvýšená
četnost dezinfekce dotykových ploch.
V případě poškození vozidla graffiti je stanovena lhůta 3 dnů pro jejich odstranění.
Pokud je rozsah poškození vozidla rozsáhlejší (plocha převyšující 10 m2 nebo
komplikovaný postup odstranění poškození) lze vozidlo vyměnit za záložní a
poškození odstranit posléze. Hanlivé, urážející, případně dehonestující či legislativou
zakázané graffiti či vyobrazení musí být odstraněny neprodleně.
1.2 Hloubkový úklid vnějších povrchů
Hloubkový úklid vnějších povrchů (i střechy vozidla) spočívá zejména ve strojním
čištění skříní vozidel v pravidelném intervalu s ohledem na aktuální klimatické
podmínky. Interval mezi dvěma hloubkovými čištěními vozidla nepřesáhne 30 dní,
přičemž v případě čištění čelních ploch vozidla nepřesáhne 15 dní. Interval je možno
prodloužit v případě, kdy vozidlo není nasazeno na vlakové spoje v ODIS, před jeho
opětovným nasazením do provozu musí být proveden hloubkový úklid.
35
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
V případě poškození vnějších polepů a nápisů strojním čištěním musí být tyto prvky
po provedení strojního čištění neprodleně doplněny.
2. Úklid vnitřních prostor vozidla
Úklid vnitřních prostor vozidla spočívá v pravidelném čistění všech povrchů vozidla,
úklidu prostor toalet a vysypávání odpadkových košů dle níže stanovených zásad.
2.1 Operativní úklid
Operativní úklid je prováděn při obratu soupravy nebo při jízdě vlaku v případě, kdy
je potřeba neprodleně odstranit znečištění s ohledem na jeho povahu (typicky se
jedná o biologické znečištění, velké kusy bahna, velké kusy zmrazků, vystříkání
hasicího přístroje apod.). Dopravce vynaloží veškeré rozumně požadovatelné úsilí k
zajištění úklidu s ohledem na charakter znečištění.
Za operativní úklid je rovněž považováno doplnění hygienických potřeb na toaletách,
vlakový personál je povinen v případě absence vícevrstvého toaletního papíru,
papírových ručníků, mýdla či dezinfekce provést jejich okamžité doplnění. S výše
uvedenou povinností je spojená i povinnost umístit do úložného prostoru ve vozidlech
standardu ODIS 4 a ODIS 5 náhradní hygienické pomůcky pro případ jejich
operativního doplnění vlakovým personálem.
2.2 Pravidelný denní úklid
Pravidelný denní úklid zahrnuje:
- vysypání všech košů v celé soupravě,
- úklid viditelných nečistot a pohozených odpadků, tiskovin nebo jízdenek,
- doplnění hygienických pomůcek na toaletách – vícevrstvého toaletního papíru,
papírových ručníků, mýdla a dezinfekce,
- základní úklid a dezinfekci zařízení a povrchů prostor toalety
Pravidelný denní úklid se provádí zpravidla při delších obratech v koncových stanicích
a/nebo v době aktivního odstavení soupravy. Interval mezi dvěma pravidelnými
denními úklidy vozidla nepřesáhne 12 provozních hodin vozidla nebo nebude
překročen nájezd 300 km od posledního provedeného pravidelného denního úklidu.
Obě výše uvedené podmínky musí být naplněny. Za provozní dobu vozidla je
považován součet všech dob mezi zpřístupněním vozidla cestujícím a výstupem všech
cestujících v koncové stanici spoje.
2.3 Pravidelný týdenní úklid
Pravidelný týdenní úklid zahrnuje:
- pravidelný denní úklid
- očištění oken, průhledných výplní dveří, průhledných stěn a přepážek
- mytí a dezinfekci klik dveří, tlačítek, madel, přídržných tyčí apod.
- očištění otíratelných ploch zařízení interiéru – stolků, loketních opěrek, opěrek
hlavy
- mytí zařízení a povrchů prostor toalety
- čištění podlah
- mytí dalších zvlášť znečištěných povrchů (i odpadkových košů)
36
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
- doplnění stržených nebo poškozených informačních materiálů, piktogramů a
samolepek
Pravidelný týdenní úklid se provádí zpravidla v době aktivního odstavení soupravy
nebo v období odstavení soupravy pro potřeby údržby. Interval mezi dvěma
pravidelnými týdenními úklidy vozidla nepřesáhne 7 (sedm) dní. Interval je možno
prodloužit v případě, kdy vozidlo není nasazeno na vlakové spoje v ODIS, před jeho
opětovným nasazením do provozu musí být proveden týdenní úklid.
2.4 Hloubkový úklid vnitřních prostor
Hloubkový úklid vnitřních prostor zahrnuje:
- pravidelný týdenní úklid
- mytí podlah
- mytí všech oken, okenních rámů, okenních rolet nebo záclonek (pokud je jimi
vozidlo vybaveno)
- hloubkové a mokré čištění sedadel
- mytí všech polic, stěn, přepážek, informačních panelů, informačních vitrín a
klaprámů a dalších povrchů ve vozidle
- mokré čištění vnitřních částí odpadkových košů
V případě požadavku na zvýšenou dezinfekci vnitřních prostor může být součástí
hloubkového úklidu rovněž provedení dezinfekčního nástřiku nebo ozónového čištění.
O provedení nadstandardního hloubkového čištění bude dopravce požádán
Objednatelem nebo společností KODIS.
Hloubkový úklid vnitřních prostor vozidla se provádí zpravidla v době odstavení
soupravy nebo v období odstavení soupravy pro potřeby údržby. Předpokládá se
odstavení soupravy z provozu na maximálně 24 hodin. V případě nedostatku
disponibilních jednotek standardu ODIS 4 je možno po dobu provádění hloubkového
úklidu (nejvýše na 24 hodin) nasadit na vlakové spoje vozidlo standardu ODIS 5,
aniž by došlo k udělení sankce za nedodržení nasazení vozidla standardu ODIS 4.
Stažení vozidla z oběhu za účelem provedení hloubkového úklidu není důvodem pro
nasazení vozidla standardu ODIS 6. KODIS může po dohodě s dopravcem prodloužit
interval hloubkového úklidu.
Interval mezi dvěma hloubkovými úklidy vozidla nepřesáhne 30 (třicet) dní. Interval
je možno prodloužit v případě, kdy vozidlo není nasazeno na vlakové spoje v ODIS,
před jeho opětovným nasazením do provozu musí být proveden hloubkový úklid
vnitřních prostor.
3. Evidence a kontrola úklidu vozidel
3.1 Evidence úklidu vozidel
Pro účely kontroly jsou dopravcem sestaveny plány úklidu, které jsou KODISu
zaslány nejpozději 14 dní před zahájením platnosti celostátní změny jízdního řádu.
Plány úklidu jednoznačně definují, ve kterých turnusových dnech, mezi kterými
vlakovými spoji a ve které stanici bude proveden pravidelný denní úklid, pravidelný
týdenní úklid a pravidelný úklid vnějších povrchů vozidla. Pokud není znám plán
37
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
hloubkového úklidu vnějších a vnitřních povrchů, dopravce informuje e-mailem
nejpozději 24 hodin před započetím hloubkového úklidu vnějších nebo vnitřních
povrchů společnost KODIS. V případě změny úklidových plánů bude dopravce
neprodleně informovat KODIS a poskytne aktuální plán úklidu.
O všech stupních úklidu vozidel jsou vedeny záznamy v elektronické podobě,
záznamy jsou archivovány minimálně po dobu 12 měsíců. Na požádání jsou záznamy
poskytnuty společnosti KODIS ke kontrole plnění standardu pro úklid vozidel.
Pravidelný denní úklid je zaznamenáván v podobě evidence na tiskopisu, který je
umístěn na stěně v prostorách bezbariérové toalety v soupravě (týká se vozidel
standardu ODIS 4 a ODIS 5). Z vyplněného záznamu musí být zřejmé datum a čas
provedení pravidelného denního úklidu.
3.2 Kontrola úklidu vozidel
Objednatel a KODIS jsou oprávněni kontrolovat plnění standardu úklidu vozidel.
Kontrola úklidu vozidel je prováděna zpravidla po provedení hloubkového úklidu
(vnějšího i vnitřního), namátkově je kontrolována evidence pravidelného denního
úklidu. Dopravce poskytne součinnost při kontrole provedeného úklidu, bude včas
informovat o změnách plánu úklidu a na požádání poskytne záznamy o provedení
úklidu v elektronické podobě.
38
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
VIII. STANDARD ÚDRŽBY VOZIDEL
Dopravce udržuje vozidla v bezzávadném technickém stavu, dbá na dodržování
platné legislativy a technických norem v oblasti údržby vozidel a správy vozidlového
parku.
Při výměně součástí musejí být používány nové díly nebo při obnově opotřebených
dílů musejí být tyto upraveny tak, že jsou uvedeny do nového nebo zánovního stavu.
Pokud budou prvky vybavení nahrazovány pouze z částí, musí být toto realizováno
takovým způsobem, aby vznikl jednotný nově vyhlížející vzhled, přičemž opticky
nový/zánovní vzhled je definován následovně:
• polstrování sedáků a opěradel a příp. opěrek hlavy musí být bez skvrn, děr a
škrábanců a bez záplat; jednotné barvy,
• podlahové krytiny jsou nové jednotné barvy nebo jednotného vzoru, bez
nerovností, bez viditelných škrábanců, oděrek, děr nebo trhlin,
• obložení stěn a stropů a dveří nejsou zašpiněná ani flekatá, jinak zabarvená,
rozškrábaná, vyboulená, natržená ani proražená,
• karoserie a postranně viditelná obložení střechy jsou bez rzi a vyboulenin;
všechny montované a záklopné díly jsou v plném rozsahu na svém místě; celá
karoserie je nově nalakovaná nebo velkoplošně polepená,
• všechny nátěry a velkoplošné polepy jsou ve vztahu k barevnému tónování
jednotné, bez opotřebení, vyblednutí, kapek, bublinek, bez šmouh, bez graffiti,
viditelných záplat a bez zašpinění barvou na sousedních jinobarevných nebo
nelakovaných plochách nebo dílech,
• skleněné prvky, okenní tabulky a gumová těsnění nejsou počmáraná,
rozškrábaná, prasklá, natržená a zašlá,
• v prostoru pro cestující nejsou žádné poškozené, opotřebené nebo staře
působící prvky vybavení; jsou plně funkční, nepoškrábané, neoprýskané, bez
vyboulenin a graffiti,
• všechny nápisy a polepy na vozidle a ve vozidle jsou úplné, bez trhlin,
zašpinění, vyblednutí a změn barevnosti; souvislé nápisy musí být ohledně
typu, velikosti a barvy písma jednotné a v českém jazyce, případná
vícejazyčnost je ke konzultaci s objednatelem,
• nejsou zde žádné viditelné na cestujícího provizorně působící spoje např.
izolepou nebo kabelovými spojkami.
Dopravce zabezpečí odstranění drobných závad při provozním ošetření soupravy. U
závad vyžadujících náročnější zásah údržby nebo závad vedoucích k vyřazení
soupravy z plánovaného oběhu v průběhu dne dopravce o této závadě neprodleně
informuje KODIS. Při výjezdu soupravy po provedení hloubkového úklidu nebo
vyššího stupně údržby, než je provozní ošetření, dopravce garantuje bezzávadný stav
soupravy. KODIS může v odůvodněných případech udělit jednorázově výjimku z výše
uvedených požadavků s ohledem na charakter závady a aktuální disponibilní počet
vozidel.
39
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
IX. STANDARD ORGANIZACE VÝLUK
Výluky infrastruktury jsou projednávány minimálně s dvouměsíčním předstihem se
správcem infrastruktury (dále jen Správce) na pravidelných výlukových poradách.
Projednané výluky jsou zasílány Správcem formou zápisu z výlukové porady.
Zástupce dopravce je povinen se těchto výlukových porad zúčastnit.
Na výluku, která si vyžádá zastavení provozu na trati s nutností použití náhradní
autobusové dopravy (dále NAD), vypracuje KODIS tzv. výlukový pokyn, tj. nařízení,
jak má být výluka dopravcem organizovaná.
Ve výlukovém pokynu KODIS zpravidla určuje:
• rozsah výluky z hlediska počtu dní,
• rozsah výluky z hlediska časového ohraničení,
• vyloučený traťový úsek (tento bývá zpravidla delší, než je vyloučený úsek
zadaný Správcem),
• oběhy souprav,
• počet autobusů NAD, resp. souhrnnou kapacitu vozidel NAD pro daný spoj,
• oběhy autobusů NAD.
Tento výlukový pokyn musí KODIS dodat nejpozději 30 dní před konáním výluky,
nebude-li domluveno jinak.
Dopravce je povinen v případě výluky zajistit dopravní obslužnost pomocí NAD.
V případě použití NAD musí být zajištěno vždy minimálně 50 % kapacity částečně
nízkopodlažními vozidly pro přepravu imobilních cestujících. Vozidla NAD budou
vybavena (přenosným) GPS modulem k určení polohy vozidla pro sledování
dispečinkem KODIS. Dopravce informuje dispečink KODIS o nasazených vozidlech
NAD (RZ vozidla, typ vozidla, jízdní řád (oběh) vozidla NAD). Dopravce zabezpečí
přepravu kočárků, invalidních vozíků a jízdních kol ve vozidlech náhradní dopravy
v rozsahu definovaném společností KODIS (maximálně do výše počtu standardně
nabízených míst).
Vozidla NAD zastavují na zastávkách k tomu určených. Zastávky NAD (případně jejich
stanoviště) jsou stanoveny KODISem v příloze č. 10 tohoto dokumentu společně
s jejich označením. Označení zastávek NAD provádí správce označníku na přidělených
zastávkách (stanovištích). V případě, že se zastávka NAD neshoduje se zastávkou
městské hromadné dopravy či příměstské autobusové dopravy (zastavení je
stanoveno na jiném místě než na zastávce), provádí dopravce označení zastávky NAD
na nejbližším vhodném místě, vždy však po domluvě s KODISem. KODIS může určit
označení dané zastávky formou přenosného zastávkového označníku.
Dopravce zveřejní informace o výluce nejpozději 7 dní před konáním dané výluky na
svých webových stránkách, v železničních stanicích a zastávkách (vždy na místech
určených jako místa pro informace pro cestující), pokud byl o takové výluce
informován provozovatelem dráhy minimálně 21 dní před konáním výluky.
40
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
Po ukončení výluky provede dopravce odstranění označení:
• formou přenosného zastávkového označníku a z webových stránek
neprodleně,
• formou informací ve stanicích a zastávkách nejpozději do 72 hodin od
ukončení výluky.
Pokud dopravce obdrží informace, že Správce zkracuje určitou výluku o několik hodin
či dní, neprodleně o této skutečnosti informuje KODIS formou e-mailu. V takovém
případě platí stejná pravidla pro odstranění informací a označení o výluce.
Nedodržení obsluhy zastávek NAD, nezajištění informovanosti cestujících dle výše
uvedeného a nedodržení pravidel pro odstranění informací o výluce podléhá
sankčním ujednáním dle přílohy č. 9 tohoto dokumentu.
41
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
X. STANDARD OPATŘENÍ PRO SNÍŽENÍ DOPADU
MIMOŘÁDNOSTÍ
Dopravce o mimořádné situaci informuje dispečink KODIS neprodleně po nahlášení
mimořádné události. Ve smyslu tohoto standardu se za mimořádnou událost
považuje každé narušení grafikonu s možným dopadem na jízdu vlaku vedoucím ke
zpoždění vlakového spoje nad 30 minut nebo zrušení trasy vlakového spoje (nebo její
části). Za mimořádnost se považuje narušení grafikonu s možným dopadem na jízdu
vlaku, o kterém dopravce nemohl vědět s předstihem (tzn. jedná se o nahodilou,
resp. nepředvídatelnou událost).
V případě mimořádné události na trati či z důvodů na straně dopravce a nutnosti
zajištění náhradní autobusové dopravy (NAD), zajistí dopravce NAD do 60 minut od
nahlášení mimořádné události. Dopravce je povinen vyvinout maximální možné úsilí
při zajištění NAD a zajistit náhradní dopravu v kapacitě odpovídající minimálně 50%
kapacity soupravy, přičemž za kapacitu je pro účely tohoto standardu považován
počet míst k sezení (v případě náhradní dopravy i vlakové soupravy).
V případě disponibilního železničního vozidla je upřednostněno nasazení tohoto
vozidla před zavedením NAD, pokud toto dovoluje charakter mimořádnosti (např.
eliminace zpoždění zkrácením trasy vlaku).
Autobusy NAD budou obsluhovat zastávky NAD (případně stanoviště těchto
zastávek), které jsou stanoveny KODISem v příloze č. 10 tohoto dokumentu společně
s jejich označením. Odchylně od standardu výluk není nutné provádět označení na
místě, které se neshoduje se zastávkou městské či příměstské autobusové dopravy
(typicky prostor před nádražní budovou apod.). Za účelem minimalizace dopadu
mimořádné události na cestující vypracuje KODIS scénáře použití autobusové
dopravy při mimořádných událostech, které dopravci předá nejpozději 14 dní před
začátkem platnosti následujícího jízdního řádu.
Dopravce neprodleně zajistí zveřejnění informací o mimořádné události na svých
webových stránkách a v součinnosti se správcem infrastruktury zajistí informační
hlášení o mimořádné události v železničních stanicích a zastávkách. Zaměstnanci
dopravce musí v maximální možné míře poskytovat kvalifikované informace
cestujícím, případně cestující odkázat na dopravní infocentra.
Po ukončení mimořádné události dopravce informuje o této skutečnosti neprodleně
dispečink KODIS, své zaměstnance a formou svých webových stránek také cestující.
Nezajištění NAD po uplynutí období 60 minut od nahlášení mimořádné události
podléhá sankčním ujednáním dle přílohy č. 9 tohoto dokumentu.
V případě předpokladu trvání mimořádnosti více než 4 hodin dopravce vypracuje
konkrétní opatření pro danou mimořádnost společně s dispečinkem KODIS. Dispečink
KODIS toto opatření následně odsouhlasí, dispečinky dopravce i KODIS mohou
požadovat aktualizaci konkrétního opatření s ohledem na vývoj situace.
V případě předpokladu trvání mimořádnosti více než 3 dny se po uplynutí 72 hodin
od vzniku mimořádnosti považuje tato mimořádnost za výluku a vztahují se na ni
opatření a standardy platné pro výluku. Příkladem takové mimořádnosti může být
např. dlouhodobá nesjízdnost tratě.
42
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
XI. STANDARD NASAZENÍ ZÁLOŽNÍCH VOZIDEL
Standard nasazení záložních vozidel definuje postup při nasazení záložních vozidel, tj.
vozidel standardu ODIS 4, ODIS 5 a ODIS 6. Standard dále definuje záložní vozidlo
a jeho disponibilitu v čase.
Zásady pro nasazení vozidel standardu ODIS 4, ODIS 5 a ODIS 6 do pravidelného
oběhu:
- Ve standardním režimu jsou nasazována výhradně vozidla standardu ODIS 4,
přičemž vozidlo standardu ODIS 4 je připraveno i na pozici záložního vozidla.
- V případě nedostatku vozidel standardu ODIS 4 jsou přednostně vypravována
vozidla standardu ODIS 4 a na pozici záložního vozidla je nasazeno vozidlo
standardu ODIS 5 (případně vozidlo standardu ODIS 6, pokud není vozidlo
ODIS 5 v danou chvíli k dispozici).
- V případě vyššího správkového stavu nebo většího nedostatku vozidel
standardu ODIS 4 je vozidlo standardu ODIS 5 nasazeno do plánovaného
oběhu a na pozici záložního vozidla je umístěno vozidlo standardu ODIS 6.
- V případě, pokud dojde k odstavení většiny vozidel standardu ODIS 4 nebo
odstavení vozidel standardů ODIS 4 a ODIS 5, je možno nasadit do
plánovaného oběhu vozidlo ODIS 6 a na pozici záložního vozidla umístit další
vozidlo standardu ODIS 6.
K jednotlivým provozním scénářům nasazení vozidel standardů ODIS 4, ODIS 5 a
ODIS 6 jsou vázány odpovídající sankce dle přílohy č. 10 Smlouvy.
1. Záložní vozidlo
Záložní vozidlo je určeno pro potřeby nahrazení vozidla nasazeného na plánovaném
oběhu v případě výskytu poruchy, potřeby nahrazení soupravy nebo mimořádnosti.
Záložní vozidlo musí být k dispozici na svém stanovišti, tak aby v případě
mimořádnosti nebo poruchy vozidla byl dopravce schopen minimalizovat dopady na
jízdní řád. Stanoviště záložního vozidla je umístěno na trase provozované linky S6
nebo v jejím blízkém okolí, tj. v dojezdové vzdálenosti max. 30 km od pravidelné
trasy linky S6. Disponibilita záložního vozidla je stanovena na období pondělí až
neděle od 4:00 do 22:00 s předpokládaným nasazením dle aktuální provozní situace
a disponibility personálu dopravce.
O nasazení záložního vozidla rozhoduje dispečink dopravce. O každém využití
záložního vozidla je proveden záznam a tento záznam je zaslán v souhrnném
měsíčním přehledu KODISu. Záložní vozidlo může být využito i v jiných provozních
souborech nebo na ostatních vlakových spojích dopravce mimo ODIS, avšak toto
využití podléhá schválení dispečinkem KODIS.
43
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
XII. STANDARD OPERATIVNÍHO ŘÍZENÍ PROVOZU
(PŘÍPOJE VE STANICÍCH)
1. Dispečerský aparát Dopravce a KODIS
Standard operativního řízení provozu definuje rozsah pravomocí jednotlivých
dispečerských aparátů (Dopravce a KODIS) a spolupráci mezi nimi.
1.1 Komunikace mezi dispečinky
Dispečink KODIS s dispečerským aparátem dopravce komunikuje skrze datové věty,
e-mail a telefonické spojení. Pro potřeby operativního zajišťování přípojných vazeb
a řešení mimořádných událostí v provozu je vyžadována oboustranná odezva do 2
minut od přijetí požadavku datovou větou (notifikace) nebo požadavku na telefonický
hovor.
Dopravce je povinen provozovat dispečink denně v období od 15 minut před
odjezdem prvního vlaku z výchozí stanice do 15 minut po příjezdu posledního vlaku
do koncové stanice.
Dispečink KODIS může být provozován v automatickém režimu, kdy pracuje s garancí
návazností s pevně stanovenými maximálními čekacími dobami. V případě zpoždění
vlaku je dle nastavených návazností řidiči návazného autobusového spoje odesílána
zpráva s pokynem na vyčkávání. V tomto režimu není možné provést navýšení čekací
doby.
1.2 Oprávnění dispečinku KODIS
Dispečink KODIS se podílí na řešení mimořádností v provozu, zajišťování přípojných
vazeb mezi vlakovými a autobusovými spoji a vede evidenci mimořádných provozních
stavů nebo omezení jednotlivých poskytovaných služeb.
Ve vztahu k řízení provozu je dispečink KODIS oprávněn po konzultaci
s dispečerským aparátem dopravce rozhodnout o zkrácení trasy vlakového spoje,
odřeknutí vlakového spoje, opoždění vlakového spoje, jízdě po odklonové trase,
mimořádném zastavení / průjezdu vlaku ve stanici / zastávce a případných dalších
opatřeních spojených s trasou vlaku.
Dispečink KODIS a dispečerský aparát dopravce jsou povinni se v rámci možností
řídit předem zpracovanými scénáři pro eliminaci provozních nepravidelností vydanými
KODISem ve spolupráci s dopravci.
2. Přípoje ve stanicích
Standard operativního řízení provozu definuje postup, kterým se zajišťují přípoje ve
stanicích. Ve smyslu tohoto standardu se za přípoje považují nejen vlaky osobní
dopravy, ale i návazné a přípojné autobusové spoje.
Ze zastávky či stanice, kde je stanoveno čekání na přípoj, lze provést odjezd
odchylně, tj. později od pravidelného jízdního řádu, a to v zájmu uspokojení
přepravních potřeb potenciálně přestupujících cestujících. Dopravce se přitom řídí
44
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
pomůckou „Čekací doby“, kdy bez souhlasu dispečera KODIS nepřekročí stanovenou
pravidelnou čekací dobu, výjimku tvoří důvody spojené s řízením provozu, které
nemůže dopravce ovlivnit.
2.1 Příprava podkladů pro operativní řízení
KODIS vypracuje pro Dopravce dokument „Čekací doby“, který upravuje čekání
Dopravce na přípojné spoje. Následně tento dokument postoupí Dopravci, který je
povinen takové čekání na přípojné spoje projednat s provozovatelem dráhy a
realizovat je dle rozhodnutí provozovatele dráhy k nejbližšímu možnému termínu
změn jízdních řádů.
Dokument „Čekací doby“ vychází ze služební pomůcky správce infrastruktury „Přípoje
mezi vlaky osobní dopravy“, přejímá terminologii, strukturu a základní grafickou
podobu. Nad rámec pomůcky správce infrastruktury jsou čekací doby rozlišeny na
pravidelné a mimořádné.
V případě pravidelné čekací doby není potřeba čekání na přípoj projednávat
s dispečinkem KODIS, v případě uplatnění mimořádné čekací doby je takové čekání
nutno schválit dispečinkem KODIS. V odůvodněných a mimořádných případech je
možno výjimečně překročit i mimořádnou čekací dobu, avšak každý jednotlivý případ
musí být potvrzen dispečinkem KODIS.
2.2 Operativní řízení v praxi
V praxi je vyčkávání na přípoje (vlaky osobní dopravy, návazné autobusové spoje a
přípojné autobusové spoje) řízeno níže uvedeným postupem:
Postup při zajišťování přípojů ve stanicích
1/ vlak jede včas
2/ vlak je mírně opožděn, postačuje stanovená pravidelná čekací doba
3/ vlak je opožděn, s ohledem na níže uvedené důvody je vhodné pravidelnou
čekací dobu prodloužit – je kontaktován dispečink KODIS, po schválením
dispečinkem KODIS se použije mimořádná čekací doba, o tomto použití se provede
záznam
4/ vlak je příliš opožděn, mimořádná čekací doba by nepostačovala -> přípoj je
rozvázán
Níže jsou uvedeny důvody pro použití mimořádné čekací doby:
Důvody pro použití mimořádné čekací doby
a/ významná přípojná vazba (očekává se přestup více cestujících, kteří tvoří
nezanedbatelný podíl z celkového počtu cestujících využívajících návazný vlak)
b/ významný počet přestupujících – prokazatelný (hlášený) vyšší počet
přestupujících cestujících
c/ vznik mimořádnosti nebo neočekávaného zpoždění těsně před příjezdem do
stanice s přípojem
d/ silné narušení grafikonu – povětrnostní vlivy, mimořádné události, extrémní
případy
45
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
Dopravce se zavazuje řídit dokumentem „Čekací doby“ a stanovené pravidelné čekací
doby dodržovat, pokud provozovatel dráhy nestanoví jinak. V případě požadavku
dispečinku KODIS na vyčkávání vlaku je dopravce povinen tomuto požadavku
vyhovět, pokud tomu nebrání objektivní důvody na straně řízení provozu
provozovatele dráhy.
2.3 Vyhodnocení provozu a kontrola
Vyčkávající spoje se nezahrnou do příslušných výkazů zpožděných spojů, bude-li
čekání a tomu odpovídající zpoždění oproti pravidelnému jízdnímu řádu odpovídat
parametrům uvedeným v příslušném dokumentu „Čekací doby“. V opačném případě,
dojde-li k nedovolenému navýšení čekací doby, a toto navýšení čekací doby nebude
projednáno s dispečinkem KODIS nebo dojde-li k rozvázání přípoje bez vyvinutí
přiměřeného úsilí při zajišťování návaznosti, vystavuje se Dopravce hrozbě udělení
sankce.
Dopravce poskytne na žádost KODIS sestavu vlaků s překročenou mimořádnou
čekací dobou. Dopravce dále na žádost Objednatele nebo KODIS prověří všechny
podněty k vyčkávání na přípojné autobusové a vlakové spoje.
46
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
SEZNAM ZKRATEK
BČK Bezkontaktní čipová karta ODISka nebo bezkontaktní bankovní
platební karta
BK Bezkontaktní bankovní platební karta
CS Centrální správa karetního systému Moravskoslezského kraje
CED Centrální dispečink
CIS Centrální informační systém o jízdních řádech
ČR Česká republika
DI Dopravní infocentrum
ES Evropské společenství
GPRS General packet radio service
GSM Globální systém pro mobilní komunikaci
HW Hardware
IMEI International mobile equipment identity (mezinárodní identita
mobilního zařízení)
KODIS Koordinátor ODIS s.r.o.
LCD Liquid crystal display (display z tekutých krystalů)
LED Light-emitting diode (dioda emitující světlo)
MHD Městská hromadná doprava
NAD Náhradní autobusová doprava
NFC Near Field Communication (modulární technologii radiové
bezdrátové komunikace mezi elektronickými zařízeními na velmi
krátkou vzdálenost (do 4 cm) s přiblížením přístrojů)
ODIS Integrovaný dopravní systém Moravskoslezského kraje ODIS
QR Quick Response (kód rychlé reakce pro automatizovaný sběr
dat)
SW Software
47
___K_o_o_rd_i_n_át_o_r_O_D_I_S__s._r_._o_.________T_e_c_h_ni_ck_é__a _p_ro_v_o_zn_í_s_ta_n_d_ar_d_y_O_D_I_S_
SEZNAM PŘÍLOH
Příloha č. 1: Základní technické parametry vozidel
Příloha č. 2: Popis zobrazování informací na vnitřních informačních panelech vozidel
Příloha č. 3: Procesy MSK
Příloha č. 4: Návrh datové věty pro MSK
Příloha č. 5: Platby bankovní kartou
Příloha č. 6: Struktura BČK Moravskoslezské karty
Příloha č. 7: Struktura 2D kodu pro jízdní doklady ODIS
Příloha č. 8: Komunikace s dispečinkem ODIS
Příloha č. 9: Sankce
Příloha č. 10: Zastávky náhradní autobusové dopravy (NAD)
Příloha č. 11: Greenlist MSK
Příloha č. 12: Yellowlist MSK
Příloha č. 13: Požadavky na provedení Testovacího provozu
Příloha č. 14: Výjimky z plnění bodů TPS
Příloha č. 15: Metodický pokyn k označení železničních kolejových vozidel a autobusů
NAD během výluk a omezení kapacity dráhy
Příloha č. 16: Zajištění propagace objednatele
48
Technické a provozní standardy ODIS – Příloha č. 1
Základní technické parametry vozidel
Tato příloha obsahuje základní technické parametry vozidel standardů ODIS 4,
ODIS 5 a ODIS 6. Pod standardem ODIS 4 jsou uvedeny parametry netrakční
jednotky Push-Pull, přičemž jsou doplněny další požadavky na dovybavení vozidla. U
standardu ODIS 4 jsou uvedeny další technické parametry vycházející z dostupných
údajů od současného dopravce, s ohledem na probíhající proces výroby vozidla jsou
u vybraných parametrů uvedeny výpočtové hodnoty. Standardy ODIS 5 a ODIS 6
definují minimální požadavky na vozidla v těchto standardech.
1. Požadavky na vozidla standardu ODIS 4, ODIS 5 a ODIS 6
vycházející z železniční infrastruktury
Všechna vozidla standardu ODIS 4 (vč. hnacích vozidel k netrakční jednotce), ODIS
5 a ODIS 6, jejich obsluha a vlaková četa musí být schopni zajišťovat provoz dle
navrženého jízdného řádu (zejména s ohledem na dynamiku jízdy a plnění jízdních
dob) na následujících tratích a úsecích:
- 323: Ostrava hl.n. – Frenštát pod Radhoštěm město
Všechna vozidla standardu ODIS 4 (vč. hnacích vozidel k netrakční jednotce), ODIS
5 a ODIS 6 a vybraný personál musí být schopni zajistit v případě potřeby (např.
z důvodu výlukové činnosti nebo dlouhodobě přerušeného provozu) jízdu vozidel po
odklonových trasách. V případě jízdy po odklonových trasách je možno uvažovat
jízdu vozidel v režimu tažených vozidel, tj. např. na závěsu hnacího vozidla
vybaveného vlakovým zabezpečovačem ETCS příslušné úrovně a specifikace. Klíčová
je zejména přechodnost vozidel pro daný traťový úsek. Jedná se o následující tratě a
jejich úseky:
- 271: Bohumín – Hranice na Moravě
- 280: Hranice na Moravě – Valašské Meziříčí
- 321: Ostrava-Svinov – Odb. Odra, Výh Polanka nad Odrou – Český Těšín
- 323: Ostrava hl.n. – Valašské Meziříčí
- 322: Frýdek-Místek – Český Těšín
Parametry příslušných tratí a traťových úseků (vč. podmínek přístupu na dráhu) jsou
dopravcům přístupné v Prohlášení o dráze (https://www.spravazeleznic.cz/
dopravci/prohlaseni-o-draze) a na Portálu provozování dráhy Správy železnic, s. o.
(https://provoz.spravazeleznic.cz/Portal).
1
1.1 Vozidla standardu ODIS 4
1.1.1 Rozměry vozidla (netrakční jednotky)
- Maximální vnější šířka vozů 2 800 mm
- Maximální výška od temene kolejnice 4 630 mm
- Délka jednotlivých vozů soupravy přes nárazníky / styčnou rovinu spřáhel
o Řídící vůz 26 950 mm
o Vložený vůz 26 400 mm
o Koncový vůz 26 410 mm
- Celková délka soupravy přes nárazníky 79 760 mm
- Rozvor vozů soupravy (vzdálenost krajních náprav) 21 900 mm
- Rozvor podvozků 2 400 mm
- Vzdálenost středů otočných podvozků 19 500 mm
- Délka převislého konce vozů (od středu otáčení podvozku)
o Řídící vůz přední (u kabiny) 4 000 mm
o Řídící vůz zadní 3 450 mm
o Vložený vůz 3 450 mm
o Koncový vůz přední 3 450 mm
o Koncový vůz zadní (u neprůchozího čela) 3 460 mm
- Průjezdný průřez
o Obrys vozidel Kinematický obrys DE2 podle ČSN EN 15273-2, příloha
L.2. Pouze antény radiostanice přesahují obrys DE2 a jsou uvnitř obrysu
Z-GCZ3.
1.1.2 Hmotnost vozidla (netrakční jednotky)
- Výpočtová konstrukční hmotnost v provozním stavu 150,6 t
o podle ČSN EN 15663
- Hmotnost na nápravu (výpočtová)
o Rozdíl zvážených hmotností na nápravu a na kolo v souladu s Vyhláškou
173/1995 v platném znění, příloha č. 3, část I, bod 10.2.3
o Řídící vůz, přední podvozek 13,4 t
o Řídící vůz, zadní podvozek 12,8 t
o Vložený vůz, přední podvozek 12,4 t
o Vložený vůz, zadní podvozek 12,2 t
o Koncový vůz, přední podvozek 12,4 t
o Koncový vůz, zadní podvozek 12,2 t
2
1.1.3 Minimální poloměr oblouku
Nejmenší jmenovitý poloměr oblouku koleje při průjezdu traťovou rychlostí je 150 m.
Tento parametr je závazný i pro hnací vozidla k netrakční jednotce.
1.1.4 Maximální rychlost 160 km/h
Maximální provozní rychlost netrakční jednotky min. 100 km/h
Maximální provozní rychlost pro soupravu
vč. hnacího vozidla
1.1.5 Brzdící procenta netrakční jednotky (v jednotlivých režimech brzdění)
o Výpočtová – reálná budou stanovena až na vyrobeném vozidle
o Dle ČSN EN 14198:2017
o Režim P: 105 - 125 %
o Režim R: 150 - 170 %
o Režim R+Mg min: 170 - 184%
1.1.6 Druh táhlového ústrojí
- Řídící vůz – přední čelo – táhlové ústrojí v souladu s ČSN EN 15566 a UIC 520
(šroubovka, tažný hák)
- Řídící vůz – zadní čelo – mezivozové centrální spřáhlo
- Vložený vůz – mezivozové centrální spřáhlo
- Koncový vůz – přední čelo – mezivozové centrální spřáhlo
- Koncový vůz – zadní čelo – táhlové ústrojí v souladu s ČSN EN 15566 a UIC
520 (šroubovka, tažný hák)
Táhlové ústrojí hnacího vozidla musí být uzpůsobeno k tažení (tlačení) netrakční
jednotky.
1.1.7 Vlakový zabezpečovač
Vůz je vybaven kompletní instalací mobilní části zabezpečovače ETCS level 2 (výrobce
Alstom Belgium SA), včetně příslušenství GSM-R, kompatibilní s infrastrukturní částí v
aktuální verzi (Baseline 3, SW verze 3.4 případně vyšší ve smyslu TSI CCS).
Národní zabezpečovač je MIREL VZ1, schválený pro provoz na tratích SŽDC a je
kompatibilní s traťovou částí LS. Dále je kompatibilní se systémem ETCS a použitým
rychloměrem (Hasler TELOC 3000).
Hnací vozidlo musí být vybaveno vlakovým zabezpečovačem v souladu s aktuálně
platnou legislativou, splňujícím všechny náležitosti pro bezpečný provoz na trati 323
v úseku Ostrava hl. n. – Frenštát pod Radhoštěm město.
3
1.1.8 Požadavky na komunikaci
Technická specifikace pro komunikaci hnacího vozidla se soupravou push-pull vychází
z UIC 558 (IRS 50558) a WTB ČD.
1.1.9 Průchodnost soupravou, přechod mezi vozy netrakční jednotky
Mezi jednotlivými vozy je umožněn volný pohyb cestujících pomocí dvouvrstvého
mezivozového přechodu, který je koncipován tak, aby umožňoval všechny provozní
pohyby při zachování maximálního prostoru pro cestující. Vnější povrch přechodu
obepíná i mezivozové spřáhlo. Mezivozový přechod plní zároveň funkci tepelné a
hlukové izolace. Mezivozový přechod je složen ze dvou polovin, při rozpojení vozů
zůstane na každém voze jedna polovina přechodu. Mezivozový přechod je utěsněn
proti vnikání vody, prachu a prachového sněhu dovnitř vozu.
Mezivozovým přechodem jsou vybavena obě čela vloženého vozu, zadní čelo řídícího
vozu a přední čelo koncového vozu. Přední čelo řídícího vozu a zadní čelo koncového
vozu jsou neprůchozí.
1.1.10 Schopnost vozidla (netrakční jednotky) se odstavit v režimu
aktivního odstavení (předtápění)
Během aktivního odstavení udržuje řídicí systém ve vozidle nezámrznou teplotu 5 °C
(ochrana proti zamrznutí vodního hospodářství) a ve spolupráci s odpovídající
lokomotivou zajistí také předtopení soupravy, podle provedení lokomotivy v
přednastavený čas. V aktivním odstavení je vozidlo zajištěno proti pohybu, v provozu
je osvětlení, klimatizace atd. Zrušení aktivního odstavení může být vyvoláno
strojvedoucím, nebo zásahem některé z předdefinovaných ochran (pohyb, ztráta VN,
požár…).
1.1.11 Počty míst v soupravě (netrakční jednotce)
- Počet míst k sezení 356, z toho 51 sklopných
sedadel
454
- Počet míst k stání 30
- Počet míst pro kola 4
- Počet míst pro invalidní vozíky 10
- Počet míst v 1. třídě
1.1.12 Počet informačních panelů netrakční jednotky a jejich specifikace
- Vnitřní tabule - 22 ks
Uvnitř vozů jsou použity dva druhy barevných displejů, které se liší úhlopříčkou – 10“
a 18“. V každém nástupním prostoru je umístěn jeden 10“ displej. V předním
nástupním prostoru koncového vozu tento displej slouží k ovládání informačního
systému soupravy vlakovou četou. Na obou koncích ostatních prostorů pro cestující
(spodní oddíl, horní oddíl, představek) je pak po jednom 18“ displeji. Výjimkou je
zadní představek vloženého vozu a koncového vozu a přední představek řídícího
vozu, kde je pouze po jednom displeji z důvodu menšího počtu sedadel. Na předním
4
představku řídícího vozu není žádný displej, protože je zde jen jedno sedadlo. Další
displej 18“ je na stěně univerzálního WC přiléhající k prostoru pro cestující na vozíku,
aby byla zajištěna viditelnost displeje pro tyto cestující bez nutnosti otáčet hlavu.
- Vnější tabule - 7 ks
Na předním čele řídícího vozu v horní části čelního skla je umístěna informační tabule
s možností zobrazení čísla linky a cílové stanice. Na obou bocích každého vozu je ve
střední části bočnice umístěna jedna tabule zobrazující číslo linky, cílovou stanici a
významné nácestné stanice. Při pohledu zvenčí vozidla jsou splněny požadavky
vyhlášky UIC 176 na minimální čitelnost.
1.1.13 Přístup do soupravy (netrakční jednotky) 12 (6 na každé straně)
- Počet nástupních dveří 1 300 mm
- Šířka nástupních dveří
1.1.14 Počet toalet (netrakční jednotky)
- Počet standardních toalet 4
- Počet bezbariérových toalet 1
1.1.15 Informační piktogramy a popisky uvnitř vozidla (netrakční jednotky)
Vozidlo je zevnitř i zvenku vybaveno piktogramy, které požadují příslušné předpisy
(např. TSI) nebo které usnadňují orientaci cestujících (např. piktogram kola či
kočárku u příslušných vstupních dveří). Důležité nápisy uvnitř vozu budou i v
Braillově písmu. Vnější označení vozidel odpovídá PN 28 0080 a vnitřní označení
vozidel odpovídá PN 28 0091.
1.1.16 Vnitřní dělení prostoru netrakční jednotky
Oddělení nástupního prostoru od oddílu pro cestující oddílovými dveřmi – NE
Oddělení jednotlivých vozů pomocí přechodových dveří – NE
Oddíl 1. třídy v řídícím vozu je od částí horního oddílu se sedadly 2. třídy oddělen
celoprosklenou tónovanou příčkou s křídlovými manuálně ovládanými dveřmi s
aretací zavřené polohy.
1.1.17 Větratelnost okny v případě poruchy klimatizace (netrakční
jednotky)
ANO – Nouzová ventilace v případě přerušení dodávky elektřiny ze zdroje VN je
provedena nouzovým chodem ventilátorů odsávání odpadního vzduchu napájením z
baterie dle UIC 553.
5
1.1.18 Vybavení vozidla (netrakční jednotky) kamerovým systémem
Řídicí vůz je vybaven dvěma vnějšími kamerami, které zajišťují strojvedoucímu
okamžitý přehled o dění kolem vlaku. Obraz z kamer je strojvedoucímu zobrazován
na displeji informačního systému. Zároveň je nasnímaný obraz i ukládán do
záznamové jednotky s ohledem na zákony a předpisy platné na území ČR.
Vozidlo je vybaveno kamerovým systémem v interiéru vozidla, po dopravci je
požadováno provozování kamerového systému, uchovávání kamerového záznamu v
souladu s platnou legislativou a v případě potřeby poskytnutí záznamu policii.
1.1.19 Řídicí systém a přenos diagnostických dat netrakční jednotky
Řídicí systém zahrnuje automatickou regulaci rychlosti, automatické vedení vlaku,
cílové brzdění a zařízení pro sběr a dálkový přenos dat z celé soupravy. Vůz je osazen
zařízením pro záznam jízdních dat dle EN 62625-1 a jednotkou pro sběr a přenos dat
v železniční bezdrátové přenosové síti s využitím datových sítí 4G. Jednotka také
zajišťuje on-line přenos vzniklých poruch na servisní server provozovatele
prostřednictvím mobilních datových sítí 4G, včetně sledování polohy satelitní navigace
s poskytováním údaje polohy a přesného času na vnitřní datové sběrnici vozidla.
Modem GPRS zajišťuje také komunikaci mezi soupravou a SW monitorování provozu
vozidel.
1.1.20 Soulad netrakční jednotky se standardy TSI
- TSI CCS
- TSI NOI
- TSI SRT, kategorie A
- TSI LOC&PAS
- TSI PRM
1.1.21 Standardy údržby netrakční jednotky – výrobcem udané cykly
preventivní údržby
- Provozní ošetření 25 000 km
- Periodická prohlídka malá 100 000 km
- Periodická prohlídka velká 300 000 km
- Periodická prohlídka vyvazovací 1 200 000 km
- Periodická oprava hlavní 2 400 000 km
1.1.22 Minimální doby pro technologické úkony (obrat soupravy)
Souprava (s kompatibilní lokomotivou) je po technické stránce schopna úvratě
(změny směru jízdy) v době čtyř minut pobytu ve stanici (v tomto čase není
započítána doba přesunu strojvedoucího mezi stanovišti).
6
1.2 Vozidla standardu ODIS 5
Vozidla standardu ODIS 5 tvoří soupravu složenou z jednotlivých vozidel/dílů
jednotky nebo jejich kombinace. Níže jsou uvedeny technické parametry požadované
soupravy. Rozhodujícím kritériem je, aby v rámci soupravy bylo dosaženo splnění
všech požadovaných standardů ODIS 5.
1.2.1 Rozměry vozidla
Maximální délka soupravy je stanovena na 120 metrů s ohledem na délku nástupišť
na předmětné trati
1.2.2 Minimální poloměr oblouku
Nejmenší jmenovitý poloměr oblouku koleje při průjezdu traťovou rychlostí je 150 m
1.2.3 Maximální rychlost min. 100 km/h
Maximální provozní rychlost
1.2.4 Vlakový zabezpečovač
Vozidlo musí být vybaveno vlakovým zabezpečovačem v souladu s aktuálně platnou
legislativou, splňujícím všechny náležitosti pro bezpečný provoz na trati 323 v úseku
Ostrava hl. n. – Frenštát pod Radhoštěm město.
1.2.5 Průchodnost soupravou, přechod mezi vozy
Celá souprava je koncipována jako průchozí, musí být umožněno cestujícím
procházet mezi jednotlivými vozy (články) soupravy i v průběhu jízdy.
1.2.6 Počty míst v soupravě min. 310, z toho max. 20 %
- Počet míst k sezení min. 16
sklopných min. 2
min. 1
- Počet míst pro kola min. 10
- Počet míst pro kočárky
- Počet míst pro invalidní vozíky
- Počet míst v 1. třídě
1.2.7 Počet informačních panelů a jejich specifikace
Vozidlo je vybaveno elektronickými informačními panely v souladu s Technickými a
provozními standardy ODIS.
1.2.8 Přístup do soupravy min. 12 (6 na každé straně)
Počet nástupních dveří
1.2.9 Počet toalet min. 2
Počet standardních toalet min. 1
Počet bezbariérových toalet
7
1.2.10 Informační piktogramy a popisky uvnitř vozidla
Vozidlo je zevnitř i zvenku vybaveno piktogramy, které požadují příslušné předpisy
(např. TSI) nebo které usnadňují orientaci cestujících (např. piktogram kola či
kočárku u příslušných vstupních dveří). Důležité nápisy uvnitř vozu budou i v
Braillově písmu.
1.2.11 Vnitřní dělení prostoru
Oddíl 1. třídy je od částí horního oddílu se sedadly 2. třídy oddělen příčkou nebo
jiným vhodným způsobem.
1.2.12 Větratelnost okny (v případě poruchy klimatizace)
Jednotka musí být určena pro provoz ve středoevropském klimatickém prostředí dle
ČSN EN 50 125-1, za předpokladu, že okolní teplota bude v rozmezí -25 až +40°C a
relativní vlhkost vzduchu max. 90% při +20°C
V případě poruchy klimatizace je v souladu s Technickými a provozními standardy
ODIS požadována větratelnost okny v prostoru oddílu pro cestující.
1.2.13 Řídicí systém a přenos diagnostických dat
Hnací vozidlo je vybaveno jednotkou pro sběr a přenos dat v železniční bezdrátové
přenosové síti s využitím datových sítí 4G. Jednotka zajišťuje on-line přenos
sledování polohy satelitní navigace s poskytováním údaje polohy a přesného času na
vnitřní datové sběrnici vozidla.
1.2.14 Minimální doby pro technologické úkony (obrat soupravy)
Souprava je po technické stránce schopna úvratě (změny směru jízdy) v době čtyř
minut pobytu ve stanici (v tomto čase není započítána doba přesunu strojvedoucího
mezi stanovišti).
1.2.15 Další požadavky
Souprava musí splňovat závazné normy a ustanovení příslušných vyhlášek UIC
nutných pro uvedení drážních vozidel do provozu v ČR.
Souprava umožní bezbariérový nástup do vozidla alespoň jedněmi dveřmi, současně
umožní nástup imobilních cestujících pomocí plošiny.
Je dbáno na zachování jednotného vzhledu v rámci soupravy - tj. sjednocení vnějšího
nátěru v rámci soupravy, v případě potřeby je nutné uvedení soupravy do
jednotného vzhledu. Návrh vnějšího vzhledu soupravy bude odsouhlasen
Objednatelem a KODIS.
Umístění informačních piktogramů na vozidlo je v režii dopravce, dopravce umisťuje
piktogramy po schválení KODISem, dopravce si piktogramy a jejich přesný vzhled
zajišťuje sám.
8
1.3 Vozidla standardu ODIS 6
Vozidla standardu ODIS 6 tvoří soupravu složenou z jednotlivých vozidel/dílů
jednotky nebo jejich kombinace. Níže jsou uvedeny technické parametry požadované
soupravy. Rozhodujícím kritériem je, aby v rámci soupravy bylo dosaženo splnění
všech požadovaných standardů ODIS 6.
1.3.1 Rozměry vozidla
Maximální délka soupravy je stanovena na 120 metrů s ohledem na délku nástupišť
na předmětné trati.
1.3.2 Minimální poloměr oblouku
Nejmenší jmenovitý poloměr oblouku koleje při průjezdu traťovou rychlostí je 150 m.
1.3.3 Maximální rychlost min. 80 km/h
Maximální provozní rychlost
1.3.4 Vlakový zabezpečovač
Vozidlo musí být vybaveno vlakovým zabezpečovačem v souladu s aktuálně platnou
legislativou, splňujícím všechny náležitosti pro bezpečný provoz na trati 323 v úseku
Ostrava hl. n. – Frenštát pod Radhoštěm město.
1.3.5 Počty míst v soupravě min. 240, z toho max. 20 % sklopných
min. 8
Počet míst k sezení min. 2
- Počet míst pro kola nepožadováno
- Počet míst pro kočárky nepožadováno
- Počet míst pro invalidní vozíky
- Počet míst v 1. třídě
1.3.6 Počet informačních panelů a jejich specifikace
Vozidlo je vybaveno elektronickými informačními panely v souladu s Technickými a
provozními standardy ODIS.
1.3.7 Přístup do soupravy min. 8 (4 na každé straně)
Počet nástupních dveří
1.3.8 Počet toalet min. 2
Počet standardních toalet nepožadováno
Počet bezbariérových toalet
1.3.9 Informační piktogramy a popisky uvnitř vozidla
Vozidlo je zevnitř i zvenku vybaveno piktogramy, které požadují příslušné předpisy
nebo které usnadňují orientaci cestujících (např. piktogram kola či kočárku u
příslušných vstupních dveří).
9
1.3.10 Větratelnost okny
Jednotka musí být určena pro provoz ve středoevropském klimatickém prostředí dle
ČSN EN 50 125-1, za předpokladu, že okolní teplota bude v rozmezí -25 až +40°C a
relativní vlhkost vzduchu max. 90% při +20°C.
V případě poruchy klimatizace je v souladu s Technickými a provozními standardy
ODIS požadována větratelnost okny v prostoru oddílu pro cestující.
V případě vozu bez klimatizace je v souladu s Technickými a provozními standardy
ODIS požadována adekvátní větratelnost okny v prostoru oddílu pro cestující.
1.3.11 Minimální doby pro technologické úkony (obrat soupravy)
Souprava je po technické stránce schopna úvratě (změny směru jízdy) v době čtyř
minut pobytu ve stanici (v tomto čase není započítána doba přesunu strojvedoucího
mezi stanovišti).
1.3.12 Další požadavky
Souprava musí splňovat závazné normy a ustanovení příslušných vyhlášek UIC
nutných pro uvedení drážních vozidel do provozu v ČR
Umístění informačních piktogramů na vozidlo je v režii dopravce, dopravce umisťuje
piktogramy po schválení KODISem, dopravce si piktogramy a jejich přesný vzhled
zajišťuje sám.
Souprava je alespoň částečně nízkopodlažní, tzn. disponuje úrovňovým nástupním
prostorem pro nástupiště ve výšce 550 mm nad TK, umožňující bezbariérový nástup
do vozidla dle platných TSI PRM.
10
Technické a provozní standardy ODIS – Příloha č. 2
Popis zobrazování informací na vnitřních informačních
panelech vozidel
1.1 Standardní průběh trasy
1. Při příjezdu vozidla do výchozí zastávky spoje a nástupu cestujících je zobrazeno
následující standardní schéma LCD informačního panelu:
Obr. 1a.
V hlavičce levé části informačního panelu je zobrazeno číslo linky ve formátu ODIS,
cílová zastávka spoje a aktuálně předpokládaný čas příjezdu spoje do cílové zastávky.
V prostoru pod hlavičkou jsou zobrazeny nejvýše 4 nejbližší nácestné zastávky spoje
včetně aktuální zastávky. U všech nácestných zastávek je stejně jako u cílové
zastávky uveden předpokládaný čas příjezdu, tzn. čas příjezdu dle jízdního řádu
navýšený o případné aktuální zpoždění spoje. V případě výchozí zastávky spoje je čas
příjezdu nahrazen časem odjezdu. Aktuální zpoždění spoje je možné získávat buď z
níže uvedené webové služby MPV NET, nebo přímo z palubního systému vozidla – v
tomto případě musí být hodnota zpoždění zaokrouhlována dolů na celé minuty. Po
levé straně jsou číselně a graficky znázorněny tarifní zóny (1 zastávka se může
nacházet nejvýše ve 4 tarifních zónách). Grafické znázornění tarifních zóny by mělo
být provedeno, pokud je to v dané situaci možné, tak, aby každá tarifní zóna byla v
rámci všech zobrazených zastávek znázorněna jednou barvou a v jednom sloupci (v
některých případech toto není možné dodržet).
2. Vždy po vjezdu do GPS okruhu zastávky, která je na informačním panelu zobrazena
ve žlutě podbarveném řádku (vyjma výchozí zastávky spoje), je u aktuální zastávky
odmazán čas předpokládaného příjezdu do zastávky:
1
Obr. 1b.
3. Vždy po výjezdu z GPS okruhu zastávky, která je na informačním panelu zobrazena
ve žlutě podbarveném řádku, je trasa o jednu zastávku posunuta vpřed.
4. Po výjezdu z GPS okruhu 5. zastávky od konce trasy spoje, tj. jakmile je ve žlutě
podbarveném řádku zobrazena 4., 3. či 2. zastávka od konce trasy spoje, již šipka
průběhu trasy neukazuje na cílovou zastávku spoje uvedenou v záhlaví, ale posouvá
se postupně dolů ukazujíc na cílovou zastávku spoje uvedenou v seznamu nácestných
zastávek dle následujícího vzoru:
Obr. 2.
5. Po výjezdu z GPS okruhu 2. zastávky od konce trasy spoje, tj. jakmile je ve žlutě
podbarveném řádku zobrazena poslední zastávka spoje, již šipka průběhu trasy není
zobrazena.
Obr. 3.
V případě, že vozidlo pokračuje průběžně s cestujícími na další spoj, bude po výjezdu
z GPS okruhu 2. zastávky od konce trasy stávajícího spoje následovat místo obr. 3
rovnou obr. 1a již s údaji následujícího spoje, na který vozidlo bezprostředně přejíždí.
2
6. Od vjezdu do GPS okruhu poslední zastávky spoje minimálně do doby zavření dveří
po výstupu cestujících bude v celé levé části informačního panelu vyjma hlavičky
zobrazen aktuální čas a definovaný text. Zároveň bude u cílové zastávky smazán údaj
o předpokládaném času příjezdu.
Obr. 4.
1.2 Další informace a stavy
• Tranzitní tarifní zóny
Jestliže se na trase spoje nacházejí tzv. tranzitní zóny, tzn. tarifní zóny, jimiž spoj
projíždí, ale nemá na jejich území žádnou zastávku a cestující v zónovém tarifu musí s
touto tarifní zónou na daném spoji počítat, zobrazí se tyto zóny na informačním
panelu následovně:
Obr. 5.
Může nastat také situace s několika tranzitními zónami za sebou:
Obr. 6.
Po výjezdu z GPS okruhu zastávky nacházející se v trase spoje bezprostředně před
tranzitní zónou, bude trasa na informačním panelu standardně posunuta o jeden
3
řádek, tranzitní zóny zůstanou zobrazeny po celou dobu průjezdu spoje těmito
zónami, avšak řádek se žlutým podbarvením bude posunut až na následující
zastávku:
Obr. 7.
Po vjezdu do GPS okruhu zastávky nacházející se v trase spoje bezprostředně po
tranzitní zóně, budou tranzitní zóny z informačního panelu odmazány a trasa
posunuta do standardního zobrazení s aktuální zastávkou v posledním řádku (viz obr.
1).
Uvedený postup zobrazení tranzitní zóny (tranzitních zón) je volitelně zobrazovanou
informací. Rozhodnutí o poskytnutí dodatečné informace v podobě zobrazení
tranzitních zón je ponecháno na dopravci.
• Zastávky na znamení
Zastávka na znamení bude na informačním panelu označena křížkem umístěným v
elipse symbolizující zastávku (viz obr. 1).
• Návazné spoje
V pravé části informačního panelu budou zobrazovány primárně návazné spoje z
vybraných zastávek. Společnost KODIS dodá seznam zastávek, u nichž budou
návazné spoje zobrazovány. U každé zastávky v seznamu bude definováno, ze
kterých zastávek / stanic, případně ze kterých jejich stanovišť budou návazné spoje
zobrazovány (může být kombinováno více zdrojů – např. autobusová a železniční
doprava – obr. 3).
Jestliže se některá ze 4 aktuálně zobrazovaných nácestných zastávek spoje nachází v
seznamu zastávek s návaznostmi, bude v seznamu zastávek pod názvem nejbližší z
nich zobrazen piktogram šipky s textem upozorňujícím na možné přestupy. Zároveň
bude název této zastávky se stejným piktogramem šipky zobrazen v hlavičce pravé
části informačního panelu. Níže bude zobrazen seznam nejvýše 6 návazných spojů z
definovaných stanovišť definovaných zastávek / stanic ve formátu: Alias linky (pokud
není uveden, tak celé číslo linky
/ vlaku), cílová zastávka, čas na přestup ve formátu „x min“, příp. „<1 min“, označení
stanoviště (pokud je uvedeno), ze kterého spoj odjíždí, případně symbol vlaku (viz
obr. 4).
4
Položka „čas na přestup“ je vypočítávána následovně:
����ř���������� = ����ř��á�� + ��∆��á�� − ����ř𝒂���� − ��∆𝒂����
����ř���������� − č𝑎�� ��𝑎 ��ř����������
����ř��á�� − č𝑎�� �������������� ��á��𝑎����éℎ�� ���������� ���� ��𝑎����á������ �� ��á��𝑎����������í ������ ��í������íℎ�� řá����
��∆��á�� − 𝑎������á����í ������ž��ě��í ��á��𝑎����éℎ�� ����������
����ř𝑎���� − č𝑎�� ��ří���������� ����������, �� ��ě��ž ���� ��𝑎��ℎá��í ������. ��𝑎������, ���� ��𝑎����á������ �� ��á��𝑎����������í ������ ��ř
��∆𝑎���� − 𝑎������á����í ������ž��ě��í ����������, �� ��ě��ž ���� ��𝑎��ℎá��í ������������𝑎č��í ��𝑎������
𝑷��������! 𝑴ůž�� ��𝒂����𝒂�� ��𝒂��é ��������𝒂����, ������ 𝒂������á����í �������� �������� ��ř���� ��ů��������í
𝒂 ��á��𝒂����ý �������� �������� ���� ��ů����������, �������� ��á������������í��í ������. 𝑻������ ���� ���������� ������������������ ����
��ý����č����.
Zobrazované spoje jsou řazeny vzestupně dle vypočtené hodnoty času na přestup.
Nejsou zobrazovány spoje, u nichž je vypočtená hodnota času na přestup menší než
0 min nebo větší než 99 min. Není zobrazován spoj, v němž se informační panel
nachází. U spojů, kde je vypočtená hodnota času na přestup 0 min, je zobrazována
jako „<1 min“.
• Dodatečné informace pro cestující
V případě, že v on-line datech webové služby http://www.mpvnet.cz/ u zastávky,
která je na informačním panelu zobrazena ve žlutě podbarveném řádku, je uveden
informační text příslušející stanovišti, do kterého spoj přijíždí, je tento text zobrazen v
pravé spodní části informačního panelu jako běžící se zprava doleva. Text překrývá
ostatní prvky a je zobrazen po celou dobu, kdy je v levém žlutě podbarveném řádku
zobrazena jemu odpovídající zastávka.
Obr. 8a.
5
Společnost KODIS může dodat dopravci informace pro cestující v elektronické podobě
(obrázky, videa v rozlišení 960 x 540 px), která budou v dohodnutém období
přehrávána na informačních panelech ve vozidlech na dohodnutých linkách.
Informace budou zobrazovány v pravé části informačního panelu v době, kdy
nebudou zobrazovány žádné návazné spoje. Jestliže bude pro danou linku určeno
více mediálních souborů, budou tyto přehrávány sekvenčně. Informace pro cestující
bude zobrazena přes celou plochu pravé části informačního panelu. Překryta bude
pouze zobrazením aktuálního času a případně běžícím informačním textem k aktuální
zastávce.
Obr. 8b.
Obr. 8c.
Jestliže není v informačním panelu nahrána žádná informace pro cestující a nejsou
aktuálně zobrazovány ani žádné návaznosti, je pravá polovina informačního panelu
prázdná, přičemž zveřejnění jakýchkoliv informačních materiálů na této části
informačního panelu podléhá schválení společnosti KODIS. (obr. 7).
6
• Dlouhé názvy zastávek
Jestliže je název zastávky delší, než prostor pro jeho zobrazení v dané velikosti fontu,
bude konkrétní text názvu zastávky zobrazen přiměřeně sníženou velikostí fontu tak,
aby název zastávky do daného prostoru beze zbytku vešel:
Obr. 9.
7
8
Popis webové služby http://www.mpvnet.cz/
Webová služba nabízí data o aktuálních odjezdech spojů ze zastávek v ODIS v datovém
formátu XML. Klient zadá dotaz v podobě webové adresy
http://www.mpvnet.cz/odis/x/ZZZZZZZ/?t=true&pz=true&pocet=PPP, kde ZZZZZZZ je až
7ciferné CIS číslo autobusové zastávky či číslo železniční zastávky a PPP je počet spojů, které
požaduje vypsat (jsou vypisovány spoje s odjezdy nejvýše za 300 min). Data jsou aktuální
vždy k času odeslání dotazu klienta. Pro aktualizaci dat je nutné provést nový dotaz.
Vzor XML pro dotaz http://mpvnet.cz/odis/x/47544/?t=true&pz=true&pocet=6:
<TBL cas="2016-04-29T13:48:52" ver="1.0.5962.27484" text="Ověřovací provoz. Bez
záruky.">
<t id="47544" stan="1,2" zast="Ostrava,Zábřeh,Hotel Bělský les" ciszast="47544">
<o stan="1" lin="27" alias="27" spoj="52" smer="Proskovice" odj="2016-04-
29T13:50:00+02:00" sled="true" zpoz="1" np="false" t="Autobus" pz="Sámova"/>
<o stan="1" lin="31" alias="31" spoj="12" smer="Výškovice" odj="2016-04-
29T13:52:00+02:00" sled="true" zpoz="1" np="true" t="Autobus" pz="Městský stadion"/>
<o stan="1" lin="96" alias="96" spoj="8" smer="Poliklinika" odj="2016-04-
29T13:53:00+02:00" sled="true" zpoz="0" np="false" t="Autobus" pz="Nádraží
Vítkovice"/>
<o stan="1" lin="48" alias="48" spoj="169" smer="Opavská" odj="2016-04-
29T13:55:00+02:00" sled="true" zpoz="0" np="true" t="Autobus" pz="Hrabůvka kostel"/>
<o stan="2" lin="59" alias="59" spoj="3" smer="Mírové náměstí" odj="2016-04-
29T13:55:00+02:00" sled="true" zpoz="5" np="true" t="Autobus" pz="Kulturní dům"/>
<o stan="2" lin="880641" alias="641" spoj="21" smer="Ostrava,ÚAN" odj="2016-04-
29T14:08:00+02:00" sled="true" zpoz="0" np="false" t="Bus" pz="Petřvald,u Ševčíků"/>
<i stan="47544 1 2">Tramvajová doprava ve směru na Dubinu je nahrazena autobusy,
které odjíždějí z autobusové zastávky směr Zábřeh.</i>
<i stan="47544 3">Z tohoto stanoviště odjíždí náhradní autobusová doprava za tramvajové
linky směr Dubina.</i>
</t>
9
</TBL>
Struktura XML:
• TBL (cas=“čas, k němuž jsou data aktuální“; ver=“verze sw“; text=“technická
poznámka“).
o t (id=“id zastávky“; stan=“stanoviště nacházející se na dané zastávce“;
zast=“název zastávky“; ciszast=“číslo zastávky“).
▪ o – odjezd spoje (stan=“označení stanoviště spoje“; lin=“číslo linky“;
alias=“číslo linky ve formátu ODIS“; spoj=“číslo spoje/vlaku“;
smer=“cílová zastávka spoje“; odj=“odjezd spoje dle jízdního řádu“;
sled=“true/false zda je spoj sledován on-line“; zpoz=“aktuální
zpoždění spoje v minutách, záporné zpoždění převádět na 0“;
np=“true/false zda je na spoj vypraveno bezbariérově přístupné
vozidlo“; t=“druh dopravy Tramvaj/Trolejbus/Autobus (tzn. MHD)/Bus
(tzn. PAD)/druh vlaku (Os/R/Sp...“; pz=“poslední zastávka spoje, z níž
je o spoji on-line informace“; info=“obsahuje text „nejede“, pokud byl
spoj provozní změnou zrušen“).
▪ i – informační text pro cestující (stan=“CIS číslo zastávky případně
doplněné o označení stanovišť, pro která je text určen – oddělováno
mezerami“; global="true").
Systém zobrazování informací na LCD monitoru musí být nastaven tak, aby bylo
možné vzhled softwarově upravovat.
10
Procesy MSK
Procesy MSK
Vlastník dokumentace: Koordinátor ODIS s.r.o.
Verze 9.3
6. 4. 2021
Vlastník dokumentace: Koordinátor ODIS s.ro. List 1/90
Procesy MSK
Obsah
INFORMACE O DOKUMENTU .................................................................................................................. 7
Historie změn ...................................................................................................................................... 7
Seznam použitých zkratek a výrazů..................................................................................................... 9
1 Obecně platné pro všechny dopravce........................................................................................... 11
1.1 Kontrola vůči blacklistu a greenlistu karet ............................................................................ 12
1.2 Kontrola jednoho časového kupónu ..................................................................................... 13
1.3 Zakoupení časového kupónu................................................................................................. 14
1.4 Dobití předplaceného časového kupónu .............................................................................. 15
1.5 Placení elektronickou peněženkou (EP) ................................................................................ 16
1.6 Dobití předplacené EP ........................................................................................................... 17
1.7 Dobití EP ................................................................................................................................ 18
1.8 Kontrola CP při nahrávání časových kupónů......................................................................... 20
1.8.1 Možné varianty karty a CP............................................................................................. 21
1.8.2 Postup změny CP na předprodejním místě ................................................................... 21
1.9 Možné kombinace přestupů v oblasti MĚSTO ...................................................................... 22
1.9.1 Cesta z REGIONU do MĚSTA, cestující zakupuje kilometrické jízdné ............................ 22
1.9.2 Cesta z MĚSTA, cestující zakupuje jednotkové jízdné ................................................... 23
1.10 Možné kombinace přestupů v oblasti REGION – REGION a MĚSTO A – MĚSTO B ............... 24
1.11 Spolucestující - dokupované jízdenky ................................................................................... 25
1.12 Předprodej............................................................................................................................. 25
1.12.1 Reklamační operace ...................................................................................................... 25
1.12.2 Prodej a nahrání časových kupónů................................................................................ 26
1.12.2.1 Držitel, který má kartu s CP pro dítě, který je platný max. do data 15ti narozenin
26
2 PAD ................................................................................................................................................ 27
2.1 Kontrola ve vozidlech PAD..................................................................................................... 27
2.2 Kontrola 2D kódu................................................................................................................... 28
2.3 Kilometrické jízdné (kontrola revizorem).............................................................................. 29
2.4 Zakoupení kilometrické jízdenky ........................................................................................... 30
2.4.1 Zakoupení žákovské nebo studentské kilometrické jízdenky – platí do 31. 8. 2018..... 31
2.4.2 Zakoupení kilometrické jízdenky ................................................................................... 32
Vlastník dokumentace: Koordinátor ODIS s.ro. List 2/90
Procesy MSK
2.5 Postup výpočtu jízdného ....................................................................................................... 33
2.5.1 Zadání řidičem ............................................................................................................... 33
2.5.2 Podklady pro zadání ...................................................................................................... 33
2.5.3 Výpočet jízdného ........................................................................................................... 33
2.5.3.1 Nástup ve výchozí zastávce V, výstup v cílové zastávce C......................................... 34
2.5.3.2 Nástup na stejném spoji, kdy cestující má jízdenku do cílové zastávky C1 a chce jet
do cílové zastávky C2................................................................................................................. 34
2.5.3.3 Nástup na stejné lince, ale jiném spoji...................................................................... 35
2.5.3.4 Nástup na jiném spoji i jiné lince............................................................................... 36
3 Velké MHD..................................................................................................................................... 40
3.1 Jednotkové městské jízdné.................................................................................................... 40
3.2 Zakoupení jednotkové městské jízdenky .............................................................................. 41
3.3 Postup výpočtu jízdného ....................................................................................................... 42
3.3.1 Odbavení Ostrava XXL - současný stav k 20.12.2012 .................................................... 42
3.3.1.1 Příklady ...................................................................................................................... 43
4 Malé MHD ..................................................................................................................................... 44
4.1 Kontrola ve vozidlech MHD (při nástupu předními dveřmi) ................................................. 44
4.2 Jednotkové městské jízdné.................................................................................................... 44
4.3 Zakoupení jednotkové městské jízdenky .............................................................................. 44
4.4 Zakoupení kilometrické jízdenky ........................................................................................... 44
4.5 Postup výpočtu jízdného ....................................................................................................... 45
4.5.1 Zadání řidičem ............................................................................................................... 45
4.5.2 Podklady pro zadání ...................................................................................................... 45
4.5.3 Výpočet jízdného ........................................................................................................... 45
4.5.3.1 MHD jízdenka ............................................................................................................ 45
4.5.3.2 Nástup na stejné lince, ale jiném spoji...................................................................... 46
4.5.3.3 Nástup na jiném spoji i jiné lince............................................................................... 47
5 Systém Check-in Check-out ........................................................................................................... 48
5.1 Jednotkové městské jízdné.................................................................................................... 48
5.2 Check –in ............................................................................................................................... 49
5.2.1 Check – in OV XXL ......................................................................................................... 49
5.2.2 Check –in pro XXL (353)................................................................................................. 51
5.2.3 MHD jízdenka (čl. 4.5.3.1) ............................................................................................. 52
5.2.4 Nástup na stejné lince, ale jiném spoji.......................................................................... 53
Vlastník dokumentace: Koordinátor ODIS s.ro. List 3/90
Procesy MSK
5.2.5 Nástup na jiném spoji i jiné lince................................................................................... 54
5.2.6 Nástup ve výchozí zastávce V, výstup v cílové zastávce C (původní 2.4.3.1) ................ 55
5.3 Check -out.............................................................................................................................. 56
5.3.1.1 Nástup ve výchozí zastávce V, výstup v cílové zastávce C při použit Check-out ...... 58
5.3.1.2 Nástup ve výchozí zastávce V, výstup v cílové zastávce C a pokračování na lince X2
spoji Y2 při použití Check-out.................................................................................................... 58
5.4 Check- out pro XXL (353) ...................................................................................................... 60
5.4.1.1 Nástup ve výchozí zastávce V, výstup v cílové zastávce C při použit Check-out pro
XXL (353) 61
5.5 Check -out –Příměsto ............................................................................................................ 62
5.5.1.1 Nástup ve výchozí zastávce V, výstup v cílové zastávce C při použit Check-out ...... 63
5.5.1.2 Nástup ve výchozí zastávce V, výstup v cílové zastávce C , kdy část trasy je částečně
pokrytá platnou zónou a čas od prvního do posledního úseku nepokrytého kupónem
nepřekročí stanovený čas pro krátkou jízdenku........................................................................ 64
5.6 Check -out –Příměsto pro XXL (353)...................................................................................... 65
5.7 Přikoupení jízdenek ............................................................................................................... 67
6 Železniční dopravci ........................................................................................................................ 69
6.1 Kontrola v ŽD ......................................................................................................................... 69
6.1.1 Kontrola benefitu ODIS Prima (Momentálně není použito. ) ....................................... 69
6.2 Kilometrické jízdné (kontrola revizorem/obsluhou) ............................................................. 69
6.2.1 Km + zónové jízdné na POP ........................................................................................... 69
6.2.2 Km + zónové jízdné zakoupené BK formou tzv. režimu capping................................... 69
6.2.3 Dokupované jízdné zakoupené na samoobslužném terminálu v rámci Yellowlistů ..... 70
6.3 Zakoupení kilometrické jízdenky ........................................................................................... 70
6.4 Výpočet jízdného ................................................................................................................... 70
6.5 I. etapa................................................................................................................................... 71
6.5.1 Km + zónové jízdné na POP ........................................................................................... 71
6.5.1.1 Trasa jako posloupnost stanic – km vzdálenosti ....................................................... 71
6.5.1.2 Nástup ve výchozí zastávce, výstup v cílové zastávce ............................................... 72
6.5.1.3 Trasa jako posloupnost zón – odbavení pouze na BČK ............................................. 72
6.5.1.4 Kombinace trasy jako posloupnost zón a km tzv. lomený tarif – odbavení pouze
na BČK 72
6.5.2 Km + zónové jízdné UNIPOK .......................................................................................... 73
6.5.2.1 Prodej a nahrání časového kupónu na POP .............................................................. 73
Vlastník dokumentace: Koordinátor ODIS s.ro. List 4/90
Procesy MSK
6.5.2.2 Prodej a nahrání časového kupónu na UNIPOK ........................................................ 73
6.5.3 Km + zónové jízdné na samoobslužném terminálu (push-pull soupravy) ..................... 73
6.5.3.1 Nákup jízdného pro spolucestující (zavazadla) na samoobslužném terminálu......... 74
6.6 II. etapa.................................................................................................................................. 74
7 Platba bankovní kartou ................................................................................................................. 74
7.1 Diagram procesu odbavení cestujícího v Regionu na bankovní kartu .................................. 75
7.2 Diagram procesu variable fare .............................................................................................. 78
7.3 Diagram procesu odbavení jízdenky MĚSTO nebo „check-in“ pro Ostrava XXL nebo XXL
(zóna 353) cestujícího ve vozidle PAD na bankovní kartu................................................................. 79
7.4 Proces odbavení cestujícího ve vozidlech s nástupem všemi dveřmi (např. DPO), pro oblast
OV XXL a XXL (353) s časovým kupónem na bankovní kartě............................................................. 82
7.5 Check-out OV XXL na BK pro PAD......................................................................................... 85
8 Odbavení virtuální ODISky............................................................................................................. 88
8.1 Diagram procesu odbavení cestujícího v PAD na Virtuální ODISku....................................... 88
8.2 Proces odbavení cestujícího ve vozidlech DPO po 20.hodině s nástupem předními dveřmi.
90
Obrázky
Obrázek 1: Kontrola vůči blacklistu karet.............................................................................................................. 12
Obrázek 2: Kontrola jednoho časového kupónu.................................................................................................... 13
Obrázek 3: Zakoupení časového kupónu............................................................................................................... 14
Obrázek 4 Zakoupení časového předplaceného kupónu ....................................................................................... 15
Obrázek 5: Placení EP............................................................................................................................................ 16
Obrázek 6 Kredit předplacené EP .......................................................................................................................... 17
Obrázek 7: Kredit EP.............................................................................................................................................. 18
Obrázek 8: Kontrola CP při nahrání časových kupónů........................................................................................... 20
Obrázek 9: Možnosti přestupu v oblasti MĚSTO ................................................................................................... 22
Obrázek 10: Přestup v oblasti MĚSTO – kilometrické jízdné ................................................................................. 22
Obrázek 11: Přestup v oblasti MĚSTO – jednotkové jízdné ................................................................................... 23
Obrázek 12: Možnosti přestupu v oblasti REGION-REGION a MĚSTO A-MĚSTO B................................................ 24
Obrázek 13: Přestup v oblasti REGION-REGION a MĚSTO A-MĚSTO B ................................................................. 24
Obrázek 14: Kontrola ve vozidlech PAD, Malé MHD a ŽD ..................................................................................... 27
Obrázek 15: Kontrola QR ve vozidlech PAD, Malé MHD a ŽD ............................................................................... 28
Obrázek 16: Kilometrické jízdné (kontrola revizora) ............................................................................................. 29
Obrázek 17 -Zakoupení kilometrické jízdenky - obecně ........................................................................................ 30
Obrázek 18: Zakoupení žákovské nebo studentské kilometrické jízdenky............................................................. 31
Obrázek 19: Zakoupení kilometrické jízdenky ....................................................................................................... 32
Obrázek 20: Nástup ve výchozí zastávce V, výstup v cílové zastávce C................................................................. 34
Vlastník dokumentace: Koordinátor ODIS s.ro. List 5/90
Procesy MSK
Obrázek 21: Nástup na stejném spoji, cestující má jízdenku do cílové zastávky C1 a chce jet do cílové zastávky C2
.............................................................................................................................................................................. 34
Obrázek 22: Nástup na stejné lince, ale jiném spoji .............................................................................................. 35
Obrázek 23: Nástup na jiném spoji i jiné lince....................................................................................................... 36
Obrázek 24: Jednotkové městské jízdné................................................................................................................ 40
Obrázek 25: Zakoupení jednotkové městské jízdenky ........................................................................................... 41
Obrázek 26: MHD jízdenka.................................................................................................................................... 45
Obrázek 27: Nástup na stejné lince, ale jiném spoji .............................................................................................. 46
Obrázek 28: Nástup na jiném spoji i jiné lince....................................................................................................... 47
Obrázek 29 Check - in OV XXL ............................................................................................................................... 49
Obrázek 30 Check - in pro XXL (353)...................................................................................................................... 51
Obrázek 31: MHD jízdenka.................................................................................................................................... 52
Obrázek 32: Nástup na stejné lince, ale jiném spoji .............................................................................................. 53
Obrázek 33: Nástup na jiném spoji i jiné lince....................................................................................................... 54
Obrázek 34: Nástup na jiném spoji i jiné lince....................................................................................................... 55
Obrázek 35: Check out .......................................................................................................................................... 57
Obrázek 36: Výstup s Check out ............................................................................................................................ 58
Obrázek 37: Výstup Check out po přestupu .......................................................................................................... 59
Obrázek 38 Check-out pro XXL (353) ..................................................................................................................... 60
Obrázek 39: Výstup s Check out pro XXL (353)...................................................................................................... 61
Obrázek 40 Check-out - Příměsto .......................................................................................................................... 63
Obrázek 41: Výstup s Check out - Příměsto ........................................................................................................... 63
Obrázek 42 Nástup ve výchozí zastávce V1, výstup v cílové zastávce C1, kdy část trasy je částečně pokrytá
platnou zónou ....................................................................................................................................................... 64
Obrázek 43 Check - out Příměsto pro XXL (353) ................................................................................................... 66
Obrázek 44: Přikoupení jízdenek ........................................................................................................................... 68
Obrázek 45. Km + zónové jízdné zakoupené BK formou tzv. režimu capping........................................................ 69
Obrázek 46.Dokupované jízdné zakoupené na samoobslužném terminálu v rámci Yellowlistů ........................... 70
Obrázek 47: Nástup ve výchozí zastávce V, výstup v cílové zastávce C................................................................. 72
Obrázek 48. Diagram procesu odbavení cestujícího v Regionu na bankovní kartou............................................. 76
Obrázek 49. Diagram procesu variable fare.......................................................................................................... 78
Obrázek 50. Odbavení jízdenky MĚSTO nebo „check-in“ pro Ostrava XXL nebo XXL (zóna 353)cestujícího ve
vozidle PAD............................................................................................................................................................ 80
Obrázek 51. Proces odbavení cestujícího ve vozidlech DPO pro oblast OV XXL a XXL (353) s časovým kupónem
na bankovní kartě ................................................................................................................................................. 83
Obrázek 52. Check-out OV XXL pro PAD na BK...................................................................................................... 86
Obrázek 53. Diagram procesu odbavení cestujícího v PAD na bankovní kartou ................................................... 89
Obrázek 54. Proces odbavení cestujícího ve vozidlech DPO po 20.hodině s nástupem předními dveřmi............. 90
Vlastník dokumentace: Koordinátor ODIS s.ro. List 6/90
INFORMACE O DOKUMENTU Procesy MSK
Historie změn Autor
Holešovský
Datum Verze Stav
Skuhra
05. 08. 2010 0.0 Draft dokumentu Skuhra
Skuhra
24. 08. 2010 1.0 Opravy a doplnění Skuhra
26. 08. 2010 Holešovský
1.1 Opravy a doplnění připomínek KODIS Holešovský
01. 09. 2010 Skuhra
1.2 Opravy a doplnění na základě připomínek KODIS Holešovský
16. 09. 2010 Holešovský
12. 10. 2010 1.3 Vypořádané připomínky KODIS Videnková
25. 10. 2010 Skuhra
09. 11. 2010 1.4 Zapracování připomínek ME a KODIS Holešovský
Skuhra
23. 11. 2010 1.5 Změna v procesech + doplněny komentáře Videnková
Videnková
24. 11. 2010 1.6 Zrušena kapitola – postup výpočtu jízdného Videnková
30. 11. 2010 Skuhra
27. 01. 2011 Zapracování připomínek ME – oprava formulací, Skuhra
14. 07. 2011 1.7 doplnění odbavení žáků a studentů a úprava Skuhra
20. 01. 2012 vývojových diagramů Skuhra
08. 02. 2012 Skuhra
09. 02. 2012 1.8 Doplněny vysvětlivky a komentáře Skuhra
Skuhra
09. 02. 2012 2.0 Finalizace dokumentu Skuhra
Skuhra
09. 02. 2012 2.1 Zapracování připomínek ME Skuhra
13. 02. 2012 Skuhra
2.2 Zapracování připomínek EMT, ME
12. 03. 2012 List 7/90
2.3 Zapracování připomínek EMT, ME, ODP, CHAPS
13. 03. 2012
3.0 Změna členění dokumentu
02. 04. 2012
3.1 Zapracování připomínek KODIS
03. 04. 2012
06. 04. 2012 3.2 Dílčí změny struktury dokumentu – připomínky
KODIS
11. 04. 2012
3.3 Zapracování připomínek KODIS
3.4 Zapracování etapy 2 do ŽD
3.5 Úprava procesů dle dohody zainteresovaných
stran a upřesnění textů
3.6 Zapracování připomínek KODIS
3.9 Zapracování připomínek ME, Chaps a upřesnění
KODIS
4.0 Verifikace změn a upřesnění diagramů a textů
4.1 Oprava chyby v procesu - obrázek č. 6
4.2 Oprava drobných nepřesností a vypuštěn text
kap ŽD (do upřesnění)
Vlastník dokumentace: Koordinátor ODIS s.ro.
11. 04. 2012 4.3 Zapracování návrhu textu pro ŽD Procesy MSK
4.12.2013
4.12.2013 4.4 Rozšíření o Check-in, Cherck-out Skuhra
5.12.2013 Nenka
17.2.2014 4.5 Editace, úpravy Kubašta
4.3.2014 Kubašta
15.5.2014 4.6 Editace, úpravy Kubašta
24.6.2015 Nenka
24.6.2015 4.7 Rozšíření o předplacené transakce Nenka
17.8.2015 Nenka
26.8.2015 4.8 Úprava diagramu Check-out Nenka
26.8.2015 Nenka
31.8.2015 4.8 Upřesnění popisu Check-out Nenka
28.10.2015 Nenka
31.1.2016 5.4 Vyjmutí kontroly CP u zápisu z GL Nenka
1.2.2016 Nenka
3.2.2016 5.5 Úprava formátování a poznámky k CP Nenka
11.1.2017 Nenka
6.6.2017 5.6 Doplnění Check-out pro příměsto Nenka
8.6.2017 Nenka
16.6.2017 5.7 Úprava Check-out pro příměsto Nenka
8.7.2018 Nenka
5.8 Úprava Check-out pro příměsto Nenka
12.7.2018 Nenka
5.9 Úprava Check-out pro příměsto
12.7.2018 Nenka
6.0 Úprava Check--in
13.7.2018 Nenka
12.8.2018 6.1 Úprava hodnoty coupon type při kontrole
16.9.2019 Nenka
22.9.2019 6.2 Doplnění platby bankovní kartou Nenka
30.9.2019 Nenka
4.10.2019 6.3 Doplnění vysvětlivek u platby bankovní kartou Nenka
10.10.2019 Nenka
1.11.2019 6.5 Upřesnění času pro přestup a výše ZS Nenka
10.2.2020 Nenka
20.2.2020 6.6 Upřesnění procesu odbavení z GL Nenka
4.3.2020 Nenka
6.7 Zapracování revizí ME Nenka
Nenka
6.8 Úprava názvu kapitoly dobití kupónu
List 8/90
6.9 Úprava procesů pro slevy na jízdném 75%
7.0 Zapracování připomínek KODIS k procesům pro
slevy na jízdném 75%
7.1 Zapracování připomínek KODIS k procesům pro
slevy na jízdném 75%
7.2 Změna roku v tabulce změn
7.3 Změna roku zóny 780 na 353
7.4. Úprava kontroly zam. jízdného, aktualizace ŽD
7.5 Přenesení kap. 5.14 k procesů BK
7.6 Úprava procesu check-in pro odbavení BK v XXL
7.7 Úprava procesu check-out pro odbavení BK
7.8 Doplnění zobrazování fotografie při odbavení BK
7.9 Upřesnění názvu kapitol
8.0 Doplněno odbavení QR kódu
8.1 Doplněna poznámka o kontrole QR
8.2 Úprava vývojového diagramu 7.3
Vlastník dokumentace: Koordinátor ODIS s.ro.
27.3.2020 8.3 Zrušení doplatku ODISkou 7.3 Procesy MSK
8.4.2020
28.4.2020 8.4 Zrušení doplatku EP v obr. 7.3 Nenka
4. 5 2020 Nenka
5. 5 2020 8.5 Doplnění procesů na virtuální Odisku Nenka
20. 5 2020 Nenka
25. 5 2020 8.6 Úprava procesů na virtuální Odisku Nenka
9. 9 2020 Nenka
11. 9 2020 8.7 Úprava vyhodnocení fotografie u Virt. Odisky Nenka
Nenka
30. 3 2021 8.8 Doplnění zobrazení graf. prvku ve VO Nenka
Nenka
30. 3 2021 8.9 Doplnění zobrazení graf. prvku ve 2D
Nenka
6. 4 2021 9.0 Upřesnění odbavení na BK pro ŽD
Nenka
9.1 Úprava procesu kontrola 2D kódu
9.2 Doplnění, že zařízení musí znát všechny zastávky
ODIS v CIS
9.2 Doplnění, že zařízení musí znát všechny zastávky
ODIS v CIS
9.3 Úprava nadpisu Diagram procesu odbavení
cestujícího v PAD a ŽD…..
Seznam použitých zkratek a výrazů
Zkratka, výraz Význam
BČK Bezkontaktní čipová karta, která je použita jako nosič informací týkajících se odbavení
cestujících.
BlackList Soubor zakázaných karet a SAM
Dennylist Seznam zakázaných BK pro použití v dopravě
Taplist Seznam BK, které byly přiloženy k odbavovacímu zařízení
Tokenizace Zašifrování čísla BK
ČD České dráhy a.s.
EMT EM test ČR spol. s r.o.
Karta ODIS Karta používaná v IDS Moravskoslezského kraje - ODIS
KODIS Koordinátor ODIS, s.r.o.
ME Mikroelektronika spol. s r.o.
MSK Moravskoslezský kraj
ODIS Integrovaný dopravní systém Moravskoslezského kraje
MHD Městská hromadná doprava
PAD Příměstská automobilová doprava
SAM Secure Access Module, bezpečnostní modul
EP Elektronická peněženka
POP Odbavovací a prodejní zařízení vlakové čety v ŽD
Vlastník dokumentace: Koordinátor ODIS s.ro. List 9/90
Procesy MSK
Zkratka, výraz Význam
UNIPOK Prodejní terminál přepážky ŽD
BK Bankovní karta
Retail Standardní platba BK na obchodním terminálu
Použití platby BK, kdy skutečné zúčtování probíhá na konci dopravního dne, hlídá
Capping stropování
Železniční doprava
ŽD Soubor zakoupených kupónů a dobití EP přes e-Shopy všech dopravců
GreenList Soubor kupónů na karty ODISka nebo seznam karet ODISka (WLO)
Whitelist ODISka Seznam BK včetně profilů (WLB)
Whitelist BK Seznam jízdenek zakoupených přes samoobslužný terminál v Push_pull
Yellowlist
VO Virtuální ODISKa
GP Grafický prvek ( u virtuální ODISKy)
Vlastník dokumentace: Koordinátor ODIS s.ro. List 10/90
Procesy MSK
Procesy
V dokumentu jsou procesy rozděleny na několik kategorií a to podle typu dopravce:
• Obecně platné pro všechny dopravce,
• Příměstská automobilová doprava (PAD),
• Velká MHD,
• Malé MHD,
• Železniční dopravci (ŽD).
Je-li v procesech níže uváděná základní sazba (ZS), řídí se její výše vždy aktuálně platným tarifem, i
když je v procesech uveden jiný číselný příklad.
Je-li v procesech níže uváděn čas pro přestup, řídí se délka času pro přestup vždy aktuálně platným
tarifem, i když je v procesech uveden jiný číselný příklad, např. 30 min. apod.
1 Obecně platné pro všechny dopravce
Jedná se o procesy, které platí pro všechny dopravce.
V případě, že se na kartě nenachází žádný platný profil, bude vždy práce s kartou ukončena.
Všichni dopravci pracují s „Greenlistem“ což jsou zakoupené časové kupóny a dobitá EP přes E-shop,
a to tak, že na karty tyto časové kupóny nahrávají. Zpracování a nastavení Greenlistu bude
definováno v samostatném dokumentu.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 11/90
1.1 Kontrola vůči blacklistu a greenlistu karet Procesy MSK
Přiložení karty List 12/90
Je karta Ano
na blacklistu? Karta blokována
Ne
Setřídit záznamy greenlistů pro
danou kartu dle čísla
transakce vzestupně
Je karta Ano Dobití předplacené
na greenlistu EP?
EP
Ne
Je karta Ano Dobití
na greenlistu předplaceného
Kuponu? kuponu
Ne
Čtení dopravní
aplikace
Obrázek 1: Kontrola vůči blacklistu karet
Poznámka:
- Proces předchází procesům
o Kontrola ve vozidlech PAD, MHD a ŽD
o Zakoupení kilometrické jízdenky
o Zakoupení jednotkové městské jízdenky
o Zakoupení časového kupónu
o Dobití EP
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
1.2 Kontrola jednoho časového kupónu
READ_CARD_INFO Časový kupón
(PublisherProviderID nebo
HolderID= vozidlu dopravce)
Ne Odpovídá Ano Jedná se READ_ALL_TICKETS
dopravce? o zaměstnanecký (CouponType = 4)
časový kupón?
Ano Ne
contractHasJourney 0
2 Síťová jízdenka
Kontrola zón
Výpočet jízdného Ne Jsou všechny
úseky trasy
pokryty?
Ano
Signalizace OK;
zobrazení časového
kupónu
Obrázek 2: Kontrola jednoho časového kupónu
Poznámka:
- Pokud je více trasy pokryto několika časovými kupóny tak se do ceny počítá vždy ten nejlevnější
o Jsou odečteny všechny úseky trasy, na které jsou platné časové kupóny (i kdyby byly
některé úseky pokryty více časovými kupóny) a jízdné se počítá jen z nepokrytých úseků trasy“.
o Z časového kupónu jsou započteny použité zóny.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 13/90
1.3 Zakoupení časového kupónu Procesy MSK
Časový kupón Cestující požádá o časový
kupón zadáním zón
Volný soubor Ne Není prostor
seasonTicketFile? na kartě
Ano
Neplatná karta Ne Karta platná? READ_CARD_INFO
(ověření podpisu, kontrola
Ano
Kontrola CP platnosti karty a
cestujícího publisherNetworkID = 203811)
(viz. kap. 1.8) READ_CARD_HOLDER_INFO
(holderProfile1 nebo
holderProfile2 musí
odpovídat požadované
jízdence)
Neplatí pro Výpočet ceny
zaměstnanecký jízdného
časový kupón
Platba EP nebo
hotově WRITE_TICKET
(couponType = 0
Zápis časového contractHasJourney = 2
kupónu na kartu (zónový kupón) nebo
contractHasJourney = 0
(síťová jízdenka)
+ zápis seasonTicketInfo
dle MSKarta)
Ne - 1x Úspěšný Ne - 2x CANCEL_DEBET Neplatí pro
zápis? zaměstnanecký
časový kupón
Ano
Signalizace OK; Vadná karta,
Tisk dokladu Reklamace
Obrázek 3: Zakoupení časového kupónu List 14/90
Poznámky:
- V případě platby hotovostí odpadá volání funkce CANCEL_DEBIT
- Časový kupón se zapisuje na první volný soubor (č. 0-3, starý nebo „prázdný“)
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
1.4 Dobití předplaceného časového kupónu
Kontrola vůči
greenlistu kupónů
Volný soubor Ne Není prostor
seasonTicketFile na kartě
? READ_CARD_INFO
(ověření podpisu, kontrola
Ano platnosti karty a
publisherNetworkID = 203811)
Neplatná karta Ne Karta platná?
Zápis
Nelze dobít Kupon Větší než na Ano CouponsPrepaidTransaction
greenlistu z greenlistu na kartu
couponsPrepai WRITE_CARD_INFO
dTransaction WRITE_TICKET
(couponType = 0
na kartě contractHasJourney = 2 (zónový
kupón) nebo contractHasJourney =
Menší než na 0 (síťová jízdenka) + zápis
greenlistu seasonTicketInfo dle MSKarta)
Zápis
CouponsPrepaidTransaction
Zápis časového
kupónu na kartu
Ne Přiložte správnou kartu
Stejná jako pro dokončení
původní? operace.
Nedokončený
Ano Pravděpodobně došlo zápis Ano
Přiložena k předčasnému
karta? odebrání karty. Přiložte Úspěšný
kartu opět ke čtečce zápis?
Ne
Ne - 2x
Stornováno/ Ne
timeout?
Ano Vadná karta, Signalizace OK;
Reklamace Tisk dokladu
Neúspěšný zápis
Obrázek 4 Zakoupení časového předplaceného kupónu List 15/90
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
Poznámky:
- Časový kupón se zapisuje na první volný soubor (č. 0-3, starý nebo „prázdný“)
1.5 Placení elektronickou peněženkou (EP)
Platba EP
DEBET EP DEBIT_PURSE
Úspěšný debet
Obrázek 5: Placení EP
Poznámky:
- při platbě EP není nutné číst soubory Personalizační aplikace
- kontrola zda je samNumber na blacklistu, není nutná
- položka baseCurrencyEP by měla být hodnota ‘1000‘B – CZK v haléřích
- není třeba číst soubory nastavení EP před provedením debetu EP, vše kontroluje SAM
- pokud je některá z hodnot walletStatus a Status souboru EP různá od 7, tak nelze provést debet EP
- status souboru walletSettingsFile = 7 kontroluje SAM
- EP není přenosná mezi cestujícími,
- Každá jízdenka z EP je zlevněná jízdenka (sleva)
Vlastník dokumentace: Koordinátor ODIS s.ro. List 16/90
Procesy MSK
1.6 Dobití předplacené EP
Kontrola vůči
greenlistu EP
Neplatná karta Ne Karta platná? READ_CARD_INFO
(ověření podpisu, kontrola
platnosti karty a
publisherNetworkID = 203811)
Ano
Nelze dobít EP walletPersCreditT Vyčtení nastavení EP, tedy:
ransaction na READ_WALLET_PERSONAL_
Větší než na kartě SETTINGS
greenlistu
Menší než na Zápis
greenlistu walletPersCreditTransaction
z greenlistu na kartu
Nelze dobít EP Ne Odpovídá limit dobití? WRITE_WALLET_PERSONAL
(min. dopravce _SETTINGS
- 2000,- Kč)
CREDIT_PURSE
Ano
Zápis
walletPersCreditTransaction
Zápis EP
Ano Přiložte správnou kartu
Ne pro dokončení
operace.
Stejná jako
původní?
Nedokončený
Pravděpodobně došlo zápis
k předčasnému
Přiložena odebrání karty. Přiložte Úspěšný Ano
Ano karta? zápis?
kartu opět ke čtečce
Ne Ne
Stornováno/ Ne
timeout?
Ano Vadná karta, Úspěšný kredit
Neúspěšný zápis Reklamace Tisk dokladu
Obrázek 6 Kredit předplacené EP List 17/90
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
Poznámka:
- Proměnná „StatusEP“:
o status souboru walletSettingsFile = 7 kontroluje SAM
- SAM kontroluje:
o status souboru walletSettingsFile = 7
o je debet povolen(allowedDebet)
o nejsou překročeny hodnoty maxValueEP
o není překročena platnost EP
- EP je na kartě aktivována
1.7 Dobití EP
Kredit EP
Neplatná karta Ne Karta platná? READ_CARD_INFO
(ověření podpisu, kontrola
Ano
platnosti karty a
Nelze dobít EP Ne Odpovídá limit dobití? publisherNetworkID = 203811)
(min. dopravce
- 2000,- Kč) CREDIT_PURSE
Ano
Kredit EP
Úspěšný kredit List 18/90
Tisk dokladu
Obrázek 7: Kredit EP
Poznámka:
- Proměnná „StatusEP“:
o status souboru walletSettingsFile = 7 kontroluje SAM
o soubor walletPersonalSettingsFile není nutné číst
- SAM kontroluje:
o status souboru walletSettingsFile = 7
o je debet povolen(allowedDebet)
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
o nejsou překročeny hodnoty maxValueEP,
o není překročena platnost EP
- EP je na kartě aktivována
Vlastník dokumentace: Koordinátor ODIS s.ro. List 19/90
Procesy MSK
1.8 Kontrola CP při nahrávání časových kupónů
V rámci nahrání časového kupónu
je provedena kontrola CP
Odpovídá CP1 a je Ne
platný?
READ_CARD_HOLDER_INFO Ano PublisherProviderID
CP1 = nebo HolderID =
zaměstnanecký CP? dopravce
Ano
Ne Odpovídá Ne
dopravce?
Ano Odpovídá CP2
Ano a je platný?
Ne
Je konec platnosti
časového kupónu
menší než konec Ne
platnosti CP +29 dní?
Ano Odmítnutí nahrání
WRITE_TICKET časového kupónu
Je provedeno nahrání
časového kupónu na kartu
Obrázek 8: Kontrola CP při nahrání časových kupónů
Poznámky:
- Lze nahrát časový kupón maximálně 29 dnů po platnosti CP, v případě, že zařízení neprodává, ale
pouze nahrává kupón (zakoupený přes e-shop), není potřeba provádět kontrolu CP.
- Za správnost nahrání CP si zodpovídá držitel karty a obsluha, která CP nahrává.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 20/90
Procesy MSK
- V případě kontroly zam. jízdného – pokud Vydavatel karty není zároveň zaměstnavatel, probíhá zápis a
kontrola zaměstnavatele (dopravce) v položce HolderID
1.8.1 Možné varianty karty a CP
Určení karty Profil CP1 Profil CP2
Předdefinovaný - výroba Platnost Platnost
karty
Specifické profily Dle žádosti Do platnosti karty - - - - - -
Žákovský Do doby platnosti (D) 1 Od data D + 1 až
Studentský 2, 4, 5, 51, 52 dokladu, případně do platnosti karty
karty
Zaměstnanecká karta Do věku 15 let
Anonymní karta 19 Do doby platnosti 2
Zvíře dokladu Do platnosti karty
Do doby platnosti
3 Do doby platnosti 1
dokladu dokladu nebo
do platnosti karty
9, 49, 55, 56, Do platnosti karty 2, 3, 4, 5, 19,
57, 58, 59 nebo smlouvy zam. 51, 52 - - -
- - -
63 Do platnosti karty - - -
17 Do platnosti karty - - -
Tabulka 1 - Možné varianty karet a CP
Varianty karet a profilů se řídí aktuálním číselníkem KODIS.
1.8.2 Postup změny CP na předprodejním místě
Na předprodejních místech bude postupováno následovně:
• Žadatel předloží nárok na slevový profil formou příslušného dokladu dle smluvních
přepravních podmínek. Zaměstnanecké slevy lze uplatnit pouze u svého zaměstnavatele
(dopravce) a doba platnosti profilu je dle jeho zam. podmínek,
• V případě použití zaměstnaneckých slev probíhá kontrola tak, že pokud je zaměstnavatel
zároveň také vydavatelem, kontroluje se podle položky PublisherProviderID. V případě, že
zaměstnavatel není zároveň vydavatelem karty, je nutno použít položku HolderID, kde se
zapíše kód dopravce/zaměstnavatele. Do CC MSK bude zaslána změna profilu dle věty KODIS
• V případě Anonymní karty nebo zvířete, nelze profil měnit nebo jakkoliv upravovat,
• Změna CP se zapíše na kartu dle výše uvedené tabulky (Tabulka 1 - Možné varianty karet a
CP).
Vlastník dokumentace: Koordinátor ODIS s.ro. List 21/90
1.9 Možné kombinace přestupů v oblasti MĚSTO Procesy MSK
REGION MĚSTO REGION
ZS
ZS
ZS
Jednotková cena, přestup
zcela zdarma, bez ZS
Jednotková cena, přestup
zcela zdarma, bez ZS
Obrázek 9: Možnosti přestupu v oblasti MĚSTO
1.9.1 Cesta z REGIONU do MĚSTA, cestující zakupuje kilometrické jízdné
1. spoj Po nástupu do vozidla je
zaznamenán přestupní čas,
tj. výstupní čas + 30 min
+ aktuální zpoždění
Přestup, kdy cílová Pak se jedná o přestup, kdy
zastávka leží mimo
Ne cílová zastávka leží uvnitř
oblast daného
MĚSTA, tj. km tarif oblasti daného MĚSTA,
Ano tj. jednotkový tarif bez ZS
2. spoj Ověřen nárok na odečet ZS
= bez základní sazby
Obrázek 10: Přestup v oblasti MĚSTO – kilometrické jízdné
Vlastník dokumentace: Koordinátor ODIS s.ro. List 22/90
Procesy MSK
1.9.2 Cesta z MĚSTA, cestující zakupuje jednotkové jízdné
1. spoj Po nástupu do vozidla je
zaznamenán přestupní
čas, tj. nástupní čas (doba
označení) + 30 min. (čas je
volitelný dle PŘ MHD)
Přestup, kdy cílová Pak se jedná o přestup, kdy
cílová zastávka leží uvnitř oblasti
zastávka leží mimo Ne
oblast daného daného MĚSTA, tj. je použit
jednotkový tarif bez ZS
MĚSTA, tj. je použit
km tarif
Ano
Uplynulo Ne Žádný odečet
již 30 nebo tarif bez ZS
Ověřen nárok na odečet ZS minut
= bez základní sazby
2. spoj (v km tarifu)
Ano
Jde fakticky o nový nástup,
tj. dojde k novému označení,
nákupu nového jízdného
Obrázek 11: Přestup v oblasti MĚSTO – jednotkové jízdné
Vlastník dokumentace: Koordinátor ODIS s.ro. List 23/90
Procesy MSK
1.10 Možné kombinace přestupů v oblasti REGION – REGION a MĚSTO A –
MĚSTO B
Cesta z REGIONU do REGIONU, nebo z MĚSTA A do MĚSTA B, cestující zakupuje kilometrické jízdné
REGION REGION MĚSTO A MĚSTO B
ZS ZS
MHD km tarif
ZS ZS
km tarif MHD
Obrázek 12: Možnosti přestupu v oblasti REGION-REGION a MĚSTO A-MĚSTO B
1. spoj Po nástupu do vozidla je
zaznamenán přestupní čas,
tj. výstupní čas + 30 min
+ aktuální zpoždění
Přestup, kdy cílová Ne Pak se jedná o přestup, kdy cílová
zastávka leží
zastávka leží uvnitř oblasti daného
kdekoliv mimo
oblast daného MĚSTA, tj. jednotkový tarif
MĚSTA, tj. km tarif
Ano
Uplynulo Ne Žádný odečet
již 30 nebo tarif bez ZS
minut
Ověřen nárok na odečet ZS
2. spoj = bez základní sazby
v km tarifu
Ano
Jde fakticky o nový nástup,
tj. dojde k novému označení,
nákupu nového jízdného
Obrázek 13: Přestup v oblasti REGION-REGION a MĚSTO A-MĚSTO B List 24/90
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
Zjednodušeně:
Jde prakticky o stejné postupy, jako jsou uvedeny ve variantě 2, viz výše. Jen je zde zdůrazněno, že
platí stejné postupy jak v případě přestupu REGION – REGION, tak v případě přestupu MĚSTO A –
MĚSTO B.
1.11 Spolucestující - dokupované jízdenky
Spolucestující nemůže využít výhod držitele karty. Držitel karty však může zakoupit jízdenku z jeho EP.
Taková jízdenka se však na kartu nezapisuje.
Držitel může zakoupit buďto papírovou „hromadnou jízdenku“ pro všechny spolucestující najednou
nebo jednotlivě pro každého cestujícího zvlášť.
Výše uvedené neplatí pro v MHD Ostrava (zóna 354), kde se dokupované jízdenky řídí pravidly
uvedenými v kapitole 5.5
1.12 Předprodej
Předprodejní místa budou zajišťovat tyto služby:
1. Nahrávání a změny aktuálního CP (celý, dětský, žák aj.) dle struktury a číselníku MSK
2. Plnění EP
3. Nahrávání časových kupónů
4. Uznávání časových kupónů na pokladnách UNIPOK (viz. čl. Železniční doprava)
5. Výdej, prodej a reklamace MSK
6. Reklamace jízdného
Reklamační převody časových kupónů, EP budou prováděny vždy s „příznakem“ REKLAMACE nebo
budou prováděny na zvláštním reklamačním zařízení.
1.12.1 Reklamační operace
Reklamační operace musí obsahovat:
1. Převod EP z vadné/zablokované karty na novou
- číslo karty vadné/zablokované
- číslo karty nové, na kterou je převod proveden
- číslo operace
- převedená částka
2. Vyrovnání EP z důvodu předchozí nesprávné transakce (např. neuznání odečtu ZS)
Vlastník dokumentace: Koordinátor ODIS s.ro. List 25/90
Procesy MSK
- číslo transakce, při které došlo k nesprávné operaci
- vyrovnaná částka
- číslo karty
3. Vrácení alikvotní částky za neprojetý časový kupón
- číslo karty
- číslo transakce, při kterém byl časový kupón nahrán
- vymazání (zneplatnění) časového kupónu z karty
- vrácená alikvotní část a to buď na EP nebo v hotovosti
- poplatek za reklamační proces buďto z EP nebo v hotovosti
4. Vyplacení částky z EP v hotovosti
- číslo karty
- vymazání vyplacené částky z EP
- výše vymazané částky
- poplatek za reklamační proces buďto z EP nebo v hotovosti
1.12.2 Prodej a nahrání časových kupónů
Na karty se nahrávají časové kupóny dle číselníku se správným přiřazeným číslem „tarif number“.
Časové kupóny se nahrávají s max. platností 29 dnů přesahující platnost daného profilu.
Časové kupóny je možno nahrát s přesahem platnosti karty. Po ukončení platnosti karty pak bude
cestujícímu možno zůstatek karty včetně kupónu přehrát na kartu novou nebo vyplatit v hotovosti
v rámci reklamace.
Časový kupón lze nahrát jak z EP tak v Hotovosti.
1.12.2.1 Držitel, který má kartu s CP pro dítě, který je platný max. do data 15ti narozenin
Držitel přijde zakoupit časový kupón: 28.9.2012
Den narozenin: 1.10.2012
Délka platnosti časového kupónu: max. 30 dní
Platnost časového kupónu: 28.9.2012 - 27.10.2012
Vlastník dokumentace: Koordinátor ODIS s.ro. List 26/90
2 PAD Procesy MSK
2.1 Kontrola ve vozidlech PAD READ_ALL_TICKETS
(čtení všech kupónů z karty)
Čtení
season TicketFile READ_TICKET
(čtení jednoho kupónu)
Odpovídá Ne Neplatný kontrakt
verze a status
souboru?
Ano
Ne contractNetwork Kontrola transportní sítě
=203811
Ano
Ne Je kontrakt Kontrola contractValidity
časově platný?
Ano
Ne Odpovídá
seasonTicketContract?
Ano
Neplatný kontrakt
1 a 3 couponType 0 a 4
2
Výpočet jízdného Jednotkové Km jízdné Časový kupón
městské jízdné Zaměstnanecký
Obrázek 14: Kontrola ve vozidlech PAD, Malé MHD a ŽD
Poznámky:
- čtení jednoho souboru na testovacím pracovišti trvá cca 0.5 vteřiny, čtení všech 5 souborů cca 1.2
vteřiny, jaký postup čtení se zvolí, záleží na dodavateli odbavovacího zařízení
- při rychlém čtení ve vozidlech PAD a ŽD není nutné číst soubory Personalizační aplikace
Vlastník dokumentace: Koordinátor ODIS s.ro. List 27/90
Procesy MSK
- není distribuován Blacklist SAM, bude prováděna kontrola transakcí v clearingu a v případě odhalení
transakce na zakázaný SAM, bude provedena blokace karty
2.2 Kontrola 2D kódu
Čtení QR kódu
Kontrola Ne
podpisu
Ano OK Ne
Zobrazení údajů z QR: Je kontrakt Vizuální kontrola
platnost, nástup, časově jízdenky obsluhou
výstup, CP, číslo QR. platný?
Zobrazení grafického na mobilním
prvku zařízení cestujícího
Souhlasí kód Ne
pro výpočet
barvy
Souhlasí
Ano vizuální
Ano kontrola Ne
obsluhou
Odbavení OK Odmítnutí
odbavení
Zaslání dat o Zaslání dat o
odbavení odmítnutí
Obrázek 15: Kontrola QR ve vozidlech PAD, Malé MHD a ŽD
Poznámky:
- Zobrazení CP - vypsat na obrazovce obsluze název CP, nikoli číslo.
- Popis zobrazení grafického prvku je uveden v dokumentu
MSK_026_Struktura_2D_kódu_pro_jízdní_doklady_ODIS. List 28/90
- V případě časově neplatného kontraktu obsluha zohlední možné zpoždění
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
- zařízení zapíše uznání jízdenky (antipassback) na celou trasu a v případě opakovaného použití na
aktuálním linkospoji, zařízení odmítne odbavení.
- pro vyhodnocení kódu musí zařízení znát všechny zastávky systému ODIS v číselníku CIS
2.3 Kilometrické jízdné (kontrola revizorem)
Kilometrické jízdné
contractHasJourney 1
3 Vizuální kontrola
Kontrola v BUS jízdenky s údaji
v POP ve vlaku
Odpovídá číslo Ne Ne Odpovídají údaje
spoje? jízdenky?
Ano Ano
Signalizace OK, Neplatná jízdenka Odsouhlasení jízdenky,
Zobrazení kupónů Potvrzení v POP
Obrázek 16: Kilometrické jízdné (kontrola revizora)
Vlastník dokumentace: Koordinátor ODIS s.ro. List 29/90
2.4 Zakoupení kilometrické jízdenky Procesy MSK
Kilometrická Cestující požádá o km jízdenku;
jízdenka zadá výstupní zastávku,
případně nástupní zastávku.
Cestující požádá o Tarif žák nebo Ne Zakoupení km
tarif žák nebo student student? jízdenky – ostatní
Řidič provede vizuální
Ano (bez CP 3 a 19)
kontrolu dokladu (viz. kap. 2.4.2)
Předložil cestující Ne
doklad? Nastav default
CP
Ano
Řidič zadá
příslušný tarif
Zakoupení km
jízdenky - žák
nebo student
(viz. kap .2.4.1)
Obrázek 17 -Zakoupení kilometrické jízdenky - obecně
Poznámky:
- Platí do 31. 8. 2018.
- Km jízdenka se zapisuje pouze do souboru č. 4 na kartě (poslední soubor)
o Časové kupóny se nebudou zapisovat do souboru č. 4
- nástupní nebo výstupní zastávka mimo zóny MĚSTO
- km jízdenka je přestupní v rámci ČD
Vlastník dokumentace: Koordinátor ODIS s.ro. List 30/90
Procesy MSK
2.4.1 Zakoupení žákovské nebo studentské kilometrické jízdenky – platí do 31. 8. 2018
Kilometrická jízdenka
– žák nebo student
Čtení READ_TICKET
seasonTicketFile (čtení souboru č. 4)
Ne Nárok na odečet Ano Ověření
základní sazby? contractTransferEndDate
Nezapočtení contractTransferEndTime
Započtení základní sazby
základní sazby READ_CARD_HOLDER_INFO
CP = (3 nebo 19)
Je CP žák nebo Ne
student?
Ano Výpočet ceny
obyčejného jízdného
Výpočet ceny
jízdného
Je platba z EP? Ne Platba v hotovosti;
Tisk dokladu
Ano
Platba EP
Zápis km jízdenky WRITE_TICKET
na kartu (couponType = 2
contractHasJourney = 1 pro ČD
Ne - 1x Úspěšný Ne - 2x contractHasJourney = 3 pro BUS
zápis? + zápis seasonTicketInfo dle MSKarta)
CANCEL_DEBET
Ano
Signalizace OK; Vadná karta,
Tisk dokladu Reklamace
Obrázek 18: Zakoupení žákovské nebo studentské kilometrické jízdenky List 31/90
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
2.4.2 Zakoupení kilometrické jízdenky
Kilometrická
jízdenka – ostatní
Čtení READ_TICKET
seasonTicketFile (čtení souboru č. 4)
Ověření
contractTransferEndDate
contractTransferEndTime
Ne Nárok na odečet Ano
základní sazby?
Započtení Nezapočtení
základní sazby základní sazby
Načtení CP pro READ_CARD_HOLDER_INFO
výpočet jízdného
Výpočet ceny
jízdného
Je platba z EP? Ne Platba v hotovosti;
Tisk dokladu
Ano
Platba EP
Zápis km jízdenky WRITE_TICKET
na kartu (couponType = 2
contractHasJourney = 1 pro ČD
contractHasJourney = 3 pro BUS
+ zápis seasonTicketInfo dle MSKarta)
Ne - 1x Úspěšný Ne - 2x CANCEL_DEBET
zápis?
Ano
Signalizace OK; Vadná karta,
Tisk dokladu Reklamace
Obrázek 19: Zakoupení kilometrické jízdenky
Vlastník dokumentace: Koordinátor ODIS s.ro. List 32/90
Procesy MSK
2.5 Postup výpočtu jízdného
2.5.1 Zadání řidičem
• Nástupní stanice
• Cílová stanice,
• Typ jízdného (občan, dítě, student, zavazadlo aj. v případě platby v hotovosti. V případě BČK
bude typ jízdného zadáván jen v případě žák nebo student, nebo jiného zlevněného jízdného)
• Počet cestujících (jen při požadavku hromadného lístku bez zápisu na BČK)
• Typ platby (v případě hotovostní platby)
• První lístek vždy vydáván v autovýdeji - pouze pro držitele, contract = 1
2.5.2 Podklady pro zadání
Trasa vedena jako posloupnost stanic/zón. Ke každé stanici nutná přiřazená zóna.
• V případě odbavení z EP se trasa počítá jako posloupnost stanic tzn. dle vzdálenosti km.
Z posloupnosti stanic budou vytvořeny úseky trasy:
o Jeden úsek je část trasy mezi bezprostředně navazujícími stanicemi,
o Ke každému úseku budou zaznamenány/generovány následující údaje:
délka úseku - vzdálenost mezi určujícími stanicemi,
o Úsek trasy bude vždy generován pouze mezi stanicemi, kde spoj staví
o do km úseku trasy se počítají vzdálenosti mezi zastávkami, přes které spoj projíždí
• V případě odbavení na časový kupón je trasa jako posloupnost zón
o Cestující musí platit také zónu, kterou linka/spoj projíždí, ale nestaví v ní, tzn. zóny
dle JŘ daného spoje a linky, ale v případě, že daná linka/spoj v určité zóně nestaví, ale
zónou pouze projíždí, musí být zóna taktéž zavedena v JŘ
uvedena jako průjezdná zóna
o Taková průjezdná zóna bude v jízdním řádu součástí trasy, tedy jako „bod na trase“
s příslušným příznakem
2.5.3 Výpočet jízdného
Trasa jako posloupnost stanic – km vzdálenosti
Odbavení na BČK – držitel karty autovýdej
o Řidič zadá nástupní, výstupní stanici
o zařízení spočítá vzdálenost mezi zadanými stanicemi dle JŘ
o zařízení vypočítá cenu dle vzdálenosti, ceníku a CP
o odbavení proběhne v autovýdeji - řidič nepotvrzuje odbavení
o lomený tarif pouze u autovýdeje
Vlastník dokumentace: Koordinátor ODIS s.ro. List 33/90
Procesy MSK
o zařízení zapíše platnost jízdenky (antipassback) a nárok na zvýhodněný přestup
(bez základní sazby) – čas výstupní stanice dle JŘ + aktuální zpoždění +30 minut
2.5.3.1 Nástup ve výchozí zastávce V, výstup v cílové zastávce C
Obrázek 20: Nástup ve výchozí zastávce V, výstup v cílové zastávce C
Uložení na kartu (jízdenka J1):
• Linka X
• Spoj Y
• Nástupní zastávka
• Výstupní zastávka
• PlatnostOd = akt. čas
• PlatnostDo = čas výstupu (v zastávce C) + akt. zpoždění
• Čas pro přestup = čas výstupu (v zastávce C) + akt. zpoždění + čas na přestup
2.5.3.2 Nástup na stejném spoji, kdy cestující má jízdenku do cílové zastávky C1 a chce jet
do cílové zastávky C2
Obrázek 21: Nástup na stejném spoji, cestující má jízdenku do cílové zastávky C1 a chce jet do cílové zastávky C2
Uložení na kartu při 1. nástupu (jízdenka J1):
• Linka X
• Spoj Y
• Nástupní zastávka
• Výstupní zastávka
• PlatnostOd = akt. čas
• PlatnostDo = čas výstupu (v zastávce C1) + akt. zpoždění
• Čas pro přestup = čas 1. výstupu (v zastávce C1) + akt. zpoždění + čas na přestup
Vlastník dokumentace: Koordinátor ODIS s.ro. List 34/90
Procesy MSK
Uložení na kartu při 2. nástupu (Jízdenka J2 cena bez ZS):
• Linka X
• Spoj Y
• Nástupní zastávka
• Výstupní zastávka
• PlatnostOd = akt. čas (v zastávce C1)
• PlatnostDo = čas výstupu (v zastávce C2) + akt. zpoždění
• Čas pro přestup = čas 2. výstupu (v zastávce C2) + akt. zpoždění + čas na přestup
Příklad:
Cestující nastoupí v zastávce V1 v 14:30 a jede do zastávky C1 (čas výstupu 15:10), čas přestupu je 30
min. Na kartu se tedy uloží jízdenka J1
• Linka X
• Spoj Y
• PlatnostOd = 14:30
• PlatnostDo = 15:10 (+příp. zpoždění)
• Čas pro přestup = 15:10 + 0:30 (+příp. zpoždění) = 15:40
Poté co dojede do zastávky C1 v 15:10, tak chce pokračovat po tom samém spoji do zastávky C2.
Při nástupu na zastávce C1 (C1=V2, C1 je nově výchozí zastávka), proběhne kontrola platné jízdenky.
V tomto případě je stejná linka, spoj i datum nového nástupu, jen aktuální čas je větší než PlatnostDo,
na kartu se tedy uloží nová jízdenka J2 (aktuální čas je menší než čas na přestup, takže cena bude
bez ZS).
2.5.3.3 Nástup na stejné lince, ale jiném spoji
Obrázek 22: Nástup na stejné lince, ale jiném spoji List 35/90
Uložení na kartu při 1. nástupu (jízdenka J1):
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
• Linka X
• Spoj Y
• Nástupní zastávka
• Výstupní zastávka
• PlatnostOd = akt. čas (v zastávce V1)
• PlatnostDo = čas výstupu (v zastávce C1) + akt. zpoždění
• Čas pro přestup1 = čas 1. výstupu (v zastávce C1) + akt. zpoždění + čas na přestup
Uložení na kartu při 2. nástupu (jízdenka J2):
• Linka X
• Spoj Y2
• Nástupní zastávka
• Výstupní zastávka
• PlatnostOd = akt. čas (v zastávce V1)
• PlatnostDo = čas výstupu (v zastávce C1) + akt. zpoždění
• Cena v případě, že
o Aktuální čas je menší než čas pro přestup1: cena=bez ZS
o Aktuální čas je větší než čas pro přestup1: cena=s ZS
• Čas pro přestup2 = čas 2. výstupu (v zastávce C1) + akt. zpoždění + čas na přestup
2.5.3.4 Nástup na jiném spoji i jiné lince
Obrázek 23: Nástup na jiném spoji i jiné lince List 36/90
Uložení na kartu při 1. nástupu (jízdenka J1):
• Linka X
• Spoj Y
• Nástupní zastávka
• Výstupní zastávka
• PlatnostOd = akt. čas (v zastávce V1)
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
• PlatnostDo = čas výstupu (v zastávce C1) + akt. zpoždění
• Čas pro přestup1 = čas 1. výstupu (v zastávce C1) + akt. zpoždění + čas na přestup
Uložení na kartu při 2. nástupu (Jízdenka J2):
• Linka X2
• Spoj Y2
• Nástupní zastávka
• Výstupní zastávka
• PlatnostOd = akt. čas (v zastávce V2)
• PlatnostDo = čas výstupu (v zastávce C2) + akt. zpoždění
• Cena v případě, že
o Aktuální čas je menší než čas pro přestup1: cena=bez ZS
o Aktuální čas je větší než čas pro přestup1: cena=s ZS
• Čas pro přestup2 = čas 2. výstupu (v zastávce C2) + akt. zpoždění + čas na přestup
V případě, že po dobu antipassbacku přistoupí např. další cestující, může být odbaven z EP držitele
karty, ale pouze na papírový lístek bez zápisu na kartu a bez nároku na zvýhodněné jízdné!
Odbavení v hotovosti
o Řidič zadá nástupní, výstupní stanici a typ jízdného (celý, dítě, zavazadlo aj.)
o zařízení spočítá vzdálenost mezi zadanými stanicemi dle JŘ
o zařízení vypočítá cenu dle vzdálenosti, ceníku a typu jízdného dle zadání řidičem
o zadá řidič „typ platby v hotovosti“
o po té proběhne odbavení, vytiskne se papírová jízdenka bez nároku na přestup
o jízdenka se na KARTU NEZAPISUJE
Trasa jako posloupnost zón – odbavení pouze na BČK
o Řidič zadá nástupní, výstupní stanici
o po přiložení BČK zkontroluje a vyhodnotí platnosti, rozsah aj. zón na kartě (náležitosti
spojené se čtením časových kupónů) – Vyhodnotí se platnost po celé trase na celý úsek
o v zařízení se ZKONTROLUJE zda SRN (seriové číslo) a zóny, na které byla uznána jízda
na daném spoji už nebyly použity. Pokud ANO, pak celá trasa je dokupovaný lístek - platí
km. Po změně spoje se zruší. Na kartu se nic nezapisuje, do statistiky se poznačí jen
jednou - kontrola v souboru použitých karet (neplatí pro ŽD - kontrola bude záviset
na obsluze)
o odbavení proběhne automaticky
o při odbavení na časový kupón se nárok na přestup nezapisuje
Vlastník dokumentace: Koordinátor ODIS s.ro. List 37/90
Procesy MSK
o STORNO - při stornování lístků z BČK je potřeba kontrolovat, zda není poznačená jízda -
smazat
Kombinace trasy jako posloupnost zón a km tzv. lomený tarif – odbavení pouze na BČK
1. Počátek trasy je zaplacen zónou, zbytek doplacen za km
• Řidič zadá nástupní, výstupní stanici
• zařízení porovná trasu s platnými zónami na kartě
• V případě shody odbaví stanice shodné se zónami na kartě a k tomu dopočítá trasu v km
a to z poslední stanice zaplacené zóny do výstupní stanice.
Př. Trasa vede z bodu A do D
A=1 zóna B=2 zóna C=3 zóna D=4 zóna
Cestující má na kartě časový kupón pro zónu 1 a 2.
Postup:
• Řidič zadá nástupní stanici A, výstupní stanici D
• Zařízení odbaví z bodu A do B na časový kupón, z bodu B do D spočítá jízdné v km ceníku dle
CP
• zařízení zapíše platnost jízdenky (antipassback) a nárok na zvýhodněný přestup (bez základní
sazby) – čas výstupní stanice dle JŘ + aktuální zpoždění + 30 minut
2. Střed trasy pokryt zaplacenou zónou
A=1 zóna B=2 zóna C=3 zóna D=4 zóna
Cestující má na kartě zónu 2 a 3.
• Řidič zadá nástupní stanici A, výstupní stanici D
• Zařízení spočítá počet km z A do B, z bodu B do C odbaví na časový kupón, z bodu C do D
spočítá počet km
• km z úseku AB a CD sečte a spočítá jízdné v km ceníku dle CP
• zařízení zapíše platnost jízdenky (antipassback) na celou trasu a nárok na zvýhodněný
přestup (bez základní sazby) – čas výstupní stanice dle JŘ + aktuální zpoždění + 30 minut
3. Konec trasy je pokryt zaplacenou zónou
A=1 zóna B=2 zóna C=3 zóna D=4 zóna
Cestující má na kartě zónu 3 a 4.
• Řidič zadá nástupní stanici A, výstupní stanici D List 38/90
• Zařízení spočítá počet km z A do C
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
• vydá jízdné v km ceníku dle CP
• Ve stanici C zařízení zapíše nárok na zvýhodněný přestup (bez základní sazby) – čas výstupní
stanice dle JŘ + aktuální zpoždění + 30 minut
• z C do D odbaví na časový kupón
V případě, že je na el. peněžence nedostatečný zůstatek, zařízení nabídne automaticky možnost
platby doplatku nebo celé trasy v HOTOVOSTI.
Při lomeném tarifu se do statistiky zapíši dva lístky a to jeden za jízdu na časový kupón a jeden
na jízdu v km. Vytiskne se jedna jízdenka.
Odbavení žáků a studentů (celostátní nárok na slevy) - platí do 31. 8. 2018
V nových tarifních podmínkách došlo ke sjednocení nároků slev na časový kupón pro žáky a studenty.
Ale bohužel zůstává dvojí typ odbavení v hotovosti a z el. peněženky.
Tzn. Žák a student v případě celostátního nároku na slevy má nárok na zlevněné jízdné v hotovosti a
z el. peněženky, ale pouze na určeném úseku „Z“ a „Do“.
Proto v případě lomeného jízdného je návrh na odbavení:
1. Automatické odbavení dle CP viz. výše př. 1., 2. nebo 3., kdy cena v km bude v případě žáka
do 15 let 50% a studenta nad 15 let 100%.
2. Odbavení dle „určení řidičem“, kdy řidič musí zadat, že se jedná o dopočet km ceníku buď
žáka do 15 let(jízdné ve výši max. 37,5 % z občanského jízdného) nebo studenta nad 15 let
(jízdné ve výši max. 75% obč. jízdného).
Pokud je navolen tarif (student, žák) a nepotvrzen, zařízení zkontroluje typ karty/typ slevy a pokud
souhlasí, pak se vydá lomený tarif z časového kupónu a km zvýhodněný ceník pro studenty nebo
žáky.
Pokud navolen tarif (celý, poloviční aj.) a nepotvrzen, zařízení zkontroluje typ karty/typ slevy a pokud
nesouhlasí, pak se vydá první tarif s příslušným typem - pak lomený tarif z časového kupónu a km
ceník dle CP. Vysvětlení a sled kroků viz kap. 2.4 - Zakoupení kilometrické jízdenky.
Zvýhodněné tarify pro žáky a studenty musí být na tarifní skupině za standardními.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 39/90
Procesy MSK
3 Velké MHD
3.1 Jednotkové městské jízdné
Jednotkové městské
jízdné
Kontrola zón
Jsou všechny úseky Ne Výpočet jízdného
trasy pokryty?
Ano
Signalizace OK,
Zobrazení kupónů
Obrázek 24: Jednotkové městské jízdné
Poznámky:
- Položky ContractTransfer se kontrolují
- ContracthasJourney = 2, v případě CH.in = 3
Vlastník dokumentace: Koordinátor ODIS s.ro. List 40/90
Procesy MSK
3.2 Zakoupení jednotkové městské jízdenky
Jednotkové Cestující požádá o jízdenku
městské jízdné (nebo Check-in) zóna město.
Čtení READ_TICKET
seasonTicketFile (čtení souboru č. 4)
Ano
Nezlevněné Ne Kontrola profilu READ_CARD_HOLDER_INFO
jízdné? cestujícího (holderProfile1 nebo
holderProfile2 musí odpovídat
požadované jízdence)
Ano
Výpočet ceny WRITE_TICKET
jízdného (couponType = 1
contractHasJourney = 2, 3 (3 pro Check–IN)
Platba EP nebo + zápis seasonTicketInfo dle MSKarta)
hotově
Zápis městské
jízdenky na kartu
Ne - 1x Úspěšný Ne - 2x CANCEL_DEBET
zápis?
Ano
Signalizace OK; Vadná karta,
Tisk dokladu Reklamace
Obrázek 25: Zakoupení jednotkové městské jízdenky
Poznámky:
- nástupní i výstupní zastávka je v zóně MĚSTO
- zóna MĚSTO je v Ostravě (číslo zóny 354)
- v případě nutnosti použití defaultního CP se bude postup použití principiálně řídit dle kap. 2.3., kdy typ
jízdného se bude pro danou oblast řídit tarifem.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 41/90
Procesy MSK
3.3 Postup výpočtu jízdného
Platí do zavedení Ch-in/out
Nástup všemi dveřmi OV XXL (stav k 20.12.2012)
• Cestující se při nástupu všemi dveřmi registruje pouze v případě odbavení na el.
Peněženku
• v případě, že se trasa MHD skládá z více zón, je na cestujícím řešit tuto skutečnost
Řešení se nabízejí dvě
1. Nastoupí do dveří vozidla, u kterých bude tiskárna a zařízení, na kterém si může
dokoupit jízdné pro zónu 2
1.1. v případě, že zařízení neobsahuje trasu spoje (JŘ) je na cestujícím dokoupit si
jízdenku pro druhou zónu - výběrovým tlačítkem, ale tím by se okradl o čas
přestupu
1.2. v případě, že zařízení obsahuje trasu spoje dle (JŘ) pak zařízení vydá lom.
tarif a to tak, že po přiložení karty, zařízení zjistí, že cestující má zaplacenou
nástupní zónu, ale spoj pokračuje do „nezaplacené“ zóny. V tom případě
automaticky nabídne cestujícímu možnost dokoupení jízdného - čas
přestupu zapíše od poslední hraniční zastávky zóny 1 dle JŘ a aktuálního
zpoždění
2. Nastoupí do vozidla a jakmile vozidlo přijede na poslední hraniční zastávku mezi
zóny 1 a 2 cestující se zajde s kartou odbavit k nejbližší čtečce
3.3.1 Odbavení Ostrava XXL - současný stav k 20.12.2012
V první fázi se musí zachovat současný stav tzn. pro jednotlivé jízdné v OV XXL platí 60 min a 15 min.
„časový kupón“ (čas jízdenek je volitelný uživatelem). Řešeno bude číslem 354 „nadzóna“
(1,2,3,4,9,10,12,13,14,16,17,18,19,20,25).
Toto jízdné je omezeno časem. Tzn. cestující, který nastoupí např. v 61 minutě již si musí zakoupit
jízdenku novou nebo pokud již cestuje v dopr. prostředku je povinen si „hlídat“ zbývající čas do kdy
může cestovat. Po té buďto vystoupit nebo si zakoupit jízdenku novou na zbytek trasy.
Cesta v oblasti OV XXL
V případě, že cestující pojede pouze v úseku OV XXL zařízení vydá buďto 60 nebo 15 min. jízdenku dle
požadavku cestujícího. Po přestupu do jiného vozidla se pouze eviduje jízda.
Cesta z Regionu do XXL
1. Cestující nepožaduje jízdné pro XXL - v tom případě je odbaven v km po celý úsek trasy
Vlastník dokumentace: Koordinátor ODIS s.ro. List 42/90
Procesy MSK
2. Cestující požaduje jízdné pro XXL - v tomto případě cestující již předem nahlásí řidiči tento
požadavek. Řidič zadá tarif pro kombinaci „Region & OV XXL“ a zařízení vydá jízdenku, která
bude spočítána v km do hranice OV XXL neboli do první zastávky s „nadzónou 354“ a od této
zastávky dále vydá jízdenku s platností 60 min. od výše jmenované hraniční zastávky.
3.3.1.1 Příklady
př. 1/
A B C=zóna 1 a nadzóna 354 D=354
• řidič zadá nástupní stanici A, výstupní stanici D a tarif „Region & OV XXL“
• zařízení spočítá počet km z A do C
• vydá jízdné v km ceníku dle CP
• ve stanici C zařízení zapíše nárok na zvýhodněný přestup (bez ZS) - čas stanic C dle JŘ +
aktuální zpoždění + 30 minut
• z C vydá 60 min. jízdenku s platností od času stanice C dle JŘ + aktuální zpoždění
př. 2/
A B C=zóna 1 a nadzóna 354 D=354
Cestující má zakoupenou zónu 1
• řidič zadá nástupní stanici A, výstupní stanici D a tarif „Region & OV XXL“
• zařízení spočítá počet km z A do C
• vydá jízdné v km ceníku dle CP
• ve stanici C zařízení zapíše nárok na zvýhodněný přestup (bez ZS) - čas stanic C dle JŘ +
aktuální zpoždění + 30 minut
• z C do D uzná časový kupón pro zónu 1
• z D vydá 60 min. jízdenku s platností od času stanice C dle JŘ + aktuální zpoždění
Na kartu se zapíšou 2 jízdenky se svým časem platnosti. Jízdenka XXL se zapisuje na kartu i v případě
zaplacení v HOTOVOSTI (je to vlastně časový kupón)
Jízdenka XXL = čas platnost i - JJ MHD, lístek Region = čas přestupu – JJ PAL
Do statistiky se zapíšou 2 jízdenky
Vytiskne se jedna jízdenka s uvedenou kombinací.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 43/90
Procesy MSK
Jízdenka XXL se dá vydat pouze v případě, že linka do XXL vjíždí. Tzn. XXL je platný na zvolené trase.
Platba možná jak z el. peněženky, tak v HOTOVOSTI.
4 Malé MHD
Zóny MĚSTO:
• 40 Havířov
• 5 Karviná
• 15 Orlová
• 30 Opava
• 70 Nový Jičín, Šenov u Nového Jičína
• 50 Frýdek-Místek
• 60 Třinec
• 45 Český Těšín, Chotěbuz, Ropice
• 90 Krnov
• 100 Bruntál
• 75 Albrechtičky, Studénka
• 354 Ostrava XXL
4.1 Kontrola ve vozidlech MHD (při nástupu předními dveřmi)
Proces je popsán v diagramu (Obrázek 14: Kontrola ve vozidlech PAD, Malé MHD a ŽD).
4.2 Jednotkové městské jízdné
Proces je popsán v diagramu (Obrázek 24: Jednotkové městské jízdné).
4.3 Zakoupení jednotkové městské jízdenky
Proces je popsán v diagramu (Obrázek 25: Zakoupení jednotkové městské jízdenky).
4.4 Zakoupení kilometrické jízdenky
Proces je popsán v diagramu (Obrázek 19: Zakoupení kilometrické jízdenky).
Vlastník dokumentace: Koordinátor ODIS s.ro. List 44/90
Procesy MSK
4.5 Postup výpočtu jízdného
4.5.1 Zadání řidičem
• Nástupní stanice
• Cílová stanice – není nutná, řidič nezadává, nastaví se konec spoje dle nastavení v TS.
V případě, že linka prochází více zónami, nutné zadávání cílové stanice
• Typ jízdného - pouze v případě hotovostní platby nebo dobití kreditu
• autovýdej
4.5.2 Podklady pro zadání
Trasa dle JŘ – posloupnost stanic, každá stanice by měla obsahovat zónu a čas.
• v případě odbavení z el. peněženky se na jízdenku zapíše čas nástupní zastávky pro možnost
zvýhodněného přestupu (bez základní sazby)
• v případě odbavení na časový kupón je důležitá platná zóna nástupu
4.5.3 Výpočet jízdného
Jednotlivé městské jízdné
Nástup předními dveřmi
• aktuální (nástupní) stanice odbaví cestujícího buďto na časový kupón, nebo na el.
peněženku dle CP
• V případě dokoupení jízdenky, buďto toto odbaví řidič (linka PAD, jejíž část se odbavuje
v režimu MHD), nebo cestující přes samoobslužnou čtečku- při použití el. peněženky se
vždy zapíše platnost jízdenky (antipassback) do konečné zastávky spoje a nárok na
zvýhodněný přestup (nástupní zastávka + XY minut). Dokupované jízdenky nemají nárok
za zvýhodněný přestup.
4.5.3.1 MHD jízdenka
Obrázek 26: MHD jízdenka
Nástup na ve výchozí zastávce V
Uložení na kartu:
• Linka X List 45/90
• Spoj Y
• Zóna A
• PlatnostOd = akt. čas nástupu
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
• PlatnostDo = čas konečné zastávky (zastávka K) dle JŘ + akt. zpoždění
• Čas pro přestup = čas nástupu V (aktuální) + 30 minut
4.5.3.2 Nástup na stejné lince, ale jiném spoji
Obrázek 27: Nástup na stejné lince, ale jiném spoji
Uložení na kartu při 1. nástupu (jízdenka J1):
• Linka X
• Spoj Y
• PlatnostOd = akt. čas (v zastávce V1)
• PlatnostDo = čas konečné zastávky dle JŘ (v zastávce K1) + akt. zpoždění
• Čas pro přestup1 = čas 1. nástupu (v zastávce V1) + čas na přestup 30 min.
Uložení na kartu při 2. nástupu (jízdenka J2):
• Linka X
• Spoj Y2
• PlatnostOd = akt. čas (v zastávce V1)
• PlatnostDo = čas konečné zastávky dle JŘ (v zastávce K2) + akt. zpoždění
• Cena v případě, že
o Aktuální čas je menší než čas pro přestup1: cena=bez ZS
o Aktuální čas je větší než čas pro přestup1: cena=s ZS
• Čas pro přestup2 = čas 1. nástupu (v zastávce V1 na spoji Y) + čas na přestup 30 min
Vlastník dokumentace: Koordinátor ODIS s.ro. List 46/90
Procesy MSK
4.5.3.3 Nástup na jiném spoji i jiné lince
Obrázek 28: Nástup na jiném spoji i jiné lince
Uložení na kartu při 1. nástupu (jízdenka J1):
• Linka X
• Spoj Y
• PlatnostOd = akt. čas (v zastávce V1)
• PlatnostDo = čas konečné zastávky dle JŘ (v zastávce K1) + akt. zpoždění
• Čas pro přestup1 = čas 1. nástupu (v zastávce V1) + čas na přestup 30 min.
Uložení na kartu při 2. nástupu (Jízdenka J2):
• Linka X2
• Spoj Y2
• PlatnostOd = akt. čas (v zastávce V2)
• PlatnostDo = čas konečné zastávky dle JŘ (v zastávce K2) + akt. zpoždění
• Cena v případě, že
o Aktuální čas je menší než čas pro přestup1: cena=bez ZS
o Aktuální čas je větší než čas pro přestup1: cena=s ZS
• Čas pro přestup2 = čas 1. nástupu (v zastávce V1 na spoji Y) + čas na přestup 30 min
Vlastník dokumentace: Koordinátor ODIS s.ro. List 47/90
Procesy MSK
5 Systém Check-in Check-out
• Platí pro odbavení pouze v MHD Ostrava (zóna 354 – toto číslo zóny se může měnit dle
tarifu).
• Základní jednotlivé jízdné není časové, ale dojezdové, tj. cestující po registraci na čtečce
(check-in) dojede bez jakéhokoliv omezení do cílové zastávky daného spoje. Časový faktor je
rozhodující pouze pro případný přestup, avšak zde neomezuje dobu jízdy, ale čas, kdy je
možno přestoupit do navazujícího spoje za zvýhodněných podmínek.
5.1 Jednotkové městské jízdné
Proces je popsán v diagramu (Obrázek 24: Jednotkové městské jízdné).
Vlastník dokumentace: Koordinátor ODIS s.ro. List 48/90
Procesy MSK
5.2 Check –in Cestující požádá o jízdenku
(nebo Check-in) zóna město.
5.2.1 Check – in OV XXL
,
Jednotkové
městské jízdné
Čtení READ_TICKET
seasonTicketFile (čtení souboru č. 4)
Ověření contractTransferEndDate
Ověření contractTransferEndTime
Ano Nárok na přestup
zdarma (zona
354)
Ne
Ne Nárok na odečet Ano
základní sazby
Nezapočtení
Započtení základní základní sazby
sazby (1. nástup)
Načtení CP pro READ_CARD_HOLDER_INFO
výpočet jízdného (holderProfile1 nebo
Výpočet ceny holderProfile2 musí odpovídat
Ano požadované jízdence)
Je platba z EP Ne Nelze vydat Platba
v hotovosti dle tarifu
Ano ODIS; Tisk dokladu
Platba EP nebo
WRITE_TICKET
hotově (couponType = 3
contractHasJourney = 3
Zápis jízdenky na + zápis seasonTicketInfo dle MSKarta)
kartu (MHD XXL zápis ContractJourneyZones = 354)
Ne - 1x Úspěšný Ne - 2x CANCEL_DEBET
zápis? Vadná karta,
Reklamace
Ano
Signalizace OK;
Tisk dokladu
Obrázek 29 Check - in OV XXL
Vlastník dokumentace: Koordinátor ODIS s.ro. List 49/90
Procesy MSK
- Procesem Check-in lze zakoupit:
jednotlivou jízdenku s nárokem na zvýhodněný přestup, a to pouze v případě platby z EP
karty ODISka.
Daňové doklady za zakoupení zkrácené nebo nezkrácené jízdenky nebudou ve vozidle DPO
vydávány, cestující je může obdržet dodatečně, při návštěvě určených míst.
Nástup všemi dveřmi
• aktuální (nástupní) stanice odbaví cestujícího buďto na časový kupón, nebo na el.
peněženku dle CP
• V případě dokoupení jízdenky provede cestující přes samoobslužnou čtečku.
• Při použití el. peněženky se vždy zapíše platnost jízdenky (antipassback) do konečné
zastávky spoje a nárok na zvýhodněný přestup (nástupní zastávka + XY minut) a to i
pro dokupované jízdenky.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 50/90
Procesy MSK
5.2.2 Check –in pro XXL (353) Cestující požádá o jízdenku
(nebo Check-in) zóna 353.
Jednotkové
městské jízdné
Čtení READ_TICKET
seasonTicketFile (čtení souboru č. 4)
Ověření contractTransferEndDate
Ano Nárok na přestup Ověření contractTransferEndTime
zdarma (zona
353) READ_CARD_HOLDER_INFO
(holderProfile1 nebo
Ne
holderProfile2 musí odpovídat
Ne Nárok na odečet Ano požadované jízdence)
základní sazby
Nezapočtení
Započtení základní základní sazby
sazby (1. nástup)
Načtení CP pro
výpočet jízdného
Výpočet ceny
Ano jízdného
Je platba z EP Ne Nelze vydat.
Platba v hotovosti dle
Ano tarifu ODIS; Tisk dokladu
Platba EP nebo WRITE_TICKET
hotově (couponType = 3
contractHasJourney = 3
Zápis jízdenky na + zápis seasonTicketInfo dle MSKarta)
kartu (MHD XXL zápis ContractJourneyZones = 353)
CANCEL_DEBET
Ne - 1x Úspěšný Ne - 2x
zápis? Vadná karta,
Reklamace
Ano
Signalizace OK;
Tisk dokladu
Obrázek 30 Check - in pro XXL (353) List 51/90
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
Pro PAD
• V případě, že výstup je mimo zónu 353 - není nárok na tuto jízdenku
• V případě přestupu v zóně 353 je přestup zdarma
• V případě přestupu v zóně 77 – nákup nové jízdenky
• V případě přestupu do Regionu – ponížení o ZS.
5.2.3 MHD jízdenka (čl. 4.5.3.1)
Obrázek 31: MHD jízdenka
Nástup na ve výchozí zastávce V
Uložení na kartu:
• Linka X
• Spoj Y
• Zóna A
• couponType=3
• PlatnostOd = akt. čas nástupu
• PlatnostDo = čas konečné zastávky (zastávka K) dle JŘ + akt. zpoždění
• Čas pro přestup = čas nástupu V (aktuální) + 30 minut
Vlastník dokumentace: Koordinátor ODIS s.ro. List 52/90
Procesy MSK
5.2.4 Nástup na stejné lince, ale jiném spoji
Obrázek 32: Nástup na stejné lince, ale jiném spoji
Uložení na kartu při 1. nástupu (jízdenka J1):
• Linka X
• Spoj Y
• PlatnostOd = akt. čas (v zastávce V1)
• PlatnostDo = čas konečné zastávky dle JŘ (v zastávce K1) + akt. zpoždění
• Čas pro přestup1 = čas 1. nástupu (v zastávce V1) + čas na přestup 30 min.
Uložení na kartu při 2. nástupu (jízdenka J2):
• Linka X
• Spoj Y2
• PlatnostOd = akt. čas (v zastávce V1)
• PlatnostDo = čas konečné zastávky dle JŘ (v zastávce K2) + akt. zpoždění
• Cena v případě, že
o Aktuální čas je menší než čas pro přestup1: cena=0 Kč
o Aktuální čas je větší než čas pro přestup1: cena=s ZS
• Čas pro přestup2 = čas 1. nástupu (v zastávce V1 na spoji Y) + čas na přestup 30 min
Vlastník dokumentace: Koordinátor ODIS s.ro. List 53/90
Procesy MSK
5.2.5 Nástup na jiném spoji i jiné lince
Obrázek 33: Nástup na jiném spoji i jiné lince
Uložení na kartu při 1. nástupu (jízdenka J1):
• Linka X
• Spoj Y
• PlatnostOd = akt. čas (v zastávce V1)
• PlatnostDo = čas konečné zastávky dle JŘ (v zastávce K1) + akt. zpoždění
• Čas pro přestup1 = čas 1. nástupu (v zastávce V1) + čas na přestup 30 min.
Uložení na kartu při 2. nástupu (Jízdenka J2):
• Linka X2
• Spoj Y2
• PlatnostOd = akt. čas (v zastávce V2)
• PlatnostDo = čas konečné zastávky dle JŘ (v zastávce K2) + akt. zpoždění
• Cena v případě, že
o Aktuální čas je menší než čas pro přestup1: cena= 0,- Kč
o Aktuální čas je větší než čas pro přestup1: cena=s ZS
• Čas pro přestup2 = čas 1. nástupu (v zastávce V1 na spoji Y) + čas na přestup 30 min
Vlastník dokumentace: Koordinátor ODIS s.ro. List 54/90
Procesy MSK
5.2.6 Nástup ve výchozí zastávce V, výstup v cílové zastávce C (původní 2.4.3.1)
Obrázek 34: Nástup na jiném spoji i jiné lince
Uložení na kartu (jízdenka J1 - režim REGION):
• Linka X
• Spoj Y
• Nástupní zastávka
• Výstupní zastávka
• PlatnostOd = akt. čas
• PlatnostDo = čas výstupu (v zastávce C) + akt. zpoždění
• Čas pro přestup = čas výstupu (v zastávce C) + akt. zpoždění + čas na přestup
Uložení na kartu při 2. nástupu (Jízdenka J2 - režim XXL):
• Linka X2
• Spoj Y2
• PlatnostOd = akt. čas (v zastávce V2)
• PlatnostDo = čas konečné zastávky dle JŘ (v zastávce K2) + akt. zpoždění
• Cena v případě, že
o Aktuální čas je menší než čas pro přestup1: cena= bez ZS
o Aktuální čas je větší než čas pro přestup1: cena=s ZS
• Čas pro přestup2 = čas 2. nástupu (v zastávce V2 na spoji Y) + čas na přestup 30 min
Vlastník dokumentace: Koordinátor ODIS s.ro. List 55/90
Procesy MSK
5.3 Check -out
Proces Check-out znamená ukončení platnosti jízdenky Check-in.
• Tuto jízdenku je možno použít pouze na stejné lince a spoji, jako byl proveden první Check-in
(nástup), a to nejpozději v určeném čase procesem při výstupu. V tomto případě je jízdenka
Check-in ukončena a držitel ztrácí nárok na původně získaný zvýhodněný přestup.
• Tento proces nelze využít v případě, že při nástupu byl použit nárok na zvýhodněný přestup
z předešlé linky a spoje Při Check-out je cestujícímu na EP vrácena částka rozdílu mezi
jízdenkou Check-in a Check-out.
• V případě požadavku Check-out jízdenky ve vozidle PAD je jízdenka vydána ihned při prvním
odbavení, a to na základě předchozího požadavku cestujícího, kdy navolená trasa obsluhou
nesmí překročit max. stanovený čas a dále před tímto požadavkem nebyl použit nárok na
zvýhodněný přestup z předešlé linky a spoje.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 56/90
Procesy MSK
Jednotkové Cestující přikládá kartu
městské jízdné podruhé ke čtečce.
READ_TICKET
Čtení (čtení souboru č. 4)
seasonTicketFile
Provedeno na stejné Byl požit nárok na Signalizace
lince a ve stejném spoji zvýhodněný
jako první check-in Ne přestup nepřípustného Check-
Ne Ano out na jiném spoji
Ano Signalizace Check IN
překročení času
Provedeno ve
stanoveném čase
Ne
Ano
Výpočet rozdílu
ceny
Vrácení rozdílu CREDIT_PURSE
ceny na EP
Ano WRITE_TICKET
(zápis do souboru jízdenky (č. 4)
Zneplatnění Zkrácení data a času konce
jednotkové jízdenky platnosti a upravení ceny ve
struktuře seasonTicketInfo a
Ne - 1x Úspěšný contractTransferEndDate
zápis? v TicketTraceInfo dle MSKarta
Ne - 2x
DEBIT_PURSE
Ano
Vadná karta,
Signalizace OK; Reklamace
Tisk dokladu
Obrázek 35: Check out
Uplatnění nároku na zvýhodněný přestup znamená, že cena jízdenky je 0 nebo cena bez ZS.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 57/90
Procesy MSK
5.3.1.1 Nástup ve výchozí zastávce V, výstup v cílové zastávce C při použit Check-out
Obrázek 36: Výstup s Check out
Popis:
Uložení na kartu:
• Linka X
• Spoj Y
• Zóna XXL nebo OV XXL
• PlatnostOd = akt. čas nástupu
• PlatnostDo = čas konečné zastávky (zastávka K) dle JŘ + akt. zpoždění
• Čas pro přestup = čas nástupu V (aktuální) + 30 minut
• Check-out = čas výstupu menší než určený čas
• Výstup v zastávce C - platnost jízdenky ukončena časem výstupu mínus 1 minuta –
v položkách contractValidityEndDate a contractTransferEndDate a snížena cena v
contractPrice
5.3.1.2 Nástup ve výchozí zastávce V, výstup v cílové zastávce C a pokračování na lince X2
spoji Y2 při použití Check-out
Vlastník dokumentace: Koordinátor ODIS s.ro. List 58/90
Procesy MSK
Obrázek 37: Výstup Check out po přestupu
Popis:
Uložení na kartu (jízdenka J1)::
• Linka X
• Spoj Y
• Zóna XXL nebo OV XXL
• PlatnostOd = akt. čas nástupu
• PlatnostDo = čas konečné zastávky (zastávka K) dle JŘ + akt. zpoždění
• Čas pro přestup = čas nástupu V (aktuální) + 30 minut
• Check-out = čas výstupu menší než určený čas
• Výstup v zastávce C - platnost jízdenky ukončena.
Uložení na kartu (jízdenka J2):
• Linka X2
• Spoj Y2
• Zóna XXL
• PlatnostOd = akt. čas
• PlatnostDo = čas výstupu (v zastávce C) + akt. zpoždění
• Cena v případě, že poslední jízdenka J1 je Check-out cena = s ZS
• Čas pro přestup = čas nástupu V (aktuální) + 30 minut
Vlastník dokumentace: Koordinátor ODIS s.ro. List 59/90
Procesy MSK
5.4 Check- out pro XXL (353) Cestující přikládá kartu
Podruhé ke čtečce
Jednotkové
městské jízdné READ_TICKET
(Čtení souboru č. 4)
Čtení
seasonTickeFile
Provedeno na stejné Ne Byl použit nárok Ano Signalizace
lince a ve stejném spoji na zvýhodněný nepřípustného check-
jako první check-in přestup out na jiném spoji
Ano Ne
Provedeno Ne Check IN
v zóně 353
Proveď check-
Ano
in pro 77
Provedeno ve
stanoveném čase Ne Signalizace
Ano překročení času
Výpočet rozdílu
ceny
Vrácení rozdílu CREDIT_PURSE
ceny na EP WRITE_TICKET
(zápis do souboru jízdenky (č. 4)
Zneplatnění Zkrácení data a času konce
jednotkové jízdenky platnosti a upravení ceny ve
struktuře seasonTicketInfo a
contractTransferEndDate
v TicketTraceInfo dle MSKarta
Ne - 1x Úspěšný Ne - 2x DEBIT_PURSE
zápis
Vadná karta
Ano Reklamace
Signalizace OK
Tisk dokladu
Obrázek 38 Check-out pro XXL (353) List 60/90
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
5.4.1.1 Nástup ve výchozí zastávce V, výstup v cílové zastávce C při použit Check-out pro XXL
(353)
Obrázek 39: Výstup s Check out pro XXL (353)
Popis:
Uložení na kartu:
• Linka X
• Spoj Y
• Zóna nástupu – 353
• Zóny výstupu - 77
• PlatnostOd = akt. čas nástupu
• PlatnostDo = čas konečné zastávky (zastávka K) dle JŘ + akt. zpoždění
• Čas pro přestup = čas nástupu V (aktuální) + 45 minut
• Check-out = čas výstupu menší než určený čas
• Výstup v zastávce C – přepis jízdenky na novou jízdenku 78
Vlastník dokumentace: Koordinátor ODIS s.ro. List 61/90
5.5 Check -out –Příměsto Procesy MSK
Jednotkové Cestující požádá o List 62/90
městské jízdné krátkou jízdenku (Ch-out)
READ_TICKET (čtení
Čtení
seasonTicketFile a CP souboru č. 4)
READ_CARD_HOLDER_INFO
Nárok na přestup Ano Uznání zvýhodněného
přestupu
Ne
Ne
Jsou uznané
kupóny na trase
Ano Ano
Čas od prvního do Odpočet času pokrytého
posledního úseku kupónem
nepokrytého kupónem
nepřekročí stanovený čas
pro krátkou jízdenku
Ne
Trasa odpovídá Ne Signalizace překročení
stanovenému času
času
Ano
Výpočet ceny
jízdného
1
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
1
Dostatečný Ne Nelze vydat.
Platba v hotovosti dle
obnos na EP? tarifu ODIS; Tisk dokladu
Ano WRITE_TICKET
(couponType = 2
Platba EP contractHasJourney = 1 pro ČD
contractHasJourney = 3 pro BUS
Zápis jízdenky na + zápis seasonTicketInfo dle MSKarta)
kartu CANCEL_DEBET
Ne - 1x Úspěšný Ne - 2x Vadná karta,
zápis? Reklamace
Ano
Signalizace OK;
Tisk dokladu
Obrázek 40 Check-out - Příměsto
5.5.1.1 Nástup ve výchozí zastávce V, výstup v cílové zastávce C při použit Check-out
Obrázek 41: Výstup s Check out - Příměsto List 63/90
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
Popis:
Uložení na kartu:
• Linka X
• Spoj Y
• Zóna XXL
• PlatnostOd = akt. čas nástupu
• PlatnostDo = Check-out= čas výstupní zastávky (zastávka C1) dle JŘ + akt. zpoždění
5.5.1.2 Nástup ve výchozí zastávce V, výstup v cílové zastávce C , kdy část trasy je částečně
pokrytá platnou zónou a čas od prvního do posledního úseku nepokrytého
kupónem nepřekročí stanovený čas pro krátkou jízdenku
Obrázek 42 Nástup ve výchozí zastávce V1, výstup v cílové zastávce C1, kdy část trasy je částečně pokrytá
platnou zónou
Popis:
Uložení na kartu:
• Linka X
• Spoj Y
• Zóna XXL
• PlatnostOd = čas nástupní zastávky dle JŘ v Z1 + akt. spoždění
• PlatnostDo = Check-out= čas výstupní zastávky (zastávka C1) dle JŘ + akt. zpoždění
Vlastník dokumentace: Koordinátor ODIS s.ro. List 64/90
Procesy MSK
5.6 Check -out –Příměsto pro XXL (353)
Jednotkové Cestující požádá o
městské jízdné krátkou jízdenku (Ch-out)
READ_TICKET (čtení
Čtení
seasonTicketFile a CP souboru č. 4)
READ_CARD_HOLDER_INFO
Nárok na přestup Ano Uznání zvýhodněného
přestupu
Ne
Ne
Jsou uznané
kupóny na trase
Ano Ano
Čas od prvního do Odpočet času pokrytého
posledního úseku kupónem
nepokrytého kupónem
nepřekročí stanovený čas
pro krátkou jízdenku
Ne
Ne Není možno vydat
Výstup v zóně
353
Ano
1
Vlastník dokumentace: Koordinátor ODIS s.ro. List 65/90
Procesy MSK
1
Trasa odpovídá Signalizace překročení
stanovenému času
času
Ano
Výpočet ceny
jízdného
Ne Nelze vydat.
Dostatečný Platba v hotovosti dle
obnos na EP? tarifu ODIS; Tisk dokladu
Ano WRITE_TICKET
Platba EP (couponType = 2
contractHasJourney = 1 pro ČD
Zápis jízdenky na contractHasJourney = 3 pro BUS
kartu + zápis seasonTicketInfo dle MSKarta)
CANCEL_DEBET
Ne - 1x Úspěšný Ne - 2x
zápis? Vadná karta,
Reklamace
Ano
Signalizace OK;
Tisk dokladu
Obrázek 43 Check - out Příměsto pro XXL (353)
Vlastník dokumentace: Koordinátor ODIS s.ro. List 66/90
Procesy MSK
5.7 Přikoupení jízdenek
• Z karty je možné provést přikoupení jízdenek pro spolucestující, případně psa či zavazadlo, a
to pouze formou jízdenky s jednotnou časovou platností.
• Je možné dokoupit 3 druhy dokupovaných jízdenek současně.
• Z každého druhu dokupované jízdenky je možno provést přikoupení maximálně 15 kusů.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 67/90
Přikoupení Procesy MSK
jízdenek
Čtení READ_TICKET
(čtení souboru č. 4)
seasonTicketFile
Platná jízdenka Ne Odbavení držitele
karty
Ano
DEBIT_PURSE
Výběr
přikupovaných
jízdenek
Výpočet ceny
jízdného
Platba EP
Zápis přikoupených WRITE_BENEFIT
jízdenek Zápis přikoupených kontraktů do
souboru Benefit č. 1
(struktura benefitCheckInCheckOut
dle MSKarta)
Ne - 1x Úspěšný Ne - 2x CANCEL_DEBIT
zápis? Vadná karta,
Reklamace
Ano
Signalizace OK;
Obrázek 44: Přikoupení jízdenek
Vlastník dokumentace: Koordinátor ODIS s.ro. List 68/90
Procesy MSK
6 Železniční dopravci
Vzhledem k odlišnosti způsobu odbavení, kontroly a celkové koncepce železniční dopravy (dále jen
„ŽD“) budou případné rozdíly procesů popsány u jednotlivých oblastí.
6.1 Kontrola v ŽD
Proces je popsán v diagramu (Obrázek 14: Kontrola ve vozidlech PAD, Malé MHD a ŽD).
6.1.1 Kontrola benefitu ODIS Prima (Momentálně není použito. )
V rámci kontroly kupónu u železničních dopravců v 1. Vozidlové třídě bude prováděna kontrola
na platnost benefitu ODIS Prima, viz struktura karty ODIS.
6.2 Kilometrické jízdné (kontrola revizorem/obsluhou)
6.2.1 Km + zónové jízdné na POP
Proces je popsán v diagramu (Obrázek 16: Kilometrické jízdné).
6.2.2 Km + zónové jízdné zakoupené BK formou tzv. režimu capping
Jízdné
Jízdné na Ne
Yellowlistu?
Ano
Vizuální kontrola jízdenky
Odpovídají Ne
údaje jízdenky?
Neplatná
Ano jízdenka
Odsouhlasení
jízdenky
Obrázek 45. Km + zónové jízdné zakoupené BK formou tzv. režimu capping List 69/90
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
6.2.3 Dokupované jízdné zakoupené na samoobslužném terminálu v rámci Yellowlistů
Dokupované jízdné
Vyhledání na Není
Yellowlistu
dokupů dle čísla
ODIS nebo tokenu
Je
Kontrola platnosti, kontrola
nástupní a výstupní stanice
Jsou výsledky Ne
kontroly OK? Neplatná jízdenka
Ano
Platná jízdenka
Obrázek 46.Dokupované jízdné zakoupené na samoobslužném terminálu v rámci Yellowlistů
6.3 Zakoupení kilometrické jízdenky
Proces je popsán v diagramu (Obrázek 19: Zakoupení kilometrické jízdenky).
Odlišnost pro zařízení ŽD:
• nejdříve se provádí zápis jízdenky na kartu a poté platba EP (není podmínkou)
• Odbavuje se vždy z výchozí do cílové železniční stanice, bez ohledu na přestupy mezi vlaky.
6.4 Výpočet jízdného List 70/90
Zařízení v ŽD musí obsahovat:
• JŘ (CIS stanice),
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
• časy dle JŘ,
• zóny na trase, kterými vlak projíždí,
• aktuální čas,
• ceník km ODIS,
• ceník časových kupónů.
6.5 I. etapa
6.5.1 Km + zónové jízdné na POP
Odbavení ve vlaku by mělo být podobné jako v čl. 2 PAD.
Odbavení z A do B v km ceníku ODIS a to jak se ZS tak bez ZS (při zjištění nároku na přestup) -cena a
přirážka dle tarifu TR10 (obě položky odděleně). Ceník jízdného je omezen do 200 km.
• Čas platnosti OD = čas prodeje. Předprodej nebo nastavení počátku platnosti dokladu není
povolen
• Čas „platnosti do“ = platnost od + doba jízdy
• doba jízdy = předpokládaná doby jízdy stanovená pásmově dle vzdáleností. Za vzdálenost (2
min/km); přičemž do vzdálenosti 30 km je stanovena skokově po 5 km, od vzdálenosti 31 km pak
po pásmech 10 km
• čas přestupu „Do“ = „čas platnosti do“ + 30 minut nárok na přestup
• zařízení POP umožňuje k dokladu vydat „manipulační přirážku“ – možno zaplatit z karty ODIS
nebo v hotovosti
6.5.1.1 Trasa jako posloupnost stanic – km vzdálenosti
Odbavení na BČK – držitel karty:
o obsluha zadá nástupní, výstupní stanici (variantně lze zadat i stanice přes),
o zařízení spočítá vzdálenost mezi zadanými stanicemi dle JŘ,
o zařízení vypočítá cenu dle vzdálenosti, ceníku a CP,
o zařízení zapíše platnost jízdenky (antipassback) a nárok na zvýhodněný přestup
(bez základní sazby) – čas výstupní stanice dle JŘ + aktuální zpoždění +30 minut.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 71/90
Procesy MSK
6.5.1.2 Nástup ve výchozí zastávce, výstup v cílové zastávce
Obrázek 47: Nástup ve výchozí zastávce V, výstup v cílové zastávce C
Uložení na kartu (jízdenka J1):
• Line = číslo vlaku (nepoužívá se na UNIPOK)
• Zastávka Z a DO,
• PlatnostOd = akt. čas prodeje
• PlatnostDo = platnost od + doba jízdy (doba jízdy = předpokládaná doby jízdy stanovená pásmově
dle vzdáleností. Za vzdálenost (2 min/km); přičemž do vzdálenosti 30 km je stanovena skokově po
5 km, od vzdálenosti 31 km pak po pásmech 10 km)
• Čas pro přestup = čas platnosti Do + čas na přestup (30 min).
6.5.1.3 Trasa jako posloupnost zón – odbavení pouze na BČK
o obsluha zadá nástupní, výstupní stanici,
o po přiložení BČK zkontroluje a vyhodnotí platnosti, rozsah aj. zón na kartě (náležitosti
spojené se čtením časových kupónů) - Vyhodnotí se platnost po celé trase na celý úsek,
o při odbavení na časový kupón se nárok na přestup nezapisuje.
6.5.1.4 Kombinace trasy jako posloupnost zón a km tzv. lomený tarif – odbavení pouze
na BČK
Část trasy je zaplacen zónou/zónami, zbytek doplacen za km
• obsluha zadá nástupní, výstupní stanici (variantně lze zadat nácestné stanice),
• zařízení porovná trasu s platnými zónami na kartě,
• v případě shody vypočte placenou trasu jako celkovou trasu sníženou o úseky, které jsou
pokryty zónami na kartě a k tomu dopočítá trasu v km a to z poslední stanice zaplacené
zóny do výstupní stanice.
Př. Trasa vede z bodu A do D
A=1 zóna B=2 zóna C=3 zóna D=4 zóna
Cestující má na kartě časový kupón pro zónu 1 a 2.
Postup:
Vlastník dokumentace: Koordinátor ODIS s.ro. List 72/90
Procesy MSK
• Obsluha zadá nástupní stanici A, výstupní stanici D,
• Zařízení odbaví z bodu A do B na časový kupón, z bodu B do D spočítá jízdné v km ceníku dle
CP,
• zařízení zapíše platnost jízdenky (antipassback) a nárok na zvýhodněný přestup (bez základní
sazby) – platnost Do + čas na přestup 30 minut.
6.5.2 Km + zónové jízdné UNIPOK
V případě zakoupení jízdného na UNIPOK v předprodeji je postup výpočtu identický jako v kapitole
6.5.1 Km + zónové jízdné na POP. Zařízení dle JŘ vyhodnotí, zda má cestující nárok na zvýhodněný
přestup a také poznačí na kartu nárok na přestup:
• čas platnosti Do + čas na přestup (30 min).
Ve vlaku pak dojde pouze ke kontrole platného jízdného - zaevidování cestujícího, popř. úprava
přestupního času - dle aktuálního zpoždění vlaku.
Zařízení musí rozpoznat platné zóny na trase dle JŘ stejně jako v případě POP a zohlednit je
při výpočtu ceny.
6.5.2.1 Prodej a nahrání časového kupónu na POP
Pokladny POP prodávají alespoň omezený sortiment časových kupónů (např. 30 denní časové
kupóny), a to jak z EP, tak v hotovosti
Dále pracují s „Greenlistem“ což jsou zakoupené časové kupóny a dobitá EP přes E-shop, a to tak, že
nahrávají na karty jak tyto časové kupóny, tak časové kupóny prodané v hotovosti nebo dobití EP.
6.5.2.2 Prodej a nahrání časového kupónu na UNIPOK
Pokladny UNIPOK prodávají a nahrávají celý sortiment časových kupónů, a to jak z EP, tak v hotovosti
Dále pracují s „Greenlistem“ což jsou zakoupené časové kupóny a dobitá EP přes E-shop, a to tak, že
na karty tyto časové kupóny nahrávají.
6.5.3 Km + zónové jízdné na samoobslužném terminálu (push-pull soupravy)
Odbavení cestujícího probíhá stejně jako v čl. 6.5.1 Km + zónové jízdné na POP s výjimkou toho, že
zařízení neobsluhuje obsluha vlaku, ale sám cestující.
Odbavení z A do B v km ceníku ODIS a to jak se ZS tak bez ZS (při zjištění nároku na přestup) -cena a
přirážka dle tarifu TR10 (obě položky odděleně). Ceník jízdného je omezen do 200 km.
• Čas platnosti OD = čas prodeje. Předprodej nebo nastavení počátku platnosti dokladu není
povolen
• Čas „platnosti do“ = platnost od + doba jízdy
Vlastník dokumentace: Koordinátor ODIS s.ro. List 73/90
Procesy MSK
• doba jízdy = předpokládaná doby jízdy stanovená pásmově dle vzdáleností. Za vzdálenost (2
min/km); přičemž do vzdálenosti 30 km je stanovena skokově po 5 km, od vzdálenosti 31 km pak
po pásmech 10 km
• čas přestupu „Do“ = „čas platnosti do“ + 30 minut nárok na přestup
Na samoobslužném terminálu nelze prodat dlouhodobé časové kupóny a nelze zde vydat
manipulační přirážku.
Tiskárna jízdních dokladů není součástí samoobslužného terminálu, tzn. jízdenky je možné zakoupit
pouze na BČK (jízdné se ukládá do paměti karty) nebo BK (jízdné se ukládá do Yellowlistu). V případě
nákupu jízdného formou BK, probíhá odbavení cestujícího v rámci tzn. capping režimu (tzn. zúčtování
částky po 24 hodinách).
6.5.3.1 Nákup jízdného pro spolucestující (zavazadla) na samoobslužném terminálu
Jelikož samoobslužné terminály neobsahují tiskárnu, bude řešeno formou Yellowlistu dokupů.
Dokupované jízdné nemá nárok na přestup mezi dopravci, pouze v rámci zadané vlakové trasy.
Cestující zvolí položku „DOKUP“:
o cestující zvolí položku „DOKUP“
o cestující zadá nástupní, výstupní stanici,
o cestující zadá typ jízdného (CP – dítě, zvíře, zavazadlo aj.)
o zařízení spočítá vzdálenost mezi zadanými stanicemi dle JŘ,
o zařízení vypočítá cenu dle vzdálenosti, ceníku a CP,
o zařízení vyzve cestujícího k přiložení karty a provede platbu. V případě použití BČK zaplatí
jízdné z EP, v případě BK je platba provedena v režimu retail
o zařízení odešle on-line jízdenku do tzv. Yellowlistu
Aktualizace probíhají v rámci 15 minutových intervalů s nutnou možností on-line dotazu.
6.6 II. etapa
7 Platba bankovní kartou
Vlastník dokumentace: Koordinátor ODIS s.ro. List 74/90
Procesy MSK
7.1 Diagram procesu odbavení cestujícího v Regionu na bankovní kartu
Nahlášení trasy Obsluha nebo cestující
zadá nástupní nebo
výstupní zastávku
Přiložení karty
Tokenizace
Ne
Expirace
karty ?
OK
Je k tokenu Ne Je token na Ano
registrován denylistu?
kupón?
Ne
Ano Ne
Vyhledání kupónu Je token
na WLB?
Pokrývá kupón Ne Ano Výpočet ceny
kilometrické
alespoň část Výpočet ceny jízdenky pro TP a
kilometrické jízdenky
trasy? CP =1
dle CP TP z WLB
Ano
Ne Je token na Zobrazení Zobrazení
odbavení OK odmítnutí,
denylistu? možná platba
Zapsání dat o hotovostí
Ano nákupu
jízdenky Odmítnutí
Zobrazení: Pozor, karty
karta je na
denylistu
1
Vlastník dokumentace: Koordinátor ODIS s.ro. List 75/90
Procesy MSK
1
Je kupón na Ano Oznámení
odbavení OK
celou trasu?
Ne
Je karta na Ne Zaslání dat o jízdě
na kupón
WLB
Výpočet ceny jízdenky
Ano s uznáním kupónu na část
Výpočet ceny jízdenky trasy pro CP =1 a TP=1
s uznáním kupónu na
část trasy dle CP a TP dle
WLB
Je karta na Ano Doplatek Ano
denylistu? v hotovosti
Ne Ne Zaslání dat o jízdě na
kupón – přes ČSOB
Oznámení Oznámení
odbavení OK odmítnutí s informací o
odbavení doplatku (non-bank-
Zaslání dat o
nákupu jízdenky amount)
s uznáním kupónu
Zaslání dat o jízdě
na část trasy za hotovost
(pouze na CCMSK)
Obrázek 48. Diagram procesu odbavení cestujícího v Regionu na bankovní kartou
• Doplatek je umožněn hotovostí, doplatek z jiné BK nebo EP ODIS není zatím umožněn.
• Všechny transakce budou zasílány jak na ČSOB (struktura tapů), tak na CC MSK (struktura
věty KODIS) při vyčítání vozidla, toto duplicitní zaslání slouží ke kontrole úplnosti
transakcí. Výjimku tvoří pouze transakce hrazené hotovostí, které jsou zasílány pouze na
CC MSK ve větě KODIS jako doposud.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 76/90
Procesy MSK
• Všechny transakce zasílané na ČSOB ve struktuře tapů budou označeny jako REGION.
• Cena jízdenky REGION na BK bude zasílaná vždy se ZS, odečtení ZS v případě přestupu
provede Clearing.
• Čas na přestup bude uveden v transfer-time a řídí se typemTransfer-type.
• Čas na přestup se vypočítává stejně jako v případě odbavení kartou ODISka dle čl. 2.5.3.1
• Uznané zóny se zaznamenávají v zones-valid.
• Dokupované jízdenky v PAD budou hrazeny BK jako samostatná transakce u obchodníka
(dopravce) a nebudou zahrnuty do výpočtu jízdného na CC MSK. Při hrazení
dokupovaných jízdenek bude OZ komunikovat s bankou pod identifikací (ID) dopravce,
nikoliv pod identifikací zařízení KODISu. Peníze tedy půjdou přímo na účet dopravce,
nikoliv KODISu. Při tomto způsobu úhrady si může bankovní čtečka vyžádat on-line
autentizaci.
• Transakce uskutečněné v automatickém odbavení jsou tedy zasílány na ID KODISu.
• V případě realizace dokupu, se vypne TAP mód, obsluha na prodejním zařízení zadá
požadované lístky a tato transakce proběhne v klasickém prodejním módu (retail režim).
Tyto transakce jdou na ID dopravce a na lístkách je uvedena cena.
• Zakoupené dokupované jízdenky pomocí BK nejsou přestupní a nevzniká nárok na
odpočet ZS.
• Nákup lístku v automatickém odbavení není podmínkou pro možnost
dokupu/spolucestujícího?
• Prioritní odbavení probíhá v automatickém odbavení – výchozí tarif je zvolený dospělý.
• V případě požadavku na jiný tarif než v režimu capping, má obsluha možnost zvolit jiný
tarif. V tom případě probíhá odbavení v režimu retail. Zařízení upozorní obsluhu, zda
skutečně požaduje prodat jízdenku v režimu retail.
• Po přiložení bankovní karty – odbavuje se prioritně – čtečka je v TAP modu, palubní
počítač čeká na bankovní kartu, dojde k vyhodnocení, zda se jedná o bankovní kartu. V
případě, že ne, dochází k přepnutí na ODISku.
• Na jízdním dokladu bude uveden čas na přestup a cena a dále text „Potvrzení o jízdě.
Cena je pouze informativní. Není daňový doklad“. https://karta.odiska.cz/emvweb/
• Od 9. 12. 2018 nebude v MSK situace při které by bylo nutné vydat více jízdenek na jeden
tap na jednu trasu (například jednu pro první část trasy a druhou pro druhou část
trasy).V případě, že zakoupení jízdenky probíhá na samoobslužném terminálu (soupravy
ŽD push-pull) bez možnosti tisku, ukládá se info o jízdence do Yellowlistu.
• V případě, že token BK je na WLB, bude odbavovací zařízení zobrazovat obsluze fotografii
držitele BK z WLB.
• V případě nákupu jízdního dokladu u ŽD se výpočet platnosti jízdenky a nároku na
přestup řídí dle kapitoly 6.5.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 77/90
Procesy MSK
7.2 Diagram procesu variable fare
Předchozí kontroly
dle procesů
Je karta na Ano
Denylistu?
Ne Oznámení
Zápis na Taplist
Je spojení? Ano Zápis na Taplist +
status
Ne
Oznámení
Zkus spojení odmítnutí
podruhé
zaslání dat o
Je spojení? Ano odmítnutí
Ne
Autorizace +
Uložit údaje zaslání dopravních
dat
Pokus o další spojení
za 15 minut
Obrázek 49. Diagram procesu variable fare
Vlastník dokumentace: Koordinátor ODIS s.ro. List 78/90
Procesy MSK
7.3 Diagram procesu odbavení jízdenky MĚSTO nebo „check-in“ pro
Ostrava XXL nebo XXL (zóna 353) cestujícího ve vozidle PAD na
bankovní kartu
Nahlášení trasy
Přiložení karty
Tokenizace
Kontrola Ne
expirace
OK Ne Je token na Ano
Je k tokenu Ne denylistu?
kupón? Zobrazení odmítnutí
1 Ne karty
Ano
Je token na Zaslání dat o
Pokrývá kupón WLB odmítnutí
celou trasu?
Ano Ne
Ano
Výpočet ceny Výpočet ceny
Oznámení jízdného dle CP a TP jízdného pro CP=1 a
odbavení OK
dle WLB TP=1
Zaslání dat o
jízdě na kupón
Tisk potvrzení
Zaslání dat o
zakoupení
jízdenky
Vlastník dokumentace: Koordinátor ODIS s.ro. List 79/90
Procesy MSK
1
Ano Pokrývá kupón Ne
alespoň část Ne
trasy?
Je token na Ne Je token na
denylistu?
denylistu?
Ano Ano
Výpočet ceny jízdenky Výpočet ceny jízdného
na část trasy dle CP a TP dle CP a TP dle WLB
dle WLB
Zakoupení papírové jízdenky Tisk Platba v hotovosti nebo
na část trasy (nepokryté potvrzení z EP; výdej papírové
kupónem) hrazené jízdenky dle tarifu.
hotovostí dle tarifu. Zaslání dat o
zakoupení Zobrazení: Pozor, karta je na
jízdenky denylistu
Obrázek 50. Odbavení jízdenky MĚSTO nebo „check-in“ pro Ostrava XXL nebo XXL (zóna 353)cestujícího ve
vozidle PAD
Vlastník dokumentace: Koordinátor ODIS s.ro. List 80/90
Procesy MSK
• V případě, že začátek a konec trasy jsou v daném městě, pak platí tarif pro dané město
• V případě, že cestující nepožaduje slevu pro oblast XXL (zóna 353), pak platí tarif pro OV
XXL
• V případě, že cestující požaduje slevu pro oblast XXL (zóna 353), se vypočítává cena pro
tarif XXL. Transakce budou označeny pro zónu 353. V případě přestupu v zóně 77 – nákup
nové jízdenky. V případě přestupu do Regionu – ponížení o ZS. Cenu jízdenky provede
Clearing
• V případě, že výstup je mimo zónu 353 – pak není nárok na tuto jízdenku
• Postup výpočtu jízdného se řídí čl. 4.5 a 5 tohoto dokumentu. Blíže pak čl. 4.5.3.1 MHD
jízdenka
• Doplatek je umožněn hotovostí. Doplatek z EP ODIS nebo z jiné BK není umožněn.
• Všechny transakce budou zasílány jak na ČSOB (struktura tapů), tak na CC MSK (struktura
věty KODIS) při vyčítání vozidla, toto duplicitní zaslání slouží ke kontrole úplnosti
transakcí. Výjimku tvoří pouze transakce hrazené hotovostí, které jsou zasílány pouze na
CC MSK ve větě KODIS jako doposud.
• Všechny transakce zasílané na ČSOB ve struktuře tapů budou označeny jako MĚSTO,
v případě OV XXL budou označeny jako XXL a v případě použité slevy pro zónu 353 posílat
toto číslo zóny, v ostatních případech posílat číslo zóny 78
• Cena jízdenky na BK bude zasílaná vždy se ZS, odečtení ZS v případě přestupu provede
Clearing.
• Čas na přestup bude uveden v transfer-time a řídí se typemTransfer-type.
• Uznané zóny z kupónů se zaznamenávají v zones-valid.
• V zones-passes-through bude uvedeno číslo zóny dané MHD.
• V případě, že token BK je na WLB, bude odbavovací zařízení zobrazovat řidiči fotografii
držitele BK z WLB.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 81/90
Procesy MSK
7.4 Proces odbavení cestujícího ve vozidlech s nástupem všemi dveřmi
(např. DPO), pro oblast OV XXL a XXL (353) s časovým kupónem na
bankovní kartě
Přiložení karty
Tokenizace
Byl proveden Ano Proveď check-out
check-in jednotlivé
Zobrazení Konec
jízdenky? odmítnutí karty
Zápis na taplist +
Ne status
Kontrola Ne Zobrazení
odmítnutí karty
expirace
Zaslání dat o
OK odmítnutí
Je k tokenu Ne Je token na Ano
registrován denylistu
kupón?
Ano Ne
Ne Pokračuje se
Je kupón na odbavením
aktuální zónu? variable fare
Ano Zobrazení Pozor,
Ano karta je na Denylistu
Je token na
denylistu
Ne
1
Vlastník dokumentace: Koordinátor ODIS s.ro. List 82/90
Procesy MSK
1
Oznámení
odbavení OK
Zaslání dat o jízdě
na kupón
• OVbrpářzíepka5d1ě. P, ržoececseosdtbuajívceínní ceepstoužjíacdíhuojveesvloezvidulbeapcnhrkoDoPvonObí lkpaarsrottěoXbXlaLst(zOóVnXaXL3a53XX),L p(3a5k3)pslačatísotvaýrmif kpurpoónOeVm na
XXL
• V případě, že cestující požaduje slevu pro oblast XXL (zóna 353), se vypočítává cena pro
tarif XXL. Transakce budou označeny pro zónu 353. V případě přestupu v zóně 77 – nákup
nové jízdenky. V případě přestupu do Regionu – ponížení o ZS. Cenu jízdenky provede
Clearing
• Postup výpočtu jízdného se řídí čl. 4.5 tohoto dokumentu. Blíže pak čl. 4.5.3.1 MHD
jízdenka
• Všechny transakce budou zasílány jak na ČSOB (struktura tapů), tak na CC MSK (struktura
věty KODIS) při vyčítání vozidla, toto duplicitní zaslání slouží ke kontrole úplnosti
transakcí. Výjimku tvoří pouze transakce hrazené hotovostí, které jsou zasílány pouze na
CC MSK ve větě KODIS jako doposud.
• Všechny transakce zasílané na ČSOB ve struktuře tapů budou označeny jako MĚSTO,
v případě OV XXL budou označeny jako XXL a v případě použité slevy pro zónu 353 posílat
toto číslo zóny, v ostatních případech posílat číslo zóny 78.
• Dokupované jízdenky ve vozidlech DPO se řídí dokumentem
• Dokupované jízdenky (mimo vozidel DPO) budou hrazeny BK jako samostatná transakce
u obchodníka (dopravce) a nebudou zahrnuty do výpočtu jízdného na CC MSK. Při
hrazení dokupovaných jízdenek bude OZ komunikovat s bankou pod identifikací (ID)
dopravce, nikoliv pod identifikací zařízení KODISu. Peníze tedy půjdou přímo na účet
dopravce, nikoliv KODISu. Při tomto způsobu úhrady si může bankovní čtečka vyžádat on-
line autentizaci.
• Cena jízdenky na BK bude zasílaná vždy se ZS, odečtení ZS v případě přestupu provede
Clearing.
• Čas na přestup bude uveden v transfer-time a řídí se typemTransfer-type. List 83/90
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
• Uznané zóny z kupónů se zaznamenávají v zones-valid.
• V zones-passes-through bude uvedeno číslo zóny dané MHD.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 84/90
Procesy MSK
7.5 Check-out OV XXL na BK pro PAD
Cestující požádá o krátkou
jízdenku (check-out)
Tokenizace
Expirace Ano Oznámení
odmítnutí karty
karty?
Ne
Ano Je k tokenu Ne Je token na Ano
registrován denylistu?
kupón?
Ne Zápis na taplist +
Status
Ne Čas jízdy překročí
stanovenou dobu Oznámení
odmítnutí
pro krátkou
Zaslání dat o
jízdenku odmítnutí
Ne Je token na Ano Ano Signalizace
překročení času
WLB?
Výpočet ceny Výpočet ceny
jízdenky pro TP=1 a jízdenky pro TP a CP
CP=1 z WLB
Tisk potvrzení
Zaslání dat o
1 zakoupení jízdenky
Vlastník dokumentace: Koordinátor ODIS s.ro. List 85/90
Procesy MSK
1
Ne Jsou zóny
na trase?
Ano
Čas od prvního do Ano
posledního úseku
nepokrytého kupónem Odpočet času
nepřekročí stanovený pokrytého kupónem
čas pro krátkou
jízdenku
Ne
Trasa odpovídá Ne Signalizace
překročení času
stanovenému
času?
Ano Ano Zobrazení Pozor, karta
Je karta na je na Deny listu
deny listu?
Ne
Oznámení
odbavení OK
Zaslání dat o
nákupu jízdenky
Obrázek 52. Check-out OV XXL pro PAD na BK List 86/90
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
• V případě požadavku Check-out jízdenky ve vozidle PAD je jízdenka vydána ihned při
prvním odbavení, a to na základě předchozího požadavku cestujícího, kdy navolená trasa
obsluhou nesmí překročit max. stanovený čas.
• V případě, že cestující nepožaduje slevu pro oblast XXL (zóna 353), pak platí tarif pro OV
XXL
• V případě, že cestující požaduje slevu pro oblast XXL (zóna 353), se vypočítává cena pro
tarif XXL. Transakce budou označeny pro zónu 353.
• Postup výpočtu jízdného se řídí čl. 5 tohoto dokumentu.
• Doplatek jinou kartou není umožněn.
• Všechny transakce budou zasílány jak na ČSOB (struktura tapů), tak na CC MSK (struktura
věty KODIS) při vyčítání vozidla, toto duplicitní zaslání slouží ke kontrole úplnosti
transakcí. Výjimku tvoří pouze transakce hrazené hotovostí, které jsou zasílány pouze na
CC MSK ve větě KODIS jako doposud.
• Cena jízdenky na BK bude zasílaná vždy se ZS.
• Uznané zóny z kupónů se zaznamenávají v zones-valid.
• V zones-passes-through bude uvedeno číslo zóny dané MHD.
• V případě, že token BK je na WLB, bude odbavovací zařízení zobrazovat řidiči fotografii
držitele BK z WLB.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 87/90
Procesy MSK
8 Odbavení virtuální ODISky
8.1 Diagram procesu odbavení cestujícího v PAD a ŽD na Virtuální ODISku
Nahlášení trasy Obsluha nebo cestující
zadá nástupní nebo
Přiložení mobilního výstupní zastávku
telefonu s NFC nebo QR
Načtení a dešifrování
Je VO na
WL karet
Ano Ne
Zobraz fotografii a
grafický prvek obsluze
Souhlasí Zrušení
odbavení
fotografie a (tlačítkem)
GP? Ne Konec
Ano
Je k VO
registrován
kupón? Ne
Ano
Vyhledání kupónu Zobrazení
odmítnutí, možná
Pokrývá kupón platba hotovostí
alespoň část nebo BK
trasy? Ne Odmítnutí
karty
Ano
1
Vlastník dokumentace: Koordinátor ODIS s.ro. List 88/90
1 Procesy MSK
Je kupón na Ano Oznámení
odbavení OK
celou trasu? Zaslání dat o jízdě
na kupón
Ne
Zaslání dat o jízdě na
Výpočet ceny jízdenky kupón a doplatku v
s uznáním kupónu na
část trasy dle CP a TP dle hotovosti
WL VO
Nákup jízdenky Ano
na část trasy
v hotovosti
Ne
Oznámení
odmítnutí
odbavení
Obrázek 53. Diagram procesu odbavení cestujícího v PAD na bankovní kartou
Doplatek je umožněn hotovostí, doplatek z jiné BK nebo EP ODIS není zatím umožněn.
• Doplatek je umožněn hotovostí, doplatek z jiné BK nebo EP ODIS není zatím umožněn.
• Doplatek je realizován nákupem samostatné jízdenky na část trasy, kterou se držitel
prokazuje při případném přestupu.
• Čas na přestup se vypočítává stejně jako v případě odbavení kartou ODISka dle čl. 2.5.3.1
Vlastník dokumentace: Koordinátor ODIS s.ro. List 89/90
Procesy MSK
8.2 Proces odbavení cestujícího ve vozidlech DPO po 20.hodině
s nástupem předními dveřmi.
Přiložení mobilního
telefonu s NFC nebo QR
Načtení a dešifrování
Je VO na
WL karet
Ano Ne
Zobraz fotografii a
grafický prvek řidiči
Souhlasí Zzrušení
odbavenéí
fotografie a GP? Ne (tlačítkem)
Ano Konec
Je k VO
registrován
kupón? Ne
Ano
Je kupón na Zobrazení
aktuální zónu? odmítnutí karty
Ne
Ano
Oznámení
odbavení OK
Zaslání dat o jízdě Zaslání dat o
na kupón odmítnutí
Obrázek 54. Proces odbavení cestujícího ve vozidlech DPO po 20.hodině s nástupem předními dveřmi
Vlastník dokumentace: Koordinátor ODIS s.ro. List 90/90
Návrh datové věty pro MSK
Verze: 1.0.46.86
Obsah
Návrh datové věty pro MSK ................................................................................................................ 1
Obsah ........................................................................................................................................... 2
Historie změn ............................................................................................................................... 4
Popis datových toků CC MSK ..................................................................................................... 8
Typy předávání DAT ................................................................................................................... 9
1. Datový tok mezi CC MSK a dopravcem ............................................................................... 10
Datový tok od CC MSK k dopravci ........................................................................................... 10
Datový tok od dopravce k CC MSK .......................................................................................... 11
2. Datový tok mezi CC MSK a cestujícím.................................................................................12
Datový tok od CC MSK k cestujícímu ...................................................................................... 12
Datový tok od cestujícího k CC MSK ....................................................................................... 12
3. Datový tok mezi CC MSK a KODIS ..................................................................................... 12
Datový tok od CC MSK ke KODIS ........................................................................................... 12
Datový tok od KODIS k CC MSK............................................................................................. 13
Věta KODIS ................................................................................................................................... 14
Obecné informace ...................................................................................................................... 14
Aktivace karty v CC...................................................................................................................14
Zablokovaní a odblokování a pozastavení karty + změna jejich parametrů .............................. 17
Změna profilů na kartě ............................................................................................................... 19
Greenlist profilů ......................................................................................................................... 22
Seznam všech karet v systému...................................................................................................24
Aktivace zařízení........................................................................................................................26
Zablokovaní a odblokování zařízení .......................................................................................... 27
Transakce na zařízení.................................................................................................................30
Podezřelé transakce....................................................................................................................40
Zasílání transakcí ODIS/neODIS pro ODIS/neODIS karty ze zařízení ODIS .......................... 41
Zasílání transakce jako potvrzení, že za daný den zařízení dodalo seznam transakcí ............... 42
Zasílání transakce jako MULTI-LÍSTEK do CCMSK. ............................................................. 43
Řešení neukončených nahrání e-shop transakcí na strojku........................................................45
Žádosti o vydání karty................................................................................................................ 46
Blacklist karet ................................................................................................................................ 50
Denylist bankovních karet ............................................................................................................. 52
Význam použitých datových položek ........................................................................................ 52
Zpracování odpovědí.................................................................................................................. 53
Metoda GetLastIssuedDenyListSequenceNo ............................................................................ 54
Metoda GetDenyList..................................................................................................................55
Metoda GetDenyListBinary ....................................................................................................... 56
Green-list peněženky/kupónů ........................................................................................................ 58
Převod GL kupónu ..................................................................................................................... 60
Převod GL elektronické peněženky ........................................................................................... 61
Inkarta ............................................................................................................................................ 62
Zobrazení informace In Karty přes webové rozhraní CC .......................................................... 63
Vrácení informace o zůstatku EP na kartě ................................................................................. 64
Vrácení kupónů na kartě ............................................................................................................ 65
Nestandardní situace, reklamace, storno a výměny karet .......................................................... 66
Reklamace/storno nákupu EP na eshopu ....................................................................................... 72
Reklamace nákupu EP na eshopu .............................................................................................. 72
Storno nákupu EP na eshopu ..................................................................................................... 72
Posílaní souborů s pozdějším zpracováním ................................................................................... 73
2
Stažení souboru s odpovědí po zpracování .................................................................................... 73
Webová služba UltralightApi......................................................................................................... 74
Registrace zakoupeného kreditu elektronické peněženky na Ultralight kartu ........................... 76
Získání aktuálního zůstatku kreditu elektronické peněženky Ultralight karty nebo dopravní
karty ........................................................................................................................................... 78
Získání bluelistu Ultralight karet vč. zůstatků kreditů elektronických peněženek .................... 79
Registrace převedení zůstatku elektronické peněženky Ultralight karty na jinou Ultralight kartu
.................................................................................................................................................... 80
Registrace zakoupené dlouhodobé jízdenky na Ultralight kartu do systému ............................ 81
Získání platných dlouhodobých jízdenek Ultralight karty, bankovní karty nebo dopravní karty
.................................................................................................................................................... 83
Získání bluelistu platných dlouhodobých jízdenek Ultralight karet .......................................... 84
Registrace operace s Ultralight kartou do systému .................................................................... 85
Registrace blokace Ultralight karty do systému ........................................................................ 86
Registrace odblokace Ultralight karty do systému .................................................................... 87
Získání aktuálního blacklistu Ultralight karet............................................................................88
Registrace zakoupeného kreditu elektronické peněženky na dopravní kartu ............................ 89
Registrace zakoupené dlouhodobé jízdenky na dopravní kartu do systému..............................90
Registrace zakoupené dlouhodobé jízdenky na bankovní kartu do systému ............................. 92
Přiřazení transakce provedených na e-shopu k dopravní kartě .................................................. 94
Získání informací Ultralight karty, bankovní karty nebo ODIS karty ....................................... 95
Získání všech dlouhodobých jízdenek Ultralight karty ............................................................. 98
Získání všech jízdenek Ultralight karty dle časového období ................................................... 99
Získání všech pohybů elektronické peněženky dle časového období ...................................... 100
Registrace změny zákaznického profilu na Ultralight kartě .................................................... 102
Získání všech informací Ultralight karty vč. aktuálního zůstatku elektronické peněženky .... 103
Registrace vyplacení zůstatku elektronické peněženky z Ultralight karty .............................. 104
Získání sezamu všech prodejů elektronické peněženky na Ultralight kartách ........................ 105
Získání sezamu všech prodejů dlouhodobých jízdenek na Ultralight kartách ......................... 106
Registrace storna nákupu EP nebo dlouhodobé jízdenky na Ultralight kartě..........................107
Chybové stavy .......................................................................................................................... 108
Příklady užití ................................................................................................................................ 110
Příklady užití – rozšíření .............................................................................................................. 123
Dlouhodobé jízdné ................................................................................................................... 123
Krátkodobé jízdné .................................................................................................................... 124
Jednotlivé jízdné ...................................................................................................................... 125
Kilometrické jízdné..................................................................................................................127
Příklady užití pro mobilní aplikaci...............................................................................................128
Stažení transakcí z CC MSK pomocí webové služby..................................................................136
WSDL: ..................................................................................................................................... 138
Vygenerování hesla z CC MSK pomocí webové služby ......................................................... 141
WSDL pro GetUserPasswordByCardNo ................................................................................. 142
Stažení karet se změnami profilu z CC MSK pomocí webové služby ........................................ 144
Stažení karet se změnami údajů z CC MSK pomocí webové služby .......................................... 145
Aktualizace stavu žádosti o kartu pomocí webové služby...........................................................146
Stažení všech transakcí z CC MSK pro dopravce za měsíc.........................................................147
Stažení všech transakcí z CC MSK pro dopravce na vlastních kartách provedených u jiného
dopravce za měsíc. ....................................................................................................................... 148
Stažení aktuálního seznamu všech žádostí o kartu ...................................................................... 149
Dodatek 1 ..................................................................................................................................... 152
Dodatek 2 ..................................................................................................................................... 154
3
Historie změn
Datum Verze Popis Autor
Doplnění upřesnění ke kapitolám Aktivace zařízení, XT-card
20. 02. 2015 1.0.46.9 Transakce zařízení, Příklady užití, Blacklist karet XT-card
Úprava příkladů 32 a 33 v sekci Příklady užití XT-card
24. 02. 2015 1.0.46.10 Úprava položky zones XT-card
17. 08. 2015 1.0.46.11 Úprava znění povinnosti položky „amount“ při resetu XT-card
14. 10. 2015 1.0.46.12 počítadla zařízení
Doplnění nových položek card-emv-token a card-emv- XT-card
18. 01. 2016 1.0.46.13 block-noticed do datové věty XT-card
Doplnění kapitoly Denylist včetně příkladů XT-card
20. 01. 2016 1.0.46.15 Doplnění příkladu 35. přiložení bankovní karty (tapnutí)
25. 01. 2016 1.0.46.16 do kapitoly Příklady užití XT-card
04. 02. 2016 1.0.46.17 Doplnění nové hodnoty „tap“ do stávající položky
Transtype XT-card
15. 02. 2016 1.0.46.18 Přepracování kapitoly Denylist bankovních karet (nyní
WS)
18. 03. 2016 1.0.46.19 Doplnění kapitoly Vygenerování hesla z CC MSK
pomocí webové služby
Doplnění kapitoly Stažení karet se změnami profilu z CC
MSK pomocí webové služby
Doplnění položek customerprofile a customerprofiler2
do odpovědi v rámci stažení všech karet za dopravce
Doplnění kapitoly Denylist bankovních karet o:
• URL adresy webové služby včetně WSDL,
• návratové chybové kódy
• podrobnější popis jednotlivých položek
přenášených struktur
Doplnění kapitoly Řešení neukončených nahrání e-shop
transakcí na strojku
04. 04. 2016 1.0.46.20 Úprava elementu device-id XT-card
11. 04. 2016 1.0.46.21 Doplnění kapitoly Denylist bankovních karet o: XT-card
09. 05. 2016 1.0.46.22 • binární podoba denylistu XT-card
24. 05. 2016 1.0.46.23 XT-card
Doplnění nových položek card-emv-taplist-number a
13. 06. 2016 1.0.46.24 card-emv-vehicle-number do datové věty XT-card
12. 07. 2016 1.0.46.25 Doplnění kapitoly Změna profilů na kartě, Stažení karet XT-card
04. 08. 2016 1.0.46.26 se změnami profilu z CC MSK pomocí webové služby a XT-card
Seznam všech karet v systému
26. 10. 2016 1.0.46.27 Doplnění kapitoly Aktivace karty v CC XT-card
16. 11. 2016 1.0.46.28 Doplnění kapitoly Reklamace/storno nákupu EP XT-card
29. 11. 2016 1.0.46.29 z eshopu XT-card
Úprava kapitoly Změna profilů na kartě, Stažení karet se
změnami profilu z CC MSK pomocí webové služby a
Seznam všech karet v systému – přidání parametru
„datum změny profilu u dopravce“
Úprava příkladu č. 14
Úprava a doplnění příkladů v rámci chystané dělby tržeb
Úprava příkladů pro převod kupónu na kartě
4
14. 12. 2016 1.0.46.30 Úprava kapitoly Vrácení informace o zůstatku na kartě a XT-card
01. 02. 2017 1.0.46.31 Vrácení kupónů na kartě XT-card
Přidání příkladu pro prodej krátkodobého jízdného na
31. 03. 2017 1.0.46.32 papír, placeno hotově, 24 hodinová celosíťová obyčejná XT-card
(200 Kč)
25. 05. 2017 1.0.46.33 Přidání nového příznaku tariff-type=“NP“ jako XT-card
07. 09. 2017 1.0.46.34 nepřestupní pro odlišení nepřestupní jízdenky zasílané XT-card
12. 09. 2017 1.0.46.35 v jedné transakci v oblasit Ostrava XXL. XT-card
19. 09. 2017 1.0.46.36 Od 2. 7. změna zóny 354 na 78 XT-card
02. 10. 2017 1.0.46.37 Doplněn příklad pro nákup kupónu na BK (příklady 37 + XT-card
20. 12. 2017 1.0.46.38 38) XT-card
08. 01. 2018 1.0.46.39 Doplněn příklad pro jízdu na dlouhodobý kupón XT-card
23. 04. 2018 1.0.46.40 zakoupený na bankovní kartu (příklad 39) XT-card
Přidán parametr transfer-time – datum a čas pro uznání
11. 05. 2018 1.0.46.41 přestupu (použití u jízdy na kupón na BK) XT-card
15. 05. 2018 1.0.46.42 Seznam dopravců doplněn o Kód Dopravce XT-card
29. 05. 2018 1.0.46.43 Aktualizace seznamu dopravců XT-card
30. 05. 2018 1.0.46.44 Doplněn příklad pro dobití EP z bankovní karty (příklad XT-card
27. 07. 2018 1.0.46.45 40) XT-card
Přidána funkčnost pro převod GL kupónu a EP (fyzicky
13. 11. 2018 1.0.46.46 nenabité na kartu) XT-card
Přidán příklad 43. Kontrola jednotlivého jízdného ve
23. 11. 2018 1.0.46.47 vlaku XT-card
29. 11. 2018 1.0.46.48 Doplnění příkladů transakcí bankovních karet (příklady XT-card
14. 1. 2019 1.0.46.49 44 – 48) XT-card
Doplnění kapitoly Žádosti o vydání karty a Stažení
30. 1. 2019 1.0.46.50 aktuálního seznamu všech žádostí o karty XT-card
06. 02. 2019 1.0.46.51 Aktualizace seznamu dopravců XT-card
Upráva funkčnosti pro převod GL kupónu a EP
Zrušení provozovny Olomouc
Rozšíření údajů ODIS karty o jméno, příjmení, datum
narození a číslo ISIC karty (atributy name, surname,
birthdate a isicno)
Přidání atributu cp-date-to pro nákup kupónu na ODIS
kartu, u které končí platnost profilu karty dříve, než
platnost kupónu (příklad 49)
Přidání metod ChangeCardRequestState() a
GetCardInformationChanges() v rámci přenosu
informací mezi eshopem DPO a CCMSK
Rozšíření údajů pořízení žádosti ODIS karty
Úprava metody ChangeCardRequestState()
Doplnění číselníku kontaktních míst
Úprava metody ChangeCardRequestState()
Úprava číselníku kontaktních míst
Úprava číselníku kontaktních míst
Aktualizace seznamu dopravců
Aktualizace číselníku kontaktních míst
Přidána kapitola Webová služba UltralightApi
Aktualizace číselníku kontaktních míst
Aktualizace metody GetCardRequestList()
Přidání CustomerProfile a Zones do sekce Ultralight
5
11. 02. 2019 1.0.46.52 karty XT-card
07. 03. 2019 1.0.46.53 Přidání možnosti vymazat údaje z karty XT-card
21. 05. 2019 1.0.46.54 Úprava a doplnění příkladů dokupovaných jízdnek na XT-card
22. 05. 2019 1.0.46.55 BK v PAD přes standardní Sale XT-card
10. 07. 2019 1.0.46.56 Přidání příkladů užití pro Jednodenní oblastní jízdenku - XT-card
28. 08. 2019 1.0.46.57 JESENÍKY XT-card
Přidání příkladů užití pro práci s Ultralight kartou
24. 09. 2019 1.0.46.58 Aktualizace číselníku kontaktních míst XT-card
25. 09. 2019 1.0.46.59 Aktualizace kapitoly Webová služba UltralightApi XT-card
26. 09. 2019 1.0.46.60 Přidání rozhraní pro greenlist profilů XT-card
Přidání příkladu 56. Prodej krátkodobého jízdného na
01. 10. 2019 1.0.46.61 Ultralight kartu v oblasti XXL XT-card
Aktualizace kapitoly Webová služba UltralightApi
04. 10. 2019 1.0.46.62 Aktualizace číselníku kontaktních míst XT-card
Přidání hodnoty parametru TransType pro ČD XT-card
23. 10. 2019 1.0.46.63 Přidání parametru passes-through-id pro ČD XT-card
04. 11. 2019 1.0.46.64 Aktualizace kapitoly Registrace operace s Ultralight XT-card
05. 11. 2019 1.0.46.65 kartou do systému XT-card
07. 11. 2019 1.0.46.66 Úprava příkladu č. 53 XT-card
29. 11. 2019 1.0.46.67 Přidání hodnoty parametru TransType pro Ultralight
Úprava příkladů s ultralight kartou č. 53, 54, 55, 56 XT-card
04. 12. 2019 1.0.46.68 Přidání parametrů card-taplist-number a card-vehicle- XT-card
08. 01. 2020 1.0.46.69 number pro ultralight karty XT-card
Přidání příkladů č. 57 a 58 pro storno transakcí BK v
23. 01. 2020 1.0.46.70 PAD XT-card
Přidání příkladu č. 59 – check-out transakce na UL kartu XT-card
12. 02. 2020 1.0.46.71 Aktualizace kapitoly Webová služba UltralightApi XT-card
12. 03. 2020 1.0.46.72 Aktualizace kapitoly Webová služba UltralightApi
27. 03. 2020 1.0.46.73 Aktualizace kapitoly Webová služba UltralightApi XT-card
Přidán nový artibut clearing-id
20. 04. 2020 1.0.46.74 Přidání příkladu č. 60 a 61 – nákup na EP a jízda na EP XT-card
koordinátora KOVED
29. 04. 2020 1.0.46.75 Aktualizace kapitoly Webová služba UltralightApi
Přidáno reklamační dobití/vybití na kontaktním místě
KODIS
Aktualizace kapitoly Webová služba UltralightApi
Přidání hodnoty mobile-app pro platbu mobilní aplikací
Přidání nového atributu fare-id pro jednoznačnou
identifikace mobilní jízdenky
Přidány příklady č. 64 a 65
Přidány příklady č. 66 pro neplatné odbavení na mobilní
jízdenku
Přidání atributu valid-from a valid-to při nákupu mobilní
jízdenky
Přidání možnosti nastavit u ODIS karty číslo dopravce,
který je zaměstnavatelem držitele karty nebo
zaměstnavatelem rodinného přislušníka držitele karty
Aktualizace příkladů (appl-id)
Přidány příklady č. 67 a 68 pro nákup 24 hodinové
jízdenky na Ultralight kartu
Přidána kapitola příkladů pro mobilní jízdenku
6
26. 05. 2020 1.0.46.76 Úprava UltralightApi - Registrace operace s Ultralight XT-card
kartou do systému (přidána možnost nakupovat
09. 06. 2020 1.0.46.77 dlouhodobé kupóny ve vozidlech). XT-card
15. 06. 2020 1.0.46.78 Doplnění kapitoly příkladů pro mobilní jízdenku. XT-card
07. 09. 2020 1.0.46.79 Přidání nových atributů fare-label a pay-id pro mobilní XT-card
15. 09. 2020 1.0.46.80 jízdenku XT-card
06. 10. 2020 1.0.46.81 Přidání nového atributu fare-provider-cin pro IČ XT-card
08. 10. 2020 1.0.46.82 dopravce XT-card
04. 11. 2020 1.0.46.83 Přidání nového atributu its-no pro číslo IDS XT-card
25. 03. 2021 1.0.46.84 Přidání nového atributu fare-qr-check pro zasílání XT-card
výsledku odbavení na QR kód
08. 04. 2021 1.0.46.85 Přidání nového atributu print pro identifikaci XT-card
26. 04. 2021 1.0.46.86 samoobslužného zařízení bez tisku XT-card
Přidání nového atributu network-id pro identifikaci
dopravního systému
Doplnění příkladů storno transakcí pro mobilní jízdenku
č. 17, 18, 19
Aktualizace číselníku kontaktních míst
Upraveny příklady č. 65 a 66
Rozšíření údajů ODIS karty o fotku a stav oveření
Aktualizace číselníku provozoven
Úprava popisů datových toků
7
Popis datových toků CC MSK
1. KODIS Zavedení dopravce do CC
(Provádí se ručně z www formuláře)
2. Dopravce Aktivace zařízení CLEARING MSK
Odpověď s výsledkem aktivace zařízení
3. Dopravce Aktivace karet
Odpověď s výsledkem aktivace karet
4. Dopravce Zaslání transakcí
Potvrzení přijetí jednotlivých transakcí
5. Dopravce Deaktivace karty/zařízení
6. Dopravce Potvrzení o úspěšnosti/neúspěšnosti operace
jednotlivých transakcí
Žádost o blacklist/whitelist
Data blacklistu/whitelistu
8
Schéma datových toků CC MSK
Clearing MSK
1 2 3
Typy předávání DAT
1. Prostřednictvím www rozhraní
Dopravce
Předávání dat (informací) prostřednictvím www je myšleno získání infoKrmOaDcIíSprohlížením příslušné
webové stránky na adrese „clearing.kodisC.cezs“t.ující (Blue Pixel)
(držitel karty)
2. Prostřednictvím xls souboru
Předávání dat (informací) prostřednictvím xls souboru je myšleno získání informací z příslušné
webové stránky na adrese „clearing.kodis.cz“ na které je umožněno stažení dané informace ve
formátu xls a uložení a PC uživatele.
3. Prostřednictvím e-mailu
Týká se pouze zasílání hesla, heslo přijde na e-mailovou adresu, která je zadána v aktivačních
údajích, zasílaných na server ve větě KODIS ve formátu XML.
4. Prostřednictvím XML souboru
Komunikace prostřednictvím XML souboru je hlavním komunikačním kanálem Clearingu pro
komunikaci s dopravci.
Jedná se o zaslání XML souboru dle specifikace věty KODIS na adresu
„clearing.kodis.cz/readdata.aspx“ metodou POST. V metodě POST jsou zasílány celkem 3
parametry name, passwd a XMLdata. První dva obsahují informace o Loginu a Heslu. Poslední
parametr obsahuje XML formát zprávy pro CCMSK dle specifikace věty KODIS. Na každou takto
zaslanou XML zprávu server odpoví opět dle specifikace věty KODIS.
Příklad:
POST clearing.kodis.cz/readdata.aspx HTTP/1.1
Cache-Control: no-cache
Connection: Keep-Alive
Content-Length: 4539
Content-Type: multipart/form-data; boundary=----FormData----
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
9
Host: 10.0.0.80
User-Agent: Java/1.6.0_21
------FormData----
Content-Disposition: form-data; name="name"
ttt
------FormData----
Content-Disposition: form-data; name="passwd"
ttt
------FormData----
Content-Disposition: form-data; name="XMLdata"; filename="message.xml"
Content-Type: text/xml
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1550" samno="10435" cashno="1" paycount="0"
depozitcount="1" sumcount="1" vat="20" sign="">
<transaction tx-id="1" card-id="04084EEA052280" appl-id="0" type="dep" amount-
type="card" transtype="mhdp" jumboaccount="no" when="2012-03-28 13:31:02"
baseamount="767" amount="767" currency="CZK" vat="20" tariff="1" tariff-type="JD" person-
type="1" transtypetext="DPI" loyalty="0" note="MSKStressTest" tranret="a1" />
</transactions>
------FormData------
1. Datový tok mezi CC MSK a dopravcem
Datový tok od CC MSK k dopravci
1. Prostřednictvím www rozhraní
• Informace o všech uživatelích daného dopravce v systému.
• Informace o všech kartách daného dopravce v systému.
• Informace o všech zařízeních daného dopravce v systému.
• Informace o všech transakcích daného dopravce v systému.
• Informace o všech dávkách zaslaných daným dopravcem do systému.
• Black list.
• Historie přihlášení uživatelů daného dopravce.
• Zůstatky na EP daného dopravce.
• Zařízení bez transakcí daného dopravce.
1. Prostřednictvím xls souborů
• Rozúčtování podle linek, zón a obcí daného dopravce. Dopravce bude stahovat jednou měsíčně,
data jsou zpracovávána v termínech určených platnou Smlouvou o dělbě tržeb mezi dopravci
v Integrovaném dopravním systému Moravskoslezského kraje.
2. Prostřednictvím XML souboru
10
• Black list karet dle specifikace věty KODIS. Blacklist přichází ihned po dotazu dopravce na CC,
Dopravce bude stahovat Black list minimálně jednou denně a importovat jej ihned po stažení
do odbavovacích zařízení .
• Green listy dle specifikace věty KODIS. Green list přichází ihned po dotazu dopravce na CC.
Dopravce bude stahovat Green Listy minimálně jednou denně a importovat djej ihned po
stažení do odbavovacích zařízení
• Seznam všech karet daného dopravce v systému dle specifikace věty KODIS. Seznam karet
přichází ihned po dotazu, předpokládá se, že dopravce může stahovat dle své potřeby, z hlediska
CC není nutno stahovat vůbec.
• Odpověď s výsledkem operace pro aktivaci zařízení dle specifikace věty KODIS. Přichází
okamžitě po zaslání dotazu.
• Odpověď s výsledkem operace pro aktivaci karet dle specifikace věty KODIS. Přichází
okamžitě po zaslání dotazu.
• Odpověď s výsledkem operace pro přijetí jednotlivých transakcí dle specifikace věty KODIS.
Přichází okamžitě po zaslání dotazu.
• Odpověď s výsledkem operace zablokovaní, odblokování a pozastavení karet dle specifikace
věty KODIS. Přichází okamžitě po zaslání dotazu.
• Odpověď s výsledkem operace změna parametrů karet dle specifikace věty KODIS. Přichází
okamžitě po zaslání dotazu.
• Odpověď s výsledkem operace zablokovaní a odblokování zařízení dle specifikace věty KODIS.
Přichází okamžitě po zaslání dotazu.
3. Prostřednictvím webové služby (WS)
• Seznam všech transakcí, včetně transakcí provedených u jiných dopravců, k zadanému číslu
karty za zvolené období.
Datový tok od dopravce k CC MSK
1. Prostřednictvím XML souborů
• Aktivace zařízení dle specifikace věty KODIS. Dopravce musí provést dříve, než bude
vytvořená první transakce z tohoto zařízení, nejlépe ještě před instalací zařízení do vozidla.
• Aktivace karet dle specifikace věty KODIS. Dopravce musí provést dříve, než bude zaslaná
první transakce na této kartě, nejlépe při předání karty cestujícímu.
• Veškeré transakce dle specifikace věty KODIS. Dopravce zasílá transakce alespoň jednou denně
(aby měl cestující co nejaktuálnější přehled o svých jízdách na webovém rozhraní), nejpozději
však do 3 dnů od provedení transakce.
• Dopravce zasílá transakce v termínech dle platné Smlouvy o dělbě tržeb mezi dopravci
v Integrovaném dopravním systému Moravskoslezského kraje.
• Zablokování, odblokování a pozastavení karet dle specifikace věty KODIS. Dopravce zasílá na
Clearing okamžitě po oznámení cestujícím (do všech odbavovacích zařízení se distribuuje
nejpozději do 24 hodin)
• Změna parametrů karet dle specifikace věty KODIS. Dopravce zasílá dle charakteru změny,
nejlépe co nejdříve.
11
• Změna stavů transakcí umístěných v greenlistech (změna stavu kupónu v případě nahrání
předplaceného kupónu na kartu a změna stavu dobití EP v případě nahrání dobití EP
prostřednictvím e-shopu)
• Zablokovaní a odblokování zařízení dle specifikace věty KODIS. Dopravce zasílá okamžitě
v případě, kdy může dojít k zneužití zařízení (ztráta, krádeže apod.) v případě technické poruchy
nebo likvidace postačí zaslat do posledního termínu zasílání dat pro provádění zúčtování za
daný měsíc dle platné Smlouvy o dělbě tržeb mezi dopravci v Integrovaném dopravním systému
Moravskoslezského kraje.
• Žádost o blacklist dle specifikace věty KODIS. Dopravce bude zasílat denně a získaný blacklist
importovat ihned do odbavovacích zařízení.
• Žádost o greenlisty dle specifikace věty KODIS. Dopravce bude zasílat denně a získaný
greenlist importovat ihned do odbavovacích zařízení.
• Žádost o seznam všech karet daného dopravce v systému dle specifikace věty KODIS.
2. Datový tok mezi CC MSK a cestujícím
Datový tok od CC MSK k cestujícímu
Clearing poskytuje data cestujícímu – držiteli karty:
1. Prostřednictvím www rozhraní
Tato data jsou poskytnuta na základě zadání správných přihlašovacích údajů:
• základní informace o kartě (vydavatel, číslo karty, aktivace karty),
• přehled jízd provedených na danou kartu,
• přehled kupónů zakoupených na danou kartu,
• pohyby na elektronické peněžence
2. Prostřednictvím e-mailu
• přístupové heslo
Datový tok od cestujícího k CC MSK
Cestující neposílá na Clearing žádná data.
3. Datový tok mezi CC MSK a KODIS
Datový tok od CC MSK ke KODIS
2. Prostřednictvím www rozhraní
• Informace o všech uživatelích v systému.
• Informace o všech kartách v systému.
• Informace o všech zařízeních v systému.
• Informace o všech transakcích v systému.
• Informace o všech dávkách zaslaných v systému.
• Black list.
• Historie přihlášení.
12
• Report pro ČNB.
• Zůstatky na EP.
• Billing EP.
• Statistiku držitelů karet podle profilů.
• Soupis podezřelých transakcí.
• Zařízení bez transakcí.
3. Prostřednictvím xls souborů
• Rozúčtování podle linek, zón a obcí za všechny dopravce.
• Rozúčtování podle spojů.
4. Prostřednictvím XML souboru
• Black list.
Datový tok od KODIS k CC MSK
• Zavedení dopravců do systému - data jsou zaváděna prostřednictvím www rozhraní.
• Rozúčtování dle Blue Pixel – data jsou předávána ve formátu xls.
13
Věta KODIS
Obecné informace
XML soubory
Při zasílání xml dat prostřednictvím webového rozhraní CC, je nutné zasílat data ve správném
kódování. Požadovaný typ kódování je UTF-8.
Soubory mohu být zasílány v zip formátu, avšak pro každou skupiny XML souborů
(aktivace/deaktivace karet, transakce, aktivace/deaktivace zařízení, apod.) musí být samostatný zip.
XML soubory pro aktivace karet a zařízení musí být odeslány dříve, než budou na těchto kartách a
zařízeních provedeny a odeslány jakékoliv transakce v XML souborech do CC.
Aktivace karty v CC
Tento XML soubor se posílá jako seznam aktivovaných karet a aplikací na ni u daného
provozovatele. Příklad XML souboru pro aktivaci karty
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>newcard</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>3</itemscount>
<lang>cz</lang>
</header>
<items>
<newcard cardsno="000000001" card_kodis="45689745" cardlogin="0000000001"
cardpwd="heslo" valid_from="2003-05-31 12:33:27" valid_to="2005-06-01
00:00:00" note="první karta">
<app appID="4609" max_counter="100000"/>
<app appID="34965" max_counter="100000"/>
</newcard>
<newcard cardsno="000000002" card_kodis="56689745" cardpwd="heslo"
valid_from="2003-05-31 12:34:27" valid_to="2005-06-01 00:00:00"
email="jan.novak@seznam.cz">
<app appID="4609" max_counter="100000"/>
<app appID="34965" max_counter="100000"/>
</ newcard >
...
<newcard cardsno="000000003" card_kodis="99689745" cardpwd="heslo"
valid_from="2003-05-31 12:34:27" valid_to="2005-06-01 00:00:00"
email="petr.volny@seznam.cz" customerprofile="1" cp-date-from="2016-05-01
14:30:00" cp-date-to="2016-06-01 14:30:00" cp-date="2016-05-01 14:25:26">
<app appID="4609" max_counter="100000"/>
<app appID="34965" max_counter="100000"/>
14
</newcard >
</items>
</rootCC>
V rámci elementu <items> se nacházejí elementy <newcard>, které mají následující atributy:
cardsno – výrobní číslo čipu karty v hexadecimálním tvaru přidělené výrobcem čipu např.
„04A456B1F0D380“ (povinná položka)
card_kodis - identifikační číslo karty, řetězec o délce max. 20 znaků, tak jak je uveden na kartě
(povinná položka)
cardlogin – nepoužívaná položka (nepovinná položka)
cardpwd – heslo pro přihlášení k portálu (nepovinná položka)
email - email držitele karty. Má-li mít držitel přístup k informacím o své kartě, jež jsou uloženy na
CCMSK, musí být email vyplněn. Na tento email je zasíláno první heslo pro přihlášení. (povinná
položka v případě požadavku na přístup do systému CCMSK)
valid_from – datumový začátek platnosti karty (povinná položka)
valid_to – datumový konec platnosti karty (povinná položka)
note - umožňuje přidat ke kartě poznámku (nepovinná položka)
customerprofile - číslo profilu 1 na kartě (nepovinná položka)
cp-date-from – začátek intervalu platnosti profilu č. 1 na kartě. Povinný pro
actdeact=“customerprofile“.
cp-date-to – konec intervalu platnosti profilu č. 1 na kartě. Povinný pro actdeact=“customerprofile“.
cp-date - datum změny profilu č. 1 u dopravce. Povinný pro actdeact=“customerprofile“.
customerprofile2 - číslo profilu 2 na kartě (nepovinná položka)
cp2-date-from – začátek intervalu platnosti profilu č. 2 na kartě. Povinný pro
actdeact=“customerprofile2“.
cp2-date-to – konec intervalu platnosti profilu č. 2 na kartě. Povinný pro
actdeact=“customerprofile2“.
cp2-date – datum změny profilu č. 2 u dopravce. Povinný pro actdeact=“customerprofile2“.
name – jméno držitele ODIS karty (nepovinná položka)
surname – přijmení držitele ODIS karty (nepovinná položka)
birthdate – datum narození držitele ODIS karty (nepovinná položka)
isicno – číslo ISIC karty držitele ODIS karty (nepovinná položka)
photo – fotografie v base64 (nepovinná položka)
ver_state – stav oveření odis karty – 1 = ověřená, 2 = neověřená (nepovinná položka) (pokud není
vyplněn, tak se uloží karta jako neověřená)
Karta může obsahovat 1 až n aplikací na kartě, které se aktivují přidáním elementu <app>, který má
dva atributy:
appID - který určuje číslo aplikace v dekadickém formátu. Číslo aplikace může nabývat hodnoty 1
až 2 147 483 647, pro aplikaci jízdenka je určeno číslo „4609“ a pro aplikaci EP je
„34965“. Tyto dvě aplikace jsou povinné. Při aktivaci karty se vždy vytvoří aplikace 0, i
když nebude přidán element <app> do XML u dané karty. Do této aplikace 0 budou
přiřazeny všechny transakce s nezadanou hodnotou aplikace, nebo pokud neexistuje žádná
jiná aplikace. (povinná položka).
max_counter – maximální počet transakcí u dané aplikace. Slouží pro kontrolu, zda počet transakcí
nepřekročil povolený počet transakcí. Pokud je uvedena hodnota 0 nebo není uvedena žádná
hodnota, kontrola se neprovádí (nepovinná položka)
15
Jako odpověď CC posílá seznam karet, které byly úspěšné aktivované. U neaktivovaných karet je
uveden důvod, proč nebyly úspěšně aktivované. U úspěšně aktivovaných je hodnota atributu „stat”
IS_OK.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype> newcard_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>3</itemscount>
<lang>cz</lang>
</header>
<items>
<newcard_ret cardsno="000000001" stat=“IS_OK“ reason=““/>
<newcard_ret cardsno="000000002" stat=“IS_ERR“ reason=“karta již byla
aktivována 21.3.2007“/>
...
<newcard_ret cardsno="000000003" stat=“IS_OK“ reason=““/>
</items>
</rootCC>
cardsno – výrobní číslo karty v hexadecimálním tvaru (povinná položka)
stat – status operace – definuje úspěšnost operace. V případě úspěchu má hodnotu IS_OK (povinná
položka)
reason – obsahuje textový důvod neprovedení operace (povinná položka)
16
Zablokovaní a odblokování a pozastavení karty + změna jejich parametrů
V systému lze zablokovat, trvale zablokovat, odblokovat a zničit kartu. Navíc je možno pomocí
tohoto XML i měnit login, heslo, poznámku, email či typ držitele ke kartě. Karty již musí být
aktivovány v systému.
Příklad XML souboru pro jednotlivé operace s kartami.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>actdeact_card</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>9</itemscount>
<lang>cz</lang>
</header>
<items>
<actdeact_card cardsno="000000001" actdeact="deact" date="2007-03-31 14:30:00"
/>
<actdeact_card cardsno="000000002" actdeact="act" date="2007-03-31 14:30:00"
/>
<actdeact_card cardsno="000000003" actdeact="deact_ever" date="2007-03-31
14:30:00"/>
<actdeact_card cardsno="000000004" actdeact="destroy" date="2007-03-31
14:30:00" />
<actdeact_card cardsno="000000005" actdeact="note" note="změna poznámky" />
<actdeact_card cardsno="000000006" actdeact="cardlogin" cardlogin="newlogin"
/>
<actdeact_card cardsno="000000007" actdeact="cardpwd"
cardpwd="newpassword" />
<actdeact_card cardsno="000000008" actdeact="email"
email="petr.rychly@gmail.com" />
<actdeact_card cardsno="000000009" actdeact="incard" />
<actdeact_card cardsno="000000010" actdeact="name" name="Jan" />
<actdeact_card cardsno="000000011" actdeact="surname" surname ="Novák" />
<actdeact_card cardsno="000000012" actdeact="birthdate" birthdate="1995-03-31"
/>
<actdeact_card cardsno="000000013" actdeact="isicno" isicno="S123456789321Y"
/>
<actdeact_card cardsno="000000014" actdeact="delete_data" type="email" />
<actdeact_card cardsno="000000015" actdeact="employer_id" employer_id="62" />
<actdeact_card cardsno="000000011" actdeact="photo" photo="asdf" />
<actdeact_card cardsno="000000011" actdeact="ver_state" ver_state="1" />
...
</items>
</rootCC>
cardsno – výrobní číslo karty v hexadecimálním tvaru (povinná položka)
17
actdeact – typ operace „act“ odblokování, „deact“ zablokování, „deact_ever“ zablokování navždy,
„destroy“ zešrotování, „note“ změní poznámku ke kartě, „cardlogin“ změní login ke kartě,
„cardpwd“ změní heslo ke kartě, “email“ změní email držitele, „incard“ = nahrání In Karty na
ODIS kartu (povinná položka), „name“ = změna jména držitele ODIS karty, „surname“ = změna
příjmení držitele ODIS karty, „birthdate“ = změna data narození držitele ODIS karty, „isicno“ =
změna čísla ISIC karty držitele ODIS karty, „delete_data“ = vymazání údaje z karty, „employer_id“
= nastavení čísla dopravce, který je zároveň zaměstnavatelem nebo zaměstnavatelem rodinného
příslušníka
date – kdy se aktivace/deaktivace má provést. Povinná pro actdeact = „act“ nebo actdeact = „deact“
nebo actdeact = „deact_ever“ nebo actdeact = „destroy“, jinak se ignoruje.
note – nová poznámka ke kartě. Povinný pro actdeact = „note“, jinak se ignoruje.
cardlogin – nový login ke kartě. Povinný pro actdeact = „cardlogin“, jinak se ignoruje.
cardpwd – nové heslo ke kartě. Povinný pro actdeact = „cardpwd“, jinak se ignoruje.
email – nový email držitele. Povinný pro actdeact = „email“, jinak se ignoruje.
name – nové jméno držitele ODIS karty. Povinný pro actdeact = „name“, jinak se ignoruje.
surname – nové příjmení držitele ODIS karty. Povinný pro actdeact = „surname“, jinak se ignoruje.
birthdate – nové datum narození držitele ODIS karty. Povinný pro actdeact = „birthdate“, jinak se
ignoruje.
isicno – nové číslo ISIC karty držitele ODIS karty. Povinný pro actdeact = „isicno“, jinak se
ignoruje.
type – typ informace k vymazání. Povinný pro actdeact = „delete_data“, jinak se ignoruje. Může
nabývat hodnot – email, name, surname, birthdate, isicno.
employer_id – kód dopravce (v případě smazání se zašle hodnota „0“)
photo – nová fotografie v base64 držitele ODIS karty. Povinný pro actdeact = „photo“, jinak se
ignoruje.
ver_state – stav oveření odis karty – 1 = ověřená, 2 = neověřená. Povinný pro actdeact =„ver_state“,
jinak se ignoruje.
Jako odpověď CC zasílá seznam karet s úspěšností, s jakou byly aktivovány nebo deaktivovány a
důvod proč se operace nezdařila.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>actdeact_card_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>3</itemscount>
<lang>cz</lang>
</header>
<items>
<actdeact_card_ret cardsno="000000001" actdeact=“deact“ stat=“IS_OK“
reason=““/>
<actdeact_card_ret cardsno="000000002" actdeact=“act“ stat=“IS_ERR“
reason=“Karta nebyla v systému ještě aktivována“/>
<actdeact_card_ret cardsno="000000009" actdeact=“ incard“ stat=“IS_OK“
reason=““/>
...
</items>
</rootCC>
18
cardsno – výrobní číslo karty v hexadecimálním tvaru (povinná položka)
actdeact - typ provedené operace - „act“, „deact“, „deact_ever“, „note“, „cardlogin“, „cardpwd“,
„email“ (povinná položka)
stat – status operace – definuje úspěšnost operace. V případě úspěchu má hodnotu IS_OK (povinná
položka)
reason – obsahuje textový důvod neprovedení operace (povinná položka)
Změna profilů na kartě
V systému lze změnit profily na kartě. Změnu profilů lze provézt jak pro vlastní, tak cizí karty.
Získání informací o změnách profilů na kartách popisuje kapitola „Stažení karet se změnami proflů
z CCMSK pomocí webové služby“, případně jak získat aktuální profily vlastních karet popisuje
kapitola „Seznam všech karet v systému“.
Změny profilů se rovněž zaznamenávají do greenlistu profilů viz kapitola „Greenlist profilů“.
Příklad XML souboru pro změnu profilů na kartě:
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>actdeact_card</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>2</itemscount>
<lang>cz</lang>
</header>
<items>
<actdeact_card cardsno="000000009" actdeact="customerprofile"
customerprofile="2" date-from="2016-05-01 14:30:00" date-to="2016-06-01
14:30:00" date="2016-05-01 14:24:26" />
<actdeact_card cardsno="000000009" actdeact="customerprofile2"
customerprofile2="50" date-from="2016-05-01 14:30:00" date-to="2016-06-01
14:30:00" date="2016-05-01 14:24:36" />
</items>
</rootCC>
cardsno – výrobní číslo karty v hexadecimálním tvaru (povinná položka)
actdeact – typ operace „customerprofile“ – změna profilu 1 na kartě, „customerprofile2“ – změna
profilu 2 na kartě (povinná položka)
customerprofile – číslo profilu 1 na kartě. Povinný pro actdeact = „customerprofile“, jinak se
ignoruje. V případě zrušení profilu 1 na kartě se zasílá hodnota „0“.
customerprofile2 – číslo profilu 2 na kartě. Povinný pro actdeact = „customerprofile2“, jinak se
ignoruje. V případě zrušení profilu 2 na kartě se zasílá hodnota „0“.
date-from – začátek intervalu platnosti profilu karty. Povinný pro actdeact=“ customerprofile“ a
actdeact=“ customerprofile2“. V případě zrušení profilu je nepovinný.
date-to – konec intervalu platnosti profilu karty. Povinný pro actdeact=“ customerprofile“ a
actdeact=“ customerprofile2“. V případě zrušení profilu je nepovinný.
19
date – datum změny profilu u dopravce. Povinný pro actdeact=“customerprofile“ a actdeact=“
customerprofile2“.
20
Jako odpověď CC zasílá seznam karet s úspěšností, s jakou byly provedeny změny profilů na kartě
a důvod proč se operace nezdařila.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>actdeact_card_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>2</itemscount>
<lang>cz</lang>
</header>
<items>
<actdeact_card_ret cardsno="000000009" actdeact=“ customerprofile“
stat=“IS_OK“ reason=““/>
<actdeact_card_ret cardsno="000000009" actdeact=“ customerprofile2“
stat=“IS_ERR“ reason=“Karta nebyla v systému ještě aktivována“/>
</items>
</rootCC>
cardsno – výrobní číslo karty v hexadecimálním tvaru (povinná položka)
actdeact - typ provedené operace - „customerprofile“, „customerprofile2 (povinná položka)
stat – status operace – definuje úspěšnost operace. V případě úspěchu má hodnotu IS_OK (povinná
položka)
reason – obsahuje textový důvod neprovedení operace (povinná položka)
Příklad XML souboru pro zrušení profilu na kartě na kartě:
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>actdeact_card</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>2</itemscount>
<lang>cz</lang>
</header>
<items>
<actdeact_card cardsno="000000009" actdeact="customerprofile"
customerprofile="0" date="2016-05-01 14:24:36" />
<actdeact_card cardsno="000000009" actdeact="customerprofile2"
customerprofile2="0" date="2016-05-01 14:24:36" />
</items>
</rootCC>
21
Greenlist profilů
Změny profilů na katě budou distribuovány pomocí Greenlistu profilů, který bude dostupné na
webové službě. Předání dat probíhá on-line, ihned po obdržení dotazu na server.
K ostré verzi CC MSK je WS dostupná na: http://clearing.kodis.cz/WebService/DataService.asmx
K testovací verzi CC MSK je WS na: http://clearing.kodis.cz/WebServiceTest/DataService.asmx
Pro získání Greenlistu profilů definujeme 1 zprávu.
Metoda Popis
GetGreenlistProfiles Vrátí seznam změn profilů na kartě
GetGreenlistProfiles()
Request Typ Popis Default Required?
Parametr String Uživatelský login provozovatele N/A Yes
UserLogin String Uživatelské heslo provozovatele N/A Yes
Password Typ (celý, inkrementální) N/A Yes
Type Int Počáteční pořadové číslo N/A No
SequenceNoStart
Response
Parametr Typ Popis Default Required?
GreenlistProfiles Verze souboru N/A No
Datum vytvoření dávky N/A No
GreenlistProfilesHeader Pořadové číslo N/A No
Typ (celý, inkremetnální) N/A No
FileVersion String Počet záznamů N/A No
Příznak, zdali došlo k resetu N/A No
IssueDateTime Datetime
Číslo čipu karty N/A Yes
SequenceNo Int CP1 – profil číslo 1
CP2 – profil číslo 2 N/A Yes
Type Číslo profilu N/A Yes
Platnost profilu od N/A Yes
ItemsCount Int Platnost profilu do N/A Yes
Číslo dopravce, který změnu provedl N/A Yes
Reset Bool Datum provedení změny N/A Yes
Jednoznačné identifikační číslo záznamu
GreenlistProfilesItem N/A Yes
Stav zpracování
Cardsno String
Type
CustomerProfile Int
ValidFrom Datetime
ValidTo Datetime
Provider int
Date Datetime
GreenlistProfileID int
ResponseStatus
ErrorCode Int
0 – OK
ErrorMessage String Jinak číslo chyby N/A Yes
Popis chyby
22
Pro odstranění záznamu z Greenlistu profilů je nutné zaslat potvrzení o nahrání do clearingového
centra.
Příklad XML souboru pro potvrzení:
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>actdeact_card</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
<actdeact_card cardsno="000000009" actdeact="greenlist-profile-confirm"
date="2016-06-01 14:24:26" greenlist-profile-id="1" />
</items>
</rootCC>
cardsno – výrobní číslo karty v hexadecimálním tvaru (povinná položka)
actdeact – typ operace „greenlist-profile-confirm“ – potvrzení o nahrání (povinná položka)
date – datum provedení potvrzení (povinná položka)
greenlist-profile-id – Jednoznačné identifikační číslo záznamu (povinná položka)
Jako odpověď CC zasílá seznam karet s úspěšností a důvod proč se operace nezdařila.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>actdeact_card_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
<actdeact_card_ret cardsno="000000009" actdeact=“greenlist-profile-confirm“
stat=“IS_OK“ reason=““/>
</items>
</rootCC>
stat – status operace – definuje úspěšnost operace. V případě úspěchu má hodnotu IS_OK (povinná
položka)
reason – obsahuje textový důvod neprovedení operace (povinná položka)
23
Seznam všech karet v systému
Z CC je možno vyexportovat seznam všech karet, které byly v systému aktivovány.
Formát XML je následující:
Dopravcům se budou vracet pouze jejich vlastní karty.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>card_list</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
<card_list/>
</items>
</rootCC>
Jako odpověď CC zasílá XML obsahující seznam karet:
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>card_list_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>n</itemscount>
<lang>cz</lang>
</header>
<items>
<card_list_ret cardsno="042C1309D61B80" cardlogin="115701" cardState"1"
providerName="KODIS" customerprofile="2" cp-date-from="2016-05-01
14:30:00" cp-date-to="2016-06-01 14:30:00" cp-date="2016-05-01 14:24:36"
customerprofile2="50" cp2-date-from="2016-05-01 14:30:00" cp2-date-to="2016-
06-01 14:30:00" cp2-date="2016-05-01 14:24:36" />
…
</items>
</rootCC>
cardsno - výrobní číslo karty v hexa (povinná položka)
cardlogin – login, pod kterým se bude klient přihlašovat k portálu (povinná položka)
cardState – stav karty: -1=zešrotovaná, 0=blokovaná/neplatná, 1=aktivní (povinná položka)
providerName – název subjektu, který poskytuje karty. Položka je povinná pokud má uživatel právo
na vrácení všech karet v systému
customerprofile – číslo profilu 1 na kartě (povinná položka)
cp-date-from – začátek intervalu platnosti profilu 1 karty (povinná položka)
cp-date-to – konec intervalu platnosti profilu 1 karty (povinná položka)
24
cp-date – datum změny profilu 1 u dopravce (povinná položka)
customerprofile2 – číslo profilu 2 na kartě (povinná položka)
cp2-date-from – začátek intervalu platnosti profilu 2 karty (povinná položka)
cp2-date-to – konec intervalu platnosti profilu 2 karty (povinná položka)
cp2-date – datum změny profilu 2 u dopravce (povinná položka)
Poznámka: karta se stavem zablokovaná navždy se vypisuje jako neplatná, tedy se stavem=0, neboť
se jedná o neplatnou kartu.
Poznámka: karta se stavem sešrotována se záměrně vypisuje se stavem -1, ačkoliv se jedná rovněž o
neplatnou kartu, z důvodu rozlišení, že tyto karty se již v systému nemohou vyskytnout, neboť
fyzicky neexistují.
25
Aktivace zařízení
Tento XML soubor se posílá jako seznam aktivovaných zařízení u daného provozovatele. Jednou
použité číslo zařízení se nedá již znovu použít ani po zablokování předcházejícího zařízení. Zařízení
je možné aktivovat (stejně jako další operace) pouze pomocí XML souboru. XML však lze rovněž
nahrát ručně přes webové rozhraní.
Příklad XML souboru pro aktivaci nového zařízení.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>newdevice</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>3</itemscount>
<lang>cz</lang>
</header>
<items>
<newdevice device-id="000000001" samno="000000000000A105" cashno="1"
max_counter="100000" valid_from="2003-05-31 12:33:27" valid_to="2005-06-
01 00:00:00" where="tu" note="první zařízení" premise="jídelna1"/>
<newdevice device-id="000000002" samno="000000000000A106" cashno="2"
max_counter="100000" valid_from="2003-05-31 12:33:27" valid_to="2005-06-
01 00:00:00" where"tu" note="první zařízení" premise="jídelna2"/>
...
<newdevice device-id="000000003" samno="000000000000A107" cashno="3"
max_counter="100000" valid_from="2003-05-31 12:33:27" valid_to="2005-06-
01 00:00:00" where="tu" note="první zařízení" subprovider="ČZU"
premise="jídelna3"/>
</items>
</rootCC>
Jednotlivé atributy mají následující vlastnosti
device-id – číslo zařízení. Musí být u daného provozovatele jedinečné a nedá znovu použít pro jiné
zařízení i po zakázání předchozího (povinná položka)
samno – je číslo SAM modulu v hexadecimálním formátu (nepovinná položka)
cashno – dekadické číslo pokladny (nepovinná položka)
premise - provozovna provozovatele, kterému patří dané zařízení (nepovinná položka)
max_counter – maximální počet transakcí na daném zařízení (poslední hodnota použitelná pro
řadu). Indikuje, kdy se číselník transakcí na zařízení vynuluje. Je nutné, aby hodnota čítače se
„neotočila“ (nevynulovala) za časový úsek menší než 24 hodin (povinná položka)
valid_from – datumový začátek platnosti zařízení (povinná položka)
valid_to – datumový konec platnosti, zařízení - Clearing akceptuje největší možnou hodnotu
31.12.9999. Je však vhodné zařízení aktivovat s „rozumnou“ hodnotou, např. 31.12.2050 apod. –
toto platí pro všechny atributy, které se týkají časového rozsahu (povinná položka)
where – textový popis místa, kde je zařízení umístěno (nepovinná položka)
note - umožňuje přidat k zařízení poznámku (nepovinná položka)
subprovider - umožňuje zařízení přiřadit k departmentu (oddělení), jehož kód je v atributu zadán
(nepovinná položka)
26
print – identifikace samoobslužného zařízení bez tisku (1 = klasické zařízení, 2 = samoobslužné bez
tisku). Pokud není vyplněno, tak se bere jako klasické zařízení. (nepovinná položka)
Jako odpověď CC zasílá seznam zařízení, která byla úspěšně aktivovaná. U neaktivovaných
zařízení je uveden důvod, proč nebyly úspěšně aktivované. U úspěšně aktivovaných je hodnota
IS_OK.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype> newdevice_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>3</itemscount>
<lang>cz</lang>
</header>
<items>
<newdevice_ret device-id="1" stat="IS_OK" reason=""/>
<newdevice_ret device-id="2" stat="IS_ERR" reason="Zařízení již bylo
aktivováno"/>
...
<newdevice_ret device-id="3" stat"IS_OK" reason=""/>
</items>
</rootCC>
device-id – dekadické číslo zařízení, Musí být u daného provozovatele jedinečné (povinná položka)
stat – status operace – definuje úspěšnost operace. V případě úspěchu má hodnotu IS_OK (povinná
položka)
reason – obsahuje textový důvod neprovedení operace (povinná položka)
Zablokovaní a odblokování zařízení
V systému lze zablokovat a odblokovat zařízení, změnit poznámku a umístění zařízení, i jeho
přiřazení k departmentu. Zařízení již musí být aktivováno v systému.
Příklad XML souboru pro zablokování a odblokování zařízení.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>actdeact_device</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>n</itemscount>
<lang>cz</lang>
27
</header>
<items>
<actdeact_device device-id="1" actdeact=“deact“ date=“2007-03-31 14:30:00“
where=“tu“ note=“zablokovaní zařízení“/>
<actdeact_device device-id="1" actdeact=“act“ date=“2007-03-31 14:30:00
where=“tu“ note=“znovu obnovené zařízení“/>
<actdeact_device device-id="1" actdeact=“subprovider“ subprovider=”MAUR”/>
<actdeact_device device-id="1" actdeact=“samno“ samno=”000000000000A4F5”/>
<actdeact_device device-id="1" actdeact=“cashno“ cashno=”5”/>
<actdeact_device device-id="1" actdeact=“premise“ premise=”jídelna4”/>
…
</items>
</rootCC>
device-id – dekadické číslo zařízení (povinná položka)
actdeact – typ operace „act“ aktivace, „deact“ deaktivace, „deact_ever“ deaktivace navždy, „note“ –
změní se poznámka ke kartě, „where“ změní se umístění zařízení, „subprovider“ změní
přiřazení zařízení k departmentu, „samno” změní číslo SAM modulu, „cashno“ změní číslo
pokladny, “premise” změní provozovnu provozovatele, kterému patří dané zařízení, „print“
změní typ tisku na zařízení (povinná položka)
date – kdy se aktivace/deaktivace má provést. Povinná pro actdeact = „act“ nebo actdeact = „deact“
nebo actdeact = „deact_ever“, jinak se ignoruje.
note – nová poznámka k zařízení. Povinný pro actdeact = „note“, jinak se ignoruje.
where – místo, kde je zařízení umístěno. Povinný pro actdeact = „where“, jinak se ignoruje.
subprovider - umožňuje změnit přiřazení zařízení k departmentu, jehož kód je v atributu zadán.
Povinný pro actdeact = „subprovider“, jinak se ignoruje.
samno - umožňuje změnit číslo SAM modulu. Povinný pro actdeact = „samno“, jinak se ignoruje.
cashno - umožňuje změnit číslo pokladny. Povinný pro actdeact = „cashno“, jinak se ignoruje.
premise - umožňuje změnit provozovnu provozovatele, kterému patří dané zařízení. Povinný pro
actdeact = „premise“, jinak se ignoruje.
print – identifikace samoobslužného zařízení bez tisku (1 = klasické zařízení, 2 = samoobslužné bez
tisku). Pokud není vyplněno, tak se bere jako klasické zařízení. Povinný pro actdeact = „print“,
jinak se ignoruje.
Jako odpověď CC zasílá seznam zařízení s úspěšností, s jakou byly aktivovány nebo deaktivovány a
důvod proč se operace nezdařila.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>actdeact_device_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>3</itemscount>
<lang>cz</lang>
</header>
<items>
<actdeact_device_ret device-id="1" actdeact=“deact“ stat=“IS_OK“ reason=““/>
<actdeact_device_ret device-id="1" actdeact=“act“ stat=“IS_OK“ reason=““/>
28
</items>
</rootCC>
cardsno – dekadické číslo zařízení (povinná položka)
actdeact - typ provedené operace - „act“, „deact“, „deact_ever“, „note“, „where“, „subprovider“,
„samno”, „cashno“, “premise”.
stat – status operace – definuje úspěšnost operace. V případě úspěchu má hodnotu IS_OK (povinná
položka)
reason – obsahuje textový důvod neprovedení operace (povinná položka)
29
Transakce na zařízení
Systém transakcí nebude používat odpočty, transakce bude identifikována číslem transakce, které je
unikátní v rámci zařízení. Každé aktivované zařízení musí zaslat seznam transakcí za každý den i
v případě, že na něm žádná transakce neproběhla nebo v případě, že zařízení není provozováno,
postačí zaslat alespoň jednou k poslednímu dni v měsíci, a to do termínu dle Smlouvy o dělbě tržeb.
Nebude-li zařízení delší dobu používáno, např. u záložních zařízení, je možno jej zablokovat (viz
kapitola Zablokování a odblokování zařízení. Je-li zařízení zablokováno, nejsou z něj, od doby
zablokování, na Clearing zasílány transakce.
Nezašle-li dopravce veškeré, transakce za daný měsíc za všechny strojky (včetně prázdných
transakcí k poslednímu dni v měsíci, pokud aktivované strojky nebyly v provozu), potvrdí KODISu
úplnost zaslaných transakcí e-mailem do termínu stanoveného pro zasílání transakcí platnou
smlouvou o dělbě tržeb, pak bude provedeno rozúčtování transakcí tak, jako by byly úplné. Pokud
bude rozúčtování již provedeno, není možno již žádné zpětné zaslání transakcí.
Je-li známo, že některá data nebude možno vyčíst, dopravce sdělí tuto skutečnost KODISu mailem
do termínu stanoveného pro zasílání transakcí platnou smlouvou o dělbě tržeb.
Storno transakcí je řešeno na zařízení, pokud zařízení již odešle transakci na clearing, transakce je
zaúčtována. Stornování se provádí přes reklamace a storno viz Reklamace.
Název zasílaného souboru je doporučen následovně:
T1267275_110429_00763.xml
XXXXXXX_RRMMDD_ZZZZZ
Kde:
XXXXXXX – výrobní číslo terminálu
RRMMDD – rok, měsíc a den otevření odpočtu
ZZZZZ – číslo počátečního lístku, pořadové číslo transakce v rámci terminálu
Pomocí tohoto XML se do systému vkládají transakce.
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="3"
depozitcount="1" sumcount="4" vat="5" premise="1">
<transaction card-id="000000001" appl-id="0" when="1.1.2007 14:05:00"
type="dep" amount="300" vat="5" balance_after="300" tx-id ="0"
transtype="DPI" transtypetext="" note="první dobití" tranret="a1" currency =
"CZK"/>
...
</transactions>
U transakcí se nesmí číslo transakce v atributu tx-id v rámci jednoho zařízení otočit dříve než
nastane hodnota definovaná při aktivací zařízení u atributu max_counter. Pokud je potřeba otočit
číslo dříve než nastane hodnota definovaná u zařízení je potřeba, informovat CC o změně řady
speciální transakcí (type=“devcounter“).
30
Element <transactions> obsahuje atributy:
device-id – číslo zařízení (jedinečné v rámci dopravce) v desítkové soustavě od 0 do 999999999999
(povinná položka)
samno – Číslo SAM modulu (Security Access Module), jedinečné v rámci kraje, v desítkové
soustavě (povinná položka, kromě případu kde není dostupná čtečka karet - prodej
papírových jízdenek/kupónů)
cashno – Číslo pokladny (jedinečné v rámci dopravce) v desítkové soustavě (integer) (nepovinná
položka)
paycount – Celkový počet následujících vybíjecích (debetních) transakcí na daném zařízení -
hodnota v EP se touto transakcí snižuje (povinná položka)
depozitcount – Celkový počet následujících dobíjecích (kreditních) transakcí na daném zařízení -
hodnota v EP se touto transakcí zvyšuje (povinná položka)
sumcount – Celkový počet následujících transakcí v řádcích. Kontroluje se při příjmu transakcí
(povinná položka)
vat – Sazba daně z přidané hodnoty DPH v procentech [%] na daném zařízení platná pro následující
transakce, pokud se neurčí jiná sazba DPH u jednotlivé samotné transakce (povinná
položka)
premise - Číslo provozovny dopravce, do které náleží dané zařízení (maximálně 20
alfanumerických znaků) (nepovinná položka)
Element <transaction> obsahuje atributy:
tx-id – Pořadové číslo transakce na zařízení (v desítkové soustavě). Pokud je atribut
type=“devcounter“, potom hodnota tx-id musí obsahovat hodnotu počítadla transakcí po
předčasném přerušení číselné řady - předčasném „přetočení“ počítadla transakcí (povinná
položka) Existuje výjimka, kdy číslo transakce muže být stejné a nejedná se o multi
transakci – jde o stornování následující transakce pro ČD - viz příklad 26. V případě použití
transakce typu „odp“ se transakčí řada nepřerušuje, ale pokračuje dále aby byla zachována
posloupnost (tx-id odp transakce = poslední tx-id + 1).
card-id – Výrobní číslo čipu karty (v šestnáctkové soustavě) přidělené výrobcem čipu karty
(jednoznačné pro všechny karty na světě) (povinná položka pro práci s kartou)
appl-id - Číslo aplikace (AID) na kartě v desítkové soustavě (pro aplikaci jízdenka je „4609“ a pro
aplikaci EP je „34965“). Současně obsahuje také typ karty (povinná položka pro práci s
kartou)
type - Typ operace. Hodnota (částka – atribut amount) transakce je vždy kladná. Typ operace pak
rozlišuje, zda se jedná o kreditní nebo debetní operaci. Kreditní operace hodnotu v
elektronické peněžence EP zvýšila a debetní operace hodnotu v EP snížila. Typ operace
„dep“ představuje kreditní operaci, „pay“ debetní operaci a „devcounter“ se používá v
případě, jestliže dojde ke změně číselné řady na daném zařízení dříve, než dojde k jeho
přirozenému přetečení, potom je nutno zaslat transakci s typem transakce devcounter, který
31
oznamuje, že číselná řada transakcí začíná znovu (první hodnota řady je 1.) a v položce tx-id
je uvedeno nové počáteční číslo transakce. Typ operace „odp“ udáví informační transakci,
že zařízení nezaslalo žádné transakce. Toto je nutné pro kontrolu doručených transakcí za
daný den. (povinná položka)
amount-type – Způsob platby: definuje způsob platby (v hotovosti, elektronickou peněženkou EP,
bankovní platební kartou, atd.). Konstanta „cash“ definuje hotovostní platbu, kdy se
nepracuje z EP, „ep“ platbu elektronickou peněženkou nebo práce s elektronickou
peněženkou (při nabíjení hotovostí zde bude „ep“), “card“ platbu bankovní platební kartou,
“ultralight“ platbu ultralight kartou, "bank" platbu převodem, „prepaid“ použito v případě
že probíhá jízda na předplacený kupón nebo jízdenku, „ep-cash“ – vracení části peněz z EP,
„move“ – slouží k identifikaci vybití peněženky na staré kartě nebo na nabití při převodu
peněz ze staré karty. Pro transakce zasílané ze strojků do CC MSK provedené nad kupónem
na základě green-listu se používá hodnota “eshop”, pro mobilní aplikace se používá
„mobile-app“ (povinná položka).
transtype – Typ transakce definuje, co která transakce představuje. „Například: jízda v MHD, nákup
jízdenky na MHD, parkování, parkování u obchodního domu v Ostravě, atd. Univerzální typ
(jiný) je „uni“. „mhd“ je jakákoliv jízda (check-in / check-out), „mhdp“ nákup časové
jízdenky, „park“ parkování, „parkobos“ parkování u obchodního domu v Ostravě,
„mhdpr“ – reklamace kuponu, „mhdr“ – reklamace jízdy nebo ZS. V případě transakcí
prováděných s kartami, které nepatří do CCMSK a je s nimi prováděna operace na
zařízeních kdy dochází k změně čísla transakce na zařízení, musí být odesílána vyrovnávací
transakce, pak transtype obsahuje „outside-odis“. Jako označení stornování transakce se
uvádí v tomto tagu hodnota „cancel“.
Pro případ zasílání jen nákupu kilometrické jízdenky se zde uvádí „mhdtb“ (ticket buy) –
pro označení nákupu a ne jízdy. Musí však platit, že pak samotná jízda musí zasílat stále
všechny požadované informace jako cenu, zs, atd.
Pro žádosti z e-shopu se používají hodnoty “eshop-ep” pro dobití EP a “eshop-c” pro dobití
kupónu, „eshop-epr“ pro reklamaci dobití EP.
Pro nedokončené transakce se používá hodnota „incomplete“.
Pro přiložení bankovní karty (tapnutí) k terminálu se používá hodnota „tap“, „cd“ pro
nákup ve vlacích ČD (slouží pouze pro kontrolu – nejde do dělby tržeb z věty kodis), pro
práci s ultralight kartou se používá hodnota „ultralight“, pro reklamační dobití/vybití na
kontaktním místě KODIS se používá hodnota „reclamation“ (povinná položka).
jumboaccount – Příznak u transakcí pracujících s JUMBO účtem (podobně jako u peněženky EPIK
na In-kartě Českých drah). V případě hodnoty “yes” se pracuje s JUMBO účtem a v případě
hodnoty „no“ se pak s JUMBO účtem nepracuje (nepovinná položka)
when – datum a čas vzniku transakce (povinná položka)
baseamount – Ceníková základní hodnota (částka) transakce před slevami (nepovinná položka)
amount – Skutečná hrazená hodnota (částka) transakce odečtená z EP nebo v hotovosti nebo
platební kartou po všech slevách s DPH. Pouze pokud je Typ operace type „pay“ nebo
„dep“. Při „“devcounter“ se je „0“. Při jízdě na časový lístek je „0“ povinná položka pokud
type je „pay“, „dep“ nebo „devcounter“.
currency – Peněžní měna, ve které byla provedena transakce (pokud není uvedena, je automaticky
měnou Kč - standardní hodnota pro Kč je „CZK“) (nepovinná položka)
32
vat – Sazba daně z přidané hodnoty DPH v procentech [%] v případech, kdy se sazba DPH liší od
společné daně DPH na zařízení uvedené v hlavičce transakcí (povinná položka pro
předplacenou jízdu na kupón – uvádí se hodnota DPH 0)
balance_before – Zůstatek (hodnota) v elektronické peněžence EP před provedením transakce s EP
(povinná položka v případě práce s EP)
balance_after – Zůstatek (hodnota) v elektronické peněžence EP po provedení transakce s EP
(povinná položka v případě práce s EP)
departure-id – Jako první je uvedeno číslo nástupní zastávky podle CIS JŘ a jako druhé je uvedeno
tarifní číslo nástupní zastávky, čísla jsou oddělená středníkem. (Povinná položka v případě
transakce související s nástupem do vozidla)
departure-zone – Číslo tarifní zóny nástupní zastávky (Povinná položka v případě transakce
související s nástupem do vozidla)
arrival-id – Jako první je uvedeno číslo výstupní zastávky podle CIS JŘ a jako druhé je uvedeno
tarifní číslo výstupní zastávky, čísla jsou oddělená středníkem (Povinná položka v případě
transakce související s výstupem z vozidla)
arrival-zone – Číslo tarifní zóny výstupní zastávky (check-out). Při odbavení jednorázové jízdenky
(check-in), kde cestující hlásí dopředu výstupní zastávku, bude uvedena zóna této výstupní
zastávky. V ostatních případech bude uvedena zóna poslední zastávky daného spoje. Při
odbavení kupónu, kde cestující hlásí dopředu výstupní zastávku, bude uvedena zóna této
výstupní zastávky, v ostatních případech bude uvedena nepovinně zóna poslední zastávky
daného spoje. (Povinná položka v případě transakce související s výstupem a nástupem
z/do vozidla)
passes-through-id – Jako první je uvedeno číslo zastávky podle CIS JŘ, kterými vozidlo projíždí a
jako druhé je uvedeno tarifní číslo výstupní zastávky, čísla jsou oddělená středníkem
(neovinná položka – určeno pro ČD)
zone – Seznam tarifních zón, pro které platí zakoupený časový kupón na kartě (pouze pro transakce
s hodnotou atributu transtype = “mhdp“). Zóny jsou odděleny středníkem. Lze uvést
maximálně deset zón (Povinná položka v případě práce s kupóny). Pro síťovou jízdenku se
zde uvádí číslo 352.
Od 2. 7. 2017 změna zóny 354 na 78.
line – Číslo linky podle CIS JŘ, na kterou je provedena transakce (Povinná položka v případě
transakce související s jízdou)
V případě prodeje kupónů se v čísle linky zasílá číslo prodejního místa.
Druh Dopravce a provozovna Kód Číslo Možná
MHD Nový Jičín
Technické služby města Nového Jičína, Dopravce provozovny předprodej
PAD příspěvková organizace
PAD (KOVED) ARRIVA MORAVA a.s., provozovna R05 (804) 804xxx
PAD Zlín I
(KOVED) Transdev Morava s.r.o., provozovna _ARRIVA 823 823xxx
Vsetín I
_TM 827 827xxx
ARRIVA MORAVA a.s., provozovna Bruntál
ARRIVA 850 850xxx
33
PAD Osoblažská dopravní společnost s.r.o. ODS 851 851xxx
PAD Transdev Morava s.r.o., oblast Krnov TM 852 852xxx
TM 853 853xxx
PAD Transdev Morava s.r.o., oblast Bruntál TM 854 854xxx
ARRIVA R02 (855) 855xxx
PAD Transdev Morava s.r.o., oblast Rýmařov TM 855 855xxx
ARRIVA 856 856xxx
MHD Bruntál ARRIVA MORAVA a.s. do 31.12. 20183) ČSADFM 860 860xxx
MHD Bruntál Transdev Morava s.r.o. ARRIVA 861 861xxx
MHD Krnov ARRIVA MORAVA a.s. ČSADFM 861 861xxx
PAD ČSAD Frýdek-Místek a.s. ČSADVS 862 862xxx
ČSADFM 863 863xxx
PAD ARRIVA MORAVA a.s., provozovna Třinec (nikdy ČSADFM 864 864xxx
PAD nic nevykazovala)2) ČSADFM 865 865xxx
PAD ČSAD Frýdek-Místek a.s., oblast FM III. do ARRIVA 866 866xxx
8.6.2019 ČSADKA 870 870xxx
ČSADHA 871 871xxx
Z-Group bus a.s., oblast Jablunkov, Třinec ČSADHA 872 872xxx
ČSADKA 873 873xxx
PAD ČSAD Frýdek-Místek a.s., oblast Frýdek - Místek ČSADKA 874 874xxx
ARRIVA 875 875xxx
PAD ČSAD Frýdek-Místek a.s., oblast Frýdlant ČSADHA 876 876xxx
ČSADKA 877 877xxx
MHD Frýdek-Místek ČSAD Frýdek-Místek a.s. ČSADKA 878 878xxx
MHD Třinec ARRIVA MORAVA a.s. ARRIVA 880 880xxx
PAD ČSAD Karviná a.s. TM 882 882xxx
ČSADVS 883 883xxx
PAD ČSAD Havířov a.s., oblast Český Těšín 884 884xxx
TM 885 885xxx
PAD ČSAD Havířov a.s., provozovna Havířov ARRIVA 886 886xxx
ARRIVA 887 887xxx
PAD ČSAD Karviná a.s., oblast Karviná R01 (890) 890xxx
TM 890 890xxx
PAD ČSAD Karviná a.s., oblast Orlová ARRIVA 891 891xxx
VOJTILA 900 900xxx
MHD Český Těšín ARRIVA MORAVA a.s. ARRIVA 901 901xxx
902 902xxx
MHD Havířov ČSAD Havířov a.s. (částečně v ODIS) TQM 903 903xxx
TQM 904 904xxx
MHD Karviná ČSAD Karviná a.s. ČSADVS 905 905xxx
ČSADVS
MHD Orlová ČSAD Karviná a.s. ČSADHA 910 910xxx
MDPO
PAD ARRIVA MORAVA a.s., oblast Bílovec do 911 911xxx
8.6.2019 ARRIVA
PAD Transdev Morava s.r.o., oblast NJ západ R03 (912) 912xxx
PAD Z-Group bus a.s., oblast NJ východ ARRIVA
PAD 912 912xxx
Transdev Morava s.r.o., oblast Bílovec ARRIVA
R04 (913) 913xxx
MHD Studénka ARRIVA MORAVA a.s. do 31.12. 2018 ČSADHA
913 913xxx
MHD Nový Jičín ARRIVA MORAVA a.s. ČSADKA
914 914xxx
MHD Studénka Transdev Morava s.r.o. ČSADHA
915 915xxx
PAD ARRIVA MORAVA a.s., provozovna Olomouc1) TM
34
PAD Vojtila Trans s.r.o. DPO
PAD ARRIVA MORAVA a.s., provozovna Olomouc SV
PAD TQM-holding s.r.o., oblast Opava do 8.6.2019
PAD TQM-holding s.r.o., oblast Vítkov do 8.6.2019
PAD Z-Group bus a.s., oblast Opava
PAD Z-Group bus a.s., oblast Vítkov
PAD ČSAD Havířov a.s., oblast Hlučín
MHD Opava Městský dopravní podnik Opava, a.s.
PAD ARRIVA MORAVA a.s., oblast Hlučín II. do
PAD 31.8.2019
PAD ARRIVA MORAVA a.s., oblast Hlučín III. do
31.8.2019
ARRIVA MORAVA a.s., oblast FM I. do 8.6.2019
PAD ČSAD Havířov a.s., oblast Havířov 1 ( od 1.1.
PAD 2021)
ČSAD Karviná a.s., oblast Hlučín II. do 13.6.2020
PAD ČSAD Havířov a.s., oblast Havířov 2 ( od
PAD 1.1.2021)
Transdev Morava s.r.o., oblast Hlučín I. do
MHD Ostrava 13.6.2020
Dopravní podnik Ostrava a.s.
PAD ARRIVA MORAVA a.s., provozovna Přerov ARRIVA 920 920xxx
930xxx
PAD ARRIVA MORAVA a.s., provozovna Šumperk ARRIVA 930 940xxx
PAD Z-Group bus a.s., provozovna Vsetín (není ČSADVS 940 948xxx
PAD v ODIS) 950xxx
_TQM 948
(KOVED) TQM-holding s.r.o., provozovna
Valašské Meziříčí II
PAD ARRIVA MORAVA a.s., provozovna Jeseník ARRIVA 950
České dráhy, a.s.,oblast 1 CeskeDrahy 982
České dráhy, a.s.,oblast 2 CeskeDrahy 983
České dráhy, a.s.,oblast 3 CeskeDrahy 984
České dráhy, a.s.,oblast 4 CeskeDrahy 985
České dráhy,a.s.,oblast 5 CeskeDrahy 986
České dráhy,a.s., oblast 6 CeskeDrahy 987
České dráhy, a.s.,oblast 7 CeskeDrahy 988
České dráhy,a.s., oblast 8 CeskeDrahy 989
MBM rail s.r.o MBM 992
KODIS APK provozovna KODISEAPK 993
KODIS E-SHOP provozovna KODISE- 994
SHOP
KODIS EMV provozovna KODISEMV 995
RegioJet a.s. RJ 996
KODIS provozovna KODIS 997
GW Train Regio GWTR 998
České dráhy,a.s., CeskeDrahy 999
Aktuální ke dni 1. 1. 2021.
Modře dopravci, kteří v ODIS nejsou nebo v ODIS ukončili provoz
Poznámky:
1): 1.1.2018 byla ARRIVA MORAVA a.s., provozovna Olomouc PAD č. 890 zrušena (v DB zůstala pod č. R01) a Vojtila Trans
s.r.o. PAD převzala číslo provozovny 890.
2): 9.12.2018 byla ARRIVA MORAVA a.s., provozovna Třinec zrušena a nahradila ji ČSAD Frýdek-Místek a.s., oblast FM III.
3): 31.12.2018 byla ARRIVA MORAVA a.s., MHD Bruntál č. 855 zrušena (v DB zůstala pod č. R02) a Transdev Morava s.r.o.,
MHD Bruntál převzala číslo provozovny 855.
Prodej kupónu bude nejprve přidělen dopravci, který ho prodal. Následně pokud má dopravce
několik provozoven, bude prodej pod konkrétní provozovnu přidělen na základě prvního trojčíslí
uvedené linky v transakci dle číselníku.
Pokud bude chtít dopravce, aby zakoupené časové kupóny na přepážce (popřípadě i e-shop) spadaly
pod konkrétní provozovnu, bude muset upravit prodejní SW tak, aby prodeje byly zasílány
v transakci s číslem linky, která by identifikovala provozovnu i přepážku v rámci provozovny.
Číslování linky obsahuje v prvých 3 číslicích číslo provozovny a čísla přepážek budou číslovány od
999 sestupně (998, 997 atd.).
název prodej ve prodej u
oblasti v číslo vozidle kamenný vlakové
vlaky ČD stav k 2021 dle oblastí CC provozovny (validátor) předprodej čety
Velká smlouva na výkony na většině
území MSK oblast 1 982 982999 982998 982997
Smlouva na výkony na trati 323 území
MSK (jednotky Push Pull) oblast 2 983 983999 983998 983997
Smlouva na výkony na tratích 270 a 320
území MSK (ne ROP) oblast 3 984 984999 984998 984997
Smlouva na výkony na trati 323 území
ZLK oblast 4 985 985999 985998 985997
35
výkony ROP oblast 5 986 986999 986998 986997
výkony MD (R27) oblast 6 987 987999 987998 987997
výkony R27 IC (Opava - Ostrava) oblast 7 988 988999 988998 988997
výkony R8 oblast 8 989 989999 989998 989997
sequence – Číslo spoje podle CIS JŘ, na kterou je provedena transakce (Povinná položka v případě
transakce související s jízdou). Nebo číslo vlaku (vždy jedinečné tří až šestimístné číslo).
tariff – Atribut určuje platnost jízdenky - vyjádřeno dle číselníku KODIS položkou TP – Tarif
Profile): (Povinná položka v případě transakce obsahující tarif)
Kombinace vychází z číselníku tarifů, který je dostupný v samostatném dokumentu. Při
zaslání transakce s kombinací tarifu, která není v číselníku, nebude transakce zpracována
v rámci dělby tržeb.
tariff-type – Typ jízdenky určuje druh jízdenky - vyjádřeno „JD“ - jednotlivá, „PP“ - předplatní,
„PS“ - přestupní, „NP“ - nepřestupní, atd. Hodnota NP se používá pouze pro označení
elektronické nepřestupní jízdenky z ceníku pro jednotlivé jízdné Ostrava XXL s kartou
ODISka zasílané v jedné transakci, neplatí pro dvě transakce. (Povinná položka v případě
transakce obsahující tarif.)
in-zone – Tarifní oblast v rámci jednorázového jízdného (včetně jízdy při přestupu): Ostrava,
Opava, Region, atd. (Nepovinná položka, lze použít v případě transakce související s jízdou)
base-rate – Atribut říká, zda byla použita základní sazba (obdoba platby při nástupu do TAXI).
První jednotlivé jízdné bude se základní sazbou, další přestupní jízdné bude bez základní
sazby. První jednotlivé jízdné bude se základní sazbou „zs“, další přestupní jízdné bude bez
základní sazby „0“ (Povinná položka v případě transakce související s jízdou)
person-type – Typ osoby - vyjádřeno dle číselníku KODIS položkou CP – Customer Profile anebo
jako multilístek s označením 99. (Povinná položka v případě transakce obsahující tarif)
Kombinace vychází z číselníku tarifů, který je dostupný v samostatném dokumentu. Při
zaslání transakce s kombinací tarifu, která není v číselníku, nebude transakce zpracována
v rámci dělby tržeb.
valid-from – platnost jízdenky od. (Povinná položka v případě transakce obsahující časový tarif)
valid-to – platnost jízdenky do. (Povinná položka v případě transakce obsahující časový tarif)
km_count – počet kilometrů u kilometrické jízdenky (Povinná položka v případě transakce
obsahující kilometrický tarif)
zones – Čísla uznaných zón, kterými cestující na zakoupenou jízdenku projede a které jsou zároveň
platné pro aktuálně zakoupené kupóny (pouze pro transakce s hodnotou atributu transtype
jinou, než “mhdp“). Obsahuje maximálně 10 zón oddělených středníkem.
Vyplňuje se také při odbavení jednotlivé jízdenky MHD (pro danou oblast MĚSTO), kde
cestující hlásí dopředu výstupní zastávku, budou uvedeny zóny daného spoje mezi nástupní
a výstupní zastávkou. V ostatních případech, budou uvedeny zóny do poslední zastávky
daného spoje. (Povinná položka v případě transakce související s jízdou)
36
Pro jednotlivé jízdenky kilometrické se nevyplňuje.
Od 2. 7. 2017 změna zóny 354 na 78.
chech-in – Čas nástupu do vozidla (Neovinná položka, lze použít v případě transakce související s
jízdou při použití čipové karty)
check-out – Čas výstupu z vozidla (neovinná položka, lze použít v případě transakce související s
jízdou při použití čipové karty pro nákup jednotlivého regionálního jízdného a při využití
zkráceného městského jízdného)
check-km – počet projetých kilometrů v rámci „check-in“ a „check-out“ (nepovinná položka)
transtypetext – Popisem transakce je například: Parkovací místo u ZOO - uvádí se pouze, pokud je
hodnota atributu transtype „uni“ (nepovinná položka)
loyalty – Počet získaných věrnostních bodů za transakci (nepovinná položka)
note – Poznámka k transakci (nepovinná položka, vhodné použít pro reklamace, storna, převody
kuponu atd.). Uvádí se zde například informace o přesunu kuponu s číslem karty, nebo
pokud se jedná o storno transakci z určitého důvodu ap. Tuto informaci zákazník vidí na
výpisu transakcí. Při zpracování není brán zřetel na obsah.
tranret – Vrací se zpět v rámci potvrzení jednotlivých transakcí. Slouží k jednoznačné identifikaci
transakce v rámci clearingové operace (nepovinná položka)
serviceid – jednoznačný identifikátor transakce/služby, používá se pro koupi předem definovaných
služeb (nepovinná položka)
eshop-tr-id – jednoznačné číslo transakce vygenerované na straně CC. Povinné pro dobití EP nebo
kupónu přes e-shop a také pro transakce ze strojků, které byly provedeny na základě
transakcí z green-listu EP/kuponu.
passengers-count – položka informující, že se jedná o hromadnou jízdenku, kde je více cestujících
započítaných v jedné ceně (povinné v případě pořízení kuponu přes eshop –
transtype=eshop-c). V případě pořízení kupónu přes e-shop je passengers-count=“1“. Na e-
shopu není možné nahrát jeden kupón pro více držitelů karet. (Pro dokupované jizdenky
DPO, které se zapisují do benefitu bude uváděn passenger-count dle skutečnosti.)
tiket-id – jedná se o číslo jízdenky (nepovinná položka pro dopravce kteří mají stejné číslo jízdenky
a číslo transakce). Existují totiž dopravci, kteří nemají stejné číslování jízdenky a číslo
transakce a pak by nebylo možno s takovou transakcí jednoduše pracovat. Tiket-id se týká
vytištěné jízdenky, v případě např. check-out transakce nebude vydávána (nebude tištěna).
transfer-time – datum a čas pro uznání přestupu (povinný u jízdy na kupón na bankovní kartu)
fare-id – jednoznačná indentifikace jízdenky pro mobilní aplikace (povinná při nákupu mobilní
jízdenky, tak při jízdě na předplacenou mobilní jízdenku)
fare-label – název uplatněné slevy (nepovinná položka)
pay-id – identifikátor platby platební bránou (nepovinná položka)
37
fare-provider-cin – IČ dopravce (povinná položka)
fare-qr-check – výsledek odbavení na QR kód, zda byl přijat (hodnota = 1) nebo odmítnut (hodnota
= 0) (nepovinná položka)
network-id – identifikace dopravního systému pro případné přeposlání transakcí na korektní
clearingové centrum (povinné pro ČD)
Tagy pro multitransakce.
U všech multi transakcí je uvedeno stejné číslo transakce s tím, že musí být povinně uvedeny dva
tagy multi-index a multi-sum.
multi-index – jedná se o index multitransakce (v rámci jedné multi-transakce musí být unikátní)
multi-sum – jedná se o počet multi transakcí v jedné multitransakci. Nutné pro kontrolu dodaných
transakcí.
Další tagy se používají jen pro případy reklamací jízdy, zs, karty, kuponu atd.
card-kodis-id – Číslo karty v systému ODIS (v desítkové soustavě - 20 cifer).(Povinná položka u
reklamací pro převod EP/tarifu a nebo vyplacení peněz z EP pro ztracenou či vadnou kartu)
reclamation-provider – kód dopravce, který vlastní zařízení na kterém došlo k chybě (povinná
položka pro reklamace spojené s reklamování ZS a jízdy).
reclamation-device – číslo zařízení, kde byla reklamovaná transakce provedena. (povinná položka
v případě reklamace jízdy a ZS)
reclamation – Číslo reklamované transakce pod, kterou byla v systému CCMSK vedena (číslo lístku
dle našich informací – uvádějte jako celé číslo), jedná se o povinnou položku v případě
reklamace (pro případy reklamace ve vozidle, reklamace karty, reklamace vrácení poměrné
části kuponu je hodnota tohoto tagu je 0.
supplementary-date – jedná se o datum, kdy byla transakce provedena. Povinné pro některé typy
reklamací.
reclamation-multi-index – jedná se o číslo multi-indexu pro reklamování multi transakce.
clearing-id – jedná se o identifikaci koordinátora (bez atributu = výchozí = KODIS). Pro
koordinátora KOVED použijte hodnotu „koved“ (nepovinná položka).
Tagy pro práci s bankovní kartou:
card-emv-token – číslo tokenu bankovní karty
card-emv-block-noticed – identifikátor stavu, zda cestující obdržel informaci o umístnění bankovní
karty na denylist (0 = karta není na denylistu, tzn. cestující informaci neobdržel; 1 = karta je
na denylistu, tzn. cestující informaci obdržel)
card-emv-taplist-number – pořadové číslo taplistu v rámci vozidla
38
card-emv-vehicle-number – identifikátor vozidla
cp-date-to – konec platnosti profilu na kartě (platí pro nákup kupónu, jehož majitel ukončí studium
nebo dosáhne 26 let v aktuální platnosti kupónu, atd.)
cp-date-to – konec platnosti profilu na kartě (platí pro nákup kupónu, jehož majitel ukončí studium
nebo dosáhne 26 let v aktuální platnosti kupónu, atd.)
Tagy pro práci s ultralight kartou:
card-taplist-number – pořadové číslo taplistu v rámci vozidla
card-vehicle-number – identifikátor vozidla
card-uid – číslo čipu ultralight karty (povinná položka pro práci s ultralight kartou)
Tagy pro dopravce ČD:
its-no – číslo IDS (nepovinná položka)
Jako odpověď CC zasílá XML obsahující potvrzení jednotlivých transakcí
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>transaction_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>n</itemscount>
<lang>cz</lang>
</header>
<Items>
<device_ret device-id=”2” stat=“IS_OK“ reason=““>
<transaction_ret card-id="000000001" appl-id=“0“ date=“1.1.2007 14:05:00“
tx-id=”0“ tranret=“a1“ stat=“IS_OK“ reason=““ />
…
<transaction_ret card-id ="000000001" appl-id =“0“ date=“1.1.2007 16:25:00“
transcount=”10“ tranret=“b2“ stat=“IS_OK“ reason=““ />
</device_ret>
</Items>
</rootCC>
device-id – dekadické číslo zařízení, na kterém byla transakce provedena (povinná položka)
card-id – číslo karty v hexadecimálním formátu (povinná položka)
appl-id – dekadické číslo aplikace na kartě (povinná položka)
date – datum a čas provedení transakce (povinná položka)
tx-id – číslo transakce na daném zařízení (povinná položka)
eshop-tr-id – číslo transakce na e-shopu (povinná položka pouze v případě transakce z e-shopu se
žádostí na dobití časového kupónu/EP)
39
tranret – obsahuje hodnotu z došlé transakce u atributu tranret (povinná položka)
stat – status operace – definuje úspěšnost operace. V případě úspěchu má hodnotu IS_OK (povinná
položka), v případě neúspěchu a neuložení transakce v CC je vráceno k dané transakci
IS_ERROR. Pokud dojde k nějakým problémům s přijímanou transakcí, a to z důvodu, že
některé parametry jsou podezřele zadány nebo zde chybí, je uvedeno IS_WARNING, což
znamená, že transakce je přijata, ale je zařazena mezi podezřelé transakce.
Reason – obsahuje textový důvod neprovedení operace (povinná položka). Jejich seznam najdete
v dodatku číslo 1 na konci tohoto dokumentu.
Podezřelé transakce
Podezřelé transakce jsou transakce, které byly do CC přijaty, ale z technických či logických důvodů
jsou označeny jako vadné (neexistující karta, chybějící číslo zóny u předplatní atd.). Zobrazují se ve
výpisu podezřelých transakcí a je možno zjistit, jaká chyba byla u příjmu zjištěna a lze je také uznat
za korektní. Je třeba však brát na zřetel, že kontrola zobrazuje jen první chybu, kterou nalezne, a
tudíž operátor musí kontrolovat celou transakci. Po jejím uznání bude transakce zavedena do CC
jako korektní a bude zaúčtována jako běžná transakce.
40
Zasílání transakcí ODIS/neODIS pro ODIS/neODIS karty ze zařízení ODIS
Při odbavování cestujících na strojcích ODIS nastávají jisté specifické situace při vydávání neODIS
jízdenek a také při práci s neODIS kartami. Zde je výčet možných situací, které popisují jak
v daném případě postupovat. NeODIS karta - je karta dopravce nepatřící do ODIS sytému karet.
Tyto karty nejsou a nebudou zaváděný do CCMSK. NeODIS jízdenky které je možno prodávat na
zařízeních ODIS jsou jízdenky konkrétního dopravce nepatřící do systému ODIS.
Zde jsou možné případy:
1. Jízdenka "neODIS" hrazená v hotovosti.
Tyto transakce se do CCMSK nezapisují. Provede se jen zaslání vyrovnávací transakce a tedy
pohyb počítadla zařízení:
<transaction tx-id="6" type="pay" amount-type="cash" transtype="outside-odis"
when="2012-01-27T13:59:49.000" amount="0" />
2. Jízdenka "neODIS" hrazená kartou ODISKa a transakce hrazené kartou ODISka, které nemají
být zahrnuty do dělby tržeb.
Tyto transakce se do CCMSK zapisují jen z pohledu pohybu EP na kartě. Provede se jen zaslání
vyrovnávací transakce společně s informací o pohybu na EP:
<transaction tx-id="6" card-id="04105DEA052280" appl-id="4609" type="pay"
transtype="outside-odis" amount-type="ep" when="2012-01-27T13:59:49" amount="60"
balance_before="500" balance_after="560" currency="CZK" vat="14" />
3. Jízdenka "neODIS" hrazená kartou neODIS.
Tyto transakce se do CCMSK nezapisují. Provede se jen zaslání vyrovnávací transakce a tedy
pohyb počítadla zařízení:
<transaction tx-id="6" type="pay" amount-type="cash" transtype="outside-odis"
when="2012-01-27T13:59:49.000" amount="0" />
4. Jízdenka "ODIS" hrazená v hotovosti.
Běžná situace popsaná ve větě KODIS:
<transaction tx-id="6" when="2012-01-06T13:59:49.000" line="900250" sequence="11"
type="pay" amount-type="cash" transtype="mhd" base-rate="zs" amount="9.5"
currency="CZK" vat="14" departure-id="130000" arrival-id="365000" tariff-type="JD"
tariff="1" person-type="1" note="papir" />
5. Jízdenka "ODIS" hrazená kartou neODIS.
Platba v hotovosti:
<transaction tx-id="6" when="2012-01-06T13:59:49.000" line="900250" sequence="11"
type="pay" amount-type="cash" transtype="mhd" base-rate="zs" amount="9.5"
currency="CZK" vat="14" departure-id="130000" arrival-id="365000" tariff-type="JD"
tariff="1" person-type="1" note="papir" />
41
Zasílání transakce jako potvrzení, že za daný den zařízení dodalo seznam
transakcí
V případě, že zařízení v daný den nevygenerovalo transakci a bylo aktivní, je třeba do systému
odeslat potvrzovací transakci tohoto stavu.
Její formát je:
<?xml version="1.0" encoding="UTF-8"?>
<transactions version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1"
sumcount="1" vat="14" premise="1">
<transaction tx-id="50" type="odp" amount-type="cash" transtype="uni"
when="2012-01-27T13:59:49.000" amount="0" />
</transactions>
42
Zasílání transakce jako MULTI-LÍSTEK do CCMSK.
Jen pro firmu Mikroelektronika je zaveden způsob příjmu multi-lístku ve větě KODIS následovně:
(multi-lístek je sloučení několika lístků do jedné transakce)
Multilístek
Příklad situaci multi lístku s více zákaznickými profily na jednom lístku (CP), a jednou jízdou
z A do B:
Multi-lístek bude mít v person-type uveden speciální nový typ 99, který označuje situaci
sloučení jízdenky (například pro cestujícího, dítě a zvíře, atp.).
Příklad multi-lístku (sloučení jednotlivé jízdenky s jízdenkou pro psa):
<transaction tx-id="1" card-id="045066662A80" appl-id="4609" when="2012-10-06 13:59:49"
line="900250" sequence="11" type="pay" amount-type="ep" transtype="mhd" base-rate="zs"
amount="65" currency="CZK" vat=„14“ balance_before="500" balance_after="435" departure-
id="130000" arrival-id="365000" tariff-type="JD" tariff="1" person-type="99" note="" passengers-
count ="2" />
Příklad multi-lístku (sloučení jednotlivé jízdenky pro dospělé 3 cestující 3x52 Kč):
<transaction tx-id="1" card-id="045066662A80" appl-id="4609" when="2012-10-06 13:59:49"
line="900250" sequence="11" type="pay" amount-type="ep" transtype="mhd" base-rate="zs"
amount="156" currency="CZK" vat=„14“ balance_before="1010" balance_after="854" departure-
id="130000" arrival-id="365000" tariff-type="JD" tariff="1" person-type="99" note="" passengers-
count="3" />
Dodatek:
• tariff-type v tomto typu multilístku musí být jen pro stejné jízdenky - jednotlivá,
předplatní a přestupní (JD, PP, PS). Sloučení není možné.
Multi lístek s přestupem.
Příklad pro situaci multi lístku s víc zákaznickými profily na jednom lístku (CP), jednou
jízdou z A do B a přestupní jízdenkou z B do C:
Příklad multi-lístku (více pasažérů s dvěmi linkospoji):
První transakce s prvním spojem na, který si v multi lístku zakoupil jízdenku:
<transaction tx-id="1" multi-index="1" multi-sum="2" card-id="045066662A80" appl-id="4609"
when="2012-10-06 13:59:49" line="900250" sequence="40" type="pay" amount-type="ep"
transtype="mhd" base-rate="zs" amount="65" currency="CZK" vat=„14“ balance_before="500"
balance_after="435" departure-id="130000" arrival-id="365000" tariff-type="JD" tariff="1"
person-type="99" note="" passengers-count="2" />
Druhá transakce s druhým spojem na, který si v multi lístku zakoupil jízdenku (kde dochází
k přestupu):
<transaction tx-id="1" multi-index="2" multi-sum="2" card-id="045066662A80" appl-id="4609"
when="2012-10-06 13:59:49" line="900250" sequence="11" type="pay" amount-type="ep"
transtype="mhd" base-rate="0" amount="45" currency="CZK" vat=„14“ balance_before="435"
balance_after="390" departure-id="140000" arrival-id="835000" tariff-type="PS" tariff="1"
person-type="99" note="" passengers-count="2" />
Jízdenka s přestupem.
43
Příklad pro situaci jízdenky s jedním zákaznickým profilem na jednom lístku (CP), jednou
jízdou z A do B a přestupní jízdenkou z B do C:
Příklad jízdenky s přestupem (jeden pasažér s dvěmi linkospoji), jízda je prováděna v jednom
vozidle a nedochází k dalšímu odbavení cestujícího v místě přestupu.
První transakce s prvním spojem na, který si v multi lístku zakoupil jízdenku:
<transaction tx-id="1" multi-index="1" multi-sum="2" card-id="045066662A80" appl-id="4609"
when="2012-10-06 13:59:49" line="900250" sequence="40" type="pay" amount-type="ep"
transtype="mhd" base-rate="zs" amount="65" currency="CZK" vat=„14“
balance_before="500" balance_after="390" departure-id="130000" arrival-id="365000"
tariff-type="JD" tariff="1" person-type="1" note="" />
<transaction tx-id="1" multi-index="2" multi-sum="2" card-id="045066662A80" appl-id="4609"
when="2012-10-06 13:59:49" line="900250" sequence="11" type="pay" amount-type="ep"
transtype="mhd" base-rate="0" amount="45" currency="CZK" vat=„14“
balance_before="500" balance_after="390" departure-id="365000" arrival-id="835000"
tariff-type="PS" tariff="1" person-type="1" note="" />
Pro balance-before a balance-after je zde v příkladu vidět specifická situace - zůstatky na EP jsou u
obou transakcí stejné (balance-before je hodnota před první operací a balance-after je hodnota po
druhé transakci). Je to z důvodu nemožnosti zasílat aktuální zůstaky ke každé multi transakci.
Ti dopravci, kteří umění tyto zůstatky zasílat je zasílají. Pro ty, kteří toto neumějí, musí být
v CCMSK nastaven u dopravce speciáln příznak.
44
Řešení neukončených nahrání e-shop transakcí na strojku
Dojde-li k odtržení karty v procesu zápisu e-shop transakce z greenlistu na kartu, může se stát, že
cestující má na kartě již zapsáno id transakce, které brání opětovnému dobití, protože stojky zapisují
dobíjecí transakci z greenlistu pouze pokud je na kartě nižší identifikátor transakce (bezpečnostní
opatření).
1) Ověří u jaké transakce z greenlisu bylo zapsáno číslo transakce, ale nebylo provedeno
samotné dobití.
To lze učinit zjištěním, které e-shop transakce byly na CC MSK zaslány a které zůstaly
na greenlistu.
Případně vyčtením čísla greenlistové transakce přímo z karty, pokud držitel neměl více
dobíjecích transakcí z e-shopu.
2) Zapíše si takto zjištěné číslo transakce z greenlistu, které bude potřebovat pro zaslání
transakce o zápisu dobití e-shop transakce na kartu na CC MSK.
3) Provede zápis dobití na kartu a do CC MSK zašle transakci informující o zápisu na
kartu, se stejnými parametry, jako by ji provedl strojek, jen číslo zařízení bude skutečné
číslo zařízení, ze kterého je reklamace řešena.
45
Žádosti o vydání karty
Tento XML soubor se posílá jako žádost o vydání. Příklad XML souboru pro žádost o vydání karty
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>cardrequest</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
<cardrequest contactpointno="0001" provider="92" cardtype="4"
customerprofiledateto2="2024-05-31" customerprofiledatefrom2="2018-05-14"
customerprofileno2="0" customerprofiledateto1="2024-05-31"
customerprofiledatefrom1="2018-05-14" customerprofileno1="1" photo="/9j/ABCDE="
note="" deliveryzip="12345" deliverycity="Český Těšín" deliverystreetevidenceno="1705"
deliverycityevidenceno="593" deliverystreet="Viaduktová" deliveryrecipient="Dopravní
infocentrum Český Těšín" deliverytype="0" representativepersonalidentityno=""
representativeemail="" representativesurname="" representativename="" birthdate="1988-
03-27" personalidentityno="" email="abcde@seznam.cz" surname="Nováková"
name="Romana" cardvalid-to="2024-05-31" cardvalid-from="2018-05-14" cardno=""
cardKODIS="920311109210007276" requeststate="1" requestid="ea8491d7-fcef-4090-
95c1-317b58797928" createddate="2018-05-14 15:08:22"/>
</items>
</rootCC>
V rámci elementu <items> se nacházejí elementy <cardrequest>, které mají následující atributy:
contactpointno - jednoznačné číslo kontaktního místa daného dopravce (v hlavičce výrobní dávky je
to atribut 'place') (povinná položka)
KODIS
0000 - Koordinátor ODIS s.r.o.
0001 - Dopravní infocentrum Český Těšín
0002 - Dopravní infocentrum Ostrava – IMC - Poděbradova
0003 - Dopravní infocentrum Třinec
0004 - Dopravní infocentrum Jablunkov
0005 - ČSAD Havířov, Podlesí, aut. nádr.
0006 - Dopravní infocentrum Hlučín
0007 - Dopravní infocentrum Karviná
0008 - Dopravní infocentrum Orlová
0009 - ČSAD Havířov, Město, Radnice
0010 - ČSAD Havířov, Šenov, ČSAD
0011 - DP Ostrava - prodejna Poděbradova (číslo výdejního místa – 1)
0012 - DP Ostrava - prodejna vozovna Poruba (číslo výdejního místa – 12)
0013 - DP Ostrava - prodejna Venuše (číslo výdejního místa – 7)
46
0014 - DP Ostrava - prodejna Zábřeh - DK AKORD (číslo výdejního místa - 11)
0015 - DP Ostrava Specializované pracoviště (číslo výdejního místa – 91)
0016 - DP Ostrava Jízdní výhody (číslo výdejního místa – 92)
0017 - Městské muzeum Rýmařov p.o.
0018 - MIC Bruntál - terminál
0019 - Informační kancelář Nový Jičín
0020 - Informační kancelář Kopřivnice
0021 - ČSAD Karviná, Nové Město, Bohumínská
0022 - ČSAD Frýdek-Místek, AN
0023 - ČSAD Frýdek-Místek, Garáže
0024 - Dopravní infocentrum Opava (Bílovecká 2874/5)
0025 - VŠB - TU Ostrava
0026 - eShop KODIS
0027 - Dopravní infocentrum Krnov (Zámecké nám. 2068/4)
0028 - Opava, předprodej MDPO (Hor.nám.)
0029 - Arriva Morava a.s.
KOVED
1000 - KOVED ZK s.r.o.
1001 - KOVED ZK - eShop
1002 - Zlín, AN
1003 - Uherské Hradiště, AN
1004 - Valašské Klobouky, AN
1005 - Uherský Brod, Dopravní terminál
1006 - Luhačovice, AN
1007 - Kroměříž, AN
1008 - Valašské Meziříčí, AN
1009 - Rožnov pod Radhoštěm, AN
1010 - Vsetín, AN
1011 - Bystřice pod Hostýnem, AN
1012 Holešov, AN
provider - číslo dopravce, jež je vydavatelem karty (povinná položka)
cardtype - číslo typu držitele karty, které bude zapsáno na kartě (povinná položka)
0 - anonymní karta
1 - personalizovaná karta
2 - přenosná karta
3 - nepřenosná nepersonalizovaná karta
4 - graficky personalizovaná karta
5 - náhradní karta
6 - zaměstnanecká graficky personalizovaná karta
customerprofiledateto2 - datum začátku platnosti druhého zákaznického profilu
customerprofiledatefrom2 - datum konce platnosti druhého zákaznického profilu
customerprofileno2 - číslo druhého zákaznického profilu, který bude zapsán na kartě
(0=nenastaven) (povinná položka)
customerprofiledateto1 - datum začátku platnosti prvního zákaznického profilu
customerprofiledatefrom1 - datum konce platnosti prvního zákaznického profilu
customerprofileno1 - číslo prvního zákaznického profilu, který bude zapsán na kartě
(0=nenastaven) (povinná položka)
47
photo - fotografie žadatele (BASE64)
note - poznámka na žádosti
deliveryzip - PSČ z adresy pro doručení karty
deliverycity - město z adresy pro doručení karty
deliverystreetevidenceno - číslo orientační z adresy pro doručení karty
deliverycityevidenceno - číslo popisné z adresy pro doručení karty
deliverystreet - ulice z adresy pro doručení karty
deliveryrecipient - jméno a příjmení nebo název organizace z adresy pro doručení karty
deliverytype - způsob doručení karty (povinná položka)
0 - doručení na kontaktní místo
1 - poštou na adresu
2 - poštou na adresu doporučeně
representativebirthdate - datum narození zákonného zástupce
representativepersonalidentityno - číslo osobního dokladu zákonného zástupce (OP, PAS, ŘP apod.)
representativeemail - email zákoného zástupce
representativesurname – příjmení zákonného zástupce
representativename - jméno zákonného zástupce
birthdate - datum narození žadatele
personalidentityno - číslo osobního dokladu žadatele (OP, PAS, ŘP apod.)
email - email žadatele
surname - příjmení žadatele
name - jméno žadatele
cardvalid-to - datum konce platnosti karty (povinná položka)
cardvalid-from - datum počátku platnosti karty (povinná položka)
cardno - číslo čipu karty (pokud je již známo)
cardKODIS - logické číslo karty (pokud je již známo)
requeststate - stav žádosti o kartu (povinná položka)
1 - žádost o kartu byla zaslána z CM nebo eShopu do CCMSK
2 - žádost o kartu byla zaslána do výroby na personalizační linku
3 - karta byla personalizována na výrobní lince
4 - žádost o kartu byla stornována
requestid – id žádosti
createddate - datum a čas podání žádosti (povinná položka)
companyname - název firmy
companyid - IČ
companyvatid - DIČ
carduserpassword - přihlašovací jméno do CC
48
Jako odpověď CC posílá seznam žádostí, které byly úspěšné přijaty. U neúspěšných žádostí je
uveden důvod, proč nebyly úspěšně přijaty. U úspěšně přijatých je hodnota atributu „stat” IS_OK.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>cardrequest_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
<cardrequest_ret reason="" stat="IS_OK" requeststate="1" requestid="ea8491d7-fcef-4090-
95c1-317b58797928" requestno="728" createddate="2018-05-14 15:08:22"/>
</items>
</rootCC>
stat – status operace – definuje úspěšnost operace. V případě úspěchu má hodnotu IS_OK (povinná
položka)
reason – obsahuje textový důvod neprovedení operace (povinná položka)
requeststate – stav žádosti o kartu (povinná položka)
1 - žádost o kartu byla zaslána z CM nebo eShopu do CCMSK
2 - žádost o kartu byla zaslána do výroby na personalizační linku
3 - karta byla personalizována na výrobní lince
4 - žádost o kartu byla stornována
requestid – id žádosti (povinná položka)
requestno – číslo žádosti (povinná položka)
createddate – id žádosti (povinná položka)
49
Blacklist karet
CC udržuje seznam zakázaných karet. Při odeslání následujícího XML se vrátí seznam zakázaných
karet. Je možné si vyžádat blacklist jen pro určitého dopravce pokud v elementu < blacklist > se
definují tito dopravci. Pokud nejsou uvedeni, tak se vrátí globální seznam zakázaných karet. Dále je
možné zažádat o rozšířený blacklist, tzn. nejen seznam karet aktuálně umístěných v blacklistu, ale
také karet, které v blacklistu již nejsou z důvodu vypršení platnosti a karet, které již v blacklistu
nejsou z důvodu sešrotování. Příklad XML souboru pro získání blacklistu karet.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>blacklist</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
<blacklist>
<provider>DPO</provider>
<extend>1</ extend >
</blacklist>
</items>
</rootCC>
provider – kód dopravce (nepovinná položka). V případě, že není uveden žádný kód dopravce, vrací
se blacklist pro všechny dopravce.
extend – rozšířený blacklist, hodnoty 0 nebo 1 v případě požadavku na rozšířený blacklist
(nepovinná položka)
Jako odpověď CC zasílá seznam zakázaných karet
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype> blacklist_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>3</itemscount>
<lang>cz</lang>
</header>
<items>
< blacklist_ret cardsno="000000001" cardKODIS="95456665235458"
date=“1.1.2007 14:30:00“ cardstate=“3“ />
</items>
</rootCC>
50
cardsno – výrobní číslo karty v hexadecimálním tvaru (povinná položka)
cardKODIS – logické číslo karty (povinná položka)
date – datum zneplatnění karty (povinná položka)
provider – kód dopravce (povinná položka v případě globálního blacklistu)
cardstate – stav karty (povinná položka v případě rozšiřeného blacklistu)
Hodnota atributu cardstate může nabývat hodnot:
0: karta je na blacklistu
2: karta je na blacklistu trvale zablokovaná
3: karta je na blacklistu a je zešrotovaná
4: karta je na blacklistu a vypršela její platnost, ale není zešrotovaná
51
Denylist bankovních karet
CC udržuje seznam bankovních karet, které jsou odmítnuté vydavatelem pro použití ve veřejné
dopravě DPO. Nejde o “zakázané karty”, protože karty mohou fungovat mimo veřejnou dopravu.
V ostré verzi CC MSK je WS dostupná na:
http://clearing.kodis.cz/WebService/DataService.asmx
V testovací verzi CC MSK je WS dostupná na:
http://clearing.kodis.cz/WebServiceTest/DataService.asmx
Aktuální WSDL soubor je možné získat na výše uvedených adresách, přidání postfixu ?WSDL
k dané URL adrese.
Význam použitých datových položek
• CardEmvToken – EMV karetní token
• DenyListType – typ DenyListu
o FULL = plný
o INC = inkrememtální
• DenyList – Struktura DenyListu. Odpověď může obsahovat i několik
struktur DenyList za sebou, v případě že je požadováno stažení
inkrementálního seznamu nebo více vydaných seznamů najednou (rozsah
definovaný položkami SequenceNoStart a SequenceNoEnd).
o DenyListHeader – Hlavička DenyListu
▪ FileVersion – Verze struktury DenyListu
▪ IssueDateTime – Datum vydání DenyListu
▪ SequenceNo – Pořadové číslo DenyListu
▪ Type (viz položka DenyListType)
▪ ItemsCount – Počet záznamů na DenyListu
▪ Reset – Má-li tento příznak hodnotu true, pak došlo k resetu
DenyListu, tzn. všechny dřívější položky EMV karet na
seznamu byly vymazány (pokud tento DenyList obsahuje
nějaké položky, jedná se již o nové zánamy EMV karet na
seznamu). Reset Denylistu je obvykle prováděn jednou
denně na přelomu dne, kdy je z bankovního back office
stažen zvela nový plný DenyList, který je potřeba nově
nasadit na CC. Příznak je důležitý v případě požadavku na
stažení inkrementálního DenyListu, čímž je klient
informován, že byl nasazen zcela nový seznam odmítnutých
EMV karet (čímž došlo k narušení posloupnosti změn).
o DenyListItems – Seznam karet v DenyListu
▪ DenyListItem – Jedna položka DenyListu
• CardEmvToken – EMV karetní token
• OriginDateTime – Datum vzniku události
• BlockNoticed - příznak, že uživateli bylo už
zobrazeno, že má kartu na denylistu
• StateCode – Kód stavu EMV karty (pouze u
inkrementálního DenyListu)
o ADD = přidání karty na DenyList (blokace)
o DEL = odebrání karty z DenyListu
(odblokace)
52
o FileName – Jméno binárního souboru DenyListu
o Data – binární data souboru DenyListu
• Password – Uživatelské heslo provozovatele
• ResponseStatus – Struktura s výsledkem zpracování dotazu
o ErrorCode – Pokud je 0, vše je OK
o ErrorMessage – Text chyby
• SequenceNo – Pořadové číslo DenyListu
• SequenceNoStart – Počáteční pořadové číslo DenyListu
• SequenceNoEnd – Koncové pořadové číslo DenyListu
• UserLogin – Uživatelský login provozovatele
•
Zpracování odpovědí
Zpracování chyb
V jednotlivých XML odpovědích zde uvedených metod webové služby je vždy navrácen následující
element určující výsledek zpracování metody webové služby:
<ResponseStatus>
<ErrorCode>int</ErrorCode>
<ErrorMessage>string</ErrorMessage>
</ResponseStatus>
V tagu ResponseStatus se mohou objevit následující kombinace hodnot u elementu ErrorCode a
ErrorMessage:
• 0 „OK“
• -1 „Uživatelský účet nenalezen (chybný uživatelský login nebo heslo)“
• -2 „Uživatelský účet nemá přiděleno právo 'Online XML komunikace'“
• -3 „Nepodařilo se získat pořadové číslo posledně vydaného DenyListu“
• -4 „Chybná hodnota vstupního parametru DenyListType
(CardEmvDenylistBatchTypeCode)“
• -5 „Hodnota parametru SequenceNoStart nesmí být větší než hodnota parametru
SequenceNoEnd“
• -6 „Hodnoty parametrů SequenceNoStart a SequenceNoEnd musí být v rozsahu
<1;LastIssuedDenyListSequenceNo>“
• - 32768 chybový text výjimky
Zpracování vrácených dat
Pokud nedošlo k chybě a vrací-li daná metoda smysluplná data, obsahuje další element, který
následuje po elementu <ResponseStatus></ResponseStatus> datovou část s odpovědí (liší se
podle typu volané metody webové služby).
53
Binární podoba DenyListu
DenyList je možné také stahovat v binární podobě.
Popis souboru: Popis
Název souboru Soubor stoplistu (upload)
ST.YYMMDDHHMISS YYMMDDHHMISS … je řídící hodnota
pro verzi stoplistu v terminálu. Stejná
hodnota je uvedena v hlavičce zdrojových
XML dat
Formát souboru:
Položka Délka Popis
ROWS_NUM 4B Udává celkový počet tokenů (záznamů) ve stoplistu
ROW_LEN 1B
Délka jednoho záznamu. Do délky záznamu se počítá
TOKEN 33B max_len(TOKEN)+STATUS
STATUS 1B Vlastní karetní token. Pozn: 33B je pro aktuálně používaný
formát tokenu.
0…. info N/A
1 …. Držitel karty byl informován o blokované kartě
Soubor stoplistu obsahuje neoddělená binární data (ne ASCII), kde jednotlivé tokeny jsou
vzestupně seřazeny. Položka STATUS do třízení nevstupuje.
Zdrojovým podkladem pro binární stoplist jsou XML data stoplistu.
Příklad:
000000022210CDF8F44E6C266C6B8FC8BF010370288CF2136B134E44CC22E26D79344C46D13E0110
DDF8F44E6C266C6B8FC8BF010370288CF2136B134E44CC22E26D79344C46D13E00
Metoda GetLastIssuedDenyListSequenceNo
Metoda vrátí pořadové číslo posledně vydaného plného DenyListu.
Požadavek:
POST /DataService.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetLastIssuedDenyListSequenceNo xmlns="http://tempuri.org/">
<UserLogin>string</UserLogin>
<Password>string</Password>
</GetLastIssuedDenyListSequenceNo>
54
</soap12:Body>
</soap12:Envelope>
Odpověď:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetLastIssuedDenyListSequenceNoResponse xmlns="http://tempuri.org/">
<ResponseStatus>
<ErrorCode>int</ErrorCode>
<ErrorMessage>string</ErrorMessage>
</ResponseStatus>
<SequenceNo>int</SequenceNo>
</GetLastIssuedDenyListSequenceNoResponse>
</soap12:Body>
</soap12:Envelope>
Metoda GetDenyList
Metoda vrátí seznam karet na DenyListu
Požadavek:
POST /DataService.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetDenyList xmlns="http://tempuri.org/">
<UserLogin>string</UserLogin>
<Password>string</Password>
<DenyListType>FULL or INC</DenyListType>
<SequenceNoStart>int</SequenceNoStart>
<SequenceNoEnd>int</SequenceNoEnd>
</GetDenyList>
</soap12:Body>
</soap12:Envelope>
Odpověď:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetDenyListResponse xmlns="http://tempuri.org/">
55
<ResponseStatus>
<ErrorCode>int</ErrorCode>
<ErrorMessage>string</ErrorMessage>
</ResponseStatus>
<DenyList>
<DenyListHeader>
<FileVersion>string</FileVersion>
<IssueDateTime>dateTime</IssueDateTime>
<SequenceNo>int</SequenceNo>
<Type>FULL or INC</Type>
<ItemsCount>int</ItemsCount>
<Reset>boolean</Reset>
</DenyListHeader>
<DenyListItems>
<DenyListItem>
<CardEmvToken>string</CardEmvToken>
<OriginDateTime>dateTime</OriginDateTime>
<BlockNoticed>boolean</BlockNoticed>
<StateCode>ADD or DEL</StateCode>
</DenyListItem>
<DenyListItem>
<CardEmvToken>string</CardEmvToken>
<OriginDateTime>dateTime</OriginDateTime>
<BlockNoticed>boolean</BlockNoticed>
<StateCode>ADD or DEL</StateCode>
</DenyListItem>
</DenyListItems>
</DenyList>
<DenyList>
<DenyListHeader>
<FileVersion>string</FileVersion>
<IssueDateTime>dateTime</IssueDateTime>
<SequenceNo>int</SequenceNo>
<Type>FULL or INC</Type>
<ItemsCount>int</ItemsCount>
<Reset>boolean</Reset>
</DenyListHeader>
<DenyListItems>
<DenyListItem>
<CardEmvToken>string</CardEmvToken>
<OriginDateTime>dateTime</OriginDateTime>
<BlockNoticed>boolean</BlockNoticed>
<StateCode>ADD or DEL</StateCode>
</DenyListItem>
<DenyListItem>
<CardEmvToken>string</CardEmvToken>
<OriginDateTime>dateTime</OriginDateTime>
<BlockNoticed>boolean</BlockNoticed>
<StateCode>ADD or DEL</StateCode>
</DenyListItem>
</DenyListItems>
</DenyList>
</GetDenyListResponse>
</soap12:Body>
</soap12:Envelope>
Metoda GetDenyListBinary
Metoda vrátí seznam karet na DenyListu v binární podobě
56
Požadavek:
POST /DataService.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetDenyListBinary xmlns="http://tempuri.org/">
<UserLogin>string</UserLogin>
<Password>string</Password>
<DenyListType>FULL or INC</DenyListType>
<SequenceNoStart>int</SequenceNoStart>
<SequenceNoEnd>int</SequenceNoEnd>
</GetDenyListBinary>
</soap12:Body>
</soap12:Envelope>
Odpověď:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetDenyListBinaryResponse xmlns="http://tempuri.org/">
<ResponseStatus>
<ErrorCode>int</ErrorCode>
<ErrorMessage>string</ErrorMessage>
</ResponseStatus>
<DenyList>
<FileName>string</FileName>
<Data>base64Binary</Data>
</DenyList>
<DenyList>
<FileName>string</FileName>
<Data>base64Binary</Data>
</DenyList>
</GetDenyListBinaryResponse>
</soap12:Body>
</soap12:Envelope>
57
Green-list peněženky/kupónů
CC udržuje seznam dobití EP/kupónů, které je na fyzickou kartu teprve dohrát. Při odeslání
následujícího XML se vrátí seznam těchto transakcí. Je možné si vyžádat green-list jen pro určitého
dopravce a to tak že v elementu < greenlist > se definuje jejich seznam (oddělení čárkou). Pokud
nejsou uvedeni, tak se vrátí globální seznam transakcí. Seznam je navíc možno omezit datumovým
rozsahem. To zda se vrací dobití EP nebo kupónu se rozlišuje pomocí elementu <type>.
Příklad XML souboru:
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>greenlist</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
< greenlist>
<type>EP</type>
<provider>0,1</provider>
<datefrom>2012-06-01</datefrom>
<dateto>2012-06-01</dateto>
</ greenlist>
</items>
</rootCC>
type – typ seznamu – EP=seznam pro EP, COUPON=seznam pro kupóny (povinná položka)
provider – kód(y) dopravce, pokud není specifikováno, vrací se seznam pro všechny dopravce
(nepovinná položka)
datefrom – počáteční datum rozsahu (nepovinná položka)
dateto – koncové datum rozsahu – (nepovinná položka)
Jako odpověď CC zasílá seznam transakcí pro:
a) dobití EP
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>greenlist_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>3</itemscount>
<lang>cz</lang>
</header>
58
<items>
<greenlist_ret cardsno="000000001" card_kodis=”92012345678907456467”
provider=”0” contractsaleagent=”155” contractsaledevice=”1” amount=”150”
trno=”100” tr_type=”EP” currency=”CZK”/>
…
</items>
</rootCC>
cardsno – výrobní číslo karty v hexadecimálním tvaru – max. 16 znaků (povinná položka)
card_kodis - identifikační číslo karty, řetězec o délce max. 20 znaků (povinná položka)
provider – kód subjektu (poskytovatele) karty – hodnota 0 až 200 (povinná položka)
contractsaleagent – pokladník, který nabíjel EP (nepovinná položka)
contractsaledevice – číslo prodejního místa (nepovinná položka)
amount – částka dobití EP – hodnota 0 až 4500 (povinná položka)
trno – identifikační číslo transakce (povinná položka)
tr_type – typ transakce, zdali se jedná o pěněženku nebo kupón – hodnota EP nebo COUPON
(povinná položka)
currency – měna – CZK=české koruny, bráno jako default není li hodnota specifikována (nepovinná
položka)
b) dobití kupónu
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>greenlist_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>3</itemscount>
<lang>cz</lang>
</header>
<items>
<greenlist_ret cardsno="000000001" card_kodis=”92012345678907456467”
provider=”0” contractsaleagent=”155” contractsaledevice=”1” tp=”10” cp=”20”
zones=”1,2,3,4” validfrom=”2012-01-01 00:00:00” validto=”2012-12-31 23:59:59”
amount=”150” passengers-count=”2” trno=”150” tr_type=“COUPON“
currency=”CZK” contractjourneytype=“2“ />
…
</items>
</rootCC>
cardsno – výrobní číslo karty v hexadecimálním tvaru – max. 16 znaků (povinná položka)
card_kodis - identifikační číslo karty, řetězec o délce max. 20 znaků (povinná položka)
provider – kód subjektu (poskytovatele) karty – hodnota 0 až 200 (povinná položka)
contractsaleagent – pokladník, který nabíjel EP (nepovinná položka)
contractsaledevice – číslo prodejního místa (nepovinná položka)
tp – tariff-profile kupónu (povinná položka)
cp – customer-profile kupónu (povinná položka)
zones – seznam zón oddělených čárkou (povinná položka)
validfrom – počátek platnosti kupónu (povinná položka)
59
validto – konec platnosti kupónu (povinná položka)
amount – Cena za kupón – hodnota 0 až 4500 (povinná položka)
passengers-count – počet cestujících – hodnota 0 až 60 (povinná položka)
trno – identifikační číslo transakce (povinná položka)
tr_type – typ transakce, zdali se jedná o pěněženku nebo kupón – hodnota EP nebo COUPON
(povinná položka)
currency – měna – CZK=české koruny, bráno jako default není li hodnota specifikována (nepovinná
položka)
contractjourneytype – typ trasy (povinná položka)
Mapování ostatních informací je pro přehlednost zobrazeno zde:
Položka CCMSK položky
ContractProvider Dobití kuponu Dobití EP
CouponType
ContractSaleAgent provider
ContractSaleDevice
ContractSaleSerialNumber tariff-type
ContractValidityStartDate
ContractValidityStartTime contractsaleagent contractsaleagent
ContractValidityEndDate
ContractValidityEndTime contractsaledevice contractsaledevice
ContractAmount trno
ContractTariffProfile
ContractCustomerProfile validfrom
ContractPrice
ContractJourneyZones validfrom
WalletPersProvider
WalletPersCreditTransaction validto
ContractHasJourney
validto
passengers-count
tp
cp
amount amount
zones provider
contractjourneytype trno
Převod GL kupónu
Kupón pořízený na eshopu, který ještě nebyl fyzicky nahrán na kartu, lze převézt na jinou kartu
(např. ze ztracené/vadný karty). Dopravce může přesouvat kupón pouze na vlastních kartách.
<transaction reclamation="0" note="převod" eshop-tr-id="545" amount="112" when="2018-03-07
10:00:00" transtype="eshop-c" amount-type="move" type="pay" appl-id="4609" card-
id="041A4502EF2380" tx-id="6" line="900000" sequence="1" />
eshop-tr-id – jednoznačné číslo GL transakce kupónu
card-id – číslo čipu nové karty
appl-id – číslo aplikace nové karty
line – číslo linky podle CIS JŘ, na kterou je provedena transakce (v případě přesunu GL kupónu se
v čísle linky zasílá číslo prodejního místa, které přesun provádí)
60
Po úspěšném zpracování transakce o převodu, bude vytvořena nová GL transakce, která bude
přidělená nové kartě. Stará GL transakce, která je spárovaná se starou kartou, bude stornována.
Změny se do systému promítnou ihned.
Převod nelze stornovat. Pro zpětné převedení je třeba poslat převod na původní kartu.
Převod GL elektronické peněženky
EP pořízená na eshopu, která ještě nebyla fyzicky nahrána na kartu, lze převézt na jinou kartu (např.
ze ztracené/vadný karty). Dopravce může přesouvat EP pouze na vlastních kartách.
<transaction reclamation="0" note="převod" eshop-tr-id="545" amount="200" when="2018-03-07
10:00:00" transtype="eshop-ep" amount-type="move" type="pay" appl-id="4609" card-
id="041A4502EF2380" tx-id="6" line="900000" sequence="1" />
eshop-tr-id – jednoznačné číslo GL transakce EP
card-id – číslo čipu nové karty
appl-id – číslo aplikace nové karty
line – číslo linky podle CIS JŘ, na kterou je provedena transakce (v případě přesunu GL kupónu se
v čísle linky zasílá číslo prodejního místa, které přesun provádí)
Po úspěšném zpracování transakce o převodu, bude vytvořena nová GL transakce, která bude
přidělená nové kartě. Stará GL transakce, která je spárovaná se starou kartou, bude stornována.
Změny se do systému promítnou ihned.
Převod nelze stornovat. Pro zpětné převedení je třeba poslat převod na původní kartu.
61
Inkarta
Stahování informace zda na ODIS kartě byla nahrána In Karta (Incard-list)
CC udržuje seznam karet, na kterých je nahrána In Karta, tzv. incard-list. Je možné si vyžádat
incard-list jen pro určitou kartu. Pokud není uvedena, vrátí se seznam všech karet, na kterých je
nahrána In Karta. Příklad XML souboru pro získání incard-listu.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>incardlist</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
<incardlist>
<cardsno>000000009</cardsno>
</incardlist>
</items>
</rootCC>
cardsno – výrobní číslo karty v hexadecimálním tvaru (nepovinná položka)
Jako odpověď CC zasílá incard-list.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>incardlist_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
<incardlist_ret cardsno="000000009" incard="1" />
</items>
</rootCC>
cardsno – výrobní číslo karty v hexadecimálním tvaru (povinná položka)
incard – položka uvádí, zdali je na kartě nahrána In Karta - „1“, či nikoliv – „0“ (povinná
položka)
62
Další příklad XML souboru pro získání incard-listu.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>incardlist</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
<incardlist/>
</items>
</rootCC>
Jako odpověď CC zasílá incard-list.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>incardlist_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>3</itemscount>
<lang>cz</lang>
</header>
<items>
<incardlist_ret cardsno="000000001" incard="1" />
<incardlist_ret cardsno="000000005" incard="1" />
<incardlist_ret cardsno="000000009" incard="1" />
</items>
</rootCC>
cardsno – výrobní číslo karty v hexadecimálním tvaru (povinná položka)
incard – položka uvádí, zdali je na kartě nahrána In Karta - „1“, či nikoliv – „0“ (povinná
položka)
Zobrazení informace In Karty přes webové rozhraní CC
Pokud má cestující na své kartě nahranou In Kartu, zobrazí se mu položka In Karta v základních
informacích o kartě.
63
Vrácení informace o zůstatku EP na kartě
Stahování informace o aktuálním zůstatku na ODIS kartě. (WalletBalance)
Příklad XML souboru pro získání zůstatku na EP.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>walletbalance</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
<walletbalance>
<card_kodis>920311106280024785</card_kodis>
</walletbalance>
</items>
</rootCC>
card_kodis – logické číslo karty (povinná položka)
Jako odpověď CC zasílá zůstatek na EP.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>walletbalance_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
<walletbalance_ret cardsno="043681F2052280" balance_after="152,200"
provider="62" valid_to="2018-05-09 08:15:24" valid_from="2012-05-09
08:15:24" card_state="1" />
</items>
</rootCC>
cardsno – výrobní číslo karty v hexadecimálním tvaru (povinná položka)
balance_after – aktuální zůstatek EP na kartě (povinná položka)
provider – číslo dopravce dle číselníku MSK (povinná položka)
valid_from – platnost karty od (povinná položka)
valid_to – platnost karty do (povinná položka)
card_state – stav karty, 1 = aktivní, 0 = neaktivní (povinná položka)
64
Vrácení kupónů na kartě
Stahování informace o kupónech na ODIS kartě. (TicketsInfo)
Příklad XML souboru pro získání kupónů.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>ticketsinfo</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
<ticketsinfo>
<card_kodis>920311106280024785</card_kodis>
</ticketsinfo>
</items>
</rootCC>
card_kodis – logické číslo karty (povinná položka)
Jako odpověď CC zasílá kupóny.
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>ticketsinfo_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
<ticketsinfo_ret device-id="1" valid-to="2015-01-18 23:59:00" valid-
from="2014-12-20 00:00:00" person-type="1" tariff="14" zone="1, 3"
amount="470,000" when="2014-12-19 17:49:43"
cardsno="043681F2052280" provider-code="62" contractjourneytype="2" />
</items>
</rootCC>
65
Nestandardní situace, reklamace, storno a výměny karet
Stručný popis řešení nestandardních situací v systému s příklady výskytů a jejich řešení v rámci
systému.
Možné typy situací:
1. Reklamace přímo ve vozidle (při odbavování cestujícího).
2. Převod peněz nebo kupónu ze staré vadné nebo zablokované karty na novou.
3. Vyplacení částky z EP v hotovosti.
4. vrácení kupónu nevyužitého nebo využitého částečně
5. Reklamace na přepážce lísku/neoprávněného započítání základní sazby. Tento typ
reklamace se v systému provádí zadáním všech potřebných informací pro identifikaci, o
jakou transakcí se jednalo, viz dále. Tuto reklamaci může provést jen vydavatel karty a smí
tak reklamovat transakce provedené jen na svých vlastních zařízeních.
6. Reklamace na přepážce lísku/neoprávněného započítání základní sazby. Tento typ
reklamace se v systému provádí zadáním všech potřebných informací pro identifikaci, o
jakou transakcí se jednalo, viz dále. Tento typ reklamací se provádí v situacích, kdy je
sporná transakce provedena na zařízení jiného dopravce, než je vydavatel karty. Tyto
reklamace se zákazníkem vyřizuje dopravce ve spolupráci s vydavatelem.
Reklamace ve vozidle:
Storno v autobuse je možné pouze ihned při odbavení cestujícího, jinak není umožněna. Pak se
zasílají obě transakce, původní a stornovaná transakce (která musí být v transakční řadě následující
po stornované transakci). V takovém případě, se transakce nebude do zúčtovávání započítávat.
Stornovaná transakce má kromě stejných údajů jako transakce ještě příznak reclamation (s
hodnotou 0 nebo číslo transakce – dle typu). Takto zavedenou storno transakcí se označí transakce
jako storno a nebude se zahrnovat do celkového zúčtování. Pro transakce, kde se pracuje s EP a
dochází ke storno transakci, která mění stav EP, je nutné v balance-after a balance-before uvádět
aktuální stav EP, který je na kartě po storno operaci.
Příklad:
Transakce:
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1"
sumcount="1" vat="14" premise="1">
<transaction tx-id="122554" card-id="12" appl-id="4609" when="1.1.2012
13:58:00" type="dep" amount-type="ep" transtype="mhd" amount="60" vat="14"
line="900250" sequence="11" balance_before="200" balance_after="140"
note="prodej jízdenky" currency="CZK"/>
</transactions>
Storno poslední transakce:
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1"
sumcount="1" vat="14" premise="1">
<transaction tx-id="122555" card-id="111111121" appl-id="4609" when="1.1.2012
13:59:00" type="dep" amount-type="ep" transtype="cancel" amount="60" vat="14"
66
line="900250" sequence="11" balance_before="140" balance_after="200“
note="reklamace jízdenky ve vozidle" currency="CZK" reclamation="0" />
</transactions>
Poznámka pro tento případ: Mezi transakcí a stornovanou transakcí (kde je reclamation=0) nesmí
být vložena žádné jiná transakce a čísla jejich transakcí musí jít chronologicky za sebou!
Je nutné také dodržet formátování a hodnoty parametrů v storno transakci, a to i when tedy čas
odeslání, vyjma situace operace s kartou, u těch je ve storno transakci nutno uvádět balance-after a
balance-before takové jaké jsou na kartě.
Storno transakce dle reclamation čísla (prioritně ČD):
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1"
sumcount="1" vat="14" premise="1">
<transaction tx-id="122555" card-id="14" appl-id="4609" when="1.1.2012
14:09:00" type="dep" amount-type="ep" transtype="cancel" amount="60" vat="14"
line="900250" sequence="11" balance_before="100" balance_after="160"
note="reklamace jízdenky s časovým odstupem" currency="CZK"
reclamation="122554" />
</transactions>
Poznámka pro tento případ: Je nutné také dodržet formátování a hodnoty parametrů v storno
transakci a to i when tedy čas odeslání, vyjma situace operace s kartou, u těch je ve storno transakci
nutno uvádět balance-after a balance-before takové jaké jsou na kartě.
V tomto případě jde dokonce o situaci, kdy mezi prodejem a stornem došlo na kartě k pohybu -40
Kč.
Pro typy reklamací, které nedokáže rozhodnout dopravce sám, se používá webový formulář
na CCMSK.
Tyto reklamace se provádí na přepážce, která má přístup k CCMSK webu. Všechny reklamace
vyžadují, aby byla uživateli odebrána stvrzenka či karta, kterou reklamuje a uživatel nemohl
reklamaci opakovaně uplatnit jinde. Bude mu vytištěn doklad o provedené reklamaci.
Průběh této reklamace je následující: Dopravce, který řeší danou reklamaci v případě, že není
schopen řešit případ ve svém systému, zapíše tuto reklamaci do reklamačního formuláře na webu
CCMSK. Tento formulář bude mít následující položky:
Karta č: / Nová karta č: / Číslo zařízení: /Číslo transakce:
Typ reklamace
• Jízdného
• karty
Reklamace jízdného
• Kupón
• jednotlivé jízdné
• ZS
Reklamace karty
• Vracení části peněz z EP
• Výměna nové/ztracené/vadné karty
Popis reklamace či problému.
Popis vyřešení reklamace. (např. dohrán kupón, vrácena ZS atd.)
67
Zda je reklamace postoupena dopravci a identifikace kterému. Nebo zda byla předána KODISu.
Zápis provedl (číslo dopravce a označení přihlášené obsluhy).
Informace o stavu:
• Uzavřeno (možnost zadat číslo transakce, která situaci dořešila)
• Postoupeno (Komu)
Možnost Tisk účtenku.
Pokud reklamaci vyřeší přímo dopravce, u kterého k reklamaci došlo, bude reklamace uzavřena.
Pokud, ale reklamaci nemůže vyřídit, nebo nesouhlasí s reklamací, může postoupit reklamaci dál.
Podle situace je postoupena vydavateli karty a nebo KODISu, s výjimkou reklamace kuponu,
v takovém případě je nejprve postoupena prodejci kuponu. V případě, že tento dopravce nesouhlasí,
může být postoupena reklamace KODISu k rozhodnutí o sporné reklamaci mezi dopravci.
Celý systém reklamací funguje tak, že v případě vracení peněz cestujícímu z důvodu chyby jednoho
dopravce je mu tato částka stržena jako náhrada za chybu, kterou způsobil.
Převod peněz nebo kupónu z vadné nebo zablokované karty na novou
Pro tuto situaci se v transakční větě musí zadat v amount-type nový řetězec move, který identifikuje
pohyb peněz jen na jiné medium. U pohybu na EP transtype = uni a u kuponu transtype = mhdp.
Smí ji provádět jen dopravce, který je zároveň vydavatel karty.
Při zasílání těchto transakcí se nebere zřetel na to, zda je karta na blacklistu zablokovaná nebo
neplatná.
Příklad (převod peněz na novou kartu):
Vybití EP staré (vyměňované) karty
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="1" depozitcount="0"
sumcount="1" vat="14" premise="1">
<transaction card-id="000000003" appl-id="34965" when="5.1.2012 14:05:00"
type="pay" amount-type="move" transtype="uni" amount="350" vat="14" tx-
id="122552" balance_before="350" balance_after="0" note="vybití karty"
currency="CZK" reclamation=“0“/>
</transactions>
Vybití z EP ztracené/vadné karty
<?xml version="1.0" encoding="UTF-8"?>
<transactions version="1.0" device-id="1" cashno="1" paycount="1" depozitcount="0"
sumcount="1" vat="14" premise="1">
<transaction type="pay" amount-type="move" transtype="uni" when="5.1.2012
14:05:00" amount="350" vat="14" tx-id="122552" balance_before="350"
balance_after="0" note="vybití karty" currency="CZK" card-kodis-
id=“6542115489554“ reclamation=“0“/>
</transactions>
Zde není uvedeno card-id ani app-id. Pro tento případ se zde využije tag card-kodis-id je v něm pak
uvedeno logické číslo karty, ze které se vybíjí hodnota EP.
Nabití EP nové karty
<?xml version="1.0" encoding="UTF-8"?>
<transactions version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1"
sumcount="1" vat="14" premise="1">
68
<transaction card-id="000000001" appl-id="34965" when="5.1.2012 14:06:32"
type="dep" amount-type="move" transtype="uni" amount="350" vat="14" tx-id
="122553" note="převod karty na novou kartu 00000001" currency = "CZK"
balance_before="0" balance_after="350" reclamation=“0“/>
</transactions>
Tato transakce o nabití není započítávána a jedná se jen o převod na novou kartu.
Převod kupónu na novou kartu:
Zrušení kuponu ze staré karty:
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1"
sumcount="1" vat="14" premise="1">
<transaction card-id="000000001" appl-id="4609" when="1.1.2012 16:05:00"
type="dep" amount-type="move" transtype="mhdp" amount="350" vat="14" tx-id
="122552" note="převod karty 00000003" zone=“3“ currency = "CZK" valid-
from="1.1.2012 14:05:00" valid-to="1.1.2013 14:05:00" tariff="14" tariff-
type="PP" person-type="1" reclamation=“0“/>
</transactions>
Zrušení kuponu ze ztracené/vadné karty:
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1"
sumcount="1" vat="14" premise="1">
<transaction when="1.1.2012 16:05:00" type="dep" amount-type="move"
transtype="mhdp" amount="350" vat="14" tx-id ="122552" note="převod karty
00000003" zone=“3“ currency = "CZK" valid-from="1.1.2012 14:05:00" valid-
to="1.1.2013 14:05:00" card-kodis-id=“6542115489554“ tariff="14" tariff-
type="PP" person-type="1" reclamation=“0“/>
</transactions>
Zde není card-id ani app-id v card-kodis-id je uvedeno číslo karty, ze které se převádí kupóny.
Kupón bude zneplatněn.
Nahrání kuponu na novou kartu:
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="1" depozitcount="0"
sumcount="1" vat="14" premise="1">
<transaction card-id="000000003" appl-id="4609" when="1.1.2012 16:05:00"
type="pay" amount-type="move" transtype="mhdp" amount="350" vat="14" tx-id
="122552" note="převod karty 00000001" zone=“3“ currency = "CZK" valid-
from="1.1.2012 14:05:00" valid-to="1.1.2013 14:05:00" tariff="14" tariff-
type="PP" person-type="1" reclamation=“0“/>
</transactions>
Nejedná so o nákup nového kupónu.
Vyplacení částky z EP v hotovosti
Pro vyplacení části/všech peněz z EP se musí ve transakční větě zadat ep-cash, kdy se identifikuje,
že se jedná o výplatu peněz z EP. Transtype = uni
Příklad (vrácení hotovosti z karty):
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="1" depozitcount="0"
sumcount="1" vat="14" premise="1">
69
<transaction card-id="000000001" appl-id="34965" when="5.1.2012 14:06:32"
type="pay" amount-type="ep-cash" transtype="uni" amount="200" vat="14" tx-id
="122558" balance_before="200" balance_after="0" note="vyplacení hotovosti
z karty." currency="CZK" reclamation=“0“/>
</transactions>
Příklad (vrácení hotovosti ze ztracené karty):
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="1" depozitcount="0"
sumcount="1" vat="14" premise="1">
<transaction when="5.1.2012 14:06:32" type="pay" amount-type="ep-cash"
transtype="uni" amount="100" vat="14" tx-id ="122558" balance_before="100"
balance_after="0" note="vyplacení hotovosti ze ztracené karty." currency="CZK"
card-kodis-id=“6542115489554“ reclamation=“0“/>
</transactions>
Reklamace dlouhodobé časové jízdenky (kupónu)
Reklamace dlouhodobých časových jízdenek se pro účely zúčtování importují do BP a účtují se v
BP jako doposud, pro účely zobrazení cestujícímu na CC se bude zasílat storno transakce obsahující
datum platnosti kupónu, číslo karty a zóny, podle těchto údajů se dohledá původní transakce a
barevně označí, současně se zobrazí cestujícímu storno transakce obsahující datum a čas, místo atd.
Storno transakce časové jízdenky se v transakční větě označí v tagu transtype, kde se uvede
„mhdpr“. Tak bude jasně řečeno, že se jedná o reklamaci časové jízdenky. Spolu s tímto údajem
musí být vyplněny i ostatní informace o kupónu, jeho platnosti apod. obdobně jako při koupi
kupónu. V amount je uvedena vrácená částka zákazníkovi z části nebo celého kupónu podle situace.
Pokud kupón obsahuje více zón, musí být vrácen celý!
Příklad (Reklamace kupónu vrací poměrnou část):
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1"
sumcount="1" vat="14" premise="1">
<transaction tx-id="3" card-id="000000000005" appl-id="4609" when="2012-01-
21T13:28:31.000" type="dep" amount-type="cash" transtype="mhdpr"
amount="150" currency="CZK" vat="14" zone="21" valid-from="2012-01-06
00:00:00" valid-to="2012-02-04 00:00:00" tariff="14" tariff-type="PP" person-
type="1" note="vracení poměrné části kuponu" supplementary-date=“2012-01-
01T13:59:49“ reclamation=“0“/>
</transactions>
V amount je poměrná část vráceného kuponu, v případě že je vyplácena nějaká pokuta nebo
manipulační poplatek, v amount musí být celá částka, která je zákazníkovi vrácena. Teprve
následně lze provést výběr z EP a nebo peníze za kupon vyplácet jen v hotovosti, zaplatit poplatek a
zbytek peněz pak nahrát na peněženku.
Reklamace jízdy nebo (ZS) na přepážce (pro vlastní transakce):
Pokud chyba vznikla na zařízení dopravce, u kterého je reklamace podána, a je zároveň vydavatel
karty, pak musí strojek odeslat na CCMSK transakci o vyřízení této reklamace.
Tato reklamace se označí tak, že se v transakční větě zašle v transtype „mhdr“ Reclamation
obsahuje číslo lístku (číslo reklamované transakce) a reclamation-device obsahuje číslo zařízení
reklamované transakce.
70
Tato reklamace se vždy vztahuje k uživateli s kartou.
V případě, že není schopen dopravce vydat doklad ve svém systému, vyplní formulář reklamací na
webu CCMSK.
Příklad (Reklamace jízdenky/zs):
<?xml version="1.0" encoding="UTF-8"?>
<transactions device-id="1" cashno="1" paycount="0" depozitcount="1" sumcount="1" vat="14"
premise="1">
<transaction tx-id="6" card-id="0000000007" appl-id="4609" when="2012-01-
27T13:59:49.000" type="dep" amount-type="ep" transtype="mhdr" base-rate="0"
amount="20" currency="CZK" vat="14" balance_before="700" balance_after="720"
reclamation-device=„52“ reclamation=“4565421“ supplementary-date=“2012-01-
01T13:59:49“ />
</transactions>
Po odeslání této transakce na CCMSK je vydán lístek, kde je číslo lístku (transakce).
Tato transakce nebude do konečného zúčtování započítána.
Uživatel karty bude mít ve výpise jízd na webu CCMSK označenou konkrétní stornovanou
transakci, a uvidí tam také transakci, s vrácením peněz a datem kdy byla reklamace uplatněna.
V případě, že je pro řešení použit formulář reklamací na CCMSK, bude nové číslo lístku a číslo
strojku zapsáno společně do reklamačního formuláře pro potvrzení a ukončení této reklamace.
Reklamace jízdy nebo ZS na přepážce (pro transakce provedené na zařízení jiném než je
vydavatel karty):
Reklamace jízdy nebo ZS se vyřizuje vždy u dopravce, u kterého vznikla.
Pokud chyba nevznikla na zařízení vydavatele karty, pak dopravce, který vyřizuje reklamaci, vyplní
reklamační formulář na CCMSK a vznese dotaz na KODIS o potvrzení posloupnosti předchozích
jízd pro uznání nároku odečtení. Zákazník je odkázán na dořešení reklamace do 5ti dnů od podání
reklamace a je mu vytisknut doklad
Po dořešení reklamace se zákazníkem a po uznání nároku na odečet ZS odesílá do CCMSK ze
strojku transakce, kde v transtype se zadá „mhdr“. Dále v Reclamation se zadá číslo reklamovaného
lístku (číslo transakce), reclamation-device obsahuje číslo zařízení reklamované transakce a
reclamation-provider obsahuje kód dopravce.
Tato reklamace se vždy vztahuje k uživateli s kartou.
Příklad (Reklamace jízdenky/zs po schválení reklamace Kodisem – u vydavatele karty):
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1"
sumcount="1" vat="14" premise="1">
<transaction tx-id="6" card-id="0000000007" appl-id="4609" when="2012-01-
27T13:59:49" type="dep" amount-type="ep" transtype="mhdr" base-rate="0"
amount="20" currency="CZK" vat="14" balance_before="700" balance_after="720"
reclamation-device=„52“ reclamation=“4565421“ reclamation-provider=“352“
supplementary-date=“2012-01-01T13:59:49.000“ />
</transactions>
71
Reklamace/storno nákupu EP na eshopu
U řešení reklamací a storna nákupu EP (žádosti o dobití EP) na eshopu je důležité zohlednit, zdali
byl nákup již zahrnut do aktuálního měsíčního rozúčtování.
Reklamace nákupu EP na eshopu
Reklamace nákupu EP na eshopu se používá v případech, kdy nákup byl již zahrnut do aktuálního
měsíčního rozúčtování. Cestující následně přišel (např. v dalším měsíci) na přepážku reklamovat
nákup z důvodu nefunkčního nahrání zakoupeného EP na kartu apod.
Tyto transakce budou zahrnuty do měsíčního rozúčtování jako vratky a budou mít vliv na
vypočtený celkový zůstatek na kartách.
Příklad transakce nákup EP na eshopu (žádost o dobití EP):
<transaction tx-id="5" card-id="04105DEA052280" appl-id="34965" type="dep" when="2016-01-
01T13:50:00.000" amount-type="card" transtype="eshop-ep" amount="200.0" currency="CZK" vat="0"
balance_before="0" balance_after="200.0" note="" />
Příklad reklamace nákupu EP na eshopu (žádosti o dobití EP):
<transaction tx-id="6" card-id="04105DEA052280" appl-id="34965" type="pay" when="2016-03-
01T13:50:00.000" amount-type="card" transtype="eshop-epr" amount="200.0" currency="CZK" vat="0"
balance_before="0" balance_after="200.0" note="" eshop-tr-id="100" reclamation="0" />
Storno nákupu EP na eshopu
Storno nákupu EP na eshopu se používá v případech, kdy nákup nebyl zahrnut do aktuálního
měsíčního rozúčtování. Došlo k nesprávnému odeslání transakce z důvodu nefunkčního eshopu
apod.
Storno transakce nákupu EP na eshopu lze zasílat pouze ve stejném měsící, kdy byl proveden
nákup.
Tyto transakce nebudou zahrnuty do měsíčního rozúčtování.
Příklad transakce nákup EP na eshopu (žádost o dobití EP):
<transaction tx-id="5" card-id="04105DEA052280" appl-id="34965" type="dep" when="2016-01-
01T13:50:00.000" amount-type="card" transtype="eshop-ep" amount="200.0" currency="CZK" vat="0"
balance_before="0" balance_after="200.0" note="" />
Příklad storna nákupu EP na eshopu (žádosti o dobití EP):
<transaction tx-id="6" card-id="04105DEA052280" appl-id="34965" type="pay" when="2016-01-
02T10:00:00.000" amount-type="card" transtype="cancel" amount="200.0" currency="CZK" vat="0"
balance_before="0" balance_after="200.0" note="" eshop-tr-id="100" reclamation="0" />
72
Posílaní souborů s pozdějším zpracováním
CC umožňuje přijímat jednotlivé XML a zip soubory dle specifikace věty KODIS tak, že nebudou
zpracovávány okamžitě, ale jen se přijmou a uloží pro pozdější zpracování. Při přijímání se
nekontroluje obsah zprávy.
Pro posílání příkazů s pozdějším zpracováním se postupuje stejně jako při posílaní příkazů
s okamžitým zpracováním. Data se neposílají na „clearing.kodis.cz/readdata.aspx“, ale na stránku
„clearing.kodis.cz/ReadDataButProcessLater.aspx“ metoda POST a parametry zůstaly stejné.
Odpovědí je informace zda došlo/nedošlo při příjmu k chybě v standardní hlavičce.
Po přijmutí dávky s pozdějším zpracováním se daná dávka objeví v seznamu dávek jako dávka
s pozdějším zpracováním. Zpracování provádí aplikace, která v daný okamžik (22:00 h) dávky
s pozdějším zpracováním zpracuje. Po zpracování se dávka zobrazí v seznamu stejně jako při
okamžitém zpracování.
Stažení souboru s odpovědí po zpracování
CC umožňuje stažení souboru s odpovědí po zpracování. Stažení je možno provést bud z stránky
s seznamem dávek, nebo přes stránku na adrese „clearing.kodis.cz/GetFile.aspx“ metodou POST.
V metodě POST jsou zasílány celkem 3 parametry name, passwd a filename. První dva obsahují
informace o Loginu a Heslu. Poslední parametr obsahuje název odeslaného souboru na zpracování.
Odpovědí je bud chybové XML nebo daný soubor. Pokud bylo posláno více souborů se stejným
názvem, vyhledá se ten poslední.
73
Webová služba UltralightApi
Rozhraní budou dostupná pomocí webové služby ze serveru KODIS. Předání dat probíhá online
ihned po obdržení dotazu na server.
WS ostrá verze: https://clearing.kodis.cz/UltralightApi/Service.asmx
WS testovací verze: https://clearing.kodis.cz/UltralightApiTest/Service.asmx
Ověřování probíhá jako basic access authentication. Pro volání jednotlivých metod je dále
požadován Userlogin (uživatelský login) a Password (uživatelské heslo) dopravce, který musí mít
rovněž nastaveno právo pro online komunikaci s webovou službou a konkrétní metodou.
Seznam dostupných metod webové služby:
RegisterPurchasedCredit – registrace zakoupeného kreditu elektronické peněženky na Ultralight
kartu do systému
GetCardCredit – získání aktuálního zůstatku kreditu elektronické peněženky Ultralight karty nebo
dopravní karty
GetBluelist – získání bluelistu Ultralight karet vč. zůstatků kreditů elektronických peněženek
RegisterCreditMove – registrace převedení zůstatku elektronické peněženky Ultralight karty na
jinou Ultralight kartu
RegisterPurchasedTicket – registrace zakoupené dlouhodobé jízdenky na Ultralight kartu do
systému
GetCardTicket – získání platných dlouhodobých jízdenek Ultralight karty, bankovní karty nebo
dopravní karty
GetBluelistTicket – získání bluelistu platných dlouhodobých jízdenek Ultralight karet
RegisterCardOperation – registrace operace s Ultralight kartou (platba kreditem elektronické
peněženky/nákup dlouhodobé jízdenky/neplatná operace – použití Ultralight karty bez kreditu a
platné dlouhodobé jízdenky) do systému
RegisterCardBlock – registrace blokace Ultralight karty do systému
RegisterCardUnblock – registrace odblokace Ultralight karty do systému
GetBlacklist – získání aktuálního blacklistu Ultralight karet
CardRegisterPurchasedCredit – registrace zakoupeného kreditu elektronické peněženky na dopravní
kartu do systému
CardRegisterPurchasedTicket – registrace zakoupené dlouhodobé jízdenky na dopravní kartu do
systému
BankCardRegisterPurchasedTicket – registrace zakoupené dlouhodobé jízdenky na bankovní kartu
do systému
RegisterGreenlistConfirmation – přiřazení transakce provedených na e-shopu k dopravní kartě
74
GetCardState – získání informací Ultralight karty, bankovní karty nebo ODIS karty
75
Registrace zakoupeného kreditu elektronické peněženky na Ultralight kartu
Pro registraci zakoupeného kreditu elektronické peněženky na Ultralight kartu do systému je
dostupná metoda RegisterPurchasedCredit(). Při platbě dopravní kartou ODIS se rovněž založí
transakce o pohybu elektronické peněženky na dopravní kartě.
Request
Parameter Type Description Defaul Required
t ?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
PurchasedCreditReq Yes
CardUID string identifikační číslo Ultralight karty N/A Yes
Date datetime datum a čas zakoupení kreditu N/A Yes
elektronické peněženky
Amount decimal zakoupená částka N/A Yes
AmountType typ úhrady (CASH – hotovost, N/A Yes
BANKCARD – bankovní karta,
ULTRALIGHT – Ultralight karta,
CARD – ODIS karta,
BANK_TRANSFER - bankovní
převod)
BalanceBefore decimal předchozí zůstatek na kartě (v N/A No
případě platby Ultralight kartou)
Vat byte sazba DPH N/A No
DeviceNo string označení prodejního automatu N/A Yes
TxID int pořadové číslo transakce na zařízení N/A Yes
IsExternal bool příznak, zdali se jedná o externí N/A Yes
prodej
PaymentReferenc string variabilní symbol N/A No
eNumber
SaleNo int číslo prodeje N/A No
BankCardReq (nepovinný v případě platby bankovní kartou na přepážce) No
Token string token bankovní karty N/A Yes
PanMas string maskované číslo bankovní karty N/A Yes
TerminalNo string označení terminálu N/A Yes
Currency string měna N/A Yes
AuthorizationCod string autorizační kód N/A Yes
e
CardApplication string název karetní aplikace N/A Yes
Name
AID string ID karetní aplikace N/A Yes
OperationResult string výsledek operace N/A Yes
CardReq (povinný v případě platby dopravní kartou ODIS) No
CardID string číslo čipu dopravní karty N/A Yes
CardBalanceBefo decimal předchozí zůstatek na dopravní kartě N/A Yes
re
Response Popis Default Required?
Parametr Typ číslo vzniklé chyby (0 = OK) Yes
ResponseStatus
ErrorCode int N/A Yes
76
ErrorMessage string popis vzniklé chyby N/A Yes
ErrorMessage string popis vzniklé chyby N/A Yes
Výčet chyb naleznete na konci dokumentu.
77
Získání aktuálního zůstatku kreditu elektronické peněženky Ultralight karty
nebo dopravní karty
Pro získání aktuálního zůstatku kreditu elektronické peněženky Ultralight karty nebo dopravní karty
je dostupná metoda GetCardCredit()
Request
Parameter Type Description Default Required?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
CardCreditReq Yes
CardType typ použité karty (ULTRALIGHT – N/A Yes
Ultralight karta, CARD – ODIS karta)
CardUID string identifikační číslo Ultralight karty N/A No
(povinné v případě práce s Ultralight
kartou)
CardID string číslo čipu dopravní karty (povinné N/A No
v případě práce s dopravní kartou)
Response Description Default Required
Parameter Type ?
N/A No
CardCreditResp N/A Yes
N/A Yes
Balance decimal zůstatek Yes
Yes
ResponseStatus číslo vzniklé chyby (0 = OK)
popis vzniklé chyby
ErrorCode int
ErrorMessag string
e
Výčet chyb naleznete na konci dokumentu.
78
Získání bluelistu Ultralight karet vč. zůstatků kreditů elektronických
peněženek
Pro získání bluelistu Ultralight karet vč. zůstatků kreditů elektronických peněženek je dostupná
metoda GetBluelist()
Request
Parameter Type Description Default Required?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
Type typ bluelistu (FULL – celý, INC – N/A Yes
inkrementální)
SequenceNo int počáteční pořadové číslo bluelistu N/A No
(pouze v případě inkrementálního
požadavku)
Response Type Description Default Required
Parameter ?
verze souboru N/A Yes
BluelistCredit [] datum vytvoření dávky N/A Yes
pořadové číslo N/A Yes
BluelistCreditHeader typ bluelistu (celý, inkremetnální) N/A Yes
počet záznamů N/A Yes
FileVersion string příznak, zdali došlo k resetu bluelistu N/A Yes
Yes
IssueDateTime datetime identifikační číslo Ultralight karty N/A Yes
zůstatek na kartě N/A Yes
SequenceNo int typ zákaznického profilu N/A Yes
Yes
BluelistType začátek platnosti profilu Yes
ItemsCount int konec platnosti profilu
Reset bool začátek platnosti karty
konec platnosti karty
BluelistCreditItem [] zbývající částka pro dosáhnutí capping
limitu
CardUID string zbývající částka pro dosáhnutí
skupinového capping limitu
Balance decimal datum a čas nároku na přestup
ADD, DEL (přidání nebo odebrání
CustomerProfi short záznamu)
le číslo vzniklé chyby (0 = OK)
popis vzniklé chyby
CustomerProfi datetime N/A No
leValidFrom
CustomerProfi datetime N/A No
leValidTo
ValidFrom datetime N/A No
N/A No
ValidTo datetime N/A Yes
CappingLimit decimal
CappingGroup decimal N/A Yes
Limit datetime
TransferDate N/A No
StateCode N/A Yes
ResponseStatus Yes
N/A Yes
ErrorCode int N/A Yes
ErrorMessage string
Výčet chyb naleznete na konci dokumentu.
79
Registrace převedení zůstatku elektronické peněženky Ultralight karty na
jinou Ultralight kartu
Pro registraci převedení zůstatku elektronické peněženky Ultralight karty na jinou Ultralight kartu
je dostupná metoda RegisterCreditMove()
Request
Parameter Type Description Default Required?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
CreditMoveReq Yes
OldCardUID string identifikační číslo staré N/A Yes
Ultralight karty
NewCardUID string identifikační číslo nové N/A Yes
Date Ultralight karty
Amount datetime datum a čas převedení N/A Yes
OldBalanceBefore
NewBalanceBefore zůstatku
DeviceNo
decimal částka k převedení N/A Yes
TxID
decimal zůstatek na staré kartě N/A Yes
decimal zůstatek na nové kartě N/A Yes
string označení prodejního N/A Yes
automatu
int pořadové číslo transakce N/A Yes
na zařízení
Response Popis Default Required?
Parametr Typ Yes
ResponseStatus číslo vzniklé chyby (0 = OK) N/A Yes
ErrorCode int popis vzniklé chyby N/A Yes
ErrorMessage string
Výčet chyb naleznete na konci dokumentu.
80
Registrace zakoupené dlouhodobé jízdenky na Ultralight kartu do systému
Pro registraci zakoupené dlouhodobé jízdenky na Ultralight kartu do systému je dostupná metoda
RegisterPurchasedTicket(). Při platbě dopravní kartou ODIS se rovněž založí transakce o pohybu
elektronické peněženky na dopravní kartě.
Request
Parameter Type Description Default Require
d?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
PurchasedTicketReq Yes
CardUID string identifikační číslo Ultralight karty N/A Yes
Date datetime datum a čas zakoupení dlouhodobé N/A Yes
jízdenky
CustomerProfile short typ zákaznického profilu N/A Yes
TariffProfile short číslo tarifu N/A Yes
ValidFrom datetime začátek platnosti dlouhodobé N/A Yes
jízdenky
ValidTo datetime konec platnosti dlouhodobé jízdenky N/A Yes
Zones short [] seznam zón N/A Yes
Amount decimal cena dlouhodobé jízdenky N/A Yes
AmountType typ úhrady (CASH – hotovost, N/A Yes
BANKCARD – bankovní karta,
ULTRALIGHT – Ultralight karta,
CARD – ODIS karta,
BANK_TRANSFER - bankovní
převod)
BalanceBefore decimal předchozí zůstatek na kartě (v N/A No
případě platby Ultralight kartou)
Vat byte sazba DPH N/A No
DeviceNo string označení prodejního automatu N/A Yes
TxID int pořadové číslo transakce na zařízení N/A Yes
PaymentReferenc string variabilní symbol N/A No
eNumber
SaleNo int číslo prodeje N/A No
BankCardReq (nepovinný v případě platby bankovní kartou na přepážce) No
Token string token bankovní karty N/A Yes
PanMas string Maskované číslo bankovní karty N/A Yes
TerminalNo string označení terminálu N/A Yes
Currency string měna N/A Yes
AuthorizationCod string autorizační kód N/A Yes
e
CardApplication string název karetní aplikace N/A Yes
Name
AID string ID karetní aplikace N/A Yes
OperationResult string výsledek operace N/A Yes
CardReq (povinný v případě platby dopravní kartou ODIS) No
CardID string číslo čipu dopravní karty N/A Yes
CardBalanceBefo decimal předchozí zůstatek na dopravní kartě N/A Yes
re
81
Response Popis Default Required?
Parametr Typ Yes
ResponseStatus číslo vzniklé chyby (0 = OK) N/A Yes
ErrorCode int popis vzniklé chyby N/A Yes
ErrorMessage string
Výčet chyb naleznete na konci dokumentu.
82
Získání platných dlouhodobých jízdenek Ultralight karty, bankovní karty nebo
dopravní karty
Pro získání platných dlouhodobých jízdenek Ultralight karty, bankovní karty nebo dopravní karty je
dostupná metoda GetCardTicket()
Request
Parameter Type Description Defaul Required?
t
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
CardTicketReq Yes
CardType typ použité karty (BANKCARD – N/A Yes
bankovní karta, ULTRALIGHT –
Ultralight karta, CARD – ODIS karta)
Token string token bankovní karty (povinné v případě N/A No
práce s bankovní kartou)
CardUID string identifikační číslo Ultralight karty N/A No
(povinné v případě práce s Ultralight
kartou)
CardID string číslo čipu dopravní karty (povinné N/A No
v případě práce s dopravní kartou)
Response
Parameter Type Description Default Required?
No
CardTicketResp [] Yes
Yes
CustomerProfile short typ zákaznické profilu N/A Yes
TariffProfile short číslo tarifu N/A Yes
Yes
ValidFrom datetime začátek platnosti dlouhodobé N/A Yes
Yes
jízdenky Yes
ValidTo datetime konec platnosti dlouhodobé jízdenky N/A
Zones short []
ResponseStatus seznam zón N/A
ErrorCode int
ErrorMessage string číslo vzniklé chyby (0 = OK) N/A
popis vzniklé chyby N/A
Výčet chyb naleznete na konci dokumentu.
83
Získání bluelistu platných dlouhodobých jízdenek Ultralight karet
Pro získání bluelistu platných dlouhodobých jízdenek Ultralight karet je dostupná metoda
GetBluelistTicket()
Request
Parameter Type Description Default Required?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
Type typ bluelistu (FULL – celý, INC – N/A Yes
inkrementální)
SequenceNo int počáteční pořadové číslo bluelistu N/A No
(pouze v případě inkrementálního
požadavku)
Response Type Description Default Required
Parameter ?
N/A Yes
BluelistTicket [] N/A Yes
N/A Yes
BluelistTicketHeader N/A Yes
N/A Yes
FileVersion string verze souboru N/A Yes
datum vytvoření dávky Yes
IssueDateTime datetime pořadové číslo N/A Yes
typ bluelistu (celý, inkremetnální) N/A Yes
SequenceNo int počet záznamů N/A Yes
příznak, zdali došlo k resetu bluelistu N/A Yes
BluelistType N/A Yes
identifikační číslo Ultralight karty N/A Yes
ItemsCount int typ zákaznického profilu N/A Yes
číslo tarifu Yes
Reset bool začátek platnosti dlouhodobé jízdenky Yes
konec platnosti dlouhodobé jízdenky
BluelistTicketItem [] seznam zón
ADD, DEL (přidání nebo odebrání
CardUID string záznamu)
CustomerProfile short číslo vzniklé chyby (0 = OK)
popis vzniklé chyby
TariffProfile short
ValidFrom datetime
ValidTo datetime
Zones short []
StateCode
ResponseStatus int Yes
ErrorCode string N/A Yes
ErrorMessage N/A Yes
Výčet chyb naleznete na konci dokumentu.
84
Registrace operace s Ultralight kartou do systému
Pro registraci operace s Ultralight kartou (platba kreditem elektronické peněženky - nákup
jednotlivé jízdné/nákup dlouhodobé jízdenky/neplatná operace – použití Ultralight karty bez kreditu
a platné dlouhodobé jízdenky) do systému je dostupná metoda RegisterCardOperation()
Request
Parameter Type Description Default Required?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
CardOperationReq Yes
CardUID string identifikační číslo Ultralight karty N/A Yes
Date datetime datum a čas provedení operace N/A Yes
Line string linka, na které byla operace provedena N/A Yes
Sequence int spoj, ve které byla operace provedena N/A Yes
DeviceNo string označení prodejního automatu N/A Yes
TxID int pořadové číslo transakce na zařízení N/A Yes
CappingActive bit příznak, zdali došlo k aplikaci N/A Yes
cappingu
VehicleNumber string číslo vozidla N/A Yes
TaplistNumber int pořadové číslo taplistu N/A Yes
CreditReq No
Amount decimal částka N/A Yes
BalanceBefore decimal předchozí zůstatek na kartě N/A Yes
CappingAmount decimal částka, o kterou byla jízdenka snížena N/A No
v rámci aplikace cappingu
Vat byte sazba DPH N/A No
TicketReq (povinné v případě nákupu dlouhodobé jízdenky) Yes
CustomerProfile short typ zákaznického profilu N/A Yes
TariffProfile short číslo tarifu N/A Yes
ValidFrom datetime začátek platnosti dlouhodobé jízdenky N/A Yes
ValidTo datetime konec platnosti dlouhodobé jízdenky N/A Yes
Zones short [] seznam zón N/A Yes
Response Popis Default Required?
Parametr Typ
ResponseStatus číslo vzniklé chyby (0 = OK) N/A Yes
ErrorCode int popis vzniklé chyby N/A Yes
ErrorMessage string
Výčet chyb naleznete na konci dokumentu.
85
Registrace blokace Ultralight karty do systému
Pro registraci blokace Ultralight karty do systému je dostupná metoda RegisterCardBlock()
Request
Parameter Type Description Default Required
?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
CardBlockReq Yes
CardUID string identifikační číslo Ultralight karty N/A Yes
Date
datetime datum a čas umístění karty na blacklist N/A Yes
Response Description Default Required
Parameter Type ?
číslo vzniklé chyby (0 = OK) N/A Yes
ResponseStatus popis vzniklé chyby N/A Yes
ErrorCode int Yes
ErrorMessag string
e
Výčet chyb naleznete na konci dokumentu.
86
Registrace odblokace Ultralight karty do systému
Pro registraci odblokace Ultralight karty do systému je dostupná metoda RegisterCardUnblock()
Request
Parameter Type Description Default Required
?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
CardUnblockReq Yes
CardUID string identifikační číslo Ultralight karty N/A Yes
Date
datetime datum a čas umístění karty na blacklist N/A Yes
Response Description Default Required
Parameter Type ?
číslo vzniklé chyby (0 = OK) N/A Yes
ResponseStatus popis vzniklé chyby N/A Yes
ErrorCode int Yes
ErrorMessag string
e
Výčet chyb naleznete na konci dokumentu.
87
Získání aktuálního blacklistu Ultralight karet
Pro získání aktuálního blacklistu Ultralight karet je dostupná metoda GetBlacklist()
Request
Parameter Type Description Default Required?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
Type typ blacklistu (FULL – celý, INC – N/A Yes
inkrementální)
SequenceNo int počáteční pořadové číslo blacklistu N/A No
(pouze v případě inkrementálního
požadavku)
Response Description Default Required
Parameter Type ?
N/A Yes
Blacklist [] N/A Yes
Yes
BlacklistHeader Yes
FileVersion string verze souboru
datum vytvoření dávky
IssueDateTim datetime
pořadové číslo
e typ blacklistu (celý, inkremetnální)
počet záznamů
SequenceNo int příznak, zdali došlo k resetu blacklistu N/A Yes
N/A Yes
BlacklistType identifikační číslo Ultralight karty N/A Yes
datum a čas umístění karty na blacklist N/A Yes
ItemsCount int ADD, DEL (přidání nebo odebrání
záznamu) Yes
Reset bool N/A Yes
číslo vzniklé chyby (0 = OK) N/A Yes
BlacklistItem [] popis vzniklé chyby N/A Yes
CardUID string
Date datetime
StateCode
ResponseStatus Yes
ErrorCode int N/A Yes
ErrorMessag string N/A Yes
e
Výčet chyb naleznete na konci dokumentu.
88
Registrace zakoupeného kreditu elektronické peněženky na dopravní kartu
Pro registraci zakoupeného kreditu elektronické peněženky na dopravní kartu do systému je
dostupná metoda CardRegisterPurchasedCredit().
Request
Parameter Type Description Defaul Required
t ?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
CardPurchasedCreditReq Yes
CardID string číslo čipu dopravní karty N/A Yes
Date datetime datum a čas zakoupení kreditu N/A Yes
elektronické peněženky
Amount decimal zakoupená částka N/A Yes
AmountType typ úhrady (CASH – hotovost, N/A Yes
BANKCARD – bankovní karta,
ULTRALIGHT – Ultralight karta)
BalanceBefore decimal předchozí zůstatek na dopravní kartě N/A Yes
Vat byte sazba DPH N/A No
DeviceNo string označení prodejního automatu N/A Yes
TxID int pořadové číslo transakce na zařízení N/A Yes
PaymentReferenc string variabilní symbol N/A No
eNumber
BankCardReq (povinný v případě platby bankovní kartou) No
Token string token bankovní karty N/A Yes
PanMas string Maskované číslo bankovní karty N/A Yes
TerminalNo string označení terminálu N/A Yes
Currency string měna N/A Yes
AuthorizationCod string autorizační kód N/A Yes
e
CardApplication string název karetní aplikace N/A Yes
Name
AID string ID karetní aplikace N/A Yes
OperationResult string výsledek operace N/A Yes
UltralightReq (povinný v případě platby Ultralight kartou) No
CardUID string identifikační číslo Ultralight karty N/A Yes
CardBalanceBefo decimal předchozí zůstatek na Ultralight N/A Yes
re kartě
Response Popis Default Required?
Parametr Typ Yes
ResponseStatus číslo vzniklé chyby (0 = OK) N/A Yes
ErrorCode int popis vzniklé chyby N/A Yes
ErrorMessage string
Výčet chyb naleznete na konci dokumentu.
89
Registrace zakoupené dlouhodobé jízdenky na dopravní kartu do systému
Pro registraci zakoupené dlouhodobé jízdenky na dopravní kartu do systému je dostupná metoda
CardRegisterPurchasedTicket().
Request
Parameter Type Description Default Required?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
CardPurchasedTicketReq Yes
CardID string číslo čipu dopravní karty N/A Yes
Date datetime datum a čas zakoupení dlouhodobé N/A Yes
jízdenky
CustomerProfile short typ zákaznického profilu N/A Yes
TariffProfile short číslo tarifu N/A Yes
ValidFrom datetime začátek platnosti dlouhodobé N/A Yes
jízdenky
ValidTo datetime konec platnosti dlouhodobé jízdenky N/A Yes
Zones short [] seznam zón N/A Yes
Amount decimal cena dlouhodobé jízdenky N/A Yes
AmountType typ úhrady (CASH – hotovost, N/A Yes
BANKCARD – bankovní karta,
ULTRALIGHT – Ultralight karta,
CARD – ODIS karta)
BalanceBefore decimal předchozí zůstatek na dopravní kartě N/A No
(v případě platby dopravní kartou)
Vat DPH sazba DPH N/A No
DeviceNo string označení prodejního automatu N/A Yes
TxID int pořadové číslo transakce na zařízení N/A Yes
PaymentReferenc string variabilní symbol N/A No
eNumber
BankCardReq (povinný v případě platby bankovní kartou) No
Token string token bankovní karty N/A Yes
PanMas string Maskované číslo bankovní karty N/A Yes
TerminalNo string označení terminálu N/A Yes
Currency string měna N/A Yes
AuthorizationCod string autorizační kód N/A Yes
e
CardApplication string název karetní aplikace N/A Yes
Name
AID string ID karetní aplikace N/A Yes
OperationResult string výsledek operace N/A Yes
UltralightReq (povinný v případě platby Ultralight kartou) No
CardUID string identifikační číslo Ultralight karty N/A Yes
CardBalanceBefo decimal předchozí zůstatek na Ultralight N/A Yes
re kartě
Response Popis Default Required?
Parametr Typ Yes
ResponseStatus číslo vzniklé chyby (0 = OK) N/A Yes
ErrorCode int popis vzniklé chyby N/A Yes
ErrorMessage string
90
Výčet chyb naleznete na konci dokumentu.
91
Registrace zakoupené dlouhodobé jízdenky na bankovní kartu do systému
Pro registraci zakoupené dlouhodobé jízdenky na bankovní kartu do systému je dostupná metoda
BankCardRegisterPurchasedTicket().
Request
Parameter Type Description Default Required?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
BankCardPurchasedTicketReq Yes
Token string token bankovní karty N/A Yes
PanMas string maskované číslo bankovní karty N/A Yes
Date datetime datum a čas zakoupení dlouhodobé N/A Yes
jízdenky
CustomerProfile short typ zákaznického profilu N/A Yes
TariffProfile short číslo tarifu N/A Yes
ValidFrom datetime začátek platnosti dlouhodobé N/A Yes
jízdenky
ValidTo datetime konec platnosti dlouhodobé jízdenky N/A Yes
Zones short [] seznam zón N/A Yes
Amount decimal cena dlouhodobé jízdenky N/A Yes
AmountType typ úhrady (CASH – hotovost, N/A Yes
BANKCARD – bankovní karta,
ULTRALIGHT – Ultralight karta,
CARD – ODIS karta)
Vat byte sazba DPH N/A No
DeviceNo string označení prodejního automatu N/A Yes
TxID int pořadové číslo transakce na zařízení N/A Yes
PaymentReferenc string variabilní symbol N/A No
eNumber
TerminalNo string označení terminálu N/A Yes
Currency string měna N/A Yes
AuthorizationCod string autorizační kód N/A Yes
e
CardApplication string název karetní aplikace N/A Yes
Name
AID string ID karetní aplikace N/A Yes
OperationResult string výsledek operace N/A Yes
CardReq (povinný v případě platby dopravní kartou ODIS) No
CardID string číslo čipu dopravní karty N/A Yes
CardBalanceBefo decimal předchozí zůstatek na dopravní kartě N/A Yes
re
UltralightReq (povinný v případě platby Ultralight kartou) No
CardUID string identifikační číslo Ultralight karty N/A Yes
CardBalanceBefo decimal předchozí zůstatek na Ultralight N/A Yes
re kartě
Response Popis Default Required?
Parametr Typ Yes
ResponseStatus číslo vzniklé chyby (0 = OK) N/A Yes
ErrorCode int popis vzniklé chyby N/A Yes
ErrorMessage string
92
Výčet chyb naleznete na konci dokumentu.
93
Přiřazení transakce provedených na e-shopu k dopravní kartě
Pro přiřazení transakce provedených na e-shopu k dopravní kartě je dostupná metoda
RegisterGreenlistConfirmation().
Request
Parameter Type Description Defaul Required
t ?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
GreenlistConfirmationReq Yes
CardID string číslo čipu dopravní karty N/A Yes
Date datetime datum a čas provedení operace N/A Yes
EshopTrID int číslo e-shop transakce vygenerované N/A Yes
na straně CC
DeviceNo string označení prodejního automatu N/A Yes
TxID int pořadové číslo transakce na zařízení N/A Yes
Response Popis Default Required?
Parametr Typ Yes
ResponseStatus číslo vzniklé chyby (0 = OK) N/A Yes
ErrorCode int popis vzniklé chyby N/A Yes
ErrorMessage string
Výčet chyb naleznete na konci dokumentu.
94
Získání informací Ultralight karty, bankovní karty nebo ODIS karty
Pro získání informací Ultralight karty, bankovní karty nebo ODIS karty je dostupná metoda
GetCardState()
Request Description Default Required?
Parameter Type uživatelský login dopravce N/A Yes
Userlogin string uživatelské heslo dopravce N/A Yes
Password string Yes
CardStateReq identifikační číslo Ultralight karty, N/A Yes
CardUID string bankovní karty nebo ODIS karty
typ použité karty N/A Yes
CardType
ULTRALIGHT – Ultralight karta
BANKCARD – bakovní karta
CARD – ODIS karta
Response Type Description Default Required?
Parameter No
CardStateResp string identifikační číslo karty N/A Yes
CardUID string logické číslo karty N/A No
CardNo datetime datum zavedení karty N/A Yes
Date stav karty N/A Yes
State
REGISTERED – zavedená
VALID – platná
INVALID – neplatná
BLOCKED – blokovaná
CustomerProfile short zákaznický profil 1 N/A No
1
CustomerProfile datetime začátek platnosti profilu 1 N/A No
1ValidFrom
CustomerProfile datetime konec platnosti profilu 1 N/A No
1ValidTo
CustomerProfile short zákaznický profil 2 N/A No
2
CustomerProfile datetime začátek platnosti profilu 2 N/A No
2ValidFrom
CustomerProfile datetime konec platnosti profilu 2 N/A No
2ValidTo
ValidFrom datetime platnost od N/A No
ValidTo datetime platnost do N/A No
Balance decimal zůstatek N/A No
CardStateTicketResp [] No
CustomerProfile short typ zákaznické profilu N/A Yes
TariffProfile short číslo tarifu N/A Yes
ValidFrom datetime začátek platnosti dlouhodobé N/A Yes
jízdenky
ValidTo datetime konec platnosti dlouhodobé jízdenky N/A Yes
95
Zones short [] seznam zón N/A Yes
typ greenlistu
CardStateGreenlistResp [] No
GreenlistType N/A Yes
EP – elektronická peněženka
COUPON – dlouhodobé kupóny
EshopTrId int identifikační číslo e-shop transakce N/A Yes
Amount decimal částka N/A Yes
CustomerProfile short typ zákaznické profilu N/A No
TariffProfile short číslo tarifu N/A No
ValidFrom datetime začátek platnosti dlouhodobé N/A No
jízdenky
ValidTo datetime konec platnosti dlouhodobé jízdenky N/A No
Zones short [] seznam zón N/A No
ResponseStatus Yes
ErrorCode int číslo vzniklé chyby (0 = OK) N/A Yes
ErrorMessage string popis vzniklé chyby N/A Yes
Výčet chyb naleznete na konci dokumentu.
96
Seznam dalších metod webové služby pro podporu eshopu:
GetTicketList – získání všech dlouhodobých jízdenek Ultralight karty
GetFareList – získání všech jízdenek Ultralight karty dle časového období (pokud není zadáno
časové období, vrací jízdenky za poslední 3 měsíce. Maximální rozpětí časového období je 1 rok)
GetBalanceList – získání všech pohybů elektronické peněženky dle časového období (pokud není
zadáno časové období, vrací pohyby za poslední 3 měsíce. Maximální rozpětí časového období je 1
rok)
RegisterProfileChange – registrace změny zákaznického profilu na Ultralight kartě
GetState – získání všech informací Ultralight karty vč. aktuálního zůstatku elektronické peněženky
RegisterCreditPayOut – registrace vyplacení zůstatku elektronické pěněženky z Ultralight karty
GetCreditlist – získání sezamu všech prodejů elektronické peněženky na Ultralight kartách
GetCouponlist – získání sezamu všech prodejů dlouhodobých jízdenek na Ultralight kartách
RegisterCancellation – registrace storna nákupu EP nebo dlouhodobé jízdenky na Ultralight kartě
97
Získání všech dlouhodobých jízdenek Ultralight karty
Pro získání všech dlouhodobých jízdenek Ultralight karty je dostupná metoda GetTicketList()
Request
Parameter Type Description Defaul Required?
t
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
TicketListReq Yes
CardUID string identifikační číslo Ultralight karty N/A Yes
ValidOnly bool Pouze platné nebo budoucí platné N/A Yes
Response
Parameter Type Description Default Required?
No
TicketListResp [] Yes
Date datetime datum a čas zakoupení dlouhodobé N/A Yes
Yes
jízdenky Yes
CustomerProfile short typ zákaznické profilu N/A Yes
Yes
TariffProfile short číslo tarifu N/A Yes
Yes
ValidFrom datetime začátek platnosti dlouhodobé N/A
No
jízdenky Yes
ValidTo datetime konec platnosti dlouhodobé jízdenky N/A Yes
Zones short [] Yes
Amount decimal seznam zón N/A Yes
AmountType Yes
cena dlouhodobé jízdenky N/A
typ úhrady (CASH – hotovost, N/A
BANKCARD – bankovní karta,
ULTRALIGHT – Ultralight karta,
CARD – ODIS karta,
BANK_TRANSFER - bankovní
převod)
Vat byte sazba DPH N/A
ProcessingType string
ID N/A
TransactionID guid
ResponseStatus ID transakce N/A
ErrorCode int
ErrorMessage string číslo vzniklé chyby (0 = OK) N/A
popis vzniklé chyby N/A
Výčet chyb naleznete na konci dokumentu.
98
Získání všech jízdenek Ultralight karty dle časového období
Pro získání všech jízdenek Ultralight karty dle časového období (pokud není zadáno časové období,
vrací jízdenky za poslední 3 měsíce. Maximální rozpětí časového období je 1 rok) je dostupná
metoda GetFareList()
Request
Parameter Type Description Defaul Required?
t
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
FareListReq Yes
CardUID string identifikační číslo Ultralight karty N/A Yes
DateFrom datetime datum od N/A Yes
DateTo datetime datum do N/A Yes
Response Type Description Default Required?
Parameter N/A No
FareListResp [] datetime datum a čas provedení jízdy N/A Yes
Date int číslo transakce N/A Yes
TxID string linka N/A Yes
Line int spoj N/A Yes
Sequence short typ zákaznické profilu N/A Yes
CustomerProfile short číslo tarifu N/A Yes
TariffProfile short [] seznam zón N/A Yes
Zones decimal částka N/A Yes
Amount byte Sazba DPH N/A No
Vat typ jízdenky ( Yes
CalculatedType NORMAL - normální jízda N/A
ALL_DAY - celodenní jízdenka N/A Yes
ResponseStatus ALL_DAY_GROUP - celodenní Yes
skupinová jízdenka Yes
ErrorCode int ALL_DAY_NETWORK - celodenní
síťová jízdenka
ErrorMessage string ALL_DAY_GROUP_NETWORK -
celodenní skupinová síťová
jízdenka)
číslo vzniklé chyby (0 = OK)
popis vzniklé chyby
Výčet chyb naleznete na konci dokumentu.
99
Získání všech pohybů elektronické peněženky dle časového období
Pro získání všech pohybů elektronické peněženky dle časového období (pokud není zadáno časové
období, vrací pohyby za poslední 3 měsíce. Maximální rozpětí časového období je 1 rok) je
dostupná metoda GetBalanceList()
Request
Parameter Type Description Defaul Required?
t
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
BalanceListReq Yes
CardUID string identifikační číslo Ultralight karty N/A Yes
DateFrom datetime datum od N/A Yes
DateTo datetime datum do N/A Yes
Response
Parameter Type Description Default Required?
N/A No
BalanceListResp [] datum a čas provedení pohybu N/A Yes
číslo transakce N/A Yes
Date datetime částka N/A Yes
typ úhrady (CASH – hotovost, Yes
TxID int BANKCARD – bankovní karta, N/A
ULTRALIGHT – Ultralight karta, N/A No
Amount decimal CARD – ODIS karta, N/A Yes
BANK_TRANSFER - bankovní N/A Yes
AmountType převod) N/A Yes
sazba DPH Yes
Vat byte ID transakce N/A
TransactionID guid předchozí zůstatek No
BalanceBefore decimal následující zůstatek
BalanceAfter decimal typ transakce (
TransactionTyp CREDIT_BUY - zakoupení kreditu
e elektronické peněženky
TRANSACTION – provedení
CalculatedType operace (transakce jízdné)
CREDIT_MOVE – převod
elektronické peněženky
TICKET_BUY – nákup kupónu
ADDITIONAL_FARE_BUY –
nákup dokupovaného jízdného
typ jízdenky (
NORMAL - normální jízda
ALL_DAY - celodenní jízdenka
ALL_DAY_GROUP - celodenní
skupinová jízdenka
ALL_DAY_NETWORK - celodenní
síťová jízdenka
ALL_DAY_GROUP_NETWORK -
celodenní skupinová síťová
jízdenka)
100
Povinné v případě TransactionType
= TRANSACTION
ResponseStatus Yes
ErrorCode int číslo vzniklé chyby (0 = OK) N/A Yes
ErrorMessage string popis vzniklé chyby N/A Yes
Výčet chyb naleznete na konci dokumentu.
101
Registrace změny zákaznického profilu na Ultralight kartě
Pro registraci změny zákaznického profilu na Ultralight kartě je dostupná metoda
RegisterProfileChange()
Request
Parameter Type Description Default Required
?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
CardProfileChangeReq Yes
CardUID string identifikační číslo Ultralight karty N/A Yes
Date datetime datum a čas změny N/A Yes
CustomerPro datetime zákaznický profil N/A Yes
file
ValidFrom datetime začátek platnosti N/A Yes
ValidTo datetime konec platnosti N/A Yes
DeviceNo string označení prodejního automatu N/A Yes
Response Description Default Required
Parameter Type ?
číslo vzniklé chyby (0 = OK) N/A Yes
ResponseStatus popis vzniklé chyby N/A Yes
ErrorCode int Yes
ErrorMessag string
e
Výčet chyb naleznete na konci dokumentu.
102
Získání všech informací Ultralight karty vč. aktuálního zůstatku elektronické
peněženky
Pro získání všech informací Ultralight karty vč. aktuálního zůstatku elektronické peněženky je
dostupná metoda GetState()
Request
Parameter Type Description Default Required?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
StateReq Yes
CardUID string identifikační číslo Ultralight karty N/A No
Response Description Default Required
Parameter Type ?
N/A No
StateResp string číslo karty N/A Yes
CardNo datetime datum zavedení karty N/A Yes
Date stav karty (REGISTERED – zavedená Yes
State VALID – platná
INVALID – neplatná
CustomerPro short BLOCKED – blokovaná) N/A Yes
zákaznický profil
file N/A No
začátek platnosti profilu
CustomerPro datetime N/A No
konec platnosti profilu
fileValidFro N/A No
platnost od N/A No
m platnost do N/A Yes
zůstatek
CustomerPro datetime Yes
číslo vzniklé chyby (0 = OK) N/A Yes
fileValidTo popis vzniklé chyby N/A Yes
ValidFrom datetime
ValidTo datetime
Balance decimal
ResponseStatus
ErrorCode int
ErrorMessag string
e
Výčet chyb naleznete na konci dokumentu.
103
Registrace vyplacení zůstatku elektronické peněženky z Ultralight karty
Pro registraci vyplacení zůstatku elektronické peněženky z Ultralight karty je dostupná metoda
RegisterCreditPayOut().
Request
Parameter Type Description Defaul Required
t ?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
CreditPayOutReq Yes
CardUID string identifikační číslo Ultralight karty N/A Yes
Date datetime datum a čas vyplacení zůstatku N/A Yes
Amount decimal částka N/A Yes
BalanceBefore decimal zůstatek na kartě N/A Yes
DeviceNo string označení prodejního automatu N/A Yes
TxID int pořadové číslo transakce na zařízení N/A Yes
Response
Parametr Typ Popis Default Required?
Yes
CreditPayOutResp aktuální zůstatek Ultralight karty N/A Yes
Yes
Balance decimal číslo vzniklé chyby (0 = OK) N/A Yes
popis vzniklé chyby N/A Yes
ResponseStatus
ErrorCode int
ErrorMessage string
Výčet chyb naleznete na konci dokumentu.
104
Získání sezamu všech prodejů elektronické peněženky na Ultralight kartách
Pro získání sezamu všech prodejů elektronické peněženky na Ultralight kartách je dostupná metoda
GetCreditlist()
Request
Parameter Type Description Default Required?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
SequenceNo int pořadové číslo creditlistu N/A Yes
Response Type Description Defaul Required
Parameter t ?
Yes
Creditlist [] N/A Yes
N/A Yes
CreditlistHeader N/A Yes
N/A Yes
FileVersion string verze souboru N/A Yes
datum vytvoření dávky N/A Yes
IssueDateTime datetime pořadové číslo Yes
typ creditlistu (celý, inkremetnální)
SequenceNo int počet záznamů
příznak, zdali došlo k resetu
CreditlistType creditlistu
ItemsCount int identifikační číslo Ultralight karty
datum a čas zakoupení kreditu
Reset bool elektronické peněženky
zakoupená částka
CreditlistItem [] typ úhrady (CASH – hotovost, Yes
BANKCARD – bankovní karta, N/A Yes
CardUID string ULTRALIGHT – Ultralight karta, N/A Yes
CARD – ODIS karta,
Date datetime BANK_TRANSFER - bankovní
převod)
Amount decimal zůstatek na kartě N/A Yes
sazba DPH N/A Yes
AmountType variabilní symbol
Balance decimal ADD, DEL (přidání nebo odebrání N/A Yes
Vat byte záznamu) N/A No
PaymentRefer string N/A No
enceNumber číslo vzniklé chyby (0 = OK)
StateCode popis vzniklé chyby N/A Yes
ResponseStatus Yes
N/A Yes
ErrorCode int N/A Yes
ErrorMessage string
Výčet chyb naleznete na konci dokumentu.
105
Získání sezamu všech prodejů dlouhodobých jízdenek na Ultralight kartách
Pro získání sezamu všech prodejů dlouhodobých jízdenek na Ultralight kartách je dostupná metoda
GetCouponlist()
Request
Parameter Type Description Default Required?
Userlogin string uživatelský login dopravce N/A Yes
Password string uživatelské heslo dopravce N/A Yes
SequenceNo int pořadové číslo ticketlistu N/A Yes
Response Type Description Default Required
Parameter ?
N/A Yes
Couponlist [] string verze souboru N/A Yes
CouponlistHeader datetime datum vytvoření dávky N/A Yes
FileVersion int pořadové číslo N/A Yes
IssueDateTime typ ticketlistu (celý, inkremetnální) N/A Yes
SequenceNo int počet záznamů N/A Yes
TicketlistType bool příznak, zdali došlo k resetu ticketlistu Yes
ItemsCount N/A Yes
Reset string identifikační číslo Ultralight karty N/A Yes
CouponlistItem [] datetime datum a čas zakoupení dlouhodobé Yes
CardUID jízdenky Yes
Date typ zákaznického profilu
číslo tarifu
CustomerProfile short začátek platnosti dlouhodobé jízdenky N/A Yes
TariffProfile short konec platnosti dlouhodobé jízdenky N/A Yes
ValidFrom datetime seznam zón N/A Yes
ValidTo datetime cena dlouhodobé jízdenky N/A Yes
Zones short [] typ úhrady (CASH – hotovost, N/A Yes
Amount decimal BANKCARD – bankovní karta, N/A Yes
AmountType ULTRALIGHT – Ultralight karta, N/A Yes
CARD – ODIS karta,
Vat byte BANK_TRANSFER - bankovní N/A No
PaymentReferenc string převod) N/A No
eNumber sazba DPH
StateCode variabilní symbol N/A Yes
ResponseStatus int ADD, DEL (přidání nebo odebrání Yes
ErrorCode string záznamu) N/A Yes
ErrorMessage N/A Yes
číslo vzniklé chyby (0 = OK)
popis vzniklé chyby
Výčet chyb naleznete na konci dokumentu.
106
Registrace storna nákupu EP nebo dlouhodobé jízdenky na Ultralight kartě
Pro registraci storna nákupu EP nebo dlouhodobé jízdenky na Ultralight kartě je dostupná metoda
RegisterCancellation()
Request
Parameter Type Description Default Required?
uživatelský login dopravce N/A Yes
Userlogin string uživatelské heslo dopravce N/A Yes
Password string číslo prodeje N/A Yes
datum a čas provedení storna N/A Yes
RegisterCancellationReq
SaleNo int
Date datetime
Response Type Description Default Required
Parameter ?
int číslo vzniklé chyby (0 = OK) N/A Yes
ResponseStatus string popis vzniklé chyby N/A Yes
ErrorCode Yes
ErrorMessage
Výčet chyb naleznete na konci dokumentu.
107
Chybové stavy
Aktualizace ke dni 04. 11. 2019
-1 Chyba při zjištění popisu chyby: Popis neexistuje
0 Akce proběhla bez chyb.
1 Nebyla nalezena cena v ceníku.
2 Součet cen jednotlivých jízdenek nemůže být větší než cena celodenní skupinové jízdenky.
100 ACM: User not found
101 ACM: User found more than once
102 ACM: User is not assigned the right
103 ACM: User not found by ID
104 ACM: Device not found by number and provider
200 Chyba při ukládání transakce: Duplicitní transakce
201 Chyba při ukládání transakce: Data v tabulce CardEmv nebyla uložena
202 Chyba při ukládání transakce: ODIS karta neexistuje
203 Chyba při ukládání transakce: Data v tabulce Transaction nebyla uložena
204 Chyba při ukládání transakce: Data v tabulce Balance nebyla uložena
205 Chyba při zjištění stavu karty: Karta neexistuje
206 Chyba při ukládání transakce: Data v tabulce Fare nebyla uložena
207 Chyba při ukládání transakce: Data v tabulce FareCheckOut nebyla uložena
208 Chyba při ukládání transakce: Nenalezen tarif v ceníku
209 Chyba při ukládání transakce: Data v tabulce Fare nebyla upravena
210 Chyba při ukládání transakce: Chyba při clearování dat
211 Chyba při ukládání transakce: Data v tabulce FareZone nebyla uložena
212 Chyba při ukládání transakce: Chyba při přidání Fare do BluelistTicket
213 Chyba při ukládání transakce: Chyba při odebrání Fare z BluelistTicket
214 Chyba při ukládání transakce: Zavedení karty nebylo provedeno
215 Chyba při ukládání transakce: Záznam změny karty nebyl proveden
216 Chyba při ukládání transakce: Data v tabulce Coupon nebyla uložena
217 Chyba při ukládání transakce: Data v tabulce CouponZone nebyla uložena
218 Chyba při ukládání transakce: Blokace karty nebyla provedena
219 Chyba při ukládání transakce: Karta je již blokována
220 Chyba při ukládání transakce: Karta není blokována
221 Chyba při ukládání transakce: Neplatný zůstatek na staré kartě
222 Chyba při ukládání transakce: Neplatný tarif pro nákup kupónu
223 Chyba při zjištění stavu karty: Karta není ve stavu REGISTERED nebo VALID
224 Chyba při zjištění karty: Karta neexistuje
225 Chyba při ukládání transakce: Transakce převedna na typ jízda na platný dlouhodobý kupón
226 Chyba při ukládání transakce: Karta byla již přednabita pro externí prodej
227 Chyba při ukládání transakce: Jedná se o pozdě dodanou transakci
228 Chyba při ukládání transakce: Jedná se o uznaný přestup nebo dojezd na konečnou stanici
229 Chyba při ukládání transakce: Jedná se o neplatný check-out
230 Chyba při ukládání transakce: Změna zákaznického profilu nebyla provedena
231 Chyba při ukládání transakce: Změna zákaznického profilu nebyla provedena - RestApi: {0}
232 Chyba při ukládání transakce: Změna zákaznického profilu nebyla provedena - ODIS karta {0}
108
233 Chyba při ukládání transakce: Změna zákaznického profilu nebyla provedena - karta nemá
vyplněnou platnost (nebyla použita)
234 Chyba při ukládání transakce: Provedení CI - CO - CI ve stejném vozidle do 10 min
235 Chyba při stornování transakce: Transakce nenalezena
236 Chyba při stornování transakce: Transakce již byla stornována dne {0}
300 Bluelist: BluelistBatchType value not supported
301 Bluelist: Value of parameter BluelistSequenceNo must be in range
<1;LastIssuedBluelistSequenceNo>
302 BluelistTicket: BluelistTicketBatchType value not supported
303 BluelistTicket: Value of parameter BluelistTicketSequenceNo must be in range
<1;LastIssuedBluelistTicketSequenceNo>
304 Bluelist: Bluelist not created
305 Creditlist: Creditlist not created
306 Ticketlist: Ticketlist not created
400 UltralightApi: Neplatné číslo zařízení
109
Příklady užití
1. Prodej jednotlivého regionálního jízdné (papírová kilometrická jízdenka) na papír, platba
v hotovosti ve vozidle s provedením jízdy
<transaction tx-id="6" when="2012-01-06T13:59:49.000" line="900250" sequence="11"
type="pay" amount-type="cash" transtype="mhd" base-rate="zs" amount="9.5" currency="CZK"
vat="14" departure-id="130000" arrival-id="365000" tariff-type="JD" tariff="1" person-type="1"
note="papir" />
2. Prodej jednotlivého regionálního jízdné (papírová kilometrická jízdenka) na papír, platba
z EP ve vozidle s provedením jízdy
<transaction tx-id="6" card-id="04105DEA052280" appl-id="4609" when="2012-01-
06T13:59:49.000" line="900250" sequence="11" type="pay" amount-type="ep" transtype="mhd"
base-rate="zs" amount="9.5" currency="CZK" vat="14" balance_before="704.1"
balance_after="694.6" departure-id="130000" arrival-id="365000" tariff-type="JD" tariff="1"
person-type="1" note="papir" />
3. Prodej jednotlivého městského jízdné (papírová MHD jízdenka) na papír, platba v hotovosti
<transaction tx-id="6" when="2012-01-06T13:59:49.000" line="900250" sequence="11"
type="pay" amount-type="cash" transtype="mhd" base-rate="zs" amount="20" currency="CZK"
vat="14" departure-id="130000" tariff-type="JD" tariff="4" person-type="1" note="papir"
zones=“45;60“ />
4. Prodej jednotlivého městského jízdné (papírová MHD jízdenka) na papír, platba z EP
<transaction tx-id="6" card-id="04105DEA052280" appl-id="4609" when="2012-01-
06T13:59:49.000" line="900250" sequence="11" type="pay" amount-type="ep" transtype="mhd"
base-rate="zs" amount="20" currency="CZK" vat="14" balance_before="700"
balance_after="680" departure-id="130000" tariff-type="JD" tariff="4" person-type="1"
note="papir" departure-zone=“5“ zones=“5;6“ arrival-zone=“6“ />
5. Prodej jednotlivého regionálního jízdné (kilometrická jízdenka) na BČK, platba z EP ve
vozidle s provedením jízdy
<transaction tx-id="6" card-id="04105DEA052280" appl-id="4609" when="2012-01-
06T13:59:49.000" line="900250" sequence="11" type="pay" amount-type="ep" transtype="mhd"
base-rate="zs" amount="9.5" currency="CZK" vat=„14“ balance_before="704.1"
balance_after="694.6" departure-id="130000" arrival-id="365000" tariff-type="JD" tariff="1"
person-type="1" note="" />
6. Prodej jednotlivého městského jízdné (MHD jízdenka) na BČK, platba z EP
<transaction tx-id="6" card-id="04105DEA052280" appl-id="4609" when="2012-01-
06T13:59:49.000" line="900250" sequence="11" type="pay" amount-type="ep" transtype="mhd"
base-rate="zs" amount="20" currency="CZK" vat="14" balance_before="700"
balance_after="680" departure-id="130000" tariff-type="JD" tariff="4" person-type="1" note=""
zones=“45;60“ />
7. Jízda na el. jízdenku (uznání přestupu na MHD jízdenku)
<transaction tx-id="6" card-id="04105DEA052280" appl-id="34965" when="2012-01-
06T13:59:49.000" line="900250" sequence="11" type="pay" amount-type="ep" transtype="mhd"
base-rate="0" amount="20" currency="CZK" vat="14" balance_before="700" balance_after="680"
departure-id="130000" tariff-type="PP" tariff="4" person-type="1" note="" departure-zone=“5“
zones=“5;6“ arrival-zone=“6“ />
110
8. Dobití EP
<transaction tx-id="5" card-id="04105DEA052280" appl-id="34965" type="dep" when="2012-01-
06T13:50:00.000" amount-type="ep" transtype="uni" line="900250" sequence="11"
amount="700.0" currency="CZK" vat="0" balance_before="0" balance_after="700.0" note="" />
9. Dobití časového kupónu v hotovosti
<transaction tx-id="3" card-id="045056B26A1E80" appl-id="4609" when="2012-01-
06T13:28:31.000" type="pay" amount-type="cash" transtype="mhdp"
line="900250" sequence="11" amount="225" departure-id="130000" currency="CZK" vat="14"
zone="21" valid-from="2012-01-06 00:00:00" valid-to="2012-02-04 00:00:00" tariff="14" tariff-
type="PP" person-type="1" note="" />
10. Dobití časového kupónu z EP
<transaction tx-id="3" card-id="045056B26A1E80" appl-id="4609" when="2012-01-
06T13:28:31.000" type="pay" amount-type="ep" transtype="mhdp" line="900250" sequence="11"
amount="225" departure-id="130000" currency="CZK" vat="14" balance_before="1225"
balance_after="1000" zone="21;35" valid-from="2012-01-06 00:00:00" valid-to="2012-02-04
00:00:00" tariff="14" tariff-type="PP" person-type="1" note="" />
11. Jízda na časový kupón
<transaction tx-id="4" card-id="04105DEA052280" appl-id="4609" when="2012-01-
06T13:59:49.000" line="900250" sequence="11" type="pay" amount-type="prepaid"
transtype="mhd" base-rate="zs" amount="0" currency="CZK" vat=„14“ departure-id="130000"
arrival-id="365000" tariff-type="PP" tariff="14" person-type="1" note="" zones=“100;112“ />
12. Storno jízdenky
Viz kapitola reklamace.
13. Prodej jednotlivého regionálního jízdné (kilometrická jízdenka) na BČK, platba z EP (jen
nákup) bez jízdy
<transaction tx-id="6" card-id="04105DEA052280" appl-id="4609" when="2012-01-
06T13:59:49.000" line="900250" sequence="11" type="pay" amount-type="ep" transtype="mhdtb"
base-rate="zs" amount="9.5" currency="CZK" vat=„14“ balance_before="704.1"
balance_after="694.6" departure-id="130000" arrival-id="365000" tariff-type="JD" tariff="1"
person-type="1" note="" />
14. MULTI-Transakce: Jízda na kupón z BČK + doplatek za km jízdné
<transaction tx-id="123" multi-index=“1“ multi-sum=“2“ card-id="04105DEA051280" appl-
id="4609" when="2012-01-06T13:59:49.000" line="900250" sequence="11" type="pay" amount-
type="prepaid" transtype="mhd" base-rate="zs" amount="0" currency="CZK" vat=„14“ departure-
id="130000" arrival-id="365000" tariff-type="PP" tariff="14" person-type="1" note="Multi
transakce 1" zones=“62“ />
<transaction tx-id="123" multi-index=“2“ multi-sum=“2“ card-id="04105DEA051280" appl-
id="4609" when="2012-01-06T13:59:49.000" line="900250" sequence="11" type="pay" amount-
type="ep" transtype="mhd" base-rate="zs" amount="12.5" currency="CZK" vat=„14“
balance_before="250.5" balance_after="238" departure-id="130000" arrival-id="365000" tariff-
type="JD" tariff="1" person-type="1" note="Multi transakce 2" />
15. MULTI-Transakce: Prodej dvou jednotlivých jízd na přípojové spoje regionálního jízdné
(kilometrická jízdenka) na BČK, platba z EP (V druhém případě se nejedná o jízdu ale jen o
111
nákup jízdenky a ve vozidle, kde jízda pokračuje, je třeba vygenerovat transakci jízdy (není
jisté, že daný pasažér tuto jízdu nastoupil).
<transaction tx-id="124" multi-index=“1“ multi-sum=“2“ card-id="04105DEA051280" appl-
id="4609" when="2012-01-06T13:59:49.000" line="900250" sequence="11" type="pay" amount-
type="ep" transtype="mhd" base-rate="zs" amount="60" currency="CZK" vat=„14“
balance_before="700" balance_after="640" departure-id="130000" arrival-id="365000" tariff-
type="JD" tariff="1" person-type="1" note="Multi transakce 1" />
<transaction tx-id="124" multi-index=“2“ multi-sum=“2“ card-id="04105DEA051280" appl-
id="4609" when="2012-01-06T13:59:49.000" line="9150" sequence="31" type="pay" amount-
type="ep" transtype="mhdtb" base-rate="0" amount="30.5" currency="CZK" vat=„14“
balance_before="640" balance_after="609.5" departure-id="365000" arrival-id="241000" tariff-
type="JD" tariff="1" person-type="1" note="Multi transakce 2" />
Transakce ve vozidle kde jízda pokračuje, vypadá takto:
<transaction tx-id="35451" card-id="04105DEA051280" appl-id="4609" when="2012-01-
06T14:42:11.650" line="2150" sequence="31" type="pay" amount-type="ep" transtype="mhd"
base-rate="0" amount="30.5" currency="CZK" vat=„14“ balance_before="640"
balance_after="609.5" departure-id="365000" arrival-id="241000" tariff-type="JD" tariff="1"
person-type="1" note="provedení jízdy a zaslání do CCMSK" />
16. Prodej jednotlivého regionálního jízdné (kilometrická jízdenka) na BČK, platba v hotovosti
ve vozidle s provedením jízdy
<transaction tx-id="6" card-id="04105DEA052280" appl-id="4609" when="2012-01-
06T13:59:49.000" line="900250" sequence="11" type="pay" amount-type="cash" transtype="mhd"
base-rate="zs" amount="9.5" currency="CZK" vat=„14“ departure-id="130000" arrival-
id="365000" tariff-type="JD" tariff="1" person-type="1" note="" />
17. Prodej papírového kupónu a platba v hotovosti
<transaction tx-id="116" when="2012-01-06T13:59:49.000" line="900250" sequence="11"
type="pay" amount-type="cash" transtype="mhdp" amount="600" currency="CZK" vat=„14“
departure-id="130000" tariff-type="PP" tariff="14" person-type="1" zone="21" valid-from="2012-
01-06 00:00:00" valid-to="2012-02-04 00:00:00" note="" />
18. Pořízení žádosti na dobití EP přes e-shop bankovním převodem
<transaction tx-id="5" card-id="04105DEA052280" appl-id="34965" type="dep" when="2012-01-
06T13:50:00.000" amount-type="bank" transtype="eshop-ep" amount="700.0" currency="CZK"
vat="0" balance_before="0" balance_after="700.0" note="" />
Poznámka: jednoznačné ID e-shop transakce vygeneruje CC a vrátí ho v odpovědním XML
v atributu eshop-tr-id
19. Pořízení žádosti na dobití EP přes e-shop platební kartou
<transaction tx-id="5" card-id="04105DEA052280" appl-id="34965" type="dep" when="2012-01-
06T13:50:00.000" amount-type="card" transtype="eshop-ep" amount="700.0" currency="CZK"
vat="0" balance_before="0" balance_after="700.0" note="" />
Poznámka: jednoznačné ID e-shop transakce vygeneruje CC a vrátí ho v odpovědním XML
v atributu eshop-r-id
20. Storno žádosti na dobití EP přes e-shop
<transaction tx-id="5" card-id="04105DEA052280" appl-id="34965" type="pay" when="2012-01-
06T13:50:00.000" amount-type="card" transtype="cancel" amount="700.0" currency="CZK"
vat="0" balance_before="0" balance_after="700.0" note="" eshop-tr-id=”100” reclamation=”0” />
112
21. Příklad reklamace nákupu EP na eshopu (žádosti o dobití EP)
<transaction tx-id="6" card-id="04105DEA052280" appl-id="34965" type="pay" when="2016-03-
01T13:50:00.000" amount-type="card" transtype="eshop-epr" amount="200.0" currency="CZK"
vat="0" balance_before="0" balance_after="200.0" note="" eshop-tr-id="100" reclamation="0" />
22. Provedení fyzického dobití EP na základě transakce z green-listu
<transaction tx-id="5" card-id="04105DEA052280" appl-id="34965" type="dep" when="2012-01-
06T13:50:00.000" amount-type="ep" transtype="uni" amount="700.0" currency="CZK" vat="0"
balance_before="0" balance_after="700.0" note="" eshop-tr-id=”100” />
23. Pořízení žádosti na dobití časového kupónu přes e-shop bank. převodem
<transaction tx-id="3" card-id="045056B26A1E80" appl-id="4609" when="2012-01-
06T13:28:31.000" type="pay" amount-type="bank" transtype="eshop-c"
line="900250" sequence="11" amount="225" currency="CZK" vat="14" zone="21" valid-
from="2012-01-06 00:00:00" valid-to="2012-02-04 00:00:00" tariff="14" tariff-type="PP" person-
type="1" note="" passengers-count="1" />
Poznámka: jednoznačné ID e-shop transakce vygeneruje CC a vrátí ho v odpovědním XML
v atributu eshop-tr-id
24. Pořízení žádosti na dobití časového kupónu přes e-shop bank. převodem
<transaction tx-id="3" card-id="045056B26A1E80" appl-id="4609" when="2012-01-
06T13:28:31.000" type="pay" amount-type="card" transtype="eshop-c"
line="900250" sequence="11" amount="225" currency="CZK" vat="14" zone="21" valid-
from="2012-01-06 00:00:00" valid-to="2012-02-04 00:00:00" tariff="14" tariff-type="PP" person-
type="1" note="" passengers-count="1" />
Poznámka: jednoznačné ID e-shop transakce vygeneruje CC a vrátí ho v odpovědním XML
v atributu eshop-tr-id
25. Storno žádosti na dobití časového kupónu přes e-shop
<transaction tx-id="3" card-id="045056B26A1E80" appl-id="4609" when="2012-01-
06T13:28:31.000" type="dep" amount-type="card" transtype="cancel"
line="900250" sequence="11" amount="225" currency="CZK" vat="14" zone="21" valid-
from="2012-01-06 00:00:00" valid-to="2012-02-04 00:00:00" tariff="14" tariff-type="PP" person-
type="1" note="" eshop-tr-id=”100” reclamation=”0” />
26. Provedení fyzického dobití časového kupónu na základě transakce z green-listu
<transaction tx-id="3" card-id="045056B26A1E80" appl-id="4609" when="2012-01-
06T13:28:31.000" type="pay" amount-type="eshop" transtype="mhdp"
line="900250" sequence="11" amount="225" currency="CZK" vat="14" zone="21" valid-
from="2012-01-06 00:00:00" valid-to="2012-02-04 00:00:00" tariff="14" tariff-type="PP" person-
type="1" note="" eshop-tr-id=”100” />
27. Storno transakce speciálně pro ČD – jedná se o storno, při kterém je tx-id stejné jak pro
stornovanou tak pro stornující transakci. Musí však být dodrženo vyplnění transtype a
reclamation.
Transakce:
113
<transaction tx-id="122" card-id="048B53E23B2480" appl-id="4609" type="pay" amount-
type="cash" transtype="mhdp" when="2012-08-01 07:58:10" amount="495" zone="5;6"
tariff="14" tariff-type="PP" person-type="1" valid-from="2012-08-01 00:00:00" valid-to="2012-
08-30 23:59:59" note="" tranret="122" />
Storno transakce:
<transaction tx-id="122" card-id="048B53E23B2480" appl-id="4609" type="pay" amount-
type="cash" transtype="cancel" when="2012-08-01 07:58:10" amount="495" zone="5;6"
tariff="14" tariff-type="PP" person-type="1" valid-from="2012-08-01 00:00:00" valid-to="2012-
08-30 23:59:59" note="" tranret="-122" reclamation="122" />
114
28. Storno jednotlivého regionálního jízdného (papírová kilometrická jízdenka) na papír, platba
v hotovosti ve vozidle s provedením jízdy
Storno transakce poslední:
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1"
sumcount="1" vat="14" premise="1">
<transaction tx-id="122555" card-id="111111121" appl-id="4609" when="1.1.2012
13:59:00" type="dep" amount-type="cash" transtype="cancel" amount="60"
vat="14" line="900250" sequence="11" balance_after="300" balance_before="140"
note="reklamace jízdenky ve vozidle" currency="CZK" reclamation="0" />
</transactions>
Storno transakce dle reclamation čísla (prioritně ČD):
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1"
sumcount="1" vat="14" premise="1">
<transaction tx-id="122555" card-id="14" appl-id="4609" when="1.1.2012
13:59:00" type="dep" amount-type="cash" transtype="cancel" amount="60"
vat="14" line="900250" sequence="11" balance_after="300" balance_before="140"
note="reklamace jízdenky s časovým odstupem" currency="CZK"
reclamation="122554" />
</transactions>
29. Příklad multi-lístku (sloučení jednotlivé jízdenky s jízdenkou pro psa):
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1"
sumcount="1" vat="14" premise="1">
<transaction tx-id="1" card-id="045066662A80" appl-id="4609" when="2012-10-06
13:59:49" line="900250" sequence="11" type="pay" amount-type="ep"
transtype="mhd" base-rate="zs" amount="65" currency="CZK" vat=„14“
balance_before="500" balance_after="435" departure-id="130000" arrival-
id="365000" tariff-type="JD" tariff="1" person-type="99" note="" passengers-
count=2 />
</transactions>
30. Příklad multi-lístku (sloučení jednotlivé jízdenky pro dospělé 3 cestující 3x52 Kč):
<?xml version="1.0" encoding="UTF-8"?>
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1"
sumcount="1" vat="14" premise="1">
<transaction tx-id="1" card-id="045066662A80" appl-id="4609" when="2012-10-06
13:59:49" line="900250" sequence="11" type="pay" amount-type="ep"
transtype="mhd" base-rate="zs" amount="156" currency="CZK" vat=„14“
balance_before="1010" balance_after="854" departure-id="130000" arrival-
id="365000" tariff-type="JD" tariff="1" person-type="99" note="" passengers-
count=3 />
</transactions>
115
31. Příklad zaslání nedokončené transakce (EM-test)
<transaction tx-id="6" when="2012-01-06T13:59:49.000" type="pay" amount-type="cash"
transtype="incomplete" amount="0" />
32. Příklad zaslání transakce „devcounter“
<transaction transtype="uni" amount-type="cash" amount="0" when="2015-01-09 05:02:51"
type="devcounter" tx-id="1"/>
33. Prodej jízdenky Check-in, platba z EP v případě kde cestující hlásí dopředu výstupní
zastávku
<transaction tx-id="6" card-id="04105DEA052280" appl-id="4609" when="2012-01-
06T13:59:49.000" line="900250" sequence="11" type="pay" amount-type="ep" transtype="mhd"
base-rate="zs" amount="20" currency="CZK" vat="14" balance_before="700"
balance_after="680" departure-id="130000" tariff-type="JD" tariff="4" person-type="1" note=""
departure-zone=“5“ zones=“5;6;7“ arrival-zone=“6“ arrival-id=“140000“ />
34. Prodej jízdenky Check-in, platba z EP v případě kde cestující nehlásí dopředu výstupní
zastávku
<transaction tx-id="6" card-id="04105DEA052280" appl-id="4609" when="2012-01-
06T13:59:49.000" line="900250" sequence="11" type="pay" amount-type="ep" transtype="mhd"
base-rate="zs" amount="20" currency="CZK" vat="14" balance_before="700"
balance_after="680" departure-id="130000" tariff-type="JD" tariff="4" person-type="1" note=""
departure-zone=“5“ zones=“5;6;7“ arrival-zone=“7“ arrival-id=“141000“ />
35. Prodej jízdenky Check-out, vrácení na EP
<transaction tx-id="7" card-id="04105DEA052280" appl-id="4609" when="2012-01-
06T14:09:49.000" line="900250" sequence="11" type="dep" amount-type="ep" transtype="mhd"
base-rate="zs" amount="10" currency="CZK" vat="14" balance_before="680"
balance_after="690" tariff-type="JD" tariff="4" person-type="1" note="" arrival-id=“140000“
arrival-zone=„6“ zones=“5;6;7“ />
36. Přiložení bankovní karty (tapnutí)
<transaction tx-id="7" when="2016-01-18T12:00:00.000" line="900250" sequence="11"
type="pay" amount-type="card" transtype="tap" amount="0" currency="CZK" vat="14" tariff-
type="JD" tariff="4" person-type="1"departure-id="130000" arrival-id="140000" zones="5;6;7"
card-emv-token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967"
card-emv-block-noticed="0" card-emv-taplist-number="12345" card-emv-vehicle-
number="1234"/>
37. Prodej dlouhodobého jízdného na bankovní kartu, placeno hotově (student 15-26, 90 denní, zóna
30)
<transaction transtype="mhdp" amount-type="cash" type="pay" amount="276.00" when="2015-11-
02T12:00:00" tx-id="1" person-type="3" tariff="17" tariff-type="JD" line="880000" sequence="1"
currency="CZK" zone="30" valid-from="2015-11-02T12:00:00" valid-to="2016-02-02T12:00:00" card-emv-
token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967" />
38. Prodej dlouhodobého jízdného na bankovní kartu, placeno bankovní kartou (student 15-26, 90
denní, zóna 30 + 45)
<transaction transtype="mhdp" amount-type="card" type="pay" amount="476.00" when="2015-11-
02T12:00:00" tx-id="1" person-type="3" tariff="17" tariff-type="JD" line="880000" sequence="1"
116
currency="CZK" zone="30;45" valid-from="2015-11-02T12:00:00" valid-to="2016-02-02T12:00:00" card-
emv-token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967" />
39. Jízda na dlouhodobý kupón zakoupený na bankovní kartu (student 15-26, 90 denní, zóna 30 + 45)
<transaction transtype="mhd" amount-type="prepaid" type="pay" amount="0.00" when="2015-11-
02T12:00:00" tx-id="1" person-type="3" tariff="17" tariff-type="PP" line="880000" sequence="1"
currency="CZK" zones="30;45" departure-id="130000" arrival-id="140000" transfer-time="2015-11-
02T12:45:00" card-emv-
token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967" />
40. Dobití EP z bankovní karty
<transaction tx-id="5" card-id="04105DEA052280" appl-id="34965" type="dep" when="2012-01-
06T13:50:00.000" amount-type="ep" transtype="uni" line="900250" sequence="11"
amount="700.0" currency="CZK" vat="0" balance_before="0" balance_after="700.0" note=""
card-emv-token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967"
/>
41. Převod GL kupónu, který nebyl fyzicky nahrán na kartu
<transaction reclamation="0" note="převod" eshop-tr-id="545" amount="112" when="2018-03-07
10:00:00" transtype="eshop-c" amount-type="move" type="pay" appl-id="4609" card-
id="041A4502EF2380" tx-id="6"/>
42. Převod GL EP, který nebyl fyzicky nahrán na kartu
<transaction reclamation="0" note="převod" eshop-tr-id="545" amount="200" when="2018-03-07
10:00:00" transtype="eshop-ep" amount-type="move" type="pay" appl-id="4609" card-
id="041A4502EF2380" tx-id="6"/>
43. Kontrola jednotlivého jízdného ve vlaku
<transaction tx-id="4" card-id="04105DEA052280" appl-id="4609" when="2012-01-
06T13:59:49.000" line="900250" sequence="11" type="pay" amount-type="prepaid"
transtype="mhd" base-rate="zs" amount="0" currency="CZK" vat=„14“ departure-id="130000"
arrival-id="365000" tariff-type="PP" tariff="1" person-type="1" note="kontrola" vat="0" />
44. Transakce dokupovaných jízdenek na BK v PAD přes standardní Sale v oblasti REGION a
MĚSTO (tyto transakce nejdou do zúčtování bankovních transakcí na konci dne). Příklad
multi-lístku na BK v oblasti REGION (sloučení jednotlivé jízdenky s jízdenkou pro psa)
<transaction tx-id="1" when="2012-10-06 13:59:49" line="900250" sequence="11" type="pay"
amount-type="card" transtype="mhd" base-rate="zs" amount="65" currency="CZK" vat=„14“
departure-id="130000" arrival-id="365000" tariff-type="JD" tariff="1" person-type="99" note=""
passengers-count ="2" />
117
45. Transakce dokupovaných jízdenek na BK v PAD přes standardní Sale v oblasti REGION a
MĚSTO (tyto transakce nejdou do zúčtování bankovních transakcí na konci dne). Příklad
multi-lístku na BK v oblasti REGION (sloučení jednotlivé jízdenky pro dospělé 3 cestující
3x52 Kč)
<transaction tx-id="1" when="2012-10-06 13:59:49" line="900250" sequence="11" type="pay"
amount-type="card" transtype="mhd" base-rate="zs" amount="156" currency="CZK" vat=„14“
departure-id="130000" arrival-id="365000" tariff-type="JD" tariff="1" person-type="99"
note="" passengers-count="3" />
46. Transakce dokupovaných jízdenek na BK v oblasti XXL (tyto transakce jdou do zúčtování
bankovních transakcí na konci dne a je nutné posílat jednu transakci za každou dokoupenou
jízdenku). Příklad dokoupení krátkodobé jízdenky pro dospělého na 45 minut z bankovní
karty (tapnutí)
<transaction tx-id="7" when="2016-01-18T12:00:00.000" line="900250" sequence="11"
type="pay" amount-type="card" transtype="tap" amount="20" currency="CZK" vat="14"
tariff-type="JD" tariff="19" person-type="1" departure-id="130000" arrival-id="140000"
zones="78" card-emv-
token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967" card-
emv-block-noticed="0" card-emv-taplist-number="12345" card-emv-vehicle-number="1234"/>
47. Transakce jednotlivých jízdenek na BK v oblasti REGION a MĚSTO (tyto transakce jdou
do zúčtování bankovních transakcí na konci dne a je nutné posílat jednu transakci za každou
jízdenku). Příklad jednotlivé jízdenky na BK v oblasti REGION (tapnutí - neposílat zóny)
<transaction tx-id="7" when="2016-01-18T12:00:00.000" line="900250" sequence="11"
type="pay" amount-type="card" transtype="tap" amount="10" currency="CZK" vat="14"
tariff-type="JD" tariff="1" person-type="1" departure-id="130000" arrival-id="140000" card-
emv-token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967"
card-emv-vehicle-number="1234"/>
48. Transakce jednotlivých jízdenek na BK v oblasti REGION a MĚSTO (tyto transakce jdou
do zúčtování bankovních transakcí na konci dne a je nutné posílat jednu transakci za každou
jízdenku). Příklad jednotlivé jízdenky na BK v oblasti MĚSTO (tapnutí - poslat jednu
městkou zónu 5 - Karviná, 45 - Český Těšín, 60 - Třinec, 70 - Nový Jičín, 90 - Krnov a 100
- Bruntál)
<transaction tx-id="7" when="2016-01-18T12:00:00.000" line="900250" sequence="11"
type="pay" amount-type="card" transtype="tap" amount="10" currency="CZK" vat="14"
tariff-type="JD" tariff="1" person-type="1" departure-id="130000" arrival-id="140000"
zones="5" card-emv-
token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967" card-
emv-vehicle-number="1234"/>
49. Transakce dokupovaných jízdenek na BK v PAD přes standardní Sale v oblasti XXL (tyto
transakce nejdou do zúčtování bankovních transakcí na konci dne a je nutné posílat jednu
transakci za každou dokoupenou jízdenku). Příklad dokoupení krátkodobé jízdenky pro
dospělého na 45 minut z bankovní karty
<transaction transtype="mhdp" amount-type="card" type="pay" amount="20.00" when="2015-
11-01T12:00:00" tx-id="10001" person-type="1" tariff="19" tariff-type="JD" line="880000"
118
sequence="1" currency="CZK" departure-id="130000" zone="78" valid-from="2015-11-
01T12:00:00" valid-to="2015-11-01T12:45:00"/>
50. Nákup kupónu na ODIS kartu s dřívejším koncem platnosti zákaznického profilu, než konec
platnosti kupónu
<transaction tx-id="1873" card-id="047734FA9F5680" appl-id="34965" type="pay"
when="2018-07-24 15:00:48" amount-type="cash" transtype="mhdp" amount="566.00"
currency="CZK" vat="15" person-type="3" tariff="14" tariff-type="PP" zone="40;78" valid-
from="2018-07-24 00:00:00" valid-to="2018-08-22 23:59:59" line="874999" cp-date-
to="2018-08-10 23:59:59" />
51. Nákup jednodenní oblastní jízdenky - JESENÍKY pro jednu osobu na papír, placeno hotově
(dospělý 15+, 1 denní, zóny 100 + 101)
<transaction transtype="mhdp" amount-type="cash" type="pay" amount="100.00"
when="2019-08-02T12:00:00" tx-id="20006" person-type="1" tariff="8" tariff-type="JD"
line="880000" sequence="1" departure-id="130000" arrival-id="365000" currency="CZK"
zone="100;101" valid-from="2019-08-02T00:00:00" valid-to="2019-08-02T23:59:59"
passengers-count="1" />
52. Nákup jednodenní oblastní jízdenky - JESENÍKY skupinové na papír, placeno hotově
(dospělý 15+, 1 denní, zóny 100 + 101)
<transaction transtype="mhdp" amount-type="cash" type="pay" amount="250.00"
when="2019-08-02T12:00:00" tx-id="20006" person-type="1" tariff="8" tariff-type="JD"
line="880000" sequence="1" departure-id="130000" arrival-id="365000" currency="CZK"
zone="100;101" valid-from="2019-08-02T00:00:00" valid-to="2019-08-02T23:59:59"
passengers-count="5" />
53. Elektronické jízdné přestupní, placeno Ultralight kartou (20Kč)
<transaction transtype="ultralight" amount-type="ultralight" type="pay" amount="20.00"
when="2015-11-01T12:00:00" tx-id="10001" person-type="1" tariff="1" tariff-type="JD"
sequence="1" line="900000" currency="CZK" base-rate="zs" departure-id="130000"
departure-zone="78" card-uid="04044CE2052280" balance_before="200" balance_after="180"
zones="78" arrival-id="140000" arrival-zone="78" card-taplist-number="12345" card-vehicle-
number="1234" />
54. Jízda na zakoupené dlouhodobé jízdné Ultralight kartou (vozidlo projíždí zónami 1, 2, 3 –
zakoupené dlouhodobé jízdné platí pro zóny 1, 4)
<transaction transtype="ultralight" amount-type="prepaid" type="pay" amount="0.00"
when="2015-11- 02T15:00:00" tx-id="30001" person-type="1" tariff="14" tariff-type="PP"
sequence="1" line="910112" currency="CZK" zones="1" card-uid="04064E3A913480"
departure-id="130000" arrival-id="140000" />
55. Transakce dokupovaných jízdenek na Ultralight kartu v oblasti XXL (je nutné posílat jednu
transakci za každou dokoupenou jízdenku). Příklad dokoupení krátkodobé jízdenky pro
dospělého na 45 minut.
<transaction tx-id="7" when="2016-01-18T12:00:00.000" line="900250" sequence="11"
type="pay" amount-type="ultralight" transtype="ultralight" amount="20" currency="CZK"
119
vat="14" tariff-type="JD" tariff="19" person-type="1" departure-id="130000" arrival-
id="140000" zones="78" card-uid="04064E3A913480" />
56. Prodej krátkodobého jízdného na Ultralight kartu v oblasti XXL, 3 dny obyčejná (220 Kč).
<transaction tx-id="7" when="2016-01-18T12:00:00.000" line="900250" sequence="11"
type="pay" amount-type="ultralight" transtype="ultralight" amount="220" currency="CZK"
vat="14" tariff-type="JD" tariff="9" person-type="1" departure-id="130000" arrival-
id="140000" zone="78" card-uid="04064E3A913480" valid-from="2016-01-18T12:00:00"
valid-to="2016-01-21T12:00:00"/>
57. Storno transakce jednotlivých jízdenek na BK v oblasti REGION a MĚSTO (tyto transakce
jdou do zúčtování bankovních transakcí na konci dne a je nutné posílat jednu transakci za
každou jízdenku). Příklad jednotlivé jízdenky na BK v oblasti REGION (tapnutí - neposílat
zóny)
<transaction tx-id="7" when="2016-01-18T12:00:00.000" line="900250" sequence="11"
type="pay" amount-type="card" transtype="cancel" amount="10" currency="CZK" vat="14"
tariff-type="JD" tariff="1" person-type="1" departure-id="130000" arrival-id="140000" card-
emv-token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967"
card-emv-vehicle-number="1234"/>
58. Storno transakce jednotlivých jízdenek na BK v oblasti REGION a MĚSTO (tyto transakce
jdou do zúčtování bankovních transakcí na konci dne a je nutné posílat jednu transakci za
každou jízdenku). Příklad jednotlivé jízdenky na BK v oblasti MĚSTO (tapnutí - poslat
jednu městkou zónu 5 - Karviná, 45 - Český Těšín, 60 - Třinec, 70 - Nový Jičín, 90 - Krnov
a 100 - Bruntál)
<transaction tx-id="7" when="2016-01-18T12:00:00.000" line="900250" sequence="11"
type="pay" amount-type="card" transtype="cancel" amount="10" currency="CZK" vat="14"
tariff-type="JD" tariff="1" person-type="1" departure-id="130000" arrival-id="140000"
zones="5" card-emv-
token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967" card-
emv-vehicle-number="1234"/>
59. Check-out transakce na Ultralight kartu
<transaction transtype="ultralight" amount-type="ultralight" type="dep" amount="6.00"
when="2015-11-01T12:05:00" tx-id="10002" person-type="1" tariff="1" tariff-type="JD"
sequence="1" line="900000" currency="CZK" base-rate="0" arrival-id="140000" arrival-
zone="78" card-uid="04044CE2052280" appl-id="0" balance_before="0" balance_after="6"
zones="78" card-taplist-number="12345" card-vehicle-number="1234" />
60. Dobití EP – koordinátor KOVED
<transaction tx-id="5" card-id="04105DEA052280" appl-id="34965" type="dep" when="2012-01-
06T13:50:00.000" amount-type="ep" transtype="uni" line="900250" sequence="11"
amount="700.0" currency="CZK" vat="0" balance_before="0" balance_after="700.0" note=""
clearing-id="koved" />
120
61. Nákup kilometrického jízdného na EP - koordinátor KOVED
<transaction transtype="mhd" amount-type="ep" type="pay" amount="29.00" when="2015-11-
04T06:30:00" tx-id="10001" person-type="1" tariff="1" tariff-type="JD" sequence="9"
line="900231" currency="CZK" base-rate="zs" departure-id="39699" arrival-id="7972" card-
id="04064E3A913480" appl-id="008895" balance_before="100.00" balance_after="71.00"
clearing-id="koved" />
62. Reklamační vybití EP (kontaktní místo KODIS)
<transaction tx-id="6" card-id="04105DEA052280" appl-id="34965" when="2020-01-
06T13:59:49.000" line="900250" sequence="1" type="pay" amount-type="ep"
transtype="reclamation" amount="20" currency="CZK" balance_before="100" balance_after="80"
note="reklamační vybití EP na KM" />
63. Reklamační dobití EP (kontaktní místo KODIS)
<transaction tx-id="5" card-id="04105DEA052280" appl-id="34965" when="2020-01-
06T13:50:00.000" line="900250" sequence="1" type="dep" amount-type="ep"
transtype="reclamation" amount="20.0" currency="CZK" balance_before="100"
balance_after="120" note="reklamační dobití EP na KM " />
64. Nákup mobilní jízdenky (kombinace dvou jízd)
<transaction vat="15" base-rate="zs" person-type="1" tariff="1" tariff-type="JD" arrival-zone="78"
arrival-id="51259" zones="78" departure-zone="78" departure-id="57258" currency="CZK"
amount="16" transtype="mhd" amount-type="mobile-app" type="pay" sequence="43" line="6"
when="2019-12-19 09:00:00" multi-sum="2" multi-index="1" tx-id="1" fare-id="100" valid-
from="2019-12-19 09:00:00" valid-to="2019-12-20 09:00:00" />
<transaction vat="15" base-rate="zs" person-type="1" tariff="1" tariff-type="JD" arrival-zone="59"
arrival-id="7820" departure-zone="78" departure-id="25468" currency="CZK" amount="51"
transtype="mhd" amount-type="mobile-app" type="pay" sequence="17" line="863980"
when="2019-12-19 09:00:00" multi-sum="2" multi-index="2" tx-id="1" fare-id="100" valid-
from="2019-12-19 09:00:00" valid-to="2019-12-20 09:00:00" />
65. Jízda na mobilní jízdenku (kombinace dvou jízd)
<transaction vat="15" base-rate="zs" person-type="1" tariff="1" tariff-type="JD" arrival-zone="78"
arrival-id="51259" zones="78" departure-zone="78" departure-id="57258" currency="CZK"
amount="0" transtype="mhd" amount-type="prepaid" type="pay" sequence="43" line="6"
when="2019-12-19 09:00:00" multi-sum="2" multi-index="1" tx-id="1" fare-id="100" />
<transaction vat="15" base-rate="zs" person-type="1" tariff="1" tariff-type="JD" arrival-zone="59"
arrival-id="7820" departure-zone="78" departure-id="25468" currency="CZK" amount="0"
transtype="mhd" amount-type="prepaid" type="pay" sequence="17" line="863980" when="2019-
12-19 09:00:00" multi-sum="2" multi-index="2" tx-id="1" fare-id="100" />
Pozn.: Pro relační jízdenku se neplní arrival-zone, zones a departure-zone. Plní se pouze arrival-id a
departure-id. Pro časovou zónovou jízdenku se neplní arrival-zone, arrival-id, departure-zone a
departure-id. Plní se pouze zones. Cena jízdenky je 0 – není známa.
121
66. Neplatná jízda na mobilní jízdenku (kombinace dvou jízd)
<transaction vat="15" base-rate="zs" person-type="1" tariff="1" tariff-type="JD" arrival-zone="78"
arrival-id="51259" zones="78" departure-zone="78" departure-id="57258" currency="CZK"
amount="0" transtype="mhd" amount-type="prepaid" type="pay" sequence="43" line="6"
when="2019-12-19 09:00:00" multi-sum="2" multi-index="1" tx-id="1" fare-id="100"
reclamation="0" />
<transaction vat="15" base-rate="zs" person-type="1" tariff="1" tariff-type="JD" arrival-zone="59"
arrival-id="7820" departure-zone="78" departure-id="25468" currency="CZK" amount="0"
transtype="mhd" amount-type="prepaid" type="pay" sequence="17" line="863980" when="2019-
12-19 09:00:00" multi-sum="2" multi-index="2" tx-id="1" fare-id="100" reclamation="0" />
Pozn.: Pro relační jízdenku se neplní arrival-zone, zones a departure-zone. Plní se pouze arrival-id a
departure-id. Pro časovou zónovou jízdenku se neplní arrival-zone, arrival-id, departure-zone a
departure-id. Plní se pouze zones. Cena jízdenky je 0 – není známa.
67. Prodej krátkodobého jízdného na Ultralight kartu v oblasti XXL, 24 hodinová (100 Kč).
<transaction tx-id="7" when="2016-01-18T12:00:00.000" line="900250" sequence="11"
type="pay" amount-type="ultralight" transtype="ultralight" amount="100" currency="CZK"
vat="14" tariff-type="JD" tariff="7" person-type="1" departure-id="130000" arrival-id="140000"
zone="78" card-uid="04064E3A913480" valid-from="2016-01-18T12:00:00" valid-to="2016-01-
19T12:00:00"/>
68. Transakce dokupovaných jízdenek na Ultralight kartu v oblasti XXL (je nutné posílat jednu
transakci za každou dokoupenou jízdenku). Příklad dokoupení krátkodobé jízdenky pro
dospělého na 24 hodin.
<transaction tx-id="7" when="2016-01-18T12:00:00.000" line="900250" sequence="11"
type="pay" amount-type="ultralight" transtype="ultralight" amount="100" currency="CZK"
vat="14" tariff-type="JD" tariff="7" person-type="1" departure-id="130000" arrival-id="140000"
zones="78" card-uid="04064E3A913480" />
122
Příklady užití – rozšíření
Dlouhodobé jízdné
Pro dlouhodobé jízdné platí pravidla:
• tarif 1, 7, 30, 90, 180, 365 denní
• tarif 5 měsíční
Příklady transakcí dlouhodobého jízdného:
1. Prodej dlouhodobého jízdného na papír, placeno hotově (student 15-26, 90 denní, zóny 30 + 94 +
100 + 101)
<transaction transtype="mhdp" amount-type="cash" type="pay" amount="2276.00" when="2015-
11-02T12:00:00" tx-id="20006" person-type="3" tariff="17" tariff-type="JD" line="880000"
sequence="1" currency="CZK" zone="30;94;100;101 " valid-from="2015-11-02T12:00:00" valid-
to="2016-02-02T12:00:00" />
2. Prodej dlouhodobého jízdného na EP, platba hotově (přenosný, 7 denní, zóny 1 + 2 + 3 + 12 + 15)
<transaction transtype="mhdp" amount-type="cash" type="pay" amount="473.00" when="2015-
11-02T12:00:00" tx-id="20007" person-type="63" tariff="12" tariff-type="JD" sequence="1"
line="915000" currency="CZK" zone="1;2;3;12;15" valid-from="2015-11-02T12:00:00" valid-
to="2015-11-09T12:00:00" card-id="04044302AB3780" appl-id="34965" />
3. Jízda na zakoupené dlouhodobé jízdné (vozidlo projíždí zónami 1, 4, 12, 15, 17 – zakoupené
dlouhodobé jízdné platí pro zóny 1, 2, 3, 12, 15)
<transaction transtype="mhd" amount-type="prepaid" type="pay" amount="0.00" when="2015-11-
02T15:00:00" tx-id="30008" person-type="63" tariff="12" tariff-type="PP" sequence="1"
line="915123" currency="CZK" zones="1;12;15" card-id="04044302AB3780" appl-id="4609"
departure-id="130000" arrival-id="140000" />
4. Prodej dlouhodobého jízdného na EP, platba z EP (dospělý 15+, 30 denní, zóny 1 + 4)
<transaction transtype="mhdp" amount-type="ep" type="pay" amount="495.00" when="2015-11-
02T12:00:00" tx-id="20008" person-type="1" tariff="14" tariff-type="JD" sequence="1"
line="910000" currency="CZK" balance_before="495.00" balance_after="0.00" zone="1;2;3;4"
valid-from="2015-11-02T12:00:00" valid-to="2015-12-02T12:00:00" card-id="04064E3A913480"
appl-id="34965" />
5. Jízda na zakoupené dlouhodobé jízdné (vozidlo projíždí zónami 1, 2, 3 – zakoupené dlouhodobé
jízdné platí pro zóny 1, 4)
<transaction transtype="mhd" amount-type="prepaid" type="pay" amount="0.00" when="2015-11-
02T15:00:00" tx-id="30001" person-type="1" tariff="14" tariff-type="PP" sequence="1"
line="910112" currency="CZK" zones="1" card-id="04064E3A913480" appl-id="4609" departure-
id="130000" arrival-id="140000" />
123
Krátkodobé jízdné
Pro krátkodobé jízdné platí pravidla:
• prodej v zóně 354 (Ostrava XXL) a 352 (celá síť)
• tarif 10, 30, 45, 60, 90 minutová
• tarif 24 hodinová a 24 hodinová skupinová
• tarif 70 minutová SMS, 90 minutová SMS, 24 hodinová SMS
Pozn.: od 2. 7. 2017 změna zóny 354 na 78
Příklady transakcí krátkodobého jízdného:
1. Prodej krátkodobého jízdného na papír, placeno hotově, 10 minutová žákovská (5 Kč)
<transaction transtype="mhdp" amount-type="cash" type="pay" amount="5.00" when="2015-11-
01T12:00:00" tx-id="10001" person-type="19" tariff="3" tariff-type="JD" line="880000"
sequence="1" currency="CZK" departure-id="130000" zone="354" valid-from="2015-11-
01T12:00:00" valid-to="2015-11-01T12:10:00" />
2. Prodej krátkodobého jízdného na papír, placeno hotově, 24 hodinová skupinová (200 Kč)
<transaction transtype="mhdp" amount-type="cash" type="pay" amount="200.00" when="2015-
11-01T12:00:00" tx-id="10001" person-type="1" tariff="5" tariff-type="JD" sequence="1"
line="999000" currency="CZK" departure-id="130000" zone="354" valid-from="2015-11-
01T12:00:00" valid-to="2015-11-02T12:00:00" />
3. Prodej krátkodobého jízdného na papír, placeno hotově, 60 minutová obyčejná (26 Kč)
<transaction transtype="mhdp" amount-type="cash" type="pay" amount="26.00" when="2015-11-
01T12:00:00" tx-id="10002" person-type="1" tariff="4" tariff-type="JD" sequence="1"
line="999000" currency="CZK" departure-id="130000" zone="354" valid-from="2015-11-
01T12:00:00" valid-to="2015-11-01T13:00:00" />
4. Prodej krátkodobého jízdného na papír, placeno hotově, 24 hodinová celosíťová obyčejná (200 Kč)
<transaction transtype="mhdp" amount-type="cash" type="pay" amount="200.00" when="2017-
01-01T12:00:00" tx-id="10002" person-type="1" tariff="7" tariff-type="JD" sequence="1"
line="999000" currency="CZK" departure-id="130000" zone="352" valid-from="2017-01-
01T12:00:00" valid-to="2017-01-02T12:00:00" />
124
Jednotlivé jízdné
Pro jednotlivé jízdné platí pravidla:
• hodnota atributu „tariff“ bude „1“ (viz číselník tarifů)
• jízda v městských zónách – 5, 45, 60, 90, 100
• jízda v Ostrava XXL zóně – 354 (přestupní a nepřestupní elektronické jízdné)
Pozn.: od 2. 7. 2017 změna zóny 354 na 78
Příklady transakcí jednotlivého jízdného:
1. Papírová obyčejná, město Bruntál
<transaction transtype="mhd" amount-type="cash" type="pay" amount="9.00" when="2015-11-
03T12:00:00" tx-id="10001" person-type="1" tariff="1" tariff-type="JD" sequence="1"
line="850000" currency="CZK" base-rate="zs" departure-id="130000" zones="100" arrival-
id="140000" />
2. Na ODIS kartu obyčejná, město Český Těšín (použité linky 875000 a 866000)
<transaction transtype="mhd" amount-type="ep" type="pay" amount="9.00" when="2015-11-
03T12:00:00" tx-id="10002" person-type="1" tariff="1" tariff-type="JD" sequence="1"
line="875000" currency="CZK" base-rate="zs" departure-id="130000" zones="45" arrival-
id="140000" card-id="04084E3A913480" appl-id="008895" balance_before="9.00"
balance_after="0.00" valid-from="2015-11-03T12:00:00" valid-to="2015-11-03T12:30:00" />
<transaction transtype="mhd" amount-type="prepaid" type="pay" amount="0.00" when="2015-11-
03T12:00:00" tx-id="10003" person-type="1" tariff="1" tariff-type="JD" sequence="1"
line="866000" currency="CZK" base-rate="0" departure-id="130000" zones="60" arrival-
id="140000" card-id="04084E3A913480" appl-id="008895" valid-from="2015-11-03T12:00:00"
valid-to="2015-11-03T12:30:00" />
3. Elektronické jízdné přestupní mezi linkami 915000 a 910000 (20 Kč)
<transaction transtype="mhd" amount-type="ep" type="pay" amount="20.00" when="2015-11-
01T12:00:00" tx-id="10005" person-type="1" tariff="1" tariff-type="JD" sequence="1"
line="915000" currency="CZK" base-rate="zs" departure-id="130000" departure-zone="354" card-
id="04044302AB3780" appl-id="34965" balance_before="20" balance_after="0" zones="354"
arrival-id="140000" arrival-zones="354" />
<transaction transtype="mhd" amount-type="prepaid" type="pay" amount="0.00" when="2015-11-
01T12:11:00" tx-id="10002" person-type="1" tariff="1" tariff-type="PP" sequence="1"
line="910000" currency="CZK" base-rate="0" departure-id="130000" departure-zone="354" card-
id="04044302AB3780" appl-id="34965" zones="354" />
4. Elektronické jízdné nepřestupní zasílané ve dvou transakcích (14Kč)
<transaction transtype="mhd" amount-type="ep" type="pay" amount="20.00" when="2015-11-
01T12:00:00" tx-id="10001" person-type="1" tariff="1" tariff-type="JD" sequence="1"
line="900000" currency="CZK" base-rate="zs" departure-id="130000" departure-zone="354" card-
id="04044CE2052280" appl-id="0" balance_before="20" balance_after="0" zones="354" arrival-
id="140000" arrival-zone="354" />
<transaction transtype="mhd" amount-type="ep" type="dep" amount="6.00" when="2015-11-
01T12:05:00" tx-id="10002" person-type="1" tariff="1" tariff-type="JD" sequence="1"
125
line="900000" currency="CZK" base-rate="0" arrival-id="140000" arrival-zone="354" card-
id="04044CE2052280" appl-id="0" balance_before="0" balance_after="6" zones="354" />
5. Elektronické jízdné nepřestupní zasílané v jedné transakci (14Kč)
<transaction transtype="mhd" amount-type="ep" type="pay" amount="14.00" when="2015-11-
01T12:00:00" tx-id="10001" person-type="1" tariff="1" tariff-type="NP" sequence="1"
line="900000" currency="CZK" base-rate="zs" departure-id="130000" departure-zone="354" card-
id="04044CE2052280" appl-id="0" balance_before="14" balance_after="0" zones="354" arrival-
id="140000" arrival-zone="354" />
126
Kilometrické jízdné
Pro kilometrické jízdné platí pravidla:
• hodnota atributu „tariff“ bude „1“ (viz číselník tarifů)
• bez zóny
Příklady transakcí kilometrického jízdného:
1. Cestující jede linkou 900231 z Vítkov, aut.st. na zastávku Fulnek, žel.st. spojem 9 (na místě je 7:00),
tam přestoupí na spoj 12 linky 880613 (odjezd z Fulnek, žel.st. 7:03) a vystoupí na zastávce
Studénka, žel. st. Cena s ODISKOU 46 Kč (v prvním spoji zaplatí 29Kč, v druhém 17Kč).
<transaction transtype="mhd" amount-type="ep" type="pay" amount="29.00" when="2015-11-
04T06:30:00" tx-id="10001" person-type="1" tariff="1" tariff-type="JD" sequence="9"
line="900231" currency="CZK" base-rate="zs" departure-id="39699" arrival-id="7972" card-
id="04064E3A913480" appl-id="008895" balance_before="100.00" balance_after="71.00" />
<transaction transtype="mhd" amount-type="ep" type="pay" amount="17.00" when="2015-11-
04T07:03:00" tx-id="10002" person-type="1" tariff="1" tariff-type="JD" sequence="12"
line="880613" currency="CZK" base-rate="0" departure-id="7972" arrival-id="33798" card-
id="04064E3A913480" appl-id="008895" balance_before="71.00" balance_after="54.00" />
2. Cestující jede z Třince, aut.st. do Těšína,aut.st. linkou 861761. Bez ODISky 20 Kč spojem 27.
<transaction transtype="mhd" amount-type="cash" type="pay" amount="20.00" when="2015-11-
04T12:00:00" tx-id="10004" person-type="1" tariff="1" tariff-type="JD" sequence="27"
line="861761" currency="CZK" base-rate="zs" departure-id="36872" arrival-id="5009" />
3. Cestující jede bez ODISky spojem 7 linky 860765 ze zastávky Třinec, aut.st. na zastávku Frýdek-
Místek, Frýdek, aut. nádr. je tam 6:19 a přestoupí v 6:30 na spoj 2 linky 880621 a vystoupí na
zastávce Nový Jičín, aut. nádr. cena 84 Kč (v prvním spoji zaplatí 41 kč, v druhém 43 Kč).
<transaction transtype="mhd" amount-type="cash" type="pay" amount="41.00" when="2015-11-
04T06:01:00" tx-id="10005" person-type="1" tariff="1" tariff-type="JD" sequence="7"
line="861765" currency="CZK" base-rate="zs" departure-id="36872" arrival-id="54473" />
<transaction transtype="mhd" amount-type="cash" type="pay" amount="43.00" when="2015-11-
04T06:30:00" tx-id="10006" person-type="1" tariff="1" tariff-type="JD" sequence="2"
line="880621" currency="CZK" base-rate="zs" departure-id="54473" arrival-id="24128" />
127
Příklady užití pro mobilní aplikaci
Příklady této kapitoly popisují stav k 26.5.2020 dle souboru MSK_008_struktura_tarifu_kraj
k_1_1_2020.xls, další změny budou pouze v případném následujícím souboru vydaném KODISem
MSK_008_struktura_tarifu_kraj k_x_x_xxxx.xls.
1. celý kraj (zóna 352)
Příklad pro 24 hodin ODIS, obyčejné celosíťové
<transaction vat="10" base-rate="zs" person-type="1" tariff="7" tariff-type="JD" zone="352"
currency="CZK" amount="200" transtype="mhdp" amount-type="mobile-app" type="pay"
when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19 09:00:00" valid-
to="2019-12-20 09:00:00" />
Přehled kombinací, které je možno uplatnit pro nákup jízdenky:
24 hodin ODIS Název Cena CP TP
24 hodin ODIS amount person-type tariff
24 hodin ODIS obyčejné celosíťové 200 1 7
24 hodin ODIS zlevněné celosíťové 100 2 7
24 hodin ODIS student 200 3 7
24 hodin ODIS důchodce 200 4 7
24 hodin ODIS důchodce invalidní 200 5 7
24 hodin ODIS občan 65+ 200 50 7
24 hodin ODIS občan nad 70 let 200 51 7
zvíře 100 17 7
zavazadlo 100 18 7
2. Ostrava XXL (zóna 78)
Příklad pro 10 minut, obyčejné
<transaction vat="10" base-rate="zs" person-type="1" tariff="3" tariff-type="JD" zone="78"
currency="CZK" amount="16" transtype="mhdp" amount-type="mobile-app" type="pay"
when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19 09:00:00" valid-
to="2019-12-19 09:10:00" />
Přehled kombinací, které je možno uplatnit pro nákup jízdenky:
Název Cena CP TP
amount person-type tariff
10 minut obyčejné 16 1 3
45 minut obyčejné 24 1 19
24 hodin obyčejné 100 1 7
24 hodin skupinové obyčejné 200 1 5
3 dny obyčejné 220 1 9
7 dnů obyčejné 352 1 12
10 minut zlevněné 8 2 3
45 minut zlevněné 12 2 19
24 hodin zlevněné 50 2 7
128
24 hodin skupinové zlevněné 200 2 5
3 dny zlevněné 110 2 9
7 dnů zlevněné 176 2 12
10 minut student 16 3 3
45 minut student 24 3 19
24 hodin student 100 3 7
24 hodin skupinové student 200 3 5
3 dny student 220 3 9
10 minut důchoce 16 4 3
45 minut důchoce 24 4 19
24 hodin důchoce 100 4 7
24 hodin skupinové důchoce 200 4 5
3 dny důchoce 220 4 9
10 minut důchoce invalidní 16 5 3
45 minut důchoce invalidní 24 5 19
24 hodin důchoce invalidní 100 5 7
24 hodin skupinové důchoce invalidní 200 5 5
3 dny důchoce invalidní 220 5 9
10 minut občan 65+ 16 50 3
45 minut občan 65+ 24 50 19
24 hodin občan 65+ 100 50 7
24 hodin skupinové občan 65+ 200 50 5
3 dny občan 65+ 220 50 9
10 minut občan nad 70 let 16 51 3
45 minut občan nad 70 let 24 51 19
24 hodin občan nad 70 let 100 51 7
24 hodin skupinové občan nad 70 let 200 51 5
3 dny občan nad 70 let 220 51 9
10 minut zvíře 8 17 3
45 minut zvíře 12 17 19
24 hodin zvíře 50 17 7
3 dny zvíře 110 17 9
7 dnů zvíře 176 17 12
45 minut zavazadlo 12 18 19
24 hodin zavazadlo 50 18 7
3 dny zavazadlo 110 18 9
7 dnů zavazadlo 176 18 12
7 dnů anonym přenosný 352 63 12
3. Český Těšín (zóna 45)
Příklad pro 45 minut, obyčejné
<transaction vat="10" base-rate="zs" person-type="1" tariff="19" tariff-type="JD" zone="45"
currency="CZK" amount="9" transtype="mhdp" amount-type="mobile-app" type="pay"
when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19 09:00:00" valid-
to="2019-12-19 09:45:00" />
Přehled kombinací, které je možno uplatnit pro nákup jízdenky:
129
45 minut Název Cena CP TP
45 minut amount person-type tariff
45 minut obyčejné 9 1 19
45 minut zlevněné 4 2 19
45 minut student 9 3 19
45 minut důchodce 9 4 19
45 minut důchodce invalidní 9 5 19
45 minut občan 65+ 9 50 19
45 minut občan nad 70 let 9 51 19
zvíře 4 17 19
zavazadlo 4 18 19
4. Třinec (zóna 60)
Příklad pro 45 minut, zlevněné
<transaction vat="10" base-rate="zs" person-type="2" tariff="19" tariff-type="JD" zone="60"
currency="CZK" amount="4" transtype="mhdp" amount-type="mobile-app" type="pay"
when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19 09:00:00" valid-
to="2019-12-19 09:45:00" />
Přehled kombinací, které je možno uplatnit pro nákup jízdenky:
45 minut Název Cena CP TP
45 minut amount person-type tariff
45 minut obyčejné 9 1 19
45 minut zlevněné 4 2 19
45 minut student 9 3 19
45 minut důchodce 9 4 19
45 minut důchodce invalidní 9 5 19
45 minut občan 65+ 9 50 19
45 minut občan nad 70 let 9 51 19
zvíře 4 17 19
zavazadlo 4 18 19
5. Frýdek-Místek (zóna 511)
Příklad pro 45 minut, obyčejné
<transaction vat="10" base-rate="zs" person-type="1" tariff="19" tariff-type="JD" zone="511"
currency="CZK" amount="9" transtype="mhdp" amount-type="mobile-app" type="pay"
when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19 09:00:00" valid-
to="2019-12-19 09:45:00" />
Přehled kombinací, které je možno uplatnit pro nákup jízdenky:
Název Cena CP TP
amount person-type tariff
45 minut obyčejné 9 1 19
45 minut zlevněné 4 2 19
45 minut student 9 3 19
130
45 minut důchodce 9 4 19
45 minut důchodce invalidní 9 5 19
45 minut občan 65+ 9 50 19
45 minut občan nad 70 let 9 51 19
45 minut zvíře 4 17 19
45 minut zavazadlo 4 18 19
6. Karviná (zóna 5)
Příklad pro 45 minut, obyčejné
<transaction vat="10" base-rate="zs" person-type="1" tariff="19" tariff-type="JD" zone="5"
currency="CZK" amount="10" transtype="mhdp" amount-type="mobile-app" type="pay"
when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19 09:00:00" valid-
to="2019-12-19 09:45:00" />
Přehled kombinací, které je možno uplatnit pro nákup jízdenky:
45 minut Název Cena CP TP
45 minut amount person-type tariff
45 minut obyčejné 10 1 19
45 minut zlevněné 5 2 19
45 minut student 10 3 19
45 minut důchodce 10 4 19
45 minut důchodce invalidní 10 5 19
45 minut občan 65+ 10 50 19
45 minut občan nad 70 let 10 51 19
zvíře 5 17 19
zavazadlo 5 18 19
7. Orlová (zóna 150)
Příklad pro 45 minut, zlevněné
<transaction vat="10" base-rate="zs" person-type="2" tariff="19" tariff-type="JD" zone="150"
currency="CZK" amount="4" transtype="mhdp" amount-type="mobile-app" type="pay"
when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19 09:00:00" valid-
to="2019-12-19 09:45:00" />
Přehled kombinací, které je možno uplatnit pro nákup jízdenky:
45 minut Název Cena CP TP
45 minut amount person-type tariff
45 minut obyčejné 9 1 19
45 minut zlevněné 4 2 19
45 minut student 9 3 19
45 minut důchodce 9 4 19
45 minut důchodce invalidní 9 5 19
45 minut občan 65+ 9 50 19
občan nad 70 let 9 51 19
zvíře 4 17 19
131
45 minut zavazadlo 4 18 19
8. Bruntál (zóna 100)
Příklad pro 45 minut, obyčejné
<transaction vat="10" base-rate="zs" person-type="1" tariff="19" tariff-type="JD" zone="100"
currency="CZK" amount="9" transtype="mhdp" amount-type="mobile-app" type="pay"
when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19 09:00:00" valid-
to="2019-12-19 09:45:00" />
Přehled kombinací, které je možno uplatnit pro nákup jízdenky:
45 minut Název Cena CP TP
45 minut amount person-type tariff
45 minut obyčejné 9 1 19
45 minut zlevněné 4 2 19
45 minut student 4 3 19
45 minut důchodce 9 4 19
45 minut důchodce invalidní 9 5 19
45 minut občan 65+ 9 50 19
45 minut občan nad 70 let 9 51 19
zvíře 4 17 19
zavazadlo 4 18 19
9. Nový Jičín (zóna 70)
Příklad pro 45 minut, zvíře
<transaction vat="10" base-rate="zs" person-type="17" tariff="19" tariff-type="JD" zone="70"
currency="CZK" amount="4" transtype="mhdp" amount-type="mobile-app" type="pay"
when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19 09:00:00" valid-
to="2019-12-19 09:45:00" />
Přehled kombinací, které je možno uplatnit pro nákup jízdenky:
45 minut Název Cena CP TP
45 minut amount person-type tariff
45 minut obyčejné 9 1 19
45 minut zlevněné 2 2 19
45 minut student 2 3 19
45 minut důchodce 9 4 19
45 minut důchodce invalidní 9 5 19
45 minut občan 65+ 2 50 19
45 minut občan nad 70 let 2 51 19
zvíře 4 17 19
zavazadlo 4 18 19
10. Krnov (zóna 90)
Příklad pro 45 minut, 70+
132
<transaction vat="10" base-rate="zs" person-type="51" tariff="19" tariff-type="JD" zone="90"
currency="CZK" amount="3" transtype="mhdp" amount-type="mobile-app" type="pay"
when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19 09:00:00" valid-
to="2019-12-19 09:45:00" />
Přehled kombinací, které je možno uplatnit pro nákup jízdenky:
45 minut Název Cena CP TP
45 minut amount person-type tariff
45 minut obyčejné 9 1 19
45 minut zlevněné 4 2 19
45 minut student 4 3 19
45 minut důchodce 4 4 19
45 minut důchodce invalidní 4 5 19
45 minut občan 65+ 4 50 19
45 minut občan nad 70 let 3 51 19
zvíře 4 17 19
zavazadlo 4 18 19
11. Okolí Ostrava XXL (zóna 353)
Příklad pro 45 minut, 65+
<transaction vat="10" base-rate="zs" person-type="50" tariff="19" tariff-type="JD"
zone="353" currency="CZK" amount="6" transtype="mhdp" amount-type="mobile-app"
type="pay" when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19
09:00:00" valid-to="2019-12-19 09:45:00" />
Přehled kombinací, které je možno uplatnit pro nákup jízdenky:
10 minut Název Cena CP TP
45 minut amount person-type tariff
10 minut zlevněné 4 2 3
45 minut zlevněné 6 2 19
10 minut student 4 3 3
45 minut student 6 3 19
10 minut občan 65+ 4 50 3
45 minut občan 65+ 6 50 19
občan nad 70 let 4 51 3
občan nad 70 let 6 51 19
12. Okolí Orlová XL (zóna 157)
Příklad pro 45 minut, 65+
<transaction vat="10" base-rate="zs" person-type="50" tariff="19" tariff-type="JD"
zone="157" currency="CZK" amount="6" transtype="mhdp" amount-type="mobile-app"
type="pay" when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19
09:00:00" valid-to="2019-12-19 09:45:00" />
Přehled kombinací, které je možno uplatnit pro nákup jízdenky:
133
45 minut Název Cena CP TP
45 minut amount person-type tariff
45 minut zlevněné 6 2 19
45 minut student 6 3 19
občan 65+ 6 50 19
občan nad 70 let 6 51 19
13. Nákup mobilní jízdenky, obyčejné REGION
<transaction vat="10" base-rate="zs" person-type="1" tariff="1" tariff-type="JD" arrival-
zones="59" arrival-id="7820" departure-zone="78" departure-id="25468" currency="CZK"
amount="51" transtype="mhd" amount-type="mobile-app" type="pay" sequence="17"
line="863980" when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19
09:00:00" valid-to="2019-12-20 09:00:00" />
Přehled kombinací, které je možno uplatnit pro nákup jízdenky:
km jízdné P 45min Název Cena CP TP
km jízdné P 45min amount person-type tariff
km jízdné P 45min obyčejné 1 1
km jízdné P 45min zlevněné 7 2 1
km jízdné P 45min student 3 1
km jízdné P 45min důchodce 4 1
km jízdné P 45min důchodce invalidní 5 1
km jízdné P 45min občan 65+ 50 1
km jízdné P 45min občan nad 70 let 51 1
zvíře 17 1
zavazadlo 18 1
14. Nákup mobilní jízdenky, obyčejné REGION, vyplněno pay-id
<transaction vat="10" base-rate="zs" person-type="1" tariff="1" tariff-type="JD" arrival-
zones="59" arrival-id="7820" departure-zone="78" departure-id="25468" currency="CZK"
amount="51" transtype="mhd" amount-type="mobile-app" type="pay" sequence="17"
line="863980" when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19
09:00:00" valid-to="2019-12-20 09:00:00" pay-id="c99185a748791BG" />
15. Orlová (zóna 150), Jednotlivé zlevněné (75 %)
Příklad pro 45 minut, zlevněné, Jednotlivé zlevněné (75 %)
<transaction vat="10" base-rate="zs" person-type="2" tariff="19" tariff-type="JD" zone="150"
currency="CZK" amount="4" transtype="mhdp" amount-type="mobile-app" type="pay"
when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19 09:00:00" valid-
to="2019-12-19 09:45:00" fare-label="Jednotlivé zlevněné (75 %)" />
16. Nákup mobilní jízdenky, obyčejné REGION, vyplněno fare-provider-cin
<transaction vat="10" base-rate="zs" person-type="1" tariff="1" tariff-type="JD" arrival-
zones="59" arrival-id="7820" departure-zone="78" departure-id="25468" currency="CZK"
amount="51" transtype="mhd" amount-type="mobile-app" type="pay" sequence="1" line="S1"
134
when="2019-12-19 09:00:00" tx-id="1" fare-id="100" valid-from="2019-12-19 09:00:00" valid-
to="2019-12-20 09:00:00" pay-id="c99185a748791BG" fare-provider-cin="70994226" />
17. Storno 24 hodin ODIS, obyčejné celosíťové (storno příkladu č. 1)
<transaction vat="10" base-rate="zs" person-type="1" tariff="7" tariff-type="JD" zone="352"
currency="CZK" amount="200" transtype="cancel" amount-type="mobile-app" type="pay"
when="2019-12-19 09:00:00" tx-id="2" fare-id="100" valid-from="2019-12-19 09:00:00" valid-
to="2019-12-20 09:00:00" reclamation="1" />
18. Storno 10 minut, obyčejné (storno příkladu č. 2)
<transaction vat="10" base-rate="zs" person-type="1" tariff="3" tariff-type="JD" zone="78"
currency="CZK" amount="16" transtype="cancel" amount-type="mobile-app" type="pay"
when="2019-12-19 09:00:00" tx-id="2" fare-id="100" valid-from="2019-12-19 09:00:00" valid-
to="2019-12-19 09:10:00" reclamation="1" />
19. Storno mobilní jízdenky, obyčejné REGION (storno příkladu č. 13)
<transaction vat="10" base-rate="zs" person-type="1" tariff="1" tariff-type="JD" arrival-
zones="59" arrival-id="7820" departure-zone="78" departure-id="25468" currency="CZK"
amount="51" transtype="cancel" amount-type="mobile-app" type="pay" sequence="17"
line="863980" when="2019-12-19 09:00:00" tx-id="2" fare-id="100" valid-from="2019-12-19
09:00:00" valid-to="2019-12-20 09:00:00" reclamation="1" />
135
Stažení transakcí z CC MSK pomocí webové služby.
Pomocí webové služby můžete ze serveru na KODISu stáhnou pro danou kartu v časovém intervalu
transakce provedené na kartě. Předání dat probíhá on-line, ihned po obdržení dotazu na server. Platí
zde však omezení, a to že všechny transakce může stahovat jen vydavatel karty. Pokud uživatel,
který se hlásí, není vydavatelem karty, stáhnou se jen jeho vlastní transakce.
K ostré verzi CC MSK je WS dostupná na: http://clearing.kodis.cz/WebService/DataService.asmx
K testovací verzi CC MSK je WS na: http://clearing.kodis.cz/WebServiceTest/DataService.asmx
Dostupné jsou dvě metody:
GetTransactionForCardNoHex() – na základě čísla čipu získáte transakce karty.
Parametry:
From - Datum a čas od.
To - Datum a čas do.
cardNoHex - Číslo čipu karty.
userLogin – Login oprávněného uživatele.
password – Heslo pro login.
Vrací string hodnotu ve formátu XML dle specifikace s odpovědí.
GetTransactionForCardNo() – na základě čísla ODIS karty (logické číslo karty) získáte transakce
karty.
Parametry:
From - Datum a čas od.
To - Datum a čas do.
cardNoKodis - Logické číslo karty.
userLogin – Login oprávněného uživatele.
password – Heslo pro login.
Vrací string hodnotu ve formátu XML dle specifikace s odpovědí.
Specifikace XML odpovědi:
<?xml version="1.0" encoding="UTF-8"?>
<transactions>
<transaction device-id="1" provider="veolia" provider-code="25" tx-id="556" card-
id="041D1991BB2280" appl-id="0" type="pay" amount-type="ep" transtype="mhdp"
jumboaccount="False" when="6.1.2012 13:59:49" baseamount="" amount="10,000"
currency="CZK" vat="14,000" balance_before="700,000" balance_after="680,000" departure-
id="71475020" departure-zone="" arrival-id="" arrival-zone="" zone="" line="880633"
sequence="1" tariff="" tariff-type="PP" in-zone="" base-rate="" person-type="" valid-from=""
valid-to="" km_count="" zones="" chech-in="" check-out="" check-km="" transtypetext=""
loyalty="" note="" tranret=""></transaction>
</transactions>
Význam atributů je stejný jako u věty KODIS. Některé atributy o zařízení byly vynechány.
136
Seznam chybových hlášení:
2 -- nenalezen uživatel nebo špatné heslo
1 -- nenalezeno číslo čipu karty v DB
137
WSDL:
Pro GetTransactionForCardNoHex
SOAP 1.1
Následuje ukázkový požadavek a odpověď SOAP 1.1. Uvedené zástupce je třeba nahradit
skutečnými hodnotami.
POST /DataService.asmx HTTP/1.1
Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://tempuri.org/GetTransactionForCardNoHex"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetTransactionForCardNoHex xmlns="http://tempuri.org/">
<from>dateTime</from>
<to>dateTime</to>
<cardNoHex>string</cardNoHex>
<userLogin>string</userLogin>
<password>string</password>
</GetTransactionForCardNoHex>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetTransactionForCardNoHexResponse xmlns="http://tempuri.org/">
<GetTransactionForCardNoHexResult>string</GetTransactionForCardNoHexResult>
</GetTransactionForCardNoHexResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
Následuje ukázkový požadavek a odpověď SOAP 1.2. Uvedené zástupce je třeba nahradit
skutečnými hodnotami.
POST /DataService.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetTransactionForCardNoHex xmlns="http://tempuri.org/">
<from>dateTime</from>
<to>dateTime</to>
<cardNoHex>string</cardNoHex>
138
<userLogin>string</userLogin>
<password>string</password>
</GetTransactionForCardNoHex>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetTransactionForCardNoHexResponse xmlns="http://tempuri.org/">
<GetTransactionForCardNoHexResult>string</GetTransactionForCardNoHexResult>
</GetTransactionForCardNoHexResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
Následuje ukázka požadavku a odpovědi HTTP POST. Uvedené zástupce je třeba nahradit
skutečnými hodnotami.
POST /DataService.asmx/GetTransactionForCardNoHex HTTP/1.1
Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
from=string&to=string&cardNoHex=string&userLogin=string&password=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://tempuri.org/">string</string>
Pro GetTransactionForCardNo
SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be
replaced with actual values.
POST /WebService/DataService.asmx HTTP/1.1
Host: clearing.kodis.cz
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://tempuri.org/GetTransactionForCardNo"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetTransactionForCardNo xmlns="http://tempuri.org/">
<from>dateTime</from>
<to>dateTime</to>
<cardNoKodis>string</cardNoKodis>
<userLogin>string</userLogin>
<password>string</password>
</GetTransactionForCardNo>
</soap:Body>
139
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetTransactionForCardNoResponse xmlns="http://tempuri.org/">
<GetTransactionForCardNoResult>string</GetTransactionForCardNoResult>
</GetTransactionForCardNoResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be
replaced with actual values.
POST /WebService/DataService.asmx HTTP/1.1
Host: clearing.kodis.cz
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetTransactionForCardNo xmlns="http://tempuri.org/">
<from>dateTime</from>
<to>dateTime</to>
<cardNoKodis>string</cardNoKodis>
<userLogin>string</userLogin>
<password>string</password>
</GetTransactionForCardNo>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetTransactionForCardNoResponse xmlns="http://tempuri.org/">
<GetTransactionForCardNoResult>string</GetTransactionForCardNoResult>
</GetTransactionForCardNoResponse>
</soap12:Body>
</soap12:Envelope>
140
Vygenerování hesla z CC MSK pomocí webové služby
Pomocí webové služby můžete ze serveru na KODISu vygenerovat a stáhnou heslo pro danou
kartu. Předání dat probíhá on-line, ihned po obdržení dotazu na server. Neplatí zde omezení, že
vygenerovat a stáhnout heslo může jen vydavatel karty. Dopravci mohou vygenerovat a stáhnout
heslo rovněž pro cizí karty.
Ostrá verze CC MSK bude WS na: https://clearing.kodis.cz/WebService/DataService.asmx
Testovací verze CC MSK bude WS na: https://clearing.kodis.cz/WebServiceTest/DataService.asmx
Dostupná je metoda:
GetUserPasswordByCardNo (cardNoKodis, userLogin, password) - Metoda pro vygenerování a
získání nového heska ke kartě a uživatelskému účtu karty.
Parametry:
cardNoKodis – Výrobní číslo čipu karty v hexadecimálním tvaru přidělené výrobcem
userLogin – Přihlašovací jméno dopravce
password – Přihlašovací heslo dopravce
Vrací string hodnotu s vygenerováným heslem v případě úspěchu, které splňuje následující
pravidla:
1. heslo je dlouhé minimálně 8 znaků
2. heslo obsahuje minimálně 1 číslici
3. heslo obsahuje minimálně 1 velké písmeno
4. heslo obsahuje minimálně 1 malé písmeno
V případě chyby metoda vrátí jeden z možných chybových stavů:
CHYBA: Dopravce nebyl identifikován dle přihlašovacího jména a hesla.
CHYBA: Karta nebyla nalezena.
CHYBA: Uživatel ke kartě nebyl nalezen.
CHYBA: Ukládání hesla do DB.
141
WSDL pro GetUserPasswordByCardNo
SOAP 1.1
Následuje ukázkový požadavek a odpověď SOAP 1.1. Uvedené zástupce je třeba nahradit
skutečnými hodnotami.
POST /DataService.asmx HTTP/1.1
Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://tempuri.org/GetUserPasswordByCardNo"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetUserPasswordByCardNo xmlns="http://tempuri.org/">
<cardNoHex>string</cardNoHex>
<userLogin>string</userLogin>
<password>string</password>
</GetUserPasswordByCardNo>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetUserPasswordByCardNoResponse xmlns="http://tempuri.org/">
<GetUserPasswordByCardNoResult>string</GetUserPasswordByCardNoResult>
</GetUserPasswordByCardNoResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
Následuje ukázkový požadavek a odpověď SOAP 1.2. Uvedené zástupce je třeba nahradit
skutečnými hodnotami.
POST /DataService.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetUserPasswordByCardNo xmlns="http://tempuri.org/">
<cardNoHex>string</cardNoHex>
<userLogin>string</userLogin>
<password>string</password>
</GetUserPasswordByCardNo>
</soap12:Body>
</soap12:Envelope>
142
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetUserPasswordByCardNoResponse xmlns="http://tempuri.org/">
<GetUserPasswordByCardNoResult>string</GetUserPasswordByCardNoResult>
</GetUserPasswordByCardNoResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
Následuje ukázka požadavku a odpovědi HTTP POST. Uvedené zástupce je třeba nahradit
skutečnými hodnotami.
POST /DataService.asmx/GetUserPasswordByCardNo HTTP/1.1
Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
cardNoHex=string&userLogin=string&password=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://tempuri.org/">string</string>
143
Stažení karet se změnami profilu z CC MSK pomocí webové služby
Pomocí webové služby lze stáhnout pro daného dopravce seznam vlastních karet, na kterých došlo
ke změně zákaznického profilu ve vybraném časovém intervalu. Předání dat probíhá on-line, ihned
po obdržení dotazu na server.
K ostré verzi CC MSK je WS dostupná na: http://clearing.kodis.cz/WebService/DataService.asmx
K testovací verzi CC MSK je WS na: http://clearing.kodis.cz/WebServiceTest/DataService.asmx
Dostupná je metoda:
GetProviderCardCp()
Parametry:
DateFrom - Datum a čas intervalu od
DateTo - Datum a čas intervalu do
UserLogin – Uživatelský login provozovatele
Password – Uživatelské heslo provozovatele
Vrací string hodnotu ve formátu XML dle specifikace s odpovědí.
Specifikace XML odpovědi:
<?xml version="1.0" encoding="UTF-8"?>
<cards>
<card cardsno="04044302AB3780" type="customerprofile" customerprofile="1" date-
from="2016-01-01 12:00:00" date-to="2016-02-01 12:00:00" date="2016-01-01 11:30:00"
provider="25"></card>
<card cardsno="04044302AB3780" type="customerprofile" customerprofile="50" date-
from="2016-03-01 12:00:00" date-to="2016-04-01 12:00:00" date="2016-03-01 11:30:00"
provider="62"></card>
<card cardsno="04064302AB3744" type="customerprofile2" customerprofile="2" date-
from="2016-01-01 12:00:00" date-to="2016-02-01 12:00:00" date="2016-01-01 11:30:00"
provider="25"></card>
<card cardsno="04064302AB3744" type="customerprofile2" customerprofile="50" date-
from="2016-02-01 12:00:00" date-to="2016-03-01 12:00:00" date="2016-02-01 11:30:00"
provider="25"></card>
…
</cards>
Význam atributů:
cardsno – výrobní číslo karty v hexadecimálním tvaru (povinná položka)
type – typ profilu na kartě – „customerprofile“ = profil 1, „customerprofile2“ = profil 2
customerprofile – číslo profilu na kartě, v případě zrušení profilu na kartě se zasílá hodnota „0“
(povinná položka)
date-from – začátek intervalu platnosti profilu na kartě (povinná položka v případě existujícího
profilu a hodnoty začátek intervalu platnosti na kartě)
date-to – konec intervalu platnosti profilu na kartě (povinná položka v případě existujícího profilu a
hodnoty konce intervalu platnosti na kartě)
date – datum změny profilu na kartě u dopravce (povinná položka)
provider – dopravce, který provedl změnu profilu na kartě (povinná položka)
144
Stažení karet se změnami údajů z CC MSK pomocí webové služby
Pomocí webové služby lze stáhnout pro daného dopravce seznam vlastních karet, na kterých došlo
ke změně údajů (jméno, příjmení, email, datum narození, číslo isic) ve vybraném časovém
intervalu. Předání dat probíhá on-line, ihned po obdržení dotazu na server.
K ostré verzi CC MSK je WS dostupná na: http://clearing.kodis.cz/WebService/DataService.asmx
K testovací verzi CC MSK je WS na: http://clearing.kodis.cz/WebServiceTest/DataService.asmx
Dostupná je metoda:
GetCardInformationChanges()
Parametry:
DateFrom - Datum a čas intervalu od
DateTo - Datum a čas intervalu do
UserLogin – Uživatelský login provozovatele
Password – Uživatelské heslo provozovatele
Vrací string hodnotu ve formátu XML dle specifikace s odpovědí.
Specifikace XML odpovědi:
<?xml version="1.0" encoding="UTF-8"?>
<cards>
<card cardsno="04044302AB3780" type="email" email ="jan.novak@email.cz" date="2016-01-
01 11:30:00" provider="25"></card>
<card cardsno="04044302AB3780" type="name" name ="jan " date="2016-01-01 11:30:01"
provider="25"></card>
<card cardsno="04044302AB3780" type="surname" surname ="novak" date="2016-01-01
11:30:02" provider="25"></card>
<card cardsno="04044302AB3780" type="birthdate" birthdate ="1987-08-07" date="2016-01-01
11:30:03" provider="25"></card>
<card cardsno="04044302AB3780" type="isicno" isicno ="ABCDE" date="2016-01-01
11:30:04" provider="25"></card>
…
</cards>
Význam atributů:
cardsno – výrobní číslo karty v hexadecimálním tvaru (povinná položka)
type – typ změny – „email“ = email, „name“ = jméno, „surname“ = příjmení, „birthdate“ = datum
narození, „isicno“ = číslo isic
email – nový email (povinná položka v případě type=„email“)
name – nové jméno (povinná položka v případě type=„ name“)
surname – nové příjmení (povinná položka v případě type=„ surname“)
birthdate – nové datum narození (povinná položka v případě type=„ birthdate“)
isicno – nové číslo isic (povinná položka v případě type=„ isicno“)
date – datum změny na kartě u dopravce (povinná položka)
provider – dopravce, který provedl změnu na kartě (povinná položka)
145
Aktualizace stavu žádosti o kartu pomocí webové služby
Pomocí webové služby lze aktualizovat stav žádosti o kartu a UID karty. Předání dat probíhá on-
line, ihned po obdržení dotazu na server.
K ostré verzi CC MSK je WS dostupná na: http://clearing.kodis.cz/WebService/DataService.asmx
K testovací verzi CC MSK je WS na: http://clearing.kodis.cz/WebServiceTest/DataService.asmx
Dostupná je metoda:
ChangeCardRequestState()
Parametry:
CardRequestNo – číslo žádosti
CardRequestStateID – nový stav žádosti
CardUID – UID karty
UserLogin – Uživatelský login provozovatele
Password – Uživatelské heslo provozovatele
Vrací status operace v parametru ResponseStatus (0 = OK).
Převod je možný pouze mezi stavy:
1 na 2
1 na 4
2 na 1
2 na 3 (povinné CardUID)
3 na 5
Popis stavů žádosti o kartu ke dni 16. 8. 2018
1 - žádost o kartu byla zaslána z CM nebo eShopu do CCMSK
2 - žádost o kartu byla zaslána do výroby na personalizační linku
3 - karta byla vyrobena na personalizační lince
4 - žádost o kartu byla stornována
5 - karta je připravena k vyzvednutí
146
Stažení všech transakcí z CC MSK pro dopravce za měsíc.
Tuto funkci najdete v menu webového rozhraní Transakce/Export transakcí. Jednou za měsíc je
provedeno stažení všech transakcí daného dopravce. Na této stránce pak vidí své soubory a má je
stažení.
Soubory jsou uloženy v zip souboru. Formát xml souboru je uvede níže.
<?xml version="1.0" encoding="UTF-8"?>
<transactions generateDate="21.8.2012 15:11:11" countDevices="1" status="OK"
version="1">
<device id="3290">
<transaction tx-id="18555" type="odp" amount-type="cash"
transtype="uni" when="15.6.2012 5:14:09" amount="0,000"
vat="14,000" currency="CZK" />
<transaction tx-id="18556" type="pay" amount-type="cash"
transtype="mhd" when="15.6.2012 5:41:58" amount="58,000"
vat="14,000" departure-id="5232" departure-zone="380"
arrival-id="5378" arrival-zone="1" line="900231" sequence="27"
tariff="1" tariff-type="JD" person-type="1" base-rate="True"
note="papir" km_count="49" currency="CZK" />
</device>
</transactions>
transactions
generateDate – Datum vytvoření tohoto sestavení.
countDevices – počet zařízení pro která jsou zde data.
status – Stav dokončení, OK je vše v pořádku, ERROR došlo k chybám při generování.
version – verze sestavení. Při změně sestavení se zda objeví vyšší číslo pro identifikaci formátu
sestavení.
device
id – číslo zařízení
transaction
tagy mají stejný název a význam jako ve větě KODIS kromě těchto tagů:
bad-type – obsahuje číslo chyby.
bad-confirm – obsahuje True/False. Určuje, zda byla vadná transakce uznána (True).
147
Stažení všech transakcí z CC MSK pro dopravce na vlastních kartách
provedených u jiného dopravce za měsíc.
Tuto funkci najdete v menu webového rozhraní Transakce/Export cizích transakcí. Jednou za měsíc
je provedeno stažení všech transakcí, které byly provedeny u jiných dopravců na kartách dopravce.
Na této stránce si můžete dané transakce stáhnout v jednom souboru.
Soubory jsou uloženy v zip souboru. Formát xml souboru je uvede níže.
<?xml version="1.0" encoding="UTF-8"?>
<transactions generateDate="21.8.2012 15:11:11" countTransaction="1" status="OK"
version="1">
<transaction tx-id="18555" card-id="045056B26A1E80" appl-id="4609"
type="pay" amount-type="cash"
transtype="mhd" when="15.6.2012 5:41:58" amount="58,000"
vat="14" departure-id="5232" departure-zone="380"
arrival-id="5378" arrival-zone="1" line="900231" sequence="27"
tariff="1" tariff-type="JD" person-type="1" base-rate="True"
note="papir" km_count="49" currency="CZK" />
</transactions>
transactions
generateDate – Datum vytvoření tohoto sestavení.
status – Stav dokončení, OK je vše v pořádku, ERROR došlo k chybám při generování.
countTransaction – celkový počet transakcí
version – verze sestavení. Při změně sestavení se zde objeví vyšší číslo pro identifikaci formátu
sestavení.
transaction
tagy mají stejný název a význam jako ve větě KODIS kromě těchto tagů:
bad-type – obsahuje číslo chyby.
bad-confirm – obsahuje True/False. Určuje, zda byla vadná transakce uznána (True).
148
Stažení aktuálního seznamu všech žádostí o kartu
Metoda GetCardRequestList() - pro danou kartu vrátí aktuální seznam všech žádostí o kartu na základě data
od a data do. Metoda autentizuje uživatele na základě předaného loginu a hesla.
Parametry:
RequestNoFrom – Číslo žádosti od
RequestNoTo – Číslo žádosti do
DateFrom - Datum od
DateTo - Datum do
CardNo – Logické číslo karty
Userlogin - Uživatelský login
Password - Uživatelské heslo
CardRequestState - Stav žádosti o kartu
ResponseStatus - Výsledek zpracování dotazu (pokud je ErrorCode=0 vše je OK)
CardRequestList - seznam nově personalizovaných karet s aktuálním stavem
V případě úspěchu vrací aktuální seznam všech žádostí o kartu na základě data od a data do, jinak popis
chyby, která nastala
Popis - Vrátí seznam všech žádostí o kartu na základě data podání od/do nebo čísla žádosti od/do nebo
kódu stavu žádosti o kartu. Metoda autentizuje uživatele na základě předaného loginu a hesla.
POST /Webservice/DataService.asmx HTTP/1.1
Host: karta.odiska.cz
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://tempuri.org/GetCardRequestList"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetCardRequestList xmlns="http://tempuri.org/">
<RequestNoFrom>int</RequestNoFrom>
<RequestNoTo>int</RequestNoTo>
<DateFrom>dateTime</DateFrom>
<DateTo>dateTime</DateTo>
<CardRequestState>APPLICATION or PERSONALIZATION or PERSONALIZED or
CANCELLED</CardRequestState>
<SetPersonalizationState>boolean</SetPersonalizationState>
<Userlogin>string</Userlogin>
<Password>string</Password>
</GetCardRequestList>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetCardRequestListResponse xmlns="http://tempuri.org/">
<ResponseStatus>
149
<ErrorCode>int</ErrorCode>
<ErrorMessage>string</ErrorMessage>
</ResponseStatus>
<CardRequestList>
<CardRequest>
<CreatedDate>dateTime</CreatedDate>
<ChangeDate>dateTime</ChangeDate>
<RequestNo>int</RequestNo>
<CardRequestState>APPLICATION or PERSONALIZATION or PERSONALIZED or
CANCELLED</CardRequestState>
<CardKodis>string</CardKodis>
<CardNo>string</CardNo>
<CardValidFrom>dateTime</CardValidFrom>
<CardValidTo>dateTime</CardValidTo>
<Name>string</Name>
<Surname>string</Surname>
<Email>string</Email>
<PersonalIdentityNo>string</PersonalIdentityNo>
<BirthDate>dateTime</BirthDate>
<RepresentativeName>string</RepresentativeName>
<RepresentativeSurname>string</RepresentativeSurname>
<RepresentativeEmail>string</RepresentativeEmail>
<RepresentativePersonalIdentityNo>string</RepresentativePersonalIdentityNo>
<RepresentativeBirthDate>dateTime</RepresentativeBirthDate>
<DeliveryType>CONTACT_POINT or POST_MAIL_NORMAL or
POST_MAIL_REGISTERD</DeliveryType>
<DeliveryRecipient>string</DeliveryRecipient>
<DeliveryStreet>string</DeliveryStreet>
<DeliveryCityEvidenceNo>string</DeliveryCityEvidenceNo>
<DeliveryStreetEvidenceNo>string</DeliveryStreetEvidenceNo>
<DeliveryCity>string</DeliveryCity>
<DeliveryZip>string</DeliveryZip>
<Note>string</Note>
<Photo>base64Binary</Photo>
<CustomerProfileNo1>int</CustomerProfileNo1>
<CustomerProfileDateFrom1>dateTime</CustomerProfileDateFrom1>
<CustomerProfileDateTo1>dateTime</CustomerProfileDateTo1>
<CustomerProfileNo2>int</CustomerProfileNo2>
<CustomerProfileDateFrom2>dateTime</CustomerProfileDateFrom2>
<CustomerProfileDateTo2>dateTime</CustomerProfileDateTo2>
<CardType>ANONYMOUS or PERONALIZED or PORTABLE or
NOT_PORTABLE_NOT_PERSONALIZED or GRAPHICALLY_PERSONALIZED or REPLACED or
EMPLOYEE_GRAPHICALLY_PERSONALIZED</CardType>
<Provider>unsignedByte</Provider>
<ContactPointNo>string</ContactPointNo>
</CardRequest>
<CardRequest>
<CreatedDate>dateTime</CreatedDate>
<ChangeDate>dateTime</ChangeDate>
<RequestNo>int</RequestNo>
<CardRequestState>APPLICATION or PERSONALIZATION or PERSONALIZED or
CANCELLED</CardRequestState>
<CardKodis>string</CardKodis>
<CardNo>string</CardNo>
<CardValidFrom>dateTime</CardValidFrom>
<CardValidTo>dateTime</CardValidTo>
<Name>string</Name>
<Surname>string</Surname>
<Email>string</Email>
<PersonalIdentityNo>string</PersonalIdentityNo>
<BirthDate>dateTime</BirthDate>
<RepresentativeName>string</RepresentativeName>
<RepresentativeSurname>string</RepresentativeSurname>
150
<RepresentativeEmail>string</RepresentativeEmail>
<RepresentativePersonalIdentityNo>string</RepresentativePersonalIdentityNo>
<RepresentativeBirthDate>dateTime</RepresentativeBirthDate>
<DeliveryType>CONTACT_POINT or POST_MAIL_NORMAL or
POST_MAIL_REGISTERD</DeliveryType>
<DeliveryRecipient>string</DeliveryRecipient>
<DeliveryStreet>string</DeliveryStreet>
<DeliveryCityEvidenceNo>string</DeliveryCityEvidenceNo>
<DeliveryStreetEvidenceNo>string</DeliveryStreetEvidenceNo>
<DeliveryCity>string</DeliveryCity>
<DeliveryZip>string</DeliveryZip>
<Note>string</Note>
<Photo>base64Binary</Photo>
<CustomerProfileNo1>int</CustomerProfileNo1>
<CustomerProfileDateFrom1>dateTime</CustomerProfileDateFrom1>
<CustomerProfileDateTo1>dateTime</CustomerProfileDateTo1>
<CustomerProfileNo2>int</CustomerProfileNo2>
<CustomerProfileDateFrom2>dateTime</CustomerProfileDateFrom2>
<CustomerProfileDateTo2>dateTime</CustomerProfileDateTo2>
<CardType>ANONYMOUS or PERONALIZED or PORTABLE or
NOT_PORTABLE_NOT_PERSONALIZED or GRAPHICALLY_PERSONALIZED or REPLACED or
EMPLOYEE_GRAPHICALLY_PERSONALIZED</CardType>
<Provider>unsignedByte</Provider>
<ContactPointNo>string</ContactPointNo>
<CompanyName>string</CompanyName>
<CompanyID>string</CompanyID>
<CompanyVatID>string</CompanyVatID>
<CardUserPassword>string</CardUserPassword>
</CardRequest>
</CardRequestList>
</GetCardRequestListResponse>
</soap:Body>
</soap:Envelope>
Popis jednotlivých atributů viz kapitola Žádosti o vydání karty.
151
Dodatek 1
Seznam a popis chybových hlášení z CCMSK při importu transakcí
102001, "Nesouhlasí počet vybíjecích operací u zařízení"
102002, "Nesouhlasí počty dobíjecích operací u zařízení",
102003, "Nesouhlasí suma operací u zařízení.",
102004, "Nezadáno číslo zařízení",
102005, "Neplatný formát hlavičky pro atribut 'Vat'",
102006, "Neplatný formát pro atribut 'samno'",
102007, "Neplatný formát pro atribut 'depozitcount'",
102008, "Neplatný formát pro atribut 'paycount'",
101002, "Neplatný formát pro atribut 'cardsno'",
101003, "Neplatný formát pro atribut 'tx-id'",
101004, "Neplatný formát pro atribut 'when'",
101007, "Neplatný formát pro atribut 'amount' ",
101008, "Neplatný formát pro atribut 'balance_after'",
101009, "Neplatný formát pro atribut 'balance_before'",
101010, "Neplatný formát transakce pro atribut 'vat'",
101011, "Neplatný formát transakce pro atribut 'type'",
101012, "Neplatný formát transakce pro atribut 'amout-type'",
101013, "Neplatný formát transakce pro atribut 'transtype'",
101014, "Neplatný formát transakce pro atribut 'when'",
101015, "Neplatný formát pro atribut 'appl-id'",
100020, "Chyba: Povinná položka v případě práce s EP.",
100021, "Chyba: Povinná položka v případě transakce související s nástupem do vozidla.",
100022, "Chyba: Povinná položka v případě transakce související s výstupem z vozidla.",
100023, "Chyba: Povinná položka v případě transakce související s jízdou.",
100024, "Chyba: Povinná položka v případě transakce obsahující tarif.",
100033, "Chyba: Neznámá položka TransType.",
100034, "Reklamační transakce neobsahuje korektní data (Reklamace jízdy ve vozidle)",
100035, "Reklamační transakce neobsahuje korektní data (Reklamace jízdy u vydavatele karty).",
100036, " Reklamační transakce neobsahuje korektní data (Reklamace u jiného než vydavatele
karty).",
100037, " Reklamační transakce neobsahuje korektní data (Povinná položka v případě transakce
obsahující časový tarif).",
100038, "Vyrovnávací transakce nesmí obsahovat práci s EP.",
100039, "Nebyli nalezeny položky v transakci.",
100040, "Chyba: Povinná položka v případě práce s multitransakcemi.",
100041, "Chyba: nekorektně zadán sloupec se zónami (Zone).",
100042, "Chyba: nekorektně zadán sloupec se zónami (Zones).",
200001, "Zařízení není aktivní.",
200002, "Karta není aktivní.",
200003, "Karta je na blacklistu.",
200004, "Karta v systému neexistuje.",
200005, "Aplikace pro danou kartu neexistuje nebo není zavedena.",
200006, "TariffType nenalezen v číselníku.",
200007, "PersonType nenalezen v číselníku.",
152
200008, "V číselníku zón se nepodařilo vytvořit záznam pro DepartureTariffID.",
200009, "V číselníku zón se nepodařilo vytvořit záznam pro ArrivalTariffID.",
200010, "Některé zóny v číselníku neexistují (Zone).",
200011, "Některé zóny v číselníku neexistují (Zones).",
200100, "Obecná chyba při komunikaci s Databází.",
200101, "Zařazení neexistuje.",
200102, "Transakce s tímto číslem tx-id již existuje.",
200103, "Nepodařil se zápis záznamu o transakci do tabulky.",
200104, "0-tá aplikace na kartě není vytvořena, nelze nastat data.",
200105, "Nenalezena karta dle CardKODIS",
200106, "Storno transakce nebyla přijata z důvodu nenalezení transakce ke stornování.",
200107, "Chyba při změně transakce ke stornování na stornovanou.",
200108, "Storno transakce nebyla přijata z důvodu nenalezení transakce ke stornování (Multi).",
200109, "Chyba při změně transakce ke stornování na stornovanou (Multi).",
200110, "Transakce s tímto číslem tx-id a multi-index již existuje.",
200111, "Transakce obsahuje chybný formát či sestavení pro zóny.",
200112, "Transakci se nepodařilo uložit korektně z důvodu nečitelného Zones.",
200200, "Nepodařil se zápis záznamu o transakci do tabulky.",
153
Dodatek 2
Seznam zkratek
ZS – základní sazba
KODIS – koordinátor Dopravní ODIS.
EP – elektronická peněženka
CCMSK – clearingové centrum Moravskoslezského kraje
SAM – Secure Access Module (or Secure Application Module)
XML – rozšiřitelný značkovací jazyk (Extensible Mark-up Language) je obecný značkovací jazyk
sdílení a výměnu dat.
Terminál – je zařízení uskutečňující transakce.
Multilístek – jedná se o jízdenku, na kterou jede více cestujících (několik dospělých, pes, dítě atd.).
Multitransakce – transakce skládající se z více než jedné transakce. Dají se použít k zaslání
informaci z multilístku. Tyto transakce jsou speciální v tom, že mají stejné číslo transakce (tx-id),
tedy lístku a obsahují multi-index a multi-sum.
Přestupní jízdenka – je jízdenka, která obsahuje více jízdenek na různé trasy.
Přestupní multilístek – je jízdenka, která obsahuje více jízdenek na různé trasy a zároveň na ni jede
více cestujících (několik dospělých, dětí, psů atd.).
154
Platby bankovní kartou
Verze 13.0
XT-Card a.s., Seifertova 327/85, 130 00 Praha 3, IČ: 27408256, DIČ: CZ27408256, zapsaná v obchodním rejstříku
vedeném u Městského soudu v Praze v oddílu B, vložka 10398. Číslo účtu 19-1133090227/0100.
Strana 1/68
1 Obsah
1 Obsah ........................................................................................................................................... 2
1.1 Historie změn ........................................................................................................................ 5
1.2 Seznam použitých zkratek a pojmů.......................................................................................6
2 POPIS II. FÁZE PROJEKTU..............................................................................................................7
2.1 Základní atributy....................................................................................................................7
3 ZALOŽENÍ ÚČTU A REGISTRACE BANKOVNÍ KARTY...................................................................... 8
3.1 Založení účtu a registrace bankovní karty.............................................................................8
3.1.1 Založení účtu a registrace bankovní karty pomocí internetu ......................................... 8
3.1.2 Založení účtu a registrace bankovní karty na přepážce ................................................. 8
3.2 Převod karty na jiný účet.......................................................................................................9
3.2.1 Převod karty na registračním portálu ............................................................................. 9
3.2.2 Převod karty na přepážce ............................................................................................... 9
3.2.3 Rozhraní pro převod karty na jiný účet..........................................................................9
3.3 Odregistrování karty z účtu na přepážce ............................................................................ 10
3.3.1 Rozhraní pro odregistrování karty z účtu prováděné na přepážce ............................... 10
4 ČASOVÝ KUPÓN REGISTROVANÝ K BANKOVNÍ KARTĚ............................................10
4.1 Přiřazení bankovní karty pro účely časového kupónu......................................................... 10
4.1.1 Přiřazení bankovní karty pro časový kupón v internetovém rozhraní registrovaného
účtu držitele................................................................................................................................10
4.1.2 Přiřazení bankovní karty pro časový kupón na přepážce.............................................11
4.2 Převod bankovní karty určené pro použití časových kupónů ............................................. 12
4.2.1 Převod v internetovém rozhraní v registrovaném účtu držitele ................................... 12
4.2.2 Převod na přepážce ...................................................................................................... 12
4.2.3 Rozhraní pro převod provedený na přepážce...............................................................13
4.3 Odregistrovaní přiřazení bankovní karty pro použití kupónů ............................................. 13
4.3.1 Rozhraní pro odregistrování karty ............................................................................... 14
4.3.2 Funkce pro ověření zda BK již byla registrována ........................................................ 14
4.3.3 Zasílání dat o registraci karty a distribuce White Listu bankovních karet...................15
4.4 Distribuce fotografií do PP a revizorských zařízení ............................................................. 18
4.5 Pořízení časového kupónu k bankovní kartě.......................................................................18
4.5.1 Zasílání dat o zakoupeném kupónu k bankovní kartě..................................................19
4.6 Storno kupónu ..................................................................................................................... 19
4.7 Vrácení kupónu ................................................................................................................... 20
4.8 Blokace a odblokace bankovní karty pro použití kupónu ................................................... 21
4.8.1 Rozhraní pro blokaci karty na přepážce.......................................................................22
4.8.2 Rozhraní pro odblokaci karty na přepážce...................................................................22
4.9 Odbavení cestujícího s časovým kupónem na bankovní kartě ........................................... 23
4.10 Proces odbavení cestujícího v oblasti Město, mimo Ostrava XXL na bankovní kartu ... 24
4.11 Proces odbavení cestujícího ve vozidle dopravce mimo DPO pro oblast Ostrava XXL na
bankovní kartu................................................................................................................................ 24
4.12 Proces odbavení cestujícího v Regionu na bankovní kartu ............................................. 24
4.13 Proces odbavení cestujícího ve vozidlech s nástupem všemi dveřmi (např. DPO)
s časovým kupónem na bankovní kartě ......................................................................................... 25
4.14 Diagram procesu odbavení cestujícího v Regionu na bankovní kartu ............................ 26
4.15 Diagram procesu odbavení cestujícího ve vozidle dopravce mimo DPO pro oblast
Město, Ostrava XXL nebo XXL na bankovní kartu ...................................................................... 26
4.16 Napojení dopravců na ČSOB........................................................................................... 26
4.17 DOKUPOVANÉ JÍZDNÉ ............................................................................................... 28
2
4.18 V DPO ............................................................................................................................. 28
4.19 WL dokupovaných jízdenek zasílaný ihned z validátoru na CC MSK ............................... 30
4.20 WL dokupovaných jízdenek distribuovaný do vozidel a revizorských zařízení ............... 31
4.21 WL dokupovaných jízdenek nahrávaný na kartu revizora...............................................32
4.22 Transakce dokupovaných jízdenek vyčítaných z odbavovacího zařízení na konci dne a
zasílány na CC MSK.........................................................................................................................32
4.23 Dokupované jízdenky v PAD ............................................................................................ 32
4.24 Ochrana osobních údajů .................................................................................................. 32
4.25 Evidence ověření..............................................................................................................33
4.26 Číslo obchodníka..............................................................................................................33
5 Formát taplistu...........................................................................................................................34
5.1 Variabilní data pro Ostravu ................................................................................................. 34
5.2 Soubor s dopravními daty.................................................................................................... 35
5.2.1 Formát souboru ............................................................................................................ 35
5.2.2 Simple TLV data .......................................................................................................... 36
5.2.3 Specifikace CRC32 ...................................................................................................... 36
6 DENY LIST ................................................................................................................................... 38
6.1 Význam použitých datových položek .................................................................................. 38
6.2 Zpracování odpovědí ........................................................................................................... 39
6.3 Metoda GetLastIssuedDenyListSequenceNo ...................................................................... 40
6.4 Metoda GetDenyList ........................................................................................................... 41
6.5 Metoda GetDenyListBinary ................................................................................................. 43
7 WHITE LIST KUPÓNŮ REGISTROVANÝCH K BANKOVNÍ KARTĚ .................................................. 45
8 Soubor transakcí z BO banky na CC MSK ................................................................................... 46
8.1 Denní uzávěrka transakcí .................................................................................................... 50
8.2 Clearing uzávěrka karet (z BO do CC MSK)..........................................................................50
8.3 Formát souboru Denylistu...................................................................................................51
9 Zapojení příměstských dopravců včetně železničních do systému plateb jízdného bankovní
kartou ................................................................................................................................................. 52
9.1 Rozšíření předávaných dat mezi BO a CC MSK....................................................................52
9.2 Rozšíření předávaných dat mezi odbavovacím zařízení a BO ............................................. 52
9.3 Rozšíření systému CC MSK .................................................................................................. 52
9.3.1 Soubor transakcí...........................................................................................................52
9.3.2 Tabulka jízdenek TransactionEmv............................................................................... 52
9.3.3 Zařazení druhů jízdenek...............................................................................................53
9.3.4 Počítání ceny zvýhodněného přestupu ......................................................................... 53
9.3.5 Dělení základní sazby mezi dopravce .......................................................................... 54
9.3.6 Výstupy ........................................................................................................................ 55
10 Metodika zpracovávání jednotlivých jízdenek hrazených prostřednictvím bankovní karty ..... 56
10.1 Typy jednotlivých jízdenek na bankovní kartu ................................................................ 56
10.2 Postup zpracovávání těchto prodejů v CC pro dělbu mezi dopravce..............................56
10.3 Postup při vyhodnocování jízdného v kombinaci s jízdným REGION nebo MĚSTO při
platbě platební kartou mimo situace, kdy cestující má zakoupeny dokupované jízdenky v rámci
OSTRAVA XXL: ................................................................................................................................ 57
10.4 Vyhodnocení stržené částky v situaci, kdy cestující jede v OSTRAVA XXL, v REGIONU
nebo MĚSTĚ a má pro tarifní oblast OSTRAVA XXL zakoupeny dokupované jízdenky: ................ 58
10.5 Příklad č. 1:.......................................................................................................................58
10.6 Příklad č. 2:.......................................................................................................................58
10.7 Příklad č. 3:.......................................................................................................................59
10.8 Příklad č. 4:.......................................................................................................................59
3
11 VYSTAVENÍ DAŇOVÝCH DOKLADŮ ................................................................................ 61
11.1 Příklady jednotlivých daňových dokladů při dosažení celodenního stropu .................... 61
12 ROZHRANÍ PRO E-SHOP ............................................................................................................. 62
12.1 Způsob platby .................................................................................................................. 62
12.2 Rozhraní pro e-shop......................................................................................................... 62
4
INFORMACE O DOKUMENTU
1.1 Historie změn
Datum Verze Změny Autor
20. 6. 2017 0.0 Nenka
Vytvoření dokumentu
22.6.2017 0.1 Nenka
23.8.2017 0.2 Upřesnění odbavení cestujícího na kupón Nenka
19.9.2017 0.3 Zapracování připomínek Nenka
26.9.2017 0.4 Zapracování připomínek Nenka
27.9.2017 0.5 Zapracování připomínek Nenka
4.10.2017 0.6 Zapracování připomínek Vídenková
5.10.2017 0.7 Zapracování připomínek Nenka
6.10.2017 0.8 Zapracování připomínek Nenka
11.10.2017 0.9 Zapracování připomínek Nenka
16.10.2017 10.0 Změna přenosu WL dokupů Nenka
17.10.2017 10.1 Zapracování připomínek ME Nenka
24.10.2017 10.2 Upřesnění významu Transfer-type Vídenková
31.10.2017 10.3 Úprava a korekce KODIS Nenka
23.12.2017 10.4 Úprava GetWhiteListBankCard a RegisterBankCard Nenka
5.1.2018 10.5 Revize a korekce vůči implementaci Nenka
11.1.2018 10.6 Úprava VD odbavní BK Nenka
19.1.2018 10.7 Revize a korekce vůči implementaci Nenka
19.1.2018 10.8 Úprava GetWhiteListAdditionalFare Nenka
6.2.2018 10.9 Úprava RegisterAdditionalFare Nenka
9.3.2018 11.0 Úprava GetCouponList Nenka
15.3.2018 11.1 Odbavení na BK v příměstě Nenka
5.4.2018 11.2 Úprava registrace karty bez Panmas Nenka
16.5.2018 11.3 Úprava odbavení ve městě Nenka
17.5.2018 11.4 Úprava odbavení jednotlivého jízdného v MHD Nenka
22.5.2018 11.5 Zapracování připomínek KODIS Nenka
22.5.2018 11.6 Zapracování připomínek A. Vídenkové Nenka
24.5.2018 11.7 Změna formátování Nenka
24.5.2018 11.8 Oprava gramatiky ve vývojových diagramech Nenka
31.10.2018 11.9 Dopracování kapitoly napojení na ČSOB Nenka
Doplnění nepřestupnosti u dokupované jízdenky
22.11.2018 12.0 Zapracování připomínek Mikroelektroniky do Nenka
kapitoly 4.14
6.2.2019 12.1 Oprava „s“ v departure-station-zone-numbers Nenka
Zapracování připomínek Mikroelektroniky Nenka
7.2.2019 12.2
5
24.9.2019 12.3 Přenesení 5.14 do Procesů Nenka
10.10.2019 Nenka
13.1.2020 12.4 Přenesení 5.14 do Procesů Nenka
20.2.2020 Nenka
12.5 Upřesnění jednotlivého jízdného v OV XXL
7.5.2020 Videnková
12.6 Doplnění taplistu
22.5.2020 Nenka
18.3.2020 12.7 Čas přestupu u XXL-NP, Úprava příkladů výpočtu, Nenka
22.3.2020 Nenka
Daňové doklady
12.8 Doplnění platnosti na sec. u 24 hod. kupónu na BK
12.9 Upřesnění definice Backoffice
13.0 Upřesnění zasílán dat pro dopravce s CheckIN/Out
1.2 Seznam použitých zkratek a pojmů
Pojem Popis
BČK Bezkontaktní čipová karta
DPO Dopravní podnik Ostrava, a. s.
Denylist Seznam bankovních karet, které jsou odmítnuté vydavatelem pro použití ve
veřejné dopravě DPO, nejde o “zakázané karty”, protože karty mohou
fungovat mimo veřejnou dopravu. Kontroluje se při registraci karty a
jiných operacích s ní např. prodeji kupónu.
DL Denylist
Taplist Slouží přepravní kontrole k informaci o přiloženích ve vozidle či soupravě.
Token Obsahuje otisk, linkospoj, čas přiložení, stav denylistu, výsledek přiložení a
BO status zobrazení
Šifrované číslo bankovní karty - “otisk karty”, kterým jsou v systému
nahrazována čísla bankovních karet.
Back-office dopravních dat na straně banky
BK Bankovní karta
OZ Odbavovací zařízení
CC MSK Clearingové centrum Moravskoslezského kraje
WL White list
panmas Prvních 6 a poslední 4 číska karty
ODA Off-line Data Authentication
White list karet/kuónů Seznam platných karet/kupónů
ČSOB Československá obchodní banka, a. s.
6
2 POPIS II. FÁZE PROJEKTU
Ve druhé fázi projektu Platby bankovní kartou v DPO bude řešeno:
• odbavení cestujícího na časový kupón registrovaný k bankovní kartě,
• odbavení spolucestujícícho na dokupované jízdenky bankovní kartou,
• zapojení příměstského dopravce do systému plateb jízdného bankovní kartou.
Časové kupóny bude možno zakoupit k bankovní kartě, kterou se bude cestující prokazovat jak při přepravní
kontrole, tak při nástupu předními dveřmi u řidiče. Bankovní karta tedy bude „nosičem“ časového kupónu, i
když časový kupón nebude přímo na bankovní kartě zapsán, ale bude k ní registrován v CC MSK.
Registrace časových kupónů k bankovní kartě bude možno provést pomocí webového rozhraní
komunikujícího s platební bránou ČSOB.
Registrované časové kupóny k bankovní kartě budou distribuovány do jednotlivých vozidel i do přenosných
zařízení revizorské kontroly pomocí tzv. whitelistů.
Dokupované jízdenky budou rovněž distribuovány prostřednictvím whitelistu, aby v případě přestupu bylo
možno vyhodnotit, zda má cestující zaplaceno dokupované jízdné či nikoliv.
Validátory ve vozidlech budou umožňovat cestujícímu, který zakoupil dokupované jízdné, platnosti jednotlivé
dokoupené jízdenky, a to jak přímo ve voze, kde byl dokup realizován, tak i při případném přestupu. V případě
check-in/out se informace o dokupu zobrazí automaticky. Informaci o dokupu půjde rovněž zjistit
v inforežimu terminálu. Validátor rovněž zobrazí případné kupony registrované k nosiči.
2.1 Základní atributy
• Dokupované přestupní jízdenky jsou v počátku zavedení pouze v síti DPO.
• Existuje limit na dokupované jízdné.
• Dokup je v režimu off-line, přičemž banka uhradí v rámci rizika maximálně denní částku 500,- Kč za
veškeré jízdné na každou použitou kartu v rámci dne.
• Přepravní kontrola ve vozidle bude „okamžitá“ přepravní kontrola.
• Informace o jízdách a reklamace kalkulovaného jízdného možné prostřednictvím www stránek
Koordinátora ODIS.
7
3 ZALOŽENÍ ÚČTU A REGISTRACE BANKOVNÍ KARTY
3.1 Založení účtu a registrace bankovní karty
Pro možnost využívání bankovní karty jako identifikátoru pro případný kupón musí držitel/cestující nejdříve
založit účet a provést registraci bankovní karty k danému účtu.
Založení účtu a registrace karty k tomuto účtu je možná dvěma způsoby:
• Pomocí internetového rozhraní karta.odiska.cz
• Na přepážce
Podmínkou založení účtu je email. Při registraci bankovní karty k tomuto účtu nebude v systému uloženo číslo
karty, ale pouze prvních 6 a poslední 4 čísla karty, expirace a token karty (token se generuje z vyčteného čísla
karty).
Registrace jedné bankovní karty bude možná jen k jednomu emailovému účtu. Pokud by chtěl držitel provést
registraci stejné karty k druhému účtu, bude držitel informován, že karta je již zaregistrována a je možné
provést převod karty k jinému účtu nebo odregistrování.
3.1.1 Založení účtu a registrace bankovní karty pomocí internetu
Současná registrace na karta.odiska.cz je provedena na email uživatele, tedy uživatel se zaregistruje pod svým
emailem, zvolí si heslo, zadá Captcha (ochrana proti robotickým registracím) a pak již může k tomuto
emailovému účtu přiřazovat karty.
Při přiřazení bankovní karty k emailovému účtu prostřednictvím internetového rozhraní, je provedena fiktivní
platba 1kč, která cestujícímu není účtována.
3.1.2 Založení účtu a registrace bankovní karty na přepážce
Na přepážce je možno zakládat účet a registrovat kartu pouze v případě, že tuto kartu držitel požaduje
používat pro přiřazení časového kupónu.
Registrační přepážka musí být vybavena čtečkou bankovních karet ČSOB, kterou si pořídí dopravce. Čtečka
bude provádět ODA a v případě úspěšné autentizace vracet token do aplikace registrační přepážky, odkud
bude zaslán na clearing.
Pro založení účtu a registraci bankovní karty na přepážce držitel předloží bankovní kartu, kterou chce
registrovat k danému účtu, fotografii, která bude naskenována a zavedena do systému. Dále držitel nahlásí
email, ke kterému chce založit účet a předloží požadované osobní údaje a doklad opravňující k případné slevě.
Po odeslání registrační zprávy bude na portále vygenerováno heslo k účtu a zasláno na uvedený email.
Registrace karty je možná také již k existujícímu emailovému účtu. Držitel v takovém případě na přepážce
zadá v žádosti o registraci emailový účet, ke kterému chce kartu registrovat. Pokud tento registrační emailový
účet bude existovat, karta se k tomuto emailovému účtu přiřadí. Na zadanou emailovou adresu se poté zašle
potvrzující email z portálu po obdržení registrační zprávy z přepážky.
V případě, že karta již je registrovaná, bude pracovník přepážky na tuto skutečnost systémem upozorněn. Na
základě požadavku cestujících pak pracovník přepážky může provést přeregistraci karty k novému účtu, čímž
zároveň dojde k odregistraci karty na účtu původním.
Registrovat je možné pouze bezkontaktní platební karty karetních asociací VISA a Mastercard.
Před založením účtu si pracovnice ověří, zda emailový účet již není registrován zavoláním funkce GetRegNo,
která, kromě čísla registrace vrátí také informace o existenci účtu a stavu registrace karty.
8
Registrovaným uživatelům se nebude ve výpisu jízd zobrazovat nástupní a výstupní zastávka, pouze čas, linka.
3.2 Převod karty na jiný účet
Převod karty na jiný účet provádíme:
• na registračním portálu karta.odiska.cz,
• na přepážce
Pokud účet neexistuje, založí se automaticky a uživateli bude zaslán email s heslem.
Při převodu karty na jiný účet bude s kartou převedena také celá její historie, včetně veškerých případných
zaregistrovaných osobních údajů a zakoupených kupónů.
3.2.1 Převod karty na registračním portálu
Po přihlášení na původní účet kde je karta registrovaná, vybere držitel kartu, kterou chce převést na nový
účet. Následně zadá nový emailový účet, na který chce kartu převést. V případě, že převáděná karta bude
zároveň registrovaná pro účely použití kupónu, tzn. bude obsahovat osobní údaje, bude při převodu použit
postup stejný jako při registraci dle bodu 3.1.1. tohoto dokumentu. Email se bude zadávat z důvodu eliminace
překlepů 2x a poté musí potvrdit převod na obrazovce.
3.2.2 Převod karty na přepážce
Na přepážce je možno převádět pouze kartu, která je zároveň přiřazena pro účely časového kupónu. Při
převodu karty na přepážce musí mít cestující s sebou kartu, kterou si přeje převést a dále doklad, kterým
bude prokazovat svou totožnost (např. OP). Dle tohoto dokladu bude obsluha kontrolovat registrované
osobní údaje k dané kartě. Převod karty na jiný účet se bude provádět na základě vyplněné žádosti, ve které
cestující vyplní údaje o převodu.
3.2.3 Rozhraní pro převod karty na jiný účet
Pro přenos informací o převodech karet na jiný účet definujeme 1 zprávu. Přehled definovaných zpráv:
Metoda Popis
MoveBankCard Převod karty na jiný účet
MoveBankCard Typ Popis Default Required?
String Uživatelský login provozovatele N/A Yes
Request String Uživatelské heslo provozovatele N/A Yes
Parametr String Token N/A Yes– není –li
UserLogin RegNo, jinak No
Password String Registrační číslo N/A Yes – není –li
Token Token, jinak No
String Uživatelský login nového účtu N/A Yes
RegNo
Typ Popis Default Required?
CardUserLogin N/A Yes
Int Stav zpracování
Response
Parametr
ResponseStatus
ErrorCode
9
ErrorMessage 0 – OK N/A Yes
Jinak číslo chyby
String Popis chyby
3.3 Odregistrování karty z účtu na přepážce
Odregistrování karty z účtu bude prováděno:
• Na registračním portále
• Na přepážce
Kartu bude možno odregistrovat pouze v případě, že již na kartě nejsou žádné platné ani budoucí platné
kupóny.
3.3.1 Rozhraní pro odregistrování karty z účtu prováděné na přepážce
Rozhraní pro odregistrování karty je popáno v kapitole 4.3.1 rozdíl v odregistování od účtu nebo pouze
v odregistrování pro použití časových kupónů určuje parametr CouponOnly.
4 ČASOVÝ KUPÓN REGISTROVANÝ K BANKOVNÍ KARTĚ
4.1 Přiřazení bankovní karty pro účely časového kupónu
Pro možnost využívání časového kupónu k bankovní kartě je nutné založení účtu a registrace dle bodu 3
tohoto dokumentu.
Následně bude možno vybranou bankovní kartu přiřadit pro možnost využívání jako identifikátor časového
kupónu.
Přiřazení bankovní karty k tomuto účelu bude možná dvěma způsoby:
• Pomocí internetového rozhraní v registrovaném účtu držitele na karta.odiska.cz
• Na přepážce
Držitel může mít přiřazenou pouze jednu vybranou bankovní kartu jako identifikátor časového kupónu.
V případě změny bankovní karty držitele jsou vždy identifikační údaje držitele včetně fotografie a kupónů
(současně a budoucích platných) převedeny na jinou kartu. Zároveň určená bankovní karta může být
přiřazena pouze pro jednoho konkrétního držitele.
Údaje o přiřazení bankovní karty pro využívání časového kupónu budou zaslány na CC MSK, který následně
tvoří whitelist těchto karet a vystavuje je pro distribuci do vozidel a zařízení přepravní kontroly.
Takto přiřazené bankovní karty budou umístěny a distribuovány v tzv. Whitelistu karet.
4.1.1 Přiřazení bankovní karty pro časový kupón v internetovém rozhraní
registrovaného účtu držitele
Pro přiřazení bankovní karty k možnosti využívání časového kupónu musí držitel ve svém účtu u dané karty
zatrhnout checkbox „používat pro časový kupón“ a následně vyplnit následující údaje:
10
• Jméno a příjmení
• Datum narození
• Expiraci karty
Dále přiloží fotografii, která musí být v poměru stran 4:3 a ve formátu JPG s takovým kompresním poměrem,
aby velikost nepřesáhla 16KB. Velikost bude systémem automaticky kontrolována a fotografie s větší velikostí
nebudou přijaty, menší velikosti jsou možné, pokud fotografie bude pro svou rozpoznatelnost schválena
v rámci schvalovacího procesu KODISu.
Při přiřazování karty v internetovém rozhraní bude automaticky zadán profil pouze občanský s platností max.
do uvedené Expirace karty. V případě držitelů karty, kteří mají nárok na slevněný profil, musí tito navštívit
přepážku, kde jim bude provedena změna profilu. Dokud nedojde k změně profilu, bude karta ve WL karet
distribuována s občanským profilem a cestujícímu nebude umožněno si zakoupit zvýhodněné jízdné. Při
změně profilu na přepážce bude také změněna jeho platnost (jedná-li se o profil s omezenou platností).
Po vyplnění a odeslání všech údajů bude registrace ve stavu „čekající na potvrzení“. Potvrzením je myšlena
kontrola fotografie administrátorem KODIS, který, pokud zjistí jinou fotografii, než podobu obličeje, registraci
zamítne. Administrátor bude kontrolovat fotografie v nově dodaném rozhraní na karta.odiska.cz.
Na závěr registrace obdrží cestující e-mailem potvrzení o registraci s kódem (číslem registrace), na jehož
základě lze v budoucnu kartu na přepážce zablokovat nebo provést na přepážce převod identifikačních údajů
z dané bankovní karty na jinou bankonví kartu, a to v případě ztráty původní karty, kterou cestující při
převodu již nemá k dispozici.
V případě, že karta byla registrována v počátcích spuštění projektu, kdy ještě v rámci registrace nebylo možno
získat Panmas, objeví se držiteli karty, při pokusu o registraci takovéto karty pro časový kupón, tato zpráva:
„Karta nemá dostatek informací pro registrování k dlouhodobým jízdenkám a musí projít registrací znovu.
Klikněte na tlačítko níže pro znovuzaregistrování bankovní karty přes platební bránu.“
Po dokončení fiktivní platby 1Kč, se v případě úspěšné registrace, ukáže formulář pro registrování
k dlouhodobým jízdenkám, v případě neúspěšné registrace bude uživatel přesměrován na stránku „Moje
karty“ kde uvidí i chybovou zprávu.
4.1.2 Přiřazení bankovní karty pro časový kupón na přepážce
Přiřazení bankovní karty pro možnost využívání časového kupónu na přepážce probíhá již při založení účtu a
registraci karty na přepážce dle bodu 4.1.2 tohoto dokumentu.
Pro přiřazení bankovní karty k možnosti využívání časového kupónu musí držitel předložit:
• Konkrétní bankovní kartu
• Fotografii
• Jméno a příjmení
• Datum narození
• V případě slevy - doklad opravňující ke slevě
Při přiřazení bankovní karty na přepážce mohou být zároveň zadány jakékoli profily, tzn. i slevové, jelikož
pracovnice přepážky může ihned ověřit nárok na slevu a nastavit její dobu platnosti. Pracovník přepážky také
provede okamžitou kontrolu fotografie, takovéto přiřazení nepodléhá potvrzení KODIS.
Držitel v případě registrace na přepážce dostane potvrzení o registraci s kódem (číslem registrace), na jehož
základě lze v budoucnu kartu na přepážce zablokovat nebo provést převod identifikačních údajů z dané
bankovní karty na jinou bankonví kartu, a to v případě ztráty původní karty, kterou cestující při převodu již
nemá k dispozici.
11
V systému bude rozpoznáváno, pouze v rámci jednoho účtu, že každá registrovaná karta je na jiné jméno,
příjmení a datum narození. Mezi účty nebo na přepážce nebude tato kontrola prováděna, ale podmínka jedné
platné karty registrované pro časové kupóny bude zahrnuta v Tarifu.
Na přepážce bude možné přiřadit využívání časového kuponu na již registrovanou kartu. Platí pro toto
stejné podmínky jako v bodu 5.2.2.
4.2 Převod bankovní karty určené pro použití časových kupónů
V případě ztráty bankovní karty nebo v případě její expirace musí být cestujícímu umožněno převést
registrované údaje k této kartě včetně zakoupených časových kupónů na jinou kartu registrovanou k témuž
účtu.
Převod se provádí na kartu, která je již v systému zaregistrovaná.
Převod je možný:
• na registračním portálu karta.odiska.cz,
• na přepážce - přepážka provede na svém vlastním SW a poté zašle výsledek na CC MSK
v definovaném formátu XML.
4.2.1 Převod v internetovém rozhraní v registrovaném účtu držitele
V internetovém portálu musí cestující znát přihlašovací údaje k účtu, na němž je karta registrovaná, ale pro
uskutečnění převodu již nemusí mít kartu k dispozici (pro případ ztráty), nebude muset zadávat (kód, který
obdržel při registraci) nebo jakýkoliv jiný údaj z karty kromě data expirace karty, z níž hodlá převod převést.
Pro převod vybere cestující na portále kartu, ze které si přeje údaje přenést a poté kartu, na kterou si přeje
převod provést.
Po požadavku bude převedeno:
• Jméno a příjmení držitele
• Fotografie
• Profily
• Datum narození
• Všechny současně nebo budoucí platné kupóny
4.2.2 Převod na přepážce
Základní předpoklad pro převod na přepážce je, že cestující musí předložit kartu, na kterou si přeje převod
uskutečnit, původní kartu nebo v případě její ztráty kód/číslo registrace, a doklad totožnosti, kterým potvrdí
registrované osobní údaje na původní kartě.
Po odeslání převodu se vrtátí informace zda byl proveden nebo zda karta nebyla registrována pro kupóny či
jiný důvod neprovedení převodu.
• Pokud je zaregistrována a má příznak použití pro kupóny, nelze na tuto kartu převod provést.
• Pokud je zaregistrována a nemá příznak použití pro kupóny, lze převod provést.
• Pokud není zaregistrována, musí obsluha nejdříve provést registraci karty dle bodu 3.1.2 tohoto
dokumentu.
12
4.2.3 Rozhraní pro převod provedený na přepážce
Pro přenos informací o převodech kupónu ze staré karty na novou definujeme 1 zprávu. Přehled
definovaných zpráv:
Metoda Popis
MoveBankCardCoupon Převod kupónu ze staré karty na novou kartu
MoveBankCardCoupon
Request Typ Popis Default Required?
Parametr String Uživatelský login provozovatele N/A Yes
UserLogin String Uživatelské heslo provozovatele N/A Yes
Password String Token staré karty N/A Yes – není-
TokenOld
li
RegNoOld String Číslo registrace staré karty vyplněno
RegNoOld,
TokenNew String Token nové karty jinak No
Response N/A Yes – není-
Typ Popis li
Parametr vyplněno
ResponseStatus Int Stav zpracování TokenOld,
ErrorCode jinak No
0 – OK N/A Yes
ErrorMessage
String Jinak číslo chyby - samostatné číslo pro Default Required?
nezaregistrovanou kartu
Popis chyby N/A Yes
N/A Yes
4.3 Odregistrovaní přiřazení bankovní karty pro použití kupónů
Odregistrování přiřazení bankovní karty pro použití kupónu se provádí formou „odregistrace přiřazení karty“.
Karta bude odstraněna z WL karet a nebude možno na ni zakoupit kupón ani se na kupón odbavit.
Při odregistraci budou současně odstraněny z WL kupónů také všechny kupóny registrované k dané kartě.
Pokud budou ke kartě zakoupeny platné nebo budoucí platné kupóny, nelze přiřazení karty ke kupónu
odregistrovat. Držitel musí buď provést převod dle bodu 4.2 tohoto dokumentu, nebo si kupóny nechat
vyplatit.
V případě ztráty bankovní karty může cestující, kromě povinného oznámení bance, provést odregistrování
své karty pro použití v ODIS dle výše uvedených podmínek, není však podmínkou. Pokud cestující neprovede
13
odregistraci, ale pouze provede převod jinou kartu, neutrpí neprovedením odregistrace žádnou újmu,
protože v případě použití v systému variable fare bude zablokována automaticky po prvém použití.
Pokud cestující uplatnil blokaci u vydavatele a v případě časového kupónu na kartě, může cestující sám
provést převod na jinou kartu pomocí internetového rozhraní nebo na přepážce dle podmínek převodu
uvedených v bodě 5.2 tohoto dokumentu.
Odregistrování karty pro použití kupónů je možné:
• na registračním portálu karta.odiska.cz,
• na přepážce prostřednictím SW přepážky, který pak zašle na CCMSK XML zprávu
o odregistrování karty.
Při odregistrování na přepážce musí mít cestující s sebou buď kartu, kterou si přeje odregistrovat nebo
potvrzení o registraci karty s uvedeným kódem/číslem registrace a prokázat se platným osobním dokladem.
4.3.1 Rozhraní pro odregistrování karty
Pro přenos informací o odregistrování bankovní karty definujeme 1 zprávu. Přehled definovaných zpráv:
Metoda Popis
UnregisterBankCard Odregistrování bankovní karty z clearingového centra
UnregisterBankCard
Request Typ Popis Default Required?
Parametr String Uživatelský login provozovatele N/A Yes
UserLogin String Uživatelské heslo provozovatele N/A Yes
Password String Token N/A Yes – není –li
Token jinak No
String Registrační číslo N/A Yes – není –li
RegNo Token, jinak No
Datetime Datum a čas odregistrace bankovní N/A Yes
Date karty
Yes
CouponOnly Bool Odregistrovat pouze pro povolení N/A
Response pořízení nákupu kupónů
Parametr
ResponseStatus Typ Popis Default Required?
ErrorCode N/A Yes
Int Stav zpracování
0 – OK
ErrorMessage Jinak číslo chyby N/A Yes
String Popis chyby
4.3.2 Funkce pro ověření zda BK již byla registrována
GetBankCardStatus
14
Request Typ Popis Default Required?
Parametr String
UserLogin Uživatelský login N/A Yes
Password String provozovatele
Token N/A Yes
String Uživatelské heslo
Response provozovatele N/A Yes
Parametr
BankCardStatus Token bankovní karty
ResponseStatus Typ Popis Default Required?
ErrorCode REGISTERED - karta již byla zaregistrovaná N/A No
Int
ErrorMessage String a aktuálně je platná (není registrována
pro použití kupónů)
REGISTERED_Coupon - karta již byla
zaregistrovaná pro použití kupónů a
aktuálně je platná
BLOCKED – karta již byla zaregistrovaná a
aktuálně je blokovaná
UNREGISTERED – karta již byla
zaregistrovaná, ale aktuálně je
odregistrovaná- zaregistrovat v tomto
případě.
NOT_REGISTERED – karta ještě nebyla
zaregistrovaná - zaregistrovat v tomto
případě.
EXPIRED – karta je expirovaná
UNKNOWN – neznámý stav karty
Stav zpracování N/A Yes
0 – OK
Jinak číslo chyby N/A Yes
Popis chyby
4.3.3 Zasílání dat o registraci karty a distribuce White Listu bankovních karet
Při registraci bankovní karty, budou na clearing zaslána tato data:
• Token
• Panmas (prvních 6 a poslední 4 čísla karty)
• Jméno a příjmení
• Datum narození
• E-mail
• Expiraci karty
• Profil 1 + jeho platnost od - do,
• Profil 2 + jeho platnost od - do
15
• Fotografie
• Číslo registrace ( RegNo )
Po obdržení dat o registraci karty bude karta ihned umístěna do WL bankovních karet, který si mohou
stahovat jak revizorská zařízení, tak palubní počítač.
Pro přenos informací o registraci bankovní karty a distribuci white listu bankovních karet definujeme 2
zprávy. Přehled definovaných zpráv:
Metoda Popis
RegisterBankCard Zavedení bankovní karty do clearingového centra
GetWhiteListBankCard Vrátí seznam bankovních karet na WhiteListu
RegisterBankCard
Request Typ Popis Default Required?
Parametr String Uživatelský login provozovatele N/A Yes
UserLogin String Uživatelské heslo provozovatele N/A Yes
Password bool Zavedení bankovní karty jako potvrzené N/A Yes
Confirmed (true=přepážka)
String
BankCard String Token bankovní karty N/A Yes
Token String
RegNo String Číslo registrace N/A Yes
PanMas Datetime
NameSurname String Prvních 6 a poslední 4 čísla bankovní karty N/A Yes
BirthDate Datetime
Email Short Jméno a příjmení držitele bankovní karty N/A Yes
CardExpiration Datetime
Profile1 Datum narození držitele bankovní karty N/A Yes
Profile1ValidFrom Datetime
E-mailová adresa N/A Yes
Profile1ValidTo Short
Datetime Expirace bankovní karty N/A Yes
Profile2
Profile2ValidFrom Datetime První profil držitele bankovní karty N/A Yes
Profile2ValidTo Base64 Platnost prvního profilu od držitele N/A Yes
Photo bankovní karty N/A Yes
Platnost prvního profilu do držitele
bankovní karty N/A No
Druhý profil držitele bankovní karty N/A No
Platnost druhého profilu od držitele
bankovní karty N/A No
Platnost druhého profilu do držitele
bankovní karty N/A Yes
Fotografie držitele bankovní karty
Response
Parametr Typ Popis Default Required?
N/A Yes
ResponseStatus
ErrorCode Int Stav zpracování
16
ErrorMessage 0 – OK N/A Yes
Jinak číslo chyby
String Popis chyby
GetWhiteListBankCard
Request Typ Popis Default Required?
Parametr String Uživatelský login N/A Yes
UserLogin String provozovatele N/A Yes
Uživatelské heslo N/A Yes
Password Int provozovatele N/A No
Bool Typ WhiteListu (celý, N/A No
WhiteListType Bool inkrementální) N/A No
Počáteční pořadové číslo
SequenceNoStart WhiteListu
Příznak, zda zasílat karty pouze
DiscountedProfileOnly se zlevněným profilem
Příznak, zda zasílat karty
PhotoData včetně dat fotografie
(true=včetně fotografie)
Response
Parametr Typ Popis Default Required?
WhiteListBankCard Verze souboru N/A No
Datum vytvoření dávky N/A No
WhiteListBankCardHeader Pořadové číslo N/A No
Typ WhiteListu (FULL - celý, INC - N/A No
FileVersion String inkrementální)
Počet karet N/A No
IssueDateTime Datetime Příznak, zdali došlo k resetu WhiteListu N/A No
SequenceNo Int Token bankovní karty N/A Yes
Číslo registrace N/A Yes
WhiteListType Jméno a příjmení držitele bankovní karty N/A Yes
Datum narození držitele bankovní karty N/A Yes
ItemsCount Int E-mailová adresa N/A Yes
Expirace bankovní karty N/A Yes
Reset Bool První profil držitele bankovní karty N/A Yes
Platnost prvního profilu od držitele N/A Yes
WhiteListBankCardItem bankovní karty
Platnost prvního profilu do držitele N/A Yes
Token String bankovní karty
Druhý profil držitele bankovní karty N/A No
RegNo String Platnost druhého profilu od držitele N/A No
bankovní karty
NameSurname String Platnost druhého profilu do držitele N/A No
bankovní karty
BirthDate Datetime
Email String
CardExpiration Datetime
Profile1 Short
Profile1ValidFrom Datetime
Profile1ValidTo Datetime
Profile2 Short
Profile2ValidFrom Datetime
Profile2ValidTo Datetime
17
Photo Base64 Fotografie držitele bankovní karty N/A Yes
StateCode ADD, DEL (přidání nebo odebrání BK) N/A Yes - pouze
ResponseStatus Int Stav zpracování pro
ErrorCode String inkrementální
0 – OK WL
ErrorMessage N/A Yes
Jinak číslo chyby
Popis chyby N/A Yes
4.4 Distribuce fotografií do PP a revizorských zařízení
Fotografie se budou distribuovat prostřednictvím WL karet, jehož součástí je fotografie držitele. Tyto
údaje se budou vždy stahovat z CC MSK a mohou se distribuovat do PP a revizorských zařízení těmito
způsoby:
• Kompletní, tedy celý soubor WL karet
o Pomocí Wi-fi.
o Pomocí přenosového media (Flash, SD karta).
• Přírustkový, tedy pouze změnový WL karet
o Pomocí Wi-fi
o Pomocí internetového připojení prostřednictvím SIM karty
Distribuce WL karet bude probíhat stejným způsobem jako ostatních „listů“ tedy zařízení provede žádost na
CCMSK a formou odpovědi obdrží WL formou XML. Synchronizace WL karet je prováděna pořadovým číslem.
Pokud zařízení požaduje stáhnout přírustkový WL karet zašle v žádosti poslední pořadové číslo, které má
k dispozici. WL karet je zařízení povinno stahovat alespoň jednou denně.
4.5 Pořízení časového kupónu k bankovní kartě
Časový kupón je možno na bankovní kartu pořídit:
• Na e-shopu (zde bude existovat možnost prokliku na rozhraní karta.odiska.cz).
• Na přepážce.
Při nákupu časového kupónu na přepážce, musí cestující přiložit bankovní kartu na čtečku bankovních karet
pro získání tokenu. Samotná platba nemusí být provedena touto kartou, ale i například hotovostí.
Transakce za takto nakoupené časové kupóny budou zaslány na CC MSK ve větě KODIS. CC MSK následně
tvoří white list kupónů, který bude vystavovat pro distribuci do vozidel a revizorských zařízení.
Při pořizování časového kupónu bude uživateli na e-shopu nebo v přepážkovém SW prodavačce zobrazeny
platné kupóny registrované k dané kartě dotazem na CCMSK.
Prodej kupónů se řídí tarifem ODIS. V případě prvotního spuštění použití kupónů, bude možno na bankovní
kartu zakoupit kupóny pouze na zóny, které obhospodařuje Dopravní podnik Ostrava.
18
4.5.1 Zasílání dat o zakoupeném kupónu k bankovní kartě
Zasílání dat o zakoupeném kupónu k bankovní kartě bude probíhat standardně na clearingové centrum
MSK ve formátu věty KODIS.
Příklady transakcí:
1. Prodej dlouhodobého jízdného na bankovní kartu, placeno hotově (student 15-26, 90 denní, zóna
30)
<transaction transtype="mhdp" amount-type="cash" type="pay" amount="276.00" when="2015-11-
02T12:00:00" tx-id="1" person-type="3" tariff="17" tariff-type="JD" line="880000" sequence="1"
currency="CZK" zone="30" valid-from="2015-11-02T12:00:00" valid-to="2016-02-02T12:00:00" card-emv-
token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967" />
2. Prodej dlouhodobého jízdného na bankovní kartu, placeno bankovní kartou (student 15-26, 90
denní, zóna 30 + 45)
<transaction transtype="mhdp" amount-type="card" type="pay" amount="476.00" when="2015-11-
02T12:00:00" tx-id="1" person-type="3" tariff="17" tariff-type="JD" line="880000" sequence="1"
currency="CZK" zone="30;45" valid-from="2015-11-02T12:00:00" valid-to="2016-02-02T12:00:00" card-
emv-token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967" />
3. Jízda na dlouhodobý kupón zakoupený na bankovní kartu (student 15-26, 90 denní, zóna 30 + 45)
<transaction transtype="mhd" amount-type="prepaid" type="pay" amount="0.00" when="2015-11-
02T12:00:00" tx-id="1" person-type="3" tariff="17" tariff-type="PP" line="880000" sequence="1"
currency="CZK" zones="30;45" departure-id="130000" arrival-id="140000" transfer-time="2015-11-
02T12:45:00" card-emv-
token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967" />
4.6 Storno kupónu
Stornem kupónu je myšleno okamžité vrácení celé částky za kupón v případě, že byl chybně zakoupen na
přepážce. Cestujícímu se vrací celá částka.
Storno kupónu bude možné provádět pouze na přepážce, pokud jde o kupóny zakoupené na přepážce, kdy
přepážka vrací buď hotovost, nebo provádí při platbě na platebním terminálu, tzv. reverzal okamžité storno.
Storno na směně (konkrétní prodavačky) je možné v případě storna kuponu a vystavení nového ve stejné
ceně, např. se změní datum. Storno provádí stejná prodavačka, která vystavila prvotní kupon.
V případě kupónů zakoupených na e-shopu se vždy storno provádí formou vrácení kupónu na přepážce. Není-
li kupón zakoupený na e-shopu zaplacen do půlnoci dne nákupu, bude automaticky objednávka zrušena.
Informace o provedení storna se zasílá funkcí:
Pro přenos informací o stornu kupónu definujeme 1 zprávu. Přehled definovaných zpráv:
Metoda Popis
CancellBankCardCoupon Storno kupónu
CancellBankCardCoupon
19
Request Typ Popis Default Required?
Parametr String Uživatelský login provozovatele N/A Yes
UserLogin String Uživatelské heslo provozovatele N/A Yes
Password String Token karty N/A Yes – není-
Token li
N/A
RegNo String Číslo registrace vyplněno
RegNo,
jinak No
Yes – není-
li
vyplněno
Token,
jinak No
BankCardCouponCancell Short Profil zákazníka – identifikace kupónu N/A Yes
CustomerProfile Short N/A Yes
TariffProfile Datetime Tarifní profil – identifikace kupónu N/A Yes
ValidFrom Datetime Platnost od – identifikace kupónu N/A Yes
ValidTo String Platnost do – identifikace kupónu N/A Yes
Zone
Seznam zón oddělených středníkem
Response
Parametr Typ Popis Default Required?
N/A Yes
ResponseStatus
ErrorCode Int Stav zpracování
0 – OK
ErrorMessage Jinak číslo chyby N/A Yes
String Popis chyby
4.7 Vrácení kupónu
Vrácení kupónů může být prováděno i v případě, kdy časový kupón byl již částečně využit, nebo nenabyl
časové platnosti, avšak byl již překročen čas určený pro „okamžité storno“. V případě vrácení kupónu, který
je již platný, se cestujícímu vrací alikvotní částka dle doby zbývající do konce platnosti. Vrácením kupónu je
tedy myšleno i vrácení části kupónu.
Vrácení kupónu:
• Na e-shopu nebude prováděno.
• Na přepážce – přepážka vrací hotovost. Přepážkou se v tomto případě myslí Specializované
pracoviště ODISka – bankovní karta. Kupón bude z WL kupónů odstraněn ihned po zaslání zprávy
do CC MSK. Zpráva do CC MSK se zasílá funkcí:
Pro přenos informací o vrácení kupónu definujeme 1 zprávu. Přehled definovaných zpráv:
Metoda Popis
20
ReturnBankCardCoupon Vrácení kupónu
ReturnBankCardCoupon
Request Typ Popis Default Required?
Parametr String Uživatelský login provozovatele N/A Yes
UserLogin String Uživatelské heslo provozovatele N/A Yes
Password String Token karty N/A Yes – není-
Token li
N/A
RegNo String Číslo registrace vyplněno
RegNo,
jinak No
Yes – není-
li
vyplněno
Token,
jinak No
BankCardCouponReturn
CustomerProfile Short Profil zákazníka – identifikace kupónu N/A Yes
Tarifní profil – identifikace kupónu N/A Yes
TariffProfile Short Platnost od – identifikace kupónu N/A Yes
Platnost do – identifikace kupónu N/A Yes
ValidFrom Datetime Seznam zón oddělených středníkem N/A Yes
Vrácená částka (celá, poměrná) N/A Yes
ValidTo Datetime
Zone String
Amount Decimal
Response
Parametr Typ Popis Default Required?
N/A Yes
ResponseStatus
ErrorCode Int Stav zpracování
0 – OK
ErrorMessage Jinak číslo chyby N/A Yes
String Popis chyby
Pro službu vrácení kuponu je nutné předložit kartu, ke které byl kupon vydán spolu s osobním dokladem.
4.8 Blokace a odblokace bankovní karty pro použití kupónu
Blokace karty, na rozdíl od odregistrace, ponechá kartu u účtu a v budoucnu umožní převod kupónu a dat na
jinou kartu. Zablokovaná karta bude odstraněna z WL karet a všechny její kupóny budou také odstraněny
z WL kupónu, ale cestující může později přistoupit k převodu těchto kupónů na novou kartu.
Blokace bankovní karty pro použití kupónů se provádí v případě, kdy cestující zjistil ztrátu nebo krádež karty
a nemá k dispozici druhou bankovní kartu.
Blokace karty pro použití kupónů je možné:
• na registračním portálu karta.odiska.cz,
21
• na přepážce.
Při blokaci na přepážce musí mít cestující s sebou potvrzení o registraci karty s uvedeným kódem/číslem
registrace nebo kartou, kterou si přeje zablokovat a prokázat se platným osobním dokladem.
Při odblokaci na přepážce musí mít cestující s sebou kartu, kterou si přeje odblokovat.
4.8.1 Rozhraní pro blokaci karty na přepážce
Pro přenos informací o blokacích karet definujeme 1 zprávu. Přehled definovaných zpráv:
Metoda Popis
BlockBankCard Blokace bankovní karty
BlockBankCard Typ Popis Default Required?
Request String Uživatelský login provozovatele N/A Yes
String Uživatelské heslo provozovatele N/A Yes
Parametr String Token N/A Yes– není –li
UserLogin RegNo, jinak
Password String Registrační číslo N/A No
Token Yes – není –
Datetime Datum a čas blokace bankovní karty N/A li Token,
RegNo jinak No
Yes
Date
Response Typ Popis Default Required?
N/A Yes
Parametr Int Stav zpracování
ResponseStatus N/A Yes
ErrorCode 0 – OK
ErrorMessage Jinak číslo chyby
String Popis chyby
4.8.2 Rozhraní pro odblokaci karty na přepážce
Pro přenos informací o odblokacích karet definujeme 1 zprávu. Přehled definovaných zpráv:
Metoda Popis
UnblockBankCard Odblokace bankovní karty
UnblockBankCard Typ Popis Default Required?
String Uživatelský login provozovatele
Request N/A Yes
Parametr
UserLogin
22
Password String Uživatelské heslo provozovatele N/A Yes
Token String Token
N/A Yes– není –li
RegNo
RegNo, jinak
Date
No
Response
Parametr String Registrační číslo N/A Yes – není –
ResponseStatus
ErrorCode li Token,
ErrorMessage jinak No
Datetime Datum a čas odblokace bankovní N/A Yes
karty
Typ Popis Default Required?
N/A Yes
Int Stav zpracování
0 – OK
Jinak číslo chyby N/A Yes
String Popis chyby
4.9 Odbavení cestujícího s časovým kupónem na bankovní kartě
Cestující s časovým kupónem registrovaným ke kartě bude kontrolován třemi způsoby:
• Přiložením karty ke čtečce u řidiče (v DPO v případě nástupu předními dveřmi).
• Přiložením karty k čtecímu zařízení přepravní kontroly.
• Prostřednictvím odbavovacího terminálu v režimu přepravní kontroly.
Bylo zvoleno tzv. „smart“ řešení, kdy DL ponese informaci, že karta má registrován kupón (pouze
v případě, že karta je na DL, v opačném případě zde tato informace nebude). Pokud by validátor
zjistil kartu, která je na DL a má registrován kupón, vyhledá ve WL, na jaké zóny daný kupón je a
pokud se jedná o platnou zónu, ve které se cestující nachází, kartu odbaví. (Zóna se mění otevřením
dveří na hraniční zastávce). V případě odbavení v PAD postupuje zařízení podobně jako u odbavení
ODISky. Tzn. uzná platné zóny na trase a spočítá cenu pro zbytek nepokryté trasy. Blíže pak
v dokumentu „Procesy MSK“.
Revizorské zařízení bude pravidelně aktualizovat WL kupónů (tuto aktualizaci může provést i během
kontroly ve vozidle) a po přiložení bankovní karty zařízení vyhledá podle tokenu ve WL kupónů
příslušné kupóny k registrované kartě.
Při přiložení karty s platným kupónem na danou zónu bude odeslána na CC MSK v rámci tapu
informace o uznané zóně. Na závěr dopravního dne se provede v CC MSK zúčtování tapů a zjištění,
které tapy měly na danou zónu kupón a pokud kupón na danou zónu na kartě nebyl, provede se
stržení částky za jednotlivé jízdné.
Pokud linka vede přes více zón a cestující bude mít časový kupón např. jen na jednu zónu, bude mít
povinnost provést přiložení karty pro check-in v zastávce, kde mu končí časový kupón, a to po
otevření dveří v této zastávce. Tedy provést standardní odbavení bankovní kartou, jako cestující bez
časového kupónu i v případě, že je stále ve stejném vozidle (nebo může zvolit jiný způsob odbavení
např. ODISkou z EP). Tato povinnost bude zakotvena v přepravních podmínkách.
23
Cestující po check-in bude mít na terminálu automaticky informaci, na co se přepravuje
(kupón/jednotlivá jízdenka). Stejně tak tuto informaci bude vidět řidič na PS při nástupu předními
dveřmi. Cestující pak bude mít možnost kdykoliv zobrazit v inforežimu na terminálu informaci o
kupónu (např. doba platnosti, zónová platnost…).
4.10 Proces odbavení cestujícího v oblasti Město, mimo Ostrava XXL na
bankovní kartu
Proces odbavení cestujícího v malém MHD na bankovní kartu je popsán v dokumentu „Procesy
MSK“. Odbavení na jednotlivé jízdné za použití slevových profilů nebo uznávání jízdy na kupón
(dlouhodobé jízdné) bude spuštěno ode dne vyhlášení
4.11 Proces odbavení cestujícího ve vozidle dopravce mimo DPO pro oblast
Ostrava XXL na bankovní kartu
Proces odbavení cestujícího ve velkém MHD na bankovní kartu je popsán v dokumentu „Procesy
MSK“. Odbavení na jednotlivé jízdné za použití slevových profilů nebo uznávání jízdy na kupón
(dlouhodobé jízdné) bude spuštěno ode dne vyhlášení
4.12 Proces odbavení cestujícího v Regionu na bankovní kartu
Proces odbavení cestujícího v Regionu na bankovní kartu je popsán v dokumentu „Procesy MSK“.
Pokud cestující bude mít uznaný kupón na část trasy a bude provádět doplatek v hotovosti, bude
v dopravních datech zasílaných prostřednictvím ČSOB uvedena jízda na kupón, ale v položce non-
bank-amount bude zaslána informace o výši doplatku provedeného nebankovní kartou. Při vyčítání
strojků pak budou na CC MSK zaslány 2 transakce, jednak transakce o odbavení na BK, která již byla
zaslána dříve prostřednictvím ČSOB a druhá transakce o jízdě za hotovost nebo EP.
V první fázi odbavení v Regionu na bankovní kartu bude spuštěn pouze odbavení na jednotlivé
jízdné, a to pouze za plné jízdné (CP, TP = 1).
Odbavení v Regionu na jednotlivé jízdné za použití slevových profilů nebo uznávání jízdy na kupón
(dlouhodobé jízdné) bude spuštěno ode dne vyhlášení.
24
4.13 Proces odbavení cestujícího ve vozidlech s nástupem všemi dveřmi
(např. DPO) s časovým kupónem na bankovní kartě
Proces odbavení cestujícího ve vozidlech DPO pro oblast OV XXL a XXL (353) s časovým kupónem na
bankovní kartě je popsán v dokumentu „Procesy MSK“.
Odbavení na jednotlivé jízdné za použití slevových profilů bude spuštěno ode dne vyhlášení.
25
4.14 Diagram procesu odbavení cestujícího v Regionu na bankovní kartu
Diagram procesu včetně poznámek je uveden v dokumentu Procesy MSK verze 7.4 a vyšší.
4.15 Diagram procesu odbavení cestujícího ve vozidle dopravce mimo DPO
pro oblast Město, Ostrava XXL nebo XXL na bankovní kartu
Proces odbavení jízdenky MĚSTO nebo „check-in“ pro Ostrava XXL nebo XXL (zóna 353) cestujícího
ve vozidle PAD je popsán v dokumentu „Procesy MSK“.
4.16 Napojení dopravců na ČSOB
Dopravci akceptující bankovní karty v systému CC MSK musí, z důvodu jednotné tokenizace a zúčtování,
používat platební terminály společnosti ČSOB.
Propojení platebního terminálu s odbavovacím zařízením a zavedení systému bude probíhat v těchto krocích.
1. Kontaktovat (mail: se kterým se dopravce dohodne na dalším
postupu a který zodpoví případné dotazy ve vztahu k ČSOB.
2. Dopravce podepíše s ČSOB NDA, na jehož základě obdrží dokumentaci k rozhraní, prostřednictvím
kterého bude s ČSOB komunikovat.
3. ČSOB vyvine pro platební terminál, který dopravce využívá ve svém odbavovacím zařízení pro
akceptaci bankovních karet, software, který bude umožňovat práci s BK v podmínkách CC MSK
(jednotná tokenizace). Úprava tohoto SW bankovního terminálu je pro dopravce zdarma. Pro tento
účet dopravce sdělí ČSOB níže uvedené informace:
• Jaké má odbavovací zařízení typ terminálu(ů)?
• Jaká je použitá komunikační sběrnice mezi terminálem a odbavovacím zařízením?
• Jaké jsou typy akceptovaných karet (vyjma Visa a MC)?
• Jakým způsobem probíhá na terminálu odbavení ODIS karty?
• Dokáže odbavovací zařízení zajistit konektivitu platebnímu terminálu? Jakým způsobem?
• Umožní odbavovací zařízení vytvoření FTP prostoru?
• V jakém formátu se předávají dopravní data (spoje, linky, zastávky,...) z odbavovacího
zařízení do terminálu?
4. Dopravce uzavře s ČSOB smlouvu o akceptaci platebních karet. Smlouva se uzavírá na pobočce ČSOB.
26
5. Dopravce uzavře s ČSOB smlouvu o ochraně platebního terminálu (upravuje podmínky a pravidla pro
zajištění fyzické bezpečnosti platebních terminálů).
6. ČSOB provede certifikaci, která je podmínkou pro spuštění řešení do ostrého provozu. Pro certifikaci
je potřeba doručit zařízení na ČSOB do Prahy. Certifikaci provádí firma Banit.
7. Před nasazením všech terminálů do provozu, bude potřeba provést naklíčování terminálů a nahrání
aplikace. Tato činnost se provádí v zabezpečeném prostředí ČSOB, kde budou muset být všechny
terminály dopraveny. Dopravce tedy musí zajistit dopravu veškerých terminálů do Prahy.
27
4.17 DOKUPOVANÉ JÍZDNÉ CC MSK
4.18 V DPO
Banka
7
5 Revizor
3
6 3
2 8 8
Linka 2
Linka 1
Nástup
1 Výstpu 4
Nástup
Kontrola
Přestup
(1) Cestující nastoupí do vozidla, může provést vlastní odbavení - tap, ale není podmínkou, a
poté na validátoru navolí dokupované jízdné. Volbu dokupovaného jízdného může cestující
provést kdykoliv na trase, pokud dokupované osoby k cestujícímu přistoupí. Cestující může
během cesty zkontrolovat na validátoru v inforežimu dobu platnosti dokupovaných jízdenek,
a to za každý dokup samostatně do kdy platí (4 pozice). Tuto kontrolu může provést také
v režimu revizorské kontroly. Zařízení upozorní cestujícího, že „tato karta“ nebyla odbavena.
(2) Validátor ihned zašle informaci o dokupu na CC MSK. Toto duplicitní zaslání provádí z důvodu
co možná nejrychlejšího přenosu informace do WL dokupů, protože na standardní cestě
zasílání tapů dochází až k pětiminutovému zdržení na serveru banky.
(3) CC MSK ihned po obdržení informace o dokupu vytvoří nový WL dokupovaných jízdenek a
vystaví jej pro stažení ostatním vozidlům.
(4) Při přestupu cestující provede pouze tap (nemá-li časový kupón), přičemž se mu zobrazí info,
že karta je evidována a informace o počtu dokupovaných jízdenek, nemusí nic dalšího
28
v souvislosti s dokupy provádět. Ve vozidle si může i po přestupu kdykoliv na validátoru v
inforežimu zkontrolovat dobu platnosti dokupovaných jízdenek, protože vozidlo již obdrží
nový WL dokupovaných jízdenek. Pokud by při nástupu přednímu dveřmi ještě nebyl ve
vozidle aktualizován WL dokupovaných jízdenek, může řidič tuto aktualizaci provést
z palubního počítače.
(5) Revizor při započetí kontroly přiloží revizorskou kartu validátoru. Na tuto revizorskou kartu
se nahraje taplist vozidla, který bude obsahovat také WL dokupovaných jízdenek, které byly
pořízeny do 5 minut před tímto přiložením karty revizora, následně se automaticky stáhne
aktuální WL dokupovaných jízdenek z CC MSK. Tento mechanismus zajistí aktuální WL
dokupů pro revizora a zároveň nebude příliš omezovat datový prostor karty určený pro tapy.
Osoby cestující na dokupované jízdné musí cestovat vždy spolu s držitelem bankovní karty,
na kterou byly dokupované jízdenky pořízeny.
(6) Informace o dokupovaných jízdenkách se také zašle standardní cestou na banku, které dle
svých vnitřních pravidel provádí verifikaci transakce. Banka garantuje denní jízdné do výše
500 Kč, přičemž maximální celodenní skupinová jízdenka pro Ostrava XXL činí 200 Kč, takže
maximální částka pro denní dokupované jízdné v regionu MSK je + 300 Kč (celkem 500 Kč pro
skupinové jízdné v regionu MSK).
(7) Banka zašle transakci standardně na CC MSK v režimu zasílání tapů.
(8) Informace o dokupovaném jízdném se bude rovněž zasílat ze všech vozidlech při tzv. vyčítání
odbavovacího zařízení na konci dne. Tyto transakce slouží pro kontrolu systému, zda nedošlo
ke ztrátě transakcí.
BK na rozdíl od ODISKy mohu zakoupit dokupované jízdenky bez předchozího odbavení držitele.
Nicméně v případě takového kroku zařízení upozorní cestujícího, že nemá označenou jízdu pro
„sebe“, zda skutečně požaduje zakoupení dokupovaných jízdenek. Tím bude zajištěno, že cestující
byl upozorněn na případný svůj „omyl“ a zároveň pokud bude skutečně požadovat pouze jízdenky
pro spolucestující, může takto učinit (tento případ může vzniknout např. tak, že cestující má kupón
na jiné kartě než na té, kterou chce dokoupit jízdenky).
• Dokupovaná jízdenka bude časová, tarifně pouze jedna v délce trvání dle platného tarifu a budou
umožněny maximálně 4 dokupované jízdenky (kromě samotného držitele karty). Dokupované
jízdenky je možné dokupovat průběžně (čas platnosti u jednotlivých průběžných dokupů se bude
počítat pro každý dokup), ale součastně může mít držitel karty maximálně 4 dokupované jízdenky.
• Dokupované jízdenky se budou zobrazovat na validátoru, kde budou vyhrazeny 4 pozice, na
kterých si cestující může kontrolovat zakoupené dokupované jízdenky. Bude-li, zakoupeno více
kusů dokupovaných jízdenek stejného tarifu, budou se zobrazovat na vyčleněných 4 pozicích pod
sebou.
• Nad dokupovanými jízdenkami bude prováděn autocapping. Existují–li k BK dokupované
jízdenky, bude se autocapping počítat pro skupinu, avšak se zohledněním nejvýhodnější ceny,
tedy pokud by byl výhodnější individuální capping plus dokupovaná jízdenka, bude uplatněna
tato výhodnější varianta.
• V nabídce dokupu pro BK budou i zlevněné kategorie krátkodobého jízdného (pro držitele karty
bude pouze obyčejné jízdné).
• Na registračním portále karta.odiska.cz bude dopracována funkcionalita, kterou si může cestující
zvolit formou zatržení, kdy za předpokladu, že cestující má účet, registrovanou kartu a došlo
k použití této karty v dopravě, obdrží cestující vždy za předcházející den informaci o výši
29
proježděné částky jízdného (včetně dokupu) v detailu jednotlivé karty formou zaslaného e-
mailu. Má-li cestující ke kartě registrován kupón, bude mu zaslána informace o končící platnosti
kupónu 3 dny předem.
4.19 WL dokupovaných jízdenek zasílaný ihned z validátoru na CC MSK
Pro přenos informací o dokupovaných jízdenkách do clearingového centra definujeme 1 zprávu. Přehled
definovaných zpráv:
Metoda Popis
RegisterAdditionalFare Zavedení dokupovaného jízdného ihned z validátoru do
clearingového centra
RegisterAdditionalFare
Request
Parametr Typ Popis Default Required?
Uživatelský login provozovatele N/A Yes
UserLogin String Uživatelské heslo provozovatele N/A Yes
Password String Identifikační číslo dokupu N/A Yes
Token bankovní karty N/A Yes
AdditionalFareHeader Číslo transakce N/A Yes
Datum provedení transakce N/A Yes
FareID Guid Linka N/A Yes
Spoj N/A Yes
Token String Počet jízdenek v dokupované jízdence N/A Yes
Celková cena dokupované jízdenky N/A Yes
TxID Int
Profil zákazníka N/A Yes
When Datetime Tarifní profil N/A Yes
Platnost jízdenky od N/A Yes
Line String Platnost jízdenky do N/A Yes
DPH N/A Yes
Sequence Int Cena dokupované jízdenky N/A Yes
Count Byte
TotalAmount Decimal
AdditionalFare
CustomerProfile Short
TariffProfile Short
ValidFrom Datetime
ValidTo Datetime
Vat Decimal
Amount Decimal
Response
Parametr Typ Popis Default Required?
N/A Yes
ResponseStatus
ErrorCode Int Stav zpracování
0 – OK
ErrorMessage Jinak číslo chyby N/A Yes
String Popis chyby
30
4.20 WL dokupovaných jízdenek distribuovaný do vozidel a revizorských zařízení
Pro získání whitelistu dokupovaných jízdenek definujeme 1 zprávu. Přehled definovaných zpráv:
Metoda Popis
GetWhiteListAdditionalFare Vrátí seznam dokupovaných jízdenek
GetWhiteListAdditionalFare
Request Typ Popis Default Required?
Parametr String Uživatelský login provozovatele N/A Yes
UserLogin String Uživatelské heslo provozovatele N/A Yes
Password Typ WhiteListu (celý, inkrementální) N/A Yes
WhiteListType Int Počáteční pořadové číslo WhiteListu N/A No
SequenceNoStart
Response
Parametr Typ Popis Default Required?
WhiteListAdditionalFare
WhiteListAdditionalFareHeader
FileVersion String Verze souboru N/A No
N/A No
IssueDateTime Datetime Datum vytvoření dávky N/A No
N/A No
SequenceNo Int Pořadové číslo N/A No
N/A No
WhiteListType Typ WhiteListu (celý, inkremetnální)
N/A Yes
ItemsCount Int Počet jízdenek N/A Yes
N/A Yes
Reset Bool Příznak, zdali došlo k resetu WhiteListu N/A Yes
N/A Yes
WhiteListAdditionalFareItem N/A Yes
N/A Yes
Token String Token bankovní karty N/A Yes
N/A Yes
TxID Int Číslo transakce N/A Yes
N/A Yes
When Datetime Datum provedení transakce
N/A Yes
Line String Linka
Sequence Int Spoj
CustomerProfile Short Profil zákazníka
TariffProfile Short Tarifní profil
ValidFrom Datetime Platnost jízdenky od
ValidTo Datetime Platnost jízdenky do
Amount Decimal Cena dokupované jízdenky
FareID Guid Identifikační číslo dokupu
ResponseStatus
ErrorCode Int Stav zpracování
0 – OK
ErrorMessage String Jinak číslo chyby N/A Yes
Popis chyby
31
4.21 WL dokupovaných jízdenek nahrávaný na kartu revizora
WL dokupovaných jízdenek, který není starší 5 minut před přiložením karty revizora bude na kartu revizora
nahráván v rámci taplistu a to tak, že taplist bude rozšířen o TP a CP.
4.22 Transakce dokupovaných jízdenek vyčítaných z odbavovacího zařízení na
konci dne a zasílány na CC MSK
Zasílání dat o dokupovaných jízdenkách k bankovní kartě bude probíhat standardně na clearingové centrum
MSK ve formátu věty KODIS.
Příklady transakcí:
1. Příklad multi-lístku (sloučení jednotlivé jízdenky s jízdenkou pro psa):
<transaction tx-id="1" when="2012-10-06 13:59:49" line="900250" sequence="11" type="pay" amount-
type="ep" transtype="mhd" base-rate="zs" amount="65" currency="CZK" vat=„14“ balance_before="500"
balance_after="435" departure-id="130000" arrival-id="365000" tariff-type="JD" tariff="1" person-
type="99" note="" passengers-count ="2" card-emv-
token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967" />
2. Příklad multi-lístku (sloučení jednotlivé jízdenky pro dospělé 3 cestující 3x52 Kč):
<transaction tx-id="1" when="2012-10-06 13:59:49" line="900250" sequence="11" type="pay" amount-
type="ep" transtype="mhd" base-rate="zs" amount="156" currency="CZK" vat=„14“
balance_before="1010" balance_after="854" departure-id="130000" arrival-id="365000" tariff-type="JD"
tariff="1" person-type="99" note="" passengers-count="3" card-emv-
token="10d77013a6c1baf9de924a46f666904062612f8155b474178cd4762eba2a38e967" />
4.23 Dokupované jízdenky v PAD
Dokupované jízdenky v PAD budou hrazeny BK jako samostatná transakce u obchodníka (dopravce), tzv. retail
transakce a nebudou zahrnuty do výpočtu jízdného na CC MSK. Při hrazení dokupovaných jízdenek bude OZ
komunikovat s bankou pod identifikací (ID) dopravce, nikoliv pod identifikací zařízení KODISu. Peníze tedy
půjdou přímo na účet dopravce, nikoliv KODISu. Při tomto způsobu úhrady si může bankovní čtečka vyžádat
on-line autentizaci.
4.24 Ochrana osobních údajů
Systém bude uchovávat tyto osobní údaje:
• Jméno a příjmení
• Datum narození
• Fotografie
32
Nebude-li karta mít evidován žádný nový kupón a to rok po skončení platnosti posledního kupónu, budou
výše uvedené údaje ze systému vymazány.
Cestující bude poučen o účelu a způsobu zpracování jeho osobních údajů oznámením na registračním portálu
při registraci karty nebo na formuláři při registraci na přepážce.
4.25 Evidence ověření
Evidencí ověření je myšleno ověření fotografie a nároků na slevu. CC MSK bude evidovat, který přihlášený
uživatel KODIS provedl ověření fotografií na portále, v případě ověření fotografií nebo nároků na slevu na
přepážce, bude CC MSK uchovávat pouze informaci o tom, který dopravce dané ověření provedl. Detailní
informaci o čísle pracovníka, ktery ověření provedl, bude uchovávat systém daného dopravce, který tyto
informace sdělí na vyžádání firmě KODIS.
4.26 Číslo obchodníka
CC MSK bude uchovávat pouze informaci o tom, který dopravce danou operaci (registraci, odregistraci,
prodej kupónu apod.) provedl. Detailní informaci o čísle přepážky a osobě, která operaci provedla, bude
uchovávat systém daného dopravce, který tyto informace sdělí na vyžádání firmě KODIS.
33
5 Formát taplistu
Soubor se skládá z následujících bloků:
• Záhlaví souboru – pevná velikost 22 B
• Datová část souboru – variabilní, obsahující jednotlivé tapy
• Podpis souboru – variabilní (dle typu podpisu)
Soubor používá následující kódování:
• Little-endian – pro pořadí bytů číselných datových typů.
• Dvojkový doplněk – pro kódování záporných čísel.
• UTF-8 – pro kódování znaků a textových řetězců.
V případě komprese, šifrování dat a podpisu souboru je postup následující:
• data komprimována
• data šifrována
• data podepsána
Tabulka 1 - Formát taplistu
Proměnná Velikost Popis
[B]
FileType 1 Identifikace typu souboru (0x00 – Taplist, zbytek RFU)
FileVersion 1 Verze souboru (0x03, zbytek RFU)
FileGenTime 5 Čas vytvoření souboru (1B hodiny, 1B minuty, 1B sekundy, 2B
FileGenDate milisekundy), UTC čas
4 Datum vytvoření souboru (1B den, 1B měsíc, 2B rok)
ProviderID 2 Identifikace dopravce dle číselníku ČSAD SVT
NetworkID 4 Identifikace sítě dle číselníku ČSAD SVT
SignType 1 Typ podpisu souboru (0x00 – CRC32, zbytek RFU)
DataCompressType 1 Typ komprimace datové části (0x00 – bez komprimace, zbytek RFU)
DataEncType 1 Typ použitého šifrovacího algoritmu datové části (0x00 –
nešifrováno, zbytek RFU)
DataLength 2 Délka datové části souboru
VariableData var Variabilní datová část souboru dle projektu
Sign var Podpis souboru dle algoritmu uvedeného v hlavičce.
Délka dle typu podpisu
Pozn.: Světle modře je zvýrazněna datová část souboru, tzn. každá zaevidovaná transakce
obsahuje všechny tyto proměnné. Naopak, pokud taplist neobsahuje žádnou transakci, tyto
proměnné jsou vynechány.
5.1 Variabilní data pro Ostravu
Proměnná Velikost Popis
Token [B]
TransactionTime 33 Otisk karty
5 Čas vzniku transakce (1B hodiny, 1B minuty, 1B sekundy, 2B
TransactionDate milisekundy), UTC čas
4 Datum vzniku transakce (1B den, 1B měsíc, 2B rok)
34
TransactionResult 4 Návratová hodnota transakce (vrací EMV čtečka)
Code
1 Číslo kategorie cestujícího tarifu.
CustomerProfile 1 Číslo profilu tarifu.
TariffProfile
5.2 Soubor s dopravními daty
Tento dokument popisuje formát souboru s doplňujícími dopravními daty který je předáván
revizorské čtečce (IR) v případě přiložení revizorské čtečky k validátoru .
5.2.1 Formát souboru
Soubor se skládá z následujících bloků:
• Záhlaví souboru – pevná velikost 22 B
• Datová část souboru – variabilní, obsahující Simple TLV data
• Podpis souboru (pokud je použit)
Soubor používá následující kódování:
• Little-endian - pro pořadí bytů číselných datových typů.
• Dvojkový doplněk - pro kódování záporných čísel.
• UTF-8 - pro kódování znaků a textových řetězců.
V případě komprese, šifrování dat a podpisu souboru je postup následující:
• data komprimována
• data šifrována
• data podepsána
Položka Length [B] Popis
FileType 1 Identifikace typu souboru (0x00 – Taplist (není popsáno v tomto
dokumentu), 0x01 – Doplňující dopravní data).
FileVersion 1
Verze souboru (0x01, zbytek RFU).
FileGenTime 5 Čas vytvoření souboru (1B hodiny, 1B minuty, 1B sekundy, 2B
milisekundy), UTC čas.
FileGenDate 4 Datum vytvoření souboru (1B den, 1B měsíc, 2B rok)
ProviderID
2 Identifikace dopravce dle číselníku ČSAD SVT
NetworkID 4 Identifikace sítě dle číselníku ČSAD SVT
SignType 1 Typ podpisu souboru (0x00 – CRC32, zbytek RFU)
DataCompressType 1 Typ komprimace datové části (0x00 – bez komprimace, zbytek
RFU)
DataEncType 1 Typ použitého šifrovacího algoritmu datové části (0x00 –
nešifrováno, zbytek RFU)
DataLength 2 Délka datové části souboru (délka přes všechny TLV položky)
Data DataLength Simple TLV data, popis viz kapitola 5.2.2 Simple TLV data
Sign var Podpis souboru (přes hlavičku a datovou část souboru) dle
algoritmu uvedeného v hlavičce.
Délka dle typu podpisu
Pozn.: Světle modře je zvýrazněna variabilní datová část souboru obsahující TLV data.
35
5.2.2 Simple TLV data
Všechny položky v datové části souboru jsou realizovány ve formátu Simple TLV (Type - Length - Value):
• T (Tag) – identifikátor datového objektu. Pro identifikátor v rozmezí hodnot od 0 do 254 má
Tag délku 1 B. Pro identifikátor větší než 254 má Tag délku 3 B, kde první bajt je 0xFF a
zbývající dva bajty kódují hodnotu identifikátoru (max. 65535).
• L (Length) – udává délku následujících dat v bajtech. Pokud následují data o délce 1 – 254 B,
Length má velikost 1 B. Pokud následují data o délce větší než 254 B, potom má Length velikost
3 B, kde první bajt je 0xFF a zbývající dva bajty kódují délku dat objektu (max. 65535).
• V (Value) – data objektu.
Formát Simple – TLV je použit proto, aby datová část souboru obsahovala jen položky se známou hodnotou.
Položky, které mají neznámou hodnotu, nejsou do souboru vkládány a jsou ze souboru vypuštěny. Celková
velikost souboru je tedy proměnlivá a závisí na tom, kolik položek právě obsahuje.
Název tagu TAG Popis
Line 0x01
Číslo linky.
Sequence 0x02 Použito ve strukturovaných položkách CurrentLS a AdditionalLS.
Nezáporné celé číslo, maximální velikost 4B.
CurrentLS 0x03 Příklad: Line = 25 (0x19)
TLV = 0x01 0x01 0x19
AdditionalLS 0x04
Číslo spoje.
0x05 Použito ve strukturovaných položkách CurrentLS a AdditionalLS
- 0xFE Nezáporné celé číslo, maximální velikost 4B.
Příklad: Sequence = 16 877 216 (0x10186A0)
TLV = 0x02 0x04 0xA0 0x86 0x01 0x01
Aktuální linkospoj.
Tato položka je strukturovanou položkou, která obsahuje sekvenci
Simple TLV položek Line, Sequence
Příklad: Line = 25 (0x19), Sequence = 16 877 216 (0x10186A0)
TLV = 0x03 0x09 0x01 0x01 0x19 0x02 0x04 0xA0 0x86 0x01 0x01
Další uznávaný linkospoj na aktuálním linkospoji.
Tato položka je strukturovanou položkou, která obsahuje sekvenci
Simple TLV položek Line, Sequence. Pokud je uznávaných
linkospojů na aktuálním linkospoji více, je položka zopakována.
Příklad: Line = 26 (0x1A), Sequence = 8 605 (0x219D)
TLV = 0x04 0x07 0x01 0x01 0x1A 0x02 0x02 0x9D 0x21
RFU - Rezervováno pro budoucí použití
5.2.3 Specifikace CRC32
Specifikace „CRC-32“ algoritmu:
• Name: "CRC-32"
• Width: 32-bit
• Poly: 0x04C11DB7
• Init: 0xFFFFFFFF
• RefIn: True
36
• RefOut : True
• XorOut : 0xFFFFFFFF
37
6 DENY LIST
Pro účely rychlého odbavení bude denylist rozšířen o informaci, zda je k dané kartě, která je
umístěna na denylistu evidován platný kupón.
Tuto informaci bude přidělovat CC MSK, tedy formát DL přicházejícího z banky na CC MSK zůstane
nezměněn.
CC udržuje seznam bankovních karet, které jsou odmítnuté vydavatelem nebo držitelem pro
použití ve veřejné dopravě. Nejde o “zakázané karty”, protože karty mohou fungovat mimo
veřejnou dopravu.
V ostré verzi CC MSK je WS dostupná na:
https://karta.odiska.cz/WebService/DataService.asmx
V testovací verzi CC MSK je WS dostupná na:
https://karta.odiska.cz/WebServiceTest/DataService.asmx
Aktuální WSDL soubor je možné získat na výše uvedených adresách, přidání postfixu? WSDL k dané
URL adrese.
6.1 Význam použitých datových položek
• CardEmvToken – EMV karetní token
• DenyListType – typ DenyListu
o FULL = plný
o INC = inkrememtální
• DenyList – Struktura DenyListu. Odpověď může obsahovat i několik struktur DenyList za sebou,
v případě že je požadováno stažení inkrementálního seznamu nebo více vydaných seznamů
najednou (rozsah definovaný položkami SequenceNoStart a SequenceNoEnd).
o DenyListHeader – Hlavička DenyListu
▪ FileVersion – Verze struktury DenyListu
▪ IssueDateTime – Datum vydání DenyListu
▪ SequenceNo – Pořadové číslo DenyListu
▪ Type (viz položka DenyListType)
▪ ItemsCount – Počet záznamů na DenyListu
▪ Reset – Má-li tento příznak hodnotu true, pak došlo k resetu DenyListu, tzn.
všechny dřívější položky EMV karet na seznamu byly vymazány (pokud tento
DenyList obsahuje nějaké položky, jedná se již o nové zánamy EMV karet na
seznamu). Reset Denylistu je obvykle prováděn jednou denně na přelomu dne,
kdy je z bankovního back office stažen zvela nový plný DenyList, který je potřeba
nově nasadit na CC. Příznak je důležitý v případě požadavku na stažení
inkrementálního DenyListu, čímž je klient informován, že byl nasazen zcela nový
seznam odmítnutých EMV karet (čímž došlo k narušení posloupnosti změn).
o DenyListItems – Seznam karet v DenyListu
▪ DenyListItem – Jedna položka DenyListu
• CardEmvToken – EMV karetní token
• OriginDateTime – Datum vzniku události
• BlockNoticed - příznak, že uživateli bylo už zobrazeno, že má kartu na
denylistu
38
• StateCode – Kód stavu EMV karty (pouze u inkrementálního DenyListu)
o ADD = přidání karty na DenyList (blokace)
o DEL = odebrání karty z DenyListu (odblokace)
• HasValidCoupon – příznak, že je na kartě evidován platný kupón
o FileName – Jméno binárního souboru DenyListu
o Data – binární data souboru DenyListu
• Password – Uživatelské heslo provozovatele
• ResponseStatus – Struktura s výsledkem zpracování dotazu
o ErrorCode – Pokud je 0, vše je OK
o ErrorMessage – Text chyby
• SequenceNo – Pořadové číslo DenyListu
• SequenceNoStart – Počáteční pořadové číslo DenyListu
• SequenceNoEnd – Koncové pořadové číslo DenyListu
• UserLogin – Uživatelský login provozovatele
6.2 Zpracování odpovědí
Zpracování chyb
V jednotlivých XML odpovědích zde uvedených metod webové služby je vždy navrácen následující
element určující výsledek zpracování metody webové služby:
<ResponseStatus>
<ErrorCode>int</ErrorCode>
<ErrorMessage>string</ErrorMessage>
</ResponseStatus>
V tagu ResponseStatus se mohou objevit následující kombinace hodnot u elementu ErrorCode a
ErrorMessage:
• 0 „OK“
• -1 „Uživatelský účet nenalezen (chybný uživatelský login nebo heslo)“
• -2 „Uživatelský účet nemá přiděleno právo 'Online XML komunikace'“
• -3 „Nepodařilo se získat pořadové číslo posledně vydaného DenyListu“
• -4 „Chybná hodnota vstupního parametru DenyListType
(CardEmvDenylistBatchTypeCode)“
• -5 „Hodnota parametru SequenceNoStart nesmí být větší než hodnota
parametru SequenceNoEnd“
• -6 „Hodnoty parametrů SequenceNoStart a SequenceNoEnd musí být v rozsahu
<1;LastIssuedDenyListSequenceNo>“
• - 32768 chybový text výjimky
Zpracování vrácených dat
Pokud nedošlo k chybě a vrací-li daná metoda smysluplná data, obsahuje další element, který
následuje po elementu <ResponseStatus></ResponseStatus> datovou část s odpovědí (liší se
podle typu volané metody webové služby).
39
Binární podoba DenyListu
DenyList je možné také stahovat v binární podobě.
Popis souboru: Popis
Soubor stoplistu (upload)
Název souboru YYMMDDHHMISS … je řídící hodnota pro
ST.YYMMDDHHMISS verzi stoplistu v terminálu. Stejná
hodnota je uvedena v hlavičce
zdrojových XML dat
Formát souboru:
Položka Délka Popis
ROWS_NUM 4B Udává celkový počet tokenů (záznamů) ve stoplistu
ROW_LEN 1B
Délka jednoho záznamu. Do délky záznamu se počítá
TOKEN 33B max_len(TOKEN)+STATUS
STATUS 1B Vlastní karetní token. Pozn: 33B je pro aktuálně používaný
formát tokenu.
0…. info N/A
1 …. Držitel karty byl informován o blokované kartě
Soubor stoplistu obsahuje neoddělená binární data (ne ASCII), kde jednotlivé tokeny jsou
vzestupně seřazeny. Položka STATUS do třízení nevstupuje.
Zdrojovým podkladem pro binární stoplist jsou XML data stoplistu.
Příklad:
000000022210CDF8F44E6C266C6B8FC8BF010370288CF2136B134E44CC22E26D79344C46D13E0110DDF8F44E6C266C
6B8FC8BF010370288CF2136B134E44CC22E26D79344C46D13E00
6.3 Metoda GetLastIssuedDenyListSequenceNo
Metoda vrátí pořadové číslo posledně vydaného plného DenyListu.
Požadavek:
POST /DataService.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
40
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetLastIssuedDenyListSequenceNo xmlns="http://tempuri.org/">
<UserLogin>string</UserLogin>
<Password>string</Password>
</GetLastIssuedDenyListSequenceNo>
</soap12:Body>
</soap12:Envelope>
Odpověď:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetLastIssuedDenyListSequenceNoResponse xmlns="http://tempuri.org/">
<ResponseStatus>
<ErrorCode>int</ErrorCode>
<ErrorMessage>string</ErrorMessage>
</ResponseStatus>
<SequenceNo>int</SequenceNo>
</GetLastIssuedDenyListSequenceNoResponse>
</soap12:Body>
</soap12:Envelope>
6.4 Metoda GetDenyList
Metoda vrátí seznam karet na DenyListu
Požadavek:
POST /DataService.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetDenyList xmlns="http://tempuri.org/">
<UserLogin>string</UserLogin>
<Password>string</Password>
<DenyListType>FULL or INC</DenyListType>
<SequenceNoStart>int</SequenceNoStart>
<SequenceNoEnd>int</SequenceNoEnd>
</GetDenyList>
</soap12:Body>
</soap12:Envelope>
41
Odpověď:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetDenyListResponse xmlns="http://tempuri.org/">
<ResponseStatus>
<ErrorCode>int</ErrorCode>
<ErrorMessage>string</ErrorMessage>
</ResponseStatus>
<DenyList>
<DenyListHeader>
<FileVersion>string</FileVersion>
<IssueDateTime>dateTime</IssueDateTime>
<SequenceNo>int</SequenceNo>
<Type>FULL or INC</Type>
<ItemsCount>int</ItemsCount>
<Reset>boolean</Reset>
</DenyListHeader>
<DenyListItems>
<DenyListItem>
<CardEmvToken>string</CardEmvToken>
<OriginDateTime>dateTime</OriginDateTime>
<BlockNoticed>boolean</BlockNoticed>
<StateCode>ADD or DEL</StateCode>
</DenyListItem>
<DenyListItem>
<CardEmvToken>string</CardEmvToken>
<OriginDateTime>dateTime</OriginDateTime>
<BlockNoticed>boolean</BlockNoticed>
<StateCode>ADD or DEL</StateCode>
</DenyListItem>
</DenyListItems>
</DenyList>
<DenyList>
<DenyListHeader>
<FileVersion>string</FileVersion>
<IssueDateTime>dateTime</IssueDateTime>
<SequenceNo>int</SequenceNo>
<Type>FULL or INC</Type>
<ItemsCount>int</ItemsCount>
<Reset>boolean</Reset>
</DenyListHeader>
<DenyListItems>
<DenyListItem>
<CardEmvToken>string</CardEmvToken>
<OriginDateTime>dateTime</OriginDateTime>
<BlockNoticed>boolean</BlockNoticed>
<StateCode>ADD or DEL</StateCode>
</DenyListItem>
<DenyListItem>
<CardEmvToken>string</CardEmvToken>
<OriginDateTime>dateTime</OriginDateTime>
<BlockNoticed>boolean</BlockNoticed>
<StateCode>ADD or DEL</StateCode>
</DenyListItem>
</DenyListItems>
42
</DenyList>
</GetDenyListResponse>
</soap12:Body>
</soap12:Envelope>
6.5 Metoda GetDenyListBinary
Metoda vrátí seznam karet na DenyListu v binární podobě
Požadavek:
POST /DataService.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetDenyListBinary xmlns="http://tempuri.org/">
<UserLogin>string</UserLogin>
<Password>string</Password>
<DenyListType>FULL or INC</DenyListType>
<SequenceNoStart>int</SequenceNoStart>
<SequenceNoEnd>int</SequenceNoEnd>
</GetDenyListBinary>
</soap12:Body>
</soap12:Envelope>
Odpověď:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetDenyListBinaryResponse xmlns="http://tempuri.org/">
<ResponseStatus>
<ErrorCode>int</ErrorCode>
<ErrorMessage>string</ErrorMessage>
</ResponseStatus>
<DenyList>
<FileName>string</FileName>
<Data>base64Binary</Data>
</DenyList>
<DenyList>
<FileName>string</FileName>
<Data>base64Binary</Data>
43
</DenyList>
</GetDenyListBinaryResponse>
</soap12:Body>
</soap12:Envelope>
44
7 WHITE LIST KUPÓNŮ REGISTROVANÝCH K BANKOVNÍ KARTĚ
Pro získání whitelistu kupónů definujeme 1 zprávu. Přehled definovaných zpráv:
Metoda Popis
GetWhiteListCouponBinary Vrátí seznam bankovních karet v Byte souborech
GetWhiteListCouponBinary
Request Typ Popis Default Required?
Parametr String Uživatelský login provozovatele N/A Yes
UserLogin String Uživatelské heslo provozovatele N/A Yes
Password Typ WhiteListu (celý, inkrementální) N/A Yes
WhiteListType Int Počáteční pořadové číslo WhiteListu N/A No
SequenceNoStart Typ kupónu N/A No
CouponType
Response
Parametr Typ Popis Default Required?
WhiteListCouponBinary Pořadové číslo N/A Yes
Název souboru N/A Yes
SequenceNo Int Data souboru N/A Yes
FileName String Stav zpracování N/A Yes
Data Base64
ResponseStatus
ErrorCode Int
0 – OK
ErrorMessage Jinak číslo chyby N/A Yes
String Popis chyby
Binární podoba záznamu v seznamu WhiteListu kupónů:
Token – 33B
TP – 1B
CP – 1B
Platnost ve dnech od 1. 8. 2017 – 2B (počet dnů od data 1. 8. 2017)
Platnost v hodinách – 1B (v poslední den platnosti)
Platnost v minutách -1B (v poslední den platnosti)
Platnost v sekundách – 1B (v poslední den platnosti)
StateCode – 1B (přidání nebo odebrání kupónu k BK; 1 – přidání, 2 - odebrání)
Zóny – po 2B
CRLF
45
8 Soubor transakcí z BO banky na CC MSK
Tento soubor slouží pro informaci dopravního back office banky o provedených identifikacích (tap)
bezkontaktní bankovní kartou na validátorech v dopravních prostředcích. Ve fázi 2 přibyla specifikace zón,
kterými vozidlo projíždí a dále musí být ve fázi 2 předávány i položky nástupní a výstupní zastávky i nástupní
a výstupní zóny, nárok na přestup dle jednotlivých oblastí (MĚSTO, REGION, aj.) a cena jízdenky u příměstské
dopravy.
Nárok na přestup se řídí aktuálním tarifem a dále dokumentem „Procesy MSK“.
Předávaná data byla rovněž rozšířena o identifikaci dopravce.
Soubor transakce Typ Popis
element TXS atributy
atributy
dttm datetime Datum generování souboru
count int Počet záznamů
fversion string Verze formátu souboru transakcí („1“)
laststolistversion int Verze posledního dostupného Denylistu
element TX Popis
atributy string ID terminálu v bankovním systému
terminalid
dttm datetime Datum a čas transakce
txcounter int Cyklický čítač transakcí 00000000-99999999
txstatus int
Čítač identifikuje pouze přiložení bankovní karty.
termrespcode int
authcode int Status odbavení na terminálu
1 – kartu se podařilo ve vozidle načíst
authstatus int 2 – kartu nebylo možné načíst. Nejsou k dispozici data
pro autorizaci
Návratový kód, který vydal terminál při odbavení karty.
(viz SPDH response codes)
Status navrácený z autorizace transakce u vydavatele
karty
000-010 OK
050-999 – ERROR – transakce nebyla schválena
vydavatelem. Karta je zařazena na denylist
(viz SPDH response codes)
Udává, zda bylo potřeba kartu autorizovat nebo je
možné je možné vyžít kreditního rámce (např: druhá
jízda během dne)
1 - nová autorizace – tato karta se objevila v systému
poprvé nebo byl otevřen nový kreditní rámec
2 – pending autorizace – karta má již otevřen kreditní
rámec
3 – nevalidní autorizace – karta nemá schválen kreditní
rámec a je na denylistu
46
stlversion string Verze denylistu použitá v transakci při kontrole na
token string terminálu (YYYYMMDDHHMISS)
panmas 11 Karetní token
vrevcode *) int
Maskované číslo karty
element transportdata string Prvních 6 a poslední 4 čísla karty AAAAAA*BBBB
device-id int Chybový kód při reversalu z validátoru. Vrací validátor,a
říká, proč reversoval. Požívá se při tisku jízdenky.
tx-id V případě check-in/ check-out modelu nemá smysl.
Amount *) int Jednoznačný identifikátor zařízení (např. sériové
výrobní číslo).
vat-rate*) int Příklad:device-id = 350000000112
TLV = 0x01 0x0C 0x33 0x35 0x30
line int 0x300x300x300x300x300x30 0x31 0x31 0x32
Pořadové číslo transakce na zařízení (masterindex -
sequence int jedinečné v rámci zařízení).
Příklad: tx-id = 1234 ( = 0x04D2)
departure-station-tariff-number int TLV = 0x02 0x02 0xD2 0x04
departure-station-registration- int Cena transakce hrazená platebníkartou v setinách
number měny. V rámci dokupované jízdenky se jedná o
celkovou cenu dokupované jízdenky.
arrival-station-tariff-number int Příklad: cena transakce 27.50,- Kč, amount = 2750
(=0x0ABE)
arrival-station-registration- int TLV = 0x03 0x02 0x0BE 0x0A
number Nutné uvádět pro dokupované jízdné a transfer-type
REGION, MESTO a COUPON,
Pro DPO = 0
Sazba DPH v setinách.
Příklad: sazba DPH 17.5%, vat-rate = 1750 (=0x06D6)
TLV = 0x04 0x02 0xD6 0x06
Pro DPO=0
Číslo aktuální linky.
Příklad: line = 23 (=0x17)
TLV = 0x050x01 0x17
Číslo aktuálního spoje.
Příklad: sequence = 2 (=0x02)
TLV = 0x06 0x01 0x02
Tarifní (pořadové) číslo výchozí zastávky.
Příklad: departure-station-tariff-number = 8 (=0x08)
TLV = 0x07 0x01 0x08
Evidenční číslo výchozí zastávky.
Příklad: departure-station-registration-number = 2451
(0x0993)
TLV = 0x08 0x02 0x93 0x09
Tarifní (pořadové) číslo cílové zastávky.
Příklad: arrival-station-tariff-number = 12 (=0x0C)
TLV = 0x09 0x01 0x0C
Evidenční číslo cílové zastávky.
Příklad: arrival-station-registration-number = 2461
(0x099D)
TLV = 0x0A 0x02 0x9D 0x09,
Pro DPO číslo konečné zastávky
47
ticket-cp int Evidenční číslo zákaznického profilu (CP – customer
profile) jízdenky.
ticket-tp int Příklad: ticket-cp = 2 (=0x02)
TLV = 0x0B 0x01 0x02
ticket-validity *) int Evidenční číslo tarifního profilu (TP – tariff profile)
v rámci CP dané jízdenky.
departure-station-zone-numbers string Příklad: ticket-tp = 8 (=0x08)
TLV = 0x0C 0x01 0x08
arrival-station-zone-number int
vehicle-number string Platnost jízdenky v minutách.
Příklad: ticket-validity = 45 (=0x2D)
taplist-number int TLV = 0x0D 0x01 0x2D ,
Nemusí posílat DPO
zones-passes-through string Seznam zón výchozí zastávky. max. 20 zón oddělených
středníkem).
zones-valid string Příklad: departure-station-zone-numbers = „78;5“
string
subsequent-station-zone- Číslo zóny cílové zastávky.
numbers Příklad: arrival-station-zone-number = 4 (0x04)
TLV = 0x10 0x1 0x04,
transfer-type string U DPO zóny konečné zastávky
Číslo vozidla .
Příklad: vehicle-number = „1AX5640“
Pořadové číslo taplistu (neustále rostoucí až do
přetočení v rámci čísla vozidla). V případě DPO dochází
ke zvýšení čísla taplistu na konečné zastávce, v případě
PAD dochází ke zvýšení čísla taplistu při změně linky
nebo spoje.
Příklad: taplist-number = 4 (0x04)
Zóny, kterými vozidlo projíždí (max. 20 zón oddělených
středníkem).
Příklady:
Pro transfer-type="XXL": zones-passes-through="78"
Pro transfer-type="REGION": zones-passes-through se
neuvádí
Pro transfer-type="MESTO": zones-passes-through="5"
Pro transfer-type="XXL-NP": zones-passes-
through="78"
Pro transfer-type="COUPON": zones-passes-
through="78"
Čísla uznaných zón, kterými cestující na zakoupenou
jízdenku projede a které jsou zároveň platné pro
aktuálně zakoupené kupóny (max. 20 zón oddělených
středníkem).
Příklad: zones-valid=“1;4;60“
Seznam čísel zón následující zastávky. Strukturovaná
TLV položka složená z více TLV položek definující zónu
následující zastávky (0x0F).
Příklad: subsequent-station-zone-numbers = 77 (0x4D)
a 18 (0x12)
1. zóna (77) = 0x1E 0x01 0x4D
2. zóna (19) = 0x1E 0x01 0x12
TLV = 0x1F 0x06 0x1E 0x01 0x4D 0x1E 0x01 0x12
Typ času pro přestup.
48
transfer-time*) datetime 1. Pro jednotlivé a krátkodobé jízdné OSTRAVA bude
additional-fare-count int „XXL“ - datum a čas pro uznání přestupu se počítá od
non-bank-amount int času nástupu cestujícího nebo v případě PAD času
tx-id-canceled *) int vypočítaného dle „Procesy MSK“ - datum a čas pro
uznání přestupu je uveden v položce transfer-time.
provider-id int Pokud transfer-time není uveden, počítá se 45minut od
element additionalfare času nástupu cestujícího.
ticket-cp 2. Pro jednotlivé jízdné REGION bude „REGION“ -
ticket-tp
ticket-valid-from datum a čas pro uznání přestupu je uveden v položce
ticket-valid-to transfer-time.
3. Pro jednotlivé jízdné MĚSTO bude „MESTO“ - datum
a čas pro uznání přestupu je uveden v položce transfer-
time.
4. Pro vyžádanou nepřestupní jízdenku v oblasti
OSTRAVA XXL na linkách s odbavením u řidiče, kde
nepřijde odpovídající check-out, bude „XXL-NP“-
případný další přestup nebude uznán a jakýkoliv
následující tap bude považován za check-in další
jednotlivé jízdenky. Datum a čas pro uznání přestupu je
uveden v položce transfer-time. V tomto případě však
nebude uváděn na jízdence pro držitele. Datum a čas
pro uznání přestupu slouží pouze pro případné
zpracování.
5. Pro nákup dlouhodobého jízného bude „COUPON“
Datum a čas pro uznání přestupu, tedy doba do kdy se
má uznat přestup. Výpočet přestupu pro jednotlivé
oblasti se řídí tarifem a dokumentem „Procesy MSK“
DPO raději nebude posílat (z důvodu rozdílných časů).
Počet jízdenek v dokupované jízdence
Příklad: additional-fare-count = 2
Výše doplatku, který byl proveden v hotovosti (RFU)
tx-id stornované transakce
Pokud atribut tx-id-canceled není přítomný, nejedná se
o storno transakci.
Pokud atribut tx-id-canceled je přítomný, jedná se o
storno transakci a znamená tx-id stornované transakce,
v takovém případě je nutné zopakovat všechny atributy
stornované transakce kromě dttm, txcounter a tx-id.
Storno transakce slouží pouze k předání tx-id a dalších
atributů transakce, která je stornovaná.
DPO neposílá
Číslo dopravce dle číselníku KODIS
int Evidenční číslo zákaznického profilu (CP – customer
int profile) jednotlivé dokupované jízdenky.
datetime Příklad: ticket-cp = 2
datetime Evidenční číslo tarifního profilu (TP – tariff profile)
v rámci jednotlivé dokupované jízdenky.
Příklad: ticket-tp = 8
Platnost jednotlivé dokupované jízdenky od
Platnost jednotlivé dokupované jízdenky do
49
Sazba DPH v setinách v rámci jednotlivé dokupované
vat-rate int jízdenky.
amount Příklad: sazba DPH 17.5%, vat-rate = 1750 (=0x06D6)
*) Neposílá DPO
TLV = 0x04 0x02 0xD6 0x06
int Cena v rámci jednotlivé dokupované jízdenky.
Příklad: cena transakce 27.50,- Kč, amount = 2750
8.1 Denní uzávěrka transakcí
Denní uzávěrka transakcí představuje přehled vypočítaných hodnot spotřebovaného jízdného pro jednotlivé
karty (tokeny) za uplynulý den. Jeden záznam odpovídá jednomu karetnímu tokenu.
Popis formátu viz clearingová uzávěrka karet.
8.2 Clearing uzávěrka karet (z BO do CC MSK)
Clearing uzávěrka karet představuje přehled karet a hodnot, které jsou evidovány v modulu ASORS transport
a je zde uvedena hodnota, která byla odeslána do mezibankovního zúčtování. Tento formát zůstává ve fázi 2
zachován.
element clearing Typ Popis
atributy
dttm dateTime YYYYMMDDHHMISS
businessdate date Datum, za který je účtováno. V případě vytvoření
bdid int uzávěrky po půlnoci je to datum předcházejícího dne.
count int Pořadové číslo souboru v rámci business date (od 0)
type int Počet záznamů
Typ souboru
target int 1 – denní uzávěrka z dopravního BO
2 – report o provedeném clearingu z autorizace
proctype int Určuje, zda se jedná o produkční nebo testovací soubor
1… produkční soubor
merchant string 2… testovací soubor
fversion int Udává mechanismus zpracování souboru
element tx Typ 1 – řádný – standardní soubor uzávěrky
token 2 – opravný – možnost opravit účetní záznamy pokud
businessdate string bude zasláno během business date a na straně
optype date Bankovního BOještě nedošlo ke vzniku clearingového
int záznamu.
3 – doplňkový – rozšíření odeslaného souboru transakcí
Identifikace obchodníka, pro kterého je účtováno
Verze formátu souboru
Popis
Karetní token
Datum, za který je účtováno
Typ operace, která se má s transakcí provést
1 – cleartx ... provede se zaúčtování transakce ve
prospěch obchodníka
50
amontreq int 2 – refundtx ... návrat peněz na kartu držitele z účtu
obchodníka
invoiceno string
amountclr int Částka spotřebovaného denního jízdného požadovaná
k proúčtování
Udává se v 1/100 základní měny
Variabilní symbol. Slouží k identifikaci platby v systému
dopravce. Maximální délka je 20 znaků
Částka odeslaná do mezibankovního clearingu. Tuto
hodnotu očekávejte na bankovním výpisu.
Pokud=0, a card_status=0 tak ještě nebyly naplněny
claering limit. Karta bude zúčtována později.
Udává se v 1/100 základní měny
Pozn: jen pro typ souboru 2
8.3 Formát souboru Denylistu
Denylist je generován autorizačním jádrem. Je vydáván 1x za cca 10 minut (interní parametr systému) a to
v případě, že se během autorizace vyskytla karta, která byla zamítnuta vydavatelem nebo držitelem. Tento
formát zůstává ve fázi 2 zachován.
element Denylist Typ Popis
atributy int Počet záznamů
count string Verze denylistu ve formátu YYMMDDHHMMSS
stlversion Pořadové číslo denylistu (od 0)
serno int Typ souboru
stltype string F- full plný denylist obsahuje všechny platné záznamy
I – inkrementální denylist – obsahuje změnové záznamy
fversion string
element token Verze formátu souboru („1“)
atributy Popis
token
dttm string Příslušný karetní token
reason dateTime Datum a čas založení karty na denylist
type Kód založení karty na denylist (dle SPDH)
string Příznak operace vzhledem ke denylistu
serno int 0 … zanechat na denylistu
stlversion 1 … přidat na denylist
int 2 … vyřadit ze denylistu
string Pořadové číslo denylistu (od 0)
Verze denylistu ve formátu YYMMDDHHMMSS
51
9 Zapojení příměstských dopravců včetně železničních do systému
plateb jízdného bankovní kartou
9.1 Rozšíření předávaných dat mezi BO a CC MSK
Z důvodu začlenění nových dopravců do systému musí být předávaná data rozšířena o identifikaci
dopravce, tedy Číslo dopravce dle číselníku KODIS, kterou bude provádět banka a tuto informaci
zasílat v hlavičce souboru tapů předávaných z BO na CC MSK. Číslo dopravce dle definovaného
číselníku.
9.2 Rozšíření předávaných dat mezi odbavovacím zařízení a BO
Dopravní data předávaná mezi odbavovacím zařízením budou dále BO předána na CC MSK.
Odbavovací zařízení bude do BO předávat nově seznam zón, kterými vozidlo projíždí, dále pak také
nástupní a výstupní zastávku, kterou cestující nahlásí řidiči, nástupní a výstupní zónu, nárok na
přestup a cenu jízdenky. Cenu jízdenky zařízení spočítá obdobně jako doposud podle tarifu určeného
pro danou oblast se zohledněním časových jízdenek, které může cestující mít k bankovní kartě
registrován. Tento seznam časových jízdenek k bankovním kartám vozidlo získá z WL kupónu, které
si bude aktualizovat. Stejně tak zařízení vypočítá nárok na přestup, obdobně jako doposud v případě
použití karty ODISka, a to podle tarifu a dokumentu „Procesy MSK“.
Zaslané jízdné nebude z bankovních karet strháváno ihned, ale půjde do celodenního zúčtování na
závěr dne.
Pokud by cestující dosáhl denního jízdného ve výši 200 Kč, nebudou se další částky z bankovní karty
strhávat. Zařízení musí odeslat čas pro přestup, oblast přestupu a uznané zóny pro kontrolu.
9.3 Rozšíření systému CC MSK
9.3.1 Soubor transakcí
Tento soubor slouží pro informaci dopravního back office o provedených identifikacích (tap)
bezkontaktní bankovní kartou na validátorech v dopravních prostředcích.
Soubor transakcí je nutné rozšířit nebo doplnit o následující údaje:
• Doplnění identifikátoru dalších dopravců (nyní pouze DPO).
• Doplnění atributu pro určení typu přestupu (oblast přestupu).
• Pro rozlišení jízdného v oblastech posílat typ zóny pro danou oblast (např. v případě Ostrava XXL
zónu 78 nebo 353). Pokud jde o REGION, neposílat žádnou zónu. Pokud jde o MĚSTO, posílat
vždy jednu městkou zónu dle aktuálního zónového členění a tarifu. ).
• V případě jízdného REGION a MĚSTO posílat datum a čas pro uznání přestupu (položka v db,
TransactionTapEmvTransferTime DATETIME).
• Vždy posílat cenu jízdného včetně ZS (TransactionTapEmvAmount).
9.3.2 Tabulka jízdenek TransactionEmv
Tabulka jízdenek TransactionEmv bude rozšířena o příznak přítomnosti základní sazby
TransactionEmvBaseRate (1 - byla použita základní sazba, 0 - nebyla použita základní sazba)
52
9.3.3 Zařazení druhů jízdenek
Zařazení druhů jízdenek se týká výhradně systému Clearingu a jejich zařazení do dělby tržeb dle
níže uvedené tabulky.
Proces rozúčtování jízdného na bankovní karty využívá zatím následující druhy jízdenek v oblasti
Ostrava XXL:
ProcessigTypeID Formátovaný název
0.0.1.2.1.19 Prodej - Krátkodobé - Zónové - Obyčejné - 45 minut
0.0.1.2.19.19 Prodej - Krátkodobé - Zónové - Žáci 6-15 - 45 minut
0.0.1.2.2.19 Prodej - Krátkodobé - Zónové - Děti 6-15 - 45 minut
0.0.1.2.3.19 Prodej - Krátkodobé - Zónové - Studenti 15-26 - 45 minut
0.0.3.2.1.3 Prodej - Jednotlivé - Zónové - Obyčejné - Nepřestupní
0.0.3.2.1.16 Prodej - Jednotlivé - Zónové - Obyčejné - Přestupní
0.0.3.2.1.701 Prodej - Jednotlivé - Zónové - Obyčejné - Celodenní
0.0.3.2.1.702 Prodej - Jednotlivé - Zónové - Obyčejné - Celodenní skupinové
0.1.1.2.1.19 Reklamace - Krátkodobé - Zónové - Obyčejné - 45 minut
0.1.1.2.19.19 Reklamace - Krátkodobé - Zónové - Žáci 6-15 - 45 minut
0.1.1.2.2.19 Reklamace - Krátkodobé - Zónové - Děti 6-15 - 45 minut
0.1.1.2.3.19 Reklamace - Krátkodobé - Zónové - Studenti 15-26 - 45 minut
0.1.3.2.1.3 Reklamace - Jednotlivé - Zónové - Obyčejné - Nepřestupní
0.1.3.2.1.16 Reklamace - Jednotlivé - Zónové - Obyčejné - Přestupní
0.1.3.2.1.701 Reklamace - Jednotlivé - Zónové - Obyčejné - Celodenní
0.1.3.2.1.702 Reklamace - Jednotlivé - Zónové - Obyčejné - Celodenní skupinové
Jízdné REGION a MĚSTO na bankovní karty bude využívat tyto druhy jízdenek:
ProcessigTypeID Formátovaný název
0.0.2.3.1.1 Prodej - Kilometrické - Linkové - Obyčejné - Jednotlivé
0.0.3.2.1.1 Prodej - Jednotlivé - Zónové - Obyčejné - Jednotlivé
0.0.3.2.1.703 Prodej - Jednotlivé - Zónové - Obyčejné - Celodenní síťové
0.0.3.2.1.704 Prodej - Jednotlivé - Zónové - Obyčejné - Celodenní skupinové síťové
0.1.2.3.1.1 Reklamace - Kilometrické - Linkové - Obyčejné - Jednotlivé
0.1.3.2.1.1 Reklamace - Jednotlivé - Zónové - Obyčejné - Jednotlivé
0.1.3.2.1.703 Reklamace - Jednotlivé - Zónové - Obyčejné - Celodenní síťové
0.1.3.2.1.704 Reklamace - Jednotlivé - Zónové - Obyčejné - Celodenní skupinové síťové
9.3.4 Počítání ceny zvýhodněného přestupu
Cena jednotlivého jízdného REGION je dána součtem základní sazby a příslušného násobku ceny za
každý tarifní kilometr (při výpočtu ceny zlevněného jízdného se cena za tarifní kilometry násobí
procentuální výší jízdného nárokované slevy). Při platbě v hotovosti je zaokrouhlena na celé Kč dolů,
při platbě ODISkou je cena zaokrouhlená na desetihaléře. Cena placená bankovní kartou bude
odpovídat ceně při platbě ODISkou. Tato cena bude posílána v check-in tapu.
U jízdenky typu REGION se zvýhodněným přestupem rozumí snížení ceny o výši základní sazby v
navazujícím spoji, pokud je přestup na jiný REGION nebo Ostrava XXL proveden do 45 minut od času
příjezdu do nahlášené výstupní zastávky s přihlédnutím ke zpoždění v době nástupu.
53
Zvýhodněným přestupem v rámci tarifní oblasti Ostrava XXL se rozumí přestup zdarma v době do 45
minut od zakoupení jízdenky.
V rámci přestupu jiných tarifních oblastí s výjimkou tarifní oblasti Ostrava XXL se rozumí snížení ceny
o výši základní sazby v navazující lince.
Výše základní sazby u Elektronické přestupní jízdenky Ostrava XXL odpovídá výši základní sazby u
jednotlivé jízdenky REGION placené kartou ODISka.
Výše základní sazby jako i časy určené pro přestup se řídí platným tarifem ODIS.
Nástup Uznaný Zvýhodnění přestupu Pravidlo pro uznání zvýhodněného
XXL zvýhodněný přestupu
přestup
XXL Zdarma Řeší se stávajícím způsobem
Snížení o ZS ODISKa REGION v clearingu BK
XXL REGION Snížení o ZS ODISKa MĚSTO
Snížení o ZS ODISKa REGION Pokud je čas přestupu menší nebo
XXL MĚSTO Snížení o ZS ODISKa XXL roven času nástupu (první Check-in
BK) + 45 minut
REGION REGION Snížení o ZS ODISKa MĚSTO
Snížení o ZS ODISKa MĚSTO Pokud je čas přestupu menší nebo
REGION XXL Snížení o ZS ODISKa XXL roven času nástupu (první Check-in
BK) + 45 minut
REGION MĚSTO Snížení o ZS ODISKa REGION
MĚSTO MĚSTO Pokud je čas přestupu menší nebo
MĚSTO XXL
roven času uvedenému v položce
MĚSTO REGION transfer-time u jízdenky nástupu
Pokud je čas přestupu (první Check-
in BK) menší nebo roven času
uvedenému v položce transfer-time
u jízdenky nástupu
Pokud je čas přestupu menší nebo
roven času uvedenému v položce
transfer-time u jízdenky nástupu
Pokud je čas přestupu menší nebo
roven času uvedenému v položce
transfer-time u jízdenky nástupu
Pokud je čas přestupu (první Check-
in BK) menší nebo roven času
uvedenému v položce transfer-time
u jízdenky nástupu
Pokud je čas přestupu menší nebo
roven času uvedenému v položce
transfer-time u jízdenky nástupu
Každý uznaný zvýhodněný přestup na MĚSTO a REGION bude mít uveden správný čas na další
zvýhodněný přetup v transfer-time.
9.3.5 Dělení základní sazby mezi dopravce
Mezi dopravce se dělí zaplacená základní sazba, od které je odečtena bankovní provize. Vlivem
přepočítání ceny jízdného na celodenní jízdné, může být zaplacena pouze část základní sazby nebo
i žádná základní sazba.
54
9.3.6 Výstupy
Výstupní sestava pro bankovní karty bude rozšířena o další typy jízdenek v oblasti REGION a MĚSTO.
55
10 Metodika zpracovávání jednotlivých jízdenek hrazených
prostřednictvím bankovní karty
Tato metodika slpouží výhradně pro systém Clearingu a bude se upravovat v rámci platného tarifu.
10.1 Typy jednotlivých jízdenek na bankovní kartu
1) Nepřestupní (16 Kč)
2) Přestupní (24 Kč)
3) Dokupované (24,12, Kč)
4) Region
5) Město (v rámci města není prováděn autocapping)
6) Celodenní OSTRAVA XXL (po dosažení projeté částky v daný den nad 100 Kč)
7) Celodenní skupinová Ostrava XXL (po dosažení projeté částky v daný den nad 200 Kč)
8) Celodenní síťová (po dosažení projeté částky v daný den nad 200 Kč)
9) Celodenní skupinová síťová (po dosažení projeté částky v daný den nad 500 Kč) – bude
zavedena ode dne vyhlášení tarifem.
Ceny se řídí platným tarifem.
10.2 Postup zpracovávání těchto prodejů v CC pro dělbu mezi dopravce
1) Nepřestupní - prodej zůstává dopravci, který ji prodal, rozpočet do Ostrava XXL
2) Přestupní - prodej se dělí mezi dopravce podle využití, rozpočet do Ostrava XXL , včetně
nástupní sazby jako u platby z EP
3) Dokupovaná - prodej zůstává dopravci, který prodal, rozpočet do Ostrava XXL
4) Region - pravidla stejná, jako při využívání platby z EP
5) Město – pravidla stejná, jako při využívání platby z EP
6) Celodenní OSTRAVA XXL - prodej se dělí mezi dopravce podle využití, rozpočet do Ostrava
XXL
7) Celodenní skupinová Ostrava XXL - prodej se dělí mezi dopravce podle využití, rozpočet do
Ostrava XXL
8) Prodej se dělí mezi Ostrava XXL a REGION (Město) v poměru využití obou oblastí bez
započítání autocappingu (v XXL projeto 90 Kč, v regionu 240 Kč, v Město 30 Kč : do XXL
připadne 25%, na region 67% , na Město 8% z ceny celosíťové jízdenky). Následně dojde
k rozdělení mezi dopravce podle využití.
56
9) Prodej se dělí mezi Ostrava XXL a REGION (Město) v poměru využití obou oblastí viz. bod 8.
Následně dojde k rozdělení mezi dopravce podle využití.
Veškeré prodeje za jednotlivé jízdné (bez provize) budou v CC do rozúčtování na dopravce vstupovat
pod fiktivního dopravce Koordinátor ODIS s.r.o., jelikož tyto platby budou zasílány nám. Následně
je na základě dělby tržeb přepošleme dopravci.
10.3 Postup při vyhodnocování jízdného v kombinaci s jízdným REGION nebo
MĚSTO při platbě platební kartou mimo situace, kdy cestující má zakoupeny
dokupované jízdenky v rámci OSTRAVA XXL:
1) Situace, kdy cestující jede pouze v oblasti REGION nebo MĚSTO
autocapping 200 Kč - jízdenka celodenní síťová
2) Situace, kdy cestující jede v oblasti REGION nebo MĚSTO a OSTRAVA XXL
Nejdříve se vyhodnocuje jízdné OSTRAVA XXL
a) Pokud cestující nedosáhne v rámci OSTRAVA XXL autocappingu 100 Kč a v rámci celého systému
nedosáhne autocappingu 200 Kč je cena rovna projetým částkám dle tarifu:
př. za OSTRAVA XXL projeto 40 Kč, za REGION a MĚSTO projeto 60 Kč – celková stržená částka 60 + 40 =
100 Kč - jízdenky přestupní, nepřestupní, region a město
b) Pokud cestující dosáhne v rámci OSTRAVA XXL autocappingu 100 Kč a v rámci celého systému nedosáhne
autocappingu 200 Kč je cena rovna součtu celodenní jízdenky OSTRAVA XXL a projetým částkám dle tarifu
REGION a MĚSTO:
př. Za OSTRAVA XXL projeto více jak 100 Kč, za REGION a MĚSTO projeto 60 Kč – celková stržená částka
100 (autocapping OSTRAVA XXL) + 60 = 160 Kč - jízdenky celodenní OSTRAVA XXL, region a město
c) Pokud cestující nedosáhne v rámci OSTRAVA XXL autocappingu 100 Kč a v rámci celého systému dosáhne
autocappingu 200 Kč je cena rovna celodenní síťové jízdence dle tarifu:
př. Za OSTRAVA XXL projeto 40 Kč, za REGION a MĚSTO projeto více jak 160 Kč – celková stržená částka
200 Kč - jízdenka celodenní síťová
d) Pokud cestující dosáhne v rámci OSTRAVA XXL autocappingu 100 Kč a v rámci celého systému dosáhne
autocappingu 200 Kč je cena rovna celodenní síťové jízdence dle tarifu:
př. Za OSTRAVA XXL projeto více jak 100 Kč, za REGION projeto více jak 120 Kč – celková stržená částka 200
Kč - jízdenka celodenní síťová
3) Situace, kdy cestující jede pouze po OSTRAVA XXL
Dle pravidel platných v současnosti
a) Pokud cestující nedosáhne v rámci OSTRAVA XXL autocappingu 100 Kč:
př. za OSTRAVA XXL projeto 40 Kč – celková stržená částka 40 Kč - jízdenky přestupní a nepřestupní
b) Pokud cestující dosáhne v rámci OSTRAVA XXL autocappingu 100 Kč je cena rovna celodenní jízdence
OSTRAVA XXL:
př. Za OSTRAVA XXL projeto více jak 100 Kč – celková stržená částka 100 Kč (autocapping OSTRAVA XXL)
Kč - jízdenka celodenní OSTRAVA XXL
57
10.4 Vyhodnocení stržené částky v situaci, kdy cestující jede v OSTRAVA XXL,
v REGIONU nebo MĚSTĚ a má pro tarifní oblast OSTRAVA XXL zakoupeny
dokupované jízdenky:
Systém musí vyhodnotit obě možné varianty výpočtu:
a) Vyhodnotit nejdříve majitele BK bez dokupů dle výše uvedeného postupu (body 1) a 2)) pro BK v rámci
OSTRAVA XXL, REGIONU a MĚSTA + přičíst částky za dokupy
b) Vyhodnotit nejdříve oblast OSTRAVA XXL včetně dokupů dle bodu 3) + přičíst částky za REGION a MĚSTO
10.5 Příklad č. 1:
V rámci OSTRAVA XXL projede 130 Kč, v rámci REGION a MĚSTO projede 150 Kč, dokupy v rámci
OSTRAVA XXL 140 Kč.
Výpočet:
a) 130 Kč OSTRAVA XXL – autocapping na 100 Kč
+
150 Kč REGION a MĚSTO
=
250 Kč – autocapping na 200 Kč
+ dokupy OSTRAVA XXL 140 Kč – celková částka 340 Kč - jízdenky celodenní síťová a
dokupované
b) 130 Kč OSTRAVA XXL – autocapping na 100 Kč
+
140 Kč dokupy OSTRAVA XXL
=
240 Kč – autocapping na 200 Kč
+ REGION a MĚSTO 150 Kč – celková částka 350 Kč- jízdenky celodenní skupinová a region
a město
Systém následně vyhodnotí nejvýhodnější částku pro cestujícího mezi variantami a) a b) a tuto
zadá ke stržení - tudíž částku 340 Kč.
10.6 Příklad č. 2:
V rámci OSTRAVA XXL projede 130 Kč, v rámci REGION a MĚSTO projede 150 Kč, dokupy v rámci
OSTRAVA XXL 170 Kč.
Výpočet:
a) 130 Kč OSTRAVA XXL – autocapping na 100 Kč
+
150 Kč REGION a MĚSTO
=
230 Kč – autocapping na 200 Kč
+ dokupy OSTRAVA XXL 170 Kč – celková částka 370 Kč - jízdenky celodenní síťová a
dokupované
58
b) 130 Kč OSTRAVA XXL – autocapping na 100 Kč
+
170 Kč dokupy OSTRAVA XXL
=
250 Kč – autocapping na 200 Kč
+ REGION a MĚSTO 150 Kč – celková částka 350 Kč- jízdenky celodenní skupinová a region
a město
Systém následně vyhodnotí nejvýhodnější částku pro cestujícího mezi variantami a) a b) a tuto
zadá ke stržení – tudíž částku 350 Kč.
10.7 Příklad č. 3:
V rámci OSTRAVA XXL projede 60 Kč, v rámci REGION a MĚSTO projede 250 Kč, dokupy v rámci
OSTRAVA XXL 210 Kč.
Výpočet:
a) 60 Kč OSTRAVA XXL
+
250 Kč REGION a MĚSTO
=
310 Kč – autocapping na 200 Kč
+ dokupy OSTRAVA XXL 210 Kč – autocapping na 200 Kč celková částka 400 Kč - jízdenky
celodenní síťová + celodenní skupinová
b) 60 Kč OSTRAVA XXL
+
210 Kč dokupy OSTRAVA XXL
=
270 Kč – autocapping na 200 Kč
+ REGION a MĚSTO 250 Kč – autocapping na 200 Kč celková částka 400 Kč- jízdenky
celodenní skupinová a celodenní síťová
Jelikož oba navrhované příklady vyhodnotí částku stejně, dle dohody systém upřednostní
výpočet dle varianty b).
10.8 Příklad č. 4:
V rámci OSTRAVA XXL projede 150 Kč, v rámci REGION a MĚSTO projede 350 Kč, dokupy v rámci
OSTRAVA XXL 310 Kč.
Výpočet:
a) 150 Kč OSTRAVA XXL – autocapping na 100 Kč
+
350 Kč REGION a MĚSTO
=
450 Kč – autocapping na 200 Kč
59
+ dokupy OSTRAVA XXL 310 Kč – autocapping na 200 celodenní skupinová – celková částka
400 Kč
b) 150 Kč OSTRAVA XXL – autocapping na 100 Kč
+
310 Kč dokupy OSTRAVA XXL
=
410 Kč – autocapping na 200 Kč
+ REGION a MĚSTO 350 Kč – autocapping na 200 Kč celodenní síťová – celková částka 400
Kč
Systém následně vyhodnotí nejvýhodnější částku pro cestujícího mezi variantami a) a b) a tuto
zadá ke stržení – tudíž 400 Kč.
60
11 VYSTAVENÍ DAŇOVÝCH DOKLADŮ
V případě, že nebudou jízdenky za celý zúčtovací den zastropovány na celodenní síťové jízdné,
bude se daňový doklad tisknout vždy pod hlavičkou dopravce, který jízdenku vydal/vystavil a zaslal
do zúčtování.
V případě, že však jízdenky za celý zúčtovací den dosáhnou celodenního stropu, bude se daňový
doklad tisknout vždy pod hlavičkou dopravce, který jako první vydal v dané zastropované jízdence
lístek.
11.1 Příklady jednotlivých daňových dokladů při dosažení celodenního stropu
Příklad 1. Celodenní jízdenka OV XXL cena 100 Kč
1 dopravce DPO
2 dopravce DPO
3 dopravce ČSAD Havířov
4 dopravce ČD
…..
Celodenní jízdenka OV XXL pod daňovým dokladem DPO
Příklad 2. Celodenní jízdenka OV XXL cena 100 Kč
1 dopravce ČSAD Havířov
2 dopravce DPO
3 dopravce ČD
4 dopravce DPO
5 dopravce DPO
6. dopravce DPO
…
Celodenní jízdenka OV XXL pod daňovým dokladem ČSAD Havířov
Příkdad 3. Celodenní skupinová jízdenka OV XXL cena 200 Kč
1 dopravce DPO
2 dopravce DPO
3 dopravce ČSAD Havířov
4 dopravce ČD
…..
Celodenní skupinová jízdenka OV XXL pod daňovým dokladem DPO
Příklad 4. Celodenní síťová jízdenka cena 200 Kč
1 dopravce ČD
2 dopravce DPO
3 dopravce ČSAD Havířov
4. dopravce DPO
…
Celodenní síťová jízdenka pod daňovým dokladem ČD
61
12 ROZHRANÍ PRO E-SHOP
12.1 Způsob platby
Na e-shopu bude možno provést platbu těmito způsoby:
• Bankovní kartou,
• Platebním tlačítkem.
Na e-shopu nebude umožněno platit převodem na účet.
12.2 Rozhraní pro e-shop
Pro přenos informací pro eshop definujeme 7 zpráv. Přehled definovaných zpráv:
Metoda Popis
RegisterBankCardCoupon Zaslání zakoupeného kupónu ke kartě, může použít e-
GetUserBankCard shop nebo i přepážka alternativa k whitelistu
Dotaz na karty k registrovanému účtu
GetBankCardCoupon Dotaz na kupóny na dané kartě
GetRegNo Zaslání nového registračního ID
GetCouponList Vrátí seznam prodaných kupónů prodaných na eshopu
ChangeBankCardProfile Změna profilů na bankovní kartě
GetUnregisteredBankCardList Vrátí seznam odregistrovaných karet, ke kterým je možno
smazat osobní údaje
RegisterBankCardCoupon
Request Typ Popis Default Required?
Parametr String Uživatelský login provozovatele N/A Yes
UserLogin String Uživatelské heslo provozovatele N/A Yes
Password
BankCardCoupon Bigint Číslo zařízení N/A Yes
DeviceNo Byte Sazba DPH N/A Yes
Vat String Token bankovní karty N/A Yes
Token Int Číslo transakce N/A Yes
TxID Datetime Datum provedení transakce N/A Yes
When String Linka pro identifikaci provozovny N/A Yes
Line Short Profil zákazníka N/A Yes
CustomerProfile Short N/A Yes
TariffProfile Datetime Tarifní profil N/A Yes
ValidFrom Datetime Platnost od N/A Yes
ValidTo Decimal Platnost do N/A Yes
Amount Cena kupónu
62
AmountType String Typ platby (hotovost, bankovní karta, , N/A Yes
Zone platební brána) N/A Yes
Response
Parametr Seznam zón oddělených středníkem
CouponID
ResponseStatus Typ Popis Default Required?
ErrorCode
Guid Identifikační číslo registrovaného kupónu N/A Yes
ErrorMessage
Int Stav zpracování N/A Yes
0 – OK
Jinak číslo chyby N/A Yes
String Popis chyby
GetUserBankCard
Request Typ Popis Default Required?
Parametr String Uživatelský login provozovatele N/A Yes
UserLogin String Uživatelské heslo provozovatele N/A Yes
Password String N/A Yes
Email Email uživatele (držitele BK)
Response Typ Popis Default Required?
Parametr
BankCard String Token bankovní karty N/A Yes
Token
PanMas String Prvních 6 a poslední 4 čísla bankovní N/A Yes
karty
NameSurname String Jméno a příjmení držitele bankovní N/A Yes
karty
BirthDate Datetime Datum narození držitele bankovní N/A Yes
karty
Email String Email držitele bankovní karty N/A Yes
CardExpiration
Profile1 Datetime Expirace bankovní karty N/A Yes
Profile1ValidFrom
Short První profil držitele bankovní karty N/A Yes
Datetime Platnost prvního profilu od držitele N/A Yes
bankovní karty
Profile1ValidTo Datetime Platnost prvního profilu do držitele N/A Yes
Profile2 bankovní karty
Profile2ValidFrom Short Druhý profil držitele bankovní karty N/A No
Datetime Platnost druhého profilu od držitele N/A No
Profile2ValidTo bankovní karty
Datetime Platnost druhého profilu do držitele N/A No
bankovní karty
Photo Base64 Fotografie držitele bankovní karty N/A Yes
RegNo String Číslo registrace N/A Yes
RegisteredForCouponsDate Datetime Datum registrace BK pro nákup N/A No
kupónů
UnregisteredForCouponsDate Datetime Datum odregistrace BK pro nákup N/A No
BlockedDate kupónů N/A No
ConfirmedDate Datetime Datum blokace BK
Datetime Datum potvrzení BK N/A No
63
ResponseStatus Int Stav zpracování N/A Yes
ErrorCode
0 – OK
ErrorMessage Jinak číslo chyby N/A Yes
String Popis chyby
GetBankCardCoupon
Request Typ Popis Default Required?
Parametr String Uživatelský login provozovatele N/A Yes
UserLogin String Uživatelské heslo provozovatele N/A Yes
Password String Token bankovní karty N/A Yes- není-
Token li
String Číslo registrace N/A
RegNo vyplněno
RegNo
Yes – není-
li vyplněn
Token
Response Typ Popis Default Required?
Parametr
BankCardCoupons Bigint Číslo zařízení N/A Yes
DeviceNo Byte Sazba DPH N/A Yes
Vat String N/A Yes
Token Int Token bankovní karty N/A Yes
TxID Datetime N/A Yes
When String Číslo transakce N/A Yes
Line Short N/A Yes
CustomerProfile Short Datum provedení transakce N/A Yes
TariffProfile Datetime Linka pro identifikaci provozovny N/A Yes
ValidFrom Datetime N/A Yes
ValidTo Decimal Profil zákazníka N/A Yes
Amount N/A Yes
AmountType String Tarifní profil
Platnost od N/A Yes
Zone Platnost do
ResponseStatus N/A Yes
ErrorCode Cena kupónu
Typ platby (hotovost, bankovní karta, ,
platební brána)
Seznam zón oddělených středníkem
Int Stav zpracování
0 – OK
ErrorMessage Jinak číslo chyby N/A Yes
String Popis chyby
GetRegNo Typ Popis Default Required?
64
Request
Parametr
UserLogin String Uživatelský login provozovatele N/A Yes
Password String Uživatelské heslo provozovatele N/A Yes
Token String Token bankovní karty N/A Yes
Email String Email držitele bankovní karty N/A Yes
Response
Parametr Typ Popis Default Required?
RegNo String N/A Yes
BankCardStatus Registrační číslo N/A No
REGISTERED - karta již byla zaregistrovaná
UserStatus N/A Yes
a aktuálně je platná (není registrována
ResponseStatus
ErrorCode pro použití kupónů)
REGISTERED_Coupon - karta již byla
ErrorMessage
zaregistrovaná pro použití kupónů a
aktuálně je platná
BLOCKED – karta již byla zaregistrovaná a
aktuálně je blokovaná
UNREGISTERED – karta již byla
zaregistrovaná, ale aktuálně je
odregistrovaná- zaregistrovat v tomto
případě.
NOT_REGISTERED – karta ještě nebyla
zaregistrovaná - zaregistrovat v tomto
případě.
EXPIRED – karta je expirovaná
UNKNOWN – neznámý stav karty
EXISTS – účet pod daným emailovým
účtem již existuje
NOT_EXISTS – účet pod daným emailovým
účtem neexistuje
UNKNOWN – neznámý stav účtu
Int Stav zpracování N/A Yes
0 – OK
Jinak číslo chyby N/A Yes
String Popis chyby
GetCouponList Typ Popis Default Required?
String
Request String Uživatelský login N/A Yes
Parametr provozovatele
UserLogin Int N/A Yes
Uživatelské heslo
Password provozovatele N/A Yes
Typ CouponListu (celý,
CouponListType N/A No
inkrementální)
SequenceNoStart
Počáteční pořadové číslo
CouponListu
65
Response Typ Popis Default Required?
Parametr
CouponList String Verze souboru N/A No
CouponListHeader Datetime Datum vytvoření dávky N/A No
FileVersion Int N/A No
IssueDateTime Pořadové číslo N/A No
SequenceNo Int Typ CouponList (celý, inkremetnální) N/A No
CouponListType Bool N/A No
ItemsCount Počet kupónů
Reset Příznak, zdali došlo k resetu CouponListu N/A Yes
CouponListItem N/A Yes
Token String Token bankovní karty N/A Yes
When Datetime Datum provedení transakce N/A Yes
CustomerProfile Short Profil zákazníka N/A Yes
TariffProfile Short Tarifní profil N/A Yes
ValidFrom Datetime Platnost od N/A Yes
ValidTo Datetime Platnost do N/A Yes
Amount Decimal Cena kupónu N/A Yes
AmountType Typ platby (hotovost, bankovní karta,) N/A No
Zone String Seznam zón oddělených středníkem N/A Yes - pouze
OrderNo Int Variabilní symbol
StateCode ADD, DEL (přidání nebo odebrání kupónu) pro
inkrementální
ResponseStatus Int Stav zpracování WL
ErrorCode
N/A Yes
0 – OK
ErrorMessage String Jinak číslo chyby N/A Yes
Popis chyby
ChangeBankCardProfile
Request Typ Popis Default Required?
Parametr String Uživatelský login provozovatele N/A Yes
UserLogin String Uživatelské heslo provozovatele N/A Yes
Password String Token bankovní karty N/A Yes
Token
BankCardProfiles Short Profil držitele bankovní karty N/A Yes
Profile1 Datetime Platnost prvního profilu od držitele
Profile1ValidFrom bankovní karty N/A Yes
Platnost prvního profilu do držitele
Profile1ValidTo Datetime bankovní karty N/A Yes
Profil držitele bankovní karty
Profile2 Short Platnost prvního profilu od držitele N/A Yes
Profile2ValidFrom Datetime bankovní karty
N/A Yes
66
Profile2ValidTo Datetime Platnost prvního profilu do držitele N/A Yes
Response bankovní karty
Parametr
ResponseStatus Typ Popis Default Required?
ErrorCode Int N/A Yes
Stav zpracování
ErrorMessage String 0 – OK N/A Yes
Jinak číslo chyby
Popis chyby
GetUnregisteredBankCardList
Request Typ Popis Default Required?
Parametr String N/A Yes
UserLogin String Uživatelský login provozovatele N/A Yes
Password
Int Uživatelské heslo N/A Yes
UnregisteredBankCardListType provozovatele
Typ UnregisteredBankCardListu N/A No
SequenceNoStart (celý, inkrementální)
Počáteční pořadové číslo
UnregisteredBankCardListu
Response Typ Popis Default Required?
Parametr
UnregisteredBankCardList String Verze souboru N/A No
UnregisteredBankCardHeader Datetime Datum vytvoření dávky N/A No
FileVersion Int Pořadové číslo N/A No
IssueDateTime Typ UnregisteredBankCardList N/A No
SequenceNo Int (celý, inkremetnální)
UnregisteredBankCardListType Bool Počet kupónů N/A No
Příznak, zdali došlo k resetu N/A No
ItemsCount String UnregisteredBankCardu
Reset Datetime N/A Yes
Token bankovní karty N/A Yes
UnregisteredBankCardListItem Datum odregistrace bankovní
Token karty N/A Yes - pouze
Date ADD, DEL (přidání nebo odebrání pro
kupónu) inkrementální
StateCode WL
ResponseStatus Int Stav zpracování N/A Yes
ErrorCode
0 – OK
Jinak číslo chyby
67
ErrorMessage String Popis chyby N/A Yes
68
Struktura 2D kódu
pro jízdní doklady ODIS
Verze 1.5
Historie změn:
Verze Datum Jméno Důvod vydání Status
1.0 14. 4. 2020 Matocha (ODP)
1.1 24. 4. 2020 Nenka vznik dokumentu N
1.2 14. 8. 2020 Matocha (ODP)
Doplnění printsceenu aplikace N
Aktualizace, doplnění výpočtu N
dynamického proužku
1.3 15. 3. 2021 Matocha (ODP) Doplnění postupu ověření N
dynamické hodnoty v QR
1.4 23. 3. 2021 Nenka Odstranění neexistujících N
odkazů
1.5 30. 3. 2021 Nenka Doplnění, že zastávky budou A
v CIS
Status : A – Aktuálně platný, R – Revize, N – Neplatný
Tento dokument a veškerý jeho obsah jsou chráněny autorským právem a dokument i veškerý jeho
obsah je, s eventuální výjimkou explicitně odkazovaného obsahu, majetkem společnosti Koordinátor
ODIS s. r. o., IČ 27408256, se sídlem 28. října 3388/111, Moravská Ostrava, 702 00 Ostrava. Tento
dokument nesmí být reprodukován ani citován ať zčásti nebo vcelku bez předchozího písemného
souhlasu jeho majitele.© Copyright ODP-software, spol. s r. o. 2021.
1
Obsah
1 Struktura QR kódu......................................................................................................... 3
1.1 QR kód jízdenky ODIS..................................................................................................... 3
1.2 MAP struktura dat ODIS .................................................................................................. 3
REC_TICKET_HEADER .......................................................................................................................... 6
REC_TICKET_BASIC .............................................................................................................................6
REC_TICKET_SELL ............................................................................................................................. 14
1.3 Ověření bezpečnostního proužku na odbavovacím zařízení ...............................................14
1.1.1 Výpočet barev grafického prvku .............................................................................................. 14
1.1.2 Výpočet alfanumerických znaků grafického prvku......................................................................15
1.2 Příklad výpočtu:.............................................................................................................15
1.4 Příklad jízdenky ODIS.....................................................................................................16
2. Komunikace se serverem............................................................................................. 17
2.1 Aktuální serverový čas ...................................................................................................17
2.2 Tajné hodnoty ...............................................................................................................17
2
Úvod
Tento dokument popisuje 2D kód používaný v mobilní aplikaci Můj ODIS.
1 Struktura QR kódu
1.1 QR kód jízdenky ODIS
Pro uložení jízdního dokladu je použit QR kód. S ohledem na velikost displeje pro zobrazení QR
kódu a citlivost odbavovacích zařízení je jako maximální limit pro velikost jednoho kódu stanoveno 1091
B (QR kód verze 23). Jsou-li přenášená data menší než 1091 B, je automaticky použit QR kód nižší
verze.
Může dojít k situaci, kdy je potřeba přenášet větší data, tedy je nutné zobrazit více než jeden QR
kód. V tom případě je použit tzv. „cyklický“ („dynamicky se měnící“) QR kód, tedy více kódů limitní
velikosti, které se na displeji zařízení pravidelně střídají.
1.2 MAP struktura dat ODIS
Z pohledu dodavatelů prodejních a odbavovacích zařízení je datová věta, uložená do 2D kódu,
definována jako struktura REC_MAPPHONE_DATA v dokumentu MAP Karta – Datové struktury (verze
13), kterou mají k dispozici.
Přenášená data se skládají z následujících částí:
– Metadata o přenášené struktuře
– Jízdenky a jejich podpisy
– Průkazy a jejich podpisy (pro ODIS nevyužito).
– Identity Pack a podpis (pro ODIS nevyužito).
– Dodatečná data definovaná zákazníkem (bez podpisu) (pro ODIS nevyužito).
Tato data jsou rozdělena do úseků o velikosti až 1089 B, každý úsek bude opatřen hlavičkou, tzv.
řídícími byty, které mají hexadecimální strukturu 0xCCXY, kde:
– CC je indikátor cyklického kódu, má hodnotu 0xCC,
– X je pořadové číslo QR kódu z intervalu [0, 15],
– Y je celkový počet QR kódů.
Výsledných až 1091 bytů je přeneseno v jednom QR kódu, jednotlivé úseky jsou sestaveny v paměti
odbavovacího zařízení.
Položka Popis Počet Poznámka
bytů
Verze Konstantně hodnota „1“ Povinné
struktury 1
Info o struktuře (vizte níže) Povinné
Metadata REC_TICKET_HEADER 1 Pro ODIS zatím vždy
12 jeden nebo více
Jízdenky výskytů
(Opakuje se dle
počtu jízdenek)
3
Průkazy REC_TICKET_BASIC 39 Proměnlivá délka
(Opakuje se dle REC_TICKET_SELL 15 Big endian
počtu průkazů) Počet segmentů 1
Až 4 segmenty Max. 112 Na ODIS nevyužito
Identity Pack ID účtu 4 (hodnota 0, další
ID ECC klíče 1 položky neuloženy)
Datová část ECC podpis 48 Big endian
specifická pro REC_PASSPORT_HEADER 12
zákazníka Na ODIS nevyužito,
Uživatelské REC_PASSPORT_DATA 36 tedy zde hodnota 0 a
jméno ID účtu 4 další položky nejsou
ID ECC klíče 1 uloženy
ECC podpis 48 Big endian
Info o identity packu (viz níže) 1
Big endian
Vydavatel identity packu (service 3 Proměnlivá délka
provider dle MAP číselníku)
Formát fotografie 1 BigEndian
Délka fotografie 2
Fotografie Max. 1300 Big endian
REC_CARDHOLDER_BASIC_INFO 18
REC_CARDHOLDER_PERSONAL_INFO 64 Pro ODIS vždy 2
Délka dat specifických pro poskytovatele 2
služeb
Data specifická pro poskytovatele služeb Max. 32767
ID účtu 4
ID ECC klíče 1
ECC podpis 48
Délka dat 2
Data Max. 32767 2 bajty obsahující
časové razítko QR
Délka uživatelského jména 2 kódu
Data Max. 32767
Pro ODIS vždy 0
(nevyužito) Big endian
Detailní popis vybraných položek:
4
Metadata – binární tvar JJJJPPPP, kde
– JJJJ je číslo z intervalu [0, 15] a značí počet jízdenek v přenášených datech (pro ODIS nyní
vždy 1 nebo více),
– PPPP je číslo z intervalu [0, 15] a značí počet průkazů v přenášených datech (pro ODIS nyní
vždy 0),
Info o identity packu – binární tvar SSDDDDHH, kde SS je číslo z intervalu [0, 3] a značí stav
identity packu:
Hodnota Význam
0 Nepřítomný (v tomto případě je „Info o identity packu“ jediný přítomný byte
z celého identity packu)
1 Potvrzený
2 Nepotvrzený, obsluha zařízení by měla provést verifikaci osobních údajů a fotky
3 Zamítnutý
– DDDD je číslo z intervalu [0, 127] a jedná se o pořadové číslo identity packu v rámci jednoho
účtu;
– HH jsou příznaky, zda jsou přítomny struktury nesoucí informace o držiteli: 0 – není přítomna,
1 – je přítomna. Vyšší bit značí REC_CARDHOLDER_BASIC_INFO, nižší
REC_CARDHOLDER_PERSONAL_INFO.
ID ECC klíče – identifikátor klíče v rámci číselníku poskytovatele služeb, který vydal produkt.
S číselníkem musí být obeznámena odbavovací zařízení a na základě identifikátoru musí být schopna
dohledat příslušný veřejný klíč. Podpisový klíč je tajný a musí být držen v bezpečném úložišti (SAM
modul, HSM, …). Pro jízdenky ODIS je vždy uvedena hodnota 0x01. Ostré jízdenky lze ověřit pomocí
veřejného klíče s hodnotou:
04 20 F1 B8 12 A9 F6 1A 6D CC ED 18 9A 0E A7 98 80 1F 35 CC 53 9B 50 FB
29 4D 34 1E 7E C1 9F AC 1D 66 FF 48 89 6B 38 96 C2 12 3A 7F CC B9 E1 3F D9
ECC podpis – podpis je kódován jako dvě neznaménková čísla, každé do 24 bytů, použitá eliptická
křivka secp192r1.
ID účtu – číselný identifikátor účtu, přiřazený serverem v okamžiku založení. Odbavovací zařízení
musí zkontrolovat, že se identifikátory ve všech předkládaných produktech rovnají.
Formát fotografie – číselník formátů:
Hodnota Význam
0 Ztrátové WEBP
1 Bezztrátové WEBP
2 JPG
3 PNG
4 – 255 RFU
5
REC_TICKET_HEADER Bitů Typ Hodnota / význam
Název 7 Status Code Status jízdenky (vychází z kapitoly 7.27
TicketStatus EN 1545-1). Na ODIS nyní vždy 7 (platný
doklad)
ContractValidityBeginDate 14 Date Stamp Datum počátku platnosti dokladu
Čas počátku platnosti dokladu
ContractValidityBeginTime 11 Time Stamp Poslední den platnosti dokladu
Čas konce platnosti dokladu
ContractValidityEndDate 14 Date Stamp Omezení platnosti jízdenky na vybranou
síť (ODIS: 134)
ContractValidityEndTime 11 Time Stamp Omezení platnosti jízdenky pouze na
vybraného dopravce (0: nevyužito, platí
ContractNetworkID 12 Network ID v celé síti dle contractNetworkID)
Viditelný pro jiné dopravce? V rámci ODIS
ContractProviderID 24 Provider ID vždy 1.
Platnost dokladu může být přerušen? (na
VisibleForOtherProviders 1 FLAG ODIS nevyužito)
IsInterrupted 1 FLAG
RFU 1 12 B
Celkem 96 b,
REC_TICKET_BASIC Bitů Typ Hodnota / význam
Název 8 ENUM
NipSystem 16 INTEGER(0..8190) Způsob práce se souborem
TicketValidityFromNip kleští (s časovou platností
2 ENUM jízdenky).
LastContractValidityType
Pro ODIS konstantě 0.
Pokud není nastaven
v hlavičce příznak
IsInterrupted, pak platnost
jízdenky od posledního
označení v minutách. Pokud
je příznak IsInterrupted
nastaven, pak číslo určuje
od kdy na kolik dnů je
platnost dokladu přerušena.
ODIS konstantě 0 –
nevyužito.
Typ hodnoty
LastContractValidity
ODIS konstantě 0 –
nevyužito.
6
LastContractValidity 14 INTEGER(0..16383) Hodnota prolongace
ContractPriceUnit dokladu ODIS konstantě 0 –
nevyužito.
ContractPaymentMeans
ContractPrice 4 Pay Unit Map Měna a násobek ceny
ContractID
PreviousContractID jízdního
LinkToOriginalTicket
dokladu při prodeji nebo
DocumentType prolongaci
NumberOfTicketsTotal ‘0000‘B – CZK v celých
korunách
‘1000’B – CZK v haléřích
‘0001‘B – EUR v celých
jednotkách
‘1001’B – EUR v centech
Pro ODIS CZK v haléřích.
4 Payment Means Typ platby při prodeji nebo
prolongaci jízdního dokladu.
Pro ODIS 0
(nespecifikováno)
32 INT4 Cena dokladu v jednotkách
dle ContractPriceUnit
16 INT2 Číslo aktuálního/budoucího
kontraktu (v systémech,
které číslo kontraktu
používají).
16 INT2 Číslo předchozího kontraktu
(používá se při prolongaci)
4 Ukazuje na doklad, ke
kterému byl tento doklad
vydán (například ke
kterému je tento doklad
doplatkem). Lze využít
pouze při více dokladech
v jednom 2D kódu.
4 ENUM Typ dokladu.
0: Jízdenka / místenka /
„kupón“ MHD
1: Pokuta
2: Změna jízdenky /
rozšíření jízdenky
3: Doplatková jízdenka
V ODIS vždy 0: Jízdenka
5 INTEGER(0..31) Počet koupených jízdenek.
Obvykle 1; má smysl
u jízdenek, jejichž platnost
7
ContractVehicleClassCodeRestriction 3 ENUM začíná až první validací (ve
vozidle, na nástupišti, …).
TicketNumber 8 INT1
Povolená vozová třída (v
ContractValidityRestrictDay 8 Restrict Days of závislosti na dopravním
Week prostředku)
0: bez omezení
ContractValidityRestrictCode 8 INT1 (nespecifikováno)
1: 1. třída nebo její
CustomerProfile1 16 INT2 ekvivalent (Business)
CustomerTariff1 16 INT1 2: 2. třída nebo jejich
ContractPassengers1 8 INT1 ekvivalent
(Economy/Standard)
3: Premium
4-7: RFU
V ODIS nespecifikováno.
Pořadí jízdenky (pro jednu
jízdu může být potřeba více
současně platných dokladů
– jízdenka + místenka
apod.).
V ODIS se nepoužívá.
Omezení platnosti na dny
(vhodné např. pro žákovské
jízdenky).
bity: 0 – 6 = Po až Ne, bit 7
= ‚h’ (vizte položku dále).
Nastavený bit = doklad
platí. Standardně tedy bude
vyplněno hodnotou 0x7F (7
bitů)
Omezení platnosti dle
číselníku, uplatňuje se,
pokud je nastaven nejvyšší
bit ‚h‘ položky
contractValidityRestrictDays.
První profil dokladu
cestujícího. Tento profil
ověřuje aplikační logika při
prodlužování.
První tarif cestujícího
(doplňující informace v
rámci profilu).
Počet cestujících s profilem
1.
8
ContractTransportMeansRestriction 12 ENUM Povolené dopravní
prostředky. 0 = bez
SpeciemenFlag 1 FLAG omezení.
ReturnTicketFlag 1 FLAG Příznak, že se jedná o
testovací doklad.
RFU 2 Příznak, že se jedná o
ExtendedPassengersFlag 1 FLAG zpáteční relační doklad
(relace je platná pro oba
TicketType 7 ENUM směry; pokud není bit
nastaven, je relace platná
RFU 8 pouze ve směru Z-Do).
VariantPart 88 Týká se jak jednorázových,
tak časových jízdních
Celkem 312 b 39 B dokladů.
Pokud je příznak nastaven,
první ze segmentů obsahuje
rozšířené informace o
cestujících (struktura
PassengersExtendedInfo)
Udává jak strukturu dat
jízdního dokladu, tak počet
segmentů, které doklad
zabírá nad rámec prvního
segmentu.
V ODIS připadají v úvahu
hodnoty:
- 2/18/34/50 pro
kilometrický relační
tarif
- 3/19/35/51 pro
zónový tarif
Variantní část. Obsah závisí
na TicketType. Vybrané
hodnoty jsou uvedeny pod
tabulkou
Dodatečné segmenty mají dynamickou strukturu. Ta závisí na
nastaveném bitu ExtendedPassengersFlag – pak je obsahem prvního dodatečně alokovaného
segmentu datová struktura PassengersExtendedInfo;
typu struktury dokladu TicketType. Od toho se odvíjí jak počet alokovaných dodatečných segmentů,
tak jejich struktura. Ta je popsána v následujících kapitolách.
9
Datová struktura PassengersExtendedInfo
Název Bitů Typ Hodnota / význam
CustomerProfile2 16 INT2 Typ druhého CP (obvykle sleva)
CustomerTariff2 16 INT1 Rozšiřující informace o druhém CP
ContractPassengers 8 INT1 Počet spolucestujících osob s druhým CP
2
CustomerProfile3 16 INT2 Typ třetího CP (typicky spolucestující věci (zavazadlo, pes))
CustomerTariff3 16 INT1 Rozšiřující informace o typu dokladu spolucestující věci
ContractPassengers 8 INT1 Počet spolucestujících osob se třetím CP.
3
CustomerProfile4 16 INT2 Čtvrtý typ CP dokladu
CustomerTariff4 16 INT1 Rozšiřující informace o čtvrtém CP dokladu
ContractPassengers 8 INT1 Počet spolucestujících osob s profilem 4
4
OverbookingFlag 1 FLAG Dle UIC 918-3 a UIC 918-2 ANNEX 3a
CorporateFrequent 1 FLAG Dle UIC 918-3 a UIC 918-2 ANNEX 3a
CustomerFrequent 1 FLAG Dle UIC 918-3 a UIC 918-2 ANNEX 3a
RFU 37
CustomerID 64 BCD Číslo uživatelské karty, ID průkazu či jiná identifikace cestujícího
STRING(8)
Celkem 224 b, 28 B
TicketType
Struktura čísla identifikujícího typ je tvořena dle následujícího pravidla:
b6 b5 b4 b3 b2 b1 b0
X S S T T T T
Rezervováno Počet dodatečných Struktura dat dokladu
segmentů
Platí, že pokud informace o směrování zaberou více segmentů, pak identifikace jedné stanice / zóny
nemůže „přetéct“ mezi více segmenty.
Čísla zastávek (výchozí a cílové stanice) budou uváděna vždy podle číselníku CIS.
TicketType může nabývat následujících hodnot:
ticketType Význam
0 Doklad nemá trasu (síťová jízdenka). Nepotřebuje žádné dodatečné segmenty.
1 Jednoduchý relační doklad Z, Do a volitelně Přes bez nároků na dodatečný segment.
Určen pro systémy se zónově-relačním tarifem. Nepočítá s variantou jízdenky pro více
10
PTO na jednom dokladu.
17 Shodně jako TicketType = 1 v případě, že je potřeba uložit větší počet nácestných zón.
Ty jsou uloženy do jednoho segmentu.
33 Shodně jako TicketType = 1 v případě, že je potřeba uložit větší počet nácestných zón.
Ty jsou uloženy do dvou segmentů.
49 Shodně jako TicketType = 1 v případě, že je potřeba uložit větší počet nácestných zón.
Ty jsou uloženy do tří segmentů.
2 Kilometrický doklad Z, Do a volitelně Přes bez nároků na dodatečný segment. Určený
pro autobusové a železniční jízdenky. Nepočítá s variantou jízdenky pro více PTO na
jednom dokladu.
18 Shodně jako TicketType = 2 v případě, že je potřeba uložit větší počet nácestných
stanic. Ty jsou uloženy do jednoho.
34 Shodně jako TicketType = 2 v případě, že je potřeba uložit větší počet nácestných
stanic. Ty jsou uloženy do dvou segmentů.
50 Shodně jako TicketType = 2 v případě, že je potřeba uložit větší počet nácestných
stanic. Ty jsou uloženy do tří segmentů.
3 Doklad je dán výčtem zón. Je určen typicky pro jedno až třízónové jízdenky systémů
integrované dopravy, které určují trasu výčtem zón.
19 Shodně jako TicketType = 3 pro případy, kdy je potřeba uložit větší počet zón. Zabírají
1 dodatečný segment.
35 Shodně jako TicketType = 3 pro případy, kdy je potřeba uložit větší počet zón. Zabírají
2 dodatečné segmenty.
51 Shodně jako TicketType = 3 pro případy, kdy je potřeba uložit větší počet zón. Zabírají
3 dodatečné segmenty.
4 Místenka, bez alokace dodatečného segmentu (zejm. pro potřeby ČD, nyní
nedefinováno)
20, 36, 52 Místenka, alokován jeden, dva, resp. tři dodatečné segmenty (nyní nevyužito)
5 Kilometrický doklad Z, Do a Přes bez nároků na dodatečný segment. Určený pro
autobusové a železniční jízdenky pro více PTO na jednom dokladu.
21, 37, 53 Shodně jako TicketType = 5, je alokován jeden, dva, resp. 3 dodatečné segmenty.
6 Bezešvá jízdenka (platná pro jednoho nebo více PTO v rámci jednoho dokladu), bez
dodatečného segmentu.
11
22, 38, 54 Shodně jako TicketType = 6, je alokován jeden, dva, resp. 3 dodatečné segmenty.
15, 31, 47, Datový obsah variantní části je zcela v režii PTO (žádný, jeden, dva nebo tři dodatečné
63 segmenty).
TicketType = 2, Kilometrická relační jízdenka
VariantPart má následující strukturu:
Název Bitů Typ Hodnota / význam
ContractJourneyEle 5 INTEGER(0..31) Velikost reprezentace jedné stanice zmenšená o jednu
mSize v bitech
ContractJourneyVia 5 INTEGER(0..31) Počet stanic přes
Count
ContractJourneyLe 10 INTEGER(0..1024) Délka trasy v kilometrech / tarifních jednicích
ngth
ContractJourneyFro Dle contractJourneyElemSize, Kód výchozí stanice
m max 32 bitů
ContractJourneyTo Dle contractJourneyElemSize, Kód cílové stanice
max 32 bitů
ContractJourney Dle contractJourneyElemSize, Výčet nácestných stanic, každá o velikosti dle
contractJourneyElemSize.
Celkem
88 b, 11 B
Směrování se musí vejít do 78 bitů. Pro 24 bitové kódy (např. železničních) stanic postačuje pro
uložení výchozí, cílové a jedné nácestné stanice. Pokud se směrování do této struktury nevejde, použije
se TicketType 18, 34 nebo 50 (podle počtu nácestných stanic) a je alokován jeden až tři dodatečné
segmenty. Platí, že nácestné stanice jsou v tomto segmentu uloženy všechny (není potřeba dodatečný
segment), nebo žádná (a všechny jsou v dodatečných segmentech).
Při ticketType = 1 není doplňující segment alokován.
TicketType = 18 / 34 / 50, Kilometrická relační jízdenka
VariantPart má následující strukturu:
Název Bitů Typ Hodnota / význam
Velikost reprezentace jedné stanice zmenšená o jednu
ContractJourneyEle 5 INTEGER(0..31) v bitech
mSize Počet stanic přes.
ContractJourneyVia 5 INTEGER(0..7) Délka trasy v kilometrech / tarifních jednicích
Count
Kód výchozí stanice
ContractJourneyLe 10 INTEGER(0..1024)
ngth Kód cílové stanice
ContractJourneyFro Dle contractJourneyElemSize
m
ContractJourneyTo Dle contractJourneyElemSize
12
Celkem 88 b, 11 B
Každý alokovaný dodatečný segment má strukturu:
Název Bitů Typ Hodnota / význam
ContractJourney 224 OCTET STRING(28)
Pole nácestných stanic. Velikost reprezentace jedné dle
Celkem 224 b, 28 B contractJourneyElemSize,tedy nejvíce 7 stanic při
contractJourneyElemSize = 31
TicketType = 3, Jednoduchá zónová jízdenka
VariantPart má následující strukturu:
Název Bitů Typ Hodnota / význam
ContractJourneyEle 5 INTEGER(0..31) Velikost reprezentace jedné zóny zmenšená o jednu
mSize 5 INTEGER(0..31) v bitech.
ContractJourneyVia 78 Počet zón
Count 11 B
ContractJourneyZo 88 b, Výčet zón
nes
Celkem
U tohoto typu jízdenky platí všechno nebo nic, buď se tedy všechny zóny vejdou do 78 bitů a není
potřeba dodatečný segment (tj. dodatečný segment není alokován), nebo je tento blok volný a zóny
jsou pouze v dodatečném segmentu/segmentech.
TicketType = 19 / 35 / 51, Zónová jízdenka s dodatečnými segmenty
VariantPart má následující strukturu:
Název Bitů Typ Hodnota / význam
ContractJourneyEle 5 INTEGER(0..31) Velikost reprezentace jedné zóny v bitech zmenšená o
mSize INTEGER(0..31) jednu.
ContractJourneyVia 5 Počet zón
Count 11 B
RFU 78
Celkem 88 b,
Je alokován příslušný počet dodatečných segmentů, každý se strukturou:
Název Bitů Typ Hodnota / význam
ContractJourneyZo 224 OCTET Seznam zón
nes STRING(28)
Celkem 224 b, 28 B
13
REC_TICKET_SELL
Struktura obsahuje informace o prodeji dokladu.
Název Bitů Typ Hodnota / význam
ActionDate 14
ActionTime 11 Date Stamp Datum prodeje nebo prolongace dokladu.
RFU 7
ActionProvider 24 Time Stamp Čas prodeje nebo prolongace dokladu.
ContractTransaction 64 RFU + zarovnání na celé B
Celkem 120 b Provider ID Kód dopravce/výdejce, který provedl poslední
prodejní operaci
OCTET STRING(8) Jedinečný identifikátor prodejní transakce v
systému výdejce.
15 B
1.3 Ověření bezpečnostního proužku a časového razítka na
odbavovacím zařízení
Odbavovací zjistí ze serveru (viz kapitola 3) aktuální serverový čas T a zobrazí na displeji dva grafické
prvky: pro čas T – 15 sekund a pro čas T + 15 sekund. Obsluha považuje údaje na displeji mobilního
telefonu za platné, pokud se grafický prvek v mobilním telefonu shoduje s jedním z grafických prvků
zobrazených v odbavovacím zařízení.
1.1.1 Výpočet barev grafického prvku
Odbavovací zařízení získá dvojici barev pro grafický prvek pro daný vstupní čas následujícím
postupem:
1. Odbavovací zařízení stáhne ze serveru nebo načte z lokálního úložiště dříve stažené tajné hodnoty SC0,
SC1, SC2, SC3 pro vstupní serverový čas (viz kapitola 2.2) posunutý o 15 vteřin do minulosti nebo do
budoucnosti.
2. Vypočítá X = posunutý serverový čas v milisekundách od půlnoci 1. ledna 1970 GMT.
3. Vypočítá T = X / 30000. Číslo T dále interpretuje jako 4 byty T0, T1, T2 a T3. T0 značí nejnižší byte a T3
nejvyšší byte čísla T ve formátu big endian.
4. Vypočítá byty G1, B1, R2, G2 jako:
a. G1 = ((T0 XOR T1 XOR T2 XOR SC0) krát LC0) & 0xFF
b. B1 = ((T0 XOR T2 XOR T3 XOR SC1) krát LC1) & 0xFF
c. R2 = ((T0 XOR T1 XOR T2 XOR T3 XOR SC2) krát LC2) & 0xFF
d. G2 = ((T0 XOR T1 XOR T3 XOR SC3) krát LC3) & 0xFF,
kde hodnoty LC0, LC1, LC2 a LC3 jsou tajné konstanty bezpečně předané dodavateli
odbavovacího zařízení.
5. Získá první barvu definovanou pomocí RGB, kde R = 0, G = G1, B = B1.
6. Získá druhou barvu definovanou pomocí RGB, kde R = R2, G = G2, B = 0.
7. Zobrazí obě barvy na displeji, první barvu vlevo, druhou barvu vpravo.
1.1.1.1 Příklad kódu
Následující kód zachycuje výše uvedený postup v jazyce Java:
14
Date serverTime = getServerTime(); //ziskani serveroveho casu
long X = serverTime.getTime();
int T = (int) (X / 30000);
byte[] sc = getServerValues(serverTime); //ziskani tajných hodnot ze serveru pro dany cas
int[] lc = getLocalConstants(); //nacteni tajnych konstant
int firstGreen = ((xorAll((byte) T, (byte) (T >> 8), (byte) (T >> 16), sc[0]) * lc[0])& 0xFF);
int firstBlue = ((xorAll((byte) T, (byte) (T >> 16), (byte) (T >> 24), sc[1]) * lc[1]) &
0xFF);
int secondRed = ((xorAll((byte) T, (byte) (T >> 8), (byte) (T >> 16), (byte) (ltInt >> 24),
sc[2]) * lc[2]) & 0xFF);
int secondGreen = ((xorAll((byte) T, (byte) (T >> 8), (byte) (T >> 24), sc[3]) * lc[3]) &
0xFF);
Integer firstColor = Color.argb(255, 0, firstGreen, firstBlue);
Integer secondColor = Color.argb(255, secondRed, secondGreen, 0);
return new Pair<>(firstColor, secondColor);
1.1.2 Výpočet alfanumerických znaků grafického prvku a časového razítka QR
Pro dvojici barev (a jejich složky G1, B1, R2, G2 získané postupem popsaným v předchozí kapitole)
získá odbavovací zařízení alfanumerické znaky následujícím postupem:
1. Spočítá hash SHA-512 ze vstupního pole [12, 119, 3, 6, 255, 0, G1, B1, 255, R2, G2, 0]
2. První dva bajty výsledného hashe zobrazí jako 4 hexadecimální znaky (0-9A-F) na displeji.
Poznámka: Tytéž dva bajty jsou zároveň uloženy v QR kódu v položce „Datová část specifická pro
zákazníka“. Zařízení po načtení QR kódu ověří, zda uložené bajty odpovídají bajtům získaným
popisovaným postupem.
1.2 Příklad výpočtu:
Vstupní hodnoty:
X = 1556541913447
SC0 = 5
SC1 = 27
SC2 = 12
SC3 = 19
LC0 = 101
LC1 = 57
LC2 = 67
LC3 = 31
Výstupy:
G1 = 66
B1 = 77
R2 = 48
15
G2 = 232
Alfanumerický řetězec: EE 93
1.4 Příklad jízdenky ODIS
16
2. Komunikace se serverem
2.1 Aktuální serverový čas
MapPhoneServer sděluje aktuální serverový čas pomocí webové služby:
GET https://mphs.kodis.cz/mapphoneserverodis/MapPhoneServerWS.svc/time
Odpověď
200 OK
{
"Status": "OK",
"Timestamp": "20190222083428"
}
kde Timestamp značí aktuální čas serveru ve formátu „YYYYMMDDHHmmss“.
Odbavovací zařízení musí pravidelně zjišťovat a ukládat odchylku svého systémového času od
serverového času MapPhoneServeru tak, aby bylo následně schopno zobrazit grafický prvek i
v případě nedostupného spojení se serverem.
2.2 Tajné hodnoty
MapPhoneServer sděluje tajné hodnoty pro grafický prvek na základě předaného uživatelského jména
a hesla:
POST https://mphs.kodis.cz/mapphoneserverodis/MapPhoneServerWS.svc/getVisualInspectionKeys
{
"User":"prihlasovaci_jmeno",
"Password":"heslo",
"BeginDateTime":"20180816091300",
"EndDateTime":"20180823091300"
}
Kde: User … přihlašovací jméno
Password … heslo
BeginDateTime … počátek intervalu, pro který mají být navráceny tajné hodnoty, ve formátu
„YYYYMMDDHHmmss“
EndDateTime … konec intervalu, pro který mají být navráceny tajné hodnoty, ve formátu
„YYYYMMDDHHmmss“. EndDateTime nesmí být větší než aktuální serverový čas navýšený o hodnotu
stanovenou konfigurací serveru (zpravidla 15 dnů).
Odpověď
17
200 OK
{
"Status": "OK",
"VIS": [
{
"ID": "896",
"S": "BHCrZg==",
"ValidFrom": "201808160900",
"ValidTo": "201808161000"
},
{
"ID": "897",
"S": "OOrGaw==",
"ValidFrom": "201808161000",
"ValidTo": "201808161100"
},
…
]
}
Sady tajných hodnot jsou v odpovědi uvedeny v poli VIS. Každý záznam v poli VIS obsahuje
informace:
ID … pořadové číslo jedné sady tajných hodnot
S … 4 bajty SC0 až SC3 kódované jako Base64
ValidFrom … počátek platnosti sady ve formátu YYYYMMDDHHmmss (včetně)
ValidTo … konec platnosti sady ve formátu YYYYMMDDHHmmss
Odbavovací zařízení musí zajistit pravidelné stahování tajných hodnot tak, aby bylo následně schopno
zobrazit grafický prvek i v případě nedostupného spojení se serverem.
18
Technické a provozní standardy ODIS – Příloha č. 8
Komunikace s dispečinkem ODIS
Tato příloha pojednává o konkrétní podobě komunikace s dispečinkem ODIS formou
datových toků.
1. V7800.xsd – hlášení polohy vlaku pro IDS
• vehicleId - evidenční číso hnacího vozidla hlásící polohu (krátký formát,
nenaplňuje se),
• trainNumber - aktuální číslo vlaku,
• trainType - aktuální druh vlaku,
• trainId - ID záznamu vlaku v ISOŘ CDS (pomůcka pro párování),
• phoneNumber - telefonní číslo na hnací vozidlo (naplní se, pokud je
dostupné),
• time - aktuální čas události k oznamované poloze,
• delay - poslední známá výše zpoždění vlaku (náskoku – uváděn
znaménkem „-„),
• latitude+longitude – GPS souřadnice oznamované polohy (z GPS nebo
dopravního bodu),
• stopId - evidenční číslo dopravního bodu na 5 znaků (bez kontrolní
číslice)
• eventType - typ oznamované jízdy (příjezd/odjezd/průjezd)
Poznámka: Popis železniční sítě odpovídá síti KANGO, v rámci poloh pokud je
v zájmové oblasti může být definována i cizina (reálné jde o Slovensko po Bratislavu
a Žilinu a Rakousko po Vídeň, jiní sousedé a přechody v podstatě hlášení poloh větou
20 nejsou zajištěny).
2. V7801.xsd – hlášení očekávané polohy vlaku pro IDS
(připravuje se k pilotnímu ověření)
• Obsah zprávy identický s V7800, pouze jméno zprávy odlišuje „skutečná“ od
„očekávaná“.
1
3. V7810.xsd – oznámení požadavku na čekání přípojného
vlaku na jiný typ spoje IDS
• IdVlak - ID záznamu vlaku v ISOŘ CDS (pokud je v IDS znám).
• CisloVlaku - aktuální číslo vlaku k danému bodu čekání.
• MistoCekani - evidenční číslo dopravního bodu čekání na 5 znaků (bez
kontrolní číslice).
• PovolitOdjezd – předpokládaný čas odjezdu po přestupu cestujících ze
zpožděného spoje.
• LinkaSpoj - specifikace spoje linky, na kterou se čeká (definuje IDS).
4. RealnaHlaseniPoloh.txt – ukázka naplnění dat
z 11.10.2011 (otisk obsahu zprávy z komunikační brány
ISOŘ)
• druhý řádek je komunikační hlavička podle zásad TCP KS (používá se v celém
průtoku dat): autor ČD Telematika – Ing. František Rabčan 1999,
• čtvrtý a pátý vlastní obsah zprávy hlášení polohy vlaku.
4.1 Stručné vysvětlení komunikační hlavičky:
<#42422222222222 42460033295701 1752 10110403 XML V7800 04 >
# - řídící znak počátku zprávy
42422222222222 – komunikační proces odesílatele (4) : v tomto případě CDS,
lokalita (8) a identifikace PC (2)
42460033295701 – komunikační proces příjemce (4) : v tomto případě IDS, lokalita
(8) a identifikace PC (2)
1752 – pořadové číslo zprávy
10110403 – měsíc, den, hodina a minuta vzniku zprávy
XML – pomocná položka, naplnění dle domluvy řešitelů komunikujících aplikací
2
V7800 – jméno zprávy (V – jako vstupní informace a vlastní číslo zprávy dle domluvy
řešitelů komunikujících aplikací, na typ zprávy V se odpovídá kvitancí jména K –
akceptováno nebo N – neakceptováno)
0 – způsob komprimace zprávy
4 – typ/formátování zprávy
4.2 Přenosová hlavička zprávy
Je standardně 64 bytů dlouhá, vždy nekomprimovaná a v ASCII tvaru a desítkové
soustavě (není vyloučena možnost použití položek typu rezervy v jiné soustavě). Pro
základní identifikaci zprávy jsou důležité položky odesílatele, adresáta a jména
zprávy.
Rozklad přenosové hlavičky zprávy :
Položka / počet znaků
B LJODES LJADRES PC VZNIK KINF INF K P LGTW TR ER RS
C
1 14 14 4 8 4 5 11 4 2 24
Vysvětlivky:
• 0B - označení protokolu:
Označuje počátek zprávy a identifikaci protokolu, ve kterém je zpráva
vytvořena („#” – TCP).
• LJODES – odesílatel :
Jméno adresy odesílatele skládající se z čísla systému (1-4 znak dle M53),
lokality provozování (5-6 znak předřazené nuly, 7-12 znak dle SR70 nebo
SR71) a konkrétního účastníka v rámci systému v lokalitě (13-14 znak
z přiděleného pořadového čísla – nódu). Jméno odesílatele nemusí být
numerické, čísla mohou být nahrazena alfabetickými znaky např. z důvodu
navýšení kapacity klientů v jedné lokalitě nad 100.
• LJADRES – adresát :
Jméno adresáta zprávy skládající se z čísla systému (1-4 znak dle M53),
lokality provozování (5-6 znak předřazené nuly, 7-12 znak dle SR70 nebo
SR71) a konkrétního účastníka v rámci systému v lokalitě (13-14 znak
z přiděleného pořadového čísla – nódu). Jméno odesílatele nemusí být
numerické, čísla mohou být nahrazena alfabetickými znaky např. z důvodu
navýšení kapacity klientů v jedné lokalitě nad 100.
3
• PC – číslo zprávy:
Pořadové číslo zprávy uváděné vždy jako numerické na plný počet znaků
(doplněné nulami zleva při nevyužití kapacity položky).
• VZNIK – vznik zprávy:
Časový vznik zprávy ve formátu měsíce (01-12), dne (01-28,29,30,31 podle
měsíce a přestupnosti roku), hodiny (00-23) a minuty (00-59). Čas vzniku je
běžně dosazován jako systémový čas ukončení, případně zahájení pořízení
(vytvoření) zprávy.
• KINF – klíč na informaci:
Položka sloužící jako pomocný doplňující popis identifikace ke zprávě,
respektive ke stavu zpracování zprávy (způsob zpracování, uložení do
poolu…). Tato položka je např. využívána k přenášení obvodu dopravního
body (klíč „IS“ na prvních dvou pozicích) nebo číslo odesílajícího klienta ISOŘ
ve zprávě vnější komunikace, obdobně žádajícího o blok dat z CEVIS (klíč „I“
na první pozice, druhá pozice je oblast dispečinku/celá síť ČD kam klient patří
a 3 se 4 pozicí je pořadové číslo klienta – NOD).
• INF – jméno zprávy:
Jméno zprávy se skládá z typu zprávy (1 znak – V,I, Z, O, K…) a vlastního
označení (2-5 znak – pro vstupní informace její číslo). Specifické zprávy
využívají všech pět znaků pro své jedinečné jméno např. CFILE.
• K – způsob komprimace zprávy:
Vyjádřená numericky (0-nekomprimováno, 1-komprimováno) nebo alfabeticky
(druh komprimačního algoritmu např. A – ARJ, L – LHARC…). Komprimovaná
zpráva má v následujících 10 bytech za přenosovou hlavičkou doplňující údaj o
velikosti dekomprimované zprávy (bez této přenosové hlavičky s tímto
doplněním). Přenášená zpráva je běžně komprimována od dosažení velikosti 2
kB.
• P – priorita zprávy (nově typ informace) :
Používá se hexadecimální vyplnění. Položka priority zprávy není používána pro
původní význam (přeřazení položek čekajících ve frontě do pořadí podle
důležitosti nesené zprávy) ale pro potřeby definice v jakém způsobu
formátování je zpráva vytvořena (0-textový tvar zprávy, 1-binární tvar zprávy,
2-serializovaný objekt, 3-DataContainer, 4-XML, 8-zpráva dělená na části).
• LGTW – klíč na pool komunikačního počítače (communic) :
Používá se hexadecimální vyplnění a obsahuje jméno prvku v poolu tranzitního
počítače provádějícího párování zpráv (čekání na kvitanci, odpověď).
• TR – počet průchodů tranzitním počítačem (communic) :
4
Obsahuje počet průchodů a slouží jako pomocná položka pro zachycení stavu
směrování zprávy (pro odchylné a zprostředkované komunikace).
• ERC – chybový kód zprávy (nově kódová stránka a zabezpečení přenášené
zprávy): Obsahuje číslo chyby zprávy, případně chybového řádku, nově první
znak znamená kódovou stránku přenášené zprávy (0-ASCII, 1-Windows 1250,
2-ISO LATIN-2, 3-PC LATIN-2, 4-kód Kamenických, druhý znak znamená
způsob zabezpečení přenášené zprávy (mezera-bez zabezpečení, 0-bez
významu, 1-digitální podpis 512 bitů, nebude dále podporováno, 2-šifrování
RSA, 3-digitální podpis s CA klíč 1024 bitů)
• RS – rezerva:
Neslouží pro předávání údajů mezi odesílatelem a příjemcem. Je určeno pro
zápis údajů potřebných pro komunikační služby (např. identifikace dílu
přenášeného souboru po částech). Při komunikaci uvnitř jednoho systému je
pak možné využít položku i pro jiné účely.
4.3 Kvitance zprávy
Obsahuje komunikační hlavičku, v níž se provede pouze prohození odesílatele a
příjemce a do jména zprávy se nahradí první znak podle výsledku zapracování/přijetí
zprávy (K nebo N).
Za komunikační hlavičkou může (a při „N“ se předpokládá, ale nemusí být) vlastní
text oznámení příčiny odmítnutí.
5
Tabulka smluvních sankcí - Technické a provozní standardy ODIS Příloha č. 9 TPS ODIS
Název Znění povinnosti Způsob porušení Definice jednotlivého příípadu Výše sankce za jednotlivý Opakovaná sankce (vč. podmínek Ochranná
dokumentu Článek případ
udělení opakované sankce) lhůta
Při prvním porušení je Dopravci ANO, sankce se udělí pouze v případě,
Dopravce nesplňuje příslušné ustanovení udělena výtka, při opakovaném pokud Dopravce neprovede nápravu
Technické a provozní standardy Integrovaného dopravního systému Dopravce zajišťuje přepravní výkon v rozporu s definované standardem TPS ODIS či jejich porušení (nebo neprovedení ani v dohodnutém termínu
Moravskoslezského kraje ODIS (dále jen ODIS) specifikují náležitosti, náležitostmi specifikovanými v Technických a
TPS ODIS TPS ODIS vč. které je nutné ze strany dopravce naplnit k zajištění přepravního výkonu provozních standardech ODIS. přílohami. Toto sankční ustanovení se týká nápravy v dohodnutém termínu) přiměřeném povaze porušení. Sankce Ne
příloh na území ODIS.
všech případů porušení, pro které není níže je výše sankce stanovena bude udělována za každý započatý den
definováno konkrétní sankční ujednání. jednotně na 1 000 Kč za každý po uplynutí lhůty pro odstranění,
započatý den po uplynutí lhůty dokud nebude Objednatel a/nebo
pro odstranění. KODIS informován o zjednání nápravy.
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
Vozidla zabezpečující dopravu na linkách ODIS musí splňovat standardy Dopravce zobrazuje informace na vnějších Jednotlivým případem porušení je příslušný lhůtě na základě písemné výzvy
Objednatele a/nebo KODIS bude
zobrazování informací na vnějších informačních panelech vozidel dle platných
TPS ODIS I. Část 2.1 TPS ODIS. informačních panelech vozidel v rozporu s TPS ODIS, a informační panel se zjištěnou závadou. 1 000 Kč Dopravci udělována sankce za každý Ano
to jak z hlediska obsahu, tak formy. započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
Vozidla zabezpečující dopravu na linkách ODIS musí splňovat standardy Dopravce zobrazuje informace na vnitřních Jednotlivým případem porušení je příslušný lhůtě na základě písemné výzvy
informačních panelech vozidel v rozporu s TPS ODIS informační panel se zjištěnou závadou. Objednatele a/nebo KODIS bude
zobrazování informací na vnitřních informačních panelech vozidel dle platných (vč. Přílohy č.2 TPS ODIS), a to jak z hlediska obsahu,
TPS ODIS I. Část 2.2 TPS ODIS. tak formy. 1 000 Kč Dopravci udělována sankce za každý Ano
započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
Všechna vozidla musí být vybavena funkčním akustickým elektronickým Dopravce nepoužil stanoveným způsobem akustický lhůtě na základě písemné výzvy
informačním systémem určeným pro hlášení stanic a zastávek a dalších elektronický informační systém v případě, pro který Jednotlivým případem porušení je absence Objednatele a/nebo KODIS bude
dopravních informací pomocí palubního počítače nebo jiného kontroléru, toto stanovují TPS ODIS, a to jak z hlediska obsahu, tak hlášení v příslušném voze soupravy.
TPS ODIS I. Část 2.3 mikrokontroléru nebo řídící jednotky. formy. 1 000 Kč Dopravci udělována sankce za každý Ano
započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
ANO, sankce je udělována za každý
Vozidla standardu ODIS 4, ODIS 5 a ODIS 6 musí být vybavena centrálním Dopravce ponechal v provozu vůz, který není vybaven započatý den s přetrvávajícím
zavíráním dveří. Dveře musí být za jízdy blokovány. Jednotlivým případem porušení je závada na
TPS ODIS I. Část 2.4 2 000 Kč porušením příslušného ustanovení, Ne
centrálním zavíráním dveří, popř. dveře nejsou za jízdy
příslušném voze soupravy. dokud nebude Objednatel a/nebo
blokovány.
KODIS informován o zjednání nápravy.
V provozu může být vozidlo ponecháno, nefungují-li maximálně dvoje dveře ANO, sankce je udělována za každý
na jedné straně soupravy. Současně musí být z každého vozidla (tj. i každého
vozu soupravy) umožněn výstup alespoň jedněmi dveřmi na každé straně Dopravce ponechal v provozu soupravu, která Jednotlivým případem porušení je spoj, na započatý den s přetrvávajícím
vozidla. nesplňuje standard funkčnosti dveří. kterém došlo (byť jen v části trasy) k porušení 1 000 Kč
TPS ODIS I. Část 2.4 standardu funkčnosti dveří. porušením příslušného ustanovení, Ne
dokud nebude Objednatel a/nebo
KODIS informován o zjednání nápravy.
Odbavovací terminály jsou umístěny vždy u každých nástupních dveří vozidla ANO, sankce je udělována za každý
kategorie ODIS 4, ODIS 5 a ODIS 6. V každém nástupním prostoru jsou
umístěny 2 terminály (s výjimkou dveřního prostoru s plošinou pro invalidní Ve dveřním prostoru se nenachází žádný funkční Jednotlivým případem porušení je dveřní započatý den s přetrvávajícím
vozík, kde postačuje 1 terminál), přičemž minimálně 1 terminál musí být odbavovací terminál. prostor bez funkčního odbavovacího
TPS ODIS I. Část 2.5 funkční. terminálu na příslušném spoji. 1 000 Kč porušením příslušného ustanovení, Ano
dokud nebude Objednatel a/nebo
KODIS informován o zjednání nápravy.
Stránka 1 z 8
Tabulka smluvních sankcí - Technické a provozní standardy ODIS Příloha č. 9 TPS ODIS
Název Znění povinnosti Způsob porušení Definice jednotlivého příípadu Výše sankce za jednotlivý Opakovaná sankce (vč. podmínek Ochranná
dokumentu Článek případ
udělení opakované sankce) lhůta
ANO - v případě, že nebude sjednána
Dopravce provozující vozidlo standardu ODIS 4, ODIS 5 a ODIS 6 musí zasílat náprava ani v dodatečně poskytnuté
prostřednictvím dohodnutých komunikačních kanálů informace o provozu
vlaku do dispečinku KODIS. Dopravce neposkytl KODIS záznamy o provozu vozidla Jednotlivým případem porušení je příslušný lhůtě na základě písemné výzvy
Vozidla standardu ODIS 4, ODIS 5 a ODIS 6 musí být vybavena GPS pro zasílání dle standardu. spoj, o němž nejsou KODIS poskytnuty Objednatele a/nebo KODIS bude
údajů o aktuální poloze vlaku pro upřesnění polohy vozidel v mezistaničních záznamy o provozu vozidla dle standardu.
TPS ODIS I. část 2.7 úsecích. 1 000 Kč Dopravci udělována sankce za každý Ano
započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
Každé vozidlo (tj. každý jednotlivý vůz soupravy) standardu ODIS 4, ODIS 5 a Vozidlo není vybaveno informačními vitrínami dle Jednotlivým případem porušení je příslušná lhůtě na základě písemné výzvy
ODIS 6 musí být vybaveno informačními vitrínami umožňujícími umístění příslušného standardu. chybějící nebo standard nesplňující Objednatele a/nebo KODIS bude
alespoň 4 listů formátu A3. V těchto vitrínách jsou vždy umístěny informační informační vitrína.
TPS ODIS I. část 2.8 materiály ODIS. Vitrínu lze realizovat také formou klaprámů výše uvedeného 1 000 Kč Dopravci udělována sankce za každý Ano
formátu.
započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
Každé vozidlo (tj. každý jednotlivý vůz soupravy) standardu ODIS 4, ODIS 5 a ANO - v případě, že nebude sjednána
ODIS 6 musí být navíc vybaveno klaprámy určenými k vyvěšení informací o
Integrovaném dopravním systému ODIS na železnici. Klaprámy musí být náprava ani v dodatečně poskytnuté
umístěny v každém nástupním prostoru a jsou určeny k vyvěšení materiálu o
velikosti Vozidlo není vybaveno informačními vitrínami dle Jednotlivým případem porušení je příslušná lhůtě na základě písemné výzvy
490 ˣ 490 mm. Zvolený formát vitrín a umístění vitrín podléhá schválení příslušného standardu. chybějící nebo standard nesplňující Objednatele a/nebo KODIS bude
společnosti KODIS. informační vitrína.
TPS ODIS I. část 2.8 1 000 Kč Dopravci udělována sankce za každý Ano
započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
Dopravce uvnitř vozidla nesmí žádné materiály vylepovat nebo jiným Informační nebo reklamní materiál je umístěn mimo Jednotlivým případem porušení je každý lhůtě na základě písemné výzvy
způsobem upevňovat na okna nebo jiné součásti vozidla. Jakékoliv informační Objednatele a/nebo KODIS bude
nebo reklamní materiály mohou být ve vozidlech standardu ODIS 4, ODIS 5 a
TPS ODIS I. část 2.10 ODIS 6 vyvěšovány pouze v informačních vitrínách či klaprámech. KODISem stanovené plochy, které jsou pro umisťování jednotlivý informační nebo reklamní materiál 1 000 Kč Dopravci udělována sankce za každý Ne
těchto materiálů určené. umístěný mimo KODISem stanovené plochy. započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
Každé vozidlo (tj. každý jednotlivý vůz soupravy) standardu ODIS 4, ODIS 5 a Vozidlo není vybaveno aktuální sadou informačních Jednotlivým případem porušení je každý lhůtě na základě písemné výzvy
ODIS 6 je vybaveno sadou informačních materiálů umísťovaných pouze do materiálů dle pokynů společnosti KODIS. chybějící jednotlivý informační nebo reklamní 1 000 Kč Objednatele a/nebo KODIS bude
informačních vitrín či klaprámů určených pro vyvěšování informačních a materiál.
TPS ODIS I. část 2.10 propagačních materiálů ODIS. Tato sada je vždy v aktuálním znění dle pokynů Dopravci udělována sankce za každý Ne
společnosti KODIS.
započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
Vozidla standardu ODIS 4, ODIS 5 a ODIS 6 jsou vybavena aktivní Zjevné nesplnění požadavků na funkčnost a technické Jednotlivým případem porušení je každý ANO, sankce je udělována za každý
plnohodnotnou klimatizací, která zabezpečí udržení teploty v interiéru vozidla provedení klimatizace. jednotlivý vůz na příslušném spoji, na kterém
TPS ODIS I. část 2.11 při běžném provozu dle platné legislativy. U vozidel vybavených aktivní došlo (byť jen v části trasy) k porušení tohoto 1 000 Kč spoj s přetrvávajícím porušením Ne
plnohodnotnou klimatizací je Dopravce povinen zajistit její funkčnost a standardu.
udržovat ve vnitřních prostorech vozidla tepelnou pohodu dle parametrů příslušného ustanovení.
uvedených v tabulce v bodě I. části 2.11.
Stránka 2 z 8
Tabulka smluvních sankcí - Technické a provozní standardy ODIS Příloha č. 9 TPS ODIS
Název Znění povinnosti Způsob porušení Definice jednotlivého příípadu Výše sankce za jednotlivý Opakovaná sankce (vč. podmínek Ochranná
dokumentu Článek případ
udělení opakované sankce) lhůta
1 000 Kč
Vlakové čety jsou povinny dle konstrukce vozidla umožnit temperování vozidla Zjevné nesplnění standardu spočívající v Jednotlivým případem porušení je každý ANO, sankce je udělována za každý
v případě, že je temperování řízeno dálkově, nebo zajistit přiměřené nedostatečném či neprobíhajícím temperování vozidla jednotlivý vůz na příslušném spoji, na kterém
TPS ODIS I. část 2.11 temperování vozidla. s ohledem na klimatické poměry. došlo (byť jen v části trasy) k porušení tohoto spoj s přetrvávajícím porušením Ne
standardu.
příslušného ustanovení.
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
V případě, že pro vozidlo vyplývá povinnost vybavení zásuvkami USB a 230 V, Dopravce nezajistil provozuschopnost zásuvek USB a Jednotlivým případem porušení je příslušná lhůtě na základě písemné výzvy
je dopravce tato zařízení udržovat v provozuschopném stavu. Objednatele a/nebo KODIS bude
TPS ODIS I. část 2.13 zásuvek pro nabíjení drobné elektroniky s napětím 230 zásuvka USB / 230 V. 500 Kč Dopravci udělována sankce za každý Ano
V. započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
Vozidla provozovaná ve spojích v tomto standardu jsou vybavena takovými Jednotlivým případem porušení je každý lhůtě na základě písemné výzvy
prvky, které umožní bezplatné bezdrátové připojení uživatelů (cestujících) Zjevné nesplnění požadavků na funkčnost a technické Objednatele a/nebo KODIS bude
pomocí Wi-Fi k síti internet.
TPS ODIS I. část 2.14 jednotlivý vůz v příslušném provozním dni, ve 1 000 Kč Dopravci udělována sankce za každý Ano
provedení WiFi.
započatý den po uplynutí lhůty pro
kterém došlo k porušení tohoto standardu.
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
Veškerá vozidla včetně vybavení provozovaná na linkách na základě Smlouvy ANO, sankce je udělována za každý
o veřejných službách v přepravě cestujících podléhají procesu prohlášení o
shodě s Technickými a provozními standardy ODIS. Tato povinnost platí pro Jednotlivým případem porušení je každý započatý den s přetrvávajícím
vozidla provozovaná ve všech standardech. Dopravce provozuje vozidlo bez platného prohlášení o
TPS ODIS I. část. 3. porušením příslušného ustanovení, Ne
jednotlivý vůz v příslušném provozním dni, ve 5 000 Kč
shodě. dokud nebude Objednatel a/nebo
kterém došlo k porušení tohoto standardu.
KODIS informován o zjednání nápravy.
ANO, sankce je udělována za každý
Dopravci provozující spoje ve standardu ODIS jsou povinni pro potřeby Evidence vozidel v ODIS – dopravce neinformuje KODIS Jednotlivým případem porušení je každý započatý den s přetrvávajícím
TPS ODIS I. část 4. správné funkčnosti CED společnost KODIS informovat o vozidlech nově o změnách vozidel (zařazení/vyřazení do/z provozu). jednotlivý vůz v příslušném provozním dni, ve 5 000 Kč porušením příslušného ustanovení, Ne
zařazovaných do provozu v rámci ODIS a o vozidlech, která z provozu vyřazují. kterém došlo k porušení tohoto standardu. dokud nebude Objednatel a/nebo
KODIS informován o zjednání nápravy.
ANO, sankce je udělována za každý
Pokladní přepážka v uvedených stanicích bude otevřená po celý týden v Pokladní přepážka je uzavřena v provozní době bez Jednotlivým případem porušení je příslušná započatý den s přetrvávajícím
minimálním rozsahu 05:00-20:00. předchozího informování KODIS. přepážka v daný provozní den.
TPS ODIS II., část 1 5 000 Kč porušením příslušného ustanovení, Ne
dokud nebude Objednatel a/nebo
KODIS informován o zjednání nápravy.
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
Zaměstnanec obsluhující pokladní přepážku musí dodržovat ústrojovou kázeň Zaměstnanec není oblečen ve stejnokoroji nebo Jednotlivým případem porušení je porušení lhůtě na základě písemné výzvy
ústrojové kázně u příšlušného zaměstnance v Objednatele a/nebo KODIS bude
daný provozní den.
TPS ODIS II., část 1 nošením uniformy – polokošile či košile s logem dopravce. polokošili či košili s logem dopravce. 1 000 Kč Dopravci udělována sankce za každý Ano
započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
Stránka 3 z 8
Tabulka smluvních sankcí - Technické a provozní standardy ODIS Příloha č. 9 TPS ODIS
Název Znění povinnosti Způsob porušení Definice jednotlivého příípadu Výše sankce za jednotlivý Opakovaná sankce (vč. podmínek Ochranná
dokumentu Článek případ
udělení opakované sankce) lhůta
ANO - v případě, že nebude sjednána
Pokladní přepážka není označena názvem dopravce a logem Každá pokladní náprava ani v dodatečně poskytnuté
přepážka musí být označena názvem dopravce a logem IDS ODIS a piktogramy
určujícími možnosti zakoupení jízdních dokladů. Na vývěsce je nutné pokladní Jednotlivým případem porušení je každé lhůtě na základě písemné výzvy
přepážku informacemi o provozní době, rozsahu poskytovaných služeb, chybějící označení (logo, piktogram, Objednatele a/nebo KODIS bude
možnosti placení bezkontaktní platební kartou a bezkontaktní čipovou kartou informační vývěsku)
TPS ODIS II., část 1 ODISka. Vývěska musí obsahovat telefonní kontakt na Dopravní infocentrum Chybějící označení uvedených povinných prvků. 500 Kč Dopravci udělována sankce za každý Ano
ODIS pro případ, že by byla pokladní přepážka uzavřená.
započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
Provozní doba čekárny je minimálně v rozsahu provozní doby pokladní Čekárna je uzavřena v provozní době bez předchozího Jednotlivým případem porušení je uzavřená lhůtě na základě písemné výzvy
přepážky, tj. 05:00-20:00 nebo s nejdéle otevřenou pokladnou. Objednatele a/nebo KODIS bude
TPS ODIS II., část 2 informování KODIS. čekárna v provozní době v daný provozní den. 1 000 Kč Dopravci udělována sankce za každý Ne
započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
Čekárna není vybavena odpakovým košem, informačními vitrínami o celkové Vybavení čekárny neodpovídá standardům ODIS - Jednotlivým případem porušení je čekárna lhůtě na základě písemné výzvy
polše 8x A3, nejsou zřízena dostatečné prostory pro umístění invalidního nesouhlasí počet vitrín, chybí odpadkový koš, chybí 500 Kč Objednatele a/nebo KODIS bude
vozíku nebo dětského kočárku. prostory pro stání invalidního vozíku a dětského
TPS ODIS II., část 2 kočárku. nevyhovující standardu v daný provozní den. Dopravci udělována sankce za každý Ano
započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
Dle záznamu o úklidu nebyl úklid proveden nebo i přes
V čekárně je denně prováděn úklid (vysypání košů, mytí podlah a kontaktních aktuální záznam o úklidu jsou důvodné pochybnosti o Jednotlivým případem porušení je každý NE - individuální pochybení, sankce
ploch).
TPS ODIS II., část 2 jeho zanedbání. Kontrola tohoto ustanovení je zjištěný případ neprovedeného nebo 1 000 Kč udělena za každé pochybení zvlášť Ne
zaměřena též na formální stránku evidence zanedbaného úklidu.
pravidelného denního úklidu.
ANO, sankce je udělována za každý
Dopravce bude provozovat WC ve stanicích Ostrava střed, Frýdek-Místek a WC není provozováno či je uzavřeno v provozní době Jednotlivým případem porušení je uzavřená započatý den s přetrvávajícím
Frýdlant nad Ostravicí v minimálním rozsahu shodujícím se s provozní dobou toaleta v provozní době v daný provozní den.
TPS ODIS II., část 3 pokladní přepážky. pokladní přepážky (bez předchozího informování 1 000 Kč porušením příslušného ustanovení, Ne
KODIS).
dokud nebude Objednatel a/nebo
KODIS informován o zjednání nápravy.
TPS ODIS II., část 6 Při přepravě imobilního cestujícího zajistí dopravce nástup za pomocí zvedací Dopravce nezajistil předhlášenou přepravu imobilního Jednotlivým případem porušení je příslušná 2 000 Kč NE - individuální pochybení, sankce Ne
TPS ODIS plošiny u správce infrastruktury či jiného subjektu, který plošinou disponuje za cestujícího, např. nepřistavením zvedací plošiny či nezajištěná přeprava imobilního cestujícího.
TPS ODIS I. Čl. 2.12 + předpokladu, že vozidlo dopravce není zvedací plošinou vybaveno nebo absencí asistence při nástupu / výstupu. udělena za každé pochybení zvlášť
VII. neumožňují-li poměry v železniční stanici použití výklopné plošiny.
I. Čl. 2.12 + Vozidla provozovaná v ODIS musí být denně uvnitř čistá. Vně čištěna musí být Zjevné nedodržení požadavků na čistotu a vzhled Jednotlivým případem porušení této 5 000 Kč NE - individuální pochybení, sankce Ne
VII. dle klimatických poměrů tak, aby byla vždy zajištěna čitelnost všech povinných vozidel. povinnosti je vůz kontrolovaný bezprostředně
údajů dle norem a tohoto dokumentu a také, aby byla zajištěna čistota po provedení týdenního nebo hloubkového udělena za každé pochybení zvlášť
vnějších tlačítek poptávkového otevírání dveří. Dopravci jsou povinni vést úklidu.
průkaznou evidenci o prováděném čistění vozidel tak, aby mohla být
prováděna kontrola pracovníky společnosti KODIS.
Vozidla provozovaná v ODIS musí být denně uvnitř čistá. Vně čištěna musí být Dle záznamu o úklidu nebyl úklid proveden nebo i přes 1 000 Kč NE - individuální pochybení, sankce Ne
dle klimatických poměrů tak, aby byla vždy zajištěna čitelnost všech povinných aktuální záznam o úklidu jsou důvodné pochybnosti o Jednotlivým případem porušení je
údajů dle norem a tohoto dokumentu a také, aby byla zajištěna čistota jeho zanedbání. Kontrola tohoto ustanovení je též kontrolovaná souprava po provedení udělena za každé pochybení zvlášť
vnějších tlačítek poptávkového otevírání dveří. Dopravci jsou povinni vést zaměřena na formální stránku evidence pravidelného pravidelného denního úklidu.
průkaznou evidenci o prováděném čistění vozidel tak, aby mohla být denního úklidu.
prováděna kontrola pracovníky společnosti KODIS.
Stránka 4 z 8
Tabulka smluvních sankcí - Technické a provozní standardy ODIS Příloha č. 9 TPS ODIS
Název Znění povinnosti Způsob porušení Definice jednotlivého příípadu Výše sankce za jednotlivý Opakovaná sankce (vč. podmínek Ochranná
dokumentu Článek případ
udělení opakované sankce) lhůta
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
Dopravce udržuje vozidla v bezzávadném technickém stavu, dbá na Zjevné nedodržení požadavků na standard údržby Jednotlivým případem porušení je příslušná lhůtě na základě písemné výzvy
dodržování platné legislativy a technických norem v oblasti údržby vozidel a vozidel. technická závada nebo konkrétní poškozený Objednatele a/nebo KODIS bude
správy vozidlového parku. díl.
TPS ODIS VIII. 1 000 Kč Dopravci udělována sankce za každý Ne
započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
Ve výlukovém pokynu KODIS zpravidla určuje: počet autobusů NAD, resp. Dopravce nezajistil pro výluku vozidla NAD dle Jednotlivým případem porušení povinnosti je NE - individuální pochybení, sankce
souhrnnou kapacitu vozidel NAD pro daný spoj. standardu, nedostatek spočívá v nedostatečné
TPS ODIS IX. souhrnné kapacitě vozidel NAD u příslušného příslušný vlakový spoj s nedodrženou 1 000 Kč udělena za každé pochybení zvlášť Ne
V případě použití NAD musí být zajištěno vždy minimálně 50 % kapacity nahrazovaného vlakového spoje. souhrnnou kapacitou vozidel NAD.
částečně nízkopodlažními vozidly pro přepravu imobilních cestujících.
Dopravce nezajistil pro výluku vozidla NAD dle Jednotlivým případem porušení povinnosti je
TPS ODIS IX. standardu, nedostatek spočívá v nedostatečném podílu příslušný vlakový spoj s nedodrženou 500 Kč NE - individuální pochybení, sankce Ne
částečně nízkopodlažních vozidel (jejich souhrnná souhrnnou kapacitou nízkopodlažních vozidel udělena za každé pochybení zvlášť
kapacita je menší než 50 %). NAD.
Vozidla NAD budou vybavena (přenosným) GPS modulem k určení polohy ANO, sankce je udělována za každý
vozidla pro sledování dispečinkem KODIS. Dopravce informuje dispečink
KODIS o nasazených vozidlech NAD (RZ vozidla, typ vozidla, jízdní řád (oběh) Vozidlo nedisponuje GPS modulem pro sledování Jednotlivým případem porušení povinnosti je započatý den s přetrvávajícím
vozidla NAD). vozidla dispečinkem KODIS. vozidlo NAD bez GPS modulu v daném
TPS ODIS IX. provozním dni. 500 Kč porušením příslušného ustanovení, Ano
dokud nebude Objednatel a/nebo
KODIS informován o zjednání nápravy.
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
Dopravce zveřejní informace o výluce nejpozději 7 dní před konáním dané Jednotlivým případem porušení povinnosti je lhůtě na základě písemné výzvy
výluky na svých webových stránkách, v železničních stanicích a zastávkách – Dopravce nezveřejnil informaci o výluce dle uvedených Objednatele a/nebo KODIS bude
vždy na místech určených jako místa pro informace pro cestující.
TPS ODIS IX. příslušná vývěska či chybějící informace na 500 Kč Dopravci udělována sankce za každý Ne
standardů.
započatý den po uplynutí lhůty pro
webových stránkách.
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
Po ukončení výluky provede dopravce odstranění označení informací o výluce Jednotlivým případem porušení povinnosti je lhůtě na základě písemné výzvy
(formou přenosného označníku, formou informací ve stanicích a zastávkách příslušná vývěska či informace na webových Objednatele a/nebo KODIS bude
nejpozději do 24 hodin od ukončení výluky). stránkách.
TPS ODIS IX. Dopravce neprovedl odstranění informací o výluce. 500 Kč Dopravci udělována sankce za každý Ne
započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
TPS ODIS IX. Dopravce je povinen v případě výluky zajistit dopravní obslužnost pomocí Neobsloužení zastávky NAD. Sankce udělena v případě, 1 000 Kč NE - individuální pochybení, sankce Ne
NAD. (…) Vozidla NAD zastavují na zastávkách k tomu určených. Zastávky NAD Jednotlivým případem porušení povinnosti je
(případně jejich stanoviště) jsou stanoveny KODISem v příloze č. 10 tohoto udělena za každé pochybení zvlášť
dokumentu společně s jejich označením. že obsluha zastávky není omezena stavebními pracemi
vlakový spoj, na kterém došlo k neobsloužení
či jinou rekonstrukcí (vozovky, zastávky aj.) - tato
zastávky NAD.
skutečnost je zpravidla uvedena ve výlukovém pokynu.
TPS ODIS X. Dopravce o mimořádné situaci informuje dispečink KODIS neprodleně po Neohlášení mimořádné situace, resp. její ohlášení s Jednotlivým případem je porušení povinnosti NE - individuální pochybení, sankce Ne
nahlášení mimořádné události. Ve smyslu tohoto standardu se za prodlením delším než 15 minut. 1 000 Kč
mimořádnou událost považuje každé narušení grafikonu s možným dopadem udělena za každé pochybení zvlášť
na jízdu vlaku vedoucím ke zpoždění vlakového spoje nad 30 minut nebo pro příslušnou mimořádnost.
zrušení trasy vlakového spoje (nebo její části).
Stránka 5 z 8
Tabulka smluvních sankcí - Technické a provozní standardy ODIS Příloha č. 9 TPS ODIS
Název Znění povinnosti Způsob porušení Definice jednotlivého příípadu Výše sankce za jednotlivý Opakovaná sankce (vč. podmínek Ochranná
dokumentu Článek případ
udělení opakované sankce) lhůta
TPS ODIS X. Po ukončení mimořádné události dopravce informuje o této skutečnosti Neohlášení ukončení mimořádné situace, resp. Jednotlivým případem je porušení povinnosti NE - individuální pochybení, sankce Ne
neprodleně dispečink KODIS, své zaměstnance a formou svých webových ohlášení s prodlením delším než 30 minut. 500 Kč
stránek také cestující. udělena za každé pochybení zvlášť
pro příslušnou mimořádnost.
V případě mimořádné události na trati či z důvodů na straně dopravce a Nezajištění NAD v období do 60 minut od nahlášení Jednotlivým případem je nezajištění NAD pro ANO, sankce je udělována za každou
nutnosti zajištění náhradní autobusové dopravy (NAD), zajistí dopravce NAD mimořádné události dispečinku dopravce. 1 000 Kč
TPS ODIS X. do 60 minut od nahlášení mimořádné události. hodinu nezajištění NAD pro příslušnou Ne
příslušnou mimořádnost.
mimořádnost.
ANO, sankce je udělována za každý
Dopravce je povinen provozovat dispečink denně v období od 15 minut před Jednotlivým případem je opakovaná započatý den s přetrvávajícím
odjezdem prvního vlaku z výchozí stanice do 15 minut po příjezdu posledního Dopravce neprovozuje dispečink v období stanoveném
TPS ODIS XII. část 1. vlaku do koncové stanice. porušením příslušného ustanovení, Ne
nedostupnost dispečinku dopravce v provozní 5 000 Kč
daným standardem. dokud nebude Objednatel a/nebo
době v příslušném provozním dni.
KODIS informován o zjednání nápravy.
TPS ODIS XII. část 2. Dopravce se řídí pomůckou „Čekací doby“, kdy bez souhlasu dispečera KODIS Dopravce porušil povinnost vyplývající z dokumentu (jednotlivý případ = nezajištěný přípoj nebo 1 000 Kč NE - individuální pochybení, sankce Ne
TPS ODIS XII. část 2.2 nepřekročí stanovenou pravidelnou čekací dobu, výjimku tvoří důvody "Čekací doby" ve smyslu překročení pravidelné čekací také zajištěný přípoj i přes zamítavé
spojené s řízením provozu, které nemůže dopravce ovlivnit. doby bez souhlasu dispečinku KODIS, resp. i přes stanovisko dispečinku KODIS) udělena za každé pochybení zvlášť
zamítavé stanovisko dispečinku KODIS.
Dopravce se zavazuje řídit dokumentem „Čekací doby“ a stanovené Dopravce porušil povinnost vyplývající z dokumentu Jednotlivým případem porušení povinnosti je 1 000 Kč NE - individuální pochybení, sankce Ne
pravidelné čekací doby dodržovat, pokud provozovatel dráhy nestanoví jinak. "Čekací doby" ve smyslu nevyčkání vlaku na přípoj, tj. nevyčkání na přípoj dle dokumentu "Čekací
V případě požadavku dispečinku KODIS na vyčkávání vlaku je dopravce nedodržení pravidelné čekací doby nebo doby" nebo dle požadavku KODIS. udělena za každé pochybení zvlášť
povinen tomuto požadavku vyhovět, pokud tomu nebrání objektivní důvody nerespektování požadavku KODIS na vyčkávání vlaku.
na straně řízení provozu provozovatele dráhy.
ANO - v případě, že nebude sjednána
náprava ani v dodatečně poskytnuté
Dopravce poskytne na žádost KODIS sestavu vlaků s překročenou Dopravce neposkytl sestavy vlaků a neprověřil všechny Jednotlivým případem porušení povinnosti lhůtě na základě písemné výzvy
mimořádnou čekací dobou. Dopravce dále na žádost Objednatele nebo KODIS podněty dle požadavků standardu. je neposkytnutí sestavy nebo poskytnutí Objednatele a/nebo KODIS bude
prověří všechny podněty k vyčkávání na přípojné autobusové a vlakové spoje. neúplné sestavy vlaků nebo neprověření
TPS ODIS XII. část 2. podnětů na žádost Objednatele / KODIS. 2 000 Kč Dopravci udělována sankce za každý Ano
započatý den po uplynutí lhůty pro
odstranění, dokud nebude Objednatel
a/nebo KODIS informován o zjednání
nápravy.
ANO - v případě, že nebude sjednána
Dopravce je povinen postupovat dle principu odbavení cestujícího s náprava ani v dodatečně poskytnuté
bezkontaktní čipovou kartou ODISka či bankovní kartou, zajistit podmínky k
I. část 2.5.1; využití bankovních platebních karet, zajisit základní požadavky na zařízení a Dopravce nezajistil definované požadavky nebo lhůtě na základě písemné výzvy
2.5.2 zajistit požadované údaje výstupních dat. nepostupuje podle stanovených principů odbavení
TPS ODIS 10 000 Kč Objednatele a/nebo KODIS bude Ne
Dopravci udělována sankce, dokud
nebude Objednatel a/nebo KODIS
informován o zjednání nápravy.
ANO - V případě zpoždění dodání dat
bude udělena opakovaná sankce ve
Dopravce nezaslal řádně veškerá data z odbavovacích a výši 1.000,- Kč za každý kalendářní
I. část 2.5.1; Dopravce je povinen zajistit zasílání dat do clearingu MSK včetně informací o prodejních zařízení do centrální správy karetního Jednotlivým případem je příslušné den, kdy je u daného odbavovacího či
2.5.2 přiložení bankovní karty dle specifikace věty KODIS v aktuální verzi dle Přílohy
TPS ODIS č. 4 systému Moravskoslezského kraje dle podmínek a v odbavovací či prodejní zařízení dopravce a 1 000 Kč prodejního zařízení evidováno Ne
termínech definovaných v Příloze č. 4 Návrh datové každý den zpoždění řádného dodání dat. zpoždění řádného dodání dat,
věty pro MSK. maximálně však 10.000,- Kč za jedno
odbavovací a prodejní zařízení a jeden
kalendářní měsíc.
Stránka 6 z 8
Tabulka smluvních sankcí - Technické a provozní standardy ODIS Příloha č. 9 TPS ODIS
Název Znění povinnosti Způsob porušení Definice jednotlivého příípadu Výše sankce za jednotlivý Opakovaná sankce (vč. podmínek Ochranná
dokumentu Článek případ
2 000 Kč udělení opakované sankce) lhůta
TPS ODIS I. část 2.5.1; Mezi základní požadavky na zařízení patří záznam dlouhodobé časové jízdenky Dopravce nezajistil nahrání dlouhodobé časové Jednotlivým případem porušení povinnosti je 2 000 Kč NE - individuální pochybení, sankce Ne
TPS ODIS 2.5.2 nebo kreditu elektronické peněženky zakoupené přes e-shop na ODISku - jízdenky nebo kreditu elektronické peněženky každý případ nezajištění nahrání dlouhodobé
TPS ODIS akceptace greenlistu. zakoupené přes e-shop na ODISku v termínu časové jízdenky nebo kreditu elektronické 2 000 Kč udělena za každé pochybení zvlášť
I. část 2.5.1; definovaném pro distribuci greenlistu v Příloze č. 4 peněženky.
2.5.2 Mezi základní požadavky na zařízení patří odmítnutí odbavení ODISky, která Návrh datové věty pro MSK. NE - individuální pochybení, sankce Ne
se nachází na blacklistu. Zařízení umožnilo odbavení ODISky, která byla Jednotlivým případem porušení povinnosti je
I. část 2.5.2 umístěna na blacklist v termínu definovaném v Příloze každý případ umožnění odbavení ODISky udělena za každé pochybení zvlášť
Každý člen vlakové čety provádějící úkony související s odbavením cestujících č. 4 Návrh datové věty pro MSK. umístěné v blacklistu.
musí být vybaven odbavovacím a prodejním zařízením vlakové čety. Jednotlivým případem je příslušný člen NE - individuální pochybení, sankce Ne
Člen vlakové čety provádějící úkony související s vlakové čety nedisponující funkčním
odbavením cestujících není vybaven funkčním odbavovacím a prodejním zařízením vlakové udělena za každé pochybení zvlášť
odbavovacím a prodejním zařízením vlakové čety. čety na vlakovém spoji.
ANO - v případě, že nebude sjednána
Dopravce je povinen vybavit odbavovací a prodejní zařízení vlakové čety Jednotlivým případem porušení povinnosti je náprava ani v dodatečně poskytnuté
definovanými komponenty, s definovanými funkčními vlastnostmi; dále zajistit nezajištění definovaných požadavků u
podmínky k využití bankovních platebních karet, zajisit základní požadavky na příslušného prodejního a odbavovacího lhůtě na základě písemné výzvy
zařízení a zajistit požadované údaje výstupních dat. zařízení.
TPS ODIS I. část 2.5.2 Dopravce nezajistil definované požadavky. 10 000 Kč Objednatele a/nebo KODIS bude Ne
Dopravci udělována sankce, dokud
nebude Objednatel a/nebo KODIS
informován o zjednání nápravy.
Tištěné jízdní doklady ODIS musí obsahovat údaje dle § 5 Vyhlášky č. Neuvedení všech povinných údajů na jízdní doklad dle Jednotlivým případem porušení povinnosti je NE - individuální pochybení, sankce
175/2000 Sb. O přepravním řádu pro veřejnou drážní a silniční osobní
TPS ODIS III. část 1. dopravu, dále musí obsahovat další údaje dle tabulky č. 1 Standard tištěných standardu příslušný jízdní doklad s chybějícím povinným 500 Kč udělena za každé pochybení zvlášť Ne
potvrzení nebo jízdních dokladů a další údaje dle TPS.
údajem (příp. povinnými údaji).
ANO - v případě, že nebude sjednána
Všechny jízdní doklady v ODIS vydané dopravci nebo jinou formou musí na náprava ani v dodatečně poskytnuté
sobě nést ochranné prvky.
Papírové pásky mohou být vyrobeny z termopapíru. Vydané papírové doklady Použití jiného druhu papíru do elektronických Jednotlivým případem porušení povinnosti je lhůtě na základě písemné výzvy
ODIS obsahují logo ODIS, které je chráněno ochrannou známkou společnosti odbavovacích zařízení než dle standardu. příslušné elektronické odbavovací zařízení s
TPS ODIS III. část 2. KODIS. nevhodně použitým druhem papíru. 500 Kč Objednatele a/nebo KODIS bude Ne
Dopravci udělována sankce, dokud
nebude Objednatel a/nebo KODIS
informován o zjednání nápravy.
Každý dopravce provozující veřejnou dopravu na základě Smlouvy o veřejných Dopravce nezajistil kontrolu jízdenek na ODISce, včetně
službách v přepravě cestujících k zajištění dopravní obslužnosti kraje veřejnou
drážní osobní dopravou v dané oblasti je povinen ODISku akceptovat, a to oba jízdenek zakoupených prostřednictvím e-shopu na Jednotlivým případem porušení povinnosti je NE - individuální pochybení, sankce
její výše uvedené druhy. Standard ODISky se řídí přílohou č. 6 tohoto
TPS ODIS V. část 3. dokumentu. ODISku (za každý případ) nebo prostřednictvím příslušné individuální pochybení zaměstnance 1 000 Kč udělena za každé pochybení zvlášť Ne
TPS ODIS samoobslužného terminálu (za každý případ), dopravce nebo prodejního a odbavovacího zařízení.
TPS ODIS
TPS ODIS nezajistil nahrání transakce z Greenlistu na ODISku.
TPS ODIS
TPS ODIS V. část 4., 5. Dopravce je povinen zajišťovat prodej jízdních dokladů ve vozidlech a v Vydání nesprávné jízdenky. Jednotlivým případem porušení povinnosti je NE - individuální pochybení, sankce Ne
pokladnách vybraných železničních stanic a zastávek dle standardů TPS. příslušné individuální pochybení zaměstnance 1 000 Kč
Nevydání jízdenky (s výjimkou jízdy na dlouhodobou nebo prdejního a odbavovacího zařízení. udělena za každé pochybení zvlášť
časovou jízdenku nebo kontroly již zakoupené
V. část 4., 5. Dopravce je povinen zajišťovat prodej jízdních dokladů ve vozidlech a v jízdenky), za každý případ. Jednotlivým případem porušení povinnosti je 5 000 Kč NE - individuální pochybení, sankce Ne
pokladnách vybraných železničních stanic a zastávek dle standardů TPS. příslušné individuální pochybení
Neposkytnutí služby dle definovaného požadavku. zaměstnance. udělena za každé pochybení zvlášť
V. část 5. Prodej v železničních stanicích a zastávkách poskytuje také další služby. Jednotlivým případem porušení povinnosti je NE - individuální pochybení, sankce Ne
1 000 Kč
udělena za každé pochybení zvlášť
příslušné neposkytnutí služby cestujícímu.
V. část 6. Dopravce je povinen zajišťovat odbavení cestujících u vlakové čety dle Zaměstnanec dopravce (odbavovací zařízení) Jednotlivým případem porušení povinnosti je 1 000 Kč NE - individuální pochybení, sankce Ne
V. část 7. standardů TPS. nekontroluje platnost jízdního dokladu nastupujícího příslušné individuální pochybení 1 000 Kč
cestujícího nebo neprodá jízdní doklad dle zaměstnance. udělena za každé pochybení zvlášť
Prostřednictvím samoobslužných validátorů lze zakoupit jednotlivé jízdenky s definovaných podmínek (za každý případ / spoj)
úhradou ODISkou (včetně jízdenek pro spolucestující, psy a zavazadla) nebo Jednotlivým případem porušení povinnosti je NE - individuální pochybení, sankce Ano
BK (včetně režimu capping). Samoobslužné validátory zajišťují nahrávání Samoobslužné validátory neprodají jízdenku nebo příslušný samoobslužný validátor v daném
transakcí z Greenlistu na ODISku. nenahrají transakci dle definovaného standardu. provozním dni. udělena za každé pochybení zvlášť
Stránka 7 z 8
Tabulka smluvních sankcí - Technické a provozní standardy ODIS Příloha č. 9 TPS ODIS
Název Znění povinnosti Způsob porušení Definice jednotlivého příípadu Výše sankce za jednotlivý Opakovaná sankce (vč. podmínek Ochranná
dokumentu Článek případ
udělení opakované sankce) lhůta
TPS ODIS V. část 9. KODIS zajišťuje provoz mobilní aplikace ODISapka s možností nákupu jízdenek. Jednotlivým případem porušení povinnosti je 500 Kč NE - individuální pochybení, sankce Ne
Odbavovací a prodejní zařízení vlakové čety příslušné odbavovací a prodejní zařízení
vlakové čety v daném provozním dni. udělena za každé pochybení zvlášť
Kontrola zakoupených jízdenek je zajištěna prostřednictvím odbavovacích a
nezkontroluje jízdenky mobilní aplikace ODISapka.
prodejních zařízení vlakové čety.
Stránka 8 z 8
Technické a provozní standardy ODIS – Příloha č. 10
Zastávky náhradní autobusové dopravy (NAD)
Tato příloha rozpracovává určení zastávek NAD (v případě dopravních terminálů stanovišť
NAD) při výlukách infrastruktury a mimořádných situacích vzniklých během rutinního
provozu. Označení zastávek NAD provádí správce označníku na přidělených zastávkách
(stanovištích). V případě, že se zastávka NAD neshoduje se zastávkou městské hromadné
dopravy či příměstské autobusové dopravy (zastavení je stanoveno na jiném místě než na
zastávce), provádí dopravce označení NAD na nejbližším vhodném místě vždy však po
domluvě s KODISem. KODIS může určit označení dané zastávky formou přenosného
zastávkového označníku.
Zastávky náhradní autobusové dopravy pro trať č. 323, úsek Ostrava hl. n. –
Frenštát pod Radhoštěm město, jsou určeny následovně:
Ostrava hl. n. – autobusová zastávka Ostrava, hlavní nádraží (konkrétní stanoviště
bude určeno před zahájením provozu vybraného dopravce).
Ostrava-Stodolní – bez označení, cestující během výluky nebo mimořádné události
použijí náhradně spojů MHD.
Ostrava střed – autobusová zastávka Ostrava, ÚAN nebo před staniční budovou,
případně spoje MHD (konkrétní varianta bude určena před zahájením provozu
vybraného dopravce).
Ostrava-Kunčičky – bez označení, cestující během výluky nebo mimořádné události
použijí náhradně spojů MHD.
Ostrava-Kunčice – před staniční budovou.
Vratimov – před staniční budovou.
Paskov – autobusová zastávka Řepiště, žel. st. Paskov.
Lískovec u Frýdku – před staniční budovou.
Frýdek-Místek – autobusová zastávka Frýdek-Místek, Frýdek, žel. st. (Konkrétní
stanoviště bude určeno před zahájením provozu vybraného dopravce.)
Baška – autobusová zastávka Baška, žel. st.
Pržno – autobusová zastávka Pržno, žel. st.
Frýdlant nad Ostravicí – autobusová zastávka Frýdlant nad Ostravicí, žel. st.
(Konkrétní stanoviště bude určeno před zahájením provozu vybraného dopravce.)
Čeladná – autobusová zastávka Čeladná, žel. st.
Kunčice pod Ondřejníkem – autobusová zastávka Kunčice pod Ondřejníkem, žel. st.
Frenštát pod Radhoštěm – autobusová zastávka Frenštát pod Radhoštěm, žel. st.
(Konkrétní stanoviště bude určeno před zahájením provozu vybraného dopravce.)
Frenštát pod Radhoštěm město – autobusová zastávka Frenštát pod Radhoštěm, u
škol (konkrétní stanoviště bude určeno před zahájením provozu vybraného dopravce).
Grafické označení zastávek náhradní autobusové dopravy je určeno na obrázku na dalších
stránkách. Variantně je pro lepší viditelnost na zastávkách použit také bílý podklad.
Tato příloha může být s ohledem na změnu zastávek náhradní autobusové dopravy či
s ohledem na změnu grafické podoby označení zastávek průběžně aktualizována.
1
2
3
Procesy MSK
Greenlist MSK
Vlastník dokumentace: Koordinátor ODIS s.r.o.
Verze 0.6
11. 4. 2014
Vlastník dokumentace: Koordinátor ODIS s.ro. List 1/19
Procesy MSK
Obsah
INFORMACE O DOKUMENTU .................................................................................................................. 4
Historie změn ...................................................................................................................................... 4
Seznam použitých zkratek a výrazů..................................................................................................... 4
1 Základní koncepce ........................................................................................................................... 5
1.1 Reklamace a vrácení kupónu................................................................................................... 6
2 Datové toky ..................................................................................................................................... 6
2.1 Z e-shopu na Clearing .............................................................................................................. 7
2.2 Z Clearingu na e-shop .............................................................................................................. 7
2.3 Z odbavovacího zařízení na Clearing. ...................................................................................... 7
2.4 Z Clearingu na odbavovací zařízení ......................................................................................... 7
3 Bezpečnost použití greenlistu ......................................................................................................... 8
4 Distribuce Greenlistu....................................................................................................................... 8
4.1 Žádost o Greenlist ................................................................................................................... 8
4.2 Odpověď - Greenlist ................................................................................................................ 9
4.2.1 Předplacené dobití EP.................................................................................................... 10
4.2.2 Předplacené kupóny...................................................................................................... 11
5 Zasílání transakcí ........................................................................................................................... 12
5.1 Transakce mezi CC a e-shopem ............................................................................................. 13
5.1.1 Předplacené dobití EP na e-shopu................................................................................. 13
5.1.2 Předplacený nákup kupónu na e-shopu........................................................................ 13
5.2 Transakce mezi CC a odbavovacím zařízením ....................................................................... 14
5.2.1 Provedení záznamu předplacené transakce nákupu kupónu na kartu ......................... 14
5.2.2 Provedení záznamu předplacené transakce dobití EP na kartu .................................... 14
6 Záznam Greenlistu na kartu .......................................................................................................... 15
7 Proces odbavení cestujícího .......................................................................................................... 16
7.1 Kontrola vůči blacklistu a greenlistu karet ............................................................................ 17
7.2 Nahrání předplaceného kupónu............................................................................................ 18
7.3 Nahrání dobití předplacené EP.............................................................................................. 19
Vlastník dokumentace: Koordinátor ODIS s.ro. List 2/19
Procesy MSK
Obrázky
Obrázek 1: Základní architektura komunikace........................................................................................................ 5
Obrázek 2: Kontrola vůči blacklistu karet.............................................................................................................. 17
Obrázek 3 Nahrání předplaceného kupónu........................................................................................................... 18
Obrázek 4 Kredit předplacené EP .......................................................................................................................... 19
Vlastník dokumentace: Koordinátor ODIS s.ro. List 3/19
INFORMACE O DOKUMENTU Procesy MSK
Historie změn Autor
Nenka
Datum Verze Stav Nenka
Nenka
1. 4. 2014 0.1 Vytvoření dokumentu Nenka
Úprava příkladů, dopracování procesů Nenka
7. 4. 2014 0.2 Zapracování připomínek L. Kovaříka Nenka
Zapracování připomínek z jednání ze dne 11. 4.
10. 4. 2014 0.3 2014
Přidání příkladu převodu kupónu z GL na
11. 4. 2014 0.4 náhradní kartu
Upřesnění procesu odbavení cestujícího
15.5.2014 0.5
31.8.2015 0.6
Seznam použitých zkratek a výrazů
Zkratka, výraz Význam
BČK Bezkontaktní čipová karta, která je použita jako nosič informací týkajících se odbavení
cestujících.
BlackList Soubor zakázaných karet a SAM
ČD České dráhy a.s.
EMT EM test ČR spol. s r.o.
Karta ODIS Karta používaná v IDS Moravskoslezského kraje - ODIS
KODIS Koordinátor ODIS, s.r.o.
ME Mikroelektronika spol. s r.o.
MSK Moravskoslezský kraj
ODIS Integrovaný dopravní systém Moravskoslezského kraje
MHD Městská hromadná doprava
PAD Příměstská automobilová doprava
SAM Secure Access Module, bezpečnostní modul
EP Elektronická peněženka
ŽD Železniční doprava
GreenList Soubor zakoupených kupónů a dobití EP přes e-Shopy všech dopravců
GL GreenList
Vlastník dokumentace: Koordinátor ODIS s.ro. List 4/19
Procesy MSK
Greenlist
Greenlist je xml soubor sloužící k vytvoření záznamu na kartě ODIS o transakci, která byla provedena
na e-shopu.
Greenlist je spravován a distribuován Clearingem MSK. Existují dva soubory Greenlistu, a to:
• Greenlist EP, který slouží pro transakce dobití EP prováděné prostřednictvím E-shopu.
• Greenlist kupónů, který slouží pro transakce zakoupení kupónů prostřednictvím EP
1 Základní koncepce DOPRAVCE 1
E-Shop 1 Správa Odbavovací
zařízení zařízení 1
(případně CM)
Odbavovací
zařízení n
Clearing MSK
DOPRAVCE n
E-Shop n Správa Odbavovací
zařízení zařízení 1
(případně CM)
Odbavovací
zařízení n
Obrázek 1: Základní architektura komunikace
Cestující si může zakoupit kupón nebo dobíjecí transakci na e-shopu a provést její úhradu prostředky,
které mu e-shop umožňuje. Tímto se z dané dobíjecí transakce stává předplacená transakce, která je
zaslána na clearing. Na clearing se tedy zasílají transakce až po úhradě, tedy až po spárování
s platbou.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 5/19
Procesy MSK
Tyto transakce jsou e-shopem zasílány na clearing, který jim přiřadí jednoznačné, stále rostoucí,
identifikační číslo a zařadí do Greenlistu ve struktuře definované větou KODIS.
Greenlist je poté distribuován na jednotlivá odbavovací zařízení nebo revizorská zařízení, která před
každým odbavení provedou kontrolu, zda pro přiloženou kartu existuje záznam v GL, a pokud ano,
provedou zápis této předplacené transakce na kartu. Při zápisu je kontrolováno a na kartu
zaznamenáno unikátní, stále rostoucí, číslo, která slouží jako bezpečnostní prvek proti zneužití. Tento
bezpečnostní prvek je podrobněji poslán v kapitole3 Bezpečnost použití greenlistu.
Odbavovací zařízení poté odesílá transakci o provedeném zápisu na kartu na Clearing, který již
nahranou transakci vyřadí z GL.
Předplacenou transakci, která byla zaslána na CC, již není možno stornovat.
Kupony jsou z GL automaticky odstraňovány po uplynutí platnosti, pokud nebyly na kartu nahrány.
1.1 Reklamace a vrácení kupónu
Reklamace platného kupónu je prováděna standardně na přepážkách vrácením alikvotní částky. Není-
li kupón ještě nahrán na kartě, provede se nejprve jeho nahrání v rámci procesu reklamace a ihned
poté se provede jeho vrácení.
Je-li karta ztracená nebo vadná a kupón z GL ještě nebyl na kartu nahrán, provede se blokace staré
karty a převod kupónu na novou kartu. Kupón na GL zůstává do doby své platnosti, kdy automaticky
bude z GL odstraněn. Na kartu jej již nebude možno nahrát, protože stará karta bude trvale
zablokována.
Bude-li cestující požadovat vrácení kupónu, který zůstává na GL z důvodu, že se nevejde na kartu, což
je zaviněno cestujícím, musí cestující nejdříve požádat o vrácení některého z kupónů nahraných na
kartě (což může být sankcionováno poplatkem) a až poté mu bude na kartu nahrán kupón z GL, který
může být následně vrácen, pokud vrácení cestující požaduje (opět se sankčním poplatkem, neboť
zavinění situace je na straně cestujícího).
2 Datové toky
Pojem odbavovací zařízení není v této kapitole chápán doslovně jako koncové zařízení, ale jako
systém, který koncová zařízení spravuje a provádí fyzicky exporty a importy z/do těchto zařízení.
Formát XML předávaných dat je určen pro komunikaci mezi systémy CC a správou koncových
zařízení. Formát předávaných dat mezi správou koncových zařízení a samotným koncovým zařízením
si volí každý dopravce dle svého uvážení.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 6/19
Procesy MSK
2.1 Z e-shopu (případně CM) na Clearing
Předplacené transakce jsou zasílány bezprostředně po vzniku transakce, nejpozději 2x denně.
• Transakce o zakoupení předplaceného kupónu.
• Transakce o zakoupení předplaceného dobití EP
• Žádost o GL předplacených kuponů.
• Žádost o GL předplaceného nabití EP.
2.2 Z Clearingu na e-shop (případně CM)
Veškeré odpovědi jsou zasílány ihned, jako reakce na žádost.
• Odpověď na transakci o zakoupení předplaceného kupónu.
• Odpověď na transakci o zakoupení předplaceného dobití EP
• GL předplacených kuponů.
• GL předplaceného nabití EP.
2.3 Z odbavovacího zařízení na Clearing.
Data jsou zasílána alespoň jednou denně, výjimečně může interval prodloužen až na 3 dny, pokud
vozidlo nemá možnost spojení dříve.
• Žádost o GL předplacených kuponů.
• Žádost o GL předplaceného nabití EP.
• Transakce o zápisu předplaceného dobití EP na kartu.
• Transakce o zápisu předplaceného kupónu na kartu.
2.4 Z Clearingu na odbavovací zařízení
Veškerá data jsou zasílána ihned, jako reakce na žádost.
• GL předplacených kuponů.
• GL předplaceného nabití EP.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 7/19
Procesy MSK
3 Bezpečnost použití greenlistu
Greenlist je zabezpečen proti neoprávněným pokusům zneužití na off-line zařízení, kde by cestující
mohl, po nahrání předplaceného kupónu na kartu, provést na přepážce vrácení kupónu a následně na
jiném off-line zařízení tento kupón opět nahrát, protože by stále byl v seznamu GL.
Z důvodu zamezení této manipulace je každé předplacené transakci na CC přiřazeno stále rostoucí,
unikátní číslo, které je při nahrání předplacené transakce zaznamenáno:
• v případě předplacené kupónu do struktury cardInfo v položce couponsPrepaidTransaction
• v případě předplacené transakce EP do struktury walletPersonalSettingsInfo v položce
walletPersCreditTransaction
Před nahráním předplacené transakce na kartu provede odbavovací zařízení kontrolu tohoto
unikátního čísla, a to tak, že číslo, které již karta obsahuje, musí být nižší, než číslo předplacené
transakce, kterou odbavovací zařízení hodlá nahrát. V opačném případě nahrání předplacené
transakce neprovede.
V rámci nahrávání předplacené transakce se provádí přepsání tohoto unikátního čísla na kartě, a při
dalším nahrávání další předplacené transakce se tato situace opakuje.
Obsahuje-li GL více záznamů pro jednu kartu, zařízení je musí nahrávat na kartu v pořadí od
nejstaršího po nejmladší, tedy od nejnižšího čísla po nejvyšší, aby kontrolní mechanismus nezamezil
nahrání dalšího záznamu.
Je-li na GL více čekajících transakcí, než kolik se na kartu vejde, budou na kartu nahrány jen ty
záznamy, které dle platných podmínek mohou být nahrány. Za zakoupený počet kupónů nebo částky
předplaceného dobití je zodpovědný držitel karty. Na čekající transakce, které není možno na kartu
dohrát, nebude cestující odbavován.
4 Distribuce Greenlistu
• Greenlist je distribuován formou XML souboru z Clearingu MSK, kde spojení iniciuje dopravce
nebo e-shop a greenlist je zaslán jako odpověď na žádost.
• Greenlist bude dopravce stahovat denně a získaný greenlist importovat do odbavovacích zařízení
co nejdříve, nejpozději však do 3. dne od stažení.
4.1 Žádost o Greenlist
Při odeslání následujícího XML se vrátí seznam předplacených transakcí - greenlist. Je možné si
vyžádat greenlist jen pro určitého dopravce a to tak že v elementu < greenlist > se definuje jejich
seznam (oddělený čárkou). Pokud dopravci nejsou uvedeni, vrátí se globální seznam předplacených
transakcí. Seznam je navíc možno omezit datumovým rozsahem (datem vzniku objednávky -
Vlastník dokumentace: Koordinátor ODIS s.ro. List 8/19
Procesy MSK
parametr TransactionWhen). Zda se vrací dobití EP nebo kupónu se rozlišuje pomocí elementu
<type>.
Příklad XML souboru:
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>greenlist</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>1</itemscount>
<lang>cz</lang>
</header>
<items>
< greenlist>
<type>EP</type>
<provider>0,1</provider>
<datefrom>2012-06-01</datefrom>
<dateto>2012-06-01</dateto>
</ greenlist>
</items>
</rootCC>
type – typ seznamu – EP=seznam pro EP, COUPON=seznam pro kupóny (povinná položka)
provider – kód(y) dopravce, pokud není specifikováno, vrací se seznam pro všechny dopravce
(nepovinná položka)
datefrom – počáteční datum rozsahu (nepovinná položka)
dateto – koncové datum rozsahu – (nepovinná položka)
4.2 Odpověď - Greenlist
Jako odpověď CC zasílá seznam předplacených transakcí, a to buď pro EP nebo pro kupón v závislosti
od žádosti.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 9/19
Procesy MSK
4.2.1 Předplacené dobití EP
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>greenlist_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>3</itemscount>
<lang>cz</lang>
</header>
<items>
<greenlist_ret cardsno="000000001" card_kodis=”92012345678907456467”
provider=”0” contractsaleagent=”155” contractsaledevice=”1” amount=”150”
trno=”100” tr_type=”EP” currency=”CZK”/>
…
</items>
</rootCC>
Význam jednotlivých položek
Atribut Popis Omezení Povinná
max. 16 znaků položka
cardsno výrobní číslo karty v hexadecimálním
tvaru Ano
card_kodis
provider identifikační číslo karty max. 20 znaků Ano
kód subjektu (poskytovatele) karty hodnota 0 až 200, Ano
aktuálně používané
hodnoty 0, 9, 25, 53, 62,
63, 65, 66, 67, 92, 93
contractsaleagent pokladník, který nabíjel EP hodnota 0 až Ne
2147483647
contractsaledevice číslo prodejního místa hodnota 0 až Ne
2147483647
amount částka dobití EP hodnota 0 až 4500 Ano
trno
identifikační číslo transakce hodnota 0 až Ano
(dimenzováno na 1000 let, proto není
2147483647
Vlastník dokumentace: Koordinátor ODIS s.ro. List 10/19
Procesy MSK
řešeno přetečení)
tr_type typ transakce, zdali se jedná o hodnota EP nebo Ano
currency peněženku nebo kupón
COUPON
peněžní měna, ve které byla provedena hodnota CZK Ne
transakce
4.2.2 Předplacené kupóny
<?xml version="1.0" encoding="UTF-8"?>
<rootCC>
<header>
<xmltype>greenlist_ret</xmltype>
<version>1</version>
<errorcode/>
<error/>
<itemscount>3</itemscount>
<lang>cz</lang>
</header>
<items>
<greenlist_ret cardsno="000000001" card_kodis=”92012345678907456467”
provider=”0” contractsaleagent=”155” contractsaledevice=”1” tp=”10” cp=”20”
zones=”1,2,3,4” validfrom=”2012-01-01 00:00:00” validto=”2012-12-31 23:59:59”
amount=”150” passengers-count=”2” trno=”150” tr_type=“COUPON“
currency=”CZK” contractjourneytype=“2“ />
…
</items>
</rootCC>
Na kartu jsou zapisovány informace (provider, contractsaleagent, contractsaledevice) subjektu, který
kupón prodal, nikoliv subjektu, který jej nahrál.
Význam jednotlivých položek
Atribut Popis Omezení Povinná
položka
cardsno výrobní číslo karty v hexadecimálním max. 16 znaků Ano
tvaru
card_kodis identifikační číslo karty max. 20 znaků Ano
provider kód subjektu (poskytovatele) karty hodnota 0 až 200, Ano
aktuálně používané List 11/19
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
hodnoty 0, 9, 25, 53, 62,
63, 65, 66, 67, 92, 93
contractsaleagent pokladník, který nabíjel EP hodnota 0 až Ne
2147483647
contractsaledevice číslo prodejního místa hodnota 0 až Ne
2147483647
tp tariff-profile kupónu hodnota 0 až 100 Ano
cp customer-profile kupónu hodnota 0 až 100 Ano
zones seznam zón oddělených čárkou Čísla zón (max 10) Ano
oddělené čárkou
(Celosíťová jízdenka má
číslo 352).
validfrom počátek platnosti kupónu Ano
validto konec platnosti kupónu Ano
amount částka dobití EP hodnota 0 až 4500 Ano
passengers-count počet cestujících hodnota 0 až 60 Ano
trno identifikační číslo transakce hodnota 0 až 16777215 Ano
tr_type typ transakce, zdali se jedná o hodnota EP nebo Ano
pěněženku nebo kupón
COUPON
currency peněžní měna, ve které byla provedena hodnota CZK Ne
transakce
contractjourneytype typ trasy hodnota 0 až 10 Ne
5 Zasílání transakcí
Transakce jsou detailně popsány ve větě KODIS, zde jsou uvedeny příklady pro konkrétní typy
transakcí zasílaných v rámci datových toků greenlistu.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 12/19
Procesy MSK
5.1 Transakce mezi CC a e-shopem
5.1.1 Předplacené dobití EP na e-shopu
Pořízení žádosti na dobití EP přes e-shop bankovním převodem
<transaction tx-id="5" card-id="04105DEA052280" appl-id="34965" type="dep" when="2012-01-
06T13:50:00.000" amount-type="bank" transtype="eshop-ep" amount="700.0" currency="CZK" vat="0"
balance_before="0" balance_after="700.0" note="" />
Poznámka: jednoznačné ID e-shop transakce vygeneruje CC a vrátí ho v odpovědním XML v atributu
eshop-tr-id
Pořízení žádosti na dobití EP přes e-shop platební kartou
<transaction tx-id="5" card-id="04105DEA052280" appl-id="34965" type="dep" when="2012-01-
06T13:50:00.000" amount-type="card" transtype="eshop-ep" amount="700.0" currency="CZK" vat="0"
balance_before="0" balance_after="700.0" note="" />
Poznámka: jednoznačné ID e-shop transakce vygeneruje CC a vrátí ho v odpovědním XML v atributu
eshop-r-id
5.1.2 Předplacený nákup kupónu na e-shopu
Pořízení žádosti na dobití časového kupónu přes e-shop bank. převodem
<transaction tx-id="3" card-id="045056B26A1E80" appl-id="4609" when="2012-01-06T13:28:31.000"
type="pay" amount-type="bank" transtype="eshop-c" amount="225" currency="CZK" vat="14"
zone="21" valid-from="2012-01-06 00:00:00" valid-to="2012-02-04 00:00:00" tariff="14" tariff-
type="PP" person-type="1" note="" passengers-count="1" />
Poznámka: jednoznačné ID e-shop transakce vygeneruje CC a vrátí ho v odpovědním XML v atributu
eshop-tr-id
Pořízení žádosti na dobití časového kupónu přes e-shop bank. převodem
<transaction tx-id="3" card-id="045056B26A1E80" appl-id="4609" when="2012-01-06T13:28:31.000"
type="pay" amount-type="card" transtype="eshop-c" amount="225" currency="CZK" vat="14"
zone="21" valid-from="2012-01-06 00:00:00" valid-to="2012-02-04 00:00:00" tariff="14" tariff-
type="PP" person-type="1" note="" passengers-count="1" />
Poznámka: jednoznačné ID e-shop transakce vygeneruje CC a vrátí ho v odpovědním XML v atributu
eshop-tr-id
Vlastník dokumentace: Koordinátor ODIS s.ro. List 13/19
Procesy MSK
5.2 Transakce mezi CC a odbavovacím zařízením
5.2.1 Provedení záznamu předplacené transakce nákupu kupónu na kartu
Provedení fyzického dobití časového kupónu na základě transakce z green-listu
<transaction tx-id="3" card-id="045056B26A1E80" appl-id="4609" when="2012-01-06T13:28:31.000"
type="pay" amount-type="eshop" transtype="mhdp"
line="900250" sequence="11" amount="225" currency="CZK" vat="14" zone="21" valid-from="2012-
01-06 00:00:00" valid-to="2012-02-04 00:00:00" tariff="14" tariff-type="PP" person-type="1" note=""
eshop-tr-id=”100” />
5.2.2 Provedení záznamu předplacené transakce dobití EP na kartu
Provedení fyzického dobití EP na základě transakce z green-listu
<transaction tx-id="5" card-id="04105DEA052280" appl-id="34965" type="dep" when="2012-01-
06T13:50:00.000" amount-type="ep" transtype="uni" line="900250" sequence="11" amount="700.0"
currency="CZK" vat="0" balance_before="0" balance_after="700.0" note="" eshop-tr-id=”100” />
5.2.3 Příklad převodu kupónu z GL na náhradní a novou kartu
• ztracená karta : card-id – 00000001, card-kodis-id - 111111
• náhradní karta : card-id – 00000002, card-kodis-id - 222222
• nová karta: card-id – 00000003, card-kodis-id - 333333
Zrušení kuponu ze ztracené/vadné karty:
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1" sumcount="1"
vat="14" premise="1">
<transaction when="1.1.2012 16:05:00" type="dep" amount-type="move" transtype="eshop-c" amount="350"
vat="14" tx-id ="122552" note="převod karty 00000001" zone=“3“ currency="CZK" valid-from="1.1.2012
14:05:00" valid-to="1.1.2013 14:05:00" card-kodis-id=“111111“ tariff="14" tariff-type="PP" person-
type="1" reclamation=“0“ eshop-tr-id=”100” />
</transactions>
Zde není card-id ani app-id, v card-kodis-id je uvedeno číslo karty, ze které se převádí kupóny. Kupón bude
zneplatněn.
Nahrání kuponu na náhradní kartu:
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1" sumcount="1"
vat="14" premise="1">
<transaction card-id="00000002" appl-id="4609" when="1.1.2012 16:05:00" type="dep" amount-type="move"
transtype="eshop-c" amount="350" vat="14" tx-id="122553" note="převod karty 00000002" zone=“3“
currency="CZK" valid-from="1.1.2012 14:05:00" valid-to="1.1.2013 14:05:00" tariff="14" tariff-type="PP" person-
type="1" reclamation=“0“ eshop-tr-id=”100” />
</transactions>
Vlastník dokumentace: Koordinátor ODIS s.ro. List 14/19
Procesy MSK
Nejedná se o nákup nového kupónu.
Zrušení kuponu z náhradní karty:
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1" sumcount="1"
vat="14" premise="1">
<transaction when="1.1.2012 16:05:00" type="dep" amount-type="move" transtype="eshop-c" amount="350"
vat="14" tx-id ="122554" note="převod karty 00000002" zone=“3“ currency="CZK" valid-from="1.1.2012
14:05:00" valid-to="1.1.2013 14:05:00" card-kodis-id=“222222“ tariff="14" tariff-type="PP" person-
type="1" reclamation=“0“ eshop-tr-id=”100” />
</transactions>
Zde není card-id ani app-id v card-kodis-id je uvedeno číslo karty, ze které se převádí kupóny. Kupón bude
zneplatněn.
Nahrání kuponu na novou kartu:
<transactions lang="cs" version="1.0" device-id="1" cashno="1" paycount="0" depozitcount="1" sumcount="1"
vat="14" premise="1">
<transaction card-id="00000003" appl-id="4609" when="1.1.2012 16:05:00" type="dep" amount-type="move"
transtype="eshop-c" amount="350" vat="14" tx-id="122555" note="převod karty 00000003" zone=“3“
currency="CZK" valid-from="1.1.2012 14:05:00" valid-to="1.1.2013 14:05:00" tariff="14" tariff-type="PP" person-
type="1" reclamation=“0“ eshop-tr-id=”100” />
</transactions>
Nejedná se o nákup nového kupónu.
6 Záznam Greenlistu na kartu
Mapování ostatních informací z položek GL do struktury karty je pro přehlednost zobrazeno
v následující tabulce:
Položka CCMSK položky
(MSK_012_MSKarta30) (Návrh_datové_věty_pro_MSK_1.0.46.5)
ContractProvider Dobití kuponu Dobití EP
CouponType
ContractSaleAgent provider
ContractSaleDevice
ContractSaleSerialNumber tariff-type
contractsaleagent contractsaleagent
contractsaledevice contractsaledevice
trno
Vlastník dokumentace: Koordinátor ODIS s.ro. List 15/19
Procesy MSK
ContractValidityStartDate Validfrom
ContractValidityStartTime Validfrom
ContractValidityEndDate Validto
ContractValidityEndTime Validto
ContractAmount passengers-count
ContractTariffProfile tp
ContractCustomerProfile cp
ContractPrice amount amount
ContractJourneyZones zones provider
trno
WalletPersProvider
WalletPersCreditTransaction
ContractHasJourney contractjourneytype
7 Proces odbavení cestujícího
V GL se nebude nacházet pouze poslední transakce, ale všechny čekající transakce (tedy např. dobiji
na eshopu 100,- a za dva dny 300,-, tak při nástupu do autobusu mi budou obě transakce na kartu
nahrány, pokud se na ni vejdou. Transakce budou na kartu nahrávány postupně, což je v procesech
uvedeno.
V případě, čekajících kupónů na GL, které se na kartu nevejdou, nebude cestující na tento "čekají"
kupón odbaven, cestující si může zakoupit pouze takový počet kupónu, které má uvedeno v
podmínkách pro cestujícího. Zodpovědnost za "pokus o přeplnění" karty je tedy na cestujícím a
škoda, která mu v důsledku tohoto pokusu vznikla (musel si zaplatit jízdu i když měl na GL kupón,
který se na kartu nevešel) jde k tíži cestujícího.
Při nákupu kupónu na eshopu sice bude kontrolován max. počet kupónů, ale tato kontrola nebude
100%, protože transakce o nákupu jiného kupónu v autobuse ještě nemusela do systému dorazit.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 16/19
7.1 Kontrola vůči blacklistu a greenlistu karet Procesy MSK
Přiložení karty List 17/19
Je karta Ano
na blacklistu? Karta blokována
Ne
Setřídit záznamy GL EP a
kupónů pro danou kartu dle
čísla transakce vzestupně
Je karta Ano
na greenlistu EP?
Dobití předplacené
EP
Ne
Je karta Ano Dobití
na greenlistu předplaceného
Kuponu? kuponu
Ne
Čtení dopravní
aplikace
Obrázek 2: Kontrola vůči blacklistu karet
Poznámka:
- Proces předchází procesům
o Kontrola ve vozidlech PAD, MHD a ŽD
o Zakoupení kilometrické jízdenky
o Zakoupení jednotkové městské jízdenky
o Zakoupení časového kupónu
o Dobití EP
Vlastník dokumentace: Koordinátor ODIS s.ro.
Procesy MSK
7.2 Nahrání předplaceného kupónu
Kontrola vůči
greenlistu kupónů
Volný soubor Ne Není prostor
seasonTicketFile? na kartě
Ano READ_CARD_INFO
(ověření podpisu, kontrola
Neplatná karta Ne Karta platná?
platnosti karty a
Ano publisherNetworkID = 203811)
Kontrola CP READ_CARD_HOLDER_INFO
cestujícího (holderProfile1 nebo
holderProfile2 musí
(viz. kap. Chyba! odpovídat požadované
jízdence)
Nelze dobít Kupon Větší než na couponsPrepa
Pokračovat dalším greenlistu idTransaction
číslem GL transakce
pro danou kartu na kartě
Menší než na WRITE_TICKET
greenlistu (couponType = 0
contractHasJourney = 2 (zónový
Zápis časového kupón) nebo contractHasJourney =
kupónu na kartu 0 (síťová jízdenka) + zápis
seasonTicketInfo dle MSKarta)
+ zápis couponsPrepaidTransaction
z greenlistu na kartu
Ne - 1x Úspěšný Ne - 2x
zápis?
Ano
Signalizace OK; Vadná karta,
Tisk dokladu Reklamace
Obrázek 3 Nahrání předplaceného kupónu
Poznámky:
- Časový kupón se zapisuje na první volný soubor (č. 0-3, starý nebo „prázdný“)
Vlastník dokumentace: Koordinátor ODIS s.ro. List 18/19
Procesy MSK
- Tisk dokladu není pro tento případ, ze strany KODIS, stanoven a je na vůli každého dopravce.
7.3 Nahrání dobití předplacené EP
Kontrola vůči
greenlistu EP
Neplatná karta Ne Karta platná? READ_CARD_INFO
(ověření podpisu, kontrola
platnosti karty a
publisherNetworkID = 203811)
Nelze dobít EP Větší nebo walletPersCre
Pokračovat dalším rovno než na ditTransaction
číslem GL transakce greenlistu
pro danou kartu na kartě
Menší než na
greenlistu
Kredit EP CREDIT_PURSE
+zápis
walletPersCreditTransaction
z greenlistu na kartu
Úspěšný kredit
Tisk dokladu
Obrázek 4 Nahrání dobití předplacené EP
Poznámka:
- Proměnná „StatusEP“:
o status souboru walletSettingsFile = 7 kontroluje SAM
- SAM kontroluje:
o status souboru walletSettingsFile = 7
o je debet povolen(allowedDebet)
o nejsou překročeny hodnoty maxValueEP
o není překročena platnost EP
- EP je na kartě aktivována
- Tisk dokladu není pro tento případ, ze strany KODIS, stanoven a je na vůli každého dopravce.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 19/19
Procesy MSK
Yellowlist MSK
Vlastník dokumentace: Koordinátor ODIS s.r.o.
Verze 0.1
1.10. 2019
Vlastník dokumentace: Koordinátor ODIS s.ro. List 1/9
Obsah
INFORMACE O DOKUMENTU ....................................................................................................... 3
Historie změn ................................................................................................................................... 3
Registrace jízdného ...................................................................................................................... 5
Registrace dokupovaného jízdného ............................................................................................. 6
Stažení yellowlistu platných jízdenek .......................................................................................... 7
Chybové stavy..............................................................................................................................9
2
INFORMACE O DOKUMENTU
Historie změn
Datum Verze Stav Autor
Vytvoření dokumentu Nenka
1. 10. 2019 0.1
3
Yelloulist
Yelloulist je xml soubor, který tvoří seznam jízdenek, zakoupených prostřednictvím automatického
zařízení ve vlacích.
Rozhraní budou dostupná pomocí webové služby ze serveru KODIS. Předání dat probíhá online
ihned po obdržení dotazu na server formou odpovědi na dotaz.
WS ostrá verze: https://clearing.kodis.cz/NameOfService/DataService.asmx
WS testovací verze: https://clearing.kodis.cz/ NameOfServiceTest/DataService.asmx
Adresa služby bude doplněna.
Ověřování probíhá jako basic access authentication.
Pro volání jednotlivých metod je dále požadován Userlogin (uživatelský login) a Password
(uživatelské heslo) dopravce, který musí mít rovněž nastaveno právo pro online komunikaci
s webovou službou.
Seznam dostupných metod webové služby:
RegisterFare – registrace jízdného
RegisterAdditionalFare – registrace dokupovaného jízdného
GetYellowlist – stažení platných jízdenek
4
Registrace jízdného
Pro registraci jízdného do systému je dostupná metoda RegisterFare().
Request Type Description Default Required?
Parameter string uživatelský login dopravce N/A Yes
Userlogin string uživatelské heslo dopravce N/A Yes
Password
Fare string číslo karty ODIS nebo token BK N/A Yes
Token
TxID int číslo transakce N/A Yes
When
Line datetime datum a čas provedení transakce N/A Yes
Sequence
DepartureID string linka N/A No
ArrivalID
PassesThroughID int spoj N/A No
CustomerProfile
TariffProfile int číslo nástupní stanice N/A No
ValidFrom
ValidTo int číslo výstupní stanice N/A No
Amount
Vat int číslo průjezdní stanice N/A No
short profil zákazníka N/A Yes
short tarifní profil N/A Yes
datetime platnost jízdenky od N/A No
datetime platnost jízdenky do N/A No
decimal cena jízdenky N/A Yes
byte DPH N/A Yes
Response Type Description Default Required?
Parameter int stav zpracování
ResponseStatus N/A Yes
ErrorCode
0 – OK
ErrorMessage string Jinak číslo chyby N/A Yes
popis chyby
Výčet chyb naleznete na konci dokumentu.
5
Registrace dokupovaného jízdného
Pro registraci dokupovaného jízdného do systému je dostupná metoda RegisterAdditionalFare().
Request Type Description Default Required?
Parameter string uživatelský login dopravce N/A Yes
Userlogin string uživatelské heslo dopravce N/A Yes
Password
AdditionalFare string číslo karty ODIS nebo token BK N/A Yes
Token
TxID int číslo transakce N/A Yes
When
Line datetime datum a čas provedení transakce N/A Yes
Sequence
DepartureID string linka N/A No
ArrivalID
PassesThroughID int spoj N/A No
CustomerProfile
TariffProfile int číslo nástupní stanice N/A No
ValidFrom
ValidTo int číslo výstupní stanice N/A No
TotalAmount
Vat int číslo průjezdní stanice N/A No
Count
short profil zákazníka N/A Yes
short tarifní profil N/A Yes
datetime platnost jízdenky od N/A No
datetime platnost jízdenky do N/A No
decimal celková cena jízdenky N/A Yes
byte DPH N/A Yes
byte počet jízdenek v jízdence N/A Yes
Response Type Description Default Required?
Parameter int stav zpracování
ResponseStatus N/A Yes
ErrorCode
0 – OK
ErrorMessage string Jinak číslo chyby N/A Yes
popis chyby
Výčet chyb naleznete na konci dokumentu.
6
Stažení yellowlistu platných jízdenek
Pro stažení platných jízdenek ze systému je dostupná metoda GetYellowlist().
Request Type Description Default Required?
Parameter string uživatelský login dopravce N/A Yes
Userlogin string uživatelské heslo dopravce N/A Yes
Password typ: N/A Yes
Type int FULL (plný),
INC (inkrementální) N/A No
SequenceNoStart počáteční pořadové číslo (povinné
v případě INC)
Response Type Description Default Required?
Parameter
YellowlistList string verze souboru N/A No
YellowlistHeader datetime datum vytvoření dávky
FileVersion int pořadové číslo N/A No
IssueDateTime typ:
SequenceNo int FULL (plný), N/A No
Type bool INC (inkrementální)
počet záznamů N/A No
ItemsCount příznak, zdali došlo k resetu
Reset N/A No
YellowlistItem
Token N/A No
TxID
When string číslo karty ODIS nebo token BK N/A Yes
Line
Sequence int číslo transakce N/A Yes
DepartureID
ArrivalID datetime datum a čas provedení transakce N/A Yes
PassesThroughID
CustomerProfile string linka N/A No
TariffProfile
ValidFrom int spoj N/A No
ValidTo
Amount int číslo nástupní stanice N/A No
Count
Type int číslo výstupní stanice N/A No
ResponseStatus int číslo průjezdní stanice N/A No
ErrorCode
short profil zákazníka N/A Yes
short tarifní profil N/A Yes
datetime platnost jízdenky od N/A No
datetime platnost jízdenky do N/A No
decimal cena jízdenky N/A Yes
byte počet jízdenek v jízdence N/A No
FARE – jízdné N/A Yes
ADDITIONAL_FARE –
dokupované jízdné
int stav zpracování N/A Yes
0 – OK
ErrorMessage string Jinak číslo chyby N/A Yes
popis chyby
7
Výčet chyb naleznete na konci dokumentu.
8
Chybové stavy
-1: Uživatelský účet nenalezen (chybný uživatelský login nebo heslo)
-2: Uživatelský účet nemá přiděleno právo 'Online komunikace'
9
Technické a provozní standardy ODIS – Příloha č. 13
Požadavky na provedení Testovacího provozu
V rámci Testovacímu provozu bude ověřena funkčnost odbavovacího a prodejního zařízení
vlakové čety a prodejního zařízení pokladní přepážky pro stanice (dále společně jen jako
„odbavovací zařízení“), ve smyslu Technických a provozních standardů ODIS včetně jejich
příloh (dále jen „TPS ODIS").
Za Objednatele zajistí pro Dopravce součinnost pro provedení a ověření Testovacího provozu
Koordinátor ODIS s.r.o. (dále jen „KODIS“), který Dopravci písemně potvrdí úspěšné provedení
Testovacího provozu.
1. Odbavovací zařízení musí zajistit bezproblémový proces odbavení cestujících na bázi
bezkontaktní čipové karty typu MIFARE DESFire EV1 8 kB (dále jen „BČK“). Musí
umožnit prodej cestovního dokladu, jak papírového, tak na platformě BČK podle
platného Tarifu ODIS. Odbavovací zařízení musí akceptovat jakékoliv vydané BČK dle
požadavků stanovených v dokumentu „Struktura BČK Moravskoslezské karty“. Zařízení
musí splňovat bezpečnostní zásady (bezpečné úložiště klíčů v odbavovacím zařízení –
SAM modul, bezpečná komunikace odbavovacího zařízení s bezkontaktní čipovou
kartou, atd.). Komunikace zařízení s kartou na odbavovacím a prodejním zařízení
vlakové čety musí trvat krátkou dobu – za jakékoliv situace a při jakékoliv tarifní
kombinaci do 5 sekund od přiložení karty.
2. Odbavovací zařízení musí plnit tyto funkce - prodej papírového jízdního dokladu,
plnění elektronické peněženky, nahrání jednotlivého jízdného ODIS na BČK při prodeji
z elektronické peněženky, nahrání dlouhodobého časového jízdného ODIS na BČK při
platbě z elektronické peněženky nebo za hotovost, nahrání dlouhodobého časového
jízdného ODIS zakoupeného přes e-shop, nahrání kreditu elektronické peněženky
zakoupeného přes e-shop, zaplacení přirážky při platbě z elektronické peněženky BČK
nebo za hotovost nebo z BK (bankovní platební karty) - platí pro odbavovací a
prodejní zařízení vlakové čety, reklamační proces, čímž se rozumí vystornování
jakékoliv operace provedené v rámci odbavení BČK, proces vrácení jízdného - úplné
nebo částečné vrácení DČJ nebo vrácení jízdného na prodejním zařízení pokladní
přepážky pro stanice. Odbavovací zařízení musí mít dostatečnou paměťovou kapacitu
pro Tarif ODIS, musí zvládat zapisovat data přímo do paměti BČK, musí generovat
výstupní sestavy dle požadavků clearingového centra stanovených v dokumentu
„Návrh datové věty pro MSK“, musí umět pracovat s jednotnými vstupními daty
popisujícími Tarif ODIS, který bude spravovat KODIS a který je součástí clearingového
centra, popis je opět definován v „Návrhu datové věty pro MSK“.
1
3. KODIS poskytne Dopravci bezpečným způsobem klíče ke kartám a SAM modulům.
4. Dopravce v rámci testování požadavků pro odbavení cestujícího prokáže připravenost
svého odbavovacího zařízení pro odbavení cestujících. Testování bude probíhat
v místě a termínu dle dohody Dopravce s KODIS. Výzvu k přípravě a provedení
Testovacího provozu vznese Dopravce vůči KODIS.
5. Dopravci budou dány k dispozici testovací BČK, testovací SAM modul, testovací
autentizační klíče, testovací greenlisty a blacklist (velikost greenlistu s kreditem
elektronické peněženky do 100 záznamů, velikost greenlistu s dlouhodobými
časovými jízdenkami do 2 000 záznamů, velikost blacklistu do 500 záznamů).
6. Smluvní strany se dohodly, že je Dopravce povinen zajistit, že odbavovací zařízení
bude muset splňovat následující minimální základní stanovené parametry a funkce pro
garanci funkčnosti budoucího plnění:
(a) Autentizace a odemčení SAM modulu umístěného v terminálu, a to zadáním
PINu na odbavovacím zařízení a přiložením odemykací karty ke čtecí zóně
odbavovacího zařízení.
(b) Propojení s e-shopem: v rámci provozních testů bude předložen Dopravci
greenlist s daty o nákupu na e-shopu, který si dopravce stáhne sám do svého
zařízení z testovacího Clearingu. Data o nákupu na e-shopu mohou být
alternativně po dohodě předána na USB flash disku. Dopravce nahraje
greenlist do odbavovacího zařízení. V dalším kroku bude přiložena k zařízení
BČK Objednatele, pro kterou bude v greenlistu záznam transakce, zařízení
nahraje transakci na BČK. Správnost zápisu na kartu bude ověřena na zařízení
Dopravce.
7. V rámci testů bude předložen Dopravci i blacklist BČK, který si dopravce stáhne sám
do svého zařízení z testovacího Clearingu. Blacklist BČK může být alternativně po
dohodě předán na USB flash disku. Dopravce nahraje blacklist do odbavovacího
zařízení. V dalším kroku bude přiložena k zařízení BČK Objednatele, pro kterou bude v
blacklistu záznam. BČK zapsaná na blacklistu musí být odbavovacím zařízením
odmítnuta – nesmí se na ni provést žádný zápis.
8. Pro účely testů bude mít odbavovací zařízení nahrán jízdní řád linky z oblasti VŘ.
9. Ověření správnosti odbavení dle Tarifu ODIS bude provedeno tehdy, pokud Dopravce
úspěšně splní tyto úkoly:
o nabití kreditu Elektronické peněženky;
o nákup dlouhodobé časové jízdenky na zóny, které určí Objednatel, a to jak
platbou v hotovosti, tak z Elektronické peněženky;
2
o prodej jednotlivé jízdenky v hotovosti;
o prodej jednotlivé jízdenky z BK v rámci režimu retail;
o prodej jednotlivé jízdenky z Elektronické peněženky BČK Objednatele dle
dokumentu Procesy MSK, odbavení s vygenerovaným nárokem na přestup dle
Tarifu ODIS;
o prodej jednotlivé jízdenky z jiné stanice, než je stanice aktuální;
o na BČK Objednatele je uložena dlouhodobá časová jízdenka ODIS pro část
trasy. Odbavení proběhne automatizovaně po přiložení BČK k zařízení, obsluha
pouze nastaví požadovanou cílovou stanici, zařízení uzná zóny pro část trasy
pokrytou dlouhodobou časovou jízdenkou ODIS a prodá pro zbývající část
trasy jednotlivou jízdenku s řádnou platností dle Tarifu ODIS (úsek pokrytý
dlouhodobou časovou jízdenkou může být na začátku, na konci, nebo děleně
po trase);
o Na BČK Objednatele bude zakoupen v e-shopu kredit elektronické peněženky,
dále DČJ. Po přiložení BČK k zařízení musí zařízení nejdříve provést nahrání
objednaných transakcí z e-shopu a následně prodat jízdenku pro
požadovanou trasu, a to na „jedno“ přiložení BČK. V případě odtrhnutí karty
při nahrávání musí zařízení upozornit obsluhu nebo držitele o nutnosti
provedení dokončení celé operace.
o Na mobilním zařízení Objednatele bude zakoupena jízdenka z mobilní
aplikace ODISapka. Odbavovací a prodejní zařízení vlakové čety vyhodnotí
jízdenku po přiložení a přečtení 2D kódu.
o SW odbavovacího zařízení musí zobrazit platné dlouhodobé časové jízdenky
ODIS uložené na BČK Objednatele a zůstatek kreditu elektronické peněženky
na BČK Objednatele.
3
Technické a provozní standardy ODIS – Příloha č. 14
Výjimky v plnění bodů
Technických a provozních standardů ODIS
Výjimku v plnění bodů Technických a provozní standardů lze udělit pouze po domluvě
se KODISem a pouze písemnou formou.
Výjimka v plnění Technických a provozních standardů ODIS je udělena v případě bodů:
Kapitola II. STANDARD VOZIDEL ODIS
Článek 2. Standardy vybavení vozidel provozovaných v ODIS
Bod 2.1 Elektronické informační panely nebo tabule
Vozidla dle standardu ODIS 6 uvedená do provozu před uzavřením smlouvy není
nutno dodatečně opatřovat čelními elektronickými informačními panely na čelech
soupravy. Toto se týká i vozidel rekonstruovaných.
Vozidla dle standardu ODIS 6 uvedená do provozu před uzavřením smlouvy není
nutno dodatečně opatřovat bočními elektronickými informačními panely. V takovém
případě je nutno vozidla opatřit náhradním informačním systémem v podobě
kartonové či plastové cedule s vyvedením označení linky a trasy vlaku. Základní
návrh vzhledu kartonové či plastové cedule určuje společnost KODIS. V případě, že
jsou dveře na boku vozidla od sebe umístěny ve vzdálenosti menší než 10 metrů, lze
opatřit kartonovou či plastovou cedulí pouze jedny z nich.
Bod 2.2 Vnitřní elektronický vizuální informační systém
Vozidla dle standardu ODIS 6 uvedená do provozu před uzavřením smlouvy není
nutno dodatečně opatřovat vnitřním elektronickým vizuálním informačním systémem.
Bod 2.3 Akustický elektronický informační systém
Vozidla dle standardu ODIS 6 uvedená do provozu před uzavřením smlouvy není
nutno dodatečně opatřovat akustickým elektronickým informačním systémem.
Vozidla dle standardu ODIS 5 a ODIS 6 není nutno opatřovat vlakovým rozhlasem,
informovanost cestujících o mimořádnostech či jiných operativních opatřeních však
musí být zajištěna náhradním způsobem (např. vlakovou četou).
1
Bod 2.4 Dveře vozidla, místa pro kočárky a osoby s omezenou schopností
pohybu
Vozidla dle standardu ODIS 5 a ODIS 6 uvedená do provozu před uzavřením smlouvy
není nutno dodatečně vybavovat systémem poptávkového otevírání dveří.
Vozidla dle standardu ODIS 5 a ODIS 6 není nutno dodatečně vybavovat systémem
automatického zavírání po ukončení nástupu a výstupu cestujících.
Bod 2.5.1 Odbavovací terminály
Vozidla dle standardu ODIS 5 a ODIS 6 není nutno dodatečně opatřovat
odbavovacími terminály.
Bod 2.6 Signalizační zařízení uvnitř vozidla
Vozidla dle standardu ODIS 5 a ODIS 6 uvedená do provozu před uzavřením smlouvy
není nutno opatřovat signalizačním zařízením umožňujícím informovat strojvedoucího
či vlakovou četu o požadavku cestujícího na vozíku pro invalidy na výstup
na zastávce a o požadavku rychlé pomoci (SOS tlačítko).
Vozidla dle standardu ODIS 6 uvedená do provozu před uzavřením smlouvy není
nutno dodatečně opatřovat požadovaným počtem tlačítek sloužícím požadavku
cestujícího
na výstup na zastávce na znamení.
Bod 2.11 Klimatická pohoda vozidel
Vozidla dle standardu ODIS 5 a ODIS 6 není nutno dodatečně vybavovat aktivní
plnohodnotnou klimatizací. Vozidla ODIS 5 a ODIS 6 v případě temperování vozidla
nepřekročí teplotu 24 °C uvnitř vozidla.
Bod 2.13 Uspořádání interiéru vozidla
Vozidla dle standardu ODIS 5 a ODIS 6 není nutno dodatečně opatřovat zásuvkami
230 V a USB porty.
Bod 2.14 Wi-Fi
Vozidla dle standardu ODIS 6 uvedená do provozu před uzavřením smlouvy není
nutno dodatečně opatřovat příslušným zařízením dle bodu 2.14.
2
Technické a provozní standardy ODIS – Příloha č. 15
Metodický pokyn k označení ŽKV a NAD při výlukách
Tento metodický pokyn byl vytvořen za účelem sjednocení pravidel označování železničních kolejových
vozidel a autobusů náhradní dopravy během výlukových činností, omezení kapacity dráhy a případně
během platnosti nařízení vyhlášených Vládou ČR, která zásadním způsobem ovlivňují pravidelný
provoz vlaků železniční dopravy. Odkaz na tento výlukový pokyn bude součástí Rozkazu o výluce
(ROV).
1. Označování během výluky na vnějších panelech vozidel
Během konání výluky je nutné na vnějších informačních elektronických panelech vozidel
(případně na cedulích vozidel) vlakové soupravy dodržet označení platné cílové stanice.
Příklad: Probíhá výluka Háj ve Slezsku – Štítina. Osobní vlak jedoucí z Českého Těšína do Opavy
východu nese na informačních panelech (kromě označení čísla linky) označení cílové stanice Opava
východ. Toto označení platí pro vlaky před vyloučeným úsekem i za vyloučeným úsekem.
2. Označování během výluky na vnitřních panelech vozidel
Během konání výluky je nutné na vnitřních informačních elektronických panelech vozidel
(případně na cedulích vozidel) vlakové soupravy dodržet označení platné cílové stanice.
Příklad: Probíhá výluka Háj ve Slezsku – Štítina. Osobní vlak jedoucí z Českého Těšína do Opavy
východu nese na informačních panelech (kromě označení čísla linky) označení cílové stanice Opava
východ. Toto označení platí pro vlaky před vyloučeným úsekem i za vyloučeným úsekem.
Doplňkově lze na vnitřních informačních elektronických panelech zobrazit informace o výluce,
například: Mezi stanicemi Háj ve Slezsku – Štítina probíhá výluka traťové koleje a v tomto úseku je
zavedená náhradní autobusová doprava.
3. Označování autobusů náhradní dopravy
Během konání výluky je nutné označovat autobusy náhradní autobusové dopravy (NAD)
pouze úsekem, který je vedený NAD. Příklad: Probíhá výluka Háj ve Slezsku – Štítina. NAD
jedoucí z Háje ve Slezsku do Štítiny je označena následovně:
a. Na vnějším informačním elektronickém panelu (kromě čísla linky) název stanice, do
které je NAD organizovaná. Na vnějším informačním elektronickém panelu je nutné
zobrazit text „dále přestup na vlak“. Nepřestupuje-li se dále do vlakové soupravy,
postačí pouze číslo linky a název stanice.
b. V případě označení autobusu NAD papírovou cedulí je nutné zobrazit také logo
Integrovaného dopravního systému Moravskoslezského kraje ODIS a číslo linky. Na
papírových cedulích je možné doplňkově vypsat také důležité nácestné stanice a
zastávky. Na papírové ceduli je možno doplnit kromě místa výchozí a cílové stanice
také text „a zpět“ (pro obousměrné označení lze použít také šipky místo textu „a
zpět“). Akceptováno je také rozlišení vozidel NAD textem „zastávkový“ nebo
„zrychlený“. Nebude-li doplněn text „a zpět“ nebo nebudou-li doplněny šipky
na papírovou ceduli, bude označení bráno jako chybné, v případě uvedení
opačného směru jízdy, než spoj NAD právě obsluhuje.
1
4. Informační panely v železničních stanicích
Na centrálních informačních elektronických panelech v železničních stanicích a zastávkách (tam, kde
jsou tyto panely zřízeny) je uváděna cílová stanice vlaku dle platného jízdního řádu včetně výlukových
jízdních řádů. Informace o výlukách jsou zobrazovány na informační tabuli formou textu „NÁHRADNÍ
DOPRAVA“ ve sloupci „směr“. Doplňkově mohou být uvedeny informace formou běžícího textu o úseku
výluky, případně začátku a konci její platnosti. Cestujícím je informace o náhradní dopravě sdělována
také akustickou formou. Podrobnější informace o výlukách je nutné umístit v tištěné formě ve stanici
nebo zastávce na místě k tomu určeném.
5. Mimořádnosti, nasazení vozidel jiných řad, redukce jízdních řádů
Při mimořádnosti, mimořádné události či redukci jízdních řádů, kdy může dojít k nasazení vozidel
jiných řad než obvyklých, nebo při nasazování jiných řad v pravidelném provozu je nutné tato vozidla
označit následovně:
a. Na vnějším informačním elektronickém panelu cílovou stanicí a volitelně číslem linky
a vybranými nácestnými zastávkami.
b. Na vnitřním informačním elektronickém panelu cílovou stanicí a volitelně číslem linky
a vybranými nácestnými zastávkami.
c. Papírovou cedulí tištěnou, na které bude zobrazeno číslo linky, výchozí stanice, cílová
stanice (volitelně nácestné zastávky), doplnění textu „a zpět“ (případně doplnění
šipek).
d. V případě nemožnosti dodržení bodů a-c je nutné označit vozidla základními prvky –
číslem linky cílovou stanicí. V případě uvedení výchozí a cílové stanice je taktéž
tolerováno doplnění textem „a zpět“ nebo šipek.
V případě mimořádnosti a mimořádné události budou dílčí nedostatky v označování vlaků
tolerovány. Bude-li mimořádnost nebo mimořádná událost trvat déle než 4 hodiny, bude
postupováno formou sankcí při nesprávném označení vlaku. Mimořádnou událostí se ve
smyslu tohoto pokynu rozumí mimořádná událost v drážní dopravě – vykolejení soupravy,
střet s osobou, projetí návěsti stůj, střet s překážkou na trati. Za mimořádnost se ve
smyslu tohoto pokynu nepovažuje:
a. Nasazení jiné než obvyklé řady vozidel.
b. Odlišné nasazení vozidla z důvodu výluky nebo mimořádnosti trvající déle než 4
hodiny.
c. Odchylka od plánovaného oběhu z důvodu dispozice dopravce.
d. Úprava řazení vlaku (např. operativní posílení).
2
Technické a provozní standardy ODIS – Příloha č. 16
Zajištění propagace objednatele
Propagací objednatele – Moravskoslezského kraje (dále jen Objednatel) se rozumí propagace
respektující Manuál jednotného vizuálního stylu – Corporate design manual (dále jen Manuál)
– a umístění logotypu s názvem „Moravskoslezský kraj“ a doplňkového grafického prvku –
prstýnků na vozidla Dopravce. Tento Manuál je dostupný na webové stránce
https://www.msk.cz/assets/verejnost/manual.pdf Objednatele. Důležité je dodržet níže
uvedené specifikace:
Umístění logotypu s názvem „Moravskoslezský kraj“ se týká všech vozidel provozovaných na
základě Smluv o veřejných službách v přepravě cestujících k zajištění dopravní obslužnosti
kraje veřejnou drážní osobní dopravou (dále jen Smlouvy) a jejich novelizovaných Dodatků.
Umístění doplňkového grafického prvku – prstýnků – je uvažováno pouze u vozidel standardu
ODIS 4. Rozšíření umístění doplňkového grafického prvku – prstýnků na vozidla standardu
ODIS 5 a ODIS 6 záleží na společné dohodě Objednatele a Dopravce.
Logotyp s názvem „Moravskoslezský kraj“
- Logotyp bude zpracován v souladu s Manuálem Objednatele.
- Logotyp bude umístěn na obou bocích, konkrétní umístění podléhá schválení
Objednatelem.
- Velikost a barevné provedení logotypu podléhá Manuálu a schválení Objednatelem, tj.
konkrétní grafický návrh musí být před samotnou realizací (aplikací na vozidlo)
odsouhlasen Objednatelem.
- Originál logotypu, písma a barevnosti je uložen v digitalizované podobě na Krajském
úřadě Moravskoslezského kraje.
Doplňkový grafický prvek – prstýnky
- Jedná se o grafický prvek, přesný popis je stanoven v Manuálu Objednatele.
- Grafický prvek – prstýnky bude umístěn na bočnice vozidla po dohodě
s Objednatelem.
- Velikost a barevné provedení grafického prvku – prstýnků podléhá Manuálu a
schválení Objednatelem, tj. konkrétní grafický návrh musí být před samotnou realizací
(aplikací na vozidlo) odsouhlasen Objednatelem.
- Originál grafického prvku a barevnosti je uložen v digitalizované podobě na Krajském
úřadě Moravskoslezského kraje.
Označení Integrovaného dopravního systému Moravskoslezského kraje ODIS
- Logotyp bude umístěn na všech dveřích vozidel s výjimkou dvoukřídlých dveří, kdy
postačuje umístění pouze na jednom křídle. Konkrétní umístění podléhá schválení
Objednatelem a KODIS. Ve vyjmenovaných případech může být označení umístěno
v blízkosti dveří.
- Velikost a barevné provedení logotypu specifikuje KODIS.
- Originál logotypu, písma a barevnosti je uložen v digitalizované podobě poskytne
Dopravci na vyžádání KODIS.
Další propagační činnost bude projednána mezi Objednatelem, KODIS a Dopravcem a na
základě výsledků společných jednání bude případně realizována.
1
OBSAH:
1. ÚVOD ...................................................................................................................................................... 2
1.1 VZTAH K PRAVIDLŮM PRO ŽADATELE A PŘÍJEMCE OPD A K DOKUMENTACI PROGRAMU 127 65 .................................... 2
1.2 KOMPETENCE A KONTAKTY .............................................................................................................................. 2
2. VYMEZENÍ POUŽITÝCH POJMŮ A ZKRATEK.............................................................................................. 3
2.1 VYMEZENÍ POJMŮ (NEUVEDENÝCH NEBO ODLIŠNÝCH OD PRAVIDEL PRO ŽADATELE A PŘÍJEMCE OPD) ............................. 3
2.2 POUŽITÉ ZKRATKY .......................................................................................................................................... 3
3. PODMÍNKY PODPORY A CHARAKTERISTIKA PODPOROVANÝCH INVESTIC............................................... 3
3.1 PŘÍJEMCI PODPORY ........................................................................................................................................ 3
3.2 ZPŮSOBILÉ VÝDAJE ......................................................................................................................................... 4
3.3 NEZPŮSOBILÉ VÝDAJE ..................................................................................................................................... 4
3.4 PŘESNÉ PODMÍNKY POSKYTNUTÍ PODPORY .......................................................................................................... 5
3.5 DALŠÍ UPŘESŇUJÍCÍ PODMÍNKY PRO POSKYTNUTÍ PODPORY ................................................................................... 10
3.6 UPŘESŇUJÍCÍ PODMÍNKY PRO ZÁRUKY PŘEVODU Z DOTACE POŘÍZENÝCH VOZIDEL ...................................................... 12
4. INDIKÁTORY A UDRŽITELNOST VÝSTUPŮ PROJEKTU ............................................................................. 14
5. HODNOCENÍ ŽÁDOSTÍ O PODPORU ....................................................................................................... 14
6. UPŘESNĚNÍ POŽADOVANÝCH PŘÍLOH ŽÁDOSTI O PODPORU ................................................................ 15
1
1. Úvod
Tento program (Pořízení a modernizace železničních kolejových vozidel – ev. č. 127 65) je
jedním z programů, které jsou určeny k naplnění Specifického cíle 1.5 - Vytvoření
podmínek pro širší využití železniční a vodní dopravy prostřednictvím modernizace
dopravního parku a to v rámci INVESTIČNÍ PRIORITY 3 prioritní osy 1: Rozvoj a
zlepšování dopravních systémů šetrných k životnímu prostředí, včetně systémů s nízkou
hlučností, a nízkouhlíkových dopravních systémů, včetně vnitrozemské a námořní lodní
dopravy, přístavů, multimodálních spojů a letištní infrastruktury s cílem podporovat
udržitelnou regionální a místní mobilitu (nařízení (EU) č. 1300/2013 o Fondu soudržnosti, čl.
4, odst. (d), bod ii.). Realizací programu je podporováno zvýšení atraktivity osobní železniční
dopravy, vedoucí ke zvýšení podílu této dopravy na přepravním trhu.
1.1 Vztah k Pravidlům pro žadatele a příjemce OPD a k dokumentaci
programu 127 65
Žadatelé o podporu jsou povinni řídit se platnou verzí Pravidel pro žadatele a příjemce OPD.
Příjemci jsou povinni řídit se vždy platnou verzí Pravidel pro žadatele a příjemce OPD,
nebude-li stanoveno v právním aktu o poskytnutí / převodu podpory jinak.
Tyto specifické podmínky výzvy upřesňují ustanovení týkající se přípravy a
implementace projektů uvedená v platné verzi Pravidel pro žadatele a příjemce OPD.
Tyto specifické podmínky výzvy dále upřesňují ustanovení uvedená v dokumentaci
programu Pořízení a modernizace železničních kolejových vozidel (ev. č. 127 65, dále jen
„Program“).
Specifické podmínky výzvy jsou pro žadatele a příjemce závazné.
1.2 Kompetence a kontakty
Řídicím orgánem Operačního programu Doprava je Ministerstvo dopravy. Odbor fondů EU
(O 430) je pověřen výkonem funkce Řídicího orgánu a mezi jeho kompetence patří mimo jiné
metodické nastavení OPD, příjem, schvalování, monitoring a kontroly projektů.
Nastavení podmínek jednotlivých výzev probíhá ve spolupráci s věcně příslušným odborem
MD. Pro tento program plní funkci věcně příslušného odboru Odbor veřejné dopravy
(O 190).
Žadatelé se mohou v případě dotazů obrátit na kontakty uvedené na webu Řídicího orgánu
OPD na stránce s dokumentací výzvy (http://web.opd.cz/vyzva-28/) nebo na e-mail
zkv@opd.cz. V případě technických dotazů se lze obrátit přímo na zástupce Odboru veřejné
dopra
2
2. Vymezení použitých pojmů a zkratek
2.1 Vymezení pojmů (neuvedených nebo odlišných od Pravidel pro žadatele a
příjemce OPD)
Dnem zahájení realizace projektu je datum prvního právně závazného příslibu
objednávky vozidel.
Doba udržitelnosti (trvalost operace) je doba 5 let od data, kdy projekt nabyl centrální
stav1 „Projekt finančně ukončen ze strany ŘO“, tzn. data proplacení poslední žádosti o platbu
příjemci. Doba udržitelnosti je specifikována v právním aktu o poskytnutí podpory nebo jeho
příloze.
Dopravce je provozovatel drážní dopravy podle § 2 odst. 4 zákona č. 266/1994 Sb., o
drahách.
Objednatel veřejné dopravy je orgán veřejné správy (zpravidla kraj) objednávající
regionální železniční dopravu v závazku veřejné služby podle Nařízení (EU) č. 1370/2007.
Smlouva o veřejných službách je smluvní vztah mezi objednatelem a dopravcem,
uzavřený na základě článku 3 Nařízení (EU) č. 1370/2007, vedoucí k zajištění regionální
veřejné dopravy na železnici v závazku veřejné služby.
Železniční vozidlo je kolejové vozidlo, sloužící k přepravě osob po železnici,
odpovídající ustanovením zákona č. 266/1994 Sb., o drahách.
2.2 Použité zkratky
ČR – Česká republika
EU – Evropská unie
ETCS – European Train Control Systém, česky evropský vlakový zabezpečovací systém
GSM-R – Global System for Mobile Communications – Railway, mezinárodní standard
bezdrátové komunikace určený pro železniční aplikace
OPD – Operační program Doprava (2014 – 2020)
PPŽaP – Pravidla pro žadatele a příjemce OPD
ŘO OPD – Řídicí orgán Operačního programu Doprava (Ministerstvo dopravy)
TSI – Technické specifikace pro interoperabilitu
ZV – způsobilý výdaj
3. Podmínky podpory a charakteristika podporovaných investic
Předmětem podpory poskytované v rámci tohoto Programu jsou investice:
- na pořízení železničních kolejových vozidel, která jsou určená k provozu v osobní
železniční dopravě regionálního charakteru, zajišťovanému prostřednictvím smlouvy o
veřejných službách. Podrobněji viz kapitola 3.2.
3.1 Příjemci podpory
Příjemce podpory mohou být pouze:
1 Centrální stav udává stav příslušné žádosti o podporu (projektu) z hlediska jejího projektového cyklu v systému
MS2014+. O změnách stavu je žadatel/příjemce průběžně informován v systému IS KP14+.
3
Dopravci s licencí dle § 24 a násl. zákona č. 266/1994 Sb., o dráhách ve znění
pozdějších předpisů, kteří nejpozději k datu vydání rozhodnutí o poskytnutí dotace mají
uzavřenu smlouvu o veřejných službách podle zákona o veřejných službách.
Kraje jako objednatelé dle § 3 odst. 2 zákona o veřejných službách v případě, že
budou vlastníky z dotace pořízených vozidel..
3.2 Způsobilé výdaje
Společné zásady pro způsobilost výdajů jsou uvedeny v PPŽaP, kap. 12.6 a 12.7. Níže je
uvedeno zpřesnění výdajů považovaných za způsobilé v rámci tohoto Programu:
a) propláceny mohou být pouze skutečně vzniklé výdaje vynaložené v souladu s cíli
Programu a bezprostředně související s realizací projektu;
b) ZV musí být vynaloženy až po podání žádosti o podporu;
c) ZV musí být řádně doložené doklady o jejich zaplacení.
Způsobilým výdajem je v tomto Programu pouze nákup nového vozidla pro nadregionální
nebo regionální železniční osobní dopravu. Podpořeny mohou být výhradně tyto konfigurace
vozidel:
- elektrické jednotky a vozy,
- motorové jednotky a vozy,
- netrakční jednotky s lokomotivou,
- netrakční jednotky samostatně a
- ucelené soupravy osobních vozů klasické stavby, umožňující sestavení standardní
vlakové soupravy dle příslušné smlouvy o veřejných službách v drážní dopravě z vozidel
pořízených z dotace. Provozování jiných, než z dotace pořízených, vozidel ve vlakové
soupravě je přípustné pouze v případě mimořádně zvýšené poptávky po přepravě (např. před
státními svátky) po předchozí dohodě s objednatelem předmětných výkonů v závazku veřejné
služby. Soupravy osobních vozů je možno podpořit jak samostatně tak v odůvodněných
případech i s hnacím vozidlem. Elektrická hnací vozidla musí být vyjma odůvodněných
případů schopna provozu na střídavé trakční soustavě 25 kV 50 Hz. Blíže jsou konfigurace
vozidel specifikovány v kapitole 4.2 Programu.
3.3 Nezpůsobilé výdaje
Kategorie nezpůsobilých výdajů jsou vymezeny v PPŽaP, kap. 12.8 „Nezpůsobilé výdaje“.
Z hlediska tohoto Programu (odlišně od PPŽaP) jsou za nezpůsobilé výdaje považovány
takové výdaje, které nastaly před předložením žádosti o podporu.
Daně jsou obecně nezpůsobilým výdajem. Pokud je příjemce podpory plátcem DPH,
pak není oprávněn nárokovat si za způsobilý výdaj DPH s nárokem na odpočet (pro subjekty,
které nejsou plátci DPH, je DPH způsobilým výdajem). Takový příjemce (zpravidla
objednatel veřejné dopravy, pro nějž vlastnictví železničních kolejových vozidel
nepředstavuje ekonomickou činnost) pak (je-li to v souladu s platnými pravidly o účetnictví)
je oprávněn nesnižovat o přijatou dotaci pořizovací cenu vozidla, pokud přijatou dotaci,
časově rozprostřenou na dobu odepisování, účtuje do výnosů. V takovém případě je možné,
že hodnota vozidla bude za dobu jeho používání promítnuta do nákladů objednatele formou
odpisů, které se stanou jednou z kalkulačních položek nájemného fakturovaného dopravci a
dopravce uplatní v souladu s uzavřenou smlouvou o veřejných službách nájemné jako
kompenzovatelnou položku vůči objednateli. Z hlediska finančních toků je mechanismus
tohoto modelu odlišný od modelu pořizování vozidel dopravcem, dopad na výši souhrnné
4
kompenzace za dobu účetního odepisování vozidla je ale v obou případech neutrální, nebo
pozitivní (ve smyslu úspory souvisejících nákladů na financování vynaložených dopravcem a
následně uplatněných jako kompenzovatelné položky vůči objednateli) pro veřejný sektor ve
srovnání se stavem, kdy by si vozidla pořídil dopravce a objednatel takový provoz financoval
na základě standardních vyrovnávacích plateb.
3.4 Přesné podmínky poskytnutí podpory
Podpora je na základě tohoto Programu poskytována z důvodu úzké vazby na zajištění
veřejných služeb v dopravě podle Nařízení (EU) č. 1370/2007. Z toho důvodu je podporu
možné poskytnout pouze za určitých přesně daných podmínek, přičemž existuje úzká vazba
mezi předmětem podpory a uzavíráním smluv o veřejných službách. Vzhledem k tomu, že
příjemce dotace může být buď dopravce, nebo objednatel veřejné dopravy, existuje
v závislosti na způsobu uzavření příslušné smlouvy o veřejných službách 6 situací, při jejichž
splnění je možné podporu poskytnout. V případě, že provoz z dotace pořízených vozidel bude
zajištěn smlouvami o veřejných službách více objednatelů, musí níže uvedené podmínky
splnit všichni dotčení objednatelé. V případě, že z dotace pořízená vozidla budou
provozována na základě přímo zadané smlouvy o veřejných službách uzavřené nejdéle do
roku 2023, je podmínkou přiznání dotace též sjednání dodatku ke smlouvě o zajištění
stabilního financování regionální železniční osobní dopravy mezi státem a kraji, vymezující
podmínky spolufinancování ze státního rozpočtu v případě využití podpory z OPD na pořízení
železničních kolejových vozidel. Tento dodatek musí nabýt platnosti a účinnosti nejpozději do
konce roku 2017. Dodatek musí být účinný vůči kraji, jehož objednaných dopravních výkonů
se čerpání podpory týká, před vydáním rozhodnutí o poskytnutí dotace.
Varianta A1 – žadatelem o dotaci je objednatel veřejných služeb, k zadání
veřejných služeb dopravci dochází na základě provedení otevřeného nabídkového
řízení
K žádosti o dotaci je nezbytné doložit:
1) doklad o zveřejnění záměru uzavřít smlouvu o veřejných službách na základě
nabídkového řízení v Úředním věstníku Evropské Unie na základě článku 7 odstavce 2
Nařízení (EU) č. 1370/2007
Objednatel je povinen k žádosti o dotaci doložit kopii oznámení předběžných informací pro
veřejnou zakázku na služby v Úředním věstníku Evropské unie. Jedná se o běžný formulář pro
oznámení podle čl. 7 odst. 2 Nařízení (EU) č. 1370/2007, který musí být zveřejněn nejméně
jeden rok před zahájením řízení výzvy k podání nabídek v dodatku k Úřednímu věstníku
Evropské unie. Z doloženého oznámení musí být zřejmé, že smlouva bude zadána v otevřeném
nabídkovém řízení (jedná se o informaci v oddíle IV oznámení).
2) doklad o zahájení zadávacího řízení na dodávku předmětných železničních kolejových
vozidel.
Objednatel je povinen k žádosti o dotaci doložit kopii oznámení zadávacího řízení na dodávku
vozidel ve Věstníku veřejných zakázek a v Úředním věstníku Evropské unie. Jedná se o
standardní formulář 2 ve smyslu § 7 písm. b) vyhlášky č. 168/2016 Sb., o uveřejňování
formulářů pro účely zákona o zadávání veřejných zakázek a náležitostech profilu zadavatele.
Varianta A2 – žadatelem o dotaci je dopravce, k zadání veřejných služeb
dopravci dochází na základě provedení otevřeného nabídkového řízení
K žádosti o dotaci je nezbytné doložit:
5
1) doklad o zveřejnění záměru uzavřít smlouvu o veřejných službách na základě
nabídkového řízení v Úředním věstníku Evropské Unie na základě článku 7 odstavce 2
Nařízení (EU) č. 1370/2007
Dopravce je povinen k žádosti o dotaci doložit kopii oznámení předběžných informací pro
veřejnou zakázku na služby v Úředním věstníku Evropské unie. Jedná se o běžný formulář pro
oznámení podle čl. 7 odst. 2 Nařízení (EU) č. 1370/2007, který musí být zveřejněn nejméně
jeden rok před zahájením řízení výzvy k podání nabídek v dodatku k Úřednímu věstníku
Evropské unie. Z doloženého oznámení musí být zřejmé, že smlouva bude zadána v otevřeném
nabídkovém řízení (jedná se o informaci v oddíle IV oznámení).
Varianta B1 – žadatelem o dotaci je objednatel veřejných služeb, k zadání
veřejných služeb dopravci dochází na základě přímého zadání až na dobu 10 let,
kdy nebyl deklarován relevantní zájem jiných dopravců
K žádosti o dotaci je nezbytné doložit:
1) doklad o zveřejnění záměru uzavřít smlouvu o veřejných službách na základě
nabídkového řízení v Úředním věstníku Evropské Unie na základě článku 7 odstavce 2
Nařízení (EU) č. 1370/2007, obsahující informaci o možnosti využití podpory z OPD na
pořízení vozidel, popřípadě jeho oprava zveřejněná v Úředním věstníku Evropské Unie
alespoň po dobu čtyř měsíců.
Objednatel je povinen k žádosti o dotaci doložit kopii oznámení předběžných informací pro
veřejnou zakázku na služby v Úředním věstníku Evropské unie. Jedná se o běžný formulář pro
oznámení podle čl. 7 odst. 2 Nařízení (EU) č. 1370/2007, který musí být zveřejněn nejméně
jeden rok před zahájením řízení výzvy k podání nabídek v dodatku k Úřednímu věstníku
Evropské unie. Z doloženého oznámení musí být zřejmé, že smlouva bude zadána na základě
přímého zadání (jedná se o informaci v oddíle IV oznámení).
V případě, že oznámení předběžných informací neobsahuje informaci o možnosti využití
podpory z OPD na pořízení vozidel na konkrétním provozním souboru, je nezbytné zveřejnit v
Úředním věstníku Evropské Unie změnu oznámení. Předmětná informace o možnosti využití
podpory z OPD na pořízení vozidel musí být zveřejněna v oddíle VI. 1. oznámení a musí
obsahovat vymezení dopravních výkonů, na nichž předpokládá na obnovu vozidel využít
podporu z OPD, a musí obsahovat informaci, že na internetových stránkách www je uveden
vzorový formulář pro uplatnění relevantního zájmu o sjednání smlouvy o veřejných službách v
přepravě cestujících na dopravních výkonech, na nichž objednatel předpokládá na obnovu
vozidel využít podporu z OPD. Žádost o dotaci lze podat nejdříve po uplynutí čtyř měsíců od
dne, kdy byla v Úředním věstníku Evropské unie zveřejněna informace o možnosti využití
podpory z OPD na pořízení vozidel.
2) prohlášení objednatele, že v období čtyř měsíců od dne, kdy byla v Úředním věstníku
Evropské unie zveřejněna informace o možnosti využití podpory z OPD na pořízení vozidel,
nebyl ze strany jiných dopravců vyjádřen relevantní zájem o zajištění veřejných služeb.
Objednatel je povinen k žádosti o dotaci doložit prohlášení, ve kterém jednoznačně deklaruje,
že v období čtyř měsíců od dne, kdy byla v Úředním věstníku Evropské unie zveřejněna
informace o možnosti využití podpory z OPD, neobdržel žádné prohlášení dopravce na
vzorovém formuláři (internetové stránky www), že uplatňuje ve vztahu k oznámení
zveřejněnému v Úředním věstníku Evropské unie podle čl. 7 odst. 2 nařízení EP a Rady (ES)
č. 1370/2007 relevantní zájem o sjednání smlouvy o veřejných službách v přepravě cestujících
na dopravních výkonech, na nichž příslušný orgán předpokládá na obnovu vozidel využít
podporu z OPD.
6
3) doklad o zahájení zadávacího řízení na dodávku předmětných železničních kolejových
vozidel.
Objednatel je povinen k žádosti o dotaci doložit kopii oznámení zadávacího řízení na dodávku
vozidel ve Věstníku veřejných zakázek a v Úředním věstníku Evropské unie. Jedná se o
standardní formulář 2 ve smyslu § 7 písm. b) vyhlášky č. 168/2016 Sb., o uveřejňování
formulářů pro účely zákona o zadávání veřejných zakázek a náležitostech profilu zadavatele.
Varianta B2 – žadatelem o dotaci je dopravce, k zadání veřejných služeb
dopravci dochází na základě přímého zadání až na dobu 10 let, kdy nebyl
deklarován relevantní zájem jiných dopravců
K žádosti o dotaci je nezbytné doložit:
1) doklad o zveřejnění záměru uzavřít smlouvu o veřejných službách na základě
nabídkového řízení v Úředním věstníku Evropské Unie na základě článku 7 odstavce 2
Nařízení (EU) č. 1370/2007, obsahující informaci o možnosti využití podpory z OPD na
pořízení vozidel, popřípadě jeho oprava zveřejněná v Úředním věstníku Evropské Unie
alespoň po dobu čtyř měsíců.
Dopravce je povinen k žádosti o dotaci doložit kopii oznámení předběžných informací ze
strany příslušného objednatele pro veřejnou zakázku na služby v Úředním věstníku Evropské
unie. Jedná se o běžný formulář pro oznámení podle čl. 7 odst. 2 Nařízení (EU) č. 1370/2007,
který musí být zveřejněn nejméně jeden rok před zahájením řízení výzvy k podání nabídek v
dodatku k Úřednímu věstníku Evropské unie. Z doloženého oznámení musí být zřejmé, že
smlouva bude zadána na základě přímého zadání (jedná se o informaci v oddíle IV
oznámení).
V případě, že oznámení předběžných informací neobsahuje informaci o možnosti využití
podpory z OPD na pořízení vozidel na konkrétním provozním souboru, je nezbytné zveřejnit v
Úředním věstníku Evropské Unie změnu oznámení. Předmětná informace o možnosti využití
podpory z OPD na pořízení vozidel musí být zveřejněna v oddíle VI. 1. oznámení a musí
obsahovat vymezení dopravních výkonů, na nichž předpokládá na obnovu vozidel využít
podporu z OPD, a musí obsahovat informaci, že na internetových stránkách www je uveden
vzorový formulář pro uplatnění relevantního zájmu o sjednání smlouvy o veřejných službách v
přepravě cestujících na dopravních výkonech, na nichž objednatel předpokládá na obnovu
vozidel využít podporu z OPD. Žádost o dotaci lze podat nejdříve po uplynutí čtyř měsíců od
dne, kdy byla ze strany příslušného objednatele v Úředním věstníku Evropské unie zveřejněna
informace o možnosti využití podpory z OPD na pořízení vozidel.
2) prohlášení objednatele, že v období čtyř měsíců od dne, kdy byla v Úředním věstníku
Evropské unie zveřejněna informace o možnosti využití podpory z OPD na pořízení vozidel,
nebyl ze strany jiných dopravců vyjádřen relevantní zájem o zajištění veřejných služeb.
Dopravce je povinen k žádosti o dotaci doložit prohlášení příslušného objednatele, ve kterém
jednoznačně deklaruje, že v období čtyř měsíců od dne, kdy byla v Úředním věstníku Evropské
unie zveřejněna informace o možnosti využití podpory z OPD, neobdržel žádné prohlášení
dopravce na vzorovém formuláři (internetové stránky www), že uplatňuje ve vztahu k
oznámení zveřejněnému v Úředním věstníku Evropské unie podle čl. 7 odst. 2 nařízení EP a
Rady (ES) č. 1370/2007 relevantní zájem o sjednání smlouvy o veřejných službách v přepravě
cestujících na dopravních výkonech, na nichž příslušný orgán předpokládá na obnovu vozidel
využít podporu z OPD.
3) smlouva o veřejných službách nebo smlouva o smlouvě budoucí vedoucí k jejímu
uzavření.
7
Dopravce je povinen k žádosti o dotaci doložit smlouvu o veřejných službách s příslušným
objednatelem veřejných služeb, zahrnující dopravní výkony, na nichž budou provozována
vozidla s požadovanou podporou z OPD. Pokud smlouva o veřejných službách není s
objednatelem dosud sjednána, je dopravce povinen k žádosti o dotaci doložit smlouvu o
smlouvě budoucí s objednatelem, vedoucí k uzavření smlouvy o veřejných službách, která
bude zahrnovat dopravní výkony, na nichž budou provozována vozidla s požadovanou
podporou z OPD.
Varianta C1 – žadatelem o dotaci je objednatel veřejných služeb, k zadání
veřejných služeb dopravci dochází na základě přímého zadání nejvýše do roku
2023
K žádosti o dotaci je nezbytné doložit:
1) doklad o zveřejnění záměru uzavřít smlouvu o veřejných službách na základě
nabídkového řízení v Úředním věstníku Evropské Unie na základě článku 7 odstavce 2
Nařízení (EU) č. 1370/2007, obsahující informaci o možnosti využití podpory z OPD na
pořízení vozidel, popřípadě jeho oprava zveřejněná v Úředním věstníku Evropské Unie
alespoň po dobu čtyř měsíců.
Objednatel je povinen k žádosti o dotaci doložit kopii oznámení předběžných informací pro
veřejnou zakázku na služby v Úředním věstníku Evropské unie. Jedná se o běžný formulář pro
oznámení podle čl. 7 odst. 2 Nařízení (EU) č. 1370/2007, který musí být zveřejněn nejméně
jeden rok před zahájením řízení výzvy k podání nabídek v dodatku k Úřednímu věstníku
Evropské unie. Z doloženého oznámení musí být zřejmé, že smlouva bude zadána na základě
přímého zadání (jedná se o informaci v oddíle IV oznámení). V případě, že oznámení
předběžných informací neobsahuje informaci o možnosti využití podpory z OPD na pořízení
vozidel na konkrétním provozním souboru, je nezbytné zveřejnit v Úředním věstníku Evropské
Unie změnu oznámení. Předmětná informace o možnosti využití podpory z OPD na pořízení
vozidel musí být zveřejněna v oddíle VI. 1. oznámení a musí obsahovat vymezení dopravních
výkonů, na nichž předpokládá na obnovu vozidel využít podporu z OPD, a musí obsahovat
informaci, že na internetových stránkách www je uveden vzorový formulář pro uplatnění
relevantního zájmu o sjednání smlouvy o veřejných službách v přepravě cestujících na
dopravních výkonech, na nichž objednatel předpokládá na obnovu vozidel využít podporu z
OPD. Žádost o dotaci lze podat nejdříve po uplynutí čtyř měsíců od dne, kdy byla v Úředním
věstníku Evropské unie zveřejněna informace o možnosti využití podpory z OPD na pořízení
vozidel.
2) doklad o zahájení zadávacího řízení na dodávku předmětných železničních kolejových
vozidel.
Objednatel je povinen k žádosti o dotaci doložit kopii oznámení zadávacího řízení na dodávku
vozidel ve Věstníku veřejných zakázek a v Úředním věstníku Evropské unie. Jedná se o
standardní formulář 2 ve smyslu § 7 písm. b) vyhlášky č. 168/2016 Sb., o uveřejňování
formulářů pro účely zákona o zadávání veřejných zakázek a náležitostech profilu zadavatele.
3) doklad o zveřejnění záměru uzavřít smlouvu o veřejných službách na základě
nabídkového řízení v Úředním věstníku Evropské Unie na základě článku 7 odstavce 2
Nařízení (EU) č. 1370/2007
Objednatel je povinen k žádosti o dotaci doložit kopii oznámení předběžných informací pro
veřejnou zakázku na služby v Úředním věstníku Evropské unie. Jedná se o běžný formulář pro
oznámení podle čl. 7 odst. 2 Nařízení (EU) č. 1370/2007, který musí být zveřejněn nejméně
jeden rok před zahájením řízení výzvy k podání nabídek v dodatku k Úřednímu věstníku
Evropské unie. Z doloženého oznámení musí být zřejmé, že smlouva o veřejných službách
zahrnující dopravní výkony, na nichž budou provozována vozidla s požadovanou podporou z
8
OPD bude nejpozději k prosinci 2023 zadána v otevřeném nabídkovém řízení (jedná se o
informace v oddílech II.3. a IV oznámení).
Varianta C2 – žadatelem o dotaci je dopravce, k zadání veřejných služeb
dopravci dochází na základě přímého zadání nejvýše do roku 2023
K žádosti o dotaci je nezbytné doložit:
1) doklad o zveřejnění záměru uzavřít smlouvu o veřejných službách na základě
nabídkového řízení v Úředním věstníku Evropské Unie na základě článku 7 odstavce 2
Nařízení (EU) č. 1370/2007, obsahující informaci o možnosti využití podpory z OPD na
pořízení vozidel, popřípadě jeho oprava zveřejněná v Úředním věstníku Evropské Unie
alespoň po dobu čtyř měsíců.
Dopravce je povinen k žádosti o dotaci doložit kopii oznámení předběžných informací ze
strany příslušného objednatele pro veřejnou zakázku na služby v Úředním věstníku Evropské
unie. Jedná se o běžný formulář pro oznámení podle čl. 7 odst. 2 Nařízení (EU) č. 1370/2007,
který musí být zveřejněn nejméně jeden rok před zahájením řízení výzvy k podání nabídek v
dodatku k Úřednímu věstníku Evropské unie. Z doloženého oznámení musí být zřejmé, že
smlouva bude zadána na základě přímého zadání (jedná se o informaci v oddíle IV
oznámení). V případě, že oznámení předběžných informací neobsahuje informaci o možnosti
využití podpory z OPD na pořízení vozidel na konkrétním provozním souboru, je nezbytné
zveřejnit v Úředním věstníku Evropské Unie změnu oznámení. Předmětná informace o
možnosti využití podpory z OPD na pořízení vozidel musí být zveřejněna v oddíle VI. 1.
oznámení a musí obsahovat vymezení dopravních výkonů, na nichž předpokládá na obnovu
vozidel využít podporu z OPD, a musí obsahovat informaci, že na internetových stránkách
www je uveden vzorový formulář pro uplatnění relevantního zájmu o sjednání smlouvy o
veřejných službách v přepravě cestujících na dopravních výkonech, na nichž objednatel
předpokládá na obnovu vozidel využít podporu z OPD. Žádost o dotaci lze podat nejdříve po
uplynutí čtyř měsíců od dne, kdy byla ze strany příslušného objednatele v Úředním věstníku
Evropské unie zveřejněna informace o možnosti využití podpory z OPD na pořízení vozidel.
2) smlouva o veřejných službách nebo smlouva o smlouvě budoucí vedoucí k jejímu
uzavření.
Dopravce je povinen k žádosti o dotaci doložit smlouvu o veřejných službách s příslušným
objednatelem veřejných služeb, zahrnující dopravní výkony, na nichž budou provozována
vozidla s požadovanou podporou z OPD. Smlouva musí být uzavřena nejdéle na období do
prosince 2023. Součástí smlouvy musí být závazek dopravce převést vlastnictví vozidel
pořízených s využitím podpory z OPD k okamžiku ukončení smlouvy osobě určené
objednatelem. Pokud smlouva o veřejných službách není s objednatelem dosud sjednána, je
dopravce povinen k žádosti o dotaci doložit smlouvu o smlouvě budoucí s objednatelem,
vedoucí k uzavření smlouvy o veřejných službách, která bude zahrnovat dopravní výkony, na
nichž budou provozována vozidla s požadovanou podporou z OPD, bude uzavřena nejdéle na
období do prosince 2023 a její součástí bude závazek dopravce převést vlastnictví vozidel
pořízených s využitím podpory z OPD k okamžiku ukončení smlouvy osobě určené
objednatelem.
3) doklad o zveřejnění záměru uzavřít smlouvu o veřejných službách na základě
nabídkového řízení v Úředním věstníku Evropské Unie na základě článku 7 odstavce 2
Nařízení (EU) č. 1370/2007
Dopravce je povinen k žádosti o dotaci doložit kopii oznámení předběžných informací ze
strany příslušného objednatele pro veřejnou zakázku na služby v Úředním věstníku Evropské
unie. Jedná se o běžný formulář pro oznámení podle čl. 7 odst. 2 Nařízení (EU) č. 1370/2007,
který musí být zveřejněn nejméně jeden rok před zahájením řízení výzvy k podání nabídek v
9
dodatku k Úřednímu věstníku Evropské unie. Z doloženého oznámení musí být zřejmé, že
smlouva o veřejných službách zahrnující dopravní výkony, na nichž budou provozována
vozidla s požadovanou podporou z OPD, bude ze strany příslušného objednatele nejpozději k
prosinci 2023 zadána v otevřeném nabídkovém řízení (jedná se o informace v oddílech II.3. a
IV oznámení).
3.5 Další upřesňující podmínky pro poskytnutí podpory
(1) Podpora je poskytovaná formou dotace jako nevratná finanční pomoc.
(2) Podpora je účelově určena k úhradě výdajů vzniklých v souvislosti s plněním projektu.
(3) Na podporu není právní nárok.
(4) Podporovaná investice musí být zachována v regionu, v němž se podpora poskytuje,
alespoň po dobu udržitelnosti.
(5) Příjemce podpory musí navrátit veškerou protiprávní podporu (článek 14 nařízení
Rady (ES) č. 659/1999 a zákon č. 218/2000 Sb.).
(6) Příjemce podpory je povinen řádně doložit ZV z hlediska vzniku, uhrazení a přímé
vazby výdaje na projekt.
(7) Projekty/akce financované s účastí státního rozpočtu jsou evidované v Informačním
systému (IS) EDS/SMVS Ministerstva financí. Povinnost jejich evidence v IS vyplývá
z vyhlášky MF č. 560/2006 Sb. Pro žadatele toto znamená nutnost předložení
vyplněných vstupních EDS formulářů akce. Vyplněné vstupní EDS formuláře
nepředkládá žadatel jako povinnou přílohu žádosti o podporu, ale až v případě
schválení žádosti o podporu, tj. po vydání příslušného Schvalovacího protokolu.
Předložení formulářů EDS bude podmínkou Schvalovacího protokolu, jejíž splnění
bude nezbytné pro vydání právního aktu o poskytnutí podpory, tj. Rozhodnutí o
poskytnutí dotace (RoPD). EDS formuláře předkládá žadatel v písemné i elektronické
podobě a adresuje je správci programu formou žádosti o vydání RoPD, na základě
které je žadateli následně RoPD vydáno (včetně podmínek rozhodnutí). Parametry
v EDS formulářích žadatele musí odrážet příslušnou strukturu parametrů v EDS
formulářích programové dokumentace. Formuláře EDS jsou žadatelem pořizovány
online v IS EDS/SMVS. Více k pořízení EDS formulářů a přihlášení žadatele do
systému EDS SMVS je uvedeno na http://www.edssmvs.cz.
(8) Nová vozidla pořízená z dotace musí být provozována výhradně na dopravních
výkonech zajišťovaných v závazku veřejné služby, a to po celou dobu ekonomické
životnosti vozidla. Dopravní výkony uvedené v žádosti o dotaci musí tvořit ucelený
provozní koncept, což znamená provoz na jedné či několika logicky propojených
linkách osobní železniční dopravy, neobjednává-li daný objednatel linky, musí být
tyto výkony realizované na jedné či několika vzájemně souvisejících tratích. Vozidla
musí být provozována na dopravních výkonech, předpokládaných v projektové
žádosti, po celou dobu platnosti smlouvy o veřejných službách, v jejímž rámci budou
vozidla provozována bezprostředně po zařazení do provozu. Vozidla musí být
provozována na dopravních výkonech, předpokládaných v projektové žádosti,
nejméně po dobu udržitelnosti 5 let.
(9) Do přípustných dopravních výkonů mohou být nad rámec dopravních výkonů
uvedených v předchozím bodě zahrnuty i výkony manipulační a technologické, pokud
je jejich realizace spojena s provozem a údržbou předmětného vozidla. Nasazení
vozidla na jakýchkoliv jiných dopravních výkonech může být v mimořádných a
10
odůvodněných případech výslovně odsouhlaseno poskytovatelem dotace. Výkony
mimo závazek veřejné služby, provozované úplatně, jsou výslovně vyloučeny.
(10) Vozidla pořízená v rámci podpory nesmí být po dobu pěti let od uvedení do provozu
převedena příjemcem podpory na jiného majitele nebo dána za předmět zástavy, s
výjimkou realizace nákupu vozidel formou splátkového prodeje; v těchto případech
však jakékoli zajištění musí splňovat ostatní pravidla a podmínky Programu. V
případě realizace zástavního práva je příjemce povinen podporu vrátit. Výjimku tvoří
dále případy, kdy příjemce majetkově převede vozidla pořízená z podpory na
nabyvatele, který bude nadále splňovat pravidla a podmínky Programu.
(11) Nová vozidla pořízená v rámci podpory musí dále být:
- schválena pro provoz na železničních tratích v ČR nejpozději k datu první žádosti o
platbu,
- označena prvky publicity OPD na bočních vnějších stranách vozidla v souladu
s povinnými prvky specifikovanými v Pravidlech pro publicitu v kapitole 16 PPŽaP
(minimální rozměr tohoto označení na každém vozidle je 30 x 120 cm, konkrétní
podoba označení vozidel musí být ze strany Řídícího orgánu předem odsouhlasena),
- vybavena klimatizací v prostorách pro cestující,
- vybavena prostředky bezdrátové komunikace, které budou umožňovat cestujícím
přístup na internet ve formě wi-fi,
- vybavena zásuvkami s napětím 230 V pro napájení drobné elektroniky a přenosných
počítačů v počtu nejméně jedné zásuvky na 4 místa k sezení (s výjimkou sklopných
sedaček),
- vybavena v interiéru vozidla určeném pro přepravu cestujících elektronickým
vizuálním a akustickým informačním systémem pro poskytování informací cestujícím,
- v exteriéru, v případě vozidel, určených pro přepravu cestujících, vybavena na bočních
stranách vnějším elektronickým vizuálním informačním systémem,,
- alespoň jeden vůz v soupravě vozidel vybaven pro přepravu osob se sníženou
schopností pohybu a orientace v souladu s článkem 4.2.2 „Vozidla“ předpisu TSI pro
osoby s omezenou schopností pohybu a orientace.
- vybavena toaletou minimálně dle platných norem TSI (ve vztahu k počtu míst k
sezení), přičemž alespoň jedno WC v soupravě musí být bezbariérově dostupné dle
příslušných předpisů TSI - přípustné jsou pouze toalety s uzavřeným systémem.
- dle platných norem TSI (ve vztahu k počtu míst k sezení) připadne v soupravě
příslušný počet míst pro přepravu dětských kočárků a na každých 100 míst k sezení
připadnou v soupravě alespoň 2 místa pro přepravu jízdních kol (variantně lyží),
vozidla jsou vybavena systémem centrálního zavírání a blokování dveří.
- v případě hnacích vozidel a řídících vozů, pořízených v rámci OPD2 vybavena
příslušným technickým mobilním zařízením, potřebným pro činnost systémů GSM-R
a ETCS, pokud budou provozována na tratích, na kterých se dle Národního
implementačního plánu ERTMS počítá s implementací ETCS level 2, s výjimkou
případů, u nichž se aplikuje článek 9, odstavec 1, písmeno a) směrnice č. 2008/57,
přičemž v těchto případech budou vozidla dovybavena do 5 let od jejich schválení do
provozu.
(12) Příjemce podpory odpovídá za to, že doklady jím předložené ŘO OPD, jsou úplné a
pravdivé.
11
3.6 Upřesňující podmínky pro záruky převodu z dotace pořízených vozidel
Z důvodu zajištění podmínky Programu, že z dotace pořízená vozidla musí být provozována
po celou dobu své ekonomické životnosti v závazku veřejné služby, jsou pro jednotlivé
varianty vazeb mezi příjemci dotace a objednateli podle Nařízení (EU) č. 1370/2007
stanoveny podmínky, zajišťující dodržení této povinnosti. Tyto podmínky rozšiřují a pro
účely výzvy č. 28 zpřesňují základní ustanovení Programu.
Varianta A1 – žadatelem o dotaci je objednatel veřejných služeb, k zadání veřejných
služeb dopravci dochází na základě provedení otevřeného nabídkového řízení
Platí pravidla Programu - nová vozidla pořízená z dotace musí být provozována výhradně na
dopravních výkonech zajišťovaných v závazku veřejné služby, a to po celou dobu
ekonomické životnosti vozidla (ekonomická životnost je podle účetních standardů, obvyklých
v ČR, zpravidla 30 let, přičemž je předpoklad, že i po skončení smlouvy o veřejných službách
provázané s příslušným projektem budou předmětná vozidla v rámci možností jezdit i nadále
na stejných nebo obdobných výkonech v režimu veřejných služeb zajišťovaných
objednatelem v rámci nové smlouvy o veřejných službách).
Pro výběr dopravce po skončení platnosti smlouvy o veřejných službách zadané na základě
otevřeného nabídkového řízení platí pravidla nastavená nařízením (ES) č. 1370/2007.
Varianta A2 – žadatelem o dotaci je dopravce, k zadání veřejných služeb dopravci
dochází na základě provedení otevřeného nabídkového řízení
Platí pravidla Programu – pokud v průběhu doby ekonomické živostnosti zakoupeného
vozidla (zpravidla 30 let) příjemce podpory skončí plnění smlouvy o veřejných službách tímto
vozidlem, bude povinen postupovat jedním ze způsobů uvedených bodě 8 kapitoly 4.4. Z
pohledu splnění podmínek pro poskytování podpory je doporučeno, aby podmínky otevřeného
nabídkového řízení stanovily povinnost smluvního převést vlastnictví vozidel pořízených s
využitím podpory z OPD k okamžiku ukončení smlouvy osobě určené objednatelem
(zpravidla objednateli nebo novému provozovateli dotčených dopravních výkonů).
Pro výběr dopravce po skončení platnosti smlouvy o veřejných službách zadané na základě
otevřeného nabídkového řízení platí pravidla nastavená nařízením (ES) č. 1370/2007.
Varianta B1 – žadatelem o dotaci je objednatel veřejných služeb, k zadání veřejných
služeb dopravci dochází na základě přímého zadání až na dobu 10 let, kdy nebyl
deklarován relevantní zájem jiných dopravců
Platí pravidla Programu - nová vozidla pořízená z dotace musí být provozována výhradně na
dopravních výkonech zajišťovaných v závazku veřejné služby, a to po celou dobu
ekonomické životnosti vozidla (zpravidla 30 let).
Pro výběr dopravce po skončení platnosti smlouvy o veřejných službách zadané přímým
zadáním platí pravidla nastavená nařízením (ES) č. 1370/2007.
Varianta B2 – žadatelem o dotaci je dopravce, k zadání veřejných služeb dopravci
dochází na základě přímého zadání až na dobu 10 let, kdy nebyl deklarován relevantní
zájem jiných dopravců
12
Platí pravidla Programu – pokud v průběhu doby ekonomické živostnosti zakoupeného
vozidla (zpravidla 30 let) příjemce podpory skončí plnění smlouvy o veřejných službách tímto
vozidlem, bude povinen postupovat jedním ze způsobů uvedených na straně 29 Programu. Z
pohledu splnění podmínek pro poskytování podpory je nezbytné, aby smlouva o veřejných
službách, popř. smlouva o smlouvě budoucí vedoucí k jejímu uzavření, obsahovala povinnost
smluvního dopravce závazek dopravce převést vlastnictví vozidel pořízených s využitím
podpory z OPD k okamžiku ukončení smlouvy osobě určené objednatelem (zpravidla
objednateli nebo novému provozovateli dotčených dopravních výkonů).
Pro výběr dopravce po skončení platnosti smlouvy o veřejných službách zadané přímým
zadáním platí pravidla nastavená nařízením (ES) č. 1370/2007.
Varianta C1 – žadatelem o dotaci je objednatel veřejných služeb, k zadání veřejných
služeb dopravci dochází na základě přímého zadání nejvýše do roku 2023
Platí pravidla Programu - nová vozidla pořízená z dotace musí být provozována výhradně na
dopravních výkonech zajišťovaných v závazku veřejné služby, a to po celou dobu
ekonomické životnosti vozidla (zpravidla 30 let).
Pro výběr dopravce po skončení platnosti smlouvy o veřejných službách zadané přímým
zadáním nejvýše do prosince 2023 platí podmínka zadání na základě otevřeného nabídkového
řízení. Tím není dotčeno právo objednatele přijmout mimořádné opatření ve smyslu článku 5
odst. 5 nařízení (ES) č. 1370/2007 v případě přerušení služeb nebo v případě bezprostředního
rizika vzniku takové situace.
V případě, že objednatel nesplní podmínku uvedenou v předchozím odstavci, bude mu ve
shodě se smlouvou o zajištění stabilního financování regionální železniční osobní dopravy
odpovídajícím způsobem krácena pro příslušný kalendářní rok výše spolufinancování ze
státního rozpočtu.
Varianta C2 – žadatelem o dotaci je dopravce, k zadání veřejných služeb dopravci
dochází na základě přímého zadání nejvýše do roku 2023
Platí pravidla Programu – pokud v průběhu doby ekonomické živostnosti zakoupeného
vozidla (zpravidla 30 let) příjemce podpory skončí plnění smlouvy o veřejných službách tímto
vozidlem, bude povinen postupovat jedním ze způsobů uvedených na straně 29 Programu. Z
pohledu splnění podmínek pro poskytování podpory je nezbytné, aby smlouva o veřejných
službách, popř. smlouva o smlouvě budoucí vedoucí k jejímu uzavření, obsahovala povinnost
smluvního dopravce závazek dopravce převést vlastnictví vozidel pořízených s využitím
podpory z OPD k okamžiku ukončení smlouvy osobě určené objednatelem (zpravidla
objednateli nebo novému provozovateli dotčených dopravních výkonů).
Pro výběr dopravce po skončení platnosti smlouvy o veřejných službách zadané přímým
zadáním nejvýše do prosince 2023 platí podmínka zadání na základě otevřeného nabídkového
řízení. Tím není dotčeno právo objednatele přijmout mimořádné opatření ve smyslu článku 5
odst. 5 nařízení (ES) č. 1370/2007 v případě přerušení služeb nebo v případě bezprostředního
rizika vzniku takové situace.
V případě, že objednatel nesplní podmínku uvedenou v předchozím odstavci, bude mu ve
shodě se smlouvou o zajištění stabilního financování regionální železniční osobní dopravy
odpovídajícím způsobem krácena pro příslušný kalendářní rok výše spolufinancování ze
státního rozpočtu.
13
4. Indikátory a udržitelnost výstupů projektu
Průběh Programu a naplňování jeho cílů bude sledováno indikátory platnými pro OPD.
Indikátor, který je v programovém dokumentu OPD stanoven pro Specifický cíl 1.5, je „Počet
nově pořízených nebo modernizovaných vozidel pro drážní dopravu“. Tento indikátor je
dokládán v projektové žádosti a bude sledován po celou dobu udržitelnosti projektu. Pro účely
výzvy č. 28 se za hodnotu indikátoru považuje počet samostatných vozů osobní přepravy,
hnacích vozidel nebo celkový počet dílů jednotek elektrické nebo nezávislé trakce. Vazba
takto vypočteného indikátoru ke konkrétním železničním vozidlům musí být zřejmá z údajů,
uvedených v příloze č. 3 Investiční záměr.
Žadatel je povinen zajistit provoz všech z dotace pořízených vozidel po celou dobu
udržitelnosti projektu. Pokud dojde k závažnému poškození vozidla tak, že toto vozidlo již
nebude možné dále provozovat podle podmínek rozhodnutí o poskytnutí dotace, může
dopravce toto vozidlo nahradit jiným, pokud je náhradní vozidlo nejméně srovnatelného stáří
a splňuje veškeré kvalitativní požadavky stanovené Programem a smlouvou o veřejných
službách. V případě krátkodobější neschopnosti z dotace pořízených vozidel musí příjemce
dotace postupovat v úzké součinnosti s ŘO OPD.
5. Hodnocení žádostí o podporu
Žádosti o podporu jsou hodnoceny v souladu kritérii výběru projektů, která byla schválena
Monitorovacím výborem OPD dne 16. 5. 2017. Tato kritéria jsou zveřejněna jako součást
dokumentace výzvy.
Alokace je v rámci této průběžné výzvy přidělována v pořadí podle data registrace
jednotlivých žádostí o podporu. V případě, že by v průběhu trvání výzvy došlo k situaci, že
předložené žádosti o podporu budou v rámci souhrnné požadované výše podpory překračovat
dostupnou alokaci, budou tyto žádosti o podporu nad alokaci vybírány pouze jako náhradní
projekty do zásobníku projektů. V případě následného uvolnění dostupné alokace reservované
pro dříve předložené projekty mohou být projekty ze zásobníku taktéž podpořeny (vždy v
pořadí podle data registrace žádosti o podporu). ŘO OPD v takovém případě oznámí žadateli
možnost vydání Rozhodnutí o poskytnutí dotace (nejpozději do 31.12.2021). Žadatel muže
projekt vybraný pouze do zásobníku také předložit do případné další výzvy.
Žádosti o podporu, které s kladným výsledkem projdou kontrolou formálních náležitostí,
kontrolou projektové přijatelnosti a následně věcným hodnocením, obdrží Schvalovací
protokol, který bude specifikovat podmínky pro vydání příslušného právního aktu v podobě
Rozhodnutí o poskytnutí dotace. V případě tzv. velkých projektů (s celkovou výší
způsobilých výdajů překračující 75 milionů EUR) bude vydáván pouze Předběžný
schvalovací protokol, přičemž schvalovací proces těchto žádostí bude dále pokračovat na
úrovni JASPERS IQR resp. EK. Podrobný postup je uveden v PPŽaP v kapitole 8.5.
Rozhodnutí o poskytnutí dotace v případě velkých projektů bude vždy vydáno až na základě
Schvalovacího protokolu po rozhodnutí Evropské komise o schválení projektu.
Postup hodnocení a výběru projektů je blíže popsán v PPŽaP (kapitola 8) a v Kritériích
výběru projektů.
14
6. Upřesnění požadovaných příloh žádosti o podporu
Přehled povinných příloh žádosti je závazně specifikován v rámci dokumentu „Upřesnění
požadovaných příloh žádosti o podporu v rámci výzev pro specifický cíl 1.5“, který je
zveřejněn jako součást dokumentace výzvy.
15
Počet přepravených cestujících na lince za období
Počet přepravených cestujících na lince za období od dd.mm.rrrr do dd.mm.rrrr
Dopravce:
Odjezd z Příjezd do Čas odjezdu Pá So Ne Po Út St Čt Pá So Ne Po
Linka Číslo vlaku Výchozí stanice vlaku výchozí Cílová stanice cílové z tarifního Tarifní bod Výstup Obsazenost Obs. % Výstup Obsazenost Obs. % Výstup Obsazenost Obs. % Výstup Obsazenost Obs. % Výstup Obsazenost Obs. % Výstup Obsazenost Obs. %
stanice vlaku vlaku stanice vlaku bodu
Nástup Výstup Obsazenost Obs. % Nástup Výstup Obsazenost Obs. % Nástup Výstup Obsazenost Obs. % Nástup Výstup Obsazenost Obs. % Nástup Výstup Obsazenost Obs. % Nástup Nástup Nástup Nástup Nástup Nástup
Příloha č.10 - Smluvní sankce Znění povinnosti Způsob porušení Výše pokuty Podmínky Opakování ano/ne
Název NE
dokumentu Článek
Smlouva články 3, 4 Dopravce se zavazuje zajistit Veřejné služby v drážní dopravě v souladu se Objednatel je oprávněn požadovat po Dopravci 10.000.000 Kč, a to
Smlouvou a v souladu s platným právním řádem České republiky, zejména ZVS. zaplcení smluvní sankce v případě nezahájení jednorázově
poskytování Veřejných služeb v drážní dopravě v
souladu s čl. 5 odst. 1 nebo 2.
Smlouva články 3, 4 Dopravce se zavazuje zajistit Veřejné služby v drážní dopravě v souladu se Objednatel je oprávněn požadovat po Dopravci 500.000 Kč denně po ANO
Smlouvou a v souladu s platným právním řádem České republiky, zejména ZVS. zaplcení smluvní sankce v případě, že Dopravce dobu přerušení
přeruší poskytování Veřejných služeb v drážní poskytování služeb Pokud Dopravce i
dopravě na dobu delší 24 hodin. maximálně však přes písemnou výzvu
10.000.000 Kč Objednatele nezjedná
nápravu lze pokutu
Smluvní strany potvrzují, že Dopravce před uzavřením této Smlouvy uzavřel rovněž uložit opakovaně.
Smlouva článek 10 odst. 2 Smlouvu o spolupráci při zajišťování provozu a rozvoje Integrovaného dopravního Objednatel je oprávněn požadovat po Dopravci 1.000.000 Kč Pokud Dopravce i
Smlouva systému Moravskoslezského kraje ODIS mezi Dopravcem a Koordinátorem ODIS zaplacení smluvní sankce v případě, že poruší přes písemnou výzvu
Smlouva s.r.o.Smlouvu o dělbě tržeb mezi dopravci v Integrovaném dopravním systému povinnost mít po celou Dobu plnění této Smlouvy Objednatele nezjedná
Smlouva Moravskoslezského kraje podle zákona č. 89/2012 Sb., občanský zákoník je Dopravce uzavřeny smlouvy dle tohoto ustanovení.. nápravu lze pokutu
povinen uzavřít bez zbytečného odkladu po uzavření této Smlouvy. Tyto smlouvy není uložit opakovaně.
Dopravce oprávněn bez souhlasu Objednatele po dobu trvání této Smlouvy ukončit. NE
článek 10 odst. 3 Dopravce je povinen mít po celou dobu plnění této Smlouvy uzavřenou smlouvu 1.000.000 Kč ANO
článek 10 odst. 7 o kompenzaci slev z jízdného ve veřejné osobní dopravě s Ministerstvem dopravy, Objednatel je oprávněn požadovat po Dopravci
článek 10 odst. 7 pokud bude poskytována kompenzace za státem nařízené slevy jízdného. Dopravce je zaplacení smluvní sankce v případě, že poruší 2.000 Kč za každý
povinen učinit veškerá opatření k řádnému a včasnému uzavření smlouvy o povinnost mít po celou Dobu plnění této Smlouvy jednotlivý případ
kompenzaci slev z jízdného ve veřejné osobní dopravě pro příslušné období a uzavřenou smlouvu o kompenzaci z jízdného ve
pravidelně žádat o kompenzaci slevy z jízdného dle uzavřené smlouvy a metodiky veřejné osobní dopravě s Ministerstvem dopravy, 2.000 Kč za každý den
Ministerstva dopravy. Dopravce je povinen uzavření smlouvy a podání jednotlivé pokud bude poskytována kompenzace za státem prodlení
žádosti o kompenzaci objednateli doložit vždy nejpozději do 14 dnů od provedení nařízené slevy jízdného.
úkonu (uzavření smlouvy nebo podání žádosti).
Smluvní strany se pro účely stanovení Skutečné kompenzace a za podmínek blíže
stanovených Smlouvou o spolupráci při zajišťování provozu a rozvoje Integrovaného
dopravního systému Moravskoslezského kraje ODIS mezi Dopravcem a Koordinátorem
ODIS s.r.o. a Smlouvou o dělbě tržeb mezi dopravci v Integrovaném dopravním Objednatel je oprávněn požadovat po Dopravci
systému Moravskoslezského kraje podle zákona č. 89/2012 Sb., občanský zákoník zaplacení smluvní sankce za každý nepravdivý nebo
dohodly, že a) Dopravce je povinen na základě počtu vlkm v příslušném kalendářním neúplný výkaz dopravních výkonů.
měsíci stanoveného objednatelem předložit Koordinátorovi ODIS s.r.o., (dále také
jako „KODIS): i. výkaz dopravních výkonů v příslušném kalendářním měsíci dle článku
14 odst. 6 této Smlouvy.
Smluvní strany se pro účely stanovení Skutečné kompenzace a za podmínek blíže
stanovených Smlouvou o spolupráci při zajišťování provozu a rozvoje Integrovaného
dopravního systému Moravskoslezského kraje ODIS mezi Dopravcem a Koordinátorem
ODIS s.r.o. a Smlouvou o dělbě tržeb mezi dopravci v Integrovaném dopravním Objednatel je oprávněn po Dopravci požadovat
systému Moravskoslezského kraje podle zákona č. 89/2012 Sb., občanský zákoník zaplacení smluvní sankce za každý den prodlení
dohodly, že a) Dopravce je povinen na základě počtu vlkm v příslušném kalendářním s odevzdání výkazu dopravních výkonů.
měsíci stanoveného objednatelem předložit Koordinátorovi ODIS s.r.o., (dále také
jako „KODIS): i. výkaz dopravních výkonů v příslušném kalendářním měsíci dle článku
14 odst. 6 této Smlouvy.
Příloha č.10 - Smluvní sankce
Název Znění povinnosti Způsob porušení Výše pokuty Podmínky Opakování ano/ne
dokumentu Článek
20.000 Kč za každý Sankce bude udělena v V případě, že
V územním obvodu Objednatele je zaveden integrovaný dopravní systém s názvem den, v němž se jednání případě zjištění nebude sjednaná
dopustil neakceptace nebo náprava ani v
Integrovaný dopravní systém ODIS (dále také jako „ODIS“ nebo „IDS“). Vzhledem nevydávání určitého dodatečně
20.000 Kč druhu jízdného dokladu poskytnuté lhůtě
k uvedené skutečnosti bude Dopravce odbavovat cestující dle tarifu ODIS v jeho ODIS. ze strany
50.000 Kč za každý Objednatele nebo
Smlouva článek 11 odst. 1 aktuálně platné a úplné podobě. Objednatel je oprávněn tarif ODIS v průběhu trvání Objednatel je oprávněn požadovat po Dopravci jednotlivý den KODIS.
Smlouvy kdykoliv změnit. O změně stávajícího tarifu ODIS je Objednatel v případě zaplacení smluvní sankce za každý případ, kdy
strukturálních změn tarifu ODIS, tj. v případě změn tarifních zón, zavedení nového Dopravce neodbaví cestujícího dle tarifu ODIS v jeho V případě, že
druhu jízdenky, změn způsobu výpočtu jízdného povinen písemně uvědomit Dopravce aktuálně platné a úplné podobě. nebude sjednaná
nejpozději 90 dní předem. V případě úprav cen jízdného je Objednatel povinen náprava ani v
dodatečně
písemně uvědomit Dopravce nejpozději 30 dní předem. Dopravce je vedle výše poskytnuté lhůtě
ze strany
uvedeného tarifu ODIS povinen akceptovat jízdní doklady Systému jednotného Objednatele nebo
KODIS.
jízdního dokladu (dále jen „SJT“).
ANO
Smlouva článek 11 odst. 2 Dopravce bude v rámci IDS prodávat a akceptovat papírové jízdní doklady nebo Dopravce neakceptuje nebo nevydává jízdní doklad
Smlouva článek 11 odst. 3 elektronické jízdní doklady nahrané v elektronických nosičích, tj. bezkontaktních ODIS.
čipových kartách (dále také jako „BČK“), bezkontaktních platebních kartách (dále také
jako „BPK“) a mobilní aplikaci ODISapka, které jsou kompatibilní s elektronickými
nosiči ve veřejné drážní osobní dopravě v souladu s přílohou č. 7 této Smlouvy.
Kompatibilitou v drážní dopravě se zejména rozumí zajištění dodržování společných
bezpečnostních pravidel pro vzájemnou komunikaci u všech zúčastněných subjektů s
tím, že však nebude ovlivněna nezávislost každého z nich.
Dopravce je povinen provádět odbavování cestujících elektronickým odbavovacím
systémem a vydat doklad o zaplacení (jízdenku), resp. potvrzení o jízdě (při použití
BPK v režimu autocapping). Dopravce předloží KODIS ke schválení vzory jízdenek, Objednatel je oprávněn po Dopravci požadovat
které bude vydávat a uznávat, a to nejméně 15 dní před začátkem Doby plnění, a při zaplacení smluvní sankce v případě, že Dopravce
každé změně nejméně 5 dní před zavedením změny, pokud tím nebude zkrácena poruší povinnost vést řádně evidenci, tj. za každý den
doba na implementaci požadovaných změn odbavovacího systému Dopravce. s chybějící či neúplnou evidencí.
Dopravce je povinen vést přesnou evidenci prodaných jízdních dokladů ve struktuře
jednotlivých druhů těchto dokladů a tuto evidenci uchovávat po celou Dobu plnění a
nejméně 5 let poté.
… Do dat dle tohoto odstavce nemá právo Dopravce jakkoliv později zasahovat či je Objednatel je oprávněn požadovat po Dopravci 500.000 Kč za každé
Smlouva článek 11 odst. 5 dodatečně pozměňovat s výjimkou nutných korekcí např. při stornu apod. Dopravce zaplacení smluvní sankce v případě neoprávněného jednotlivé takové NE
se zavazuje neprovádět manipulaci s údaji o prodejích jízdného. zásahu či manipulace s údaji o prodejích jízdného. porušení
Dopravce je povinen vykázat veškeré Skutečné tržby dle čl. 10 odst. 5, které se
vztahují k předmětu Smlouvy, bez DPH v plné výši Objednateli v souladu s
podmínkami stanovenými ve Smlouvě. Dopravce je povinen Objednateli věrohodně
Smlouva článek 11 odst. 6 doložit jejich výši. V případě, že Dopravce nevykáže Skutečné tržby dle čl. 10 odst. 5 Objednatel je oprávněn požadovat po Dopravci desetinásobek NE
této Smlouvy ve stanoveném termínu, anebo jim poskytnutý výkaz těchto tržeb bude zaplacení smluvní sankce v případě jakéhokoliv nevykázané částky, za
nesprávný či neúplný, není Objednatel povinen hradit Skutečnou kompenzaci dle porušení dle tohoto odstavce Smlouvy. každý jednotlivý případ
čl. 10 odst. 6 této Smlouvy. Objednatel je oprávněn kontrolovat správnost a úplnost
vykázaných předmětných tržeb kdykoliv v průběhu Doby plnění, úhrada Skutečné
kompenzace neznamená potvrzení správnosti či úplnosti vykázaných Tržeb ze strany
Objednatele.
Dopravce se zavazuje, že bez vědomí KODIS nebude v jízdním řádu provádět žádné Objednatel je oprávněn po Dopravci požadovat Nevztahuje se na
operativní změny
změny týkající se časové polohy vlaků (vyjma nezbytných časových posunů zaplacení smluvní sankce za provedení změny, která by 5.000 Kč za každou související s řešením
takto provedenou mimořádností v provozu
Smlouva článek 13 odst. 3 z dopravních a technologických důvodů určených provozovatelem dráhy), četností v průběhu jízdního řádu změnila provoz na touto změnu, jednorázově nebo jiné obdobné NE
provozní situace,
vedení vlaků či zastavování vlaků. Dopravce je oprávněn navrhnout KODIS změnu Smlouvou dotčených vlacích a tratích bez předchozího
vymezení vlakových spojů. projednání a odsouhlasení Objednatelem.
Smlouva článek 13 odst. 4 Pro vlaky dle projednaného návrhu jízdního řádu (dále také jako „Návrh“) je Objednatel je oprávněn požadovat po Dopravci 1.000 Kč za každý NE
Dopravce povinen pro každé období platnosti jízdního řádu v rámci Doby plnění zaplacení smluvní sankce v případě chybně zadaného jednotlivý případ
Smlouvy podat v termínu podle § 34a odst. 1 Zákona o drahách u odpovídajícího vlaku v jízdním řádu, nikoli odjetého. (chybně zadaný spoj)
přídělce kapacity dopravní cesty žádost o přidělení kapacity dopravní cesty. porušení povinnnosti
Příloha č.10 - Smluvní sankce Znění povinnosti Způsob porušení Výše pokuty Podmínky Opakování ano/ne
Název
dokumentu Článek NE
Smlouva článek 13 odst. 4 Bude-li Dopravce informován, že kapacitu dopravní cesty nebude možné přidělit či že Objednatel je oprávněn požadovat po Dopravci 50.000 Kč za každý NE
není možné vyhovět všem uplatněným požadavkům dle čl. 17 odst. 4 písm. a) zaplacení smluvní sankce v případě porušení jakékoli jednotllivý případ
Smlouvy a v souladu s žádostí podanou podle odstavce 1 tohoto článku, zahájí v tomto odstavci uvedené povinnosti. porušení povinností V případě, že
Dopravce jednání s přídělcem kapacity dopravní cesty ve smyslu §34e odst. 3 Zákona nebude sjednaná
o dráhách. O tomto postupu musí Dopravce bezodkladně informovat KODIS, náprava ani v
nejpozději však následující pracovní den poté, co tuto informaci obdržel, a předat dodatečně
KODIS veškeré související podklady. Dopravce je dále povinen prokazatelně poskytnuté lhůtě
navrhnout provozovateli dráhy, aby se KODIS účastnil příslušných jednání s ze strany
provozovatelem dráhy v této věci. Objednatele nebo
KODIS.
Smlouva článek 13 odst. 7 Dopravce smí provádět krátkodobé změny jízdních řádů (tzv. výluky) nebo Objednatel je oprávněn požadovat po Dopravci 5.000 Kč za každý
dlouhodobé změny jízdních řádů (např. formou výlukového jízdního řádu) jen zaplacení smluvní sankce v případě, že provede změny jednotlivý případ
s předchozím souhlasem KODIS. Smluvní strany a KODIS mohou projednat, že po jízdních řádů bez předchozího souhlasu KODIS. porušení povinnosti
přechodnou dobu bude Dopravce v odůvodněných případech zproštěn některých
povinností dle této Smlouvy.
Smlouva článek 13 odst. 10 Dopravce je povinen Objednatele písemně informovat o rozsahu přidělené kapacity Objednatel je oprávněn požadovat po Dopravci 5.000 Kč za každý
dopravní cesty na následující Dopravní rok do konce října kalendářního roku, v němž zaplacení smluvní pokuty v případě, že Dopravce jednotlivý případ
je o přidělení rozhodnuto. Objednatele neinformuje o rozsahu přidělené kapacity porušení povinnosti
v souladu s tímto ustanovením Smlouvy.
Výkon ujetý záložní soupravou ODIS 5 V případě, že dojde k Nasazení vozidla je Za každý
nasazení vozidla přičitatelné Dopravci. jednotlivý vlkm
standardu ODIS 5, je (zaokrouhleno na
Dopravci krácena desetiny vlkm).
kompenzace o 5 % z
objednávkové ceny za
vlkm
Smlouva článek 14 odst. 1 Dopravce je povinen zajišťovat Dopravní výkony v souladu s podmínkami stanovenými V případě, že dojde k Za každý
v této Smlouvě a jejích přílohách zejména pak příloze č. 7 Technické a provozní nasazení vozidla jednotlivý vlkm
standardy ODIS včetně jejích příloh (dále jen „TPS ODIS"). Základní technické Výkon ujetý záložní soupravou ODIS 6 standardu ODIS 6, je Nasazení vozidla je (zaokrouhleno na
parametry vozidel jsou stanoveny kapitolou č. 1 TPS ODIS, ve které jsou upraveny dopravci krácena přičitatelné Dopravci. desetiny vlkm).
standardy vozidel ODIS 4, 5, 6. Postup nasazení jednotlivých vozidel dle jejich kompenzace o 15 % z
parametrů je upraven TPS ODIS. objednávkové ceny za
vlkm
Smlouva článek 14 odst. 1 Dopravce je povinen zajišťovat Dopravní výkony v souladu s podmínkami stanovenými
Příloha č.10 - Smluvní sankce v této Smlouvě a jejích přílohách zejména pak příloze č. 7 Technické a provozní
standardy ODIS včetně jejích příloh (dále jen „TPS ODIS"). Základní technické
parametry vozidel jsou stanoveny kapitolou č. 1 TPS ODIS, ve které jsou upraveny
standardy vozidel ODIS 4, 5, 6. Postup nasazení jednotlivých vozidel dle jejich
parametrů je upraven TPS ODIS.
Název Znění povinnosti Způsob porušení Výše pokuty Podmínky Opakování ano/ne
dokumentu Článek 50 Kč za vlkm
Nasazení NAD. V případě, že dojde k Za každý
nasazení NAD, které je jednotlivý vlkm
přičitatelné Dopravci (zaokrouhleno na
desetiny vlkm).
Neodjetý výkon. Za každý Za každý
neuskutečněný jednotlivý vlkm
zaviněný vlkm 100 Kč (zaokrouhleno na
desetiny vlkm).
Smlouva článek 14 odst. 4 Dopravce zajistí přesnost a spolehlivost poskytovaných dopravních služeb, tzn., že Zpoždění vlaku v intervalu 16-20 minut přičitatelné 1 000 Kč Zpoždění je přičitatelné Za každý
vlaky, které jsou předmětem Smlouvy, budou vedeny včas dle platného jízdního Dopravci 1 500 Kč Dopravci. jednotlivý vlak.
řádu. Za vlak jedoucí včas se považuje vlak, jehož zpoždění z příčin na straně 2 000 Kč Za každý
Dopravce ve výchozí nebo konečné stanici nepřevýší 15 minut. Zpoždění vlaku v intervalu 21-30 minut přičitatelné 2 500 Kč Zpoždění je přičitatelné jednotlivý vlak.
Dopravci Dopravci. Za každý
Zpoždění vlaku v intervalu 31-45 minut přičitatelné 2.000 Kč za každý Zpoždění je přičitatelné jednotlivý vlak.
Dopravci jednotlivý případ Dopravci. Za každý
Zpoždění vlaku v intervalu 46 a více minut Zpoždění je přičitatelné jednotlivý vlak.
přičitatelné Dopravci 2.000 Kč za každý den Dopravci.
prodlení NE
Smlouva článek 14 odst. 6 Dopravce se zavazuje elektronicky poskytovat Objednateli a KODIS úplný měsíční Dopravce je povinen zaplatit Objednateli smluvní
Smlouva článek 14 odst. 6 přehled neuskutečněných dopravních výkonů s rozdělením dle zavinění a úplný pokutu za každý nepravdivý nebo neúplný výkaz. ANO
přehled o zpoždění vlaků zaviněných Dopravcem s rozdělením dle zavinění vždy do
15. kalendářního dne následujícího měsíce po vykazovaném měsíci ve struktuře dle Dopravce je povinen zaplatit Objednateli smluvní
přílohy č. 11 Smlouvy. Měsíční výkazy související s přesností musí být vyplněny řádně pokutu za každý kalendářní den prodlení s
a pravdivě a jejich zaslaná podoba musí být podepsána oprávněnou osobou jednat za termínem odevzdání.
Dopravce.
Dopravce se zavazuje elektronicky poskytovat Objednateli a KODIS úplný měsíční
přehled neuskutečněných dopravních výkonů s rozdělením dle zavinění a úplný
přehled o zpoždění vlaků zaviněných Dopravcem s rozdělením dle zavinění vždy do
15. kalendářního dne následujícího měsíce po vykazovaném měsíci ve struktuře dle
přílohy č. 11 Smlouvy. Měsíční výkazy související s přesností musí být vyplněny řádně
a pravdivě a jejich zaslaná podoba musí být podepsána oprávněnou osobou jednat za
Dopravce.
Dopravce je povinen zajistit, aby byl jeho personál proškolen pro jednání v krizových
Smlouva článek 14 odst. 8 situacích, dodržoval ve vztahu k cestujícím normy slušného chování, ovládal plynně Objednatel je oprávněn požadovat po Dopravci 1.000 Kč za každý NE
český jazyk (případně rozuměl česky a ovládal plynně slovenský jazyk), a aby byl zaplacení smluvní sankce v případě, že nezajistí, aby jednotlivý případ
schopen poskytovat v českém nebo slovenském jazyce správné informace o jízdních jeho personál vyhovoval stanoveným požadavkům či porušení povinnosti
řádech, a dále informoval o tarifu a přepravních podmínkách ODIS. KODIS poskytne jeho personál jednal v rozporu se stanovenými
Dopravci součinnost v oblasti proškolování personálu ve věci přepravních a tarifních požadavky, a to s ohledem na připomínku cestujícího
podmínek ODIS a návazností veřejné dopravy v Moravskoslezském kraji. Personál zaslanou KODIS nebo Objednatele či bude takové
Dopravce je povinen nabídnout, a v případě zájmu cestujícího poskytnout, pomoc porušení povinnosti detekováno během kontrolní
s nástupem, výstupem a pohybem osob přepravujících dětský kočárek s dítětem či činnosti.
osob s omezenou schopností pohybu a orientace ve vozidel, zejména obsloužit
cestující s invalidním vozíkem plošinou pro nástup, resp. výstup.
Příloha č.10 - Smluvní sankce
Název Článek Znění povinnosti Způsob porušení Výše pokuty Podmínky Opakování ano/ne
dokumentu článek 14 odst. 11 NE
Za účelem kontroly plnění povinností Dopravce vyplývajících z této Smlouvy se 50.000 Kč za každý
Smlouva jednotlivý případ
Dopravce zavazuje umožnit zaměstnancům Objednatele nebo KODIS kontrolní činnost porušení
ve vlacích, stanicích, zastávkách a prodejních místech a zabezpečit součinnost svých
zaměstnanců při výkonu této kontroly. Požadovaná součinnost nesmí být v rozporu s
pravidly pro bezpečné provozování dráhy a drážní dopravy. O formě a způsobu
provádění kontroly rozhoduje v každém jednotlivém případě Objednatel a KODIS.
Objednatel nebo KODIS při provádění kontroly dbá na to, aby její výkon nezpůsobil Objednatel je oprávněn požadovat po Dopravci
zpoždění vlaku a nebránil plnění pracovních povinností zaměstnanců Dopravce před zaplacení smluvní pokuty v případě, že Dopravce
odjezdem vlaku z výchozí stanice, během jeho jízdy ani po příjezdu vlaku do cílové neumožní zaměstnancům Objednatele nebo KODIS
stanice. Při kontrole stanic, zastávek a prodejních míst Objednatel nebo KODIS dbá provádět kontrolní činnost, neposkytne součinnost či ji
na to, aby její výkon významně neomezoval provoz prodejního místa. Pokud neposkytne stanoveným způsobem.
poskytování součinnosti ze strany Dopravce vyžádané Objednatelem nebo KODIS
způsobí zpoždění vlaku nebo porušení jiných povinností Dopravce
dle
Dopravce je povinen umožnit Objednateli či KODIS na vyžádání provést kontrolu
veškerých dat potřebných pro posouzení správnosti údajů vykazovaných Dopravcem
Smlouva článek 15 odst. 1 dle ustanovení této Smlouvy. Dopravce je rovněž povinen kdykoliv Objednateli či Objednatel je oprávněn po Dopravci požadovat 50.000 Kč za každý NE
KODIS umožnit kontrolu plnění jakýchkoliv povinností Dopravce dle této Smlouvy. Při zaplacení smluvní sankce v případě, že Dopravce jednotlivý případ
kontrolách je Dopravce povinen poskytnout Objednateli či KODIS veškerou rozumně neumožní Objednateli či KODIS provést kontrolu dat porušení NE
požadovanou součinnost, zejména poskytnout vyžádané dokumenty relevantní pro nebo plnění povinností dle tohoto ustanovení Smlouvy. ANO
plnění této Smlouvy a zajistit přítomnost odpovědných zaměstnanců. KODIS či NE
Objednatel je povinen provádět kontroly způsobem, který nebude nad přiměřenou
míru zatěžovat běžný provoz Dopravce.
článek 15 odst. 2 Dopravce předloží KODIS zpracované oběhy všech vozidel vždy k zahájení platnosti Objednatel je oprávněn požadovat po Dopravci 2.000 Kč za každý
GVD a při každé změně oběhů vozidel, vč. oběhů výlukových. V rámci oběhů zaplacení smluvní sankce za každý chybně nebo jednotlivý případ
Dopravce všechny spoje garantuje jako nízkopodlažní a tyto spoje budou zálohovány neúplně zpracovaný oběh vozidel.
alespoň částečně nízkopodlažními vozidly. Dopravce je povinen tyto garantované
nízkopodlažní spoje vyznačit v jízdních řádech mezinárodním symbolem přístupnosti a
spolu s jízdními řády zveřejnit.
článek 15 odst. 2 Dopravce předloží KODIS zpracované oběhy všech vozidel vždy k zahájení platnosti Objednatel je oprávněn po Dopravci požadovat 2.000 Kč za každý den
GVD a při každé změně oběhů vozidel, vč. oběhů výlukových. V rámci oběhů zaplacení smluvní sankce za každý den prodlení prodlení
Dopravce všechny spoje garantuje jako nízkopodlažní a tyto spoje budou zálohovány předložení zpracovaných oběhů vozidel.
alespoň částečně nízkopodlažními vozidly. Dopravce je povinen tyto garantované 200.000 Kč za každý
nízkopodlažní spoje vyznačit v jízdních řádech mezinárodním symbolem přístupnosti a jednotlivý případ
spolu s jízdními řády zveřejnit. porušení (příslušná
sčítací kampaň)
Dopravce se zavazuje provádět ve všech vlacích, které jsou předmětem Smlouvy,
článek 15 odst. 4 průzkumy frekvence cestujících. Průzkum se uskuteční minimálně 4x (čtyřikrát) Objednatel je oprávněn požadovat po Dopravci
v příslušném kalendářním roce a jeho realizace bude trvat vždy alespoň interval 10 zaplacení smluvní pokuty v případě, že Dopravce
(deset) po sobě jdoucích dnů. KODIS Dopravci stanoví datum zahájení realizace neuskuteční průzkum frekvence v souladu s tímto
průzkumu. Dopravce poskytne KODIS data získaná z průzkumu frekvence cestujících ustanovením Smlouvy či vůbec nezašle data získaná z
nejpozději do 30 (třiceti) dnů od posledního dne realizace průzkumu. Dopravce průzkumu frekvence (neuskuteční průzkum vůbec, ve
poskytne KODIS sestavu dat v elektronické podobě podle jednotlivých tratí, a dále stanoveném počtu opakování za rok, po stanovený
podle jednotlivých vlaků s údaji o nástupech, výstupech a obsazenosti vlaků interval dní)
cestujícími ve všech zastávkách a stanicích po všechny dny realizace v průzkumu ve
formátu dle přílohy č. 9 této Smlouvy.
Příloha č.10 - Smluvní sankce
Název Znění povinnosti Způsob porušení Výše pokuty Podmínky Opakování ano/ne
dokumentu Článek NE
ANO
Smlouva článek 15 odst. 4 Dopravce se zavazuje provádět ve všech vlacích, které jsou předmětem Smlouvy, 2.000 Kč za každý NE
průzkumy frekvence cestujících. Průzkum se uskuteční minimálně 4x (čtyřikrát) jednotlivý případ
v příslušném kalendářním roce a jeho realizace bude trvat vždy alespoň interval 10 po porušení
sobě jdoucích dnů. KODIS Dopravci stanoví datum zahájení realizace průzkumu. Objednatel je oprávněn požadovat po Dopravci
Dopravce poskytne KODIS data získaná z průzkumu frekvence cestujících nejpozději zaplacení smluvní pokuty v případě, že Dopravce zašle
do 30 (třiceti) dnů od posledního dne realizace průzkumu. Dopravce poskytne KODIS KODIS data získaná z průzkumu frekvence cestujících
sestavu dat v elektronické podobě podle jednotlivých tratí, a dále podle jednotlivých neúplná nebo chybná.
vlaků s údaji o nástupech, výstupech a obsazenosti vlaků cestujícími ve všech
zastávkách a stanicích po všechny dny realizace v průzkumu ve formátu dle přílohy
č. 9 této Smlouvy.
Dopravce se zavazuje provádět ve všech vlacích, které jsou předmětem Smlouvy,
průzkumy frekvence cestujících. Průzkum se uskuteční minimálně 4x (čtyřikrát)
v příslušném kalendářním roce a jeho realizace bude trvat vždy alespoň interval 10 po
Smlouva článek 15 odst. 4 sobě jdoucích dnů. KODIS Dopravci stanoví datum zahájení realizace průzkumu. Objednatel je oprávněn požadovat po Dopravci 2.000 Kč za každý den
Dopravce poskytne KODIS data získaná z průzkumu frekvence cestujících nejpozději zaplacení smluvní pokuty za každý den prodlení se prodlení
do 30 (třiceti) dnů od posledního dne realizace průzkumu. Dopravce poskytne KODIS zasláním dat získaných z průzkumu cestujících.
sestavu dat v elektronické podobě podle jednotlivých tratí, a dále podle jednotlivých
vlaků s údaji o nástupech, výstupech a obsazenosti vlaků cestujícími ve všech
zastávkách a stanicích po všechny dny realizace v průzkumu ve formátu dle přílohy
č. 9 této Smlouvy.
Smlouva článek 15 odst. 5 Dopravce se zavazuje předávat KODIS podklady jím vyžádané pro vyřizování Objednatel je oprávněn požadovat po Dopravci 2.000 Kč za každý
připomínek k jízdním řádům, včetně podkladů týkajících se technologie železniční zaplacení smluvní sankce v případě, že Dopravce jednotlivý případ
dopravy, a to vždy nejpozději do 10 (deseti) pracovních dnů od doručení požadavku poskytne požadované podklady KODIS co do obsahu porušení povinnosti
KODIS, resp. nejpozději do 3 (tří) pracovních dnů po obdržení vyjádření neúplné nebo chybné.
provozovatele dráhy, je-li toto vyjádření pro poskytnutí podkladů nezbytné.
Smlouva článek 15 odst. 5 Dopravce se zavazuje předávat KODIS podklady jím vyžádané pro vyřizování 2.000 Kč za každý den ANO
připomínek k jízdním řádům, včetně podkladů týkajících se technologie železniční Objednatel je oprávněn požadovat po Dopravci prodlení
dopravy, a to vždy nejpozději do 10 (deseti) pracovních dnů od doručení požadavku zaplacení smluvní sankce za každý den prodlení Pokud Dopravce i
KODIS, resp. nejpozději do 3 (tří) pracovních dnů po obdržení vyjádření s poskytnutím podkladů. přes písemnou výzvu
provozovatele dráhy, je-li toto vyjádření pro poskytnutí podkladů nezbytné. Objednatele nezjedná
nápravu lze pokutu
Smlouva článek 15 odst. 7 Smluvní strany potvrzují, že Dopravce před uzavřením této Smlouvy uzavřel rovněž 1.000.000 Kč uložit opakovaně.
Smlouvu o spolupráci při poskytování služeb zprostředkování karetních transakcí.
Následující smlouvy: a) Smlouvu o poskytnut SAM modulů; b) Smlouvu o finančním Objednatel je oprávněn požadovat po Dopravci
vyrovnání elektronické peněženky karty ODISka v Integrovaném dopravním systému zaplacení smluvní sankce v případě, že poruší
Moravskoslezského kraje podle zákona č. 89/2012 Sb.; c) Komisionářskou smlouvu o povinnost mít po celou Dobu plnění této Smlouvy
obchodní spolupráci; je Dopravce povinen uzavřít nejpozději do 1 měsíce po podpisu uzavřené vyjmenované smlouvy.
této Smlouvy. Smlouvy vyjmenované v tomto odstavci není Dopravce oprávněn bez
souhlasu Objednatele po dobu trvání této Smlouvy ukončit.
Příloha č.10 - Smluvní sankce Znění povinnosti Způsob porušení Výše pokuty Podmínky Opakování ano/ne
Název
dokumentu Článek Pokud Dopravce i
přes písemnou výzvu
Smlouva článek 15 odst. 10 Dopravce je povinen zajistit údržbu Vlakových jednotek dle řádného a výrobcem Objednatel je oprávněn požadovat po Dopravci 5.000 Kč za každý KODIS nezjedná
předepsaného plánu údržby. Dopravce je povinen evidovat a na vyzvání KODIS zaplacení smluvní pokuty v případě, že Dopravce jednotlivý případ nápravu, lze pokutu
předložit relevantní dokumenty údržbových zásahů na všech Vlakových jednotkách. nepředloží na výzvu KODIS relevantní dokumenty uložit opakovaně.
údržbových zásahů na všech Vlakových jednotkách.
Smlouva článek 15 odst. 11 Dopravce se zavazuje po Dobu plnění jednou za Dopravní rok uspořádat exkurzi Objednatel je oprávněn požadovat po Dopravci 5.000 Kč za každý NE
Vlakových jednotek určenou žákům základních a středních škol. Taková exkurze zaplacení smluvní pokuty v případě, že Dopravce jednotliý případ
či obdobná aktivita bude přístupná minimálně 4 skupinám po 10 osobách včetně neprokáže, že splnil povinnost dle tohoto ustanovení
pedagogického doprovodu. Obsah a průběh exkurze či obdobné aktivity nejsou Smlouvy.
definovány. Dopravce v každém Dopravním roce prokáže, že tuto povinnost splnil.
Dopravce je povinen zajistit nejpozději v termínu 90 dnů před zahájením provozu dle Objednatel je oprávněn po Dopravci požadovat
Smlouva článek 16 odst. 4 Smlouvy, případně v jiném termínu stanoveném Objednatelem, úspěšné provedení zaplacení smluvní sankce v případě, že nezajistí 10.000 Kč za každý den ANO
prodlení
Testovacího provozu na funkčnost odbavovacího systému za podmínek provedení úspěšně ukončeného Testovacího provozu ANO
specifikovaných v příloze TPS ODIS a její příloze č. 13. ve stanoveném termínu. Pokud Dopravce i
přes písemnou výzvu
Smlouva článek 16 odst. 8 Dojde-li k takovému poškození Vlakové jednotky, které objektivně bude znemožňovat 10.000 Kč za každý den Objednatele nezjedná
další provoz v rámci Veřejných služeb v drážní dopravě, je Dopravce povinen tuto Objednatel je oprávněn po Dopravci požadovat takového porušení nápravu lze pokutu
Vlakovou jednotku neprodleně, nejdéle však do devíti měsíců, nahradit Vlakovou zaplacení smluvní sankce v případě, že Dopravce uložit opakovaně.
jednotkou nejvýše srovnatelného stáří, jako byla vlaková jednotka poškozená, nasadí vozidlo, které nesplňuje jakékoliv (byť jediné) z
splňující všechny požadavky Smlouvy a Programu. V souvislosti s poškozením Vlakové kritérií uvedených v tomto článku, po uplynutí uvedené
jednotky a jejím nahrazením jinou Vlakovou jednotkou není Dopravce oprávněn lhůty.
požadovat navýšení Ceny.
Dopravce při převodu jednotek současně předá nabyvateli dokumenty vyjmenované Objednatel je oprávněn po Dopravci požadovat
pod písm. a) až g). Uvedené dokumenty je Dopravce povinen Objednateli nejpozději zaplacení smluvní sankce v případě, že Dopravce 500.000 Kč za každé
jednotlivý případ
Smlouva článek 16 odst. 9 do 3 měsíců od nabytí účinnosti této Smlouvy poskytnout. Dopravce současně souhlasí nepředá nabyvateli dokumenty při převodu či je
s tím, že tyto dokumenty budou zpřístupněny zájemcům o zakázku v novém nepředá Objednateli nejpozději do 3 měsíců od nabytí
nabídkovém řízení, nebudou-li chráněny obchodním tajemstvím Dopravce. účinnosti Smlouvy.
Příloha č.10 - Smluvní sankce Znění povinnosti Způsob porušení Výše pokuty Podmínky Opakování ano/ne
Název
dokumentu Článek Pokud Dopravce i
přes písemnou výzvu
Smlouva článek 16 odst. 10 Dopravce je v průběhu nového nabídkového řízení povinen umožnit zájemcům 500.000 Kč za každý Objednatele nezjedná
o zakázku po splnění veškerých podmínek řízení prohlídku Vlakových jednotek, včetně jednotlivý případ nápravu lze pokutu
veškeré aktualizované dokumentace vedené k provozu, údržbě a opravám Vlakových porušení povinnosti uložit opakovaně.
jednotek dle směrnice Evropského parlamentu a Rady (EU) 2016/796 ze dne 11. Objednatel je oprávněn po Dopravci požadovat
května 2016 o Agentuře Evropské unie pro železnice a o zrušení nařízení (ES) č. zaplacení smluvní pokuty v případě, že poruší jakoukoli NE
881/2004, a to v termínu stanoveném Objednatelem a kontrolu servisní dokumentace povinnost dle tohoto ustanovení Smlouvy.
a plánů údržby a servisu. Vzhledem k rozsahu takové dokumentace zájemcům taktéž
umožní pořídit si opis či kopii dokumentace. Objednatel je oprávněn stanovit prohlídku
jako součást zadávacích podmínek při výběru nového dopravce.
Dopravce je povinen zachovávat mlčenlivost o veškerých skutečnostech,
Smlouva článek 17 odst. 1 které se od Objednatele nebo KODIS dozvěděl nebo v budoucnu dozví v souvislosti Objednatel je oprávněn po Dopravci požadovat 50.000 Kč za každý
s touto Smlouvou. Toto ustanovení neplatí, pokud je Dopravce povinen informace o zaplacení smluvní pokuty v případě, že poruší jednotlivý případ
těchto skutečnostech sdělit na základě obecně závazných právních předpisů. Dále mlčenlivosti dle tohoto ustanovení Smlouvy. porušení
Dopravce společně s Objednatelem vytváří pozitivní povědomí veřejnosti o veřejné
dopravě v Moravskoslezském kraji a je loajální vůči Objednateli.
Smlouva článek 17 odst. 2 S ohledem na požadavky novely Nařízení se Dopravce zavazuje poskytnout Dopravce neposkytne informace nezbytné pro 500.000 Kč za každé Pokud Dopravce i
příslušnému orgánu a Objednateli veškeré informace nezbytné pro uzavření smlouvy uzavření smlouvy o veřejných službách v přepravě jednotlivé takové přes písemnou výzvu
o veřejných službách v přepravě cestujících za účelem jejich poskytnutí dalším cestujících za účelem poskytnutí dalším zájemcům porušení Objednatele nezjedná
zájemcům pro přípravu jejich nabídky, zejména je povinen poskytnout údaje o pro přípravu jejich nabídky dle tohoto ustanovení nápravu lze pokutu
poptávce cestujících, jízdném, nákladech a příjmech souvisejících s veřejnou uložit opakovaně.
přepravou cestujících, která je předmětem případného nabídkového řízení, a
podrobnosti o specifikacích infrastruktury, jež jsou důležité pro provoz požadovaných NE
vozidel nebo kolejových vozidel.
Smlouva čl. 17 odst. 4 Dopravce musí nejpozději ke dni zahájení a posléze po celou Dobu plnění Veřejných Objednatel je oprávněn požadovat po Dopravci 5.000.000 Kč,
služeb v drážní dopravě splňovat níže uvedené požadavky dle ustanovení § 8 odst. 3 zaplacení smluvní sankce v případě, že Dopravce jednorázově
ZVS a naplnění těchto požadavků prokázat předložením příslušných dokladů. poruší povinnosti dle tohoto ustanovení.
Dopravce je povinen: a) mít přidělenou kapacitu dopravní cesty, osvědčení dopravce
a uzavřenou smlouvu o provozování drážní dopravy s provozovatelem dráhy; b) mít
zajištěna vozidla, personál a technické zázemí nezbytné pro provozování veřejných
služeb v přepravě cestujících podle přidělené kapacity dopravní cesty; c) být způsobilý
zajistit poskytování souhrnu činností uložených zákonem o dráhách; a d) splňovat
standardy kvality a bezpečnosti dopravy, včetně standardů pro přepravu osob s
omezenou schopností pohybu a orientace.
1 VŘ 323 05.04.2022
Výkaz dopravních výkonů - Příloha č. 11 smlouvy č. XXXX
Výchozí dopravní výkon Objednaný dopravní výkon Odchylky skutečnosti proti objednávce - rozsah objednávky Rozdělení skutečného dopravního výkonu dle způsobu jeho zajištění Záměny jednotky a soupravy
jednotek
JŘ 2023/2024 - Neuskutečněný nezaviněný Skutečný
PLNĚNÍ dopravní výkon [vlkm] dopravní výkon
10.12.2023 - 31.12.2023 Výchozí dopravní Objednaný Neuskutečněný [vlkm] Výkon ujetý Výkon ujetý NAD -
leden 2024 výkon souprav dopravní výkon nezaviněný soupravou
únor 2024 Výchozí dopravní dvou jednotek Výchozí dopravní Objednaný souprav dvou Objednaný Přidaný dopravní Zrušený Neuskutečněný Neuskutečněný Výkon ujetý jednotek ODIS 4 Výkon ujetý Výkon ujetý výluky, Výkon ujetý NAD - Kontrolní součet Záměna jednotky Záměna soupravy
březen 2024 výkon jednotek [vlkm] výkon celkem dopravní výkon jednotek [vlkm] dopravní výkon výkon jednotek (odobjednaný) dopravní výkon dopravní výkon v zaviněný dopravní jednotkou ODIS 4 [vlkm] za soupravu dvou jednotek za
duben 2024 [vlkm] jednotek [vlkm] celkem [vlkm] dopravní výkon vlivem pandemii [vlkm] výkon [vlkm] [vlkm] záložní soupravou záložní soupravou mimořádnosti mimořádnosti jednotek [vlkm] jednotku [vlkm]
květen 2024 [vlkm] 0,0 [vlkm] jednotek [vlkm] [vlkm]
červen 2024 0,0 mimořádností ODIS 5 [vlkm] ODIS 6 [vlkm] nezaviněné zaviněné [vlkm]
červenec 2024 0,0 0,0 [vlkm]
srpen 2024 0,0 [vlkm]
září 2024 0,0
říjen 2024 0,0 0,0 0,0 0,0
listopad 2024 0,0 0,0 0,0 0,0
do 7.12.2024 0,0 0,0 0,0 0,0
8.12.2024 - 31.12.2024 0,0 0,0 0,0 0,0
Dopravní rok 2023/2024 0,0 0,0 0,0 0,0
0,0 0,0 0,0 0,0
Kalendářní rok 2023 0,0 0,0 0,0 0,0
0,0 0,0 0,0 0,0
Kalendářní rok 2024 0,0 0,0 0,0 0,0
0,0 0,0 0,0 0,0
0,0 0,0 0,0
0,0 0,0 0,0 0,0
0,0 0,0 0,0
0,0 0,0 0,0
0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0
0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0
0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0 0,0