Tulorekisteri virhekoodit: mitä yleisimmät koodit tarkoittavat ja miten hylätty palkkatietoilmoitus korjataan
Tulorekisterin virhekoodi on kirjaimista ja numeroista koostuva tunnus, kuten IDV0040 tai TRVA0010, jonka tulorekisteri palauttaa, kun palkkatietoilmoitus tai koko aineisto hylätään. Hylättyä ilmoitusta ei ole tallennettu tulorekisteriin, joten palkka on edelleen ilmoittamatta ja se pitää korjata ja lähettää uudelleen ennen määräaikaa. Tähän on koottu Verohallinnon vuoden 2026 virhekoodiluettelosta pienen työnantajan yleisimmät koodit suomeksi selitettyinä ja korjausohjeineen.
Lyhyesti
- Virhekoodin kirjainosa kertoo tietoryhmän: esimerkiksi IDV = tunnisteet, TRVA = tulolajit, PIV = eläkevakuutus, RDV ja DDVS = ilmoituksen ja aineiston viitteet, MSE = allekirjoitus ja tekninen sanoma.
- Hylätty ilmoitus ei ole tulorekisterissä. Palkka on ilmoitettava silti 5 kalenteripäivän kuluessa maksupäivästä, ja myöhästymismaksu alkaa maksupäivää seuraavan kuun 8. päivän jälkeen.
- Osittain hylätyssä aineistossa virheettömät ilmoitukset tallentuvat ja virheelliset hylätään. Lähetä uudelleen vain hylätyt.
- Virhekoodiluettelo julkaistaan vuosittain tulorekisterin dokumentaatio-sivulla Excel-tiedostona. Tämän sivun selitykset perustuvat vuoden 2026 luetteloon.
Palkanlaskentaohjelma, tiedostolähetys ja tekninen rajapinta kertovat tulorekisterin virheestä koodilla. Koodi on hyödyllinen, koska se kertoo tarkasti, mikä kenttä on väärin. Se on myös hämmentävä, koska Verohallinnon virallinen virhekoodiluettelo on tekninen ja pitkä: vuoden 2026 luettelossa on satoja koodeja. Pienen työnantajan ilmoituksissa toistuu kuitenkin muutama kymmenen.
Mistä tulorekisterin virhekoodit löytyvät?
Tulorekisterin virhekoodit julkaistaan vero.fi:n tulorekisterin ohjelmistokehittäjien dokumentaatio-sivulla Excel-tiedostona, erikseen kullekin vuodelle. Luettelossa on jokaisen koodin tunnus ja selite. Koodeja muutetaan vuosittain, joten tarkista selite sen vuoden luettelosta, jota ilmoituksen maksupäivä koskee. Muut koodit on koottu artikkeliin tulorekisterin koodisto.
Koodi näkyy eri paikassa sen mukaan, miten ilmoitat. Palkanlaskentaohjelma näyttää sen palautetiedossa tai virhelokissa. Tiedostolähetyksessä aineiston tilaksi tulee Hylätty tai Osittain hylätty, ja osassa tilanteista näytetään pelkkä koodi. Tulorekisterin asiointipalvelun verkkolomake tarkistaa pakolliset tiedot jo täytön aikana, joten siellä virheet näkyvät yleensä tekstinä ennen lähettämistä.
| Aineiston tila | Mitä se tarkoittaa | Mitä teet |
|---|---|---|
| Tallennettu tulorekisteriin | Kaikki ilmoitukset hyväksyttiin | Ei mitään. Tarkista vielä, että luvut ovat oikein. |
| Osittain hylätty | Virheettömät ilmoitukset tallennettiin, virheelliset hylättiin | Korjaa ja lähetä vain hylätyt ilmoitukset. |
| Hylätty | Mitään ei tallennettu | Korjaa virhe ja lähetä koko aineisto uudelleen. |
Mitä virhekoodin kirjaimet tarkoittavat?
Virhekoodin alkuosa kertoo, mihin tietoryhmään virhe liittyy, ja numero yksilöi tarkistuksen. Kun tunnet alkuosan, tiedät, mistä kohdasta ilmoitusta virhettä kannattaa etsiä, vaikka et heti löytäisi koodin selitettä.
| Alkuosa | Tietoryhmä | Tyypillinen syy pienellä työnantajalla |
|---|---|---|
| IDV | Tunnisteet (henkilötunnus, Y-tunnus) | Henkilötunnuksessa näppäilyvirhe tai väärä tunnistetyyppi |
| IEV, IEBV | Tulonsaajan tiedot | Tunniste puuttuu, ulkomaisen työntekijän nimi tai syntymäaika puuttuu |
| IEPV | Ammattiluokka | Tilastokeskuksen ammattiluokka puuttuu tai on väärä |
| TRVA, TBVA | Tulolajit | Ilmoitustavat 1 ja 2 sekaisin, tulolaji ei voimassa maksupäivänä, luontoisedun lisätiedot puuttuvat |
| PIV | Työeläkevakuutus | Eläkevakuutussopimuksen numero väärin tai ei voimassa |
| EV | Palvelussuhde | Työsuhteen päättymispäivä ennen alkamispäivää |
| RDV, DDVS, GEDD | Ilmoituksen ja aineiston perustiedot | Sama viite lähetetty jo aiemmin, lähettäjällä ei oikeutta |
| MSE | Tekninen sanoma ja allekirjoitus | Varmenne tai allekirjoitus ei kelpaa, tiedostomuoto väärä |
| BEV, AV | Etuustiedot ja poissaolot | Koskevat lähinnä etuuksien maksajia ja Kelan korvaushakemuksia |
Yleisimmät tulorekisterin virhekoodit ja korjaus
Alla on pienen työnantajan palkkatietoilmoituksissa yleisiä virhekoodeja. Selitteet on käännetty ja tiivistetty Verohallinnon vuoden 2026 virhekoodiluettelosta. Korjaus tarkoittaa, että muutat tiedon palkanlaskentaan ja lähetät hylätyn ilmoituksen uudelleen.
| Koodi | Mitä se tarkoittaa | Korjaus |
|---|---|---|
| IDV0040 | Tuntematon suomalainen henkilötunnus tai Y-tunnus | Tarkista tunnus työsopimuksesta tai henkilöllisyystodistuksesta. Keinotekoiselle tunnisteelle valitaan tunnistetyypiksi muu tunniste. |
| IDV0080 | Henkilötunnuksen tai Y-tunnuksen muoto on väärä | Tarkista väliviiva, välimerkki ja tarkistemerkki. |
| IDV0180 | Tiedon alussa tai lopussa on näkymättömiä merkkejä | Poista kopioinnista jääneet välilyönnit ja rivinvaihdot. |
| RDV0031 | Samalla maksajan ilmoitusviitteellä on jo lähetetty ilmoitus | Uusi ilmoitus tarvitsee uuden yksilöllisen viitteen. Jos tarkoitit korjata vanhaa, tee korvaava ilmoitus. |
| DDVS0280 | Samalla aineistoviitteellä on jo lähetetty aineisto | Anna aineistolle uusi viite ja lähetä uudelleen. |
| DDVS0230 | Maksupäivä on yli 45 päivää tulevaisuudessa | Tarkista maksupäivän vuosi ja kuukausi. |
| TRVA0010 | Samassa ilmoituksessa on ilmoitustavan 1 (100-sarja) ja 2 (200-sarja) tulolajeja | Valitse yksi ilmoitustapa ja ilmoita kaikki tulolajit sen mukaan. |
| TRVA0020 | Tulolaji 101 Palkka yhteensä puuttuu, vaikka käytössä on ilmoitustapa 1 | Lisää 101 ja sen vakuutustiedot. |
| TRVA0340 | Tulolaji 101 on ilmoituksella useammin kuin kerran | Yhdistä palkat yhdeksi 101-riviksi. |
| TRVA0380 | Tulolaji ei ole voimassa maksupäivänä | Tarkista tulolajin koodi kyseisen vuoden tulolajiluettelosta. |
| TRVA0080 | Autoedun (304) tietoryhmä puuttuu | Lisää autoedun tyyppi ja ikäryhmä. |
| TRVA0160 | Päivärahan (331) tietoryhmä puuttuu | Lisää päivärahan tyyppi. |
| PIV0100 | Eläkelaitoksen koodi ei vastaa vakuutussopimuksen numeron alkua | Kopioi TyEL-sopimusnumero eläkeyhtiön vakuutuskirjasta. |
| PIV0110 | Eläkevakuutussopimuksen numero on tuntematon tai ei voimassa maksupäivänä | Tarkista, onko TyEL-vakuutus voimassa ja numero oikein. Tilapäinen työnantaja käyttää tilapäisen työnantajan yleistä numeroa. |
| IEPV0020 | Tilastokeskuksen ammattiluokka puuttuu | Lisää ammattiluokka, ks. tulorekisteri ammattiluokka. |
| EV0100 | Palvelussuhteen päättymispäivä on ennen alkamispäivää | Tarkista työsuhteen päivämäärät. |
| PV0020 | Maksaja ja tulonsaaja ovat samat | Tarkista, ettei maksajan Y-tunnusta tai omaa henkilötunnusta ole tulonsaajana. |
| GEDD0090 | Lähettäjällä ei ole oikeutta lähettää aineistoa maksajan puolesta | Tarkista Suomi.fi-valtuus Palkkatietojen ilmoittaminen tai ohjelmiston rajapintavaltuus. |
| MSE0010, MSE0050 | Aineiston allekirjoitus tai varmenne ei kelpaa | Uusi tai tarkista tulorekisterin varmenne, ks. tulorekisterin varmenne. |
Mitä tapahtuu, jos tulorekisteri-ilmoitus hylätään?
Hylättyä ilmoitusta ei ole tallennettu tulorekisteriin, joten palkka on tulorekisterin kannalta ilmoittamatta. Palkkatiedot on ilmoitettava 5 kalenteripäivän kuluessa maksupäivästä, ja myöhästymismaksu alkaa, jos palkka ilmoitetaan maksupäivää seuraavan kuukauden 8. päivän jälkeen. Maksu on 3 euroa päivältä, enintään 135 euroa, ja yli 45 päivää myöhässä lisäksi 1 % palkasta.
Siksi hylkäys pitää huomata heti. Moni pieni työnantaja olettaa ilmoituksen menneen perille, koska palkanlaskentaohjelma ilmoitti lähettäneensä sen. Lähetys ei kuitenkaan ole sama asia kuin tallennus. Myöhästymismaksun voit laskea myöhästymismaksulaskurilla, ja tilanteet on käyty läpi artikkelissa tulorekisteri-ilmoitus myöhässä. Lähetetyt tiedot voi tarkistaa tulorekisterin raportilla 600.
- 11. Tarkista tilaKatso palkanlaskentaohjelmasta tai tulorekisterin asiointipalvelusta, onko aineisto Tallennettu, Osittain hylätty vai Hylätty.
- 22. Lue koodiEtsi koodi yllä olevasta taulukosta tai kyseisen vuoden virhekoodiluettelosta.
- 33. Korjaa lähdetietoKorjaa tieto palkanlaskennan perustietoihin, kuten työntekijän henkilötunnukseen tai TyEL-numeroon, jottei sama virhe toistu seuraavassa palkassa.
- 44. Lähetä uudelleenHylätty ilmoitus lähetetään uutena ilmoituksena. Käytä uutta aineistoviitettä, muuten saat koodin DDVS0280.
- 55. Varmista tallennusTarkista, että tila on nyt Tallennettu tulorekisteriin. Vasta tämä tila tarkoittaa, että palkka on ilmoitettu.
Virhekoodi vai virheellinen tieto: mikä ero?
Virhekoodi tulee vain, kun ilmoitus on teknisesti tai muodollisesti virheellinen, esimerkiksi tunnus puuttuu tai tulolajit eivät sovi yhteen. Jos ilmoitat väärän palkkasumman oikeassa muodossa, tulorekisteri hyväksyy sen, eikä mitään koodia tule. Sisällöllinen virhe korjataan korvaavalla ilmoituksella tai mitätöinnillä.
Korjauksen säännöt, kuten milloin korvaat ja milloin mitätöit ja kuinka pitkään korjata saa ilman seuraamusta, ovat artikkelissa tulorekisteri korjaus. Korvaavassa ilmoituksessa annetaan kaikki tiedot uudelleen, ei pelkkää muuttunutta riviä.
Milloin tulorekisteriin ilmoitetaan ja mitä tuloja siinä näkyy?
Palkkatiedot ilmoitetaan tulorekisteriin 5 kalenteripäivän kuluessa maksupäivästä. Tulorekisteri otettiin käyttöön palkkojen osalta 1.1.2019 ja etuuksien osalta 1.1.2021. Siinä näkyvät palkat, luontoisedut, verovapaat kustannusten korvaukset kuten päivärahat ja kilometrikorvaukset sekä Kelan ja työeläkelaitosten maksamat etuudet.
Tulonsaaja näkee omat tietonsa tulorekisterin asiointipalvelusta ja voi tilata niistä otteen, ks. tulorekisteri ote. Ilmoittamisen perusohje on artikkelissa tulorekisteri ilmoittaminen.
Usein kysytyt
Mistä löydän tulorekisterin virhekoodien selitykset?+
Verohallinnon tulorekisterin dokumentaatio-sivulta, jossa virhekoodiluettelo julkaistaan vuosittain Excel-tiedostona. Tällä sivulla on pienen työnantajan yleisimmät koodit suomeksi.
Mitä tarkoittaa virhekoodi IDV0040?+
Että henkilötunnusta tai Y-tunnusta ei tunnisteta. Tarkista tunnuksen numerot. Jos työntekijällä ei ole suomalaista henkilötunnusta, valitse tunnistetyypiksi muu tunniste.
Mitä tarkoittaa virhekoodi TRVA0010?+
Että samassa ilmoituksessa on käytetty sekä ilmoitustavan 1 tulolajeja (100-sarja) että ilmoitustavan 2 tulolajeja (200-sarja). Valitse yksi ilmoitustapa.
Mitä tapahtuu, jos tulorekisteri-ilmoitus hylätään?+
Hylättyä ilmoitusta ei tallenneta, joten palkka on ilmoittamatta. Korjaa virhe ja lähetä ilmoitus uudelleen ennen määräaikaa, muuten voit joutua maksamaan myöhästymismaksua.
Mitä tapahtuu, jos työnantaja ei ilmoita tulorekisteriin?+
Verohallinto voi määrätä myöhästymismaksun: 3 euroa päivältä maksupäivää seuraavan kuun 8. päivän jälkeen, enintään 135 euroa, ja yli 45 päivää myöhässä lisäksi 1 % palkasta. Puuttuvat tiedot näkyvät myös työntekijälle, Kelalle ja eläkelaitokselle.
Milloin ilmoitus tulorekisteriin pitää tehdä?+
5 kalenteripäivän kuluessa palkan maksupäivästä.
Milloin tulorekisteri alkoi?+
Palkkatiedot on ilmoitettu tulorekisteriin 1.1.2019 alkaen ja etuustiedot 1.1.2021 alkaen.
Tuleeko virheellisestä palkkasummasta virhekoodi?+
Ei. Virhekoodi tulee vain muodollisesta virheestä. Väärä summa oikeassa muodossa tallentuu, ja se korjataan korvaavalla ilmoituksella.
Kirjoittaa Taukon blogiin veroista, arvonlisäverosta ja palkoista: mitä yrittäjän pitää tehdä, milloin ja paljonko se maksaa.
Lue seuraavaksi
Tulorekisteri korjaus: korvaava ilmoitus vai mitätöinti, aikarajat ja virheet, jotka maksavat
Tulorekisteri-ilmoituksen korjaus tehdään yleensä korvaavalla ilmoituksella, jossa annat kaikki tiedot uudelleen oikeina samalle maksupäivälle, ja vain tietyissä virheissä mitätöimällä vanha ilmoitus ja antamalla uusi saman päivän aikana. Ajallaan annetun ilmoituksen korjaus on maksuton 45 päivän ajan. Tästä näet, kumpaa tapaa käytät, miten korjaus tehdään asiointipalvelussa ja mitkä virheet tulevat kalliiksi.
Tulorekisteri-ilmoitus myöhässä: myöhästymismaksu euroina ja mitä teet nyt
Kun tulorekisteri-ilmoitus on myöhässä, Verohallinto määrää myöhästymismaksun vasta, jos palkka ilmoitetaan maksupäivää seuraavan kuukauden 8. päivän jälkeen: maksu on 3 euroa päivältä, enintään 135 euroa, ja yli 45 päivää myöhässä siihen lisätään 1 prosentti myöhässä ilmoitetusta palkasta. Tästä näet maksun euroina, mitä teet heti, miten korjaus vaikuttaa maksuun ja milloin maksun voi saada poistettua.
Tulorekisteri ilmoittaminen: palkkailmoitus tulorekisteriin vaihe vaiheelta, tulolajit ja esimerkki
Palkkailmoitus tulorekisteriin eli palkkatietoilmoitus tehdään jokaisesta palkasta, palkkiosta, luontoisedusta ja matkakorvauksesta 5 kalenteripäivän kuluessa maksupäivästä, joko suoraan palkanlaskentaohjelmasta, tulorekisterin asiointipalvelun tallennuslomakkeella tai Palkka.fi-palvelusta. Tämä on käytännön täyttöohje: mikä ilmoituskanava sopii pienelle työnantajalle, mitä kuhunkin kohtaan kirjoitetaan, mitkä tulolajikoodit pieni yritys ja yhdistys tarvitsevat, täytetty esimerkki osakeyhtiön omistajan palkasta sekä mitä tuloja ei ilmoiteta lainkaan.