Schemas
IdAndVersionRef
idId reference to an external entity
versionOptional version reference to an external entity
CustomerEntitlement
A holder for an id and version combination
contractIdThe id of a benefit-contract that gives a customer an entitlement
A holder for an id and version combination
Customer
customerIdCustomer id that will be linked to the order line created from the offer specified
The entitlement data for a customer; used if the the offer is created with entitlements
RefType
idValue to identify a given resource
versionOptional version for a given resource
DistributionDetails
OfferConfiguration
offerIdThe id of the offer that is used
A holder for a customers entitlements
Customers with optional entitlement data; used to link travellers to order line and when offers are created with entitlements
Wrapper for references connected to distribution of travel rights and/or tickets
externalReferenceExternal reference to an order line. Only used by external operators to identify order lines created by OfferConfigurations
selectableProductIdsA list of ids for selected products. Duplicates are only supported for SupplementProducts which does not modify seating assignments for the PreassignedFareProduct
selectedTravellerIdsThis field is used to specify which travellers will be included in the use of this offer. This field cannot be used in combination with count. It is validated against the travellers identified in the travellerMappings property of the selected Offer, as well as the legal number of UserProfiles per compartment when reserving a group product. When reserving a group product, validation is performed against the valid number of UserProfiles per compartment. When reserving regular products, a number of order lines will be made, corresponding to the number of selectedTravellerIds. Each order line will have one of the selectedTravellerIds.
countDeprecated: Please use either selectedTravellerIds or multiple offer configurations, depending on your use case. Old description: The number of instances of the salespackage(s), represented in the offer, and customer combination one would like to purchase. Default value = 1. If set to anything other than 1 when orderLineId is set, the endpoint will return 400 bad request.
customerIdsDeprecated: Use customers to supply customer ids
orderLineIdPlease use /change-order-line instead. If replacing an order line, this is the id of the order line to replace
ReserveOffersRequest
A list of offer configurations selected for purchase
orderIdThe offer to add the order to. If no orderId is specified, a new order is created
ReplacedOrderLineIds
originalOrderLineIdsreplacedByOrderLineIdsOrderLineIdsAndReservationIds
orderIdorderLineIdsreservationIdsApiError
timestampstatustitleShort, human-readable summary of the problem
errorexceptionmessagepathChangeOrderLinesConfiguration
offerIdThe id of the offer that is used
orderLineIdThe id of the OrderLine to replace. Multiple offer configurations may contain the same orderLineId if replacing the OrderLine with multiple offer configurations. In that case, selectedOrderLineIds must also be equal.
Customers with optional entitlement data; used to link travellers to order line and when offers are created with entitlements
Wrapper for references connected to distribution of travel rights and/or tickets
externalReferenceExternal reference to an order line. Only used by external operators to identify order lines created by OfferConfigurations
selectableProductIdsA list of ids for selected products. Duplicates are only supported for SupplementProducts which does not modify seating assignments for the PreassignedFareProduct
selectedTravellerIdsThis field is used to specify which travellers will be included in the use of this offer. It is validated against the travellers identified in the travellerMappings property of the selected Offer, as well as the legal number of UserProfiles per compartment when reserving a group product. When reserving a group product, validation is performed against the valid number of UserProfiles per compartment. When reserving regular products, a number of order lines will be made, corresponding to the number of selectedTravellerIds. Each order line will have one of the selectedTravellerIds.
selectedOrderLineIdsChangeOrderLinesRequest
orderIdThe order to add the offer(s) to
A list of change offer configurations selected for purchase
refundPriceDifferenceExperimental value that is used to refund the price difference between the original purchase and the change, if the change is cheaper than the original product.
SelectedProductConfiguration
selectedProductIdA selectable product id.
countThe number of times to add said product. Count will only be considered on a fare product level. Default 1
AddSupplementProductsConfiguration
offerIdThe id of the offer that is used
orderLineIdThe id of the order line to add supplement products to
A list of ids and counts for selected supplement product configurations. Count is only considered for fare products.
Customers with optional entitlement data; used to link travellers to order line and when offers are created with entitlements
AddSupplementProductsRequest
A list of supplement product configurations selected for purchase
orderIdThe order to add the supplement product(s) to
Option
idspecifiedProductstypesversionOrderLineOptions
orderLineIdChangeOption
orderIdTextInLanguage
langThe language of the text
valueThe value of the text in the given language
PriceWithTax
amountAmount including tax amount.
taxAmountTax amount
currencyCurrency
taxRateTax rate
taxCodeTax code for this tax rate
TPPTravelSpecification
aimedStartTimeTimestamp used when determining the beginning of the product's validity.
aimedEndTimeTimestamp used when determining the end of the product's validity.
UserProfile
Versioned Reference to a resource
A human-readable list of names for the product
Price with included tax amounts and an optional rate.
Price with included tax amounts and an optional rate.
Parameters
ThirdPartyProductConfiguration
quantityThe amount of equal third party products to add to the order
Versioned Reference to a resource
A human-readable list of names for the product
Price with included tax amounts and an optional rate.
Price with included tax amounts and an optional rate.
authorityIdOwner of the product.
externalReferenceExternal reference to an order line. Only used by external operators to identify order lines created by ThirdPartyProductConfigurations.
A map of client provided data to be placed on the order line. No validation is performed, and no guarantee can be made about its contents.
customerIdsEntur customer ids that will be linked to the order line created
Optional travel information for the order lines to be created
Wrapper for references connected to distribution of travel rights and/or tickets
Similar to OrderLine.fareProducts.parameters, but with additional fields for third party products.
ReserveThirdPartyProductsRequest
orderIdThe orderId the third party products belongs to.