Lippu- ja maksujärjestelmän toiminnallinen määrittely



Samankaltaiset tiedostot
Lippu- ja maksujärjestelmän toiminnallinen määrittely

HSL:n lippujen hinnat alkaen

alkaen. Lippujen hinnat

PILETTI Kaupunkiseutujen joukkoliikenteen lippu- ja maksujärjestelmä

Helsinki, Espoo Kauniainen, Vantaa, Kerava Sipoo Tuusula tai Kirkkonummi Siuntio

HSL-lippujen hinnat 2017

PILETTI-hankkeen esittely. Jyväskylä

PKS:n seutulippujen hinnat LIITE 1

PKS:n seutulippujen hinnat LIITE 1

HELSINGIN SEUDUN JOUKKOLIIKENTEEN TAKSA- JA LIPPUJÄRJESTELMÄ ALKAEN

Asiakaspalvelu- ja myyntipiste/-itä tulee olla pääsääntöisesti kaikissa linjan vaikutusalueen kunnissa.

Espoon ja Kauniaisten sisäisten lippujen hinnat

Joukkoliikenteen lippu- ja maksujärjestelmä. Järjestelmän ja palvelun kuvaus Helge Finnberg

HSL:n lippujen hinnat 2014

WALTTI-lippu ja maksujärjestelmä

Waltti lippu- ja maksujärjestelmä Kokemuksia käyttöönotosta Jyväskylästä

Lippu- ja maksujärjestelmä ja sen vaatimukset on kuvattu tarkemmin seuraavissa alaliitteissä:

LAPPEENRANNAN ALUEEN MAASEUTULIIKENTEEN WALTTI -KÄYTTÖÖNOTTO

AIKATAULUYHDISTELMÄ LAHDEN SEUDUN LIIKENNE ORIMATTILA - HENNA LAHTI - HENNA - HELSINKI

SUOMI. Lippujen hinnat

Tampereen seudun ja Pirkanmaan joukkoliikenteen taksajärjestelmät ja vyöhykerajat

5. Lippu- ja maksujärjestelmän kuvaus

PILETTI. Toiminnallinen määrittely. v. 0.47

Lippu- ja maksujärjestelmän kuvaus

WALTTI LIPPU- JA MAKSUJÄRJESTELMÄUUDISTUS MIKÄ MUUTTUU KOTKAN SEUDULLA?

Matkakortin kelpoisuus. Sisällys. Matkakortin kelpoisuus... 3

Liikenteenharjoittajan vastuut, tehtävät ja oikeudet

Liikenteenharjoittajan toteuttama lippujärjestelmä perustuu kilometritaksaan.

Viranomaisten lippu- ja maksujärjestelmän palvelu- ja myyntiohje LUONNOS

5. Lippu- ja maksujärjestelmän kuvaus

Pääkaupunkiseudun joukkoliikenteen taksa- ja lippujärjestelmän 2014 alustava kuvaus

5. Lippu- ja maksujärjestelmän kuvaus

Linkki. Liput, hinnat ja vyöhykkeet. Fiksusti liikkeellä. Jyväskylän seudun joukkoliikenne SUOMI

5. Lippu- ja maksujärjestelmän kuvaus

Linkki. Liput, hinnat ja vyöhykkeet. Fiksusti liikkeellä. Jyväskylän seudun joukkoliikenne SUOMI

Asiakaspalvelu- ja/tai myyntipiste tulee olla pääsääntöisesti kaikissa linjan vaikutusalueen kunnissa.

PILETTI. Tekninen vaatimusmäärittely. v. 0.2

PILETTI-hanke. Bussialan seminaari

Lippu- ja maksujärjestelmävaatimukset

Taksavyöhykkeiden määrittely ja lippujen hinnoittelu (Päivitetty )

HELSINGIN SEUDUN JOUKKOLIIKENTEEN TAKSA- JA LIPPUJÄRJESTELMÄ ALKAEN

TARJOUSPYYNNÖN LIITE Viiveajan lippu- ja maksujärjestelmä

Toiminnallinen määrittely versio 1.2

HSL Matkakortin ja Android- kirjaston kuvaus kehittäjille

5. Lippu- ja maksujärjestelmän kuvaus

Näin käytät joukkoliikennettä Helsingin seudulla

KAUPUNKIYMPÄRISTÖN PALVELUALUE Suunnittelupalvelut LIPPU-, MAKSU- JA INFORMAATIOJÄRJESTELMÄ

PKS:n seutulippujen hinnat LIITE 1

