Latest revision as of 15:49, 7 September 2023

Domestic Ticket

General Observation

Aztec barcode, in PDF or image
Variable length
For domestic tickets only, international ones use RCT2 in UIC 918.3 container
zlib compressed textual payload starting at offset 3.
zlib decompressed content is plain text and hardly larger than the full compressed data, which suggests the compressed data doesn't span the full length of the barcode (signature?).

Binary Structure

Offset	Format	Meaning	Notes
0	0x04	?	fixed value
1-2	16 bit BE	?	varies with length?
3-4	0x78 0x9C	zlib marker
5+	zlib	see below
?	?	?	high entropy data, signature?
-16	0x00	?	last 16 bytes are always 0x00

Textual Payload Structure

32-34 lines, delimited by 0x0A
if there are less than 32 lines, line 30 (and possibly 32 or 33) are omitted.
strings are UTF-8 encoded
date/time format: 8 digits, the first 4 digits are the days since 2009-01-01, the last four are the time in "hhmm" format. Local time/no timezone.
class information is either provided as "[1|2].tr." ("trieda" is class) or "*" if there is no class.
network tickets (area-wide time-limited flat rate tickets), "SIEŤOVÝ", omit lines 28 and 29

Index	Format	Meaning	Notes
0	"P"		fixed value
1	16 digit number	ticket number
2	6-8 digit number	?
3	N.NN	ticket price	in EUR
4	N.NN	price?	0.00 in all samples
5	N.NN	price?	0.00 in all samples
6	string	departure station name
7	string	arrival station name
8	<number>"["<class>"]"	train number and class	"9999[]" for network tickets
9	date/time	departure time
10	date/time	end of validity
11	string	passenger name
12	?	?	0 in all samples
13	?	?	empty in all samples
14	?	?	empty in all samples
15	string	?	set for network tickets? alpha-numeric id shown in the PDF below the passenger name
16	?	?	empty in all samples
17	1-3 digit number	?	empty for bicycle addon tickets
18	?	?	0 in all samples
19	date/time	?	can be 0
20	7 digit number	discount program membership number
21	7 digit number	?	can be empty, possibly related to the discount program?
22	"N"		fixed value
23	"text"		fixed value
24	string	ticket name/title	e.g. "CESTOVNÝ LÍSTOK"
25	<string>": "<digit>	tariff name?	e.g. "OBYČAJNÝ" (ordinary), "KLASIK" or "KLASIK RP" (discount program), digit is 1 in all samples; both fields can be empty e.g. for bicycle addon tickets
26	string	ticket type?	e.g. "JEDNOSMERNÁ CESTA" (one way) or SIEŤOVÝ (network ticket)
27	?	?	empty in all samples
28	"Z: "<string>	departure station name	omitted in network tickets (the below fields move up)
29	"Do: "<string>	arrival station name	omitted in network tickets (the below fields move up)
30	"Km: "<number>" "("NO","ŽTO")"-"<string>"-"<class>	distance?/train type/class	train type is e.g. "R", "REX", "IC"; "NO" seen on tickets for people, "ŽTO" for tickets for bicycles or extra bags; omitted in tickets with less than 34 lines; similar for network tickets, but without the "Km: <number>" prefix
31	"Vlak: "<number>["Vozeň: "<number>" Miesto: "<number>]	train/coach/seat numbers	coach/seat numbers are optional, "9999" for network tickets
32	?	?	empty in all samples
33	?	?	empty in all samples

@@ Line 8: / Line 8: @@
 * zlib compressed textual payload starting at offset 3.
 * zlib decompressed content is plain text and hardly larger than the full compressed data, which suggests the compressed data doesn't span the full length of the barcode (signature?).
+== Binary Structure ==
+{| class="wikitable"
+! Offset !! Format !! Meaning !! Notes
+|-
+| 0 || 0x04 || ? || fixed value
+|-
+| 1-2 || 16 bit BE || ? || varies with length?
+|-
+| 3-4 || 0x78 0x9C || zlib marker ||
+|-
+| 5+ || zlib || see below ||
+|-
+| ? || ? || ? || high entropy data, signature?
+|-
+| -16 || 0x00 || ? || last 16 bytes are always 0x00
+|}
 == Textual Payload Structure ==
