Dokumentaatio

• Julkaistu 25.11.2024
• Dokumentissa kuvataan
  • tulorekisterissä käytössä olevat palkkatietoilmoituksen tulolajit, tulolajien koodiarvot ja selitteet
  • ennakonpidätyksen toimittaminen ja sosiaalivakuutusmaksujen maksaminen jokaisesta tulolajista
  • tilanteet, joissa palkkatietoilmoituksen tulolajeja käytetään.

Vuoden 2025 dokumentti:

• Julkaistu dokumentista vuoden 2025 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2025 tai sen jälkeen
• Seuraavien tulolajien selitteitä on tarkennettu:
  • 201 Aikapalkka
  • 216 Muu maksettu lisä
  • 224 Työaikapankin rahakorvaus
  • 317 Muu luontoisetu
  • 328 Perhehoitajan palkkio
  • 336 Työkorvaus
  • 353 Veronalainen kustannusten korvaus

Vuoden 2026 dokumentti:

• Julkaistu Palkat – Koodistot – Tulolajit 2026 (xls), jossa yhdistetty seuraavien aiemmin voimassa olleiden dokumenttien tietosisältö:
  • Palkat – Tulolajien ja tuloista vähennettävien erien selitteet 2025
  • Palkat - Koodistot – Tulolajit 2024

• Julkaistu 8.10.2025
• Dokumentissa kuvataan palkkatietoilmoituksen tietosisältö ja mitä tietosisällön kussakin yksittäisessä kohdassa ilmoitetaan.

• Julkaistu 6.11.2025

Palkkatietoilmoituksen tietosisällön soveltamisohje 2027 (pdf)

• Julkaistu 6.11.2025

Vuoden 2025 dokumentti:

• Palkattoman poissaolon syykoodin arvo 9 "Vuorotteluvapaa" muutettu muotoon "Vuorotteluvapaa (ennen 1.4.2025)".

Vuoden 2026 dokumentti:

• 8.10.2025:
  • Julkaistu dokumentista vuoden 2026 tietosisältömuutokset ja muut Tulorekisteriyksikön päivitykset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2026 tai sen jälkeen.
  • Lisätty Tulonsaajan lisätiedot (IncomeEarnerType) kaksi uutta tulonsaajan lisätiedon tyyppiä:
    • Ulkomailla asuva vuokratyöntekijä ilma-aluksella
    • Ulkomailla asuva vuokratyöntekijä vesialuksella
  • Lisätty selitteet Tulonsaajan lisätiedoille Ulkomailla asuva vuokratyöntekijä ilma-aluksella ja Ulkomailla asuva vuokratyöntekijä vesialuksella, sekä päivitetty Tulonsaajan lisätiedon Ulkomailla asuva vuokratyöntekijä selitettä
  • Lisätty Palkaton poissaolo (UnpaidAbsence) ja Palkallinen poissaolo (PaidAbsence) uusi poissaolon syy ”Osittainen erityisraskausvapaa”
  • Lisätty Korvaushakemustiedot (ReimbApp) Maksutiedon tyyppi -kohtaan: Jos Kelan hakemustieto ilmoitetaan, Kela käsittelee ilmoituksen koodiarvojen mukaisesti työnantajan sairauspäivärahan, äitiys-, isyys- tai vanhempainrahan, erityisäitiysrahan, kuntoutusrahan, perhevapaakorvauksen, vuosilomakustannuskorvauksen tai osittaisen erityisraskausrahan hakemuksena.
• 6.11.2025:
  • Poistettu ”Osittainen erityisraskausraha” käsittelysäännöstä: Jos Kelan hakemustieto ilmoitetaan, Kela käsittelee ilmoituksen koodiarvojen mukaisesti työnantajan sairauspäivärahan, äitiys-, isyys- tai vanhempainrahan, erityisäitiysrahan, kuntoutusrahan, perhevapaakorvauksen, vuosilomakustannuskorvauksen tai osittaisen erityisraskausrahan hakemuksena.
  • Lisätty selite Auton päästöarvolle.

Vuoden 2027 dokumentti:

• 27.10.2025:
  • Julkaistu dokumentista vuoden 2027 tietosisältömuutokset ja muut Tulorekisteriyksikön päivitykset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2027 tai sen jälkeen.
  • Lisätty uusi tieto Oikaisuvaatimuksen viite tietoryhmään Palvelun tiedot (ReportData).
• 6.11.2025:
  • Lisätty selite Auton päästöarvolle.

Työnantajan erillisilmoituksen soveltamisohje 2022 (pdf)

• Julkaistu 27.12.2022
• Dokumentissa kuvataan työnantajan erillisilmoituksen tietosisältö ja mitä tietosisällön kussakin yksittäisessä kohdassa ilmoitetaan.

• Lisätty Johdanto ja Lukuohje.

• Palkkojen tietosisällön soveltamisohjeiden aiemmat versiot

• Julkaistu 8.10.2024
• Dokumentissa kuvataan
  • tulorekisteriin ilmoitettavat etuudet ja eläkkeet selitteineen ja koodiarvoineen
  • tilanteet, joissa etuustietoilmoituksen tulolajeja käytetään.

Vuoden 2025 dokumentti:

• Päivitetty seuraavien tulolajien selite: 1024 ja 1424.

Vuoden 2026 dokumentti:

• Julkaistu Etuudet – Koodistot – Tulolajit 2026 (xls), jossa yhdistetty seuraavien aiemmin voimassa olleiden dokumenttien tietosisältö:
  • Etuudet – Tulolajien ja tuloista vähennettävien erien selitteet 2025
  • Etuudet - Koodistot – Tulolajit 2025

Etuustietoilmoituksen tietosisällön soveltamisohje 2025 (pdf)

• Julkaistu 27.6.2025
• Dokumentissa kuvataan etuustietoilmoituksen tietosisältö ja mitä tietosisällön kussakin yksittäisessä kohdassa ilmoitetaan.

Etuustietoilmoituksen tietosisällön soveltamisohje 2027 (pdf)

• Julkaistu 27.10.2025

Vuoden 2025 dokumentti:

• Julkaistu dokumentista vuoden 2025 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksu-päivä on 1.1.2025 tai sen jälkeen.
• Muutettu koodistoon Sijaissaajan tyyppi (IncomeBeneficiaryType) arvon 2 selite "Kunta tai muu sosiaalihuollon toi-mielin" muotoon "Hyvinvointialue".

Vuoden 2027 dokumentti:

• Julkaistu dokumentista vuoden 2027 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksu-päivä on 1.1.2027 tai sen jälkeen.
  Lisätty uusi tieto Oikaisuvaatimuksen viite tietoryhmään Palvelun tiedot (ReportData).

• Etuuksien tietosisällön soveltamisohjeiden aiemmat versiot

Palkat – Koodistot – Tulolajit 2024 (xls)

Palkat – Koodistot – Tulolajit 2024 (pdf)

• Julkaistu 21.8.2023
• Koodisto sisältää
  • palkkatietoilmoituksen tulolajien ja tuloista vähennettävien erien koodit, ilmoitustavat ja tulolajeissa oletuksena olevat sosiaalivakuutusmaksut
  • työnantajan erillisilmoituksen tulolajien koodit.

Palkat – Koodistot – Tulolajit 2026 (xls)

• Julkaistu 13.10.2025
• Koodistossa kuvataan 
  • tulorekisterissä käytössä olevat palkkatietoilmoituksen tulolajit
  • tulolajien ja tuloista vähennettävien erien koodit, selitteet ja ilmoitustavat
  • ennakonpidätyksen toimittaminen ja sosiaalivakuutusmaksujen maksaminen jokaisesta tulolajista
  • tilanteet, joissa palkkatietoilmoituksen tulolajeja käytetään
  • työnantajan erillisilmoituksen tulolajien koodit.

Vuoden 2024 dokumentti:

• Muutettu dokumentin ulkoasua.

Vuoden 2026 dokumentti:

• 19.6.2025:
  • Julkaistu dokumentista uusi versio, jossa yhdistetty seuraavien aiemmin voimassa olleiden dokumenttien tietosisältö:
    • Palkat – Tulolajien ja tuloista vähennettävien erien selitteet 2025
    • Palkat - Koodistot – Tulolajit 2024
• 13.10.2025:
  • Tulolajin 366 Tekijänoikeuskorvaus ansiotuloa selitettä on tarkennettu.

Etuudet – Koodistot – Tulolajit 2025 (xls)

Etuudet – Koodistot – Tulolajit 2025 (pdf)

• Julkaistu 5.11.2024
• Koodisto sisältää etuustietoilmoituksen tulolajien ja tuloista vähennettävien erien koodit, ilmoitustavat ja lisätietojen pakollisuudet.

Etuudet – Koodistot – Tulolajit 2026 (xls)

