Skip to end of banner
Go to start of banner

fares

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

This page is currently a work in progress and not yet included in the Nordic NeTEx Profile

Version

Current version for fares is:   v0.8   (last changed )

Content


This document is part of the Norwegian NeTEx Profile and describes data elements for the exchange of product and fare related information via the NeTEx format.

Please note the fare/sales-transaction parts of the profile describes data object for managing and exchanging fare structures, access rights, fare products, pricing, sales management/services, fare validation and consumption, as well as presentation of fare information to the traveling public. It does not, however, describe network or time-related concepts, such as topology, date objects or departure times, as these are described in their respective profile documents stops, network and timetable.

Components

Fare components

GeographicalUnit

A geographical interval specifying access rights for the FARE STRUCTURE ELEMENTs within the range of this interval: “20-5 km”, “4-6 zones”, etc.

GeographicalUnit < FareUnit < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

Distance

xsd:nonNegativeIntegerpric

0: 1

If distance based unit, length of unit

element

prices

GeographicalUnitPriceRef

0: *

Prices associated with GEOGRAPHICALUNIT

GeographicalInterval

A geographical interval specifying access rights for the FARE STRUCTURE ELEMENTs within the range of this interval: “20-5 km”, “4-6 zones”, etc.

GeographicalInterval < FareStructureFactor < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

StartGeographicalValue

xsd:decimal

0: 1

Start value for GEOGRAPHICAL INTERVAL

element

EndGeographicalValue

xsd:decimal

0: 1

End value for GEOGRAPHICAL INTERVAL

element

NumberOfUnits

xsd:integer

0: 1

Quantity of units in GEOGRAPHICAL INTERVAL

element

IntervalType

IntervalTypeEnum

0: 1

Classification of interval type

Allowed values:

  • coupon

  • distance

  • section

  • stop

  • tariffZone

  • tariffUnit ( mangler for "takstenhet", dvs ville vært hensiktsmessig med egen type for å modellere TEN/FEN )

element

prices

GeographicalIntervalPriceRef

0: *

Prices for GEOGRAPHICAL INTERVAL


TODO

Assess the use / necessity of GeographicalStructureFactor, given Fares profile v.1 will have pre-calculated fares

GeographicalStructureFactor

The value of a GEOGRAPHICAL INTERVAL or a DISTANCE MATRIX ELEMENT expressed by a GEOGRAPHICAL UNIT.

Example can be found in the official GitHub-repository for Entur

GeographicalStructureFactor < FareStructureFactor < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

DistanceMatrixElementRef

DistanceMatrixElementRef

0: 1

Reference to a DISTANCE MATRIX ELEMENT

element

GeographicalIntervalRef

GeographicalIntervalRef

0: 1

Reference to a GEOGRAPHICAL INTERVAL

element

GeographicalUnitRef

GeographicalUnitRef

0: 1

Reference to GEOGRAPHICAL UNIT

element

NumberOfUnits

xsd:integer

0: 1

Quantity of units.

element

AmountFactor

xsd:decimal

0: 1

Arbitrary amount factor associated with Factor

TimeInterval

A time-based interval specifying access rights for the FARE STRUCTURE ELEMENTs within the range of this interval: “0-1 hours,” “1-3 days”, etc.

Example can be found in the official GitHub-repository for Entur

TimeInterval < FareInterval < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

StartTime

xsd:time

0: 1

Start time of interval

element

EndTime

xsd:time

0: 1

End time of interval

element

Duration

xsd:duration

1: 1

Duration for the TimeInterval

DistanceMatrixElement

A cell of an origin-destination matrix for TARIFF ZONEs or STOP POINTs, expressing a fare distance for the corresponding trip: value in km, number of fare units etc.

Describes point to point or zone to zone fares, representing the fare between an origin and a destination pair, including its different routing constraint.

Example can be found in the official GitHub-repository for Entur

DistanceMatrixElement < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

Distance

DistanceType

0: 1

Distance between origin and destination of a DISTANCE MATRIX ELEMENT

element

RelativeRanking

xsd:integer

0: 1

Relative preference assigned to this element if there are multiple entries between two points

element

IsDirect

xsd:boolean

0: 1

Whether journey is direct or requires changes

element

InverseAllowed

element

0: 1

Whether an inverse element in the opposite direction with the same prices may be assumed – optimisation to reduce data volumes

(choice) element

StartStopPointRef

ScheduledStopPointRef

1: 1

Start SCHEDULED STOP POINT at which a DISTANCE MATRIX ELEMENT begins.

StartTariffZoneRef

TariffZoneRef

Start TARIFF ZONE at which a DISTANCE MATRIX ELEMENT begins

StartFareSectionRef

FareSectionRef

Start FARE SECTION at which a DISTANCE MATRIX ELEMENT begins

(choice) element

EndStopPointRef

ScheduledStopPointRef

1: 1

End SCHEDULED STOP POINT at which a DISTANCE MATRIX ELEMENT ends

EndTariffZoneRef

TariffZoneRef

Final TARIFF ZONE at which a DISTANCE MATRIX ELEMENT ends

StartFareSectionRef

FareSectionRef

End FARE SECTION at which a DISTANCE MATRIX ELEMENT ends

element

prices

DistanceMatrixElementPriceRef

0: 1

A set of all possible price features of a DISTANCE MATRIX ELEMENT: default total price etc.

FareDemandFactor (todo)

Timeband (todo)

Controllable elements

FareStructureElement

A sequence or set of CONTROLLABLE ELEMENTs to which rules for limitation of access rights and calculation of prices (fare structure) are applied.

Example can be found in the official GitHub-repository for Entur

FareStructureElement < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

TariffBasis

TariffBasisEnumeration

0: 1

TARIFF BASIS to be used for the element

Allowed values:

  • flat

  • distance

  • route

  • zone

  • period

  • tour

  • group

(choice) element

validityParameterAssignments

GenericParameterAssignment

1: *

VALIDITY (i.e. GENERIC) PARAMETER ASSIGNMENTs for an element

fareStructureElementsInSequence

FareStructureElementInSequence

Use of FARESTRUCTURE ELEMENTs in a particular sequence

element

prices

FareStructureElementPriceRef

0: *

A set of all possible price features of a FARE STRUCTURE ELEMENT: default total price, discount in value or percentage etc.

FareStructureElementInSequence

A FARE STRUCTURE ELEMENT as a part of a VALIDABLE ELEMENT, including its possible order in the sequence of FARE STRUCTURE ELEMENTs forming that VALIDABLE ELEMENT, and its possible quantitative limitation.

Example can be found in the official GitHub-repository for Entur

FareStructureElementInSequence < FareElementInSequence < VersionedChild < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

FareStructureElementRef

FareStructureElementRef

0: 1

Reference to a FARE STRUCTURE ELEMENT

element

ValidableElementRef

FareStructureElementRef

0: 1

Reference to a VALIDABLE ELEMENT

We do currently not want to allow "backwards" referencing

element

validityParameterAssignments

ValidityParameterAssignment

0: *

VALIDITY PARAMETER ASSIGNMENTs associated with the ELEMENT IN SEQUENCE

Should be assigned in the referred GenericParameterAssignment(s), NOT contained as part of the sequence

GenericParameterAssignment

A VALIDITY PARAMETER ASSIGNMENT specifying generic access rights for a class of products. May include alternatives from which a purchaser selects.

Example can be found in the official GitHub-repository for Entur

GenericParameterAssignment < ValidityParameterAssignment < AccessRightParameterAssignment < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

TypeOfAccessRightAssignmentRef

TypeOfAccessRightAssignmentRef

0: 1

Classification of ACCESS RIGHT PARAMETER ASSIGNMENT

element

LimitationGroupingType

LogicalOperationEnumeration

0: 1

Logical operator for combining USAGE PARAMETERs elements. The default is ‘AND’.

‘OR’ and ‘XOR’ should only be used if parameters are all of the same type

Allowed values:

  • AND (default, i.e. interpreted as such if not stated) = 
    Successive elements are logically ANDed together; comparison must satisfy all specified values

  • OR =
    Successive elements are logically ORed together; comparison must satisfy at least one specified value

  • NOT =
    Specified elements must be different from the given value

  • XOR =
    Successive elements are logically ORed together; comparison must satisfy only one of the specified values

