Textová podoba smlouvy Smlouva č. 18205759: Smlouva o veřejných službách v přepravě cestujících - oblast č. 4

                        PŘÍLOHA Č. 4 SMLOUVY

    POPIS JEDNOTNÉHO DATOVÉHO FORMÁTU PRO VÝSTUPY
                 Z ODBAVOVACÍCH ZAŘÍZENÍ - VERZE 1.0

        Ministerstvo dopravy ČR stanovuje formát a strukturu dat pro elektronické zpracování
výstupů z odbavovacích zařízení ve veřejné linkové dopravě.

        Jednotný datový formát – verze 1.0 je závazný pro dopravce v silniční i železniční
dopravě při zpracování podkladů pro kompenzaci státem nařízených slev za období od
1. ledna 2010.

Formát dat:

CSV (comma separated values) – záznamově orientovaný formát dat s oddělovači (pole
oddělena čárkou, záznamy odděleny středníkem a CRLF). Všechny údaje jsou uvedeny
v textovém tvaru (textová pole uzavřená ve znacích uvozovky nahoře). Uvozovky uvnitř textu
není třeba zdvojovat.

Soubory mohou být bez přípony nebo mít příponu TXT nebo CSV.

Povolené kódování dat: CP1250 (Windows)

Nahrávané soubory:  popis souboru                                      stav
                    Verze exportu                                      povinný
název souboru                                                          povinný
Verze               Dopravci                                           povinný
Dopravci
Jizdenky            Jízdenky

                    DATOVÝ POPIS SOUBORŮ

1) Verze

Soubor nese informaci o použité verzi jednotného formátu pro výstupy.

název pole          charakter a popis pole                             hodnota / typ v DB
Číslo verze         - povinný text                                     1.0
Datum exportu                                                          Smalldatetime
Jméno               - povinné datum (DDMMRR)                           Varchar(20)

                    - nepovinný text

2) Dopravci

Soubor obsahuje identifikace subjektů (dopravců), za které je výstup dodáván. Název

dopravce, název provozovny a IČ musí odpovídat údajům uvedeným v Celostátním registru

dopravců, který je součástí Celostátního informačního systému o jízdních řádech (CIS JŘ).

název pole          charakter a popis pole                             typ v DB

IDDopravce          - povinné číslo                                    Nepřenáší se

IČ                  - povinné osmimístné číslo                         Varchar(8)

Název dopravce - povinný text                                          Varchar(255)

Provozovna          - nepovinný text                                   Varchar(255)

Celý dopravce       - povinná hodnota z množiny {0,1}                  Bit

Období exportu od - povinné datum (DDMMRR)                             Smalldatetime

Období exportu do - povinné datum (DDMMRR)                             Smalldatetime

Typ záznamu         - povinné číslo dle číselníku typů záznamů Tinyint

                                         1
Pole Celý dopravce určuje, zda data nesou informace za všechny provozovny daného
dopravce (hodnota 1), anebo jen za konkrétní provozovnu (hodnota 0).

Typicky bude soubor obsahovat jeden řádek. Pouze v případě, že bude dodáván export, který
bude rozdělen např. po provozovnách, bude za každou provozovnu jeden řádek s různým ID,
které bude použito v souboru Jizdenky pro určení příslušnosti jednotlivých záznamů
k provozovnám.

Pokud bude nutné při exportech použít více typů záznamů v souboru Jizdenky, bude pro
každý typ záznamu založen jeden záznam s uvedením stejného dopravce (ale s rozdílným ID).

3) Jizdenky

Soubor obsahuje jednotlivé záznamy o jízdenkách dle typu, který je uveden v souboru
Dopravci pro daného dopravce identifikovaného pomocí IDDopravce na začátku každého
záznamu. Není-li možné vytvořit export po jednotlivých jízdenkách, je možné sestavit za
daného dopravce souhrnný export, ve kterém bude pro každý typ jízdenky, slevy a operace
jeden součtový záznam za každý den a výdejnu.

Alternativy pro jednotlivé jízdenky

a) Záznam typu 1 (jednotlivé jízdenky – autobusová doprava s kilometrickým
    tarifem)

název pole         charakter a popis pole                             typ v DB

IDDopravce         - povinné číslo (vazba do souboru Dopravci)        Nepřenáší se

Číslo jízdenky     - povinný text                                     Varchar(20)

Datum výdeje       - povinné datum (DDMMRR)                           Smalldatetime

Čas výdeje         - povinný čas (HHMMSS)                             Smalldatetime
Typ operace
                   - povinný text (V – výdej, S – storno/vrácení) 1) Char

Typ jízdenky       - povinné číslo dle číselníku typů jízdenek        Tinyint

