Common Transport Format (Transportformatet, TRP)

Preface

This edition of the Common Transport Format of Traffic Data for Samtrafiken and its Owners Version 3.0 replaces Version 2.0 which was approved by Samtrafiken’s board in May 1993.

From 1993 until the present day the Transport Format has undergone three important phases of adjustments. These phases are as follows:

  • 1993.  The Transport Format entered into use for the transmission of traffic data from SJ and PTAs (Public Transport Authorities = THM) to Samtrafiken and within Samtrafiken
  • 1997.  The National Database (RDB) and the Journey Planner entered into service thus placing new demands on the Transport Format
  • 2000.  Tågkompaniet started to utilise traffic data from RDB in accordance with the Transport Format for their booking system “Tag Plats”.

1. Introduction

The target group for this document consists of all the companies that intend to exchange traffic information. The document has been prepared by Samtrafiken in collaboration with the PTAs, rail companies and most of the PTA’s system suppliers.

PTA in this document refers to all traffic companies in the roll of owning the traffic.

2. General Information

This section is intended for those who wish to order or develop export and/or import applications to/from other timetable databases.

Data is transferred to/from (TDB) via a transport document constructed in a format agreed by Samtrafiken’s owners and Samtrafiken. The format enables data to be exchanged between other systems in different data environments and RDB.

The Transport Format is physically comprised of a data file in text format that can be exchanged via different types of media. Making a data delivery always requires complete information regarding a Company, PTA or suppliers.

2.1 Requirements of External Systems

An external system means a database system for timetable data at the Company, PTA or suppliers.

Certain requirements for the external system must be fulfilled if the system is to be able to send and retrieve data to/from RDB and to interpret the data correctly.

2.2 Requirements for Delivering Data to TDB

External systems must be able to write data in the Transport Format described below. Selection of data from the external system must be possible for a specified period limited by a start date as well as by a selection of lines.

Certain post types are obligatory, others optional. In certain cases the information is obligatory in so far as a value must be given. If the external system lacks such information a default value must be stated.

2.3 Requirements for Retrieving Data from TDB

External systems must be able to read data in the Transport Format described below.

An important requirement for how the external system reads the Transport Format is that the system accepts all post types 00-99. This is important so that Samtrafiken can successively implement new post types in the Transport Format without requiring changes in the external systems.

A post type with data that is uninteresting for the external system or that contains an unknown post type can be ignored completely when reading data from the Transport Format.

The external system must interpret data in accordance with this document as far as is possible. Responsibility for use of data from RDB in the external system as regards imperfect interpretation of TDB data is the sole responsibility of the procurer of timetable data.

2.4 Calendar Handling

TDB can handle timetable data from different Company/PTAs or suppliers with differing traffic calendars and traffic periods. Traffic data from and to TDB is always to be supplied according to the international calendar.

2.5 Standard Values

Standard values for obligatory information must be applied in those cases where the information cannot be supplied by any other means. Standard values for different types of fields are shown in the Catalogue of Terms.

All numerical fields must be right justified. Any other characters + or - that may be needed must be fitted within the field width specified in the Catalogue of Terms.

Values are to be zero filled. (There are exceptions)

If information is missing for a numeric field then the value 0 must be given if no other standard value has been specified for the field in the Catalogue of Terms.

2.6 Text in Fields

All alphanumerical fields are to be left justified unless otherwise specified in the Catalogue of Terms for the field. The values are to be filled in to the full field width with space characters.

3. Catalogue of Terms

The Catalogue of Terms contains all formats and variants of terms with unique significance. The different terms’ independence (i.e. object dependence) importance is apparent from this catalogue.

FieldLengthComment

ANVSIGN

A6

User signature in the Transport Format.

CALC

A1

Indicates if a departure time or arrival time is calculated or not. Value: Y = yes, N = no.

DAGKOMB

N7

Validity expressed in day types. This is weekdays without any holidays -  Mondays through Sundays shall be given with values 1 or 0. Example: 1111111 all days of the week, 1110101 all days of the week except for Thursdays and Saturdays.

DATUM

N8

Date expressed in the form YYYYMMDD. (Year, Month, Day. Example: 20130627, which means June 27th 2013).

DIREKT

A1

Value D denotes that a connection actually has through coaches into the other train. May be left blank.

DYGN

N2

Indicates if the trip continues into the next 24 hour period/date or not. First 24 hour day = 01. Second 24 hour day = 02. All days in this matter start 00.00.

FUNKKOD

N1

Function code in the Transport Format. Valid value = 0.

HPLKOD

N1

Type of stop in the Twins system.

HPLNAMN

A15

Special 15 character stop name for the Petra booking system.

HPLNR

N6

Identifying number code for a local stop within a Company or PTA or a national stop within a specific country. In specific fields also used for geographic stop zone number.

HPLSIGN

A6

Signature/Token for a stop as defined in RDB.

INFOTEXT

A140

Free text.

KALENDER

A3

INT respective RTT. INT=international calendar (example: Long Friday=F (Friday)),

RTT=RTT-calendar (example: Long Friday =SoH (Sundays and Holidays)).

KLOCKSLAG

N4

Value 0000-2400. Value>2400 is day 2.

KNUTPUNKT

A1

Stop at which a connection between two trips is allowed to be made.

KOD

A3

Codes as defined in RDB.

KODNAMN

A40

Code name as defined in RDB.

KOMMUNKOD

N2

Municipal code within a county.

KONTAKT

A30

Name of contact person.

KOORD

N8

Coordinates (X or Y) according to the Swedish national network RT90 system.

KORTNAMN

A20

Short version of name.

LAND

A20

Country name for a LANDSKOD.

LANDSKOD

A3

Code defining a country according to RDB.

LGNAMN

??

Special name on a stop point.

LGNR

??

Identifying number of a stop point.

LINJEBET

A4

Announced line number. Can be blank.  Deprecated.

LINJENR

N4

Technical Line number within a Company/PTA.

LÅNGNAMN

A40

Complete name of stop, company, attribute etc.

LÄNSKOD