NOR / NAND må legges til?

element

LimitationSetSelectionType

SetOperatorEnumeration

0: 1

Where one or more parameter is a group containing multiple elements, (GROUP OF xxx), set operator for distinguishing between whole set and item interpretation of elements which are sets of elements

I.e. only to be used in relation to GroupOf… parameters, not to evaluate combinations of singular parameters

Allowed values:

  • oneOfAnyOneSet
    (only one item from all  referenced GROUPs OF ENTITies of a given type may be selected/has been selected)

  • oneOfEachSet
    (one item from each specified referenced GROUP OF ENTITies of a given type shall be selected/has been selected)

  • someOfAnySet
    (multiple items from any referenced GROUP OF ENTITies of a given type may be selected/have been selected)

  • allOfOneSet
    (all items from one specified  referenced GROUP OF ENTITies of a given type may be selected/have been selected)

  • allOfAllSets
    (all items from all  referenced GROUPs OF ENTITies of a given type may be selected/have been selected)

element

limitations

UsageParameter

1: *

Limitations (i.e. limitation of use) for the assignment

element

ValidityParameterAssignmentType

RelativeOperatorEnumeration

0: 1

Comparison operator for matching validity parameter values

Allowed values:

  • EQ (default) = 
    Equal (parameter value must have the same identity, or have a value equal to a quantitative value associated with the specified item)

  • NE =
    Not Equal (parameter value must not have the same identity, or have a value different from a quantitative value associated with the specified item)

  • GT =
    Greater than (parameter value must be greater than a quantitative value associated with the specified item)

  • GE = 
    Greater than or equal (parameter value must be greater than or equal to a quantitative value associated with the specified item)

  • LT =
    Less than (parameter value must be less than a quantitative value associated with the specified item)

  • LE = 
    Less than or equal (parameter value must be less than or equal to a quantitative value associated with the specified item)

element

ValidityParameterGroupingType

LogicalOperationEnumeration

0: 1

Logical operator for combining network validity parameters, e.g. ‘AND’ / ‘OR’ / ‘NOT’ / ‘XOR’

Allowed values:

  • AND (default, i.e. interpreted as such if not stated) = 
    Successive elements are logically ANDed together; comparison must satisfy all specified values

  • OR =
    Successive elements are logically ORed together; comparison must satisfy at least one specified value

  • NOT =
    Specified elements must be different from the given value

  • XOR =
    Successive elements are logically ORed together; comparison must satisfy only one of the specified values

NOR / NAND må legges til?

element

ValidityParameterSetSelectionType

SetOperatorEnumeration

0: 1

Where one or more parameter is a group containing multiple elements, (GROUP OF xxx), set operator for distinguishing between whole set and item interpretation of elements which are sets of elements

I.e. only to be used in relation to GroupOf… parameters, not to evaluate combinations of singular parameters

Allowed values:

  • oneOfAnyOneSet
    (only one item from all  referenced GROUPs OF ENTITies of a given type may be selected/has been selected)

  • oneOfEachSet
    (one item from each specified referenced GROUP OF ENTITies of a given type shall be selected/has been selected)

  • someOfAnySet
    (multiple items from any referenced GROUP OF ENTITies of a given type may be selected/have been selected)

  • allOfOneSet
    (all items from one specified  referenced GROUP OF ENTITies of a given type may be selected/have been selected)

  • allOfAllSets
    (all items from all  referenced GROUPs OF ENTITies of a given type may be selected/have been selected)

element

temporalValidityParameters

TemporalValidityParameter

Not yet defined allowed validity parameters

See proposal (TEMPORARY - Unused NeTEx Fares (Fare and SalesTransaction frames) data objects) and NeTEx part 3 part "7.6.1.2 Validity Parameters" (page 200->)

1: *

Temporal validity parameters for the assignment (e.g. OperatingDay)

element

validityParameters

ValidityParameter

Not yet defined allowed validity parameters

See proposal (TEMPORARY - Unused NeTEx Fares (Fare and SalesTransaction frames) data objects) and NeTEx part 3 part "7.6.1.2 Validity Parameters" (page 200->)

1: *

Validity parameters for the assignment (e.g. ServiceFacilities)

element

TimeIntervalRef

TimeIntervalRef

0: 1

References to TIME INTERVALS pertaining to FARE STRUCTURE ELEMENT

element

GeographicalIntervalRef

GeographicalIntervalRef

0: 1

References to GEOGRAPHICAL INTERVALS pertaining to FARE STRUCTURE ELEMENT

element

QualityStructureFactorRef

QualityStructureFactorRef

0: 1

References to QUALITY STRUCTURE FACTORs pertaining to FARE STRUCTURE ELEMENT

element

IncludesGroupingType

LogicalOperationEnumeration

0: 1

Logical operator for combining included elements, i.e. nesting of GenericParameterAssignment. The default is ‘OR’.

Allowed values:

  • OR (default, i.e. interpreted as such if not stated) =  
    Successive elements are logically ORed together; comparison must satisfy at least one specified value

  • AND  = 
    Successive elements are logically ANDed together; comparison must satisfy all specified values

  • NOT =
    Specified elements must be different from the given value

  • XOR =
    Successive elements are logically ORed together; comparison must satisfy only one of the specified values

NOR / NAND må legges til?

element

includes

GenericParameterAssignmentInContext

0: *

A list of VALIDITY PARAMETER ASSIGNMENT without ID constraing used only in the given context specifying practical parameters during a TRAVEL GenericATION, within a given fare structure (e.g. the origin or destination zone in a zone-counting system)

ValidableElement

A sequence or set of FARE STRUCTURE ELEMENTs, grouped together to be validated in one go.

Example can be found in the official GitHub-repository for Entur

ValidableElementPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

fareStructureElements

FareStructureElement

1: *

FARE STRUCTURE ELEMENTs making up VALIDABLE ELEMENT.

element

prices

FareStructureElementPriceRef

0: *

A set of all possible price features of a FARE STRUCTURE ELEMENT: default total price, discount in value or percentage etc.

TemporalValidityParameters

Temporal Validity parameters for the assignment.

Example can be found in the official GitHub-repository for Entur

TemporalValidityParameters

XML-type

Name

Datatype

Cardinality

Description

element

DayTypeRef

DayTypeRef

0: 1

Reference to a DAY TYPE

element

OperatingDayRef

OperatingDayRef

0: 1

Reference to a OPERATING DAY

(choice) element

ValidityConditionRef

ValidityConditionRef

0: 1

Reference to a VALIDITY CONDITION

Reference to a AVAILABILITY CONDITION

ValidityParameters

Validity parameters for the assignment.

NB: Different from most NeTEx reference strings, the AllAuthoritiesRef and AllOperatorsRef references have a fixed value (e.g. "All")

Example can be found in the official GitHub-repository for Entur

ValidityParameters

XML-type

Name

Datatype

Cardinality

Description

(choice) element

ValidityConditionRef

ValidityConditionRef

0: *

Reference to a VALIDITY CONDITION

AvailabilityConditionRef

AvailabilityConditionRef

Reference to a AVAILABILITY CONDITION

DistributionChannelRef

DistributionChannelRef

Reference to a DISTRIBUTION CHANNEL

GroupOfDistributionChannelsRef

GroupOfDistributionChannelsRef

Reference to a GROUP OF DISTRIBUTION CHANNELS

NetworkRef

NetworkRef

Reference to a NETWORK

LineRef

LineRef

Reference to a LINE

ServiceJourneyRef

ServiceJourneyRef

Reference to a SERVICE JOURNEY

StopPlaceRef

StopPlaceRef

Reference to a STOP PLACE

TypeOfTravelDocumentRef

TypeOfTravelDocumentRef

Reference to a TYPE OF TRAVEL DOCUMENT

FareZoneRef

FareZoneRef

Reference to a FARE ZONE

Dobbelsjekk: Bruker PoP konsekvent FARE zone eller TARIFF zone!? (dette må avspeiles her)

ClassOfUseRef

ClassOfUseRef

Reference to a CLASS OF USE

AuthorityRef

AuthorityRef

Reference to a AUTHORITY