• Julkaistu 8.10.2025
• Koodistossa kuvataan
  • tulorekisteriin ilmoitettavat etuudet ja eläkkeet
  • etuustietoilmoituksen tulolajien ja tuloista vähennettävien erien koodit, selitteet, ilmoitustavat ja lisätietojen pakollisuudet.
  • tilanteet, joissa etuustietoilmoituksen tulolajeja käytetään.

Vuoden 2025 dokumentti:

• Päivitetty tulolajin 1218 nimi.

Vuoden 2026 dokumentti:

• 27.5.2025:
  • Julkaistu dokumentista uusi versio, jossa yhdistetty seuraavien aiemmin voimassa olleiden dokumenttien tietosisältö:
    • Etuudet – Tulolajien ja tuloista vähennettävien erien selitteet 2025
    • Etuudet - Koodistot – Tulolajit 2025
  • Julkaistu dokumentista vuoden 2026 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2026 tai sen jälkeen.
  • Lisätty seuraavat uudet tulolajit: 1445
• 8.10.2025:
  • Päivitetty seuraavien tulolajien selite: 1024 ja 1424.
  • Lisätty uusi tulolaji 1446 (Osittainen erityisraskausraha).

Koodistot 2025 (xls)

Koodistot 2025 (pdf)

• Julkaistu 8.10.2025
• Koodisto sisältää tulorekisterin teknisessä rajapinnassa käytettävät koodistot.

Koodistot 2026 (xls)

• Julkaistu 8.10.2025

Koodistot 2027 (xls)

• Julkaistu 27.10.2025

Vuoden 2025 dokumentti:

• Lisätty koodistoon Aineiston tyyppi, tulorekisteristä jaettava (QueryDataType) seuraava arvo:
  • 320 Palkkatietoilmoituset - kaikki maksajat (xml)
• Lisätty koodistoon Aineiston skeeman versio QueryDataSchemaVersion) uusi arvo Palkkatietoilmoitukset – kaikki maksajat -jakelun skeema
• Lisätty koodistoon Sovellettava työehtosopimus (CBACode) uudet arvot:
  • 225 Ammatillisten aikuiskoulutuskeskusten hallinto- ja tukipalveluhenkilöstön työehtosopimus
  • 226 Ammatillisten aikuiskoulutuskeskusten opetushenkilöstön työehtosopimus
  • 227 Yksityisen opetusalan hallinto- ja tukipalveluhenkilöstön työehtosopimus
  • 228 Yksityisen opetusalan opetushenkilöstön työehtosopimus

Vuoden 2026 dokumentti:

• 28.5.2025:
  • Julkaistu dokumentista vuoden 2026 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2026 tai sen jälkeen.
  • Lisätty koodistoon Tulonsaajan lisätiedon tyyppi (IncomeEarnerType) seuraavat arvot:
    • 18 Ulkomailla asuva vuokratyöntekijä ilma-aluksella
    • 19 Ulkomailla asuva vuokratyöntekijä vesialuksella
  • Lisätty koodistoon Aineistotilauksen poimintaehdon tyyppi (ParameterType) uusi arvo 30 ”Aineiston omistajan aineistoviite”.
• 8.10.2025:
  • Lisätty koodistoon Aineiston skeeman versio QueryDataSchemaVersion) uusi arvo Palkkatietoilmoitukset – kaikki maksajat -jakelun skeema
  • Lisätty koodistoon Aineiston tyyppi, tulorekisteristä jaettava (QueryDataType) uusi arvo 320 "Palkkatietoilmoitukset - Kaikki maksajat (xml)"
  • Lisätty koodistoon palkallisen poissaolon syy (PaidAbsenceCauseCode) seuraava arvo:
    • 24 Osittainen erityisraskausvapaa
  • Lisätty koodistoon palkattoman poissaolon syy (UnpaidAbsenceCauseCode) seuraava arvo:
    • 18 Osittainen erityisraskausvapaa
  • Lisätty koodistoon Sovellettava työehtosopimus (CBACode) uudet arvot:
    • 225 Ammatillisten aikuiskoulutuskeskusten hallinto- ja tukipalveluhenkilöstön työehtosopimus
    • 226 Ammatillisten aikuiskoulutuskeskusten opetushenkilöstön työehtosopimus
    • 227 Yksityisen opetusalan hallinto- ja tukipalveluhenkilöstön työehtosopimus
    • 228 Yksityisen opetusalan opetushenkilöstön työehtosopimus
  • Poistettu koodistosta Sovellettava työehtosopimus (CBACode):
    • 4 Ammatillisten aikuiskoulutuskeskusten työehtosopimus
    • 187 Yksityisen opetusalan työehtosopimus
  • Korjattu ParameterTypen selite arvolla 30: Aineiston omistajan aineistoviite -> Työnantajan erillisilmoitusten poiminta

Vuoden 2027 dokumentti:

• Julkaistu dokumentista vuoden 2027 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2027 tai sen jälkeen.
• Lisätty aineiston skeeman versioihin seuraavat uudet skeemat:
  
  • Puuttuvien palkkatietoilmoitusten jakelun skeema
  • Puuttuvien etuustietoilmoitusten jakelun skeema
• Lisätty seuraavat uudet koodiarvot koodistoon 2.5 Aineiston tyyppi, tulorekisteristä jaettava (QueryDataType):
  
  • 321 Puuttuvat palkkatietoilmoitukset - kaikki tulonsaajat (xml)
  • 322 Puuttuvat palkkatietoilmoitukset - useita tulonsaajia (xml)
  • 323 Puuttuvat etuustietoilmoitukset - kaikki tulonsaajat (xml)
  • 324 Puuttuvat etuustietoilmoitukset - useita tulonsaajia (xml)
  • 410 Puuttuvat palkkatietoilmoitukset - yksi tulonsaaja (WS reaaliaikainen, xml)
  • 411 Puuttuvat etuustietoilmoitukset - yksi tulonsaaja (WS reaaliaikainen, xml)
• Lisätty seuraavat uudet koodiarvot koodistoon 2.7 Aineistotilauksen poimintaehdon tyypit (ParameterType):
  
  • 33 Vain ilmoitukset, joissa on kiistomerkintä
  • 34 Kiistettyjen ja ilmoitukselta puuttuvien tietojen näyttäminen
• Lisätty seuraavat uudet koodistot:
  
  • Puuttuvan tiedon tyyppi (MissingDataType)
  • Kiiston tila (DisputeStatus)
  • Vain kiistomerkittyjen ilmoitusten poiminta (OnlyReportsWithDispute)
  • Kiistettyjen ja ilmoitukselta puuttuvien

• Julkaistu 8.10.2025
• Koodisto sisältää teknisen rajapinnan virhekoodien selitteet.

Koodistot – Virhekoodit 2026 (xls)

• Julkaistu 6.11.2025

Koodistot – Virhekoodit 2027 (xls)

• Julkaistu 6.11.2025

Vuoden 2025 dokumentti:

• Muutettu virhekoodin BEV0540 tekstiä.

Vuoden 2026 dokumentti:

• 28.5.2025:
  • Julkaistu vuoden 2026 dokumentti.
    Lisätty seuraavat virhekoodit: AV0390, AV0400, AV0410, EV0180, EV0190, IDV0140, IDV0150, IDV0160, IDV0170, IDV0180, IEBV0090, IEOV0040, IEOV0050, TBVA0240, TBVA0241, TBVA0242, TBVA0243, TBVA0244.
    Päivitetty seuraavien virhekoodien selitteitä: EV0070, EV0110, EV0130, EV0140, TBVA0240, WPIDV0020.
• 13.8.2025:
  • Lisätty virhekoodi BEV0540.
  • Lisätty virhekoodi WPIDV0040.
  • Päivitetty virhekoodia WPIDV0020.
• 8.10.2025:
  • Lisätty seuraavat virhekoodit: AV0420.
  • Lisätty virhekoodi AV0430.
  • Muutettu virhekoodin BEV0540 tekstiä.
• 6.11.2025:
  • Poistettu virhekoodi AV0430.
  • Lisätty virhekoodi TRVA0440 ja muutettu TRVA0420:n selitettä.

Vuoden 2027 dokumentti:

• 27.10.2025:
  • Julkaistu vuoden 2027 dokumentti.
  • Lisätty seuraavat virhekoodit: RDV0100 ja RDV0110
• 6.11.2025:
  • Lisätty virhekoodi TRVA0440 ja muutettu TRVA0420:n selitettä

Tulorekisterin TK10-ammattiluokitus (stat.fi)

• Tulorekisterin oman ammattiluokituksen nimi on "Tulorekisterin TK10-ammattiluokitus", mutta tulorekisterin järjestelmissä siitä käytetään edelleen luokituksen vanhaa nimeä "Tilastokeskuksen ammattiluokitus (TK10)".
• Luokitus on julkaistu Tilastokeskuksen sivuilla.

• Koodistojen aiemmat versiot

Raportit tulorekisteristä 2025 (pdf)