PKS:n seutulippujen hinnat LIITE 1

Poikkeusinfo XML-rajapinnan kuvaus, rajapinnan versio 2 Seasam Group

WALTTI-LIPUT KÄYTTÖÖN MIKKELIN KAU- PUNKI- JA MAASEUTULIIKENTEESSÄ ALKAEN

Lippu- ja maksujärjestelmien kuvaus liikenteenharjoittajan tarjoama lippu- ja maksujärjestelmä

UUSI LIPPU- JA TARIFFIJÄRJESTELMÄ WALTTI 2015

TEKNINEN MÄÄRITTELY. Matkahuollon osoitekorttihaun rajapinta. Ismo Koskinen

Lappeenrannan kaupungin joukkoliikenteen palvelu- ja myyntiohje asiakaspalvelutyöhön ja kuljettajille

Lippu- ja maksujärjestelmien kuvaus liikenteenharjoittajan tarjoama lippu- ja maksujärjestelmä

ELY-KESKUKSEN WALTTI-LIPUT KUOPION LIIKENNEALUEELLA

Attribuutti-kyselypalvelu

LIPPU JA MAKSUJÄRJESTELMÄN KUVAUS

Lippu- ja maksujärjestelmien kuvaus

Jyväskylä Tuomo Kojo Linja- autoliitto

Näin lataat Waltti-matkakortin verkossa!

Alueellinen lippujärjestelmäyhteistyö käytännössä

Kuopion kaupunki Pöytäkirja 7/ (1) Kuopion kaupunkiseudun joukkoliikennelautakunta Asianro 6085/08.01.

Joukkoliikenne ja sen maksuliikenne

MIKKELIN PAIKALLISLIIKENNE AIKATAULUT Lataa aikataulut mukaasi tästä!

Liikennepalvelulain mukaiset yhteentoimivuuden vaatimukset. Laura Langer, Liikennevirasto

Massahaun tulosten tulkintaa

Ikäryhmät ja alennusryhmät Turun kaupunkiseudun joukkoliikenteessä alkaen. Joukkoliikennejohtaja Sirpa Korte :

5. Lippu- ja maksujärjestelmän kuvaus

5. Lippu- ja maksujärjestelmän kuvaus

OULUN JOUKKOLIIKENTEEN YLEISET MATKAKORTTI- JA MATKUSTUSEHDOT

Helsingin seudun liikenne

EUROOPAN PARLAMENTIN JA NEUVOSTON ASETUKSEN (EY) n:o 1370/ ARTIKLAN 1. KOHDAN MUKAINEN YHDISTELMÄRAPORTTI VUODELTA 2016

LAVIAN JOUKKOLIIKENNE. Linjojen 68 ja 69 aikataulut ja reitit. Kertalipun ostaminen ja vaihtoaika TIEDOTE

Vaatimusmäärittely Ohjelma-ajanvälitys komponentti

Helsingin seudun liikenne

Etelä-Kymenlaakson henkilökuljetusyksikkö. Asiakirjatyyppi. Raportti. Päivämäärä. Helmikuu 2018

Kaupunkipyörät ja potkulaudat + Vyöhykeuudistus

Kuopion kaupunki Pöytäkirja 7/ (1) Kuopion kaupunkiseudun joukkoliikennelautakunta Asianro 3719/08.01.

Tietojen toimittaminen Skeemat Käsittelypalautteen kysely Kansallisen tulorekisterin perustamishanke

Myyntitilaus -tiedoston kuvaus

Tekninen rajapinta Zip-tiedosto sovelluskehittäjälle Kansallisen tulorekisterin perustamishanke

Kuopion kaupunki Pöytäkirja 8/ (1) Kuopion kaupunkiseudun joukkoliikennelautakunta Asianro 6085/08.01.

Jyväskylän toimivalta-alueen yhdistelmäraportti 2017

Muutokset suoran sanoma-asioinnin webservicepalvelun

Lippu- ja maksujärjestelmän kuvaus

KOUVOLAN JOUKKOLIIKENTEEN OSTOSOPIMUS ALKAEN YLEISINFO KAUPUNGISTA JA LIIKENTEESTÄ

Tekninen rajapinta Zip-tiedosto sovelluskehittäjälle Kansallisen tulorekisterin perustamishanke

AIKATAULUT MOPPE PALVELULIIKENNE

Tekninen dokumentti. TEKNINEN DOKUMENTTI Versio (24) Versio ja pvm Laatinut Tarkastanut Hyväksynyt.

