KDE PIM/KItinerary/ZSSK Barcode: Difference between revisions

From KDE Community Wiki
 
(2 intermediate revisions by the same user not shown)
Line 34: Line 34:
* 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.
* 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.
* 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"
{| class="wikitable"
Line 54: Line 55:
| 7 || string || arrival station name ||  
| 7 || string || arrival station name ||  
|-
|-
| 8 || <number>"["<class>"]" || train number and class ||
| 8 || <number>"["<class>"]" || train number and class || "9999[]" for network tickets
|-
|-
| 9 || date/time || departure time ||
| 9 || date/time || departure time ||
|-
|-
| 10 || date/time || end of validity? || this is encoded with one day more than printed in the PDF?
| 10 || date/time || end of validity ||
|-
|-
| 11 || string || passenger name ||  
| 11 || string || passenger name ||  
Line 68: Line 69:
| 14 || ? || ? || empty in all samples
| 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
| 16 || ? || ? || empty in all samples
Line 76: Line 77:
| 18 || ? || ? || 0 in all samples
| 18 || ? || ? || 0 in all samples
|-
|-
| 19 || date/time || ? || ?
| 19 || date/time || ? || can be 0
|-
|-
| 20 || 7 digit number || discount program membership number ||  
| 20 || 7 digit number || discount program membership number ||  
Line 88: Line 89:
| 24 || string || ticket name/title || e.g. "CESTOVNÝ LÍSTOK"
| 24 || string || ticket name/title || e.g. "CESTOVNÝ LÍSTOK"
|-
|-
| 25 || <string>": "<digit> || tariff name? || e.g. "OBYČAJNÝ" (ordinary) or "KLASIK RP" (discount program), digit is 1 in all samples; both fields can be empty e.g. for bicycle addon tickets
| 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)
| 26 || string || ticket type? || e.g. "JEDNOSMERNÁ CESTA" (one way) or SIEŤOVÝ (network ticket)
|-
|-
| 27 || ? ||  ? || empty in all samples
| 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: "<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; omitted in tickets with less than 34 lines
| 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
| 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
| 32 || ? || ? || empty in all samples

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