# Ski Pass

# 1. List of Regions

Get available regions for display /skipass/regions (opens new window)

# 2. Get specific Region

After selection a region we can get available durations for that region and date.

# 2.1 Variants ( Optional )

Optional call to get filter options that can be displayed (e.g. media restrictions, 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

# 2.2 Prices ( Optional )

Optional call to get possible price options for a selected date range, the difference to offers is that prices are purely informational, nothing is persisted in the system about them, how expensive this call is depends on whether variants are filtered or not and how big the date interval is. Expect it to be more expensive than requesting offers.

# 3. Offers

Retrieving offers that can be put into cart (they also have prices), offers are persisted in the (external) system and expire after some (given) time, expect generating offers to be rather expensive. You will get offer variants and necessary personalization

# 4. Add to cart

# Remarks

Different from above /skipass/variants and /skipass/prices can also be called with date range before a date has been selected. With that a price overview according to a selected (or all) restrictions can be given.

Experience shows that a integrator can expect that reduction restrictions and also media restrictions are available throughout a skiing season e.g. if keycard media is available at the begin of the season one can also expect that it will be available at the end. The same is true for e.g. child skiing passes. However, in theory this must not be the case.

Currently contingents are only considered at payment time so neither creation of an offer nor putting a skiing ticket into cart influences the contingent.

Currently the following media types are available:

  • pickup - customer picks up the skiing ticket in the ski area at some point of sale
  • mailing - customer gets send the skiing ticket by mail
  • keycard - customer has a Keycard to which the permission of the skiing ticket can be associated
  • swisspass - customer has a SwissPass to which the permission of the skiing ticket can be associated

# Glossary

contingent - usually that means that only a specific amount of tickets is available before they are sold out, there is also the possibility of a minimum contingent, when e.g. some event only happens after X people registered their attendance

duration - time range for which a skiing pass can be used, there are several categories which are discrete, it cannot be expected that there are e.g. only day passes

media - the available possibilities which can be used as medium for skiing passes (e.g. SwissPass, some keycard)

offer - the possibility to buy a certain combination of tickets (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

personalization - the process of tailoring a ticket to a specific person, the amount of data needed for personalization of a ticket can vary, it can also be possible that a ticket is unpersonalized i.e. anonymous

reduction - the issuer may decide to give away certain skiing passes cheaper, when we use reduction we usually mean skiing passes that vary in price according to age (e.g. junior, adult, senior etc.)

region - some ski areas contain of (distinct) subsets that could have different prices and/or opening hours, length of season etc.

season - a period of time when the skiing region is generally open which means that the ski lifts are available and the pistes are maintained

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. region, duration) others change (e.g. media type, reduction)

← Adventures (Events) →