Schemas
WorkflowStatus
Status of this Order or OrderLine. Every Order starts out with the status DRAFT, and can only be changed to CONFIRMED when it is balanced - when balance is '0.00'. All OrderLines that are have the status DRAFT at that point in time can also be changed to CONFIRMED.
CancellationReason
Cancellation reason for an OrderLine. OrderLines with REPLACED have been replaced with a newer version.
RefType
idID of the resources
versionA specific version of the resource if applicable
ValidityParameter
Reference to a resource available in a different APIs
Reference to a resource available in a different APIs
Reference to a resource available in a different APIs
Reference to a resource available in a different APIs
Reference to a resource available in a different APIs
Reference to a resource available in a different APIs
SpecificParameterAssignment
Reference to a resource available in a different APIs
includesGroupingTypeLogical operator
Validity parameters
Reference to a resource available in a different APIs
validityParameterGroupingTypeLogical operator
limitationGroupingTypeLogical operator
Included SpecificParameterAssignments
Limitations
validityParameterSetSelectionTypeSet selection type for a group containing multiple elements
UsageTrigger
UsageEnd
ActivationMeans
DynamicUsageValidityPeriod
standardDurationStandard duration. Represented as a string formatted according to ISO-8601
startDateTimeStartDateTime
usageTriggerendDateTimeEndDate
usageEndactivationMeansActivation Means. Describes how a product can be activated.
CompanionProfile
minimumNumberOfPersonsmaximumNumberOfPersonsReference to a resource available in a different APIs
GroupTicket
derivedFromObjectRefIdentity of object from which this object of ENTITY was derived. Normally the same.
derivedFromVersionRefVersion of this object from which this version of ENTITY was derived.
Limitation
A dynamic UsageValidtyPeriod that is generated on the fly. Thus lacking id and version as it can not be referenced
Reference to a resource available in a different APIs
Reference to a resource available in a different APIs
Reference to a resource available in a different APIs
SetSelection
Set selection type for a group containing multiple elements
AddedBy
posPoint-of-sale reference of request used when OrderLine was added.
distributionChannelIdDistribution channel ID of request used when OrderLine was added.
PriceWithTax
amountAmount including tax amount.
taxAmountTax amount
currencyCurrency
taxRateTax rate. Must be in valid BigDecimal format
taxCodeTax code for this tax rate
PurchasedUserProfile
Reference to a resource available in a different APIs
Price with included tax amounts and an optional rate.
Price with included tax amounts and an optional rate.
typeOfConcessionThe type of concession for this UserProfile
PurchasedUsageParameter
Reference to a resource available in a different APIs
Price with included tax amounts and an optional rate.
Price with included tax amounts and an optional rate.
PurchasedUserProfileSummary
Reference to a resource available in a different APIs
countThe number of travellers with given user profile.
Price with included tax amounts and an optional rate.
Price with included tax amounts and an optional rate.
PurchasedGroup
Reference to a resource available in a different APIs
Price with included tax amounts and an optional rate.
Price with included tax amounts and an optional rate.
The UserProfile IDs that are given rights to travel with this GroupTicket.
A collection of all the different user profiles with price and tax in the group.
PurchasedParameters
Reference to luggage allowance parameters with price information.
Reference to exchanging parameters with price information.
Reference to reserving parameters with price information.
Reference to replacing parameters with price information.
Reference to round trip parameters with price information.
Reference to entitlement products used when calculating price
A representation of a user profile
A simple representation of a UsageParameter
A representation of group product
PurchasedGeographicalInterval
Reference to a resource available in a different APIs
fareZonesA list of fare zones that exist in this interval. Empty if not relevant.
distanceThe distance in the geographical interval.
zoneCountNumber of zones counted for the journey.
zonesThe Zones for which the journey passes through. Deprecated. This list will be empty when tariff zones are fully replaced by fare zones.
PurchasedFareClass
Type of FareClass chosen by customer
PurchasedAccommodation
Type of accommodation chosen by customer
PurchasedProperties
purchasedFareClassesType of FareClass chosen by customer
purchasedAccommodationsType of accommodation chosen by customer
PurchasedFareStructureElement
Reference to a resource available in a different APIs
Price with included tax amounts and an optional rate.
Price with included tax amounts and an optional rate.
legIdsThe Leg IDs that are connected to this FareStructureElement
Possible additional parameters for the configurations
The Geographical Interval with distance and zone data.
Reference to a resource available in a different APIs
elementIdUnique ID for this specific PurchasedFareStructureElement. Note that this ID is only for distinguishing parts of an orderLine. It has no use outside of the orderLine, and can't be found in any other service.
Classification of the products chosen.
PurchasedValidableElement
Reference to a resource available in a different APIs
Price with included tax amounts and an optional rate.
Price with included tax amounts and an optional rate.
legIdsThe Leg IDs that are connected to this ValidableElement.
The underlying FareStructureElement configurations which makes up this ValidableElement
Possible additional parameters for the configurations
elementIdUnique ID for this specific PurchasedValidableElement. Note that this ID is only for distinguishing parts of an orderLine. It has no use outside of the orderLine, and can't be found in any other service.
Classification of the products chosen.
occursThe number of instances of this particular type of ValidableElement that is collected in this FareProduct
OrganisationRef
idID for an Organisation
privateCodePrivate code used to reference an Organisation
PurchasedFareProduct
Reference to a resource available in a different APIs
Price with included tax amounts and an optional rate.
Price with included tax amounts and an optional rate.
legIdsThe IDs of the Legs that are connected to this FareProduct.
The ValidableElement configurations which makes up this FareProduct.
Possible additional parameters for the configurations
The Organisation that owns the FareProduct
Configuration for a purchased Fare Product
originatingFromProductIdThe ID of the entitlement product that allowed the sale discount right to be used
elementIdUnique ID for this specific PurchasedFareProduct. Note that this ID is only for distinguishing parts of an orderLine. It has no use outside of the orderLine, and can't be found in any other service.
Configuration for a Discount Right
Classification of the products chosen.
validityIdUnique identifier for a purchased FareProduct with validity
amountAmount of priced unit
purchasedProductTypeType of priced unit
fareAgreementNumberFare agreement identifier
PurchasedDiscountUsageParameters
Reference to reserving parameters with price information.
Reference to entitlement products used when calculating price
PurchasedSaleDiscountRight
Reference to a resource available in a different APIs
Price with included tax amounts and an optional rate.
Price with included tax amounts and an optional rate.
Possible additional parameters for the configurations
originatingFromProductIdThe ID of the EntitlementProduct that allowed the SaleDiscountRight to be used.
PurchasedProductType
Type of priced unit
TextInLanguage
langLanguage code according to ISO 639-3
valueA text to describe the contents of this OrderLine
SubMode
The transport sub mode (e.g., localBus or expressBus) used when traversing this leg. Null if leg is not a ride
RailReplacementInfo
originalFromStopPlaceRefThe stop place ref of the original train station where the passenger would have boarded.
originalToStopPlaceRefThe stop place ref of the original train station where the passenger would have alighted.
PurchasedLeg
idstartTimeThe date and time this Leg begins.
Reference to a resource available in a different APIs
endTimeThe date and time this Leg ends.
Reference to a resource available in a different APIs
Reference to a resource available in a different APIs
Reference to a resource available in a different APIs
Reference to a resource available in a different APIs
modeTravel mode for Leg.
subModeThe transport sub mode (e.g., localBus or expressBus) used when traversing this leg. Null if leg is not a ride
Reference to a resource available in a different APIs
Reference to a resource available in a different APIs
organisationIdThe organisation that owns the service journey on this leg, Alternative identifier to authorityRef or operatorRef.
Connected ServiceJourneys without changing material
lineIdLine ID
serviceJourneyPrivateCodePrivate code of the ServiceJourney
Present only when this leg is a rail replacement bus service. Contains the original train station stop place references that were used for pricing.
PointToPointValidity
fromPlaceValid from StopPlace
toPlaceValid to StopPlace
ZonalValidity
fareZonesValid in fare zones
groupOfTariffZonesReference to a group of tariff zones. All zones in the group are valid.
zonesValid in zones. Deprecated. This list will be empty when tariff zones are fully replaced by fare zones.
PurchasedFareProductValidity
validityIdUnique identifier for a purchased FareProduct with validity
Start and StopPlaces where the entity is valid
Zones where the product is valid
Distance
valueThe distance value.
unitUnit of distance measurement.
TravelSpecification
The FareProductValidities for a product.
The Legs of a planned travel route. Only Legs which are rides are expected to be added.
The StopPlaces the product is valid between. The first element in this array will be the StopPlace the Traveller is travelling from, and the second element will be the StopPlace the Traveller is travelling to. There will never be more than two elements in this array.
aimedStartTimeTimestamp used when determining the beginning of the ticket's validity. Taken from the offer used by the end user when ordering the ticket. Note that the fallback timestamp is the timestamp at which the orderLine was added to the Order.
aimedEndTimeTimestamp used when determining the end of the ticket's validity. Taken from the offer used by the end user when ordering the ticket. No fallback, null if not available on offer.
A distance value with a unit.
PurchasedTraveller
travellerIdID for Traveller
Entitlement information for the customer and the OrderLine
givenConsentIdTravelDocumentDetails
Reference to a resource available in a different APIs
distributionActionDistributionDetails
Reference to a resource available in a different APIs
Reference to a resource available in a different APIs
Reference to a resource available in a different APIs
distributionHolderCustomerIdReference to a customer who will use the travel right
OrderLineRequest
Price with included tax amounts and an optional rate.
Price with included tax amounts and an optional rate.
The underlying FareProducts which make up this SalesPackage.
Description.
The Travellers that are to travel on this OrderLine.
idId for an OrderLine, required when updating orderLines
Reference to a resource available in a different APIs
Possible additional parameters for the configurations
privateCodePrivate code.
externalReferenceExternal reference to another system supplied by the client.
Wrapper for references connected to distribution of travel rights and/or tickets
Classification of the products chosen.
effectiveCancellationDateIf set, the effective date for cancellation. Overrides timestamp.
A map of client provided data. No validation is performed, and no guarantee can be made about its contents.
externalConfirmationExternal confirmation status for this OrderLine. Allowed values: PENDING, SUCCESS, FAILED.
OrderLine
idID of OrderLine
versionVersion of this OrderLine. This is iterated when the OrderLine is updated, but not when it is replaced.
statusStatus of this Order or OrderLine. Every Order starts out with the status DRAFT, and can only be changed to CONFIRMED when it is balanced - when balance is '0.00'. All OrderLines that are have the status DRAFT at that point in time can also be changed to CONFIRMED.
createdAtTimestamp for when the OrderLine was created.
Price with included tax amounts and an optional rate.
Price with included tax amounts and an optional rate.
The underlying FareProducts which make up this SalesPackage.
Description.
The Travellers that are to travel on this OrderLine.
cancellationCancellation reason for an OrderLine. OrderLines with REPLACED have been replaced with a newer version.
lastConfirmedAtTimestamp for when the OrderLine was last confirmed.
refundedIf true = refunded, false = cancelled, null = active
Metadata about who or what added the OrderLine.
Reference to a resource available in a different APIs
Possible additional parameters for the configurations
privateCodePrivate code.
externalReferenceExternal reference to another system supplied by the client.
Wrapper for references connected to distribution of travel rights and/or tickets
Classification of the products chosen.
effectiveCancellationDateIf set, the effective date for cancellation. Overrides timestamp.
A map of client provided data. No validation is performed, and no guarantee can be made about its contents.
externalConfirmationExternal confirmation status for this OrderLine. Allowed values: PENDING, SUCCESS, FAILED.
PaymentRef
orderVersionOrder version number this Payment confirmed.
amountThe Payment amount. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022.
currencycompletedAtTimestamp for when Payment was completed
paymentIdReference to the Payment.
creditIdReference to the Credit.
settlementIdSupplied to the client by an external system for handling settlements. For Internal Entur Clients this is Entur’s Electronic Journal.
PurchasedReservation
reservationIdID and version of the Reservation.
Reference to a resource available in a different APIs
Traveller
idCustomer reference.
FeeRequest
Price with included tax amounts and an optional rate.
typeType of Fee. Valid types: MANUAL, REFUNDING, ONBOARD, CHANGE, INVOICE, CHANGE_NON_REFUNDABLE, PENALTY, BOOKING, REDUCTION
reasonExplanatory text describing the reason for the Fee, if applicable
orderLineIdsReferences to the OrderLines this Fee refers to, if applicable. If empty, the fee refers to all order lines
Fee
idID used to uniquely identify Fee if deletion is necessary
Price with included tax amounts and an optional rate.
typeType of Fee. Valid types: MANUAL, REFUNDING, ONBOARD, CHANGE, INVOICE, CHANGE_NON_REFUNDABLE, PENALTY, BOOKING, REDUCTION
reasonExplanatory text describing the reason for the Fee, if applicable
orderLineIdsReferences to the OrderLines this Fee refers to, if applicable. If empty, the fee refers to all order lines
ContactInfo
Customer reference.
Customer reference.
SpecialOrderCause
causeCodeThe cause code for issuing the Order.
organisationIdThe organisation responsible for the cause. Eg. the Operator responsible for the delay causing a zero ticket to be issued. Should not be confused with the organisationId of the Order, as this has no correlation.
OrderRequest
Contact information related to different aspects in the lifecycle of an Order.
externalReferenceExternal reference for Orders
expireAtAny changes not confirmed before this point in time will be discarded. Default is 20 minutes from the last operation. Cannot be in the past, or further into the future than six months.
Holder for fields used to explain why an Order has been issued. Used for zero tickets.
Order
idID of Order.
versionThe system increments an Order’s version number whenever some change occurs that causes the Order’s status to go from CONFIRMED to DRAFT. The user has to perform an action that causes the status to go from DRAFT to CONFIRMED (such as paying for the Order) before the time given in expireAt. If the Order is not confirmed within this time, the system will scrap all changes (including the incremented version) and return the Order to its last confirmed version.
statusStatus of this Order or OrderLine. Every Order starts out with the status DRAFT, and can only be changed to CONFIRMED when it is balanced - when balance is '0.00'. All OrderLines that are have the status DRAFT at that point in time can also be changed to CONFIRMED.
totalAmountThe total amount due for this Order.
balanceThe balance amount for this Order.
totalTaxAmountThe total tax amount for this Order.
currencyThe currency for this Order.
OrderLines in the given Order.
Payment references used on this Order.
Seating Reservations connected to this Order.
Unique Travellers in this Order.
organisationIdID of the organisation which created/sold this Order.
createdAtTimestamp for when Order was created.
Fees contained in the Order.
failedIndicates that the order version has failed and needs to be credited.
lastConfirmedAtTimestamp for when Order was last confirmed.
posPoint-of-sale reference of request used when Order was created
distributionChannelIdDistribution channel ID of request used when Order was created
Contact information related to different aspects in the lifecycle of an Order.
externalReferenceExternal reference for Orders
expireAtAny changes not confirmed before this point in time will be discarded. Default is 20 minutes from the last operation. Cannot be in the past, or further into the future than six months.
Holder for fields used to explain why an Order has been issued. Used for zero tickets.
PageOfOrder
Items on a specific page
totalItemsTotal number of items
totalPagesTotal number of pages available to browse
ApiError
titleShort, human-readable summary of the problem
timestampstatuserrorexceptionmessagepathOrderCreateRequest
Contact information related to different aspects in the lifecycle of an Order.
currencyThe currency for this Order.
externalReferenceExternal reference for Orders
expireAtAny changes not confirmed before this point in time will be discarded. Default is 20 minutes from the last operation. Cannot be in the past, or further into the future than six months.
organisationOverrideDeprecated. Use header Entur-On-Behalf-Of instead. If present, the Order will be created on behalf of the given organisation ID, rather than the organisation associated with the token. Requires special agreements before use is allowed.