# Package Travel
Package travel is meant to bundle products together to get a custom package of different services in one place for the user to book. Accommodations are the main products; all other product types could be the add-on products of the bundle. Normally a package definition belongs to a campaign, which means the offer is valid for a certain period, the add-on products do have special prices for this campaign.
# 1. Product Overview
First we need to get an overview about the product, generell information like duration, are there any reductions and most important which services are included in the package.
# 2. Variants ( Optional )
Retrieve optional variants to get filter options for package travel products that can be displayed (e.g. age groups), those possible filter options can be also retrieved from the offers, by getting them beforehand one would be able to (depending on the UI) to save effort for subsequent offer requests by maybe also caching filter options for some time, expect this call to be nearly as expensive as creating offers, the value of it comes in with caching
# 3. Offers
Get offers of package travel products that can be put into cart (they also have prices), offers are persisted in the system and expire after some (given) time, expect generating offers to slightly be more expensive than requesting prices for a single day.
# 4. Configure Services
# 4.1 Skipass
At the package travel product endpoint we already received some information about the skipass service. We know for which region(s) the skipass is available and also the possible durations. The first skiing day is determined by either the first day of stay or by the date the user selects. We also know the reduction and hence the age because the package travel product should have been configured for a specific reduction already.
So we don’t need the packagetravel/serviceVariants endpoint but we could use it if some variants would not be restricted already and still to choose. To avoid reduction to reduction mappings between the product categories (as there could be different names for reductions) we have to work with the age instead. Either the customer has defined a birthdate age already or we have to pick one age from the selected reduction.
# 4.1.1 Service Offer
WARNING
We now cannot use the cart endpoint but we have to retain the offer data and then put the skipass into cart together with the package travel product.
# 4.1.2 Service Variants
If we need the variants endpoint we have following call.
# 5. Cart
We now have to put everything into cart. With everything the package travel offer as well as the services for the additional services are meant. This has to happen before the offers expire.
# Glossary
main traveller - the buying customer. Most of the time it is irrelevant who is the main traveller unless there are services which are configured only once for all travellers together (e.g. accommodation). Such services will be associated to the main traveller. Having such services puts restrictions on removing travellers later on in cart.
offer - the possibility to buy a certain combination of products (those being offered) in a specified amount of time until the offer expires, when buying offers in the specified amount of time one can expect that this will be successful, requesting offers could lead to some sort of reservation being made
package travel - a bundle of services which is offered for a certain price, some services may be included some may needing extra buying, often an extra service has a special discount, services may be consumable once, several times or an unlimited number of times
personalization - the process of tailoring a offer to a specific person, the amount of data needed for personalization of a offer can vary, it can also be possible that a offer is unpersonalized i.e. anonymous (which is unlikely in case of package travel)
reduction - the issuer may decide to give away certain package travel products cheaper, when we use reduction we usually mean package travel products that vary in price according to age (e.g. child, adult etc.)
service - some offer that is part of a package travel product, in general a service can be of any type which may be also offered on its own (like e.g. skipass, accommodation, event etc.), when bought as part of a package travel the service might be included or cheaper, the service may be consumable once, several times or an unlimited number of times
variant - sub-part of an offer, a price is attached to it, while certain parameters of the offer are fixed across all variants (e.g. first day of stay) others change (e.g. duration, reduction)