• Julkaistu 8.10.2025
• Dokumentissa kuvataan tulorekisteristä tuotettavat raportit tiedon tuottajille, tiedon käyttäjille ja tulonsaajille.

Raportit ja aineistot tulorekisteristä 2026 (pdf)

• Julkaistu 8.10.2025
• Dokumentissa kuvataan
  • tulorekisteristä tuotettavat raportit ja aineistot tiedon tuottajille, tiedon käyttäjille ja tulonsaajille
  • aineistotilauksen perusteella jaettavien aineistojen poimintaehdot
  • miten tulorekisterin raporttien tiedot lasketaan.

Raportit ja aineistot tulorekisteristä 2027 (pdf)

• Julkaistu 27.10.2025

Vuoden 2025 dokumentti:

• Lisätty rajoitus raportille 701: Ilmoitusten lukumäärää ei lasketa aineistotyypille 320.

Vuoden 2026 dokumentti:

• 19.6.2025:
  • Julkaistu dokumentista uusi versio, jossa yhdistetty seuraavien aiemmin voimassa olleiden dokumenttien tietosisältö:
    • Raportit tulorekisteristä 2025
    • Tulotiedot - Laskentasääntöjä 2023
    • Tekninen rajapinta – tietojen jakelu tulorekisteristä 2025 (aineistojen sisältökuvaukset)
  • Dokumenttiin on tuotu vuoden 2026 vuosimuutoksia koskevat kokonaisuudet. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2026 tai sen jälkeen:
    • Kappale 4.10: Aineistoille 312 ja 313 Maksajan palkkatietojen yhteenveto on lisätty uusi tietoryhmä “Työnantajan erillisilmoitusten summatiedot”.
    • Kappale 9.2: Lisätty uusi laskentasääntö: ”Ei palkanmaksua” -ilmoitusten lukumäärä yhteensä (NoWages).
• 8.10.2025:
  • Korjattu lukuun Maksajan palkkatietojen yhteenveto (xml) Poimintaehtojen muutos myös kertatilaukselle (4.10.0.1)
  • Lisätty uusi luku 6.8 Palkkatietoilmoitukset – kaikki maksajat (xml).

Vuoden 2027 dokumentti:

• Julkaistu dokumentista vuoden 2027 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2027 tai sen jälkeen.
• Lisätty seuraavat uudet kappaleet:
  
  • 1.3 Tulorekisteristä jaettavat aineistot
  • 6.19 Puuttuvat palkkatietoilmoitukset - kaikki tulonsaajat (xml)
  • 6.20 Puuttuvat palkkatietoilmoitukset - useita tulonsaajia (xml)
  • 6.21 Puuttuvat etuustietoilmoitukset - kaikki tulonsaajat (xml)
  • 6.22 Puuttuvat etuustietoilmoitukset - useita tulonsaajia (xml)
  • 7.10 Puuttuvat palkkatietoilmoitukset - yksi tulonsaaja (xml)
  • 7.11 Puuttuvat etuustietoilmoitukset - yksi tulonsaaja (xml)
• Lisätty raporttien 700 ja 701 osalta Raportin tiedot -kohtaan maininta siitä, ettei Ilmoitusten lukumäärä -tietoa lasketa aineistotyypeille 321, 322, 323, 324, 410 ja 411.
• Lisätty raporttien 702 ja 710 osalta Raportin tiedot -kohtaan maininta siitä, miten tiedot näytetään, jos toimenpiteen kohde on Puuttuvan tiedon aikaväli.
• Lisätty uudet poimintaehdot 33 – Vain ilmoitukset, joissa on kiistomerkintä ja 34 – Kiistettyjen ja ilmoitukselta puuttuvien tietojen näyttäminen aineiston tyypeille 300–305 ja 314–319 sekä 400–402 ja 406–409.

Tulotiedot – Laskentasääntöjä 2023 (pdf)

• Julkaistu 11.9.2023
• Dokumentissa kuvataan, miten tulorekisterin raporttien tiedot lasketaan.

Vuoden 2023 dokumentti:

• Lisätty uusi laskentasääntö:
  • Sääntö 4.2.17 Perusteettomat viivästyskorotukset yhteensä (BenefitUnjustDelayIncreaseTotal).
• Tarkennettu kahta laskentasääntöä:
  • Sääntöön 4.2.11 Perusteettomat edut yhteensä (BenefitUnjustEnrichmentTotal) on lisätty tieto siitä, että summaan ei lasketa viivästyskorotusta, joka on perusteetonta etua.
  • Sääntöön 4.2.16 Viivästyskorotukset yhteensä (BenefitDelayIncreaseTotal) on lisätty tieto siitä, että summaan ei lasketa viivästyskorotusta, joka on perusteetonta etua.
• Tarkennettu kolmea laskentasääntöä:
  • Sääntö 4.2.2 Etuussuoritukset yhteensä (BenefitIncomeTotal) on lisätty tieto siitä, että Tulolajille ilmoitettua määrää ei lasketa mukaan summaan, jos tulolaji ei vaikuta verotukseen.
  • Sääntö 4.2.3 Nettosuorituksista tehdyt vähennykset yhteensä (BenefitNetDeductionTotal) on lisätty tieto siitä, että Tulolajiin liittyviä vähennyksiä ei huomioida, jos tulolaji ei vaikuta verotukseen.
  • Sääntö 4.2.4 Bruttosuorituksista tehdyt vähennykset yhteensä (BenefitGrossDeductionTotal) on lisätty tieto siitä, että Tulolajiin liittyviä vähennyksiä ei huomioida, jos tulolaji ei vaikuta verotukseen.

Vuoden 2026 dokumentti:

• Julkaistu Raportit ja aineistot tulorekisteristä 2026 (pdf), jossa yhdistetty seuraavien aiemmin voimassa olleiden dokumenttien tietosisältö:
  • Raportit tulorekisteristä 2025
  • Tulotiedot - Laskentasääntöjä 2023
  • Tekninen rajapinta – tietojen jakelu tulorekisteristä 2025 (aineistojen sisältökuvaukset)

• Raporttien sisältökuvausten aiemmat versiot

Tekninen rajapinta – Tietojen toimittaminen tulorekisteriin 2021 (pdf)

• Julkaistu 6.6.2022 
• Dokumentissa kuvataan 
  • tietojen toimittamista teknisen rajapinnan ja latauspalvelun kautta yleisellä tasolla
  • tulorekisterissä tietoa vastaanottavat palvelut ja lähetettävien aineistojen rakenne
  • tietojen toimittamiseen liittyvät suositukset.

Vuoden 2021 dokumentti:

• Tarkennettu luvussa 9.3.2 kuvausta aineistotilauksen mitätöinnistä ja lopettamisesta.

Vuoden 2026 dokumentti:

• Julkaistu Tekninen rajapinta – Tietojen toimittamisen ja tietojen jakelun soveltamisohje 2026 (pdf), jossa yhdistetty seuraavien aiemmin voimassa olleiden dokumenttien tietosisältö:
  • Tekninen rajapinta - Tietojen toimittaminen tulorekisteriin 2021
  • Tekninen rajapinta - Tietojen jakelu tulorekisteristä 2025
  • Tekninen rajapinta - Soveltamisohje 2024 

• Julkaistu 3.6.2024
• Dokumentissa kuvataan skeema WageReportsToIR, jolla palkkatietoilmoitukset toimitetaan tulorekisteriin.

Tietojen toimittaminen – Skeemat – Palkkatietoilmoitukset 2026 (pdf)

• Julkaistu 6.11.2025

Tietojen toimittaminen – Skeemat – Palkkatietoilmoitukset 2027 (pdf)

• Julkaistu 6.11.2025

Vuoden 2025 dokumentti:

• Julkaistu dokumentista vuoden 2025 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2025 tai sen jälkeen.
• Lisätty uusi käsittelysääntö tietoryhmän Takaisinmaksun lisätiedot (RecoveryData) elementtiin Alkuperäinen maksukausi (OrigPaymentPeriod):
  • Takaisinperittävän suorituksen tulolajin koodi oltava voimassa osittain tai kokonaan kaikkien alkuperäisten palkanmaksukausien tai maksupäivien aikana.
• Lisätty palkallinen poissaolo (PaidAbsence) -tietoryhmän elementin Maksutiedon tyyppi (PaymentType) käsittelysääntöön arvo: 2 (osa-aikainen sairauspoissaolo)
• Lisätty uusi käsittelysääntö tietoryhmän Tapaturmavakuutus (AccidentInsurance) elementtiin Tunnisteen tyyppi (Type):
  • Tunnisteen tyyppi ei saa olla ”suomalainen henkilötunnus” (2) tai ”ulkomainen henkilötunnus” (9).