Jyväskylän toimivalta-alueen yhdistelmäraportti 2016

ELY-keskuksen toimivalta-alueen lippu- ja maksujärjestelmien kuvaus a) viiveaikana ja b) viiveajan jälkeen

TEKNINEN MÄÄRITTELY. Matkahuollon toimipistehaun rajapinta. Ismo Koskinen

Tuomiorekisterin ratkaisuhaun kehittäminen

KESKI-SUOMEN ELY-KESKUKSEN JOUKKOLIIKENTEEN YLEISET MATKAKORTTI- JA MATKUSTUSEHDOT

EUROOPAN PARLAMENTIN JA NEUVOSTON ASETUKSEN (EY) N:o 1370/ ARTIKLAN 1. KOHDAN MUKAINEN YHDISTELMÄRAPORTTI VUODELTA 2011

HSL:N ESITYS UUDEN TAKSAVYÖHYKEMUUTOKSEN YHTEYDESSÄ TOTEUTETTAVISTA ERITYISRYHMIEN ALENNUS- JA VAPAALIPPUJEN MUUTOKSISTA Pääkaupunkiseudun

Waltti ja yhteiskäyttöisyys Yhteentoimivuuden toteuttaminen käytännössä

Transkriptio:

Lippu- ja maksujärjestelmän toiminnallinen määrittely Tuote- ja tariffirajanta Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy

Sisällysluettelo 1 Osajärjestelmän kuvaus... 1 2 Prosessit... 2 2.1 Tuote-ja tariffirajannan liittyminen kokonaisjärjestelmään... 2 2.2 Osajärjestelmän määritelmät... 2 2.2.1 Liikennöitsijän järjestelmä... 2 2.2.2 Siirtotiedostot... 2 2.3 Korttien sulkulista (Blacklist.xml)... 3 2.4 Yleiset ohjaukset (CommonParams.xml)... 3 2.4.1 Sulkulistastatus ja ohjaus... 3 2.4.2 Päivätyyt... 4 2.4.3 Taksa kalenteri... 4 2.4.4 Kouluryhmä kalenteri... 4 2.4.5 Koulu/Koulukalenteri (lisätty versiossa 1.4)... 4 2.4.6 Asiakasryhmät... 5 2.4.7 Asiakasryhmien ikärajat... 5 2.4.8 ALV Ryhmät... 5 2.4.8.1 ALV Tekstit... 5 2.5 Paperiliput (Singleticket.xml)... 6 2.5.1 Kertalippu (tekniset käytettävät tunnisteet productgroup=4 productid=20)... 6 2.5.1.1 Kertalippujen vaihtoajat... 6 2.5.1.2 Paperilippujen tekstit... 6 2.6 Korttituotteet (Cardparams.xml)... 6 2.6.1 Yleiset korttiparametrit... 6 2.6.2 Lipputuotteet korteille... 7 2.6.2.1 Lipputuotteiden vaihtoajat... 8 2.6.2.2 Lipputuotteiden voimassa päivätyypeittäin... 8 2.6.3 Kausilipun ohjaustiedot... 8 2.6.4 Arvolipun ohjaustiedot... 9 2.7 Hinnoittelu (Fareparams.xml)... 9 2.7.1 Paperilipun hinnoittelu... 9 2.7.1.1 Paperilippujen hinnat vyöhykkeittäin... 9 2.7.2 Kausituotteiden hinnoittelu... 10 2.7.2.1 Kausilippujen hinnat vyöhykkeittäin... 10 2.7.3 Arvolipun hinnoittelu... 10 2.7.3.1 Arvolipun hinnat vyöhykkeittäin... 11 2.8 Kertakorttilippu ja sen hinnoittelu (travelcard.xml)... 11 2.8.1 Kertakorttilipun hinnat vyöhykkeittäin... 11 2.9 Ryhmälippu (Otherticket.xml)... 11 3 Käyttötapaukset ja toimijat... 12 4 Käyttöoikeudet ja käyttäjähallinta... 12 5 Käsitemalli... 12 6 Integraatiot... 12 6.1 Liikennöitsijäjärjestelmät... 12 6.2 Tarkastajajärjestelmät... 12 Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy

7 UI demo/proto... 12 8 Muutoshistoria... 13 Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy

Tuote- ja tariffirajannan kuvaus 1 Osajärjestelmän kuvaus Piletti määrittelyiden mukainen matka- ja kertakorttisovelluksien käsittely on teknisesti ja somuksellisesti mahdollista kaikkien laite- ja ohjelmistovalmistajien toimesta. Määrittelyt ovat avoimet ja toimittajariippumattomat. Piletti ottaa käyttöön avoimen tiedonsiirtorajannan, joka mahdollistaa kaikkien laitetoimittajien toteuttaa Piletti korttien käsittelyssä tarvittavien ohjaustietojen noutamisen Piletti palvelimelta. Sähköistä tiedonsiirtoa varten perustetaan verkkopalvelu. Siirtotiedostoja voidaan hakea palvelusta joko manuaalisesti selainkäyttöliittymän kautta tai automaattisesti, jolloin yhteydenottava järjestelmä lähettää kyselyn, jonka vastauksena saadaan ko. hetkellä olevat uudet siirtotiedostot. Sanomaliikenteellä tarkoitetaan asynkronisia ja synkronisia https protokollan lä välitettäviä sanomia. Yleisesti ottaen kyselysanomat (ohjaustietojen haku) voidaan toteuttaa synkronisina. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 1(13)

2 Prosessit 2.1 Tuote-ja tariffirajannan liittyminen kokonaisjärjestelmään 2.2 Osajärjestelmän määritelmät 2.2.1 Liikennöitsijän järjestelmä Liikennöitsijän tai palveluntuottajan järjestelmän on kyettävä hakemaan tarvittavat ohjaustiedot ja kieltolistat Piletti järjestelmästä sekä välittämään tiedot ajoneuvolaitteille ja/tai myyntilaitteille. Järjestelmän tulee sisältää ominaisuudet, joiden avulla määriteltynä ajankohtana voimaan tulevat ohjaustiedot voidaan välittää etukäteen ajoneuvolaitteille. 2.2.2 Siirtotiedostot Siirtotiedostot ovat XML-dokumentteja, joiden schemat on kuvattu erikseen. Uusi ohjaustieto korvaa aina vanhan kokonaisuudessaan voimaantulohetkestä alkaen. Poikkeuksen tekee tariffitiedot, joita voi olla myös sisäkkäin voimassaolevia versioita. Siirtotiedostoja ovat: Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 2(13)

sulkulista blacklist.xml yleiset ohjaukset commonparams.xml paperiliput singleticket.xml korttituotteet cardparams.xml hinnoittelu fareparams.xml matkailijaliput travelcard.xml muut liput otherticket.xml Tässä dokumentissa kuvataan siirtotiedostoon tulevat tapahtumatyyt ja niiden tietosisällöt. Tietotyyt: X = Alfanumeerinen D = Päivämäärä (muoto vvvv-kk-pp) T = Aika (muoto tt:mm:ss) N = Numeerinen tieto, (desimaaliluku) ilman etunollia C = Kokonaisluku etunollilla 2.3 Korttien sulkulista (Blacklist.xml) Sulkulista tuotetaan automaattisesti kerran vuorokaudessa. Liikennöitsijällä on velvollisuus hakea sulkulistatiedosto kerran vuorokaudessa Piletin verkkopalvelusta ja jakaa sulkulistatiedot matkakortteja käyttäviin laitteisiin. Sulkulista-tiedoston tietueen sisältö on seuraava: Sulkulista <Blacklist> Tyyp Pitu us Suljettu kortti tai sarjan alaraja firstcardnumber X 25 Kortin koko numero Sarjan yläraja lastcardnumber X 25 Kortin koko numero tai 0 Sulkutaso blocklevel N 2 Koodiston mukaan Sulku päivämäärä blockdate D 8 Sulkulistalle kirjauspäivämäärä vvvv-kk-pp Sulkulistalla voi olla sekä yksittäisiä kortteja että sarjasulkuja, jolloin tietueella on suljettujen korttien ala- ja ylärajat. Ala- ja ylärajan kortit ovat myös suljettuja. 2.4 Yleiset ohjaukset (CommonParams.xml) 2.4.1 Sulkulistastatus ja ohjaus Sulkulistastatukset <BlacklistControl> Tyyp Pituu s Sulkutaso blocklevel N 2 1=varastettu 2=kadonnut 3=maksuhäiriö Käyttäjän teksti usertext X 12 Kuljettajan rahastuslaitteelle Leimauksen hyväksyntä operationctrl C 1 0= Leimaus estetty 1= Leimaus hyväksytään Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 3(13)