OperatorRef

OperatorRef

Reference to a OPERATOR

AllAuthoritiesRef

AllAuthoritiesRef

Always "All"

AllOperatorsRef

AllOperatorsRef

Always "All"

element

VehicleModes

VehicleModeEnumeration

0: *

List of relevant VEHICLE MODES (one or more can be entered within the element, or as separate elements)

Allowed values:

  • air

  • bus

  • cableway

  • coach

  • funicular

  • metro

  • rail

  • taxi

  • tram

  • water

element

TransportSubmode

xsd:boolean

0: *

A submode of a Public Transport MODE

See framework for maintained list of supported modes and their allowed submode values

Each TransportSubmode must consist of only one submode element and its submode value (cardinality 1: 1)

Example:
<TransportSubmode>
  <AirSubmode>domesticFlight</AirSubmode>
</TransportSubmode>

However, multiple TransportSubmode container elements can be added in the same ValidityParameter

Usage Parameters

UsageParameter

Abstract parameter type specifying the use of a SALES OFFER PACKAGE or a FARE PRODUCT.

See definition in General information

UsageParameter < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

prices

UsageParameterPriceRef

0: *

Prices associated with USAGE PARAMETER

UserProfile

The social profile of a passenger, based on age group, education, profession, social status, sex etc., often used for allowing discounts: 18-40 years old, graduates, drivers, unemployed, women etc.

Example can be found in the official GitHub-repository for Entur

UserProfile < UsageParameter < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

TypeOfConcessionRef

TypeOfConcessionRef

0: 1

Classification by type of concession (eligibility for discount)

TypeOfConcession defineres som et ValueSet (i ResourceFrame) for å gruppere/kategorisere passasjerer som kvalifiserer til rabatt, men datatypen inneholder i praksis kun fritekst-beskrivelser og er lite egnet for kategorisering. Gir upresis klassifisering av data og anbefales derfor ikke å bruke.

element

UserType

UserTypeEnumeration

1: 1

User types

Allowed values:

  • adult (normally equal to "anyone")

  • animal

  • anyone (normally equal to "adult")

  • child

  • disabled

  • disabledCompanion

  • employee

  • infant

  • jobSeeker

  • military

  • schoolPupil

  • senior

  • student

  • youngPerson

element

MinimumAge

xsd:integer

0: 1

Minimum age to be eligible for profile

element

MaximumAge

xsd:integer

0: 1

Maximum age to be eligible for profile

element

ProofRequired

ProofOfIdentityEnumeration

0: 1

Type of proof required

Allowed values:

  • noneRequired

  • creditCard

  • passport

  • drivingLicence

  • membershipCard

  • identityDocument

  • medicalDocument

  • studentCard

  • letterWIthAddress

  • measurement

element

DiscountBasis

DiscountBasisEnumeration

0: 1

Discount for this profile.

Allowed values:

  • none

  • free

  • discount

element

CompanionProfileRef

CompanionProfileRef

0: 1

COMPANION PROFILEs describing users who may travel with user

UsageValidityPeriod

A time limitation for validity of a FARE PRODUCT or a SALES OFFER PACKAGE. It may be composed of a standard duration (e.g. 3 days, 1 month) and/or fixed start/end dates and times.

Example can be found in the official GitHub-repository for Entur

UsageValidityPeriod < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

UsageValidityType
ValidityType

ValidityPeriodType


UsageValidityTypeEnumeration

0: 1

Type of usage validity Period

Allowed values (NB: XSD does not match spec, hence this list complies to XSD):

  • singleRide

  • singleTrip

  • returnTrip

  • carnet (a fixed number of individual trips)

  • dayPass

  • weeklyPass

  • weekendPass

  • monthlyPass

  • annualPass

  • seasonTicket

  • profileMembership

  • openEnded

element

UsageTrigger

UsageTriggerEnumeration

0: 1

Trigger event that starts validity period

Allowed values:

  • startOfPeriod

  • startOutboundRide

  • endOutboundRide

  • startReturnRide

  • purchase

  • specifiedStartDate

  • fulfilment

  • dayOffsetBeforeCalendarPeriod

element

UsageEnd

UsageEndEnumeration

0: 1

Classification of when the end of the Usage validity period occurs. May be a specified period (Standard Duration) or an event, e.g. end of trip

Allowed values:

  • standardDuration

  • endOfCalendarPeriod

  • endOfRide

  • endOfTrip

  • endOfFareDay

  • endOfFarePeriod

  • productExpiry

  • profileExpiry

(choice)

element

StandardDuration

xsd:duration

0: 1

Duration of VALIDITY PERIOD after departure. or validation

SteppedDuration

SteppedDuration

0: 1

Duration of VALIDITY PERIOD expressed by steps traveled

element

ActivationMeans

ActivationMeansEnumeration

0: 1

Means of activatiing start of period

SteppedDuration

Duration of VALIDITY PERIOD expressed by steps traveled

Example can be found in the official GitHub-repository for Entur

SteppedDuration

XML-type

Name

Datatype

Cardinality

Description

element

InitialStepDuration

xsd:duration

1

Duration of first step

element

SubsequentStepsDuration

xsd:duration

1

Duration of subsequent steps

element

MaximumDuration

xsd:duration

0: 1

Maximum duration (upper limit for total duration)

element

StepUnit

StepLimitUnitEnumeration

1

Unit in which steps are counted

Allowed values for StepLimitUnitEnumeration:

  • stops

  • stopsIncludingPassThroughStops

  • sections

  • zones

  • networks

  • operators

  • countries

Suspending

Conditions governing temporary suspension of a FARE PRODUCT, (i.e. period pass or subscription).

Example can be found in the official GitHub-repository for Entur

Suspending < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

SuspensionPolicy

SuspensionPolicyListOfEnumerations

0: 1

Policies for suspending term of product

Allowed values (multiple can be used simultaneously):

  • forCertifiedIllness

  • forParentalLeave

  • forHoliday

  • forAnyReason

  • necessary to add further?

element

QualificationPeriod

xsd:duration

0: 1

Minimum duration that shall have occurred before a suspension is allowed

element

MinimumSuspensionPeriod

xsd:duration

0: 1

Minimum duration allowed for a suspension

element

MaximumSuspensionPeriod

xsd:duration

0: 1

Maximum duration allowed for a suspension

element

MaximumNumberOfSuspensionsPerTerm

xsd:nonNegativeInteger

0: 1

Maximum number of suspensions for the related term

RoundTrip

Properties relating to single or return trip use of an access right.

Example can be found in the official GitHub-repository for Entur

RoundTrip < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

TripType

RoundTripTypeEnumeration

0: 1

Type of trip

Allowed values:

  • single (default)

  • return (outbound and return)

  • returnOut (outbond part)

  • returnBack (return part)

  • multiple

  • returnOnly

element

DoubleSingleFare

xsd:boolean

0: 1

Whether fare for return trip is simply double the single fare

element

IsRequired

xsd:boolean

0: 1

Whether return trip is required

FrequencyOfUse

The limits of usage frequency for a FARE PRODUCT (or one of its components) or a SALES OFFER PACKAGE during a specific VALIDITY PERIOD. There may be different tariffs depending on how often the right is consumed during the period.

Example can be found in the official GitHub-repository for Entur

FrequencyOfUse < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

FrequencyOfUseType

FrequencyOfUseTypeEnumeration

0: 1

Type of Frequency of Use

Allowed values:

  • single (default)

  • none (i.e. no interchange allowed)

  • limited

  • unlimited

  • twiceADay

  • twiceADay

element

MinimalFrequency

xsd:integer

0: 1


element

MaximalFrequency

xsd:integer

0: 1

Duration of VALIDITY PERIOD after departure. or validation

Interchanging

Limitations on making changes within a trip.

Example can be found in the official GitHub-repository for Entur

Interchanging < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

CanInterchange

xsd:boolean

0: 1

Whether an interchange can be made

element

FromMode

VehicleModeEnumeration

0: 1

Mode from which interchange is made

Allowed values:

  • air

  • bus

  • coach

  • metro

  • rail

  • tram

  • water

  • cableway

  • funicular

element

ToMode

VehicleModeEnumeration

0: 1

Mode to which interchange is made

