SANOMALIIKENNE 1 YLEISET OHJEET EDI (Electronic Data Interchange) on sähköistä organisaatioiden välistä tiedonsiirtoa. Tietojen välittämiseen voidaan käyttää XML-tekniikkaa. Lisätietoja EDIn ja XML:n käyttämisestä sekä sähköiseen kaupankäyntiin liittyvistä asioista saa esimerkiksi Tietoyhteiskunnan kehittämiskeskus ry:stä (TIEKE, www.tieke.fi). Tämän sanomasovellusohjeen mukaisilla sanomilla voidaan tehdä autoveroilmoituksia ja autoverotuksen muutosilmoituksia. XML-ilmoittamisen edellytyksenä on, että asiakkaalla on voimassaoleva Verohallinnon lupa. 1. XML-MUOTOISET SANOMAT JA PDF-ASIAKIRJATIEDOSTOT Sanomat ovat XML-muotoisia. Yhteen lähetyskertaan sisältyy vain yksi sanoma. Sanomien yhteydessä ei lähetetä sähköisesti pdf-asiakirjatiedostoja. Autoverotuksessa käytettävät sanomat ja prosessit on kuvattu sanomaliikenneoppaassa. 2. SANOMISSA ILMOITETTAVISTA TIEDOISTA Verohallinnon autoverotusasiakkaan tunnisteena lähetyskerran tasolla on OVT tunnus. OVT tunnus muodostetaan seuraavasti: Vakio 0037 + Y-tunnus ilman väliviivaa. Sanoman tasolla asiakkaat tunnistetaan Y-tunnuksen ja Verohallinnon antamien asiakastunnusten perusteella. lähettää vastaussanoman ilmoitussanomassa olleen EDI-tunnuksen perusteella. Tunnisteena käytetään EDI-tunnusta 003702454428 (testitilanteeseen ohjeistetaan erikseen). 3. SANOMAMATERIAALIN LUKUOHJE Oppaan tietosisältö -dokumentissa esitellään eri sanomien rakenteita ja tietosisältöä. Asiakkaan järjestelmän tulee noudattaa Verohallinnon toimittaman XML scheman mukaisia XML sanomia. Schemassa on määritelty XML sanomassa toimitettavat tiedot, niiden tietotyypit sekä tietojen pakollisuus. Ilmoitussanomista on käytetty koodeja: Ensiveroilmoitus =VE Ensiveroilmoituksen täydennys =VT Muutosilmoitus =MI Muutosilmoituksen täydennys =MT Massamuutosilmoitus =MA Lupailmoitussanoma =VK Tietojen yhteydessä kerrotaan tiedon muoto, pituus ja pakollisuus. Pakollisuus merkitään kirjaimella P ja ehdollinen pakollisuus (P) jokaisen sanomatyypin kohdalla. Kuvaus-sarakkeessa kuvataan tietosisältö ja kerrotaan oletusarvot ja minimi- ja maksimiarvot.
SANOMALIIKENNE 2 Ehdollisesti pakollisten tietojen kohdalla on ehdot kuvattu kuvaus-kohdassa kerrotaan myös, mitä koodistoa asiakkaan tulee käyttää. Esiintymä-sarakkeessa esitetään elementin Esiintymä. Jos esim. arvona on 1, elementti on pakollinen. Jos arvo on 0-n, elementti ei ole pakollinen ja se voi puuttua kokonaan tai esiintyä yhden tai useita kertoja. Muoto-sarakkeessa on kuvattu tietosisällön muoto ja pituus. Pituus voi olla täsmällinen pituus (esim. 10) tai muuttuva (esim. 0-50). Jos elementin määritelty pituus on 1-10, tiedon on oltava vähintään 1 merkin ja maksimissaan 10 merkkiä pitkä. 4. TIETOJEN ESITYSTAPA Autoveroilmoitustiedot lähetetään Verohallinnon vahvistamia sanomamäärityksiä käyttäen. Käytettävä merkistö on UNOC (ISO8859-1), joka on 8 bitin Ansi-merkistö skandimerkein. Tyyppi xsd:datetime Kuvaus Aikaleima ISO 8601 mukaisesti jonka formaatti on määritelty aina elementin kuvaus sarakkeessa. Formaatti: YYYY-MM-DDThh:mm:ss.sTZD YYYY = vuosi neljällä numerolla MM = kuukausi kahdella numerolla (01=Tammikuu, jne.) DD = päivä kahdella numerolla (01..31) hh = tunnit kahdella numerolla (00..23) mm = minuutit kahdella numerolla (00..59) ss = sekunnit kahdella numerolla (00..59) s = sekunnin osat kolmella numerolla (000..999) (ei pakollinen osa) TZD = aikavyöhyke (Z tai +hh:mm tai hh:mm) (ei pakollinen osa) xsd:date xsd:string xsd:integer xsd:long xsd:decimal xsd:boolean Esimerkit: 12.01.2006 22.00 = 2006-01-12T22:00:00.000Z Systeemiaika = 2006-04-07T09:45:28.370Z Päivämäärä, sama kuin yllä ilman tunteja. Voi sisältää aikavyöhykkeen. Kirjaimia ja numeroita. Kentillä on minimi- ja maksimipituudet, perustyyppi on kuitenkin merkkijono. Numeroita. Jos integer tyyppinen elementti esiintyy, sen arvo ei voi olla tyhjä. Numeroita. Jos long tyyppinen elementti esiintyy, sen arvo ei voi olla tyhjä. Desimaaliluku. Jos decimal tyyppinen elementti esiintyy, sen arvo ei voi olla tyhjä. true/false tai 1/0 tyyppinen kenttä. Sanomassa ilmoitettavat luvut ovat positiivisia lukuja (+-merkkiä ei ilmoiteta). Päivämäärät ovat muotoa vuosi-kuukausi-päivä (vvvv-kk-pp). Verohallinnosta lähtevissä sanomissa voi muutospäätöksen ollessa kyseessä, esiintyä negatiivisia lukuja. Saapuvissa sanomissa ei käytetä desimaalierottimia. Verohallinnosta lähtevissä sanomissa on desimaalierottimena piste prosenttiluvuissa. Erottimia ei käytetä euromääräisissä summissa. Sanomissa ei normaalisti käytetä tarpeettomia etunollia, mutta on tulevat sanomat hyväksytään vaikka siinä olisi mukana etunollia, kunhan se on muuten määritysten mukainen.
SANOMALIIKENNE 3 Verohallinnosta lähteviin sanomiin ei lisätä etunollia. Numeerisissa tiedoissa ei etunollilla ole merkitystä, kun taas merkkijonotiedoissa on. Ei-pakollisten tietojen tagit voidaan ilmoittaa sanomassa tyhjinä tai ne voidaan jättää ilmoittamatta kokonaan. 5. TIETOJEN LÄHETYSTAPA antaa erillisen ohjeen asiakkaan liittymisestä Verohallinnon xml- muotoisen sanomaliikenteen käyttäjäksi autoveroilmoitusten osalta. 6. KUITTAUKSET, ONGLEMATILANTEET JA VARAJÄRJESTELYT Seurantavastuu sanomien kulusta on pääosin asiakkaalla eli tämän on huolehdittava, että kaikkiin lähetettyihin sanomiin saadaan vastaus. ei lähetä asiakkaalle kuittauksena erillistä lähetyskertakohtaista kontrollisanomaa. Sanoman lähettäjä saa vastaussanoman, joka on joko hylkäys-, virhe-, keskeytys- tai päätössanoma. Verohallinnon järjestelmä tarkastaa, että jokainen lähetetty sanoma täyttää Verohallinnon sanomalle määrittelemät vaatimukset. Validin sanoman perilletulosta lähetetään sanoman lähettäjälle aina kuittauksena jokin vastaussanomista. Lisätietoja sanomien kulusta on sanomaliikenneoppaassa. Muissa autoverotukseen liittyvissä ongelmissa otetaan yhteyttä Verohallinnon Hangon toimipisteeseen. Poikkeustilanteissa (sanomien kulku on kokonaan estynyt) ohjeistaa erikseen, millä poikkeusjärjestelyllä autoveroilmoitukset annetaan. 7. LOKITIEDOT Koska epäselvissä tapauksissa asiakkaalla on näyttövastuu sanoman lähettämisestä oikeassa ajassa ja sanoman sisällöstä, on tämän syytä ylläpitää sellaista lokia, josta koko lähetetty ilmoitussanoma on vaikeuksitta luettavissa XML-muodossa ja tarvittaessa saadaan tulostettua kirjallisessa muodossa. Lähetysajan todistamiseen riittää lähettäjän, vastaanottajan, lähetyskerran tunnuksen, lähetysajan ja lähetyskertaan sisältyvän Verohallinnon viitenumeron tai jos viitenumeroa ei vielä ole annettu, ilmoittajan järjestelmän viitenumeron lokitiedot. Asiakkaan esittämä näyttö ei kuitenkaan estä veroviranomaista määräämästä hallinnollisia seuraamuksia tai ryhtymästä muihin toimenpiteisiin, jos sanoman viive tai virheellisyys antaa tällaiseen aihetta. 8. REKISTERÖIDYKSI AUTOVEROVELVOLLISEKSI HAKEUTUMINEN JA TESTAUS Rekisteröitynä verovelvollisena toimiminen on luvanvaraista, ja lupa myönnetään hakemuksesta. Vapaamuotoisen hakemuksen sisältövaatimuksista ja liitteistä saa lisätietoa Verohallinnon Hangon toimipisteestä. Hakemuksen käsittelyaika on noin 2 kuukautta riippuen tietoteknisten testausten aikataulusta. Lisätietoja on Veron Internetsivuilla.
SANOMALIIKENNE 4 antaa asiakkaalle testauksesta yksityiskohtaiset ohjeet ennen testauksen aloittamista ja jokaisen asiakkaan kanssa tehdään omat testaussuunnitelmat. Testaaminen hoidetaan Verohallinnon tekemillä testitapauksilla ja asiakkaan omalla tuotantoaineistolla, jotka asiakkaan tulee toimittaa Verohallinnon Hangon toimipisteeseen viimeistään viikkoa ennen testien aloittamista. Kaikki rekisteröityjen verovelvollisten autoveroilmoitukset ja autoverotuksen muutoshakemusilmoitukset käsitellään keskitetysti Verohallinnon Hangon toimipisteessä 1.1.2017 alkaen. 9. ARKISTOINTI Rekisteröidyt verovelvolliset ovat velvollisia arkistoimaan xml-liikenteessä vastaanottamansa veropäätössanomat kirjanpidon tositeaineistoa koskevien säännösten ja määräysten mukaan. Verotuspäätöksiin liittyvät tositteet pitää olla helposti yhdistettävissä ja audit trail on oltava mahdollista myös kansainvälisiin maksutapahtumiin (mm. tehdaslaskut, rahtilaskut, vakuutusmaksut, tilitositteet ja verovapauden tai alennetun autoveron perusteena oleva tosite). Arkistointi voi tapahtua paperisena tai teknisenä tallenteena. Säilytysaika on kuluva vuosi + kuusi (6) vuotta eli sama kuin muulla kirjanpidon tositeaineistolla. Verotuspäätös pitää voida tarvittaessa tulostaa (joko rakenteisena xml:nä tai lomakepohjaan). antaa asiakkaille erikseen tulostepohja-mallin pdf-muodossa, jossa on esillä xml-tagien nimet. Asiakas pystyy hyödyntämään tulostepohjaa tulostussysteeminsä rakentamisessa. 10. MUUT OHJEET 10.1. Muutossanomat XML-muutossanomia voidaan lähettää vain koskien niitä ensivero- tai muutospäätöksiä, jotka ovat tehty MOVElla. Vanhalla autoverotusjärjestelmällä tehtyjen verotusten muutoksia tulee hakea manuaalisesti. Niitä ei voida ilmoittaa xml-sanomaliikenteen kautta. Vanhalla autoverotusjärjestelmällä tehdyt päätökset tunnistaa siitä, että päätösnumero alkaa A kirjaimella, jota seuraa vuosiluku. MOVE-verotusjärjestelmän asianumero (= päätösnumero) alkaa numerolla kolme (3) ja jatkuu asiakaskohtaisella sarjanumerolla. Asiakas pystyy lähettämään useampia muutosilmoituksia vireille Verohallinnon autoverotusjärjestelmään, mutta ilmoitukset käsitellään saapumisjärjestyksessä. Muutosilmoituksen on kuitenkin koskettava aina edellisen muutosilmoituksen asianumeroa. 10.2. Jaksoilmoittaminen poimii ilmoitussanomat jaksoerittelylle verotusjakson päättymispäivän ja viimeisen jättöpäivän mukaan. Ilmoituksen verotusjakso päätellään päätöspäivän mukaan. 10.3. Täydennyssanomat Asiakkaan tulee huolehtia siitä, että täydennystä vaativa sanoma täydennetään verotusjakson viimeiseen jättöpäivään mennessä, jotta asiakas välttyy viivästysseuraamuksilta. Täydennyssanoma käsitellään kuten aiempi ilmoitussanoma.
SANOMALIIKENNE 5 10.4. Sanoma id:n muodostaminen Asiakas saa määrätä sanoma id:n muodon (14 merkkiä). suosittelee kuitenkin sanoma id:n muodostamista seuraavan säännön mukaan: Merkit 1-5 Verohallinnon verovelvolliselle myöntämä sarjanumero (esim. 80000) Merkit 6-7 Kuluvan vuoden kaksi viimeistä numeroa (esim. 07, vaihtuu vuosittain) Merkit 8 14 Numeroidaan juoksevasti (esim. 0000001) Sanoma id olisi muotoa: 80000070000001. 10.5. Namespace vaatimukset Verohallinnon schema vaatii namespace:n kaikilta lapsitageilta. 10.6. Asiakkaan järjestelmien muutokset suosittelee sanomaliikenteen testausta, jos asiakkaan järjestelmiin on tehty muutoksia hyväksytyn testauksen ja rekisteröidyksi verovelvolliseksi siirtymisen jälkeen. Testauksesta voi erikseen sopia Autoverotuksen yhteyshenkilön kanssa: / Autoverotus Tia sjöberg PL 1000 10901 Hanko sähköposti etunimi.sukunimi@vero.fi Autoveroneuvonta p. 029497150