Käyttöönotto - MaaS operaattori

Owned by Helmi Tuori
Last updated: Aug 08, 2023
1 min read

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 saada Maritime MaaS -rajapinnassa olevia lipputuotteita omaan palveluusi myyntiin, toimi seuraavasti:

  1. Tutustu Maritime MaaS -rajapinnan tekniseen dokumentaatioon

    Dokumentaatio koostuu seuraavista sisällöistä:
    1. Liikennöintitiedon GTFS skeema-kuvaukset (GTFS Attributes)
    2. Booking-API -kuvaukset (lipun osto ja näyttäminen)
    3. Lippudatamalli-suositus (Ticket Data model)

  2. Maritime MaaS APIssa olevan datan käyttö edellyttää sopimusta datan tuottavan liikennöitsijän kanssa


    Tässä vaiheessa näet liikennöitsijät ja heidän rajapinnassamme olevat tuotteensa täältä (Lipputuotteet)

    Liikennöitsijät valitsevat itse reitit ja tuotteet, jotka avaavat rajapintaan. Voit aina olla yhteydessä liikennöitsijään, ja ehdottaa itsellesi kiinnostavan reitin ja tuotteiden tuontia rajapintaamme.

  3. Ole yhteydessä liikennöitsijään lipputuotteiden jälleenmyynnistä, sovitte yhdessä:

  • Jälleenmyyntikomissiosta

  • Asiakaspalvelun organisoinnista lippuostojen ja mahdollisten ongelmatilanteiden osalta

  • Rajapinnan kautta ostettujen lippujen myyntihinnan tilittämisestä liikennöitsijälle

4. Kun sopimus jälleenmyynnistä on solmittu

  1. Ota yhteys meihin lähettämällä sähköpostia osoitteeseen: katso ajantasainen yhteystieto täältä

  2. Lisää aihekenttään oman yrityksesi nimi sekä tunniste Integroitumispyyntö (esimerkiksi: Forum Virium Helsinki/ integroitumispyyntö)

  3. Kerro viestissä, että yrityksesi on solminut jälleenmyyntisopimuksen toimijan X kanssa (yrityksen nimi ja yhteyshenkilö) ja haluaisit nyt ohjeet rajapintaan integroitumista varten

  4. Lähetä tästä ensimmäisestä integroitumispyyntö-viestistä näkyvä kopio (cc:) jälleenmyyntisopimuksen sopimusosapuolen yhteyshenkilölle

  5. Tulemme varmistamaan jälleenmyyntisopimuksen olemassaolon ja ohjeistamme sinua tästä eteenpäin integroitumiseen tarvittaen toimenpiteiden kanssa.


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

Vesiliikenteen MaaS -hanke - Maritime MaaS project
Marite MaaS API documentation 2021-2022
Forum Virium Helsinki & City of Helsinki