Allowed values:

  • air

  • bus

  • coach

  • metro

  • rail

  • tram

  • water

  • cableway

  • funicular

element

MaximumNumberOfInterchanges

xsd:integer

0: 1

Maximum number of  interhanges between SERVICE JOURNEYs that can be made in a single TRIP

element

MaximumTimeToMakeATransfer

xsd:duration

0: 1

Maximum time to transfer between SERVICE JOURNEYs in a single TRIP

element

CanBreakJourney

xsd:boolean

0: 1

Whether the journey can be broken at an interchange point

element

CrossBorder

xsd:boolean

0: 1

Whether interchanging crosses a border
Whether interchanging is allowed to cross a border

LuggageAllowance

Period in which the product can be purchased.

Example can be found in the official GitHub-repository for Entur

LuggageAllowance < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

BaggageUseType

BaggageUseTypeEnumeration

0: 1

Type of Baggage use

Allowed values:

  • carryOn

  • checkIn

  • oversizeCheckIn

  • baggageCompartment

element

BaggageType

BaggageTypeEnumeration

0: 1

Type of Baggage described by allowance

Allowed values:

  • animal

  • bicycle

  • game

  • handbag

  • handLuggage

  • largeMotorizedWheelchair

  • motorcycle

  • motorizedWheelchair

  • musicalnstrument

  • oversizeItem

  • pushChair

  • skis

  • smallAnimal

  • smallSuitcase

  • sportingEquipment

  • suitcase

  • trunk

  • wheelchair

element

LuggageAllowanceType

LuggageAllowanceTypeEnumeration

0: 1

Classification of allowance type

Allowed values:

  • none

  • limited

  • singleBag

  • unlimited

element

MaximumNumberItems

xsd:nonNegativeInteger

0: 1

Number of items allowed for this allowance

element (x4, possibly)

Relevant to add?

  • MaximumBagHeight

  • MaximumBagWidth

  • MaximumBagDepth

  • MaximumBagWeight

type

0: 1

Maximum bag ...

element

TotalWeight

xsd:decimal

0: 1

Total maximum weight limit (in kilograms) for this allowance

element

LuggageChargingBasis

LuggageChargingBasisEnumeration

0: 1

Basis on which luggage is charged

Allowed values:

  • free

  • chargedByItem (per colli)

  • chargedByWeight (total weight)

PurchaseWindow

Period in which the product can be purchased.

Example can be found in the official GitHub-repository for Entur

PurchaseWindow < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

PurchaseAction

PurchaseActionEnumeration

1: 1

Action governed by Purchase Window

Allowed values:

  • purchase (default)

  • reserve

element

PurchaseWhen

PurchaseWhenEnumeration

1: 1

When purchase may be made

Allowed values:

  • advanceAndDayOfTravel (default)

  • advanceOnly

  • dayOfTravelOnly

  • timeOfTravelOnly

  • untilPreviousDay

element

LatestTime

xsd:time

0: 1

Latest time on specified last day when ticket can be purchased

element

MinimumPeriodBeforeDeparture

xsd:duration

0: 1

Minimum duration before departure that ticket may be purchased

element

MaximumPeriodBeforeDeparture

xsd:duration

0: 1

Maximum duration before departure that ticket may be purchased

element

PurchaseMoment

PurchaseMomentListOfEnumerations


Permitted moments of purchase

Allowed values (multiple can be used simultaneously):

  • inAdvance

  • beforeBoarding

  • afterBoarding

  • onCheckIn

  • onReservation

Reserving

Indicating whether the access right requires reservation and any limitations on making and changing reservations.

Example can be found in the official GitHub-repository for Entur

Reserving < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

BookingArrangements

BookingArrangementsStructure

0: 1

Booking Arrangements for cancellations

See NeTEx part 3 chapter 7.6.1.3.9.2 Reserving – Model Element / Table 189 – Reserving – Element if further elements e.g. related to reservation fees are relevant

Cancelling

Requirements for cancelling a booking.

Example can be found in the official GitHub-repository for Entur

Cancelling < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

BookingArrangements

BookingArrangementsStructure

0: 1

Booking Arrangements for cancellations

ChargingPolicy 

Policy regarding different aspects of charging such as credit limits.

Example can be found in the official GitHub-repository for Entur

ChargingPolicy < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

CreditPolicy

TravelCreditPolicyEnumeration

0: 1

Policy for traveling on credit

Allowed values:

  • allowTravel

  • blockPayAsYouGoTravel

  • blockAllTravel

element

BillingPolicy

TravelBillingPolicyEnumeration

0: 1

Policy for billing frequency

Allowed values:

  • billAsYouGo

  • billOnThreshold

  • billAtFareDayEnd

  • billAtPeriodEnd

PenaltyPolicy 

Policy regarding different aspects of penalty charges, for example repeated entry at the same station, no ticket etc.

Example can be found in the official GitHub-repository for Entur

PenaltyPolicy < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

PenaltyPolicyType

PenaltyPolicyTypeEnumeration

0: 1

Classification of Penalty Policy

Allowed values:

  • noTicket

  • noValidation

  • noCheckin

  • noCheckout

element

PenaltyAction

(forslag til NeTEx utvidelse)

PenaltyActionEnumeration

(forslag til NeTEx utvidelse, dvs inkl ny enumeration)

1: 1

Classification of Penalty Action

Allowed values:

  • fine

  • ...??? (må revideres)

element

PaymentMethod

(forslag til NeTEx utvidelse, bør implementeres som liste slik at det fungerer å legge inn flere betalingsalternativer per policy)

PaymentMethodListOfEnumerations

0: 1

Available penalty payment methods

Allowed values (forløpig listet opp alle som eksisterer for objektet):

  • cash

  • cashAndCard

  • coin

  • banknote

  • cheque

  • travellersCheque

  • postalOrder

  • companyCheque

  • creditCard

  • debitCard

  • cardsOnly

  • travelCard

  • contactlessPaymentCard

  • contactlessTravelCard

  • directDebit

  • bankTransfer

  • sms

  • mobilePhone

  • voucher

  • token

  • warrant

  • mileagePoints

  • ...??? (må revideres)

Subscribing 

Parameters governing subscription to a product allowing payment at regular intervals.

Example can be found in the official GitHub-repository for Entur

Subscribing < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

SubscriptionTermType

SubscriptionTermTypeEnumeration

0: 1

Types of subscription term allowed

 Allowed values:

  • fixed

  • openEnded

element

MinimumSubscriptionPeriod

xsd:duration

0: 1

Minimum duration allowed for a subscription

element

MaximumSubscriptionPeriod

xsd:duration

0: 1

Maximum duration allowed for a subscription

element

SubscriptionRenewalPolicy

SubscriptionRenewalPolicyEnumeration

0: 1

Policy on renewing subscription

 Allowed values:

  • automatic

  • manual

  • none (for termination of subscription type)

element

possibleInstallmentIntervals

TimeIntervalRef

0: *

Allowed billing Intervals for payment in instalment

element

InstallmentPaymentMethods

PaymentMethodListOfEnumerations

0: 1

Allowed means of payment of installations as standard value

 Allowed values (multiple can be used simultaneously):

  • bankTransfer

  • creditCard

  • debitCard

  • travelCard

  • sms

GroupTicket

The number and characteristics of persons entitled to travel in addition to the holder of an access right.

Example can be found in the official GitHub-repository for Entur

GroupTicket < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

MinimumNumberOfPersons

xsd:integer

0: 1

Minimum number of persons overall allowed on ticket

element

MaximumNumberOfPersons

xsd:integer

0: 1

Maximum number of persons overall allowed on ticket

element

companionProfiles

CompanionProfileRef

0: *

The number and characteristics of a category of users allowed on the ticket

element

PricingBasis

PricingBasisEnumeration

0: 1

Discount for this profile.

Allowed values:

  • perOffer

  • perPerson

element

JointCheckIn

GroupCheckInEnumeration

0: 1

Whether the group must check in together

Allowed values:

  • none

  • required

  • allowed

element

GroupBookingFacility

GroupBookingEnumeration

0: 1

Classification of GROUP FACILITY type (TPEG pti23)