2.4.2 Päivätyyt Päivätyyp <datetype> Tyyp Pituus Tunnus type N 2 1=arkipäivä 2=lauantai 3=sunnuntai 4=erikoispäivä1 5=erikoispäivä2 Päivätyyn nimi name X 24 Yötaksa alkaa nightstart T 6 tt:mm:ss Yötaksa loppuu nightend T 6 tt:mm:ss 2.4.3 Taksa kalenteri Kalenteri poikkeuspäivät <calendarexcdate> Tyyp Pituus Tuotteenomistaja productownerid N 3 TVV tunnus Päivämäärä calendardate D 8 vvvv-kk-pp Taksan päivätyyp type N 1 1-5 0 = ei vaikutusta kalenteriin 2.4.4 Kouluryhmä kalenteri Koulukalenteri Tyyp Pituu <CalendarSchool> s Tuotteen omistaja productownerid N 3 TVV tunnus Koulukalenterin tunnus datetableid N 3 koulukortin ohjauksessa (000=oletus kalenteri) Vuosi year N 4 miltä vuodelta kalenteri Sallitut päivät alloweddates X 366 poterot vuoden päiville alkaen vuoden ensimmäisestä päivästä 0=ei matkustusoikeutta 1=on matkustusoikeus 2.4.5 Koulu/Koulukalenteri (lisätty versiossa 1.4) Koulu/koulukalenteri Tyyp Pituu <SchoolCalenderMapng> s Tuotteen omistaja productownerid N 3 TVV tunnus Koulu tunnus schoolid N 4 Koulukalenterin tunnus schoolcalendarid N 3 koulukortin tunnus (000=oletus kalenteri) Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 4(13)

2.4.6 Asiakasryhmät Asiakasryhmä Tyyp Pituu <customergroup> s Asiakasryhmän tunnus customergroupid N 1 muutettu versiossa 1.3 0=ei määritelty 1=aikuinen 2=lapsi 3=nuori 4=seniori 5=oskelija 6=koululainen Asiakasryhmän nimi name X 20 2.4.7 Asiakasryhmien ikärajat Asiakasryhmän ikärajat Tyyp Pit <customergroupage> uus Tuotteen omistaja productownerid Nn 3 TVV tunnus Asiakasryhmän tunnus customergroupid N 1 muutettu versiossa 1.3 1=aikuinen 2=lapsi 3=nuori Asiakasryhmän alaraja agemin N 2 0=ei alarajaa Asiakasryhmän yläraja agemax N 2 0=ei ylärajaa 2.4.8 ALV Ryhmät ALV ryhmät Tyyp Pituus <vatgroup> Alv ryhmän tunnus vatgroupid N 4 ALV tunnus tuotteella ALV prosentti vatpercentage N 4,2 Uusi Alv alkaa startdate D 8 Alv muutos alkaa Uusi prosentti newvatpercentage N 4,2 Tuleva alv prosentti Tekstit vattext Erikieliset tekstit 2.4.8.1 ALV Tekstit Alv teksti <vattext> Tyyp Pituus Kielikoodi languagecode C 1 0=suomi 1=ruotsi 2=englanti Alv teksti vattxt X 30 Arvonlisäveron kuittiin tulostettava teksti Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 5(13)

2.5 Paperiliput (Singleticket.xml) 2.5.1 Kertalippu (tekniset käytettävät tunnisteet productgroup=4 productid=20) Paperiliput Tyyp Pituus <PaperTicket> Tuotteen omistaja productownerid N 3 TVV /Liikennöitsijä Lippulaji ticketcode N 4 Lipun tunnus Tuotteen nimi name X 24 Asiakasryhmä customergroup C 1 muutettu versiossa 1.3 1=aikuinen 2=lapsi 3=nuori Alv ryhmä vatgroup N 4 Vaihto transfer C 1 0=ei sallittu 1=on sallittu Vaihtoajat paperticketchangeti Taulukko vaihtoajoista me Tekstit papertickettext Lippulajien tekstit 2.5.1.1 Kertalippujen vaihtoajat Paperiliput vaihtoaika Tyyp Pituus <paperticketchangetime> Vyöhykkeestä fromzone N 2 1-10 Vyöhykkeeseen tozone N 2 1-10 Vaihtoaika changetime N 4 minuutteja A A 2.5.1.2 Paperilippujen tekstit Lippulajitekstit <papertickettext> Tyyp Pituus Kielikoodi languagecode C 1 0=suomi 1=ruotsi 2=englanti Lippulajiteksti, IP readertext X 20 Lippulajiteksti, RAP reporttext X 20 Lippulajiteksti, MYY salestext X 32 2.6 Korttituotteet (Cardparams.xml) 2.6.1 Yleiset korttiparametrit Korttiparametrit <cardparamcommon> Tyyp Pituus Kortin liikkeellelaskija cardapplicationissuer N 6 Esim. 924610 Etäkortin tekninen käyttöikä cardtechage N 2 Vuosia Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 6(13)

