diff --git a/OJP/OJP_FareSupport.xsd b/OJP/OJP_FareSupport.xsd index 2700ec4be..f6c00e464 100644 --- a/OJP/OJP_FareSupport.xsd +++ b/OJP/OJP_FareSupport.xsd @@ -5,19 +5,6 @@ - - - classes of travel available on a particular service which will affect the price to be paid - - - - - - - - - - ========================================== Fare Authority ========================================== @@ -606,9 +593,9 @@ conditions of use for a particular FARE PRODUCT. - + - Travel class for which the FareProduct is valid. + Fare class for which the FareProduct is valid (Transmodel: CLASS OF USE). @@ -767,9 +754,9 @@ sequence of all passenger categories, for which this FareProduct is valid - + - Travel class for which to retrieve FareProducts. Refers to TYPE OF FARE CLASS (e.g. first class). + Fare class for which to retrieve FareProducts. Refers to TYPE OF FARE CLASS (e.g. first class). Transmodel: CLASS OF USE. diff --git a/docs/generated/index.html b/docs/generated/index.html index 7a49c1b1c..28f739726 100644 --- a/docs/generated/index.html +++ b/docs/generated/index.html @@ -325,7 +325,7 @@

OJP - Open API for distributed Journey FareResponse

FareResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

FareResult

0:*

+FareResult

Fare result choice element.

4.8. The complex type FareResultStructure

FareResultStructure

Wrapper element for Fare results.

The element contains a sequence of the following elements:

Id

1:1

FareResultObjectId

ID of this result.

ErrorCondition

0:*

+OJPError

Problems related to this FARE result.

FareEstimated

0:1

xs:boolean

Whether the fare is only estimated by the service. Estimated can mean different things: For example, the fare may vary depending on age, PassengerCategory, TravelClass, EntitlementProducts. It can also mean that the fare structure used by the service is not entirely accurate or that other factors, such as the time a shared vehicle is used, need to be factored into the price. As a rule, the price should then be given as an approximate and probably lower limit of the actual price. Default is TRUE.

Then, the element contains one of the following elements:

a

MultiTripFareResult

-1:*

+MultiTripFareResult

Fare and FareProducts for multiple trips.

b

StaticFareResult

-1:1

+StaticFareResult

Static Fare information.

c

StopFareResult

-1:1

+StopFareResult

Stop-related Fare information.

d

TripFareResult

-1:*

+TripFareResult

Fare and FareProducts for a given trip.

4.9. The complex type StopFareResultStructure

StopFareResultStructure

Stop-related Fare information.

The element contains a sequence of the following elements:

TariffZoneListInArea

1:*

+TariffZoneListInArea

One or more lists of Fare zones that belong to a Fare authority/area.

Extension

0:1

xs:anyType

4.10. The complex type StaticFareResultStructure

StaticFareResultStructure

General Fare information.

The element contains a sequence of the following elements:

FareProduct

0:*

+FareProduct

[related to FARE PRODUCT in TM and NeTEx] different FARE PRODUCTs that may be available with related information.

StaticInfoUrl

0:*

+WebLink

URL to information page on the web.

Extension

0:1

xs:anyType

4.11. The complex type TripFareProductReferenceStructure

TripFareProductReferenceStructure

Element that connects FareProducts to trips. A TripFareProduct is a FAREPRODUCT covering a part or the whole of a TRIP from boarding the first public transport vehicle to alighting from the last public transport vehicle (corresponds to a package of PREASSIGNED FARE PRODUCTs)

The element contains a sequence of the following elements:

→‍FareProductRef

1:1

→‍FareProductRef

Reference to a FareProduct.

FromTripIdRef

1:1

Identifies the "valid from" trip.

FromLegIdRef

0:1

LegObjectId

Identifies the "valid from" LEG. If missing, then valid from the first LEG.

ToTripIdRef

1:1

Identifies the "valid to" trip.

ToLegIdRef

0:1

LegObjectId

Identifies the "valid to" LEG. If missing, then valid to the last LEG.

4.12. The complex type MultiTripFareResultStructure

MultiTripFareResultStructure

Structure of a Multi Trip Fare Request result

The element contains a sequence of the following elements:

TripFareProductReference

1:*

+TripFareProductReference

Non-empty list of trip references in the corresponding MultiTripFareRequestStructure

FareProduct

0:*

+FareProduct

Zero, one or more FareProducts that are valid for the referenced trips / part of trips.

PassedZones

0:1

+TariffZoneListInArea

The set of passed zones.

StaticInfoUrl