A2

County code.  (In Sweden “LÄN”).

LÖSENORD

A6

Password or other form of authority for communication.

METER

N5

Number of meters (0-99999).

MINUTER

N3

Number of minutes (0-999).

NAMN

A30

Name of company, person or occurrence.

OPERBET

A6

Code of operator who runs the traffic for a Company/PTA. Still not used in train files.

ORTNR

N6

District number according to RDB. Numbers 000001-999999.

POSTTYP

N2

Type of post in the Transport Format.

PRIORITET

A1

Degree of importance, priority, for interchange between two trips at this stop.

PZONNR

??

The number defining a certain price zone.

PRODNR

N3

Company code as defined in RDB. Defines which tariff shall be used.

PUBLID

N4

ID-number for a specific selection of data, a “Publication”.

PUBLNAMN

A30

Name of a specific selection of data, a “Publication”.

RENHET

N4

Resultatenhet (SJ specific value).

RIKTNING

N1

Direction to or back. Value 1 or 2.

SJRAPP

A4

Code according to announcement register as defined in RDB system.

SWKOORD

N7

Coordinates (X or Y) according to SWEREF99 system.

TELENR

A20

Telephone number including -, ,,*,#. Also includes fax.

TF

A1

Denotes whether the accompanying information refer to a departure (F) or arrival (T).

THMNR

N3

Code number for Company/PTA. Value 001-999. Exception: In train files this field is used for Operators.

THMNRA

N4

Code number for Company/PTA. Value 0001-9999.

THMSIGN

A4

Code for Company/PTA according to RDB system.

TIMMAR

N2

Amount of hours (0-99).

TRAFMEDEL

A1

Vehicle class as defined in RDB, used for connection information. Possible values are:

D = Flygbuss

E = Flygtaxi

G = Gånglänk

X = Stadstrafik

B = BUS

S = TRAM

U = METRO

J = TRAIN

F = FERRY, SHIP

T = TAXI

TURBET

A6

Announced trip number. May (partially) consist of letters.

TURNR

N6

Technical trip number within a Company/PTA.

TURNAMN

A30

Special announced name on a trip. Example: Orange Express, Skåneexpressen, Kustpilen, Mittåget etc.

TYP

A3

Type of code as defined in RDB.

UICLAND

N2

UIC Numeric country code.

UNDTYP

A1

Date exceptions for trip or different time zone. Value + or -.

UPHKOD

N1

Indicates whether boarding at a departure is allowed or not, as well as if disembarking at an arrival is allowed or not on a stop. Value 0/1.

UTGNR

N4

Version of a specific selection of data.

WGKOORD

N9

Coordinates (X or Y) according to WGS84 system.

4. Logical File Structure

The internal structure and order of the posts in a transport file is shown in the diagram below.

+ Mandatory post.

* Optional post.

5. Post description

RDB, as referred to below, means Samtrafiken’s national traffic database (“Riksdatabasen” in Swedish).

+ Mandatory field.

Field

Term

Length

Position

Comment

Description in Swedish


01 - Start data

This post is mandatory. In the field LEVTHM the deliverer shall be given. The company number used must be defined in RDB. In the field URVALFRÅN the first date that the timetable applies from is given, while the field URVALTILL is the last date.


POSTTYP +

POSTTYP

N2

1-2

01

Not used


N1

3


ANVSIGN

ANVSIGN

A6

4-9

User signature (Not in use).

LÖSENORD

LÖSENORD

A6

10-15

User password (Not in use).

LEVTHM +

THMNR

N3

16-18

Deliverer. Number as defined in RDB. PTA 000 = Samtrafiken.

Leverantören av filen, 000=Samtrafiken.

URVALFRÅN +

DATUM

N8

19-26

First date of valid traffic data being included in the file. YYYYMMDD.

Den period trafikdatat i filen inkluderar.

URVALTILL +

DATUM

N8

27-34

Last date of valid traffic data being included in the file. YYYYMMDD.

KALENDERTYP +

KALENDER

A3

35-37

INT or RTT. INT=international calendar (example: Long Friday=F (Friday)).

RTT=RTT-calendar (example: Long Friday =SoH (Sundays and Holidays)).

Kalender. INT = Internationell kalender utan helgdagar.

PUBLID

PUBLID

N4

38-41

ID-number for a specific selection of data. Ex 0103.

UTGNR

UTGNR

N4

42-45

Version of a specific selection of data. Ex 0012.

PUBLNAMN

PUBLNAMN

A30

46-75

Name of a specific selection of data.

SKAPAD

DATUM+

KLOCKSLAG

N19

76-94

Date and time the file was created. Ex 2010-01-01_10.53.30.

FILESTATUS

FILESTATUS

A1

95

Internal value to be able to decide whether a file is modified or not.

LEVTHM

THMNRA

N4

96-99

PTA 0000 = Samtrafiken.


02 - Company information

Not used in files to Samtrafiken/RDB.

Information regarding PTAs and other traffic companies.


POSTTYP

POSTTYP

N2

1-2

'02'

Not used



3


THMNR

THMNR

N3

4-6

Company number as in the RDB system.

THMSIGN

THMSIGN

A4

7-10

Company signature.

THMNAMN

NAMN

A30

11-40

Name of Company.

THMBESADR

BESADR

A30

41-70

Deprecated.

THMBREVADR

BREVADR

A30

71-100

Deprecated.

THMPOSTNR

POSTNR

A6

101-106

Deprecated.

THMPOSTADR

POSTADR

A20

107-126

Deprecated.

THMLAND

LAND

A20

127-146

Country of Company.

THMKONTAKT

KONTAKT

A30

147-176

Personal contact.

THMTELENR

TELENR

A20

177-196

Telephone number.

THMFAXNR

TELENR

A20

197-217

Deprecated.


03 - List of Companies

Not used in files to Samtrafiken/RDB.

Information regarding valid PTAs and other traffic companies numbers.


POSTTYP

POSTTYP

N2

1-2

'03'

Not used



3


THMNR

THMNR

N3

4-6