Arvon käyttöaika teknisen iän umpeuduttua valueaddtime N 4 Päiviä Arvon hälytysraja valuealertlimit N 3 Saldo, euroa jäljellä Kauden hälytysraja periodalertlimit N 3 Päiviä jäljellä Antipass aika antipasstime N 4 Aika sekunteina Määrittelee kausikorttien yhteydessä ns. antipass ajan. Uudelleen käytön aikaraja reusetimelimit N 4 Aika sekunteina Määrittelee arvolipun oston ryhmälipun ostamiseksi. Ryhmän kasvatus vaihdon yhteydessä groupincrease C 1 0= ei ole sallittu 1= sallittu Virheilmoituksen näyttöaika errormsgtime N 2 aika sekunteina Infonäyttöön siirtymisaika infoscreendelay N 2 aika sekunteina Kortin hinta cardprice N 4,2 Uusi hinta newcardprice N 4,2 Uusi hinta alkaen newpricestartdate D 8 vvvv-kk-pp 2.6.2 Lipputuotteet korteille Liput korteilla Tyyp Pituus <cardticket> Tuotteen omistaja productownerid N 3 TVV /Liikennöitsijä Lippulaji ticketcode N 4 Lipun tunnus Tuotteen nimi name X 24 Tuoteryhmä productgroup C 2 1=kausilippu 2=arvolippu 3=matkailijalippu, kertatuote 5=erikoislippu Tuote producttype C 2 0=kausilippu 1=joustolippu 2=koululaislippu 3=bestpricelippu (4=työmatkalippu) 5=oskelijalippu muutettu versiossa 1.3 16=arvolippu 17=senior lippu 18=kertatuote 19=ryhmätuote Personointi personalized C 1 0=haltijakohtainen 1=henkilökohtainen Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 7(13)

ALV ryhmä vatgroup N 4 Veroprosentit kerrottu ryhmän tiedoissa Vaihto transfer C 1 0 = ei sallittu 1 =on sallittu Vaihtoajat cardticketchangetime Taulukko vaihtoajoista Voimassaoloajat datetypeperiod Päivätyypeittäin voimassaoloajat, koskee lähinnä koululaislippuja sekä seniorlippuja 2.6.2.1 Lipputuotteiden vaihtoajat Lipun vaihtoaika Tyyp Pituu <cardticketchangetime> s Vyöhykkeestä fromzone N 2 1-10 Vyöhykkeeseen tozone N 2 1-10 Vaihtoaika x y changetime N 4 minuutteja A A 2.6.2.2 Lipputuotteiden voimassa päivätyypeittäin Päivätyyp voimassa <datetypeperiod> Tyyp Pitu us Tunnus datetype N 2 1=arkipäivä 2=lauantai 3=sunnuntai 4=erikoispäivä1 5=erikoispäivä2 Voimassa alkaen starttime1 T 6 tt:mm:ss Voimassa asti endtime1 T 6 tt:mm:ss Voimassa alkaen starttime2 T 6 seniorilipulla mahdollista kahdet voimassaoloajat tt:mm:ss Voimassa asti endtime2 T 6 tt:mm:ss 2.6.3 Kausilipun ohjaustiedot Kausilipun ohjaustiedot <periodcontrol> Tyyp Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 8(13) Pitu us Tuotteen omistaja productownerid C 3 TVV / Liikennöitsijä Lippulaji ticketcode C 4 Voimassa perioddays N 3 Voimassa vuorokausia Myös joustolipun, oskelijalipun, työmatkalipun sekä bestprice lipun ohjaus Vuoden voimassa periodyear C 1 0=ei vuosituote 1=voimassa vuoden Annetun ajan dayperiod C 1 0=ei aikarajoitusta