0:*

+WebLink

URL to Fare information pages on the web.

-

5. OJP/OJP_FareSupport.xsd - Supporting definitions for fare information on passenger trips

5.1. Simple type definitions

BookingAccessEnumeration

public | authorisedPublic | staff | other

Allowed values for Booking Access.

BookingMethodEnumeration

callDriver | callOffice | online | other | phoneAtStop | text | mobileApp | atOffice | none

Allowed values for Flexible Booking method.

BookingProcessEnumeration

xs:normalizedString

Allowed values for Booking Process UIC 7037 Code list.

ContactTypeEnumeration

any | information | reservations | lostProperty | publicRelations | complaints | emergency | other

Allowed values for CONTACT role.

EmailAddressType

xs:normalizedString

Email address type a@b.

EntitlementProductCodeType

xs:NMTOKEN

Identifier of an ENTITLEMENT PRODUCT (e.g. BahnCard50, BahnCard50First, military card, concessionary card, ...). It is defined by the fare authority.

FareAuthorityCodeType

xs:NMTOKEN

Identifier of a Fare Authority.

FareProblemTypeEnumeration

FARE_OUTOFAREA | FARE_JOURNEYNOTPERMITTED | FARE_ADDITIONALCHARGES | FARE_ADDITIONALTICKETS | FARE_ROUTENOTFEASIBLE | FARE_ALREADYCOVERED | FARE_DATEOUTOFRANGE | FARE_STOPPOINTUNKNOWN | FARE_OTHER

Types of problems that may be returned in responses to FARE requests.

FareProductIdType

xs:NMTOKEN

Identifier of a FareProduct

GroupBookingEnumeration

xs:normalizedString

Allowed values for Group Booking.

PassengerCategoryEnumeration

Adult | Child | Senior | Youth | Disabled

[a simplified and specialised view of USER PROFILE in TM and NeTEx] classification of passengers by age or other factors that may determine the fare they will need to pay.

PhoneType

xs:normalizedString

Type for an International phone number. + Country + MSISDN e.g. +41 675601 etc.

PurchaseMomentEnumeration

xs:normalizedString

Allowed values for Purchase Moment.

PurchaseWhenEnumeration

xs:normalizedString

Allowed values for Purchase when.

TariffZoneCodeType

xs:NMTOKEN

Identifier of a fare zone.

TypeOfFareClassEnumeration

all | first | second | third | business | economy

classes of travel available on a particular service which will affect the price to be paid

5.2. The complex type FareAuthorityRefStructure

FareAuthorityRefStructure

FareAuthorityCode

Reference to a Fare Authority ([a specialisation of an ORGANISATION in TMv6] ORGANISATION which has the RESPONSIBILITY ROLE for the definition of FARE PRODUCTs).

5.3. The toplevel element FareAuthorityRef

FareAuthorityRef

+FareAuthorityRef

Reference to a Fare Authority.

5.4. The FareAuthorityGroup group

+

5. OJP/OJP_FareSupport.xsd - Supporting definitions for fare information on passenger trips

5.1. Simple type definitions

FareAuthorityGroup

Group of attributes for an ORGANISATION which has the RESPONSIBILITY ROLE for the definition of FARE PRODUCTs

BookingAccessEnumeration

public | authorisedPublic | staff | other

Allowed values for Booking Access.

BookingMethodEnumeration

callDriver | callOffice | online | other | phoneAtStop | text | mobileApp | atOffice | none

Allowed values for Flexible Booking method.

BookingProcessEnumeration

xs:normalizedString

Allowed values for Booking Process UIC 7037 Code list.

ContactTypeEnumeration

any | information | reservations | lostProperty | publicRelations | complaints | emergency | other

Allowed values for CONTACT role.

EmailAddressType

xs:normalizedString

Email address type a@b.

EntitlementProductCodeType

xs:NMTOKEN

Identifier of an ENTITLEMENT PRODUCT (e.g. BahnCard50, BahnCard50First, military card, concessionary card, ...). It is defined by the fare authority.

FareAuthorityCodeType

xs:NMTOKEN

Identifier of a Fare Authority.

FareProblemTypeEnumeration

FARE_OUTOFAREA | FARE_JOURNEYNOTPERMITTED | FARE_ADDITIONALCHARGES | FARE_ADDITIONALTICKETS | FARE_ROUTENOTFEASIBLE | FARE_ALREADYCOVERED | FARE_DATEOUTOFRANGE | FARE_STOPPOINTUNKNOWN | FARE_OTHER