Allowed values:

  • groupsAllowed

  • groupsNotAllowed

  • groupsAllowedWithReservation

  • groupBookingsRestricted

CompanionProfile

The COMPANION PROFILE specifies the number and characteristics of persons entitled to travel in addition to the holder of an access right, for example children, wheelchair carer, etc.

Example can be found in the official GitHub-repository for Entur

CompanionProfile < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

CompanionRelationshipType

CompanionRelationshipEnumeration

1: 1

Required Relationship of companion to eligible user

Allowed values:

  • anyone

  • carer

  • child

  • dependent

  • family

  • partner

  • teacher

  • pupil

element

MinimumNumberOfPersons

xsd:integer

0: 1

Minimum number of persons overall allowed of this type

element

MaximumNumberOfPersons

xsd:integer

0: 1

Maximum number of persons overall allowed of this type

element

DiscountBasis

DiscountBasisEnumeration

0: 1

Nature of discount for this type of user

Allowed values:

  • none

  • free

  • discount

CommercialProfile

A category of users depending on their commercial relations with the operator (frequency of use, amount of purchase etc.), often used for allowing discounts.

Example can be found in the official GitHub-repository for Entur

CommercialProfile < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

CommercialProfile inherits from UsageParameter without introducing new elements or attributes.

Transferability

The number and characteristics of persons entitled to use the public transport service instead of the original customer.

Example can be found in the official GitHub-repository for Entur

Transferability < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

CanTransfer

xsd:boolean

0: 1

Whether ticket can be transferred to someone else

element

MaximumNumberOfNamedTransferees

xsd:nonNegativeInteger

0: 1

Where a product can be used by a limited number of named users, maximum number of users allowed.

element

HasTransferFee

xsd:boolean

0: 1

Whether there is a fee for a refund or exchange

element

SharedUsage

ResellWhenEnumeration

0: 1

Indicates the nature of the permitted sharing, if any, of products that can be shared, e.g. Trips from a multi-trip carnet

 Allowed values:

  • singleUser

  • concurrentUsers (multiple users at the same time)

  • concurrentDesignatedUsers (multiple users at the same time, but only designated companions)

Reselling

Common resale conditions (i.e. for exchange or refund) attaching to the product.

Example can be found in the official GitHub-repository for Entur

Reselling < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

Allowed

ResellTypeEnumeration

0: 1

Whether exchange or refund is allowed

Allowed values:

  • none

  • partial

  • full

element

UnusedTicketsOnly

xsd:boolean

0: 1

Whether it is possible to exchange partially used tickets

element

HasFee

xsd:boolean

0: 1

Whether there is a fee for a refund or exchange

element

ExchangeableFromDuration

xsd:duration

0: 1

Duration to start of period before (negative) or after (positive) the trigger point (i.e. either Start Of Validity or First Use) or that ticket may be exchanged or refunded

element

ExchangeableUntilDuration

xsd:duration

0: 1

Duration to end of period before (negative) or after  (positive) the trigger point (i.e. either Start Of Validity or First Use) that ticket may be exchanged or refunded

element

ResellWhen

ResellWhenEnumeration

0: 1

Event marking when the exchangeable status of the ticket changes

 Allowed values (NB: XSD does not match spec, hence this list complies to XSD):

  • never

  • beforeFirstUse

  • afterFirstUse

  • beforeStartOfValidity

  • afterStartOfValidity

  • afterEndOfValidity

  • beforeValidation

  • afterValidation

  • anyTime

Refunding

Whether and how the product may be refunded.

Example can be found in the official GitHub-repository for Entur

Refunding < Reselling < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

Allowed

ResellTypeEnumeration

0: 1

Whether exchange or refund is allowed

Allowed values:

  • none

  • partial

  • full

element

CanChangeClass

xsd:boolean

0: 1

Whether user can change class

element

UnusedTicketsOnly

xsd:boolean

0: 1

Whether it is possible to exchange partially used tickets

element

ResellWhen

ResellWhenEnumeration

0: 1

Event marking when the is exchangable status of the ticket changes

Allowed values:

  • never

  • beforeStartOfValidity

  • afterStartOfValidity

  • afterEndOfValidity

  • beforeFirstUse

  • afterFirstUse

  • beforeValidation

  • afterValidation

  • anyTime

  • afterSale (tillegg)

Må revideres - NB: "afterSale" finnes (foreløpig) ikke i enum'en

element

ExchangableFromDuration

xsd:duration

0: 1

Duration to start of period before (negative) or after (positive) the trigger point (i.e. either Start of Validity or First Use ) or that ticket

element

ExchangableUntilDuration

xsd:duration

0: 1

Duration to end of period before (negative) or after (positive) the trigger point (i.e. either Start of Validity or First Use ) or that ticket

element

HasFee

xsd:boolean

0: 1

Whether there is a feed for reselling

element

RefundBasis

PerBasisEnumeration

0: 1

Basis for which refund is given

AllowedValues:

  • perOffer

  • perPerson

element

RefundType

RefundTypeEnumeration

0: 1

Type of Refund

Allowed values:

  • unused

  • delay

  • cancellation

  • partialJourney

NB: Kun mulig å angi én (mulig workaround å definere redundante Refund-objekter)

element

PaymentMethod

PaymentMethodListOfEnumerations

0: 1

Payment methods allowed to make refund

Allowed values:

  • cash

  • cashAndCard

  • coin

  • banknote

  • cheque

  • travellersCheque

  • postalOrder

  • companyCheque

  • creditCard

  • debitCard

  • cardsOnly

  • travelCard

  • contactlessPaymentCard

  • contactlessTravelCard

  • sms

  • mobilePhone

  • voucher

  • token

  • warrant

Må revideres! NB: Kun mulig å angi én (noen dekker riktignok flere case... mulig workaround å definere redundante Refund-objekter)

Exchanging

Whether and how access rights may be exchanged for other access rights.

Example can be found in the official GitHub-repository for Ent

Exchanging < Reselling < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

Allowed

ResellTypeEnumeration

0: 1

Whether exchange or refund is allowed

Allowed values:

  • none

  • partial

  • full

element

UnusedTicketsOnly

xsd:boolean

0: 1

Whether it is possible to exchange partially used tickets

element

HasFee

xsd:boolean

0: 1

Whether there is a fee for a refund or exchange

element

ExchangeableFromDuration

xsd:duration

0: 1

Duration to start of period before (negative) or after (positive) the trigger point (i.e. either Start Of Validity or First Use) or that ticket may be exchanged or refunded

element

ExchangeableUntilDuration

xsd:duration

0: 1

Duration to end of period before (negative) or after  (positive) the trigger point (i.e. either Start Of Validity or First Use) that ticket may be exchanged or refunded

element

ResellWhen

ResellWhenEnumeration

0: 1

Event marking when the exchangeable status of the ticket changes

 Allowed values (NB: XSD does not match spec, hence this list complies to XSD):

  • never

  • beforeFirstUse

  • afterFirstUse

  • beforeStartOfValidity

  • afterStartOfValidity

  • afterEndOfValidity

  • beforeValidation

  • afterValidation

  • anyTime

element

NumberOfExchangesAllowed

xsd:integer

0: 1

Whether it is possible to exchange partially used tickets

element

ToFareClass

FareClassEnumeration

0: 1

Fare class to which can be exchanged.

 Allowed values:

  • any

  • businessClass

  • economyClass

  • firstClass

element

ExchangeableTo

ExchangableToEnumeration

0: 1

Type of exchange allowed. The default is ‘anyProduct’, i.e. to any other fare.

 Allowed values:

  • anyProduct

  • sameProductSameDay

  • sameProductAnyDay

  • upgradeToStandardFare

  • upgradeToSpecifiedFare

Replacing

Whether and how access rights may be replaced if lost or stolen.

Example can be found in the official GitHub-repository for Entur

Replacing < Reselling < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

Allowed

ResellTypeEnumeration

0: 1

Whether exchange or refund is allowed

Allowed values:

  • none

  • partial

  • full

element

UnusedTicketsOnly

xsd:boolean

0: 1

Whether it is possible to exchange partially used tickets

element

HasFee

xsd:boolean

0: 1

Whether there is a fee for a refund or exchange

SecurityPolicy

Security requirements for ticketing