• Lisätty seuraavien elementtien käsittelysääntöihin arvo "3 (Kela, vuosilomakustannuskorvaus)":
  • Aineiston yhteyshenkilöt (ContactPersons) -tietoryhmän Sähköpostiosoite (Email) sekä Vastuualue (ResponsibilityCode)
  • Maksajan tunnisteet (PayerIds) -tietoryhmän Tunnisteen tyyppi (Type)
  • Tulonsaajan tunnisteet (IncomeEarnerIds) -tietoryhmän Tunnisteen tyyppi (Type)
  • Palvelussuhdetiedot (Employment) -tietoryhmän Alkupäivä (StartDate), Palvelussuhteen voimassaolo (EmploymentPeriods), Palkkauksen muodot (PaymentTypes), Palkkauksen muoto (PaymentType) ja Palvelussuhteen tyyppi (EmploymentCode)
  • Palkallinen poissaolo (PaidAbsence) -tietoryhmän Loppupäivä (EndDate) ja Maksun tiedot (ReimbPayment).
• Lisätty uusi käsittelysääntö tietoryhmän Palkallinen poissaolo (PaidAbsence) elementtiin Maksutiedon tyyppi (PaymentType):
  • Jos maksutiedon tyyppi on 3 (Kela, vuosilomakustannuskorvaus) Palkallisen "Poissaolon syyn" tulee olla 23 (vuosilomakustannuskorvaus).

Vuoden 2026 dokumentti:

• 27.5.2025:
  • Julkaistu dokumentista vuoden 2026 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2026 tai sen jälkeen.
  • Lisätty tietoryhmien Palvelussuhteen voimassaolo (EmploymentPeriods) ja Palvelussuhteen päättyminen (EmploymentEndings) käsittelysääntöihin Työeläkelaitoksen yhtiötunnus 27.
  • Lisätty Palvelussuhteen päättyminen (EmploymentEndings) tietoryhmän Palvelussuhteen päättymisen syy (EmploymentEnding) -tietoon uusi käsittelysääntö ”Ilmoituksella ei saa antaa yhtäaikaisesti sekä "Kevan koodisto" -syykoodiston mukaista päättymisen syytä että "Suomen pankin koodisto" -syykoodiston mukaista päättymisen syytä.”
  • Lisätty Palvelussuhteen päättyminen (EmploymentEndings) tietoryhmän Palvelussuhteen päättymisen syykoodisto (Type) -tietoon uusi käsittelysääntö ”Jos "Työeläkelaitoksen yhtiötunnus" -tieto on 20, 24, 25, 29 tai 30, ja ilmoituksella on annettu ”Palvelussuhteen voimassaoloaika”, jossa on "Loppupäivä", on ilmoituksella oltava yksi "Kevan koodisto" -syykoodiston mukainen päättymisen syy.”
  • Lisätty Palvelussuhteen päättyminen (EmploymentEndings) tietoryhmän Palvelussuhteen päättymisen syykoodisto (Type) -tietoon uusi käsittelysääntö ”Jos "Työeläkelaitoksen yhtiötunnus" -tieto on 27, ja ilmoituksella on annettu ”Palvelussuhteen voimassaoloaika”, jossa on "Loppupäivä", on ilmoituksella oltava yksi "Suomen Pankin koodisto" -syykoodiston mukainen päättymisen syy.
  • Poistettu käsittelysääntö tiedosta Rekisteröinnin peruste (EmploymentReg) ”Tulonsaajalla voi olla useita rekisteröinnin perusteita, mutta vain yksi tietyn Rekisteröinnin perusteen tyyppi -tiedon mukainen arvo.” tietoryhmässä Palvelussuhteen rekisteröinti (EmploymentRegs).
  • Lisätty uusi käsittelysääntö tiedolle Rekisteröinnin peruste (EmploymentReg) ”Tulonsaajalla voi olla samalla palkkatietoilmoituksella vain yksi Rekisteröinnin peruste -tieto.” tietoryhmässä Palvelussuhteen rekisteröinti (EmploymentRegs).
  • Poistettu käsittelysääntö ”Jos "Tunnisteen tyyppi" on "Muu tunnus", tunniste ei saa olla suomalainen Y-tunnus tai henkilötunnus.” tunniste -tiedolta seuraavissa tietoryhmissä:
    • Maksajan tunnisteet (PayerIds)
    • Työnantajan tunniste (EmployerId)
    • Edustajan tunnisteet (RepresentativeIds)
    • Työn teettäjän tunnisteet (FinServiceRecipientIds)
    • Toimeksiantajan tunnisteet (ServiceRecipientIds)
    • Tulonsaajan tunnisteet (IncomeEarnerIds)
  • Lisätty uusi käsittelysääntö "Jos "Tunnisteen tyyppi" on muu kuin "Y-tunnus" tai "Suomalainen henkilötunnus", tunniste ei saa olla suomalainen henkilötunnus tai Y-tunnus." tunniste -tiedolle seuraavissa tietoryhmissä:
    • Aineiston omistaja (DeliveryDataOwner)
    • Maksajan tunnisteet (PayerIds)
    • Työnantajan tunniste (EmployerId)
    • Tulonsaajan tunnisteet (IncomeEarnerIds)
    • Työtapaturmavakuutusyhtiön tunniste (AccInsProvId)
    • Edustajan tunnisteet (RepresentativeIds)
    • Työn teettäjän tunnisteet (FinServiceRecipientIds)
    • Toimeksiantajan tunnisteet (ServiceRecipientIds)
  • Lisätty uusi käsittelysääntö "Maakoodia ”FI” ei saa antaa, jos annettu ”Tunnisteen tyyppi” on muu kuin "Y-tunnus", "Suomalainen henkilötunnus" tai "Muu tunnus." maakoodi -tiedolle seuraavissa tietoryhmissä:
    • Aineiston omistaja (DeliveryDataOwner)
    • Maksajan tunnisteet (PayerIds)
    • Työnantajan tunniste (EmployerId)
    • Tulonsaajan tunnisteet (IncomeEarnerIds)
    • Työtapaturmavakuutusyhtiön tunniste (AccInsProvId)
    • Edustajan tunnisteet (RepresentativeIds)
    • Työn teettäjän tunnisteet (FinServiceRecipientIds)
    • Toimeksiantajan tunnisteet (ServiceRecipientIds)
  • Palkan määrä palkalliselta poissaoloajalta (Amount)- tiedolta tietoryhmässä Palkallinen poissaolo (PaidAbsence):
    • Poistettu käsittelysääntö ”Tiedon tulee olla ei negatiivinen luku.”
    • Lisätty uusi käsittelysääntö ”Tiedon on oltava suurempi kuin 0.”
  • Lisätty Palkallinen poissaolo (PaidAbsence) tietoryhmän Maksun tarkenne (PaymentSpecifier) -tietoon uusi käsittelysääntö "Merkkimäärä ei voi olla yli 29 merkkiä".
  • Lisätty Palkallinen poissaolo (PaidAbsence) tietoryhmän Maksun viitenumero (PaymentRef) -tietoon uusi käsittelysääntö "Merkkimäärä ei voi olla yli 20 merkkiä".
  • Lisätty Tulolajin yleistiedot (TransactionBasic) -tietoryhmässä tiedolle Tulolajin koodi (TransactionCode) seuraava käsittelysääntö:
  • Jos "Tulolajin koodi" on 321-325, ilmoituksella ei saa antaa tulolajia vastaavaa "Vakuuttamisen poikkeustilanteen tyyppi" -tietoa:
    • Tulolajia 321 ja vakuuttamisen poikkeustilanteen tyyppi -tietoa Ei vakuuttamisvelvollisuutta (työeläke-, sairaus-, työttömyys- sekä työtapaturma- ja ammattitautivakuutus), Ei vakuuttamisvelvollisuutta (työeläkevakuutus), Ei vakuuttamisvelvollisuutta (työttömyysvakuutus), Ei vakuuttamisvelvollisuutta (työtapaturma- ja ammattitautivakuutus) tai Ei vakuuttamisvelvollisuutta (sairausvakuutus) ei voi ilmoittaa yhtäaikaisesti samalla ilmoituksella.
    • Tulolajia 322 ja vakuuttamisen poikkeustilanteen tyyppi -tietoa Ei vakuuttamisvelvollisuutta (työeläkevakuutus) ei voi ilmoittaa yhtäaikaisesti samalla ilmoituksella.
    • Tulolajia 323 ja vakuuttamisen poikkeustilanteen tyyppi -tietoa Ei vakuuttamisvelvollisuutta (työttömyysvakuutus) ei voi ilmoittaa yhtäaikaisesti samalla ilmoituksella.
    • Tulolajia 324 ja vakuuttamisen poikkeustilanteen tyyppi -tietoa Ei vakuuttamisvelvollisuutta (työtapaturma- ja ammattitautivakuutus) ei voi ilmoittaa yhtäaikaisesti samalla ilmoituksella.
    • Tulolajia 325 ja vakuuttamisen poikkeustilanteen tyyppi -tietoa Ei vakuuttamisvelvollisuutta (sairausvakuutus) ei voi ilmoittaa yhtäaikaisesti samalla ilmoituksella.
  • Lisätty Maksajan tunnisteet (PayerIds), Tulonsaajan tunnisteet (IncomeEarnerIds), Edustajan tunnisteet (RepresentativeIds), Suomalaisen työn teettäjän tunnisteet (FinServiceRecipientIds) ja Toimeksiantajan tunnisteet (ServiceRecipientIds) -tietoryhmiin käsittelysääntö:
    
    • Jos tietoryhmässä ilmoitetaan useita tunnisteita, tulee tunnisteiden tyyppien olla eri. Sama tunnisteen tyyppi sallitaan vain, jos niiden maakoodit ovat eri. Suomalaisten tunnisteiden osalta (Y-tunnus/suomalainen henkilötunnus) sallitaan vain yksi per tunnisteen tyyppi.
    • Poistettu Tulonsaajan tunnisteet (IncomeEarnerIds) -tietoryhmän käsittelysäännöstä ”Jos tulonsaajalle on annettu useita suomalaisia henkilötunnuksia, tunnusten perusteella päätellyn syntymäajan tulee olla sama kaikilla tunnuksilla.”
  • Lisätty käsittelysääntö “Jos ‘tunnisteen tyyppi’ on ‘suomalainen henkilötunnus’ tai ‘Y-tunnus’, ‘Maakoodi’ voi olla vain ‘FI’” seuraaviin tietoryhmiin:
    • Aineiston omistaja (DeliveryDataOwner)
    • Aineiston lähettäjä (DeliveryDataSender)
    • Aineiston muodostaja (DeliveryDataCreator)
    • Maksajan tunnisteet (PayerIds)
    • Työnantajan tunniste (EmployerId)
    • Tulonsaajan tunnisteet (IncomeEarnerIds)
    • Työtapaturmavakuutusyhtiön tunniste (AccInsProvId)
    • Edustajan tunnisteet (RepresentativeIds)
    • Työn teettäjän tunnisteet (FinServiceRecipientIds)
    • Toimeksiantajan tunnisteet (ServiceRecipientIds)
  • Lisätty Tulonsaajan lisätiedon tyyppi (IncomeEarnerType) käsittelysäännöt (MP829): Samalla palkkatietoilmoituksella voi olla vain yksi seuraavista "Tulonsaajan lisätiedon tyyppi" arvoista:
    • Ulkomailla asuva vuokratyöntekijä
    • Ulkomailla asuva vuokratyöntekijä ilma-aluksella
    • Ulkomailla asuva vuokratyöntekijä vesialuksella
    • Tulonsaaja on oleskellut Suomessa enintään 183 päivää verosopimuksessa tarkoitettuna ajanjaksona
  • Pakollinen tietoryhmä, jos ilmoituksella on annettu ulkomaan työskentelyn lomake, jossa ”Lomaketyyppi” on ”Vuokratyöntekijän aloittamisilmoitus”. Tällöin on annettava yksi seuraavista "Tulonsaajan lisätiedon tyyppi" arvoista:
    • Ulkomailla asuva vuokratyöntekijä
    • Ulkomailla asuva vuokratyöntekijä ilma-aluksella
    • Ulkomailla asuva vuokratyöntekijä vesialuksella
  • Lisätty Työskentelyajat Suomessa (WorkPeriodsInFinland) käsittelysääntöön kohta ”Ulkomailla asuva vuokratyöntekijä ilma-aluksella” tai ”Ulkomailla asuva vuokratyöntekijä vesialuksella”
  • Lisätty uusi käsittelysääntö ”Tieto ei saa alkaa tai päättyä tulostumattomaan white space -merkkiin, eikä tieto saa sisältää tulostumattomia white space -merkkejä, pois lukien välilyönti. Kielletyt merkit on lueteltu luvussa 1.2 Merkistö.” tunniste- tiedolle seuraavissa tietoryhmissä:
    • Aineiston omistaja (DeliveryDataOwner)
    • Maksajan tunnisteet (PayerIds)
    • Työnantajan tunniste (EmployerId)
    • Tulonsaajan tunnisteet (IncomeEarnerIds)
    • Työtapaturmavakuutusyhtiön tunniste (AccInsProvId)
    • Edustajan tunnisteet (RepresentativeIds)
    • Työn teettäjän tunnisteet (FinServiceRecipientIds)
    • Toimeksiantajan tunnisteet (ServiceRecipientIds)
