Tiedostomuotoinen ennakkoilmoitus Versio 1.0 Copyright Liikenteen turvallisuusvirasto
TALLENNUSPAIKKA: MUUTOSHISTORIA Versio Päiväys Laatija Muutoksen kuvaus / hyväksyjä 1.0 Essi Laakso Lisätty ohjeeseen uudet tiedostoennakkoilmoitustiedot. Päivitetty ohjeeseen Trafi-muutokset. 0.2 22.3.2007 Essi Koskikallio Päivitetty ohjetta 0.1 8.3.2007 Essi Koskikallio Ensimmäinen versio Copyright Liikenteen turvallisuusvirasto 2 (11)
Sisällysluettelo 1. Tiedostomuotoinen ennakkoilmoitus...4 2. Ennakkoilmoitustiedosto...5 3. Ennakkoilmoituksen paluutiedosto... 11 Copyright Liikenteen turvallisuusvirasto 3 (11)
1. Tiedostomuotoinen ennakkoilmoitus kertoo mitä ajoneuvon teknisiä tietoja ja yksilöintitietoja käytetään tiedostomuotoisessa ennakkoilmoituksessa sekä tietojen järjestyksen CSVtiedostossa. Ennakkoilmoituksessa ajoneuvo ennakkoilmoitetaan Trafin Ajoneuvotyyppihyväksyntäjärjestelmässä (TYYTI) olevilla version tiedoilla. Versio tarkoittaa samaa kuin hyväksyntänumero-variantti-versio -yhdistelmä. LTJ:stä konvertoiduista kansallisesti hyväksytyissä versioissa versionimi on tyyppikoodi. Jos hyväksyntänumero-variantti-versio -yhdistelmä ei ole ollut yksikäsitteinen LTJ:ssä, konvertoiduissa EY-hyväksytyissä versioissa versionimenä on tyyppikoodi ja hyväksyntänumero sekä variantti -kentät ovat aina tyhjiä. Tiedostomuotoisessa ennakkoilmoituksessa ilmoitetaan tietyt ajoneuvon tekniset tiedot ja yksilöintitiedot. Ennakkoilmoituksen tiedostomuotona käytetään CSV-tiedostoa, eli tiedoston on oltava.csv -päätteinen. CSV-tiedostossa on yhdellä rivillä ainoastaan yhden ajoneuvon tiedot. Yhden ajoneuvon yksittäiset tiedot on erotettu toisistaan puolipistein ( ; ). Tietojen on oltava aina sovitussa järjestyksessä. Jokaisella rivillä tulee olla oikea määrä puolipisteitä. Yhdessä tiedostossa voidaan ilmoittaa enintään 2000 ajoneuvoa. Koska jokaista ajoneuvoa vastaa yksi rivi, tulee tiedostoon enintään 2000 riviä. Ennakkoilmoitustiedosto nimetään Trafin nimeämisohjeen mukaisesti. Copyright Liikenteen turvallisuusvirasto 4 (11)
2. Ennakkoilmoitustiedosto Tässä kappaleessa kuvataan mitä ajoneuvon teknisiä tietoja ja yksilöintitietoja CSV-tiedosto sisältää. Tieto ennakkoilmoitetaan, jos tieto on valinnainen (esim. turvavarusteet) tai jos tiedolla on monta vaihtoehtoa (esim. monta kaupallista nimeä). Jos tieto on yksiselitteinen, niin tieto jätetään ennakkoilmoituksessa tyhjäksi. Siinä tapauksessa, että ajoneuvolla ei ole valinnaisia tai vaihtoehtoisia tietoja, ennakkoilmoitetaan vain ajoneuvon yksilöintitiedot sekä M1 ja N1 luokilla väri ja mahdollinen lisäväri. Tietojen järjestys CSV-tiedostossa on: A. Valmistenumero - Tieto täytetään aina - Käytettävä isoja kirjaimia B. Tyyppihyväksyntänumero - Tieto täytetään aina, mikäli tyyppihyväksyntänumero on olemassa - EY-tyyppihyväksytyissä ATJ:ssa tehdyissä hyväksynnän tallennuksissa tieto on muotoa: e-kirjain pienellä + maatunnus, direktiivin nro, järjestysnumero ja laajennus, kukin näistä osista * (tähdellä) erotettuna. Esim. e1*2007/46*0123*01 - Kansallinen hyväksyntänumero on ATJ:ssa tehdyissä hyväksynnöissä muotoa: FIN suurin kirjaimin, VVKKPP, järjestysnumero ja laajennus, kukin näistä osista * (tähdellä) erotettuna. Esim. FIN*100919*0567*01 - Tieto löytyy version tiedoista C. Variantti - Tieto täytetään aina, mikäli varianttitieto on olemassa D. Versio - Tieto täytetään aina, mikäli versiotieto on olemassa E. Ajoneuvoluokka - Tieto täytetään aina - Tieto on koodiarvoinen (KdTyytiAjoneuvoluokka) F. Ennakkoilmoittajan tunnus - Tieto täytetään aina Copyright Liikenteen turvallisuusvirasto 5 (11)
- Tiedolla tarkoitetaan ennakkoilmoittajan y-tunnusta G. Moottorin numero - Vapaaehtoinen tieto - Käytössä muilla paitsi O-luokan ajoneuvoilla - Käytettävä isoja kirjaimia H. Merkki - Mikäli versiolla on useampia merkkejä, tulee ennakkoilmoituksessa yksilöidä ennakkoilmoitettavan ajoneuvon merkki - Tieto on koodiarvoinen (KdTyytiAjoneuvonMerkki) I. Kaupallinen nimi - Mikäli versiolla on useampia kaupallisia nimiä, tulee ennakkoilmoituksessa yksilöidä ennakkoilmoitettavan ajoneuvon kaupallinen nimi J. Väri - Pakollinen ajoneuvoluokilla M1 ja N1 - Käytössä ajoneuvoluokilla N ja L - Tieto on koodiarvoinen (KdTyytiVari) K. Lisäväri - Vapaaehtoinen tieto - Käytössä ajoneuvoluokilla M1, N ja L - Tieto on koodiarvoinen (KdTyytiLisavari) L. Istumapaikat kuljettajan vieressä - Ilmoitetaan mikäli versiolla on vaihtoehtoja - Jos ilmoitetaan, on samalla ilmoitettava tieto M. Istumapaikat - Käytössä ajoneuvoluokilla M, N, L, MA, T, MTK, C - Lukumäärä ilmoitettava numerona M. Istumapaikat - Ilmoitetaan mikäli versiolla on vaihtoehtoja - Jos ilmoitetaan, on samalla ilmoitettava tieto L. Istumapaikat kuljettajan vieressä - Käytössä ajoneuvoluokilla M, N, L, MA, T, MTK, C Copyright Liikenteen turvallisuusvirasto 6 (11)
- Lukumäärä ilmoitettava numerona N. Tulliton - Ilmoitetaan mikäli versiolla on tietona Ei tiedossa - Sallitut arvot: K = kyllä E = ei O. Rekisterikilven malli - Ilmoitetaan mikäli versiolla on version tiedoissa tietona Valinnainen - Käytössä ajoneuvoluokilla M ja N - Koodiarvoinen, mahdolliset arvot ovat: 01 = matala 02 = korkea P. Ovien lukumäärä - Ilmoitetaan mikäli versiolla on vaihtoehtoja - Jos ilmoitetaan, on samalla ilmoitettava tieto Q. Ovien sijainti - Käytössä ajoneuvoluokilla M, N, L, MA, T, MTK, C - Lukumäärä ilmoitettava numerona ilman etunollia Q. Ovien sijainti - Ilmoitetaan mikäli versiolla on vaihtoehtoja - Jos ilmoitetaan, on samalla ilmoitettava tieto P. Ovien lukumäärä - Käytössä ajoneuvoluokilla M, N, L, MA, T, MTK, C - Tieto on koodiarvoinen (KdTyytiOvienSijainti) R. Turvavarusteet - Turvavarusteista ennakkoilmoitetaan vain valinnaisesti asennettavat turvavarusteet - Käytössä ajoneuvoluokilla M ja N - Tieto muodostuu turvavarusteen pakollisuuskoodista, turvavarusteen koodista, istuinrivin numero-koodista ja sijainnin koodista - Turvavarusteet erotetaan toisistaan välilyönnillä - Pakollisuus, koodiarvo: 2 = valinnaiset asennetut Turvavaruste, mahdolliset koodiarvot: et = etuturvatyyny st = sivuturvatyyny vk = turvavyönkiristin an = aktiivinen niskatuki Penkkirivi, mahdolliset koodiarvot: 1 = ensimmäinen rivi 2 = toinen rivi 3 = kolmas rivi Copyright Liikenteen turvallisuusvirasto 7 (11)
Sijainti, mahdolliset koodiarvot: 1 = vasen 2 = keskellä 3 = oikea Esimerkki turvavarusteiden ennakkoilmoittamisesta: 2st11 2st13 2st21 2st23 = valinnaisesti asennettu sivuturvatyyny 1. rivillä vasemmalla valinnaisesti asennettu sivuturvatyyny 1. rivillä oikealla valinnaisesti asennettu sivuturvatyyny 2. rivillä vasemmalla valinnaisesti asennettu sivuturvatyyny 2. rivillä oikealla S. Aktiivinen ajonhallintajärjestelmä (Ajovakaudenhallinta) - Ilmoitetaan mikäli versiolla on tietona Valinnainen - Käytössä ajoneuvoluokilla M, N, O2-O4, L3-L5, L3e-L7e. - Tieto on koodiarvoinen (KdTyytiAktiivinenAjonhallinta) - Sallitut arvot: K = kyllä E = ei - Tieto löytyy version tiedoista (Jarrut-ikkuna) T. Lukkiutumattomat jarrut (Jarrujen lisätieto) - Ilmoitetaan mikäli versiolla on tietona Valinnainen - Tieto on koodiarvoinen (KdTyytiLukkiutumattomatJarrut) - Sallitut arvot: K = kyllä E = ei - Tieto löytyy version tiedoista (Jarrut-ikkuna) U. CO 2 - Ajoneuvon CO 2 -tieto - Käytössä ja pakollinen ajoneuvoluokilla M1 ja N1. - Käytössä ajoneuvoluokilla M2, M3, N2, N3 - Tieto on annettava M1 ja N1 -luokilla tiedostoennakkoilmoituksessa. - Jos tietoa ei yksilöidä ennakkoilmoitustiedostossa, tallentuu ajoneuvolle versiolle merkitty tieto (M2, M3, N2 ja N3 -luokat) - Tieto löytyy version tiedoista (Päästöt ja kulutus -ikkuna) V. Omamassa - Käytössä ja pakollinen ajoneuvoluokilla M1 ja N1 - Käytössä ajoneuvoluokilla M2, M3, N2, N3, O, L, MA, T, MTK ja C - Tieto on annettava M1 ja N1 -luokilla tiedostoennakkoilmoituksessa. - Jos versiolla on vain toinen arvoista pienin tai suurin tallennettu, tallentuu kyseinen tieto ajoneuvolle ellei tietoa muuteta ennakkoilmoituksessa (M2, M3, N2, N3, L, MA, T, MTK ja C -luokat) Copyright Liikenteen turvallisuusvirasto 8 (11)
- Tieto löytyy version tiedoista (Massat-ikkuna) W. Akseliväli, akselit 1-4 - Ilmoitetaan mikäli versiolla on vaihtoehtoja - Akselivälin voi ilmoittaa akseleille 1-4. Tiedostossa on varattu paikka neljän akselin akseliväleille. Yli 4-akselisten ennakkoilmoitus tehtävä selaimella. Akselin akseliväli jätetään tyhjäksi, jos tiettyä akselia ei ajoneuvolla ole. - Tieto löytyy version tiedoista (Mitat-ikkuna) X. Raideväli, akselit 1-4 - Käytössä ja pakollinen ajoneuvoluokilla M1 - Käytössä ajoneuvoluokilla M2, M3, N, O, L, MA, T, MTK ja C - Raidevälin voi ilmoittaa akseleille 1-4. Tiedostossa on varattu paikka neljän akselin raideväleille. Yli 4-akselisten ennakkoilmoitus tehtävä selaimella. Akselin raideväli jätetään tyhjäksi, jos tiettyä akselia ei ajoneuvolla ole. - Tieto on annettava M1-luokalla tiedostoennakkoilmoituksessa. - Muilla ajoneuvoluokilla tieto voidaan ilmoittaa, jos tarkka raideväli on tiedossa - Tieto löytyy version tiedoista (Mitat-ikkuna) Y. Tasonsäätö - Ilmoitetaan mikäli versiolla on tietona Valinnainen - Käytössä ajoneuvoluokilla M ja N - Tieto on koodiarvoinen (KdTyytiTasonsaato) - Sallitut arvot: K = kyllä E = ei - Tieto löytyy version tiedoista (Pyöräntuenta ja ohjaus -ikkuna) Z. Etusuojajärjestelmä - Ilmoitetaan mikäli versiolla on tietona Valinnainen - Käytössä ajoneuvoluokilla M1 ja N1 - Tieto on koodiarvoinen (KdTyytiEtusuojajarjestelma) - Sallitut arvot: K = kyllä E = ei Copyright Liikenteen turvallisuusvirasto 9 (11)
Esimerkkirivi ennakkoilmoitusrivistä: valmistenumero ; hyväksyntänumero ; variantti ; versio ; ajoneuvoluokka ; ennakkoilmoittajan tunnus ; moottorin numero ; merkki ; kaupallinen nimi ; väri ; lisäväri ; istumapaikat kuljettajan vieressä ; istumapaikat ; tulliton ; rekisterikilven malli ; ovien lukumäärä ; ovien sijainti ; turvavarusteet ; aktiivinen ajonhallintajärjestelmä ; lukkiutumattomat jarrut ; co2 ; omamassa ; akseliväli akselit 1-2 ; akseliväli akselit 2-3 ; akseliväli akselit 3-4 ; raideväli akseli 1; raideväli akseli 2 ; raideväli akseli 3 ; raideväli akseli 4 ; tasonsäätö ; etusuojajärjestelmä VALMISTENUMERO001;e1*01/116*0123*00;ABC41;GFH52;M1;1031715-9;;;;0;c;;;;;;;;;;;;;;;;;;;; VALMISTENUMERO002;e3*2007/46*0345*01;KLM42;PRS53;M1; 1031715-9;G4FC6U068499;762;ED;1;c;;;;01;;;;;K;K;150;1745;;;;1635;1645;;;; Copyright Liikenteen turvallisuusvirasto 10 (11)
3. Ennakkoilmoituksen paluutiedosto Ennakkoilmoittaja saa välityspalvelusta tiedoston onnistuneista ja epäonnistuneista ennakkoilmoituksista. Tiedosto on CSV-muodossa. Tiedostoon tulee jokaiselle riville tiedot yhdestä ilmoitetusta ajoneuvosta. Tietojen järjestys paluutiedostossa on: A. Valmistenumero B. Rekisteritunnus (voi puuttua, jos ennakkoilmoittajalla ei ole kilpivarastoa) C. Tyyppihyväksyntänumero D. Variantti E. Versio F. Ajoneuvoluokka G. Merkki H. Mallimerkintä I. Ennakkoilmoittajan tunnus J. Ennakkoilmoituspäivä K. Lisätietokoodi L. Lisätietokoodia vastaava selväkielinen lisätietoteksti M. Virhekoodi N. Virhekoodia vastaava selväkielinen tekstit Esimerkki paluutiedoston rivistä: VALMISTENUMERO001;IIK-137; e1*01/116*0123*00;abc41;gfh52;m1;762;ed Monikäyttöajoneuvo (AF) 5ov 1591cm3 Käsivalintainen;1031715-9;07062007;4050003;Tunnus on tilattu VALMISTENUMERO002;;e3*2007/46*0345*01;KLM42;PRS53;M1;762;ED Monikäyttöajoneuvo (AF) 5ov 1591cm3 Käsivalintainen; 1031715-9;07062007;; Copyright Liikenteen turvallisuusvirasto 11 (11)