Typ slevy          - povinné číslo dle číselníku typů slev            Tinyint

Linka              - povinné číslo                                    Int

Spoj               - povinné číslo, pokud je lze určit                Smallint

ID zastávky od     - povinné číslo dle Celostátního registru zastávek Int

ID zastávky do     - povinné číslo dle Celostátního registru zastávek Int

Tar. čís. zastávky od - povinné číslo                                 Smallint

Tar. čís. zastávky do - povinné číslo                                 Smallint

Tarifní kilometry  - povinné číslo                                    Smallint
CenaP              - povinné číslo – cena uvedená v haléřích 2)       Int
CenaO              - povinné číslo – cena uvedená v haléřích 3)       Int
Ztráta             - povinné číslo – částka uvedená v haléřích 4)     Int

IDS                - povinné číslo dle číselníku IDS, pokud se jedná  Smallint
Platnost od        o IDS

                   - povinné datum (DDMMRR) 5)                        Smalldatetime

Typ platby         - povinné číslo dle číselníku typů plateb          Tinyint

1) typ operace S (resp. záznam tohoto typu) se uvádí v případě, že dojde k vrácení jízdného

(příp. jeho části)
2) prodejní cena uvedená na jízdence (za kterou byla jízdenka vydána)
3) cena obyčejného jízdného, která by byla účtována v případě, že by nebyla aplikována žádná

sleva (plné obyčejné jízdné dle ceníku dopravce) – v případě časové jízdenky je údaj

nepovinný

                                       2
4) max. výše dotace – v případě časové jízdenky se jedná o poměrnou ztrátu přepočtenou na
tuto jízdenku, částka se uvádí včetně DPH
5) datum platnosti od je nutné uvádět pouze v případě, že se jedná o typ jízdenky s časovou
platností (týdenní, měsíční) nebo o jízdenku vydanou v předprodeji

b) Záznam typu 2 (jednotlivé jízdenky – autobusová doprava se zónovým tarifem)

název pole      charakter a popis pole                              typ v DB

IDDopravce      - povinné číslo (vazba do souboru Dopravci) Nepřenáší se

Číslo jízdenky  - povinný text                                      Varchar(20)

Datum výdeje    - povinné datum (DDMMRR)                            Smalldatetime

Čas výdeje      - povinný čas (HHMMSS)                              Smalldatetime
Typ operace
                - povinný text (V – výdej, S – storno/vrácení) 1) Char

Typ jízdenky    - povinné číslo dle číselníku typů jízdenek         Tinyint

Typ slevy       - povinné číslo dle číselníku typů slev             Tinyint

Linka           - povinné číslo                                     Int

Spoj            - povinné číslo, pokud je lze určit                 Smallint
Počet zón                                                           Tinyint
Zóny            - povinné číslo 2)                                  Varchar(50)
CenaP           - povinný text – výčet oddělený čárkami 3)          Int
CenaO           - povinné číslo – cena uvedená v haléřích 4)        Int
Ztráta          - povinné číslo – cena uvedená v haléřích 5)        Int
                - povinné číslo – částka uvedená v haléřích 6)

IDS             - povinné číslo dle číselníku IDS, pokud se         Smallint
Platnost od     jedná o IDS                                         Smalldatetime
                - povinné datum (DDMMRR) 7)

Typ platby      - povinné číslo dle číselníku typů plateb           Tinyint

1) typ operace S (resp. záznam tohoto typu) se uvádí v případě, že dojde k vrácení jízdného
(příp. jeho části)
2) počet zón (pásem), pro které jízdenka platí
3) seznam zón (pásem), pro které jízdenka platí, je nutné uvádět pouze v případě, že se jedná o

jízdenku určenou pro konkrétní zóny; u zónově-relačního tarifu je možné uvést pouze zóny
definující relaci
4) prodejní cena uvedená na jízdence (za kterou byla jízdenka vydána)
5) cena obyčejného jízdného, která by byla účtována v případě, že by nebyla aplikována žádná
sleva (plné obyčejné jízdné dle ceníku dopravce) – v případě časové jízdenky je údaj

nepovinný
6) max. výše dotace – v případě časové jízdenky se jedná o poměrnou ztrátu přepočtenou na

tuto jízdenku, částka se uvádí včetně DPH
7) datum platnosti od je nutné uvádět pouze v případě, že se jedná o typ jízdenky s časovou

platností (týdenní, měsíční) nebo o jízdenku vydanou v předprodeji

c) Záznam typu 3 (jednotlivé jízdenky – železniční doprava s kilometrickým
    tarifem)

