Tiedostomuotoinen ennakkoilmoitus 16.2.2012 Versio 1.2 Copyright Liikenteen turvallisuusvirasto
TALLENNUSPAIKKA: MUUTOSHISTORIA Versio Päiväys Laatija Muutoksen kuvaus / hyväksyjä 1.2 16.2.2012 Ville Korhonen Muutettu kohdan 2 kohtaa U sekä lisätty esimerkki liittyen polttoaineen sähkö ilmoittamiseen 1.1 Ville Korhonen Päivitetty polttoainekohtainen CO2 -ilmoitustapa. 1.0 6.9.2010 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 (12)
Sisällysluettelo 1. Tiedostomuotoinen ennakkoilmoitus... 4 2. Ennakkoilmoitustiedosto... 5 3. Ennakkoilmoituksen paluutiedosto...12 Copyright Liikenteen turvallisuusvirasto 3 (12)
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 (12)
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 (12)
- 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 M1, 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 - Tieto löytyy version tiedoista (Kori-ikkuna) 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 (12)
- Lukumäärä ilmoitettava numerona - Tieto löytyy version tiedoista (Kori-ikkuna) 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 - Tieto löytyy version tiedoista (Kori-ikkuna) 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) - Tieto löytyy version tiedoista (Kori-ikkuna) 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 (12)
Sijainti, mahdolliset koodiarvot: 1 = vasen 2 = keskellä 3 = oikea - Tieto löytyy version tiedoista (Kori-ikkuna) 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. Polttoaine-CO 2 - Ajoneuvon polttoainekohtainen CO 2 -tieto - Polttoaine on kaksinumeroinen koodiarvo (KdTyytiPolttoaine) - 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) - Polttoaine-tieto löytyy version tiedoista (Moottori 1 -ikkuna) ja CO 2 -tieto version tiedoista (Päästöt ja kulutus 2 -ikkuna) Esimerkki polttoainekohtaisesta CO 2 ennakkoilmoittamisesta, kun version polttoaineina ovat bensiini ja CNG ;01 123 13 118; = 01 = bensiinin polttoainekoodi = erotinmerkki Copyright Liikenteen turvallisuusvirasto 8 (12)
123=bensiinin CO2 arvo välilyönti 13=CNGn polttoainekoodi = erotinmerkki 118=CNGn CO2 arvo Esimerkki polttoainekohtaisesta CO 2 ennakkoilmoittamisesta, kun version polttoaineina ovat diesel ja sähkö ;02 123 04 0; = 02 = dieselin polttoainekoodi = erotinmerkki 123=dieselin CO2 arvo välilyönti 04=sähkön polttoainekoodi = erotinmerkki 0=sähkön CO2 -arvo 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) - 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. Copyright Liikenteen turvallisuusvirasto 9 (12)
- 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 - Tieto löytyy version tiedoista (Kori-ikkuna) Copyright Liikenteen turvallisuusvirasto 10 (12)
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 ; polttoaibe 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;01 123 13 118;1745;;;;1635;1645;;;; Copyright Liikenteen turvallisuusvirasto 11 (12)
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 12 (12)