• 7.7.2025:
  • Päivitetty white space merkistön selitystä: merkistö koskettaa työtapaturmavakuutusten vakuutusnumeroiden lisäksi myös tunnisteita.
• 8.10.2025:
  • Lisätty Palkkauksen muoto –tiedolle (PaymentType) uusi arvo: 3 (Urakkapalkka)
  • Lisätty tietoryhmän Palkallinen poissaolo (PaidAbsence), Maksutiedon tyyppi (PaymentType) -elementin olemassa olevaan käsittelysääntöön uusi koodiarvo 24: Jos “Maksutiedon tyyppi” = 1 (Kela, päivärahahakemus), Palkallisen “Poissaolon syy” saa olla vain jokin seuraavista: 1 (sairaus), 2 (osa-aikainen sairauspoissaolo), 3 (vanhempainvapaa), 4 (erityisraskausvapaa), 5 (kuntoutus) tai 24 (osittainen erityisraskausvapaa).
• 6.11.2025:
  • Muutettu Autoetu -tietoryhmän Auton päästöarvon käsittelysääntö sisältämään myös vuodet 2026-2029.
  • Poistettu tietoryhmästä Palkallinen poissaolo (PaidAbsence), Maksutiedon tyyppi (PaymentType) -elementin käsittelysäännöstä koodiarvo 24: Jos "Maksutiedon tyyppi" = 1 (Kela, päivärahahakemus), Palkallisen "Poissaolon syy" saa olla vain jokin seuraavista: 1 (sairaus), 2 (osa-aikainen sairauspoissaolo) ,3 (vanhempainvapaa), 4 (erityisraskausvapaa) tai 5 (kuntoutus).

Vuoden 2027 dokumentti:

• 27.10.2025:
  • Julkaistu dokumentista vuoden 2027 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2027 tai sen jälkeen.
  • Lisätty Palvelun tiedot (ReportData) tietoryhmään uusi vapaaehtoinen Oikaisuvaatimuksen viitetiedot (DemandForRectificationIds) tietoryhmä.
• 6.11.2025:
  • Muutettu Autoetu -tietoryhmän Auton päästöarvon käsittelysääntö sisältämään myös vuodet 2026-2029.

• Julkaistu 3.6.2024
• Dokumentissa kuvataan skeema PayerSummaryReportsToIR, jolla työnantajan erillisilmoitukset toimitetaan tulorekisteriin.

Tietojen toimittaminen – Skeemat – Työnantajan erillisilmoitukset 2026 (pdf)

• Julkaistu 4.7.2025

Vuoden 2025 dokumentti:

• Julkaistu dokumentista vuoden 2025 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2025 tai sen jälkeen.
• Lisätty uusi käsittelysääntö tietoryhmän Tapaturmavakuutus (AccidentInsurances) elementtiin Tunnisteen tyyppi (Type):
  • Tunnisteen tyyppi ei saa olla ”suomalainen henkilötunnus” (2) tai ”ulkomainen henkilötunnus” (9).

Vuoden 2026 dokumentti:

• 27.5.2025:
  • Julkaistu dokumentista vuoden 2026 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2026 tai sen jälkeen.
  • Poistettu käsittelysääntö ”Jos "Tunnisteen tyyppi" on "Muu tunnus", tunniste ei saa olla suomalainen Y-tunnus tai henkilötunnus.” tunniste -tiedolta seuraavissa tietoryhmissä:
    
    • Maksajan tunnisteet (PayerIds)
  • Lisätty uusi käsittelysääntö "Jos "Tunnisteen tyyppi" on muu kuin "Y-tunnus" tai "Suomalainen henkilötunnus", tunniste ei saa olla suomalainen henkilötunnus tai Y-tunnus." tunniste -tiedolle seuraavissa tietoryhmissä:
    
    • Aineiston omistaja (DeliveryDataOwner)
    • Maksajan tunnisteet (PayerIds)
    • Työtapaturmavakuutusyhtiön tunniste (AccInsProvId)
  • Lisätty uusi käsittelysääntö "Maakoodia ”FI” ei saa antaa, jos annettu ”Tunnisteen tyyppi” on muu kuin "Y-tunnus", "Suomalainen henkilötunnus" tai "Muu tunnus" maakoodi -tiedolle seuraavissa tietoryhmissä:
    • Aineiston omistaja (DeliveryDataOwner)
    • Maksajan tunnisteet (PayerIds)
    • Työtapaturmavakuutusyhtiön tunniste (AccInsProvId)
  • Lisätty Maksajan tunnisteet (PayerIds) -tietoryhmään käsittelysääntö:
    • Jos tietoryhmässä ilmoitetaan useita tunnisteita, tulee tunnisteiden tyyppien olla eri. Sama tunnisteen tyyppi sallitaan vain, jos niiden maakoodit ovat eri. Suomalaisten tunnisteiden osalta (Y-tunnus/suomalainen henkilötunnus) sallitaan vain yksi per tunnisteen tyyppi.
  • Lisätty käsittelysääntö ‘Jos "Tunnisteen tyyppi" on "Suomalainen henkilötunnus" tai "Y-tunnus", "Maakoodi" voi olla vain "FI"’ seuraaviin tietoryhmiin:
    • Aineiston omistaja (DeliveryDataOwner)
    • Aineiston lähettäjä (DeliveryDataSender)
    • Aineiston muodostaja (DeliveryDataCreator)
    • Maksajan tunnisteet (PayerIds)
    • Työtapaturmavakuutusyhtiön tunniste (AccInsProvId)
  • Lisätty uusi käsittelysääntö ”Tieto ei saa alkaa tai päättyä tulostumattomaan white space -merkkiin, eikä tieto saa sisältää tulostumattomia white space -merkkejä, pois lukien välilyönti.” tunniste- tiedolle seuraavissa tietoryhmissä:
    • Aineiston omistaja (DeliveryDataOwner)
    • Maksajan tunnisteet (PayerIds)
    • Työtapaturmavakuutusyhtiön tunniste (AccInsProvId)