-* 34 lines, delimited by 0x0A
+* 32-34 lines, delimited by 0x0A
-* UTF-8 encoded
+* if there are less than 32 lines, line 30 (and possibly 32 or 33) are omitted.
-* date/time format: 8 digits, the first 4 seems to correspond to the day?, the last four are the time in hhmm format.
+* strings are UTF-8 encoded
+* date/time format: 8 digits, the first 4 digits are the days since 2009-01-01, the last four are the time in "hhmm" format. Local time/no timezone.
+* class information is either provided as "[1|2].tr." ("trieda" is class) or "*" if there is no class.
+* network tickets (area-wide time-limited flat rate tickets), "SIEŤOVÝ", omit lines 28 and 29
 {| class="wikitable"
@@ Line 34: / Line 55: @@
 | 7 || string || arrival station name ||
 |-
-| 8 || <number>[<digit>.tr.] || train number and class ||
+| 8 || <number>"["<class>"]" || train number and class || "9999[]" for network tickets
 |-
 | 9 || date/time || departure time ||
 |-
-| 10 || date/time || arrival time ||
+| 10 || date/time || end of validity ||
 |-
 | 11 || string || passenger name ||
@@ Line 48: / Line 69: @@
 | 14 || ? || ? || empty in all samples
 |-
-| 15 || ? || ? || empty in all samples
+| 15 || string || ? || set for network tickets? alpha-numeric id shown in the PDF below the passenger name
 |-
 | 16 || ? || ? || empty in all samples
 |-
-| 17 || 1-3 digit number || ? ||
+| 17 || 1-3 digit number || ? || empty for bicycle addon tickets
 |-
 | 18 || ? || ? || 0 in all samples
 |-
-| 19 || date/time || ? || ?
+| 19 || date/time || ? || can be 0
 |-
-| 20 || 7 digit number || ? || can be empty
+| 20 || 7 digit number || discount program membership number ||
 |-
-| 21 || 7 digit number || ? || can be empty
+| 21 || 7 digit number || ? || can be empty, possibly related to the discount program?
 |-
 | 22 || "N" ||  || fixed value
@@ Line 66: / Line 87: @@
 | 23 || "text" ||  || fixed value
 |-
-| 24 || string || ticket name/title ||
+| 24 || string || ticket name/title || e.g. "CESTOVNÝ LÍSTOK"
 |-
-| 25 || string || tariff name? ||
+| 25 || <string>": "<digit> || tariff name? || e.g. "OBYČAJNÝ" (ordinary), "KLASIK" or "KLASIK RP" (discount program), digit is 1 in all samples; both fields can be empty e.g. for bicycle addon tickets
 |-
-| 26 || string || ? ||
+| 26 || string || ticket type? || e.g. "JEDNOSMERNÁ CESTA" (one way) or SIEŤOVÝ (network ticket)
 |-
 | 27 || ? ||  ? || empty in all samples
 |-
-| 28 || "Z: "<string> || departure station name ||
+| 28 || "Z: "<string> || departure station name || omitted in network tickets (the below fields move up)
 |-
-| 29 || "Do: "<string> || arrival station name ||
+| 29 || "Do: "<string> || arrival station name || omitted in network tickets (the below fields move up)
 |-
-| 30 || "Km: "<string> || ? || distance? seems to contain class?
+| 30 || "Km: "<number>" "("NO","ŽTO")"-"<string>"-"<class> || distance?/train type/class || train type is e.g. "R", "REX", "IC"; "NO" seen on tickets for people, "ŽTO" for tickets for bicycles or extra bags; omitted in tickets with less than 34 lines; similar for network tickets, but without the "Km: <number>" prefix
 |-
-| 31 || "Vlak: "<number> || train number ||
+| 31 || "Vlak: "<number>["Vozeň: "<number>" Miesto: "<number>] || train/coach/seat numbers || coach/seat numbers are optional, "9999" for network tickets
 |-
 | 32 || ? || ? || empty in all samples