Usein kysytyt kysymykset välityskeskusten kuukausiseurantatiedoista | Traficom
Liikenne- ja viestintävirasto

Usein kysytyt kysymykset välityskeskusten kuukausiseurantatiedoista

Tältä sivulta löydät vastauksia kysymyksiin välityskeskuksilta kuukausittain kerättävistä tiedoista ja niiden toimittamisesta.

Velvollisuudesta toimittaa tietoja

Kyllä on. Välityskeskuksilla on lakisääteinen velvollisuus toimittaa Traficomille liiketoimintaansa koskevia tietoja (laki liikenteen palveluista 152 § ja 179 §).

Tietojen toimitusvelvollisuuden ja toimitettavan tietosisällön tarkempi määrittely Traficomin 15.11.2021 antamasta määräyksestä: Henkilöliikenteen palvelujen kysyntä- ja tarjontatiedot ja taksiliikenteen palvelujen hintatiedot.

Taksitoiminnasta kerättävät tiedot.

Kaikista viivästyksistä kuukausiseurannan tiedontoimituksessa tulee ilmoittaa Traficomille viipymättä (lipatiedonkeruu@traficom.fi). Jos kuukausitietojen toimittaminen suoraan järjestelmään ei onnistu, on poikkeustapauksissa mahdollista toimittaa tietoja myös sähköpostitse. Tietoja toimitettaessa sähköpostitse on suositeltavaa käyttää turvasähköpostia. Ohjeita salatun viestin lähettämiseksi.

Ensisijaisesti tiedot tulee kuitenkin toimittaa aina suoraan sähköiseen tiedonkeruujärjestelmään. Vaihtoehtoinen tiedontoimitustapa on aina harkinnanvarainen ja väliaikainen.

Välityskeskuksen tulee antaa Traficomille selvitys tietojen puuttumisesta osoitteeseen

lipatiedonkeruu@traficom.fi

Selvitys tulee antaa, kun välityskeskus ei ole vielä aloittanut toimintaansa tai toiminta on päättynyt kokonaan tai vähintään kolmeksi kuukaudeksi.

Mikäli kyseessä on ainoastaan poikkeustapaus ja välitettäviä taksimatkoja kertyy kuitenkin jatkossa, tulee välityskeskuksen edellä mainitun selvityksen lisäksi palauttaa järjestelmään csv-tiedosto, jossa on vain muotovaatimukset täyttävät sarakeotsikot, niiltä kuukausilta, joilta ei ole kertynyt yhtään välitettyjä taksimatkoja.

Ottamalla yhteyttä Traficomiin (lipatiedonkeruu@traficom.fi) ja ilmoittamalla y-tunnuksensa sekä uudet yhteystiedot.

Lisäksi tulee päivittää yhteystiedot tiedonkerujärjestelmään ja huolehtia järjestelmään myönnettyjen suomi.fi- tai OTP- valtuutuksien ajantasaisuudesta.

Tietojen hyödyntämisellä tarkoitetaan käytännössä sitä, että nämä kyseiset tiedot ovat löydettävissä yhtiön tietojärjestelmistä. Eli toisin sanoen, onko yrityksellä tietoa, milloin taksimatka alkoi tai mikä oli sen lähtöpaikka.

Välityskeskusten kuukausiseurantatietojen toimitusvelvollisuuden kohteena ovat ne toimijat, jotka hallinnoivat yhtä tai useampaa taksimatkojen toteuma- tai maksutietoihin laskettavaa tietosisältöä (matkakohtaiset matkan ajaneen yrityksen y-tunnus ja ajoneuvon rekisterinumero sekä matkan lähtöpaikka, vaste-, lähtö- ja päättymisaika, matkan pituus ja kesto, matkan kokonaishinta, perushinta ja maksutapa).