Types of problems that may be returned in responses to FARE requests.

FareProductIdType

xs:NMTOKEN

Identifier of a FareProduct

GroupBookingEnumeration

xs:normalizedString

Allowed values for Group Booking.

PassengerCategoryEnumeration

Adult | Child | Senior | Youth | Disabled

[a simplified and specialised view of USER PROFILE in TM and NeTEx] classification of passengers by age or other factors that may determine the fare they will need to pay.

PhoneType

xs:normalizedString

Type for an International phone number. + Country + MSISDN e.g. +41 675601 etc.

PurchaseMomentEnumeration

xs:normalizedString

Allowed values for Purchase Moment.

PurchaseWhenEnumeration

xs:normalizedString

Allowed values for Purchase when.

TariffZoneCodeType

xs:NMTOKEN

Identifier of a fare zone.

5.2. The complex type FareAuthorityRefStructure

FareAuthorityRefStructure

FareAuthorityCode

Reference to a Fare Authority ([a specialisation of an ORGANISATION in TMv6] ORGANISATION which has the RESPONSIBILITY ROLE for the definition of FARE PRODUCTs).

5.3. The toplevel element FareAuthorityRef

FareAuthorityRef

+FareAuthorityRef

Reference to a Fare Authority.

5.4. The FareAuthorityGroup group

FareAuthorityGroup

Group of attributes for an ORGANISATION which has the RESPONSIBILITY ROLE for the definition of FARE PRODUCTs

FareAuthority

→‍FareAuthorityRef

1:1

→‍FareAuthorityRef

Reference to a Fare Authority.

FareAuthorityText

1:1

xs:string

Textual description or name of Fare authority.

5.5. The complex type TariffZoneRefStructure

TariffZoneRefStructure

Reference to a fare zone.

5.6. The toplevel element TariffZoneRef

TariffZoneRef

+TariffZoneRef

Reference to a fare zone.

5.7. The complex type TariffZoneStructure

TariffZoneStructure

[a more clearly defined equivalent of TARIFF ZONE in TM and NeTEx] A ZONE used to define a zonal fare structure in a zone-counting or zone-matrix system.

The element contains a sequence of the following elements:

→‍TariffZoneRef

1:1

→‍TariffZoneRef

Reference to a fare zone.

TariffZoneText

1:1

xs:string

Text describing the fare zone. Passengers will recognize the fare zone by this text. Often published on Fare Zone Maps.

5.8. The complex type TariffZoneListInAreaStructure

@@ -352,7 +352,7 @@

OJP - Open API for distributed Journey

- + @@ -369,7 +369,7 @@

OJP - Open API for distributed Journey

TariffZoneListInAreaStructure

List of fare zones within the area of a Fare Authority.

The element contains a sequence of the following elements:

Currency

0:1

xs:NMTOKEN

iso 4217 currency code, e.g. EUR for Euro or GBP for Pound Sterling

VatRate

0:1

Percentage

Rate of value added tax.

FareProductValidity

TravelClass

0:1

TypeOfFareClass

Travel class for which the FareProduct is valid.

FareProductValidity

FareClass

0:1

siri:FareClassEnumeration

Fare class for which the FareProduct is valid (Transmodel: CLASS OF USE).

RequiredCard

0:*

+EntitlementProduct

One or more ENTITLEMENT PRODUCTs required for the purchase of this FareProduct. In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g. the "BahnCard50" of "Deutsche Bahn".

ValidFor

0:*

PassengerCategory

Sequence of all passenger categories for which this FareProduct is valid.

ValidityDuration

0:1

xs:duration

Maximum duration of FareProduct validity starting with purchase of ticket or begin of journey (ticket validation).

Currency

0:1

xs:NMTOKEN

iso 4217 currency code, e.g. EUR for Euro or GBP for Pound Sterling

VatRate

0:1

Percentage

Rate of value added tax.

5.24. The FareProductValidityGroup group

- + @@ -389,11 +389,11 @@

OJP - Open API for distributed Journey

FareProductValidityGroup

conditions of use for a particular FARE PRODUCT.

FareProductValidity

TravelClass

0:1

TypeOfFareClass

Travel class for which the FareProduct is valid.

FareProductValidity

FareClass

0:1

siri:FareClassEnumeration

Fare class for which the FareProduct is valid (Transmodel: CLASS OF USE).

RequiredCard

0:*

+EntitlementProduct

One or more ENTITLEMENT PRODUCTs required for the purchase of this FareProduct. In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g. the "BahnCard50" of "Deutsche Bahn".