název pole      charakter a popis pole                              typ v DB
IDDopravce      - povinné číslo (vazba do souboru Dopravci)         Nepřenáší se
Číslo jízdenky  - povinný text                                      Varchar(20)
Datum výdeje    - povinné datum (DDMMRR)                            Smalldatetime
Čas výdeje      - povinný čas (HHMMSS)                              Smalldatetime
Typ operace     - povinný text (V – výdej, S – storno/vrácení) 1)   Char
Typ jízdenky    - povinné číslo dle číselníku typů jízdenek         Tinyint

                                 3
Typ slevy          - povinné číslo dle číselníku typů slev             Tinyint

Výdejna            - povinné číslo (kód SR70 stanice)                  Int

Stanice od         - povinné číslo (kód SR70 stanice)                  Int

Stanice do         - povinné číslo (kód SR70 stanice)                  Int

Tarifní kilometry  - povinné číslo                                     Smallint
CenaP              - povinné číslo – cena uvedená v haléřích 2)        Int
CenaO              - povinné číslo – cena uvedená v haléřích 3)        Int
Ztráta             - povinné číslo – částka uvedená v haléřích 4)      Int

IDS                - povinné číslo dle číselníku IDS, pokud se         Smallint
Platnost od        jedná o IDS                                         Smalldatetime
                   - povinné datum (DDMMRR) 5)

Typ platby         - povinné číslo dle číselníku typů plateb           Tinyint

1) typ operace S (resp. záznam tohoto typu) se uvádí v případě, že dojde k vrácení jízdného

(příp. jeho části)
2) prodejní cena uvedená na jízdence (za kterou byla jízdenka vydána)
3) cena obyčejného jízdného, která by byla účtována v případě, že by nebyla aplikována žádná
sleva (plné obyčejné jízdné dle ceníku dopravce) – v případě časové jízdenky je údaj

nepovinný
4) max. výše dotace – v případě časové jízdenky se jedná o poměrnou ztrátu přepočtenou na

tuto jízdenku, částka se uvádí včetně DPH
5) datum platnosti od je nutné uvádět pouze v případě, že se jedná o typ jízdenky s časovou

platností (týdenní, měsíční) nebo o jízdenku vydanou v předprodeji

d) Záznam typu 4 (jednotlivé jízdenky – železniční doprava se zónovým tarifem)

název pole         charakter a popis pole                              typ v DB

IDDopravce         - povinné číslo (vazba do souboru Dopravci) Nepřenáší se

Číslo jízdenky     - povinný text                                      Varchar(20)

Datum výdeje       - povinné datum (DDMMRR)                            Smalldatetime

Čas výdeje         - povinný čas (HHMMSS)                              Smalldatetime
Typ operace
                   - povinný text (V – výdej, S – storno/vrácení) 1) Char

Typ jízdenky       - povinné číslo dle číselníku typů jízdenek         Tinyint

Typ slevy          - povinné číslo dle číselníku typů slev             Tinyint

Výdejna            - povinné číslo (kód SR70 stanice)                  Int
Počet zón                                                              Tinyint
Zóny               - povinné číslo 2)                                  Varchar(50)
CenaP              - povinný text – výčet oddělený čárkami 3)          Int
CenaO              - povinné číslo – cena uvedená v haléřích 4)        Int
Ztráta             - povinné číslo – cena uvedená v haléřích 5)        Int
                   - povinné číslo – částka uvedená v haléřích 6)

IDS                - povinné číslo dle číselníku IDS, pokud se         Smallint
Platnost od        jedná o IDS                                         Smalldatetime
                   - povinné datum (DDMMRR) 7)

Typ platby         - povinné číslo dle číselníku typů plateb           Tinyint

1) typ operace S (resp. záznam tohoto typu) se uvádí v případě, že dojde k vrácení jízdného

(příp. jeho části)
2) počet zón (pásem), pro které jízdenka platí
3) seznam zón (pásem), pro které jízdenka platí, je nutné uvádět pouze v případě, že se jedná o

jízdenku určenou pro konkrétní zóny; u zónově-relačního tarifu je možné uvést pouze zóny

definující relaci
4) prodejní cena uvedená na jízdence (za kterou byla jízdenka vydána)

                                   4
5) cena obyčejného jízdného, která by byla účtována v případě, že by nebyla aplikována žádná
sleva (plné obyčejné jízdné dle ceníku dopravce) – v případě časové jízdenky je údaj
nepovinný
6) max. výše dotace – v případě časové jízdenky se jedná o poměrnou ztrátu přepočtenou na
tuto jízdenku, částka se uvádí včetně DPH
7) datum platnosti od je nutné uvádět pouze v případě, že se jedná o typ jízdenky s časovou
platností (týdenní, měsíční) nebo o jízdenku vydanou v předprodeji.

Alternativy pro souhrnné podklady

e) Záznam typu 5 (souhrnný – autobusová doprava)