Company number as in the RDB system.

Trafikföretagsnummer.

THMSIGN

THMSIGN

A8

7-14

Company signature.

THMNAMN

NAMN

A30

15-80

Name of Company.

Trafikföretagsnamn.


04 - Register of codes

Not used in files to Samtrafiken/RDB.

Codes describing the character of different traffic types.


POSTTYP

POSTTYP

N2

1-2

’04’

Not used



3


TDBTYP

TYP

A3

4-6

Type (category) of code in the RDB system.

TDBKOD

KOD

A3

7-9

Code in the RDB system.

TDBKOD2

KOD

A3

10-12

Deprecated.

KODNAMN

NAMN

A30

13-42

Name of code in the RDB system.


08 - District data


District is defined as a geographical area that contains one or more stops. Not used in files to Samtrafiken/RDB.


POSTTYP

POSTTYP

N2

1-2

08

Not used



3


LAND

LANDSKOD

N3

4-6

Country code as defined in RDB.(Sweden=074).

ORTNR

ORTNR

N6

7-12

District number as defined in RDB.

ORTLÅNGNAMN

LÅNGNAMN

A40

13-52

Long name for district.

ORTKORT

KORTNAMN

A20

53-72

Short name for district.

LÄN

LÄNSKOD

A2

73-74

County code.

KOMMUN

KOMMUNKOD

N2

75-76

Municipality code.

XKOORD

KOORD

N8

77-84

X coordinate according to Swedish RT90 system (Not mandatory).

YKOORD

KOORD

N8

85-92

Y coordinate according to Swedish RT90 system (Not mandatory).

ORTTYP

KOD

A3

93-95

Type of district as defined in RDB.

KOMMUN

KORTNAMN

A20

96-115

Municipality name.

TIDSZONTYP

UNDTYP

A1

116

Time zone for the district compared to Sweden. More (+) or less (-) hours.

TIDSZONTIM

TIMMAR

N2

117-118

Time zone difference for the district compared to Sweden expressed in amount of hours.


10 - Stop


10-posts must be delivered for all the stops specified in transport format post 35. The stop’s name must always be given including its full name, short name and, when used, signatures. Every Company/PTA enter here their own internal identification numbers for stops. If information regarding X and Y coordinates exists these must be given in accordance with the national coordinate system RT90.


POSTTYP +

POSTTYP

N2

1-2

10

Not used



3


HPLTHMNR +

THMNR

N3

4-6

Same Company as the data supplier in 01-post who owns the definition of stop data in the following positions. 3-digit number.

Det företag som numrerat hållplatsen. 074, 076, 086 avser emellertid land (Sverige, Norge respektive Danmark).

HPLNR +

HPLNR

N6

7-12

Stop number.

Hållplatsens nummer.

HPLSIGN

HPLSIGN

A6

13-18

Stop token.

HPLKORTNAMN

KORTNAMN

A20

19-38

Short version of stop name.

HPLLÅNGNAMN +

LÅNGNAMN

A40

39-78

Long version of stop name.

Hållplatsens namn.

LÄN

LÄNSKOD

A2

79-80

County code.

Län.

KOMMUN +

KOMMUNKOD

N2

81-82

Municipality code. Certain Company/PTA systems deliver 3 or 4 digits token using position 79-82.

Kommun.

XKOORD +

KOORD

N8

83-90

X coordinates for the stop according to Swedish coordinate system RT90.

Koordinat X.

YKOORD +

KOORD

N8

91-98

Y coordinates for the stop according to Swedish coordinate system RT90.

Koordinat Y.

LIGGERIORT

ORTNR

N6

99-104

District number where this stop is located.

RIKSHPLNR

HPLNR

N6

105-110

Swedish national stop number where this stop is subordinated.

BYTESTID +

MINUTER

N3

111-113

Minimum time in minutes for general transfer between two trips at this stop.

Not used



114-116


BYTPRIORITET +

PRIORITET

A1

117

Transfer priority - degree of importance for itransfer between two trips at this stop.

KNUTPUNKT

KNUTPUNKT

A1

118

Junction. Whether or not this stop is allowed for transfer between two trips.

Value: 0 or 1.

TMSTNNR

HPLNR

N6

119-124

Special stop number for 15 character stop name for Petra booking system.

TMSTNNAMN

HPLNAMN

A15

125-139

Special stop name for 15 character stop name for Petra booking system.

HPLINFONAMN

LÅNGNAMN

A40

140-179

Information name for this stop.

HPLTYP

HPLKOD

N1

180

Type of stop in the Twins system.


11 - Stop synonymous names

This post type is currently not in use. Any data delivered in this post will be ignored by Samtrafiken's systems.

POSTTYP

POSTTYP

N2

1-2

11

Not used



3


SYNONYM

LÅNGNAMN

A40

4-43

Long alternative name to the name in previous 10-post.


16 - Stop connection information – general connections

This post shows stop connection times in the RDB. Sets the transfer times between different vehicle classes. See also 50 posts.
In data files to Samtrafiken, these files are not (yet) considered.


POSTTYP

POSTTYP

N2

1-2

16

Not used



3


HPLTHMNR

THMNR

N3

4-6

Same Company as the deliverer in 01-post who owns the definition of stop data in the following positions.

HPLNR

HPLNR

N6

7-12

Stop number.

FRÅNTRAFMEDEL

TRAFMEDEL

A1

13

Arriving vehicle class.

TILLTRAFMEDEL

TRAFMEDEL

A1

14

Departing vehicle class.

MINÖVGTID

MINUTER

N3

15-17

Minimum time in minutes for general transfer between two trips at this stop with regard to vehicle classes above.

Not used



18-20


INVTID

MINUTER

N3

21-23

Maximum time in minutes a trip will wait in order to maintain a connection. Not in use.


17 - Stop facilities

Not in use.

Facilities at a stop.


18 - Stop facilities availability

Not in use.

See post type 17.


19 - Stop other information

Not in use.

See post type 17.


20 - Route header