• 4.7.2025:
  • (MP846) Lisätty white space merkistö (1.2)

• Julkaistu 8.10.2025
• Dokumentissa kuvataan skeema BenefitReportsToIR, jolla etuustietoilmoitukset toimitetaan tulorekisteriin.

Tietojen toimittaminen - Skeemat – Etuustietoilmoitukset 2026 (pdf)

• Julkaistu 8.10.2025

Tietojen toimittaminen - Skeemat – Etuustietoilmoitukset 2027 (pdf)

• Julkaistu 27.10.2025

Vuoden 2025 dokumentti:

• Tarkennettu edellistä sääntöä siten, että vähennyksen tulolajin koodin on oltava voimassa osittain tai kokonaan etuuden alkuperäisen ansaintakauden aikana tai suorituksen maksupäivän (DeliveryData) aikana.

Vuoden 2026 dokumentti:

• 4.7.2025:
  • Julkaistu dokumentista vuoden 2026 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2026 tai sen jälkeen
  • Lisätty uusi käsittelysääntö "Jos "Tunnisteen tyyppi" on muu kuin "Y-tunnus" tai "Suomalainen henkilötunnus", tunniste ei saa olla suomalainen henkilötunnus tai Y-tunnus." tunniste -tiedolle seuraavissa tietoryhmissä:
    • Aineiston omistaja (DeliveryDataOwner)
    • Maksajan tunnisteet (PayerIds)
    • Tulonsaajan tunnisteet (IncomeEarnerIds)
    • Vakuutuksenottajan tunnisteet (InsurancePolicyHolderIds)
    • Sijaissaajan tunnisteet (IncomeBeneficiaryIds)
  • Lisätty uusi käsittelysääntö "Maakoodia ”FI” ei saa antaa, jos annettu ”Tunnisteen tyyppi” on muu kuin "Y-tunnus", "Suomalainen henkilötunnus" tai "Muu tunnus" maakoodi -tiedolle seuraavissa tietoryhmissä:
    • Aineiston omistaja (DeliveryDataOwner)
    • Maksajan tunnisteet (PayerIds)
    • Tulonsaajan tunnisteet (IncomeEarnerIds)
    • Vakuutuksenottajan tunnisteet (InsurancePolicyHolderIds)
    • Sijaissaajan tunnisteet (IncomeBeneficiaryIds)
  • Lisätty Maksajan tunnisteet (PayerIds), Tulonsaajan tunnisteet (IncomeEarnerIds), Sijaissaajan tunnisteet (IncomeBeneficiaryIds), ja Vakuutuksenottajan tunnisteet (InsurancePolicyHolderIds) -tietoryhmiin käsittelysääntö:
    • Jos tietoryhmässä ilmoitetaan useita tunnisteita, tulee tunnisteiden tyyppien olla eri. Sama tunnisteen tyyppi sallitaan vain, jos niiden maakoodit ovat eri. Suomalaisten tunnisteiden osalta (Y-tunnus/suomalainen henkilötunnus) sallitaan vain yksi per tunnisteen tyyppi.
    • Poistettu Tulonsaajan tunnisteet (IncomeEarnerIds), Sijaissaajan tunnisteet (IncomeBeneficiaryIds) ja Vakuutuksenottajan tunnisteet (InsurancePolicyHolderIds) -tietoryhmien käsittelysäännöistä ”Jos tulonsaajalle/sijaissaajalle/vakuutuksenottajalle on annettu useita suomalaisia henkilötunnuksia, tunnusten perusteella päätellyn syntymäajan tulee olla sama kaikilla tunnuksilla.”
  • Lisätty käsittelysääntö ‘Jos "Tunnisteen tyyppi" on "Suomalainen henkilötunnus" tai "Y-tunnus", "Maakoodi" voi olla vain "FI"’ seuraaviin tietoryhmiin:
    • Aineiston omistaja (DeliveryDataOwner)
    • Aineiston lähettäjä (DeliveryDataSender)
    • Aineiston muodostaja (DeliveryDataCreator)
    • Maksajan tunnisteet (PayerIds)
    • Tulonsaajan tunnisteet (IncomeEarnerIds)
    • Vakuutuksenottajan tunnisteet (InsurancePolicyHolderIds)
    • Sijaissaajan tunnisteet (IncomeBeneficiaryIds)
  • Lisätty uusi käsittelysääntö ”Tieto ei saa alkaa tai päättyä tulostumattomaan white space -merkkiin, eikä tieto saa sisältää tulostumattomia white space -merkkejä, pois lukien välilyönti.” tunniste- tiedolle seuraavissa tietoryhmissä:
    • Aineiston omistaja (DeliveryDataOwner)
    • Maksajan tunnisteet (PayerIds)
    • Tulonsaajan tunnisteet (IncomeEarnerIds)
    • Vakuutuksenottajan tunnisteet (InsurancePolicyHolderIds)
    • Sijaissaajan tunnisteet (IncomeBeneficiaryIds)
  • Lisätty uusi käsittelysääntö "Jos tulonsaajalle/vakuutuksenottajalle/sijaissaajalle on annettu sekä Y-tunnus että suomalainen henkilötunnus, tunnusten tulee kohdistua samaan asiakkaaseen." seuraavissa tietoryhmissä:
    • Tulonsaajan tunnisteet (IncomeEarnerIds)
    • Vakuutuksenottajan tunnisteet (InsurancePolicyHolderIds)
    • Sijaissaajan tunnisteet (IncomeBeneficiaryIds)
  • Lisätty white space -merkistö (1.2)
• 13.8.2025:
  • Lisätty uusi käsittelysääntö tietoryhmän Vähennykset (Deductions) elementtiin Vähennyksen tulolajin koodi (DeductionTransactionCode ) ja alkuperäisen etuuden ansaintakaudelle (OrigBenefitEarningPeriod):
    • Vähennyksen tulolajin koodin on oltava voimassa osittain tai kokonaan etuuden alkuperäisen ansaintakauden tai suorituksen maksupäivän aikana.
  • Lisätty uusi käsittelysääntö tietoryhmän Vähennykset (Deductions) elementtiin Alkuperäisen etuuden ansaintakausi (OrigBenefitEarningPeriod):
    • Vähennyksen tulolajin koodin on oltava voimassa osittain tai kokonaan etuuden alkuperäisen ansaintakauden tai suorituksen maksupäivän aikana.
• 8.10.2025:
  • Tarkennettu edellistä sääntöä siten, että vähennyksen tulolajin koodin on oltava voimassa osittain tai kokonaan etuuden alkuperäisen ansaintakauden aikana tai suorituksen maksupäivän (DeliveryData) aikana.

Vuoden 2027 dokumentti:

• Julkaistu dokumentista vuoden 2027 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2027 tai sen jälkeen.
• Lisätty Palvelun tiedot (ReportData) tietoryhmään uusi vapaaehtoinen Oikaisuvaatimuksen viitetiedot (DemandForRectificationIds) tietoryhmä.

Tietojen toimittaminen – Skeemat – Aineistotilaukset 2025 (pdf)

• Julkaistu 24.11.2025 
• Dokumentissa kuvataan skeema SubscriptionsToIR, jolla aineistotilaukset toimitetaan tulorekisteriin.

• Julkaistu vuoden 2025 tietosisältömuutokset sisältävä versio.
  
  • Lisätty Aineiston omistajan (DeliveryDataOwner) käsittelysääntöön; Organisaatiolla on oltava asiakastunniste. Jos aineiston muodostajan tunnus eroaa aineiston omistajan tunnisteesta, aineiston poiminnassa käytetään aineiston muodostajan tiedonsaantioikeuksia.

