Sopimus ajoneuvojen ennakkoilmoittamisesta Liite 6 Tiedostomuotoinen ennakkoilmoitus Asiakas - välityspalvelu tiedostojen kuvaus Versio 2.0 Copyright Liikenteen turvallisuusvirasto
MUUTOSHISTORIA Versio Päiväys Laatija Muutoksen kuvaus / hyväksyjä 2.0 Essi Laakso Lisätty ohjeeseen uudet tiedostoennakkoilmoitustiedot. Päivitetty ohjeeseen Trafi-muutokset. 1.1 22.3.2007 Essi Koskikallio Päivitetty dokumenttia. 1.0 Jorma Uronen 0.91 13.4.2005 Jorma Uronen Poistettu [0..1] merkinnät 0.9 6.4.2005 Björn Ziessler Ensimmäinen versio Copyright Liikenteen turvallisuusvirasto 2(11)
Sisällysluettelo 1. Yleiskuvaus...4 2. Rajapinnat ja palvelut...5 2.1 Ennakkoilmoitusaineisto...5 2.1.1 Tiedostomuoto ja tiedoston nimeäminen...5 2.1.2 Ennakkoilmoitustiedot...5 2.1.3 Tietojen järjestys ennakkoilmoitusaineistossa...8 2.2 Ennakkoilmoituspaluutiedot...9 2.2.1 Tiedostomuoto ja -rakenne...9 2.2.2 Paluutiedoston tiedot...9 2.2.3 Tietojen järjestys paluutiedostossa...11 Copyright Liikenteen turvallisuusvirasto 3(11)
1. Yleiskuvaus Dokumentti sisältää tiedostomuotoiseen ennakkoilmoitukseen käytettävän asiakkaalta välityspalveluun lähettämän tiedostomuodon ja tietosisällön kuvauksen, sekä välityspalvelun asiakkaalle lähettämän paluutiedoston tiedostomuodon ja tietosisällön kuvauksen. Copyright Liikenteen turvallisuusvirasto 4(11)
2. Rajapinnat ja palvelut 2.1 Ennakkoilmoitusaineisto Tässä kappaleessa kuvataan tiedoston rakenne, jonka asiakas lähettää välityspalveluun. 2.1.1 Tiedostomuoto ja tiedoston nimeäminen Tiedostot lähetetään välityspalvelulle CSV-tiedostomuotoa käyttäen. CSV-tiedostossa on yhdellä rivillä ainoastaan yhden ajoneuvon tietoja. Yhden ajoneuvon yksittäiset tiedot erotetaan toisistaan puolipistein ( ; ). Vaikka jokin tieto jäisi tyhjäksi (esim. tieto on versiolla yksikäsitteinen), tulee jokaisella rivillä olla oikea määrä puolipisteitä. Tietojen on oltava aina sovitussa järjestyksessä. 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. 2.1.2 Ennakkoilmoitustiedot Tässä kappaleessa olevaan taulukkoon on koottu kaikki asiakkaan ennakkoilmoitustiedostossa esiintyvät tiedot ja tietojen selitykset. Ennakkoilmoituksessa ajoneuvo ennakkoilmoitetaan Trafin Ajoneuvotyyppihyväksyntäjärjestelmässä (TYYTI) olevilla version tiedoilla. Nimi Tyyppi Kuvaus Käytettävä koodisto ajoneuvoluokka code Ennakkoilmoitettavan ajoneuvon KdTyytiAjoneuvoluokka luokka. Tieto on pakollinen. ajovakaudenhallinta code Ajovakauden hallinta ( = aktiivinen ajonhallintajärjestelmä). KdTyytiAktiivinenAjonh allinta Käytössä ajoneuvoluokilla M, N, O2- O4, L3-L5, L3e-L7e. K = kyllä E = ei akselivalipituus integer Akselivälit täysin kuormitettuina. Akseliväli voidaan ilmoittaa akseleille 1-4. co2maara integer Hiilidioksidin päästömäärä g/km. 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. Copyright Liikenteen turvallisuusvirasto 5(11)
ennakkoilmoittajantu nnus string Jos tietoa ei yksilöidä ennakkoilmoitustiedostossa, tallentuu ajoneuvolle versiolle merkitty tieto (M2, M3, N2 ja N3 luokat). Ennakkoilmoitusasiakkaan y-tunnus. Tieto on pakollinen. CHARACTER(11) etusuojajarjestelma code Etusuojajärjestelmä. Käytössä ajoneuvoluokilla M1 ja N1. K = kyllä E = ei istumapaikatkuljviere ssa integer Istumapaikkojen lukumäärä kuljettajan vieressä. Käytössä ajoneuvoluokilla M, N, L, MA, T, MTK ja C istumapaikatlkm integer Ajonaikaisten istumapaikkojen kokonaislukumäärä. Käytössä ajoneuvoluokilla M, N, L, MA, T, MTK ja C. jarrutlisatieto code Jarrujen lisätieto ( = lukkiutumattomat jarrut). K = kyllä E = ei kaupallinennimi string Ajoneuvon kaupallinen nimi. VARCHAR(255) kilvenmalli code Kilven malli ( = rekisterikilven koko). Käytössä ajoneuvoluokilla M ja N. 1 = matala (ent. pitkä) 2 = korkea (ent. lyhyt) lisavari code Ajoneuvon lisäväri. Käytössä ajoneuvoluokilla M1, N ja L. KdTyytiEtusuojajarjest elma KdTyytiLukkiutumatto matjarrut KdTyytiRekisterikilvenK oko KdTyytiLisavari merkki code Ajoneuvon merkki. KdTyytiAjoneuvonMerk ki moottorinnumero string Moottorin numero. Käytössä muilla paitsi O-luokan ajoneuvoilla. VARCHAR(30) omamassa integer Ajoneuvon 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, Copyright Liikenteen turvallisuusvirasto 6(11)
N3, L, MA, T, MTK ja C -luokat). ovetlkm integer Ovien kokonaislukumäärä. Käytössä ajoneuvoluokilla M, N, L, MA, T, MTK ja C ovetsijainti code Ovien sijainti. Käytössä ajoneuvoluokilla M, N, L, MA, T, MTK ja C 01 = 2V, 2O 02 = 2V, 2O, takaovi 03 = 2V, 2O, pariovi takana 04 = 1V, 1O 05 = 1V, 1O, takaovi 06 = 1V, 1O, pariovi takana 07 = 1V, 2O 08 = 1V, 2O, takaovi 09 = 1V, 2O, pariovi takana 10 = 1O (linja-autot) 11 = 2O (linja-autot) 12 = 3O (linja-autot) X = ei mikään tai ei sovellettavissa Y = muu raidevali integer Akseleiden raideväli. Käytössä ja pakollinen ajoneuvoluokilla M1. Käytössä ajoneuvoluokilla M2, M3, N, O, L, MA, T, MTK ja C. Tieto on annettava M1-luokalla tiedostoennakkoilmoituksessa. Muilla ajoneuvoluokilla tieto voidaan ilmoittaa, jos tarkka raideväli on tiedossa. Raideväli voidaan ilmoittaa akseleille 1-4. tasonsaato code Tason säätö. K = kyllä E = ei tulliton code Tieto, onko ajoneuvo koottu EU:ssa vai EU:n ulkopuolella, eli onko kyseessä tulliton ajoneuvo. K = kyllä E = ei turvavaruste code Tieto valinnaisesti asennetusta turvavarusteesta. et = Etuturvatyyny st = Sivuturvatyyny vk = Turvavyön kiristin an = Aktiivinen niskatuki turvavaruste: pakollisuus code Turvavarusteen pakollisuus. Koodiarvot: Sallittu arvo: 2 = valinnaisesti asennetut turvavaruste: integer Tieto penkkirivistä, jolla KdTyytiOvienSijainti KdTyytiTasonsaato KdTyytiKokoonpano KdKatsaTurvavaruste KdKatsaTurvavarustee npakollisuus Copyright Liikenteen turvallisuusvirasto 7(11)
penkkirivi turvavaruste sijaitsee. turvavaruste: sijainti code Tieto turvavarusteen sijainnista. KdKatsaTurvavarustee nsijainti tyyppihyvaksyntanu mero string Tyypin yksilöivä hyväksyntänumero Kansallinen hyväksyntänumero on muotoa FIN*vvkkpp*0123*01, eli maatunnus, diaaripäivä, järjestysnumero, laajennus EY-tyyppihyväksyntänumero on muotoa e1*2007/46*0345*01, eli maatunnus, muuttava säädös, järjestysnumero, laajennus. Pakollinen tieto (voi puuttua konvertoiduilta ajoneuvoilta). VARCHAR(40) valmistenumero string Ajoneuvon valmistenumero. Tieto on pakollinen. VARCHAR(30) vari code Ajoneuvon väri. KdTyytiVari Käytössä ja pakollinen ajoneuvoluokilla M1 ja N1. Käytössä ajoneuvoluokilla M1, N ja L. variantti string Variantin nimi Valmistajan variantille antama nimi. Pakollinen mikäli varianttitieto olemassa. VARCHAR(100) versio string Version nimi Valmistajan versiolle antama nimi, joka yksilöi version muista saman variantin alla olevista versioista. Konvertoiduilla tyypeillä versionimenä voi olla LTJ:n tyyppikoodi. Pakollinen mikäli versiotieto olemassa. VARCHAR(100) 2.1.3 Tietojen järjestys ennakkoilmoitusaineistossa Tiedot ilmoitetaan CSV-tiedostossa aina seuraavassa järjestyksessä: 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ä Copyright Liikenteen turvallisuusvirasto 8(11)
Jokaisen kohdan välissä tulee olla puolipiste. Mikäli erotinmerkki on jossain välitettävässä tiedossa, on sen eteen lisätty merkki /. Eli /; tarkoittaa kentän tietoon kuuluvaa ;-merkkiä, eikä se toimi kenttien erotinmerkkinä. 2.2 Ennakkoilmoituspaluutiedot Tässä kuvataan tiedoston rakenne, jonka välityspalvelu kokoaa asiakkaalle asiakkaan tiedostomuotoisesti ennakkoilmoittamien ajoneuvojen ennakkoilmoitusten onnistumisesta. 2.2.1 Tiedostomuoto ja -rakenne Välityspalvelu kokoaa kaikki saman päivän aikana samalta ennakkoilmoittajalta tulleet ennakkoilmoitukset omiin paluutiedostoihinsa. Paluutiedostot ovat CSV-muodossa. CSV-tiedostossa on yhdellä rivillä ainoastaan yhden ajoneuvon tietoja. Yhden ajoneuvon yksittäiset tiedot on erotettu toisistaan puolipistein ( ; ). 2.2.2 Paluutiedoston tiedot Tässä kappaleessa olevaan taulukkoon on koottu kaikki paluutiedossa esiintyvät tiedot ja tietojen selitykset. Nimi Tyyppi Kuvaus Käytettävä koodisto ajoneuvoluokka code Ajoneuvoluokka. KdTyytiAjoneuvoluokka ajoneuvonmerkki code Ajoneuvon merkki. KdTyytiAjoneuvonMerkki ennakkoilmoittajantunnus string Ennakkoilmoitusasiakkaan y- tunnus. CHARACTER(11) ennakkoilmoituspaivamaara date Päivä, jolloin ennakkoilmoitus on tehty. mallimerkinta string Ennakkoilmoitetun ajoneuvon mallimerkintä. Käytössä ajoneuvoluokilla M ja N. VARCHAR(200) rekisteritunnus string Ennakkoilmoitetun ajoneuvon rekisteritunnus, mikäli ajoneuvo on saanut rekisteritunnuksen ennakkoilmoituksen yhteydessä. CHARACTER(9) tyyppihyvaksyntanumero string Tyyppihyväksyntänumero. VARCHAR(40) valmistenumero string Ajoneuvon valmistenumero. VARCHAR(30) variantti string Varianttinimi. Copyright Liikenteen turvallisuusvirasto 9(11)
VARCHAR(100) versionimi string Versionimi. VARCHAR(100) lisatietokoodi code Lisätietokoodi. KdPalkoIlmoitukset lisatietoteksti string Kuvaus lisätiedosta selväkielisenä. Koodiston mukainen lyhytselite. - Tunnus on tilattu - Ajoneuvolla on häntälupa virheensyy code Virheensyykoodi. virheellinentieto string Kuvaus virheellisestä tiedosta selväkielisenä. Koodiston mukainen lyhytselite. Ennakkoilmoittaja/ sopimuskohtaiset ilmoitukset: - Ennakkoilmoittajaa ei löydy - Sopimusta ei löydy Versiokohtaiset ilmoitukset: - Versiota ei löydy - Ei oikeutta versioon - Ennakkoilmoitus tiedostona vain valmiille ajoneuvoille - Oikeus ennakkoilmoittaa vain autoverottomia ajoneuvoja - Oikeus ennakkoilmoittaa vain EU-maissa kokoonpantuja autoverottomia ajoneuvoja Ajoneuvokohtaiset ilmoitukset: - Valmistenumero virheellinen - Valmistenumerolla löytyy jo ajoneuvo ATJ:stä - Ajoneuvo on anastettu - Version voimassaolo on päättynyt ja poikkeuslupa puuttuu - Poikkeusluvan voimassaolo on päättynyt - Tiedossa puutteita tai ristiriita ('tiedon nimi') - Tieto ei täsmää ('tiedon nimi') - Yli 4-akseliset ajoneuvot ennakkoilmoitetaan käyttöliittymällä Copyright Liikenteen turvallisuusvirasto 10(11)
2.2.3 Tietojen järjestys paluutiedostossa Tiedot ovat paluutiedostossa aina seuraavassa järjestyksessä: valmistenumero ; rekisteritunnus ; hyväksyntänumero ; variantti ; versio ; ajoneuvoluokka ; merkki ; mallimerkintä ; ennakkoilmoittajan tunnus ; ennakkoilmoituspäivä ; lisätietokoodi ; lisätietoteksti ; virhekoodi ; virheteksti Copyright Liikenteen turvallisuusvirasto 11(11)