Example can be found in the official GitHub-repository for Entur

SecurityPolicy < UsageParameterPriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

MinimumAccountSecurityLevel

xsd:nonPositiveInteger

1

Required (minimum) sequrity level of any account that should hold a FareContract representing this product. The value is specified as a negative number, 0 is the highest level of security (most secure).

Reverting (todo)

OnboardValidity (todo)

Fare Product

ServiceAccessRight

Abstract type describing an immaterial marketable element (access rights, discount rights etc).

See definition in General information

ServiceAccessRight < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Type

Cardinality

Description

element

PrivateCode

xsd:normalizedString

0: 1

Identifier of SERVICE ACCESS RIGHT

element

InfoUrl

xsd:anyURI

0: 1

Link for product information

FareProduct

Abstract type describing an immaterial marketable element (access rights, discount rights etc), specific to a CHARGING MOMENT.

See definition in General information

FareProduct < ServiceAccessRight < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Type

Cardinality

Description

element

ChargingMomentRef

FareProductRef

0: 1

Reference to a CHARGING MOMENT for product

element

TypeOfFareProductRef

TypeOfFareProductRef

0: 1

Reference to a type of FARE PRODUCT

element

ConditionSummary

ConditionSummary

0: 1

Summary description of conditions on FARE PRODUCT

element

OperatorRef

OperatorRef

0: 1

Reference to OPERATOR to which ACCESS RIGHT PARAMETER is assigned

element

FareProductRef

FareProductRef

0: 1

Another FARE PRODUCT which this product extends. Will assume all properties of base product unless specifically overridden.

element

validityParameterAssignments

ValidityParameterAssignment

0: 1

Type for a list of VALIDITY PARAMETER ASSIGNMENT.


se ValidityParameterAssignment (må ta stilling til om objektene i denne også skal være internt i objektet, eller kun wrappet)




PreassignedFareProduct

A FARE PRODUCT consisting of one or several VALIDABLE ELEMENTs, specific to a CHARGING MOMENT.

Example can be found in the official GitHub-repository for Entur

PreassignedFareProduct < FareProduct < ServiceAccessRight < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

SupplementProductRef

SupplementProductRef

1: 1

Reference to a SUPPLEMENT PRODUCT

element

accessRightsInProduct

AccessRightInProduct

0: *

List ACCESS RIGHT IN PRODUCT for this FARE PRODUCT

element

prices

FarePrice

0: *

PRICEs for this FARE PRODUCT

AccessRightInProduct

A VALIDABLE ELEMENT as a part of a PRE-ASSIGNED FARE PRODUCT, including its possible order in the set of all VALIDABLE ELEMENTs grouped together to define the access right assigned to that PREASSIGNED FARE PRODUCT.

Example can be found in the official GitHub-repository for Entur

AccessRightInProduct < FareElementInSequence < VersionedChild < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

ValidableElementRef

ValidableElementRef

0: 1

Reference to a VALIDABLE ELEMENT for which access rights are specified

element

SupplementProductRef

SupplementProductRef

1: 1

Reference to a SUPPLEMENT PRODUCT

Preferably not used as an AccessRight, but rather as a SUPPLEMENT PRODUCT to the FARE PRODUCT itself.

SupplementProduct

An additional FARE PRODUCT that may be used to describe additional purchases entitled by another product. A SUPPLEMENT PRODUCT is usually constrained by some or all of the parameters of the supplemented product, e.g. same service, same route, etc.

Example can be found in the official GitHub-repository for Entur

SupplementProduct < PreassignedFareProduct < FareProduct < ServiceAccessRight < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

PreassignedFareProductRef

PreassignedFareProductRef

1: 1

Reference to base PRE ASSIGNED FARE PRODUCT OFFER for which this is a supplement

Går kun an å referere ett FareProduct (dvs enten ett SupplementaryProduct eller en SalesDiscountRight).

 Se FareProductRelationGroup (netex_fareProduct_version.xsd)

Det må ENTEN fikses, ellers må referansen gå tilbake for akkurat dette datasettet. (Hvilket umuliggjør gjenbruk.)

element

SupplementProductType

SupplementProductEnumeration

1: 1

Classification of SUPPLEMENT PRODUCT

Allowed values:

  • animal

  • bicycle

  • dog

  • eventAddOn

  • extraLuggage

  • journeyAddOn

  • journeyExtension

  • meal

  • parking

  • penalty

  • seatReservation

  • upgrade

  • wifi

ThirdPartyProduct

A FARE PRODUCT that is marketed together with a Public Transport Fare Product.

Example can be found in the official GitHub-repository for Entur

ThirdPartyProduct < FareProduct < ServiceAccessRight < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

prices

FarePrice

0: *

Capping FARE PRICEs for this rule

Må ta stilling til hva dette objektet skal inneholde

name

type

0: x

description

SaleDiscountRight

A FARE PRODUCT allowing a customer to benefit from discounts when purchasing SALES OFFER PACKAGEs.

Example can be found in the official GitHub-repository for Entur

SaleDiscountRight < FareProduct < ServiceAccessRight < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

ProductType

SaleDiscountRightEnumeration

1: 1

SaleDiscountRightEnumeration

Allowed values:

  • payAsYouGoRight

  • statutoryRight (per regulatory approval)

  • travelCard

Under utarbeidelse (uke 43-44), avklare hvilke use-case som skal støttes i første leveranse

CappedDiscountRight

A specialisation of SALE DISCOUNT RIGHT where the discount is expressed as a capping limit for a given
time interval. For example, the London Oyster card fare, which charges for each journey at a reduced price until travel equivalent to a day pass has been consumed.

Example can be found in the official GitHub-repository for Entur

CappedDiscountRight < SaleDiscountRight < FareProduct < ServiceAccessRight < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

cappingRules

CappingRule

1: 1

List of parameters setting a price cap on a product.

CappingRule

A capping limit for a given time interval, where the capping is expressed by another product. For example, the London Oyster card fare, which charges for each journey at a reduced price until travel equivalent to a
day pass for the mode of travel has been consumed. A CAPPING RULE is a PRICEABLE OBJECT and may have USAGE PARAMETERS such as a USAGE VALIDITY PERIOD to specify how long the capping period is and a CHARGING POLICY to specify rules about travelling under credit.

Example can be found in the official GitHub-repository for Entur

CappingRule < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

prices

FarePrice

0: *

Capping FARE PRICEs for this rule

Sales Offer

SalesOfferPackage

A package to be sold as a whole, consisting of one or several FARE PRODUCTs materialised thanks to one or several TRAVEL DOCUMENTs. The FARE PRODUCTs may be either directly attached to the TRAVEL DOCUMENTs, or may be reloadable on the TRAVEL DOCUMENTs.

Example can be found in the official GitHub-repository for Entur

SalesOfferPackage < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

PrivateCode

PrivateCodeType

0: 1

Alternative identifier of an entity. can be used to associate with legacy systems.

(question) Mer ryddig å definere RoundingRef, prices, PrincingService(Ref), PricingRule(Ref), priceGroups og fareTables utenfor (evt i FareProduct)? ((warning) F.eks. kun i SalesOfferPackageElement)

element

(warning) validityParameterAssignments

GenericParameterAssignment

0: *

List of VALIDITY PARAMETER ASSIGNMENTs for SALES OFFER PACKAGE

element

distributionAssignments

DistributionAssignment

0: 1

List of DISTRIBUTION ASSIGNMENTs for SALES OFFER PACKAGE

Can be defined as separate object and referred, but may be more consistent to have embedded

element

RoundingRef

RoundingRef

0: 1

Reference to a ROUNDING

element

prices

SalesOfferPackagePrice

0: *

List of SALES OFFER PACKAGE PRICEs associated with the SALES OFFER PACKAGE ELEMENT

element

salesOfferPackageElements

SalesOfferPackageElement

0: *

List of SALES OFFER PACKAGE ELEMENTs

element

SalesOfferPackageSubstitutions

SalesOfferPackageSubstitution

1: *

List of SALES OFFER PACKAGE SUBSTITUTIONs

GroupOfSalesOfferPackages

A grouping of SALES OFFER PACKAGEs

Example can be found in the official GitHub-repository for Entur