ValidFor

0:*

PassengerCategory

Sequence of all passenger categories for which this FareProduct is valid.

ValidityDuration

0:1

xs:duration

Maximum duration of FareProduct validity starting with purchase of ticket or begin of journey (ticket validation).

PassedZones

0:1

+TariffZoneListInArea

The sequence of passed fare zones.

FareProduct

0:*

+FareProduct

One ore more FareProducts that are valid for this part of the trip.

StaticInfoUrl

0:*

+WebLink

URL to static information page on the web.

5.28. The complex type FarePassengerStructure

FarePassengerStructure

[a specialised form of USER PROFILE in TM and NeTEx] attributes of a passenger that influence the price to be paid by that passenger for a FARE PRODUCT.

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

a

Age

-1:1

xs:nonNegativeInteger

Age of the passenger on the day of travel.

b

PassengerCategory

-1:1

PassengerCategory

sequence of all passenger categories, for which this FareProduct is valid

EntitlementProducts

0:1

+EntitlementProductList

A list of ENTITLEMENT PRODUCTs.

Then, the element contains one of the following elements:

a

SalesPackageElementRef

-1:*

+FareProductRef

Id of a FareProduct that the passenger already holds and that may be used for the travel or parts of it.

b

ZonesAlreadyPaid

-1:1

+TariffZoneRefList

Fare zones for which the passenger already has a valid FareProduct.

5.29. The FareDataFilterGroup group

- +

FareDataFilterGroup

Data filter group for Fare request.

FareDataFilter

FareAuthorityFilter

0:*

+FareAuthorityRef

Fare authority for which to retrieve Fare information.

PassengerCategory

0:*

PassengerCategory

sequence of all passenger categories, for which this FareProduct is valid

TravelClass

0:1

TypeOfFareClass

Travel class for which to retrieve FareProducts. Refers to TYPE OF FARE CLASS (e.g. first class).

FareClass

0:1

siri:FareClassEnumeration

Fare class for which to retrieve FareProducts. Refers to TYPE OF FARE CLASS (e.g. first class). Transmodel: CLASS OF USE.

5.30. The complex type FareParamStructure

- +

FareParamStructure

[related to the FARE parameter model in TM and NeTEx] parameters which are used to determine the price to be paid for a FARE PRODUCT by a specific passenger.

The element contains a sequence of the following elements:

FareDataFilter

FareAuthorityFilter

0:*

+FareAuthorityRef

Fare authority for which to retrieve Fare information.

PassengerCategory

0:*

PassengerCategory

sequence of all passenger categories, for which this FareProduct is valid

TravelClass

0:1

TypeOfFareClass

Travel class for which to retrieve FareProducts. Refers to TYPE OF FARE CLASS (e.g. first class).

FareClass

0:1

siri:FareClassEnumeration

Fare class for which to retrieve FareProducts. Refers to TYPE OF FARE CLASS (e.g. first class). Transmodel: CLASS OF USE.

Traveller

0:*

+FarePassenger

Number of travellers that will make the journey and for which Fare information needs to be gathered.

5.31. The toplevel element FareProblemType

FareProblemType

FareProblemType (↔ ErrorType)

6. OJP/OJP_Lines.xsd - Request and response definitions for information on lines

6.1. Simple type definitions

LineInformationProblemTypeEnumeration

LINEINFORMATION_LINEUNKNOWN | LINEINFORMATION_OTHER

Types of problems that may be returned in responses to LINE INFORMATION requests.

6.2. The LineInformationResponseGroup group

diff --git a/examples/functions/fare/FareRequest.xml b/examples/functions/fare/FareRequest.xml index 01f4693a8..b2e431754 100644 --- a/examples/functions/fare/FareRequest.xml +++ b/examples/functions/fare/FareRequest.xml @@ -132,7 +132,7 @@ ch:1:NOVA Adult - second + secondClass 25 diff --git a/examples/functions/fare/FareResponse.xml b/examples/functions/fare/FareResponse.xml index f9f770b80..8b52f723b 100644 --- a/examples/functions/fare/FareResponse.xml +++ b/examples/functions/fare/FareResponse.xml @@ -35,7 +35,7 @@ Mybuxi 15 CHF - economy + economyClass MyBuxi @@ -65,7 +65,7 @@ NOVA 51 CHF - second + secondClass NOVA @@ -80,7 +80,7 @@ NOVA 75 CHF - first + firstClass NOVA

LineInformationResponseGroup

Line Information response group.

LineInformationResponse

LineResult

0:*

+LineResult