Trips must be sorted on routes when included in the file. Each new route starts with a new 20-post. If lines from more than one Company/PTA is included, each new company (as well as new lines) must start with a new 20-post. Within a line one or more trips (30 posts) can be given. (currently this is redundant to the information in 30-posts - right now Samtrafiken could allow files w/o 20-posts).


POSTTYP +

POSTTYP

N2

1-2

’20’

Not used



3


LINTHMNR +

THMNR

N3

4-6

Company number as in RDB. 3 digit number. May be other than deliverer in 01 post. (In train files this field is used for Operator).

Trafikföretaget. Om det är tåg anges här operatören, inte ägaren.

LINJENR +

LINJENR

N4

7-10

Technical line number.

Tekniskt linjenummer.

PRODUKTKOD

KOD

N3

11-13

Product code. Deprecated.

LINJEBET

LINJEBET

A4

14-17

Announced line number. Deprecated.

LINTHMNR

THMNRA

N4

18-21

Company number as in the RDB system. 4 digit number (In train files still used for Operator)


30 - Trip identity/header

A trip refers to a defined segment where traffic is conducted in a specified time period. A trip can result in different trip variants depending on information regarding

  • departure dates
  • waiting at stop
  • announced time
  • different comfort levels

This means that a trip in this post is the equivalent of a trip variant. Different trip variants may not be put together, or devided, unless all different values connected to each trip variant is handled correctly.


The validity of a trip is defined in the following positions in the 30-post

DAGKOMB position 38-44 (Days of the week),

FROMDATUM position 45-52 (Period starting date, this date shall be included) and

TOMDATUM position 53-60 (Period ending date, this date shall also be included in the period).

Exceptions from this validity information are given in 34 posts following each 30 post.


Product codes (PRODKOD) and booking codes (BOKKOD) are specified in the 30-post when the entire trip variant is applicable.


Product- and booking details for part of the trip as well as groups of carriages (in a train) are always found in post 37. On-demand information with regard to a trip is found in post 36.


Comfort code (KOMKOD) regards comfort level and encompasses the entire trip variant. Some are only included in 30-posts (like A, B, AB, C and W denoting different types of cars), while others are only included in 37-posts and a few may be included in both 30- and 37-posts. Such description will be supplied in each special case.


NB. Positions 61-69 and 81-89 have alternative use depending on the value: a) and c) Swedish stop signatures only. b) and d) Non-Swedish stop numbers only. This means either shall positions indicated by a) or the two b) be used. Also, either shall positions indicated by c) or the two d) be used.

NB2: Samtrafiken may (after some rethinking) accept national non-swedish signatures as well, as soon as the codes do not collide with national swedish signature.


POSTTYP +

POSTTYP

N2

1-2

’30’

Not used



3


LINTHMNR +

THMNR

N3

4-6

Company number 3 digit number.

Trafikföretaget. Om det är tåg anges här operatören, inte ägaren.

LINJENR +

LINJENR

N4

7-10

Technical line number. Part of the ID for a trip.

Tekniskt linjenummer.

TURNR +

TURNR

N6

11-16

Technical trip number. Part of the ID for a trip.

Tekniskt turnummer.

TURRIKTNING +

RIKTNING

N1

17

Trip direction 1 or 2.

Riktning.

TURBET +

TURBET

A6

18-23

Announced trip number. May often actually be an announced line number if that is what the trip shall be announced under. Example: “1”, “714X”, “Orange”.

Annonserat tågnummer, eller annonserat linjenummer för bussar. Vi använder turBet om transportMode är tåg.

TRAFMEDEL +

TRAFMEDEL

A1

24

Vehicle class as defined in  RDB.

Trafikmedel.

LINJEBET

LINJEBET

A4

25-28

Line designation. 

The line designation can sometimes contain more than 4 characters. If it contains more than 4 characters, LINJEBET will displayed as blank in STIP.dat files.

PRODKOD

KOD

A3

29-31

Product code as defined in RDB.

BOKKOD

KOD

A3

32-34

Booking code as defined in RDB.

KOMKOD

KOD

A3

35-37

Comfort code as defined in RDB.

DAGKOMB +

DAGKOMB

N7

38-44

The days the trip runs. This is weekdays without any holidays -  Mondays through Sundays shall be given with values 1 or 0. Example: 1111111 means all days of the week, 1110101 means all days of the week except for Thursdays and Saturdays.

Dagar turen går.

FROMDATUM +

DATUM

N8

45-52

Running days starts on this date, YYYYMMDD.

Period turen går.

TOMDATUM +

DATUM

N8

53-60

Running days until and including this date, YYYYMMDD.

FRÅNHPL

HPLSIGN

A9

61-69

Stop token(signature) of the trip's origin (as defined in RDB or a theoretical one).

Files to Samtrafiken: Samtrafiken may have further rules to fill this position or override this value.
Files from Samtrafiken: Samtrafiken cannot guarantee these positions to be filled.
Contact Samtrafiken if in doubt.

Not used



70-80


TILLHPL

HPLSIGN

A9

81-89

Stop token(signature) of the trip's destination (as defined in RDB or a theoretical one).

Files to Samtrafiken: Samtrafiken may have further rules to fill this position or override this value.
Files from Samtrafiken: Samtrafiken cannot guarantee these positions to be filled.
Contact Samtrafiken if in doubt.

Not used



90-96


RENHET

RENHET

N4

97-100

Resultatenhet (SJ specific value).

PRODNR

PRODNR

N3

101-103

Company code as defined in RDB. Indicates which tariff shall be used in Petra-System.
Samtrafiken internally:

  • Its value is stored in RDB as trip attribute with type K308.
  • Additionally (at leas in Train Mode) PRODNR identifies together with LINTHMNR the Company in IVU.pool which gets this trip.

Om det är tåg anges här trafikföretaget. För alla trafikslag anges här också den tariff som ska gälla.

TURNAMN

TURNAMN

A30

104-133

Special announced name on a trip. Example: Orange Express.

Eventuellt långnamn på turen, t.ex. ”Skåneexpressn 8”. Vi behöver inte turNamn om transportMode är tåg.