GroupOfSalesOfferPackages < GroupOfEntities < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

alternativeNames

AlternativeName

0: *

ALTERNATIVE NAMEs for GROUP of SALES OFFER PACKAGEs

element

PricingServiceRef

PricingServiceRef

0: *

PRICING SERVICE to use to fetch prices dynamically

element

PricingRuleRef

PricingRuleRef

0: *

Default PRICING RULE to use to derive prices from this element

element

priceGroups

PriceGroupRef

0: *

PRICE GROUPs associated with this element

(choice) element

fareTables

StandardFareTableRef

0: *

List of FARE TABLEs associated with this element

FareTableRef

element

SalesOfferPackageElements

SalesOfferPackageElement

0: 1

Common properties of SALES OFFER PACKAGE and GROUP OF SALES OFFER PACKAGES

element

members

SalesOfferPackageRef

1: *

References to members of GROUP of SALES OFFER PACKAGEs

SalesOfferPackageElement

The assignment of a FARE PRODUCT to a TYPE OF TRAVEL DOCUMENT in order to define a SALES OFFER PACKAGE, realised as a fixed assignment (printing, magnetic storage etc.) or by the possibility for the FARE PRODUCT to be reloaded on the TYPE OF TRAVEL DOCUMENT.

Example can be found in the official GitHub-repository for Entur

SalesOfferPackageElement < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

RequiresValidation

xsd:boolean

0: 1

Whether element requires validation before it can be used

element

ConditionSummary

ConditionSummary

0: 1

Summary description of SALES OFFER PACKAGE properties

element

SalesOfferPackageRef

SalesOfferPackageRef

1: 1 (ikke implementert som mandatory)

Reference to a SALES OFFER PACKAGE of which this is part. If not given by containing context must be specified.

Sannsynligvis bedre med embedding enn referanse, dvs SalesOfferPackage inkluderer sine elements?

element

TypeOfTravelDocumenRef

TypeOfTravelDocumenRef

0: 1

Reference to a TYPE OF TRAVEL DOCUMENT.

element

FareProductRef

FareProductRef

0: 1

FARE PRODUCT associated with this SALES OFFER PACKAGE

element

validityParameterAssignments

GenericParameterAssignment

0: *

GENERIC PARAMETER ASSIGNMENTs associated with the SALES OFFER PACKAGE ELEMENT

element

prices

SalesOfferPackagePriceRef

0: *

SALES OFFER PACKAGE PRICEs associated with the SALES OFFER PACKAGE ELEMENT

SalesOfferPackageSubstitution

Information on the preferred substitution of packages with other package if quota restricted product is no longer available. The relative priority is specified using the order attribute inherited from ASSIGNMENT.

Example can be found in the official GitHub-repository for Entur

SalesOfferPackageSubstitution < Assignment < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

SalesOfferPackageRef

SalesOfferPackage

0: *

text

Anbefaler som del av objektet fremfor eksternt definert (i FareFrame) med referanse, siden dette (sannsynligvis) vil være unikt per SalesOfferPackage

Sales Offer - element dependencies

ElementConsumptionPolicy (todo)

AccessRightInProductConsumptionRequirement (todo)

AccessRightInProductConsumption (todo)

AccessRightInProductSpecificationStartTimePolicyAssignmentInput (todo)