1=aikarajoitus (alkaen asti annetaan myynnin yhteydessä) Matkapäivät/Matkojen määrä periodtrip N 3 Joustolipun matkapäivät Työmatkalipun matkojen määrä kaudella Arvolippu Lippulaji valueticket N 4 Bestprice lipun käytettävä arvolipun hinnoittelu Maksimi matkat/päivä maxtripday N 2 0=ei rajoitettu, käytössä koululaislipulla 2.6.4 Arvolipun ohjaustiedot Arvolin ohjaustiedot <valuecontrol> Tyyp Pitu us Tuotteen omistaja productownerid C 3 TVV / Liikennöitsijä Lippulaji ticketcode C 4 Minimilataus minload N 6,2 Arvon minimilataus Kerrannainen loadstep N 6,2 Latauskerrannainen Maksiarvo maxvalue N 6,2 Suurin sallittu saldo kortilla Arvolipun tunnus valueticket C 4 Voimassaoloajan ulkopuolella käytettävän arvolipun hinnoittelu koskee lähinnä seniorilippua 2.7 Hinnoittelu (Fareparams.xml) 2.7.1 Paperilipun hinnoittelu Paperilipun hinnoittelu<paperticketfar e> Tyyp Pituu s Tuotteen omistaja productownerid N 3 TVV /Liikennöitsijä Lippulaji ticketcode N 4 Lipun tunnus Tariffiversio tariffversion N 4 Palautuu tapahtumassa Voimassaolon alku validstartdatetime DT 18 vvvv-kk-ppttt:mm:ss Voimassaolon loppu validenddatetime DT 18 vvvv-kk-ppttt:mm:ss Asiakasryhmä customergroup C 1 1=aikuinen 2=lapsi 3=nuori Hinnat vyöhykkeittäin paperticketzoneprice Vyöhykkeeltä vyöhykkeelle 2.7.1.1 Paperilippujen hinnat vyöhykkeittäin Paperilipun vyöhykehinnat Tyyp Pitu <paperticketzoneprice> us max 55 kpl Vyöhykkeestä fromzone N 2 1-n (maksimi tvv:n tiedoista) Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 9(13)

Vyöhykkeeseen tozone N 2 1-n (maksimi tvv:n tiedoista) Normaali hinta price N 6,2 normaalihinta Yöveloitus nightprice N 4,2 0=ei yöveloitusta yöveloituksen hinta 2.7.2 Kausituotteiden hinnoittelu Kausilippujen hinnoittelu <periodticketfare> Tyyp Pituu s Tuotteen omistaja productownerid C 3 TVV / Liikennöitsijä Lippulaji ticketcode C 4 Tariffiversio tariffversion N 4 Palautuu tapahtumassa Voimassaolon alku validstartdatetime DT 18 vvvv-kk-ppttt:mm:ss Voimassaolon loppu validenddatetime DT 18 vvvv-kk-ppttt:mm:ss Asiakasryhmä customergroup C 1 1= aikuinen 2= lapsi 3= nuori 4=seniori 5= oskelija 6= koululainen Hinnat vyöhykkeittäin cardticketzoneprice Vyöhykkeeltä vyöhykkeelle 2.7.2.1 Kausilippujen hinnat vyöhykkeittäin Kausilipun vyöhykehinnat Tyyp Pitu <cardticketzoneprice> us Vyöhykkeestä fromzone N 2 Vyöhykkeeseen tozone N 2 Normaali hinta price N 6,2 Normaalihinta max 55 Yöveloitus nightprice N 4,2 0=ei yöveloitusta yöveloituksen hinta 2.7.3 Arvolipun hinnoittelu Arvolippujen hinnoittelu <valuecardticketprice> Tuotteen omistaja productownerid C 3 TVV / Liikennöitsijä Lippulaji ticketcode C 4 Tyyp Pituus Tariffiversio tariffversion N 4 Palautuu tapahtumassa Voimassaolon alku validstartdatetime DT 18 vvvv-kk-ppttt:mm:ss Voimassaolon loppu validenddatetime DT 18 vvvv-kk-ppttt:mm:ss Asiakasryhmä customergroup C 1 1= aikuinen 2= lapsi 3= nuori 4= seniori Hinnat vyöhykkeittäin valueticketzoneprice Vyöhykkeeltä vyöhykkeelle Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 10(13)