název pole          charakter a popis pole                                  typ v DB

IDDopravce          - povinné číslo (vazba do souboru Dopravci) Nepřenáší se

Datum výdeje        - povinné datum (DDMMRR)                                Smalldatetime
Typ operace
                    - povinný text (V – výdej, S – storno/vrácení) 1) Char

Typ jízdenky        - povinné číslo dle číselníku typů jízdenek             Tinyint

Typ slevy           - povinné číslo dle číselníku typů slev                 Tinyint

Počet jízdenek      - povinné číslo                                         Int
CenaP
CenaO               - povinné číslo – cena uvedená v haléřích 2)            Int
Ztráta
                    - povinné číslo – cena uvedená v haléřích 3)            Int

                    - povinné číslo – částka uvedená v haléřích 4) Int

IDS                 - povinné číslo dle číselníku IDS, pokud se             Smallint
                    jedná o IDS

1) typ operace S (resp. záznam tohoto typu) se uvádí v případě, že dojde k vrácení jízdného

(příp. jeho části)
2) prodejní cena uvedená na jízdence (za kterou byla jízdenka vydána) – součet za typ

jízdenky a slevy
3) cena obyčejného jízdného, která by byla účtována v případě, že by nebyla aplikována žádná

sleva (plné obyčejné jízdné dle ceníku dopravce nebo dle ceníku IDS) – součet za typ

jízdenky a slevy – v případě časových jízdenek je údaj nepovinný
4) max. výše dotace – součet za typ jízdenky a slevy – v případě časových jízdenek se jedná o

poměrnou ztrátu přepočtenou na souhrn jízdenek, částka se uvádí včetně DPH

f) Záznam typu 6 (souhrnný – železniční doprava)

název pole          charakter a popis pole                                  typ v DB

IDDopravce          - povinné číslo (vazba do souboru Dopravci) Nepřenáší se

Datum výdeje        - povinné datum (DDMMRR)                                Smalldatetime
Typ operace
                    - povinný text (V – výdej, S – storno/vrácení) 1) Char

Typ jízdenky        - povinné číslo dle číselníku typů jízdenek             Tinyint

Typ slevy           - povinné číslo dle číselníku typů slev                 Tinyint

Výdejna             - povinné číslo (kód SR70 stanice)                      Int

Počet jízdenek      - povinné číslo                                         Int
CenaP
CenaO               - povinné číslo – cena uvedená v haléřích 2)            Int
Ztráta
                    - povinné číslo – cena uvedená v haléřích 3)            Int

                    - povinné číslo – částka uvedená v haléřích 4) Int

IDS                 - povinné číslo dle číselníku IDS, pokud se             Smallint
                    jedná o IDS

1) typ operace S (resp. záznam tohoto typu) se uvádí v případě, že dojde k vrácení jízdného

(příp. jeho části)

                                     5
2) prodejní cena uvedená na jízdence (za kterou byla jízdenka vydána) – součet za typ
jízdenky a slevy
3) cena obyčejného jízdného, která by byla účtována v případě, že by nebyla aplikována žádná
sleva (plné obyčejné jízdné dle ceníku dopravce nebo dle ceníku IDS) – součet za typ
jízdenky a slevy – v případě časových jízdenek je údaj nepovinný
4) max. výše dotace – součet za typ jízdenky a slevy – v případě časových jízdenek se jedná o
poměrnou ztrátu přepočtenou na souhrn jízdenek, částka se uvádí včetně DPH

4) Číselníky
    a) Typ záznamu

Kód Popis
  1 Jednotlivé jízdenky – autobusová doprava s kilometrickým tarifem
  2 Jednotlivé jízdenky – autobusová doprava se zónovým tarifem
  3 Jednotlivé jízdenky – železniční doprava s kilometrickým tarifem
  4 Jednotlivé jízdenky – železniční doprava se zónovým tarifem
  5 Souhrnný – autobusová doprava
  6 Souhrnný – železniční doprava

    b) Typ jízdenky

Aktuální podoba číselníku typů jízdenek je k dispozici na adrese:
http://www.cisjr.cz/doc/jizdenky.htm

    c) Typ slevy

Aktuální podoba číselníku typů slev je k dispozici na adrese:
http://www.cisjr.cz/doc/slevy.htm

    d) Typ platby

Kód Popis
  0 Platba v hotovosti
  1 Bezhotovostní platba čipovou kartou
  2 Bezhotovostní platba bankovní kartou
  3 Bezhotovostní platba - rezervační systém

    e) IDS (Integrované dopravní systémy)

Aktuální podoba číselníku jednotlivých IDS je k dispozici na adrese:
http://www.cisjr.cz/doc/ids.htm

                                                                    6