(denne bør muligens forsøkes å generaliseres, evt at vi får definert de andre variantene også (valg av avgang, sone osv)

CrossConstraint (todo)

Pricing

GeographicalUnitPrice

A unit for calculating geographical graduated fares

GeographicalUnitPrice < FarePrice < VersionedChild < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

GeographicalUnitPrice inherits from FarePrice without introducing new elements or attributes.

GeographicalIntervalPrice

A set of all possible price features of a QUALITY STRUCTURE FACTOR , e.g. default total price etc.

Example can be found in the official GitHub-repository for Entur

GeographicalIntervalPrice < FarePrice < VersionedChild < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

GeographicalIntervalPrice inherits from FarePrice without introducing new elements or attributes.

DistanceMatrixElementPrice

A set of all possible price features of a DISTANCE MATRIX ELEMENT: default total price etc.

Example can be found in the official GitHub-repository for Entur

DistanceMatrixElementPrice < FarePrice < VersionedChild < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

DistanceMatrixElementPrice inherits from FarePrice without introducing new elements or attributes.

FareStructureElementPrice

A set of all possible price features of a FARE STRUCTURE ELEMENT: default total price, discount in value or percentage etc.

Example can be found in the official GitHub-repository for Entur

FareStructureElementPrice < FarePrice < VersionedChild < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

FareStructureElementPrice inherits from FarePrice without introducing new elements or attributes.

UsageParameterPrice

A set of all possible price features of a USAGE PARAMETER: discount in value or percentage etc.

Example can be found in the official GitHub-repository for Entur

UsageParameterPrice < FarePrice < VersionedChild < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

UsageParameterPrice inherits from FarePrice without introducing new elements or attributes.

FareProductPrice

A set of all possible price features of a FARE PRODUCT: default total price, discount in value or percentage etc.

Example can be found in the official GitHub-repository for Entur

FareProductPrice < FarePrice < VersionedChild < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

FareProductPrice inherits from FarePrice without introducing new elements or attributes.

FulfilmentMethodPrice

A set of all possible price features of a FULFILMENT METHOD, default total price etc.

Example can be found in the official GitHub-repository for Entur

FulfilmentMethodPrice < FarePrice < VersionedChild < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

FulfilmentMethodPrice inherits from FarePrice without introducing new elements or attributes.

SalesOfferPackagePrice

A set of all possible price features of a SALES OFFER PACKAGE: default total price etc.

Example can be found in the official GitHub-repository for Entur

SalesOfferPackagePrice < FarePrice < VersionedChild < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

SalesOfferPackagePrice inherits from FarePrice without introducing new elements or attributes.


PriceGroup

A grouping of prices, allowing the grouping of numerous possible consumption elements into a limited number of price references, or to apply grouped increases, in value or percentage.

Example can be found in the official GitHub-repository for Entur

PriceGroup < GroupOfEntities < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

Amount

xsd:decimal

0: 1

Price in a specified currency

element

Currency

xsd:NMTOKEN (3 letters)

0: 1

ISO 4717 type currency code (optimization to allow PRICE UNITs to be omitted)

element

PricingRuleRef

PricingRuleRef

0: 1

Reference to a PRICING RULE used in calculation step to derive price


FareTable

A grouping of prices that may be associated with various combinations fare elements such as the DISTANCE MATRIX ELEMENT, FARE STRUCTURE ELEMENT, GEOGRAPHICAL INTERVAL, TIME INTERVAL, USAGE PARAMETER, etc.

Example can be found in the official GitHub-repository for Entur

FareTable < PriceGroup < GroupOfEntities < DataManagedObject < EntityInVersion < Entity (NB: Ikke implementert slik, i XSD arver FareTable direkte fra GroupOfEntities)

XML-type

Name

Datatype

Cardinality

Description

element

StartDate

xsd:date

0: 1

Start date for PRICE validity

element

EndDate

xsd:date

0: 1

End date for PRICE validity. Gyldighet bør heller angis med ValidityCondition for objektet

element

RoundingRef

RoundingRef

0: 1

Reference to a ROUNDING to use on calculation

element

pricesFor

PriceableObjectRef

0: *

Combination of Elements for which this table provides PRICEs

(choice) element

usedIn

TariffRef

0: *

Elements that use FARE TABLE that are not PRICEABLE OBJECTs

GroupOfDistanceMatrixElementsRef

GroupOfSalesOfferPackagesRef

element

OrganisationRef

OrganisationRef

0: *

Reference to a ORGANISATION for which this table applies

element

limitations

UsageParameterRef

0: *

Usage parameters common to all cells in table

element

prices

FarePrice

0: *

Simple FARE PRICE cells (optimised, without additional associations)


Cell

Foreløpig ikke anbefalt brukt, trolig bedre å angi priser og pristyper direkte (så lenge det er dekkende) fremfor å utveksle formatert / cellestrukturert tabell.

An unique individual combination of features within a FARE TABLE, used to associate a FARE PRICE with a fare element.

Example can be found in the official GitHub-repository for Entur

Cell < VersionedChild < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

attribute

order

xsd:integer

1: 1

>Order in which cell is to appear

element

FareStructureElementPriceRef

FareStructureElementPriceRef

0: *

Reference to a FARE STRUCTURE ELEMENT PRICE

Distribution

DistributionChannel

A type of outlet for selling a product.

Example can be found in the official GitHub-repository for Entur

DistributionChannel < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

alternativeNames

AlternativeName

0: *

List for alternative name(s) for Distribution Channel

(choice) element

DistributionChannelType

DistributionChannelTypeEnumeration

1: 1

Classification of DISTRIBUTION CHANNEL

Allowed values:

  • atStop

  • onBoard

  • online

  • telephone

  • electronicPass

  • postal

  • mobileDevice

  • agency

  • tourOperator

AllDistributionChannelsRef

AllDistributionChannelsRefStructureElement

Always "All"

element

IsObligatory

xsd:boolean

0: 1

Whether use of the channel is obligatory

element

RequiresEmailAddress

xsd:boolean

0: 1

Whether use of the channel requries the pruchaser to have an email address

(choice) element

ContactDetails

ContactStructure

0: 1

Contact details for distribution channel

OrganisationRef

OrganisationRef

Reference to Organisation responsible for Distribution Channel

element

PaymentMethods

PaymentMethodEnumeration

0: 1

Available payment methods

Allowed values:

  • cash

  • cashAndCard

  • coin

  • banknote

  • cheque

  • travellersCheque

  • postalOrder

  • companyCheque

  • creditCard

  • debitCard

  • cardsOnly

  • travelCard

  • contactlessPaymentCard

  • contactlessTravelCard

  • sms

  • mobilePhone

  • voucher

  • token

  • warrant

element

DistributionRights

DistributionRightsEnumeration

0: 1

Channels DISTRIBUTION RIGHTs

Allowed values:

  • none

  • sell

  • exchange

  • refund

  • inform

  • private

element

distributionPoints

PointRef

0: 1

List of references to a POINT (e.g. for info on geolocation)

element

DistributionGroupRef

DistributionGroupRef

0: 1

Prefined Group of specified points to which distribution is restricted, if any.

Guppering gjøres gjennom GroupOfDistributionChannels, ikke motsatt vei.

GroupOfDistributionChannels

Type for a collection of one or more references to a DISTRIBUTION CHANNEL.

Example can be found in the official GitHub-repository for Entur

GroupOfDistributionChannels < GroupOfEntities < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

members

DistributionChannelRefs

1: 1

List containing minimum two or more DistributionChannelRef for group

FulfilmentMethod

The means by which the ticket is delivered to the Customer.

Example can be found in the official GitHub-repository for Entur

FulfilmentMethod < PriceableObject < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

FulfilmentMethodType

FulfilmentMethodTypeEnumeration

0: 1

Type of FULFILMENT METHOD

Allowed values:

  • ticketOffice

  • ticketMachine

  • conductor

  • agent

  • post

  • selfprint

  • sms

  • email

  • topUpDevice

  • validator

  • mobileApp

element

RequiresCard

xsd:boolean

0: 1

Whether use of of the method requires a credit or debit card

element

RequiresBookingReference

xsd:boolean

0: 1

Whether use of of the method requires a booking reference

element

typesOfTravelDocument

TypeOfTravelDocumentRef

0: *

List of TYPES OF TRAVEL DOCUMENT associated with method

element

canIssueTypesOfTravelDocument

TypeOfTravelDocumentRef

0: *

List of TYPES OF TRAVEL DOCUMENT that can be ISSUED with method

element

canReuseTypesOfTravelDocument

TypeOfTravelDocumentRef

0: *

TYPES OF TRAVEL DOCUMENT that can be REUSED with method

element

prices

FulfilmentMethodPriceRef

0: *

Reference to a FULFILMENT METHOD PRICE

TypeOfTravelDocument

A classification of TRAVEL DOCUMENTs expressing their general function and local functional characteristics specific to the operator

Example can be found in the official GitHub-repository for Entur

TypeOfTravelDocument < TypeOfValue < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

IsCard

xsd:boolean

0: 1

Whether the TRAVEL DOCUMENT is materialised as a card

element

IsSmart

xsd:boolean

0: 1

Whether the TRAVEL DOCUMENT is materialized on a smart card or mobile device

element

HasPhoto

xsd:boolean

0: 1

Whether the TRAVEL DOCUMENT has a photo

element

MediaType

MediaTypeEnumeration

0: 1

Classification of the TRAVEL DOCUMENT by Media Type

Allowed values:

  • paperTicket

  • paperTicketWithCoupons

  • coupon

  • selfPrintPaperTicket

  • smartCard

  • mobileApp

  • card

  • mms

  • sms

element

MachineReadable

MachineReadableEnumeration

0: 1

Classification of the TRAVEL DOCUMENT by Machine Readable mechanism

Allowed values:

  • magneticStrip

  • chip

  • ocr

  • barCode

  • shotCode (NB: Only as temporary replacement for QRcode)

  • QRcode (currently missing in NeTEx)

  • nfc

DistributionAssignment

An assignment of the COUNTRY and/or DISTRIBUTION CHANNEL through which a product may or may not be distributed

See definition in General information

DistributionAssignment < Assignment < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

ServiceAccessRightRef

ServiceAccessRightRef

0: 1

Reference to a SERVICE ACCESS RIGHT

Rather referenced through PreassignedFareProduct of SalesOfferPackageElement

(choice) element

SalesOfferPackageRef

SalesOfferPackageRef

0: 1

Reference to a SALES OFFER PACKAGE

GroupOfSalesOfferPackagesRef

GroupOfSalesOfferPackagesRef

Reference to a GROUP OF SALES OFFER PACKAGEs

element

DistributionRights

DistributionRightsEnumeration

0: 1

List of values for DISTRIBUTION RIGHTs

Allowed values:

  • none

  • sell

  • exchange

  • refund

  • inform

  • private

element

DistributionChannelType

DistributionChannelTypeEnumeration

0: 1

Classification of DISTRIBUTION CHANNEL

Allowed values:

  • atStop

  • onBoard

  • online

  • telephone

  • electronicPass

  • postal

  • mobileDevice

  • agency

  • tourOperator

element

AllowedInChannel

xsd:boolean

0: 1

Whether distribution is allowed or forbidden for given channel

element

RestrictedToChannel

xsd:boolean

0: 1

Whether distribution is restricted to a given country and / or channel

element

MandatoryProduct

xsd:boolean

0: 1

Whether product is mandatory, i.e. must be provided

element

TicketingServiceFacilityList

TicketingServiceFacilityEnumeration

0: 1

List of TICKETING SERVICE FACILITies

Allowed values:

  • purchase

  • collection

  • cardTopUp

  • reservations

  • exchange

  • refund

  • renewal

  • excessFares

  • all

element

PaymentMethods


0: 1

Payment methods

Allowed values:

  • cash

  • cashAndCard

  • coin

  • banknote

  • cheque

  • travellersCheque

  • postalOrder

  • companyCheque

  • creditCard

  • debitCard

  • cardsOnly

  • travelCard

  • contactlessPaymentCard

  • contactlessTravelCard

  • sms

  • mobilePhone

  • voucher

  • token

  • warrant

element

RequiresRegistration

xsd:boolean

0: 1

Whether distribution requires registered user

element

FulfilmentMethodRef

FulfilmentMethodRef

0: 1

Reference to a FULFILMENT METHOD

Currently missing in NeTEx

PR for utvidelse med GroupOfDistributionAssignments som peker på "standardgrupper" av vanlige konfigurasjoner, for å slippe å assigne alle SalesOfferPackage til alle aktuelle DistributionAssignments?

GroupOfDistributionAssignments

Type for a collection of one or more references to a DISTRIBUTION CHANNEL.

Example can be found in the official GitHub-repository for Entur

GroupOfDistributionAssignments < GroupOfEntities < DataManagedObject < EntityInVersion < Entity

XML-type

Name

Datatype

Cardinality

Description

element

members

DistributionAssignmentRefs

1: 1

List containing minimum two or more DistributionAssignmentRef for group

  • No labels