Tietojen jälleenmyyjät-ake ATJ-käyttöönotto Kysymys-vastausluettelo Tietojen jälleenmyyjien ATJ:n käyttöönoton kysymys-vastausluettelo Nro Kysymys / Vastaus Vastaaja Vastauspvm 1 Onko sov-sov-rajapinnasta olemassa Web Servicen WSDL-dokumenttia? TE KV ATJ-tekninen liityntäsopimus pitää sisällään WebService(SOAP/HTTPS) - Heikki Honkela ja protokollan. Heillä ei kuitenkaan ole esittää WSDL-dokumenttia (eli ei WebServiceä?). Markku Noukka 23.11.2005 TPSUOn so-so-kyselyt tukevat vain HTTP-protokollaa (HTTPS). Kehitysprojekti (=AKE) vastaa sopimuskumppanirajapinnan kuvaamisesta eli sanomien XML-kuvauksista. WSDL-dokumenttia emme ole tekemässä. 2 Osaatko sanoa miksi henkilön asiointikieli ei selviä sov-sov-rajapinnasta? Asiointikieli ei ole missään vaiheessa sisältynyt sovellus-sovelluskyselyn rajapintaan. Rajapintojen sisältösuunnitelmia on esitelty kyselyjälleenmyyjille. Missään vaiheessa ei ole ko. tarve tullut esille. Heikki Honkela 13.2.2006/ täydennetty 7.3.2006 AKE käsittelee mahdolliset muutostoivomukset muutoshallintana. Täydennetty 7.3.2006/ Asiointikieli on otettu mukaan TPSUO:n so-so-kyselyyn seuraavan päätöksen mukaisesti Lisätään TPSUO-rajapintakyselyihin (so-so) perustiedot ja laajat tiedot vastausvaihtoehtoihin ajoneuvon omistajan ja haltijan asiointikieli. Muutetaan TPERA-rajapinnoissa esiintyvä äidinkieli asiointikieleksi. 3 Onko mahdollista saada EU-tyyppitiedoista pohjatietoja kaikkien versioiden ja varianttien tiedot? Esim. oikean kaupallisen nimen tarve on kumppaneille tärkeä. Tarve olisi etenkin EUtyyppihyväksyttyjen ajoneuvojen kaupalliset nimille (mikä yksilöi kaupallisen nimen onko se tyyppi- Aino Varhimo 18.5.2006
2 hyväksyntänumero vai tarvitaanko myös variantti ja versio). YTR:ssä kirjattu vastaus 18.5.2006: Varhimo totesi, että tietoja ei voida vapaasti luovuttaa, joten kumppaneita pyydettiin tarkentamaan tiedustelua seuraavasti: - tyyppitietojen yksilöinti - tietojen käyttötarkoitus - kertaluovutus vai tarvitaanko päivityksiä ja kuinka usein? 4 Jatkuuko testiympäristön käyttö myös käyttöönoton jälkeen 2.4.2007? Kyllä jatkuu. Kumppanit tullaan aikanaan ohjeistamaan siitä, miten välityspalvelun ja ATJ:n testiympäristöä voidaan hyödyntää tuotantokäytön aikana. Markku Noukka 5.4.2006 5 Saadaanko soso-palvelun kautta myös siirtokilvellisten ajoneuvojen tiedot? Kyllä. Hakusanoman laji=7 kohdistaa haun suoraan siirtokilpeen. Tämänpä voisi kirjoitella rajapinnan kuvauksiin selvemminkin. Heikki Honkela 6.4.2006 6 Mikä on välityspalvelun käyttämä sertifikaatti? Välityspalvelun testipuolella on vain self signed sertifikaatteja, mutta tuotantopuolella aitoja sertifikaatteja (VeriSignin verfioimia). Tea Talvinen ja Markku Noukka 18.8.2006 7 Pitääkö palvelukuvauksessa kuvata käytettävät tiedot tietotasolla, jolloin rajapintamuutos vaikuttaa myös palvelukuvaukseen eli sopimukseen Vaihtoehtona voisi olla pelkän kyselylajin ilmoittaminen. Minna ja Marja selvittivät asian Aino Varhimolta, Hän oli sitä mieltä, että pelkän kyselylajin ilmoittaminen ei riitä, vaan luovutettavat tiedot pitäisi ilmoittaa palvelukuvauksessa tietotasolla. Minna Laaksonen ja Marja Koskinen 18.8.2006
3 8 Koska asiakkuus alkaa kysymys liittyy palvelukuvaukseen Asiakassuhteen alkamista ei voi ihan tarkkaan määritellä, mutta tiedot voi viedä asiakasrekisteriin, kun siihen on ko. henkilön suostumus. Sopimuskumppanin on tarvittaessa annettava selvitys henkilön tietojen tallentamisesta asiakasrekisteriin. Minna Laaksonen ja Marja Koskinen 18.8.2006 10 Sovellus-sovellus-kyselyn rajapintaan sisältyviä liiketoimintakysymyksiä Mallimerkintä Heikki Honkela ja Marja Koskinen 18.8.2006 AJT:hin LTJ:stä konvertoiduilla ajoneuvoilla mallimerkintä pysyy samana kuin se on LTJ:ssäkin. ATJaikana rekisteröidyille ajoneuvoille mallimerkintä muodostetaan KATSA-järjestelmässä (= Katsastustietojärjestelmä). Tyyppikoodi Kansallinen tyyppikoodi jää pois 2.4.2007. LTJ:stä konvertoidulla ajoneuvolla se on. Vuoden 2004 alusta lähtien ajoneuvot ovat saaneet tyyppikoodin lisäksi myös tyyppihyväksyntänumeron, variantin ja version, jotka ATJ-aikana toimivat tyypityksen hakuelementteinä. Omistaja/Haltijatieto Omistajan tunnus ei voi puuttua on joko oikea tunnus tai keinotunnus. Myös ulkomaiset henkilöt saavat muodoltaan samanlaisen tunnuksen kuin suomalaisetkin. ATJ:n henkilötiedot HENKIjärjestelmään päivitetään VRK:n VTJ:stä. Y-tunnuksissa voi olla vielä vanhojakin muotoja, joista osassa voi puuttua etunolla tai joillain voi olla K-alkuinen keinotunnus. Nimi-tieto Sukunimi-elementtiin viedään yrityksen nimi (Esim. Nokia ) ja etunimi-elementtiin sitten mahdollinen toimipiste (esim. Porin aluekonttori). Luovutusilmoitus Kertoo sen kenelle omistaja on luovuttanut ajoneuvon, jota uusi omistaja ei ole vielä rekisteröinyt. Rekisteröinnin yhteydessä luovutusilmoitukset kirjataan ajoneuvon väliomistajiksi. LTJ aikainen termi on Myynti-ilmoitus ja ATJ aikainen termi Luovutusilmoitus.
4 11 Luovutuksen voi tehdä myös tuntemattomalle, jolloin ostajasta ei ole tietoa. Mitä kodistoa so-so-haussa käytetään laji-elementissä laji tulee alla olevasta koodistosta. Tämähän liittyi niihin vanhoihin rekisteritunnustupliin jonka ltj:n rekisterilaji mahdollisti. On kuitenkin huomattava että tämä ei ole sama kuin ltj:n rekisterilaji vaan tieto muodostetaan ajoneuvoluokkien perusteella. KdAtpLaji null null 0 Mopo KdAtpLaji null null 1 Auto KdAtpLaji null null 2 Moottoripyörä KdAtpLaji null null 3 Traktori tai moottorityökone KdAtpLaji null null 4 Maastoajoneuvo KdAtpLaji null null 5 Perävaunu KdAtpLaji null null 7 Siirtokilpi Jani Alatalo 23.8.2006
5 12 Vanhasta järjestelmästä saadaan data_date päivämäärä tieto joka ilmoitettaan asiakkaille mikä päivän tieto on, saadaanko uudesta järjestelmästä vastaavaa tietoa. Markku Noukka ja Jani Alatalo 8.9.2006 Jokaisessa TPERA:n ainestossa (myös osoitejälleenmyyjäpoiminnassa) on mukana aineistoinfoelementti, joka on kuvattu Ohjeessa XML-aineistolle yhteiset asiat kohdassa 5 (on myös kuvattuna alla) Välitettävän eräaineiston loppuun liitetään aineistoinfoelementti, josta ilmenee seuraava seikat: tuote; TPERAn käyttämä tuotetunnus poiminta-aika; tiedoston tuottaneen ajon aikaleima aineiston aikaväli (alkupvm ja loppupvm). Aineistovälin perusteella voi tunnistaa mm. uudelleenajoaineiston. aineistoon sisältyvien varsinaisten datatietueiden lukumäärä. Lisäksi aineisto nimetään niin, että siitä selviää poiminta-ajon aikaleima (tämä kuvataan kunkin rajapinnan kuvauksessa). TPSUO:n sovellus-sovellus -kyselyt tehdään ATJ:ssa tietokantaan joka päivittyy jatkuvasti ja on operatiivisten tietokantojen kanssa ajantasainen. Näin ollen samanlaista 'aineiston päivämäärää' ei uudessa järjestelmässä enää tarvita kuin nykyisessä LTJ:ssä. 13 Miksi kaikilla ajoneuvolla ei ole vakuutustietoja? Sovelluskysely antaa myös liikenteestä poistetun ajoneuvon tiedot joiden vakuutus ei ole voimassa. 14 Miksi kaikilla ajoneuvolla ei ole rengastietoja?
6 LTJ-aikaisia rengastietoja ei konversiossa ole pystytty viemään niille varattuun kenttään, koska ATJ:n rengastiedot viedään akselittain eikä LTJ:n aikaisille rengastiedoille ole akselitietoa. Tästä johtuen rengastiedot on konversiossa viety huomautuksiin, joita ei sovelluskyselyillä pystytä välittämään. Tämä koetaan ongelmana, johon haetaan ratkaisua. 15 Mitä rajoitustietoja on luvallista näyttää asiakkaalle ja missä tapauksessa sovelluksen pitäisi vain ilmoittaa käyttäjälle ajoneuvoon liittyy rajoituksia tms. Onko sinulla olemassa näistä jotain selventävää dokkaria, jäi mieleen kun joskun puhuit näistä. Voiko ajoneuvolla olla useita rajoitustietoja yhtä aikaa? Rajoitustiedot löytyy dokumentista Sovellus-sovelluskysely rajapintakuvaus. Kaikki rajoitukset voi näyttää asiakkaalle. Ainakin 1, 2 ja 3 vakavuudelle luokitellut on syytä näyttää. 5 luokan rajoitus/huomautukset ovat sen laatuisia, että palvelusta riippuen en niitä näyttäisi. Rajoituksen numero 33 Ajoneuvolla luovutusilmoitus (ent.myynti-ilmoitus) on vakavuusluokittelu vain 5, mutta se on mielestäni näytettävä ainakin kansalaispalveluissa. Ajoneuvolla voi olla useita rajoitustietoja samanaikaisesti. Kaikki rajoitukset välitetään vastaussanomassa. 16 Löytyykö LTJ:n aikainen tyyppikoodi sovelluskyselyn vastaussanomalta? Kyllä löytyy, tyyppikoodi viedään omaan kenttään. On kuitenkin huomioitava, että kaikilla LTJ:n aikaisillakaan ajoneuvoilla ei ole täydellistä tyyppikoodia, tyyppikoodi voi olla minimissään vain yhden merkin mittainen. 17 Miksi ajoneuvolta löytyy keskenään ristiriitaiset rengastiedot Esim. seuraavat rengas2:235/40r18 M+S ja rengas1:215/55r16 (testiympäristö TUKALA)? Esimerkissä rengasvaihtoehdot ovat akseleittain, mutta akseleiden rengasvaihtoehdot yhdistävä tieto
7 puuttuu. Molemmille akseleille voidaan laittaa 16 tai 18 renkaat. 18 Olisiko mahdollista saada sanomakuvausta, jossa näkyisi kunkin kyselylajin mukaiset tietokentät? Eri kyselylajien skeema-kuvaukset voidaan toimittaa. 19 Saako paluusanomassa tiedon auton kaskovakuutusyhtiöstä ja siitä kuinka vakuutus on voimassa (on/ei tai jopa päivämäärinä)? Rekisterissämme on vain pakollisen liikennevakuutuksen tiedot. 20 Milloin sovellus-sovellus- kyselyssä on saatavissa omistajien ja haltijoiden historiatiedot? Historiatiedoista on kehitystarpeisiin kirjattu rakennettavaksi erillinen historiatiedot- kysely. Tämän kyselyn valmistuminen riippuu nykyisissä palveluissa ilmenevien mahdollisten virheiden korjausten vaatimista resursseista. 21 Onko AKE:lla jotain sapluunaa, jota vasten rekisterinumeroiden formaatin pystyy varmistamaan? Eli siis esim. että aina aluksi on 1-3 aakkosta, sitten viiva jota seuraa 1-3 numeroa? Onko tälläistä yleispätevää muotoiluohjetta olemassa, joka pätee rekisteröimiinne ajoneuvoihin? Muoto-ohje on olemassa, mutta eri ajoneuvoja koskevat eri säännöt. Muoto-ohjeisiin saattaa tulla muutoksia, joten emme suosittele tarkkoja käsittelysääntöjä siihen, millaisen rekisteritunnuksen voi kyselysanomassa antaa. TPSUO:n sovellus-sovellus-kyselyssä tulee virhevastaus siinä tapauksessa, että annettu rekisterinumero on vääränmuotoinen.
8 22 Laskutetaanko kyselyistä, joihin tulee virhevastaussanoma? Ei laskuteta. 23 Missä vaiheessa ajoneuvon tiedot tulee rekisteriin? Ajoneuvon tiedot saadaan rekisteriin jo ennakkoilmoituksessa tai rekisteröintikatsastuksessa, mutta näillä ei ole vielä tuolloin voimassa olevaa rekisteritunnusta, joten ajoneuvon tiedot tulisi hakea valmistenumerolla tai järjestelmätunnuksella. Rekisteritunnuksella haettaessa ei vastaussanoma palauta mitään rekisteritunnusta, mutta ajoneuvon tiedot palautuvat. Siirtoluvallisen ajoneuvon tiedot voidaan hakea siirtoluvan tunnuksella. Siirtoluvallisen ajoneuvon tiedot voivat kuitenkin olla hyvin suppeat, ja esim. järjestelmätunnus vaihtuu rekisteröitäessä ajoneuvo, jos ajoneuvo ei ole ollut rekisterissä ennen siirtoluvan myöntämistä. 24 Kuinka omistaja ja muu omistaja tai haltija ja muu haltija eroavat toisistaan? Juridisesti kaikki omistajat tai kaikki haltijat ovat samanarvoisia. Rekisteriin on merkitty ensimmäinen omistaja ja muita omistajia sekä ensimmäinen haltija ja muita haltijoita. 25 Kuinka staattisia koodistot ovat? Voiko olemassa olevat koodit muuttua vai tuleeko koodistoihin aina vain mahdollisesti lisäyksiä? Periaatteessa mikä hyvänsä koodisto voi muuttua, mutta käytännössä valtaosaan tapahtuu vain harvoin muutoksia. Uusin koodisto on haettavissa AKEn kumppanisivuilta. 26 Tuleeko kyselylajeissa perustiedot hetulla ja laajat tiedot hetulla aina myös hetun loppuosa?
9 Kyllä tulee koko hetu. 27 Tuleeko sovelluskyselyssä kaikki sanomat suomeksi? Kyllä tulevat. Kooditetuille tiedoille löytyy koodistosta myös ruotsinkieliset vastineet. 28 Kun muut tiedot palautuvat kyselyssä joko selkokielisinä, seuraavissa näkyy tulevan true tai false. Onko tämä tarkoitus olla näin jatkossakin vai onko vain tässä rakennusvaiheessa näkyvä asia? <rakennettuajoneuvo>false</rakennettuajoneuvo> <markkinointikielto>false</markkinointikielto> <paripyorillavarustettu>false</paripyorillavarustettu> <ohjaava>false</ohjaava> True (tai "1") ja false (tai "0") on xml-standardin sallimat arvot totuusarvojen esittämiseen. Kyllä tämän on tarkoitus olla näin jatkossakin eli ei ole vain rakennusvaiheessa näkyvä asia.