Kuukausiseurantatietojen toimittamisvelvollisuuteen vaikuttaa välityskeskusten hallinnoimien tietosisältöjen laajuus. Näin ollen esimerkiksi toimijat, jotka hallinnoivat ainoastaan tilaustiedoiksi määriteltyjä tietosisältöjä, on rajattu kuukausiseurantatietojen toimitusvelvollisten ulkopuolelle. Tällöinkin välityskeskuksen on kuitenkin selvitettävä, miltä toiselta välitysketjun toimijalta nämä puuttuvat tiedot olisi mahdollista saada ja onko tietojen yhdistäminen mahdollista.

Mikäli välityskeskus hallinnoi edellä kuvailtua tietosisältöä, tulee tiedot toimittaa määräyksen mukaisessa tietomallissa Traficomin tiedonkeruujärjestelmään. Välityskeskukselta edellytetään tarvittaessa omaa järjestelmäkehitystyötä tietomallin mukaisen muotoilun saavuttamiseksi. Harkinnanvaraisesti Traficom voi väliaikaisesti vastaanottaa tietoja myös sähköpostitse tai myöntää välityskeskukselle lisäajan järjestelmäkehitystyön ajaksi.

Lähtökohtaisesti Traficomin 15.11.2021 antama määräys, niin vuosi- kuin kuukausiseurantatietojen toimitusvelvollisuuden osalta, koskee yhtäläisesti niin alustatalouden kuin perinteisiäkin taksinvälitysyhtiöitä. Jos yritys välittää kyytejä ulkopuolisille taksiyrityksille maksua vastaan, on yritys lähtökohtaisesti välityskeskus ja tiedontoimitusvelvollinen.

Traficom kerää taksivälityskeskuksilta kuukausiseurantatietoja, joihin kuuluu vammais- ja vanhuspalveluiden kuljetukset siltä osin kuin välityskeskukset niitä hoitavat. Tähän ei siis kuulu muiden toimijoiden kuten esim. kuntien matkakeskuksien kautta kulkevat vammais- ja vanhuspalveluiden kuljetukset. Edellisten osalta tietojen keruu on Ely-keskusten vastuulla. Kokonaiskuvan muodostamisessa huomioidaan niin markkinaehtoinen kuin julkisesti ostettukin taksiliikenne.

Järjestelmään kirjautumisesta ja tietojen syöttämisestä yleisesti

Suomi.fi-palvelun kautta voivat yrityksen nimenkirjoitusoikeudelliset toimijat tai näiden valtuuttamat tahot hallinnoida valtuuksia. Valtuuksien antamista varten tulee tietää valtuutettavien henkilöiden nimi ja henkilötunnus. Valtuutuksen tulee koskea liikkumispalveluiden tietojen ilmoittamista tai tietojen ylläpitämistä.

Valtuuksien hallinnointi.

Mikäli nimenkirjoitusoikeuden omaavilla tahoilla ei ole suomalaista henkilövarmennetta, tulee ottaa yhteyttä Traficomiin vaihtoehtoisten valtuuksien luomiseksi: lipatiedonkeruu@traficom.fi.

Yritysten välisessä tiedontoimittamisen valtuutuksessa tulee asiakasyrityksen antaa edustusyritykselle halutut liikkumispalveluiden asiointivaltuudet, jonka jälkeen edustusyritys antaa vielä erikseen halutulle työntekijälleen saatuun asiointivaltuuteen edustamisvaltuuden.

Henkilövaihdosten yhteydessä tulee valtuudet aina päivittää asianmukaisesti.

Yhden kuukauden alle järjestelmään tallentuu vain yksi tiedosto. Aiemmin syötetyn tiedoston voi joko poistaa, jolloin se ei jää enää näkyviin kansioon, tai päivittää uudella tiedostolla, jolloin aiempi tiedosto jää passiiviseksi. Poistetun ja passiivisen tiedoston tiedot poistuvat myös Traficomin tietokannasta.

Vanhat passiiviset tiedostot saa kansioon näkyviin ottamalla ruksin pois valinnasta ' Näytä vain hyväksytyt päivitykset'. Tämä ominaisuus helpottaa tiedostojen versionhallintaa, joten on suositeltavaa päivittää aiempi tiedosto poistamisen sijasta, jos tiedostoon on tehty muutoksia.