• Julkaistu 8.1.2025
• Dokumentissa kuvataan skeema InvalidationsToIR, jolla tulorekisteristä mitätöidään tulotietoilmoituksia, aineistotilauksia ja aineistoja.

Tietojen toimittaminen – Skeemat – Mitätöintitiedot 2026 (pdf)

• Julkaistu 4.7.2025

Vuoden 2025 dokumentti:

• Julkaistu dokumentista vuoden 2025 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2025 tai sen jälkeen.Täydennetty tietoryhmässä Mitätöitävät kohteet (Items) kohdan mitätöitävä kohde osion Aineistotilauksen mitätöiminen tai lopettaminen kuvausta.

Vuoden 2026 dokumentti:

• 28.5.2025:
  • Julkaistu dokumentista vuoden 2026 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2026 tai sen jälkeen.
  • Lisätty tietoryhmään Aineiston tiedot (DeliveryData) uusi käsittelysääntö ”Tieto ei saa alkaa tai päättyä tulostumattomaan white space -merkkiin, eikä tieto saa sisältää tulostumattomia white space -merkkejä, pois lukien välilyönti.”
• 4.7.2025:
  • Lisätty white space -merkistö (1.2)

Tietojen toimittaminen – Skeemat – Vastaanottokuittaus 2024 (pdf)

• Julkaistu 3.6.2024
• Dokumentissa kuvataan skeema AckFromIR, jolla tulorekisteri lähettää vastaanottokuittauksen tulorekisteriin toimitetusta aineistosta.
• Skeemaa käytetään viivästetyssä Web Service -rajapinnassa.

• Korjattu elementti Aineiston omistajan aineistoviite (DeliveryId) vapaaehtoiseksi (V) tietoryhmässä Vastaanotetun aineiston tiedot (DeliveryData).

Tietojen toimittaminen – Skeemat – Käsittelypalautteen kysely 2021 (pdf)

• Julkaistu 6.6.2022
• Dokumentissa kuvataan skeema StatusRequestToIR, jolla aineiston lähettäjä voi kysyä käsittelypalautetta tulorekisteriin lähettämästään aineistosta.
• Skeemaa käytetään viivästetyssä Web Service -rajapinnassa.

• Korjattu Tyyppi-tieto tietoryhmissä Aineiston omistaja (DeliveryDataOwner), Aineiston muodostaja (DeliveryDataCreator) ja Aineiston lähettäjä (DeliveryDataSender): Tyyppi "mtirt:Id" on muutettu tiedoksi "smt:Id". Korjaus ei vaikuta toteutukseen.

Tietojen toimittaminen – Skeemat – Käsittelypalaute 2024 (pdf)

• Julkaistu 3.6.2024
• Dokumentissa kuvataan skeema StatusResponseFromIR, jolla tulorekisteri lähettää käsittelypalautteen tulorekisteriin toimitetusta aineistosta.

• Korjattu elementti Aineiston omistajan aineistoviite (DeliveryId) vapaaehtoiseksi (V) tietoryhmässä Vastaanotetun aineiston tiedot (DeliveryData).

• Tietojen toimittamisen sisältökuvausten aiemmat versiot

Tekninen rajapinta – Tietojen jakelu tulorekisteristä 2025 (pdf)

• Julkaistu 8.10.2025
• Dokumentissa kuvataan
  • tietojen jakelua tulorekisteristä teknisen rajapinnan kautta yleisellä tasolla
  • tulorekisteristä tietoa jakavat palvelut ja jaettavien aineistojen rakenne
  • aineistotilauksen perusteella jaettavien aineistojen poimintaehdot
  • jakeluun liittyvät suositukset
  • suorituksen maksajille tarkoitettu aineisto Maksajan palkkatietojen yhteenveto (312/313).

Vuoden 2025 dokumentti:

• Lisätty johdannon taulukkoon aineisto 320 – kaikki maksajat (xml)
• Lisätty kokonaan uusi luku 6.8 Palkkatietoilmoitukset – kaikki maksajat (xml)

Vuoden 2026 dokumentti:

• Julkaistu Tekninen rajapinta – Tietojen toimittamisen ja tietojen jakelun soveltamisohje 2026 (pdf), jossa yhdistetty seuraavien aiemmin voimassa olleiden dokumenttien tietosisältö:
  • Tekninen rajapinta - Tietojen toimittaminen tulorekisteriin 2021
  • Tekninen rajapinta - Tietojen jakelu tulorekisteristä 2025
  • Tekninen rajapinta - Soveltamisohje 2024

Tietojen jakelu – Skeemat – Palkkatietoilmoitukset 2024 (pdf)

• Julkaistu 23.1.2024
• Dokumentissa kuvataan skeema WageReportsFromIR, jolla palkkatietoilmoitukset jaetaan tulorekisteristä.

Tietojen jakelu – Skeemat – Palkkatietoilmoitukset 2027 (pdf)

• Julkaistu 27.10.2025

Vuoden 2024 dokumentti:

• Korjattu termi Suomalainen työnteettäjä (FinServiceRecipient) muotoon Suomalainen työn teettäjä.

Vuoden 2027 dokumentti:

• Julkaistu dokumentista vuoden 2027 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2027 tai sen jälkeen.
• Lisätty useisiin eri tietoryhmiin niiden sisältämille tietoelementeille uusi tietoelementti, joka kertoo, onko kyseinen tieto kiistetty rekisteröidyn toimesta.
• Lisätty kohtaan 2.17 Palvelun tiedot (ReportData) seuraavat uudet tietoryhmät:
  
  • Oikaisuvaatimuksen viitetiedot (DemandForRectificationIds)
  • Ilmoitukseen kohdistuvat kiistot (ReportDisputes).
• Lisätty uusi tietoryhmä 2.60 Ilmoituksen puuttuvat tiedot (MissingData).

Tietojen jakelu – Skeemat – Työnantajan erillisilmoitukset 2024 (pdf)

• Julkaistu 11.9.2023
• Dokumentissa kuvataan skeema PayerSummaryReportsFromIR, jolla työnantajan erillisilmoitukset jaetaan tulorekisteristä.

• Lisätty uusi käsittelysääntö tietoryhmän Maksajan tunnisteet (PayerIds) elementtiin Maksajan tunniste (Id): Maksajan tunnisteita voi ilmoittaa enimmillään kolme tunnistetta.

Tietojen jakelu – Skeemat – Etuustietoilmoitukset 2024 (pdf)

• Julkaistu 11.9.2023
• Dokumentissa kuvataan skeema BenefitReportsFromIR, jolla etuustietoilmoitukset jaetaan tulorekisteristä.

Tietojen jakelu - Skeemat – Etuustietoilmoitukset 2027 (pdf)

• Julkaistu 27.10.2025

Vuoden 2024 dokumetti:

• Lisätty uusi käsittelysääntö tietoryhmän Maksajan tunnisteet (PayerIds) elementtiin Maksajan tunniste (Id): Maksajan tunnisteita voi ilmoittaa enimmillään kolme tunnistetta.

Vuoden 2027 dokumetti:

• Julkaistu dokumentista vuoden 2027 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2027 tai sen jälkeen.
• Lisätty useisiin eri tietoryhmiin niiden sisältämille tietoelementeille uusi tietoelementti, joka kertoo, onko kyseinen tieto kiistetty rekisteröidyn toimesta.
• Lisätty kohtaan 2.14 Palvelun tiedot (ReportData) seuraavat uudet tietoryhmät:
  
  • Oikaisuvaatimuksen viitetiedot (DemandForRectificationIds)
  • Ilmoitukseen kohdistuvat kiistot (ReportDisputes).
• Lisätty uusi tietoryhmä 2.38 Ilmoituksen puuttuvat tiedot (MissingData).

Tietojen jakelu – Skeemat – Palvelupyyntö 2021 (pdf)

• Julkaistu 1.6.2020
• Dokumentissa kuvataan skeema DataRequestToIR, jolla tulorekisterin tiedon käyttäjä tekee palvelupyynnön eli kyselee tietoja tulorekisteristä.
• Skeemaa käytetään reaaliaikaisessa Web Service -rajapinnassa.

• Dokumentin sisältö vastaa vuoden 2020 dokumenttia.

Tietojen jakelu – Skeemat – Lokitiedot 2025 (pdf)

• Julkaistu 8.1.2025
• Dokumentissa kuvataan skeema LogDataFromIR, jolla lokitiedot jaetaan tulorekisteristä.

Tietojen jakelu – Skeemat – Lokitiedot 2027 (pdf)

• Julkaistu 27.10.2025

Vuoden 2025 dokumentti:

• Julkaistu vuoden 2025 versio dokumentista.
• Lisätty tietoryhmään Lokitapahtumat (LogEvents) tiedot:
  • Käyttäjän nimi
  • Tiedon käyttäjän rooli.

