Käyttöönotto - Liikennöitsijä

Olemme varautuneet tarjoamaan rajattua käyttöönoton tukea uusille toimijoille kaudella 2022. Tutustu alla olevaan käyttöönoton perusvaiheistukseen, tutustu linkitettyyn tekniseen dokumentaatioon, ja ole yhteydessä tuki-meiliin. Autamme sinut käyttöönoton läpi.

Kun haluat tarjota lipputuotteitasi muiden toimijoiden saataville Maritime MaaS -rajapintaan, toimi seuraavasti:

Muodostat liikennöintitiedosta .txt-muotoisia GTFS-feedejä, ja julkaiset feedit sisältävän pakatun .zip-tiedoston avoimeen endpointiin

Liikennöintitieto sisältää rajapintaan tuotujen reittien liikennöitsijä-, aikataulu-, reitti-, pysäkki-, lipputuote-, hintaryhmä- ja käyttöehtotiedot. Liikennöintitiedon avulla edellä mainitut tuotteitasi koskevat tiedot voidaan tarjota ennen lipun ostoa asiakkaalle tarkasteltavaksi.

GTFS-feedit ja feedien attribuutit näet dokumentaatiosta täältä (GTFS Attributes)
Toteutat Maritime MaaS -speksin mukaisen lipunmyyntirajapinnan omaan lipunmyyntijärjestelmääsi

Kytkeytymällä Maritime MaaS -rajapintaan mahdollistat lippukyselyt ja ostot rajapinnan kautta lipunmyyntijärjestelmääsi.

Lipunoston booking-endpointien kuvauksen näet dokumentaatiosta täältä (Technical documentation)
Varmistat, että lippujärjestelmäsi generoi suosituksemme mukaista lippudataa

Lippudatan avulla jälleenmyyjä kykenee esittämään lipputuotteesi sen ostaneelle asiakkaalle siten, että lippu sisältää kaiken sen käytön kannalta keskeisen informaation.

Lippudatamallin suositukseen voit tutustua dokumentaatiossa täällä (Ticket Data model)
Toistaiseksi kaikki Maritime MaaS -rajapintaan avatun datan käyttö edellyttää sopimuksen solmimista liikennöitsijän kanssa tämän lipputuotteiden jälleenmyynnistä (liikennöintitieto ja lipunmyyntirajapinnat). Solmit siis jälleenmyynnistä halukkaan jälleenmyyjän kanssa sopimuksen, ja tämän jälkeen jälleenmyyjä on tässä wikissä olevien ohjeiden mukaisesti yhteydessä meihin prosessin loppuunsaattamiseksi.

Jälleenmyyntisopimuksen yhteydessä suosittelemme käymään läpi myös seuraavat asiat:
- Jälleenmyyntikomissio
- Asiakaspalvelun organisointi lippuostojen ja mahdollisten ongelmatilanteiden osalta
- Rajapinnan kautta jälleenmyytyjen lippujen myyntihinnan tilittäminen organisaatiollesi

Rajapintaan liittyviin teknisiin kysymyksiin saa tukea lähettämällä kysymykset osoitteeseen: katso ajantasainen yhteystieto täältä