Järjestelmä hyväksyy vain csv-tiedoston, jossa on käytetty puolipistettä erottimena ja määrätyn muotoisia sarakeotsikoita. Väärinkirjoitetut, puuttuvat tai ylimääräiset sarakeotsikot aiheuttavat tiedoston hylkäyksen, sarakkeiden järjestyksellä ei sen sijaan ole väliä. Vaaditut sarakeotsikot ovat:

"CompID", "VehicleID", "OrderTimeApprox", "OrderDuration", "TripDuration", "OrderTime", "DepTime", "ArrTime", "DepLocMUN", "DepLocGPSx", "DepLocGPSy", "Distance", "PriceTotal", "PriceWithoutAddServ", "OrderType", "AccessRequirement", "PaymentMethod", "Preorder" ja "AddInfo".

Tyypillisiä syitä koko tiedoston hylkäämiselle ovat ylimääräiset tyhjät rivit sekä pilkun käyttäminen listaerottimena csv-tiedostossa. Monet ohjelmat tallentavat listaerottimeksi automaattisesti pilkun ja käyttävät desimaalierottimena pistettä, jolloin järjestelmä ei hyväksy tiedostoa.

Esimerkkejä tiedoston oikeaan muotoiluun.

Tiedonkeruujärjestelmä muodostaa kuukausittain uuden kansion, jonne tiedostoja voi syöttää. Kansioiden luominen alkaa siitä kuukaudesta, jolloin yritys on ensimmäisen kerran kirjautunut järjestelmään.

Useamman kuukauden tietoja voi syöttää takautuvasti yhdistämällä kaikki halutun aikavälin matkatiedot yhteen tiedostoon. Näin toimittaessa tulee tiedosto nimetä sen sisältöä kuvaavalla tavalla esimerkiksi 'esimerkkiyritys_tammi-huhti' ja kirjoittaa kommenttikenttään tiedoston sisältämät kuukaudet aineistoa tuotaessa tiedonkeruujärjestelmän.

Toimitettavan aineiston sisällöstä ja validoinnista

Tiedoston järjestelmään tuomisen jälkeen luodaan muutaman minuutin sisällä tiedoston vierelle validointiraportti ('Näytä validointiraportti'-linkki). Validointiraporttiin tulostuu järjestelmän havaitsemien validointivirheiden määrä ja virheellisten rivien sarakeotsikot. Sarakeotsikoiden avulla voidaan paikantaa virheelliset kentät tiedostosta, vaikka näitä ei yksilöidäkään rivin tarkkuudella raportissa.

Kuukausiseuranta-aineiston sisällön tarkempi määrittely löytyy välityskesusten kuukausiseurannan ohjeista.

Autamme mielellämme aineiston laatuun ja validointiraportin tulkintaan liittyvissä kysymyksissä (lipatiedonkeruu@traficom.fi).

Suurin osa järjestelmän hylkäämistä riveistä aiheutuu rivillä esiintyvien kenttien puutteista tai virheellisistä muotoiluista sellaisten sarakeotsikoiden alla, jotka ovat pakollista tietoa (CompID, VehicleID, Distance, aika- ja paikkatiedot). Puutteet tai virheet lopuissa rivin tiedoista eivät aiheuta koko rivin hylkäämistä, nämä merkitään raportissa puutteellisesti hyväksytyiksi.

Jos kaikki tai suurin osa tiedoston riveistä on hylätty sisältää aineisto oletettavasti jonkin systemaattisesti toistuvan virheen, mikä estää hyväksyttyjenkin kenttien järjestelmään lukemisen.