Vuoden 2027 dokumentti:

• Julkaistu vuoden 2027 versio dokumentista.
• Lisätty kohtaan 2.5 Lokitapahtuman kohteet uusi tietoryhmä Puuttuvan tiedon aikaväli (MissingDataPeriodTargetItem).

Tietojen jakelu – Skeemat – Maksajan palkkatietojen yhteenveto 2021 (pdf)

• Julkaistu 6.6.2022
• Dokumentissa kuvataan skeema WageReportSummaryFromIR, jolla aineisto Maksajan palkkatietojen yhteenveto (312/313) jaetaan tulorekisteristä.
• Aineisto on tarkoitettu suorituksen maksajille.

Tietojen jakelu – Skeemat – Maksajan palkkatietojen yhteenveto 2026 (pdf)

• Julkaistu 27.5.2025

Vuoden 2021 dokumentti:

• Kappaleessa 2 Maksajan palkkatietojen yhteenveto (WageReportSummaryFromIR) kuvattuun aineiston yleisrakenteeseen on lisätty puuttuneet tietoryhmien Tyyppi-tiedot. Korjaus ei vaikuta toteutukseen.

Vuoden 2026 dokumentti:

• Julkaistu dokumentista vuoden 2026 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2026 tai sen jälkeen.
• Muutokset dokumenttiin:
  • Lisätty aineistolle uusi tietoryhmä: Työnantajan erillisilmoitusten summatiedot kohdekausittain (PayerSummaryReportPaymentMonthsSummary)

Tietojen jakelu – Skeemat – Hylätyt paperilomakkeella annetut ilmoitukset 2024 (pdf)

• Julkaistu 11.9.2023
• Dokumentissa kuvataan skeema RejectedPaperReportsFromIR, jolla aineisto Hylätyt paperilomakkeella annetut ilmoitukset (950) jaetaan tulorekisteristä.
• Aineisto sisältää hylätyt paperilomakkeella annetut palkkatietoilmoitukset ja työnantajan erillisilmoitukset.

• Lisätty uusi käsittelysääntö tietoryhmän Maksajan tunnisteet (PayerIds) elementtiin Maksajan tunniste (Id): Maksajalla voi olla enimmillään kolme tunnistetta.

Tietojen jakelu – Skeemat – Kaikki maksajat 2025 (pdf)

• Julkaistu 8.10.2025
• Dokumentissa kuvataan skeema WageReportPayersFromIR, jolla toimitetaan yhteenveto tulorekisteriin maksupäivän aikavälillä ilmoituksia toimittaneiden maksajan, sijaismaksajan ja varsinaisen työnantajan tunnisteista.

• Julkaistu vuoden 2025 versio.
• Luotu uusi skeema.
• Lisätty Maksajan tiedot (Payer) tietoryhmät Maksajan perustiedot (PayerBasic) ja Sijaismaksaja (SubstitutePayer).

Tietojen jakelu – Skeemat – Puuttuvat palkkatietoilmoitukset 2027 (pdf)

• Julkaistu 27.10.2025
• Dokumentissa kuvataan skeema MissingWageReportsFromIR, jolla toimitetaan puuttuvien palkkatietoilmoitusten tiedot.

• Dokumentti julkaistu.

Tietojen jakelu – Skeemat – Puuttuvat etuustietoilmoitukset 2027 (pdf)

• Julkaistu 27.10.2025
• Dokumentissa kuvataan skeema MissingBenefitReportsFromIR, jolla toimitetaan puuttuvien etuustietoilmoitusten tiedot.

• Dokumentti julkaistu.

• Tietojen jakelun sisältökuvausten aiemmat versiot

Tekninen rajapinta – Soveltamisohje 2024 (pdf)

• Julkaistu 12.12.2023
• Dokumentissa kuvataan tulorekisterin teknisen rajapinnan toteutukseen liittyvät periaatteet järjestelmäintegraation toteuttajan näkökulmasta.

Tekninen rajapinta – Tietojen toimittamisen ja tietojen jakelun soveltamisohje 2026 (pdf)

• Julkaistu 8.10.2025
• Dokumentissa kuvataan
  • tulorekisterin teknisen rajapinnan toteutukseen liittyvät periaatteet järjestelmäintegraation toteuttajan näkökulmasta
  • tulorekisterissä tietoa vastaanottavat palvelut ja lähetettävien aineistojen rakenne
  • tietojen toimittamista teknisen rajapinnan ja latauspalvelun kautta yleisellä tasolla
  • tulorekisteristä tietoa jakavat palvelut ja jaettavien aineistojen rakenne
  • tietojen jakelua tulorekisteristä teknisen rajapinnan kautta yleisellä tasolla
  • tietojen toimittamiseen ja jakeluun liittyvät suositukset.

Tekninen rajapinta - Tietojen toimittamisen ja tietojen jakelun soveltamisohje 2027 (pdf)

• Julkaistu 27.10.2025

Vuoden 2024 dokumentti:

• Julkaistu dokumentista vuoden 2024 tietosisältömuutokset sisältävä versio.
• Lisätty lukuun 4.1.1 tiedot aineistojen 312 ja 313 jakelusta aineiston muodostajan SFTP-kansioon.

Vuoden 2026 dokumentti:

• Ohjeeseen on yhdistetty seuraavien aiemmin voimassa olleiden dokumenttien tietosisältö:
  • Tekninen rajapinta - Tietojen toimittaminen tulorekisteriin 2021
  • Tekninen rajapinta - Tietojen jakelu tulorekisteristä 2025
  • Tekninen rajapinta - Soveltamisohje 2024

Vuoden 2027 dokumentti:

• Julkaistu dokumentista vuoden 2027 tietosisältömuutokset sisältävä versio.
• Poistettu kappaleet 10.1.5 Koodistot ja 10.2.5 Koodistot, ja siirretty kappaleissa kuvattu sisältö osaksi lukua 10 Yleistä tietojen toimittamisesta ja jakelusta. Lisätty lukuun 6 uusien jakelun skeemojen mukaisten aineistojen maksimikoot sekä sallitut juurielementit.
• Lisätty lukuun 5.2.2 uudet Web Service -palvelut, joita voidaan käyttää puuttuvien palkka- tai etuustietoilmoitusten kyselyyn.
• Lisätty lukuun 9.1 uudet tiedon käyttäjän palvelut (321-324, 410, 411), joita voidaan käyttää puuttuvien palkka- tai etuustietoilmoitusten kyselyyn.
• Lisätty lukuun 9.5.2 uudet jakelun skeemat puuttuvien palkka- tai etuustietoilmoitusten poimimiseksi.
• Päivitetty luvun 10.2.3 tekstiä johdettavien tietojen periaatteen osalta.
• Lisätty uusi luku 10.2.4 Henkilötietojen käsittelyn rajoittaminen.
• Lisätty lukuun 12.2.3 uusi Oikaisuvaatimuksen viite -tieto.

Tekninen rajapinta – ZIP – Sovelluskehittäjälle 2025 (zip)

Tekninen rajapinta – ZIP – Sovelluskehittäjälle 2025 (pdf)

• Julkaistu 8.1.2024
• Zip-tiedosto sisältää skeemojen xsd-kuvaukset ja palvelujen WSDL-kuvaukset.
• Pdf-dokumentissa kuvataan zip-tiedoston sisältö.

Tekninen rajapinta – Zip-tiedosto sovelluskehittäjälle 2027 (zip)

Tekninen rajapinta – Zip-tiedosto sovelluskehittäjälle 2027 (pdf)

• Julkaistu 27.10.2025

Vuoden 2025 dokumentti:

• Julkaistu dokumentista vuoden 2025 tietosisältömuutokset sisältävä versio.
• Lisätty kuvaus muuttuneesta sisällöstä.

Vuoden 2027 dokumentti:

• Julkaistu dokumentista vuoden 2027 tietosisältömuutokset sisältävä versio.
• Lisätty WSDL-kuvauksiin uudet palvelut:
  
  • MissingWageReportQueryService
  • MissingBenefitReportQueryService
• Lisätty XSD-skeematiedostoihin uudet skeemat:
  
  • MissingBenefitReportsFromIR.xsd
  • MissingBenefitReportsFromIRTypes.xsd
  • MissingWageReportsFromIR.xsd
  • MissingWageReportsFromIRTypes.xsd

Tekninen rajapinta – Sanoman allekirjoitus, esimerkkitoteutus (zip)

Tekninen rajapinta – Sanoman allekirjoitus, esimerkkitoteutus (pdf)

• Julkaistu 23.3.2018
• Zip-tiedosto sisältää .Net/C#-kielellä laaditun asiakasrajapinnan (client) toteutuksen Echo-palvelun (EchoService) kutsusta ja lähetettävän pyyntösanoman allekirjoittamisesta.
• Pdf-dokumentissa kuvataan zip-tiedoston sisältö.

• Sovelluskehittäjän ohjeiden aiemmat versiot