2.7.3.1 Arvolipun hinnat vyöhykkeittäin Arvolipun vyöhykehinnat <valueticketzoneprice> Tyy p Pituu s max 55 kpl Vyöhykkeestä fromzone N 2 Vyöhykkeeseen tozone N 2 Normaali hinta price N 6,2 Normaalihinta Yöveloitus nightprice N 4,2 0=ei yöveloitusta yöveloituksen hinta 2.8 Kertakorttilippu ja sen hinnoittelu (travelcard.xml) Kertakorttituote <travelticket> Tyy p Pitu us Tuotteen omistajai productowner C 4 TVV Lippulaji ticketcode C 4 Asiakasryhmä child C 1 1= aikuinen 2= lapsi Versio tariffversion N 4 Palautuu tapahtumassa Voimassaolon alku validstartdatetime DT 18 vvvv-kk-ppttt:mm:ss Voimassaolon loppu validenddatetime DT 18 vvvv-kk-ppttt:mm:ss Lipun voimassaolon alun tyyp starttype C 1 0= lipun voimassaolo annettu 1= lipun voimassaolo ensimmäisestä käyttöönotosta Voimassaoloajan tyyp validitytype C 1 3=päiviä Voimassaoloajan tuus validitylength N 3 Päivien lukumäärä Hinnat vyöhykkeittäin travelticketzoneprice Vyöhykkeeltä vyöhykkeelle 2.8.1 Kertakorttilipun hinnat vyöhykkeittäin Kertakortin vyöhykehinnat Tyy Pituu <travelticketzoneprice> p s Vyöhykkeestä fromzone N 2 Vyöhykkeeseen tozone N 2 Normaali hinta price N 6,2 Normaalihinta Yöveloitus nightprice N 4,2 0=ei yöveloitusta yöveloituksen hinta 2.9 Ryhmälippu (Otherticket.xml) Erikoislippu <groupticket> Tyy p Pitu us Tuotteen omistajai productowner C 4 TVV Lippulaji ticketcode C 4 Versio tariffversion N 4 Palautuu tapahtumassa Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 11(13)

Voimassaolon alku validstartdatetime DT 18 vvvv-kk-ppttt:mm:ss Voimassaolon loppu validenddatetime DT 18 vvvv-kk-ppttt:mm:ss Max ryhmän koko groupsize C 2 Maksimi ryhmän koko 3 Käyttötapaukset ja toimijat N/A 4 Käyttöoikeudet ja käyttäjähallinta N/A 5 Käsitemalli N/A 6 Integraatiot 6.1 Liikennöitsijäjärjestelmät Tuote- ja tariffihallinta liittyy liikennöitsijäjärjestelmiin Tuote- ja Tariffirajannan kautta. Osajärjestelmä tarjoaa liikennöitsijäjärjestelmille tuote- ja tariffitiedot. 6.2 Tarkastajajärjestelmät Tuote- ja tariffihallinta liittyy tarkastajajärjestelmään Tuote- ja Tariffirajannan kautta. Osajärjestelmä tarjoaa tarkastajajärjestelmälle tuote- ja tariffitiedot. 7 UI demo/proto N/A Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 12(13)

8 Muutoshistoria Versio Päiväys Tekijä Tarkistaja Hyväksyjä Muutoshistoria V0.1 3.11.2013 Arto Rantanen V0.2 7.11.2013 Arto Rantanen V0.3 17.11.2013 Arto Rantanen Ensimmäinen versio Palaverin 6.11.2013 aikana esiin tulleet asiat Lisätty työmatkalipun ohjaus sekä tieto KELA-lipusta V1.0 12.12.2013 Ari Hätinen Yhdistetty kuvaus, käyttötapaukset ja käyttöliittymä yhteen dokumenttiin. V1.1 19.2.2014 Jan Forsberg Tehty skeemat ja samassa yhteydessä korjailtu ja muuteltu tietojen nimiä V1.2 21.2.2014 Arto XML testiesimerkkien teon yhteydessä havaitut korjaukset ja muutokset blacklistcontrol laitettu commonparams elementtiin Tietojen arvoalueiden täsmennystä, asiakasryhmät, tuoteryhmät Poistettu Liikennöitsijä tuote, Kelalippu, Tuotteen pakollisuus, Käytettävä koulukalenteri (ei voi sitoa lippulajiin) Lisätty voimassaolo 2 eri aikarajaa per viikonpäivä V1.3 7.4.2014 Arto customergroupid arvot muutettu productid arvot muutettu ja arvoja lisätty productgroup arvoja lisätty paperilipun tekniset tunnisteet (2.5.1) v1.4 15.4.2014 Arto/Pasi Koulun liittäminen koulukalenteriin Kortin hinta lisätty Yleiset korttiparametrit Lipputuotteiden vaihtoajat ja voimassa päivätyypeittäin Lipputuotteen tietoihin v1.5 9.5.2014 Arto Tägien nimiä korjattu vastaamaan scheemaa (calendarschool) 28.10.2014 Anne Siirretty LMJ-pohjaan. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 13(13)