Validointivirheen aiheuttavat esimerkiksi: 

  • Tyhjää ilmaisevat merkinnät: ” – ”, ”N/A”, "NULL", "null", " ", "-", "#(00A0)", "0". Tyhjäksi jätetty kenttä on aina oltava aidosti tyhjä.
  • Ylimääräiset merkit ja välilyönnit muutoin oikein täytetyssä kentässä tai jonkin tietyn kentän kannalta oleellisen välimerkin puuttuminen.
  • Numerokentissä esimerkiksi tuhansien erottelu välilyönnillä, pisteellä tai pilkulla ("1 234,56", "1.234,56" tai "1,234.50"), aiheuttavat validointivirheen. Desimaalimerkkinä käytetään pilkkua ja koordinaattierottimena pistettä.

Yleisiä virheitä y-tunnuskentässä ovat ylimääräiset merkit tai puuttuva väliviiva (-). Tämän lisäksi väärin kirjoitetut tai vanhentuneet y-tunnukset aiheuttavat virheilmoituksen ja hylkäämisen, vaikka muotovaatimus täyttyisikin, sillä järjestelmä tarkistaa y-tunnukset Yritys- ja yhteisötietojärjestelmästä (YTJ). Vain toimivat voimassaolevat y-tunnukset hyväksytään.

Yleisiä virheitä rekisteritunnuskentässä ovat ylimääräiset merkit tai puuttuva väliviiva (-). Kirjainten ja numeroiden paikat on hyvä myös tarkistaa, sillä esimerkiksi "o" (o-kirjain) tai "0" (numero nolla) väärässä kohdassa aiheuttaa virheen.

Myös väärän mallinen encoding voi aiheuttaa virheen, tällöin ääkköset (å, ä, ö) eivät ole järjestelmän hyväksymässä formaatissa. Järjestelmä hyväksyy vain ANSI-formaatissa olevat ääkköset (ei esimerkiksi utf-8 ja utf-8 BOM muodossa).

Päivämääräkentissä yleisimmät virheet johtuvat sarakkeen väärästä oletusmuotoilusta. Monet ohjelmat käyttävät päivämäärien suhteen automaattista muotoilua, joka voi poiketa järjestelmän hyväksymästä. Tällöin alun perin oikein tallennetun päivämäärän muotoilu saattaa korruptoitua tiedostoa käsiteltäessä. Muotoilemalla kenttä tekstiksi päivämäärän sijaan ei päivämäärän oletusmuotoilu vaikuta kentän sisältöön.

Lisäksi tulee huomioida, että tilausajan (OderTime) on aina oltava ennen tai sama kuin matkan aloittamisajan (DepTime) ja lisäksi matkan päättymisen (ArrTime) on oltava tämän jälkeen.

Paikkatiedoissa yleisimmät virheet ovat koordinaattien erottimena käytetty pilkku (,) pisteen (.) sijasta, väärinpäin olevat x- ja y-koordinaatit tai niiden osuminen Suomen rajojen ulkopuolelle sekä koordinaattien listaaminen yhteen kenttään. Kuntakoodin osalta virheitä aiheuttavat virheelliset tai vanhentuneet kuntanumerot. Ajantasaiset kuntakoodit.

Jos rivillä ei ole jompaa kumpaa kuntanumeroa tai koordinaatteja hylätään koko rivi, myös etäisyys on pakollinen täytettävä kenttä matkan tietojen hyväksymiseksi.

Hintatiedoissa kaikki muut merkinnät, kuin numerot tai pilkulla erotetut desimaalit aiheuttavat virheen. Esimerkiksi negatiiviset arvot, hinta- ja valuuttamerkit (1234,56 € tai 1234,–) aiheuttavat validointivirheen.

Tyyppikenttiin hyväksytään vain kunkin sarakeotsikon mukaiset numeroluokat:

  • OrderType (0-4): taksitolppa / lennosta otto=0, välityskeskus=1, puhelin=2, sovellus=3, sopimusajo=4
  • AccessRequirement (0-1): ei=0, kyllä =1
  • PaymentMethod (0-4): käteinen=0, maksukortti=1, laskutus=2, matkakortti=3
  • Preorder (0-1): ei=0, kyllä =1
Sivu on viimeksi päivitetty