Not used



134-141



31 - Trips general footnotes post


Footnotes for the trip variant are available here in free text format. 31-post shall be included directly after concerned 30-post

Generally the information from 31-posts is not guaranteed to show up anywhere (like Journey Planners or booking systems). Data producers should clarify use cases of this post type with Samtrafiken.


POSTTYP

POSTTYP

N2

1-2

'31'

Not used



3


FOTNOTTYP +

TYP

A3

4-6

Value is 'TUR' or 'KM'.

FOTNOT +

INFOTEXT

A160

7-166

Free text applying to the entire trip.


32 - Trip Operator

Not used in train files.

Shows details of which operator is conducting each trip. Two or more 32-posts can be used to show different operators operating the trip in different week days or different time periods. Company/PTA number in this post refer to this Company’s/PTA’s identification of the operator.

The key is OPERBET. In the 80 post the code is defined with details of the operator referred to by the OPERBET given.


POSTTYP +

POSTTYP

N2

1-2

‘32’

Not used



3


THMNR +

THMNR

N3

4-6

Company number as in trip's 30-post. 3 digit number. This refers to the company having the code definition of this post’s OPERBET.

OPERBET +

OPERBET

A6

7-12

The Company’s/PTA’s code for the Operator. Example ‘REIBT’, ‘2X5f1’, ‘SWE32’.

DAGKOMB +

DAGKOMB

N7

13-19

The days of the week the operator operates. This is weekdays without any holidays -  Mondays through Sundays shall be given with values 1 or 0. Example: 1111111 means all days of the week, 1110101 means all days of the week except for Thursdays and Saturdays.

FROMDATUM +

DATUM

N8

20-27

Validity for the weekdays above starts on this date, YYYYMMDD.

TOMDATUM +

DATUM

N8

28-35

Validity for the weekdays above, lasting until and includes this date, YYYYMMDD.


34 - Trip - timetable period exceptions

Exceptions from the validity given in the previous 30 post, these are defined in one or more 34-posts.

Exceptions must be within the 30 post’s period (not before the start date or after the end date as defined by FROMDATUM and TILLDATUM).

The type of adjustment, is defined in position 4 TURUNDTYP where

“+” means that the trip operates on this day or for this period too.

“–“ means that the trip is cancelled on this day or for this period.

The exception dates are given in position 5-12 FROMDATUM (Period starting date) and in position 13-20 TOMDATUM (Period ending date).

Example: An adjustment of only one date is written: 2012060120120601 (same date June 1st 2012 in both positions. A period is written for instance 2012060120130117 (meaning June 1st 2012 up to and including January 17th 2013.

The positions 21-38 are intended for the stop sequence concerned in the case not all of the stop sequence is affected by the adjustment.
These positions are not yet in use

  • since the proper interpretation of the data can get rather complicated and
  • the receiving system (RDB - IVU.pool) is not tested with such data.


The sorting of the 34 can be essential, since the periods (FROMDATUM to TOMDATUM) of subsequent 34-posts may overlap.
34-posts are interpreted from to to bottom.


POSTTYP

POSTTYP

N2

1-2

'34'

Not used



3


TURUNDTYP +

UNDTYP

A1

4

Value ‘+’ indicates a trip runs extra date(s), value ‘-‘ indicates the trip does not run a certain date(s).

+ = extra dag(ar), -= inställda dag(ar).

FROMDATUM +

DATUM

N8

5-12

Exception from the trips running days starts on this date, YYYYMMDD.

Fråndatum.

TOMDATUM +

DATUM

N8

13-20

Exception from the trips running days until and including this date, YYYYMMDD.

Tilldatum. Kan vara samma datum som ovan = perioden omfattar en dag.

FRÅNHPLTHM

THMNR

N3

21-23

Currently not in use. The owner/identifier of the stop number in next position.

FRÅNHPLNR

HPLNR

N6

24-29

Currently not in use. The stop where the exception validity starts.

TILLHPLTHM

THMNR

N3

30-32

Currently not in use. The owner/identifier of the stop number in next position.

TILLHPLNR

HPLNR

N6

33-38

Currently not in use. The last stop where the exception is valid.


35 - Trip departures and arrivals

All mandatory data concerning each departure or arrival of a trip is given in 35-posts.

A departure (position 4-25) is written:

(DYGN) refers to the 24 hour day and is a relative measure from the first departure. It means that first 24 hour day gets value ‘01’. If the trip continues into the next 24 hour day such departures or arrival gets the value (02) after midnight.

(KLOCKSLAG) is the departure or arrival time in hours and minutes (ex. 1758)

(THMNR) is the Company/PTA (to define who’s stop it is) (ex. 123)

(HPLNR) is the Company’s/PTA’s (from above) stop where the trip stops. (ex. 001234)

(UPHKOD) indicates if boarding/disembarking is allowed (ex. 1), or not allowed (ex. 0)

(TURBET) is announced trip number for this section of the trip. Using this field it is possible for the announced trip number to vary along the route.


The same set of data is written also on the same row for the first arrival (but in positions 26-47) after the departure above.


(TURNR) Technical trip number is added for the departure in positions (56-61) and for the trip arrival in position (62-67). Not yet in use.


There is two different philosophies used in different situations regarding the handling of “DYGN” in combination with “KLOCKSLAG”. The alternative way to the one described below is when “DYGN” is always “01” and “KLOCKSLAG” uses values above 2400 instead. Please contact Samtrafiken to find out how to best represent your traffic.

POSTTYP +

POSTTYP

N2

1-2

’35’

Not used



3


AVGDYGN +

DYGN

N2

4-5

Concerns this departure. Indicates if the trip continues into the next 24 hour period/date or not. First 24 hour day = 01. Second 24 hour day = 02. All days in this matter start 00.00.

Avgångsdygn.

AVGTID +

KLOCKSLAG

N4

6-9

Time of departure from this stop . Value 0000-2359.

Avgångstid.

AVGHPLTHM +

THMNR

N3

10-12

Bus files: The Company/owner/identifier of the stop number in next position. Must be the same as in the preceding 30-post.
Train files: The country code of the following stop number.

Det företag som numrerat avgångshållplatsen. 074, 076, 086 avser emellertid land (Sverige, Norge respektive Danmark).

AVGHPLNR +

HPLNR

N6

13-18

The stop number for the trips departures. Unless it is the trips first departure this stop number must be the same as the previous 35-post stop number for arrival.

Avgångshållplats.

AVGUPHKOD +

UPHKOD

N1

19

0=boarding not allowed, 1=boarding allowed for the stop in position 13-18.

1 = påstigning tillåten, 0 = påstigning ej tillåten.

AVGTURBET +

TURBET

A6

20-25

Announced trip number for the departure. May contain letters.

Annonserad avgångsturbeteckning på turen.

ANKDYGN +

DYGN

N2

26-27

Concerns this arrival. Indicates if the trip continues into the next 24 hour period/date or not. First 24 hour day = 01. Second 24 hour day = 02. All days in this matter start 00.00.

Ankomstdygn.

ANKTID +

KLOCKSLAG

N4

28-31

Time of arrival to this stop . Value 0000-2359.

Ankomsttid.

ANKHPLTHM +

THMNR

N3

32-34

bus files: The Company/owner/identifier of the stop number in next position. Must be the same as in the preceeding 30-post.
train files: The country code of the following stop number.

Det företag som numrerat ankomsthållplatsen. 074, 076, 086 avser emellertid land (Sverige, Norge respektive Danmark).

ANKHPLNR +

HPLNR

N6

35-40

The stop number for the trips arrivals. Unless it is the trips last arrival this stop number must be the same as the next 35-post stop number for departure.

Ankomsthållplats.

ANKUPHKOD +

UPHKOD

N1

41

0=disembarking not allowed, 1=disembarking allowed for the stop in position 35-40.

1 = avstigning tillåten, 0 = avstigning ej tillåten.

ANKTURBET +

TURBET

A6

42-47

Announced trip number for the arrival. May contain letters.

Annonserad ankomstturbeteckning på turen.

Not used



48-55



36 - Trip departure’s and arrival’s footnotes

This post belongs to a stop specified in the closest post 35 above it and contains attribute information referring to either, the arrival to, or the departure from, this stop.

The post is used for different purposes with the use of position 5-7 TYP (type) and position 8-10 KOD (code) as follows                                          Type (5-7)      Code (8-10)

1                    - Free text                            FOT                FOT

2                    - On-demand information    FOT                BES - "FOTBES" is correct for export (Silverrail), for import (IVU) use "TIDBES"

3a                  - Connections                       TID                 ANS  - Used for guaranteed connections, valid for all usages.

3b                                                              TID                 BRU - Used for non-allowed connections, valid for all usages.

3c                                                              TID                 AND - Used for guaranteed connections. Should not be displayed/used in "printed" time tables.

3d                                                              TID                 BRD - Used for non-allowed connections. Should not be displayed/used in "printed" time tables.

The fields used for above 6 cases is as follows. Mandatory markings below depend on these cases. (36-post is optional).

1    1-10, 120-377

2    1-10, 11-41, 87-93, 120-377

3    1-10, 64-109, 372-377


The validity of the attribute in a 36-post is defined by (when used according to above)

DAGKOMB position 87-93 (Days of the week),

FROMDATUM position 94-101 (Period starting date, this date shall be included) and

TOMDATUM position 102-109 (Period ending date, this date shall be included).


On-demand trips (“BES” identifier) will be described separately.


Each 36 post in a transport format file shall be entered on its own with an own calendar validity for instance in an importing system (i.e. RDB). 36 posts are only allowed to be merged in an importing system (i.e. RDB) if they belong to the same trip and are identical except for the stop value they belong to in the transport format import file. In that case they are only allowed to be merged if the same 36-post applies to all stops in a stops equence, for instance B, C, D, E and F, which would turn into B-F.


POSTTYP +

POSTTYP

N2

1-2

’36’

Not used



3


TILLFRÅN +

TF

A1

4

F defines that this 36 post attribute belongs to the departure stop in position 13-18 in the previous 35 post. T defines that this 36 post attribute belongs to the arrival stop given in position 35-40 in the previous 35 post.
The value can be either F or T.

Kevin 2024-03-07: F means "FROM the other trip to this trip". T means "TO the other trip from his trip". Example:

3000740172... etc

3500111180740000081 0111340740001831

360FTIDBRU00000000000 0740430... etc

Broken connection FROM 430 to 172.

TYP +

TYP

A3

5-7

Values: FOT or TID. See explanation above.

KOD +

KOD

A3

8-10

Values: FOT, BES, ANS, BRU, AND or BRD. See explanation above.

Koden ”BES” anger att det är en tur som måste förbeställas från avgångshållplatsen i föregående 35-post position 13-18.

FNOTDYGN

DYGN

N2

11-12

On-demand: States how many 24 hour periods prior to departure time advance bookings have to be done. Used in combination with FOTNOTKLS to set the exact time.

FNOTKLS

KLOCKSLAG

N4

13-16

Time or 0000. On-demand: A set time when advance bookings have to be done. Used in combination with FNOTDYGN.

FNOTTIM

TIMMAR

N2

17-18

Hours or 00. On-demand: Number of hours before an advance booking has to be done. Alternative to FNOTDYGN, FNOTKLS and FNOTMIN. Can be used in combination with FNOTMIN.

FNOTMIN

MINUTER

N3

19-21

Minutes or 000. On-demand: Number of minutes before an advance booking has to be done. Alternative to FNOTDYGN, FNOTKLS and FNOTTIM. Can be used in combination with FNOTTIM.

FNOTTELENR +

TELENR

A20

22-41

Telephone number. On-demand: Telephone number the traveller shall call in order to make an advance booking.

Not used



42-59


LNJTHMNR +

PRODNR

N3

64-66

Connections: Identifying the Company/PTA the other trip belongs to.

LNJNR +

LINJENR

N4

67-70

Connections: Identifying the other trip’s technical line number.

TURNR +

TURNR

N6

71-76

Connections: Identifying the other trip’s technical trip number.

TRAFMEDEL

TRAFMEDEL

A1

77

Vehicle class. Used here with certain restrictions as redundant/contradictory information must be avoided.

THMNR +

THMNR

N3

78-80

The Company/owner/identifier of the stop number in the next position. Must be the same as in the preceeding 30-post.

THMHPLNR +

HPLNR

N6

81-86

The stop where the other trip calls. May in the future be different from the stop in position 372-377. This difference is supported by Hafas (travel planner engine of Resrobot). Currently is an intermediate situation when both fields are used and the same value is written in both.

DAGKOMB +

DAGKOMB

N7

87-93

The weekdays this 36-post is valid.

FROMDATUM +

DATUM

N8

94-101

The first date this 36-post is valid.

TOMDATUM +

DATUM

N8

102-109

The last date this 36-post is valid.

DIREKT

DIREKT

A1

110

Value D denotes that a connection actually has through coaches into the other train.

AHPLTHMNR

THMNR

N3

111-113

The Company/owner/identifier of the stop number in next position. Must be the same as in the previous 20-post. 3 digit number.

AHPLNR

HPLNR

N6

114-119

Swedish train plan code if a trip actually calls at another stop. (Example: A replacement bus may perhaps not call at the train station). Rarely used.

FOTNOTSTEXT +

INFOTEXT

A252

120-371

Free text.

THMHPLNRBE +

HPLNR

N6

372-377

The stop value in previous 35-post this 36-post belongs to, confirming the T/F indication above.


37 - Trip qualities and characteristics


Train plan codes (according to announcement register and as defined in RDB) such as products, booking and comfort codes, as well as other codes which describe a certain trip are detailed in this post.

The codes will be defined in a special document, see also chapter 6.

Announcing reports REST and SERV are always placed in this post.

KVAR and LÄGG are connected to sleeping car. KVAR defines “Sleeping place available from xx.xx” and LÄGG “sleeping place available until xx.xx”. (NB not used for couchettes).


POSTTYP

POSTTYP

N2

1-2

’37’

Not used



3


FRÅNDYGN

DYGN

N1

4

Which of the trip’s 24 hour periods the 37 post starts to be valid. 1 or 2.

FRÅNKL

KLOCKSLAG

N4

5-8

The time the 37 post starts to be valid.

FRÅNHPLTHM

THMNR

N3

9-11

The Company/owner/identifier of the stop number in next position. Must be the same as in the preceding 30-post.

FRÅNHPLNR

HPLNR

N6

12-17

The stop number where the 37 post starts to be valid.

TILLDYGN

DYGN

N1

18

The trip’s 24 hour period the 37 post ends to be valid. 1 or 2.

TILLKL

KLOCKSLAG

N4

19-22

The time the 37-post ends to be valid.

TILLHPLTHM

THMNR

N3

23-25

The Company/owner/identifier of the stop number in next position. Must be the same as in the preceeding 30-post.

TILLHPLNR

HPLNR

N6

26-31

The last stop number where the 37-post is valid.

SJRAPP

SJRAPP

A4

32-35

Report according to announcement register

TYP +

TYP

A3

36-38

Type of code as defined in RDB system.

KOD +

KOD

A3

39-41

Train plan codes as defined in RDB system.

DAGKOMB

DAGKOMB

N7

42-48

The weekdays this 37 post is valid.

FROMDATUM

DATUM

N8

49-56

The first date this 37 post is valid.

TOMDATUM

DATUM

N8

57-64

The last date this 37 post is valid.


38 - Red departures

Deprecated / cannot be handled by Samtrafiken's systems.


39 - Timetable period post service exception

If the dates defined in the 32, 36 or 37 posts shall be adjusted they are defined in 39 posts. Modifcations are either cancellations or extra validity periods. Exceptions must be within the 32, 36 or 37 post’s period.

A 39 post can only exist directly after the 32, 36- or 37-post they belong to.

The type of adjustment, cancelled or extra, is defined in position 4 TURUNDTYP where

      “+” means the attribute validity is extra this day or for this period.

      “–“ means the attribute validity is excepted for this day or for this period.

Dates concerned are entered in position 5-12 FROMDATUM (Period starting date) and in position 13-20 TOMDATUM (Period ending date).

Example: An adjustment of only one date is written: 2012060120120601 (same date June 1st 2012 in both positions. A period is written for instance 2012060120130117 (meaning June 1st 2012 up to and including January 17th 2013.

The positions 21-38 are intended for the stop sequence concerned if not all of the stop sequence is concerned of the adjustment. However these positions are not yet in use since proper interpretation of the data may get rather complicated. 


POSTTYP

POSTTYP

N2

1-2

’39’

Not used



3


TURUNDTYP +

UNDTYP

A1

4

Value ‘+’ indicates 32-, 36- or 37-post is valid extra date(s), value ‘-‘ indicates 32-, 36- or 37-post is cancelled certain date(s).

FROMDATUM +

DATUM

N8

5-12

The first date the 32-, 36- or 37-post is valid/cancelled.

TOMDATUM +

DATUM

N8

13-20

The last date the 32-, 36- or 37-post is valid/cancelled.

FRÅNHPLTHM

THMNR

N3

21-23

Currently not in use, must not be used. The owner/country code of the stop number in next position.

FRÅNHPLNR

HPLNR

N6

24-29

Currently not in use and must not be used. The stop where the exception value starts to be valid.

TILLHPLTHM

THMNR

N3

30-32

Currently not in use and must not be used. The owner/country code  of the stop number in next position.

TILLHPLNR

HPLNR

N6

33-38

Currently not in use and must not be used. The last stop where the exception value is valid.


50 – Transfer time for traffic at a stop


This post refers to stops and can be utilised to steer connections between two trips. One stop may be entered in two or more 50 post in order to describe more complex rules for a stop.


POSTTYP

POSTTYP

N2

1-2

’50’

Not used



3


HPLTHMNR +

THMNR

N3

4-6

Same Company/PTA as the deliverer in 01-post who owns the definition of stop data in the following positions. 3-digit number.

KNUTHPLNR +

HPLNR

N6

7-12

Stop number.

FRÅNTHMNR +

THMNR

N3

13-15

Arriving company. Must not be 0 (zero).

TILLTHMNR +

THMNR

N3

16-18

Departing company. Must not be 0 (zero).

FRÅNTRAFME +

TRAFMEDEL

A1

19

Arriving vehicle class (i filer från RDB till TDB får värdet vara blank och räknas då som wildcard).

TILLTRAFME +

TRAFMEDEL

A1

20

Departing vehicle class (i filer från RDB till TDB får värdet vara blank och räknas då som wildcard).

FRÅNPRODUKT +

KOD

A3

21-23

Arriving product (i filer från RDB till TDB får värdet vara blank och räknas då som wildcard).

TILLPRODUKT +

KOD

A3

24-26

Departing product (i filer från RDB till TDB får värdet vara blank och räknas då som wildcard).

MINOVGTID +

MINUTER

N3

27-29

Minimum time in minutes transfer between two trips at this stop with regard to the different values.

MAXOVGTID

MINUTER

N3

30-32

Maximum time in minutes for transfer between two trips at this stop with regard to the different values.


51 - Transfer time for traffic between two stops

Refers to links between two stops.


POSTTYP

POSTTYP

N2

1-2

’51’

Not used



3


HPLTHMNR +

THMNR

N3

4-6

Same Company as the deliverer in 01-post who owns the definition of stop data in the following positions. 3-digit number.

Företagsnummer för hållplats där gånglänken startar. I exportfiler på ”Rikshållplatsnivå” skrivs iställetlandskod.

FRÅNHPLNR +

HPLNR

N6

7-12

From stop number (where the arriving trip calls and the (walking/taxi/...-)link starts).

Rikshållplatsnummer där gånglänken startar.

HPLTHMNR +

THMNR

N3

13-15

Same Company as the deliverer in 01-post who owns the definition of stop data in the following positions. 3-digit number.

Företagsnummerförhållplats där gånglänken slutar. I exportfiler på ”Rikshållplatsnivå” skrivs iställetlandskod.

TILLHPLNR +

HPLNR

N6

16-21

To stop number (where departing trip leaves and the (walking/taxi/...-)link ends).

Rikshållplatsnummer där gånglänken slutar.

MINOVGTID

MINUTER

N3

22-24

Minimum time in minutes for transfers between the trips at the two different stops with regard to the different values in this post.

Antal minuter gånglänken bedöms kräva.

Not used.


A3

25-27


FLYTTSÄTT

TRAFMEDEL

A1

28

Way of transfer between the stops. G = walking link, T = Taxi etcetera. See code list.

Flyttsätt. G= Gång, T = Taxi.

AVSTÅND

METER

N5

29-33

Distance between the stops.

Avstånd i meter.

FRÅNDATUM

DATUM

N8

34-41

Valid from this date YYYYMMDD (note: This position is not supported by Samtrafikens systems yet).

TILLDATUM

DATUM

N8

42-49

Valid until and including this date YYYYMMDD (note: This position is not supported by Samtrafikens systems yet).


60 - Stop zone


Name and definition of a stop zone.


POSTTYP

POSTTYP

N2

1-2

'60'

Not used

 

 

3


HPLTHMNR +

THMNR

N3

4-6

For national stop zones in Sweden '074'

HPLZONNR +

HPLNR

N6

7-12


ZONNAMN +

NAMN

A30

13-42

Written with upper case characters







61 – Stops included in a stop zone

Listing of the stops that form the stop zone in the 60 post. Repeated for every stop that is included in the same 60 post.


POSTTYP

POSTTYP

N2

1-2

'61'

Not used

 

 

3

 

HPLTHMNR +

THMNR

N3

4-6

For national stop in Sweden '074'

RHPLNR +

HPLNR

N6

7-12

The stop number included in a zone.


80 - Operator data


This post give details on each Operator as defined in 32 posts by each Company/PTA. The key is OPERBET.


POSTTYP +

POSTTYP

N2

1-2

’80’

Not used

 

 

3

 

THMNR +

THMNR

N3

4-6

Company number for the operator as defined in RDB

OPERBET +

OPERBET

A6

7-12

Code for the operator as defined in TDB.

OPERNAMN +

LÅNGNAMN

A40

13-52

Company name for the operator as defined in TDB

Not used

 

 

53-168


OPERLAND

LAND

A20

169-188

Country where the operator is located.

OPERTELE +

TELENR

A20

189-208

The telephone number traffic staff use when there is a traffic disturbance.


91 - Reserved


SSIM record type 1.

We cannot specify SSIM records in this document, since we might not be allowed to spread the SSIM-specification.

92 - Reserved


SSIM record type 2.

93 - Reserved


SSIM record type 3.

94 - Reserved

6. Types and Codes

In the Transport Format type (TYP) and code (KOD) form part of the different posts. These values undergo constant change due to changes in offerings from the different PTA. The actual types and codes are identified in the RDB, which gives details of the included products, vehicle classes, means of transport, accessibility, booking rules and comfort codes etc.

7. Additional information

A 20-post represents a line, and below/belonging to it are one or more 30-posts.

A 30-post represents a trip, and below/belonging to it are 34-, 35- and 36-posts.

The next 30-post indicates that the previous 30-post has ended, and represents an entirely different trip, with its own 34-, 35- and 36-posts. In the same way a new 20-post indincates that the previous 20-post has ended, and represents that a new line is being described.

36-post

The fields TYP and KOD is mandatory in the files that TDB receives from Samtrafiken.


37-post

The fields TYP och KOD is mandatory in the files that TDB receives from Samtrafiken.

If the post doesn’t contain either TYP or KOD but SJRAPP, then the post will be interpreted in a way that makes sense, but TDB will not accept/import those kind of files from Samtrafiken.


Encoding

ISO-8859-1.