Dokumentaatio

Palkat – Koodistot – Tulolajit 2026 (xlsx)

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

Palkat – Koodistot – Tulolajit 2027 (xlsx)

• Julkaistu 29.5.2026

Vuoden 2026 dokumentti:

• Päivitetty lukuohje.

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. 
• Poistettu seuraavat tulolajit:
  • 410 Työnantajan maksaman kollektiivisen lisäeläkevakuutuksen maksu
  • 411 Työnantajan maksaman kollektiivisen lisäeläkevakuutuksen työntekijältä peritty osuus
  • 418 Vapaaehtoisen yksilöllisen eläkevakuutuksen maksu.
• Lisätty seuraavat uudet tulolajit:
  • 344 Sijaisperhehoitajan palkkio
  • 345 Tukiperheelle maksettu palkkio
  • 346 Sijaisomaishoitajan palkkio.
• Poistettu vanha selite ja lisätty uusi tulolajeille 319 and 328.

Etuudet – Koodistot – Tulolajit 2026 (xlsx)

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

Etuudet – Koodistot – Tulolajit 2027 (xlsx)

• Julkaistu 29.5.2026

Vuoden 2026 dokumentti:

• Lisätty tulolaji 1447, Yleistuki työttömyyden perusteella (Ahvenanmaan maakunta)
• Päivitetty lukuohje ja seuraavien tulolajien selitteitä: 1018, 1019 ja 1021

Vuoden 2027 dokumentti:

• Poistettu seuraavat tulolajit:
  
  • 1109 Osavanhuuseläke (vapaaehtoinen työeläkevakuutus)
  • 1112 Osa-aikaeläke (ryhmäeläkevakuutus)
  • 1113 Työttömyyseläke (eläkekassat ja -säätiöt)
  • 1319 Ylimääräinen perhe-eläke (Puolustusvoimien entiset viran tai toimen haltijat)
  • 1342 Osa-aikaeläke (vapaaehtoinen työeläkevakuutus)
  • 1417 Työuraeläke (vapaaehtoinen työeläkevakuutus)
  • 1418 Työuraeläke (suora lisäeläkejärjestely)
  • 1419 Osittainen varhennettu vanhuuseläke (vapaaehtoinen työeläkevakuutus)
  • 1421 Kertamaksullisen vapaaehtoisen eläkevakuutuksen tuotto
• Päivitetty tulolajien 1062, 1271, 1336 ja 1378 selitteet siten, että tulolajit voivat olla myös verotuksessa verottomia.
• Tarkista kaikki vuoden 2027 muutokset dokumentin versiohistoriasta.

Koodistot 2026 (xlsx)

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

Koodistot 2027 (xlsx)

• Julkaistu 29.5.2026

Vuoden 2026 dokumentti:

• Lisätty koodistoon Sovellettava työehtosopimus (CBACode) uusi arvo (voimassa 1.4.2026 alkaen):
  • 237  Medialiiton ja Ammattiliitto Pron sekä Viestintäalan toimihenkilöt Grafinet ry:n välinen toimihenkilöitä koskeva työehtosopimus
• Seuraavat Sovellettava työehtosopimus (CBACode) -koodiston arvot eivät ole voimassa 31.3.2026 jälkeen:
  • 175 Medialiiton ja Ammattiliitto Pron välinen toimihenkilöiden työehtosopimus  
  • 179 Medialiiton ja Teollisuusliiton sekä Viestintäalan toimihenkilöt Grafinet ry:n välinen toimihenkilöitä koskeva työehtosopimus

Vuoden 2027 dokumentti:

• Lisätty seuraavat uudet koodiarvot koodistoon Aineiston tyyppi, tulorekisteristä jaettava (QueryDataType):
  • 325 - Puuttuvat palkkatietoilmoitukset - useita maksajia (xml)
  • 326 - Puuttuvat palkkatietoilmoitukset - useita maksajia, useita tulonsaajia (xml)
  • 327 - Puuttuvat etuustietoilmoitukset - useita maksajia (xml)
  • 328 - Puuttuvat etuustietoilmoitukset - useita maksajia, useita tulonsaajia (xml)
  • 412 - Puuttuvat palkkatietoilmoitukset - yksi maksaja (WS reaaliaikainen, xml)
  • 413 - Puuttuvat palkkatietoilmoitukset - yksi maksaja, yksi tulonsaaja (WS reaaliaikainen, xml)
  • 414 - Puuttuvat etuustietoilmoitukset - yksi maksaja, yksi tulonsaaja (WS reaaliaikainen, xml)
• Tarkista kaikki vuoden 2027 muutokset dokumentin versiohistoriasta.

Koodistot – Virhekoodit 2026 (xlsx)

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

Koodistot – Virhekoodit 2027 (xlsx)

• Julkaistu 29.5.2026

Vuoden 2026 dokumentti:

• Poistettu virhekoodi AV0430.
• Lisätty virhekoodi TRVA0440 ja muutettu TRVA0420:n selitettä.

Vuoden 2027 dokumentti:

• Lisätty virhekoodit AV0430, AV0440, TIVA0060, BEV0550, REDV0130, BEV0570, BEV0560, INTDV0060, IEOV0060, IEV0150, IEV0160, IEV0170, EG0010–EG0120, REDV0140, REDV0150, AV0450, AV0460 and DDVS0310.
• Tarkista kaikki vuoden 2027 muutokset dokumentin versiohistoriasta.

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

Palkkatietoilmoituksen tietosisällön soveltamisohje 2026 (pdf)

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

Palkkatietoilmoituksen tietosisällön soveltamisohje 2027 (pdf)

• Julkaistu 29.5.2026

Vuoden 2026 dokumentti:

• Maksajan tyypin "Ulkomainen konserniyhtiö" tietoryhmässä Maksajan muut tiedot (PayerOther) selitettä on korjattu.

Vuoden 2027 dokumentti:

• Lisätty uusi tieto ”Tilastokeskuksen toimipaikka” tietoryhmään Tulonsaajan toimipaikka (PlaceOfBusiness). Päivitetty koko tietoryhmän ohjeistusta.
• Tarkista kaikki vuoden 2027 muutokset dokumentin versiohistoriasta.

Tietojen toimittaminen – Skeemat – Palkkatietoilmoitukset 2026 (pdf)

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

Tietojen toimittaminen – Skeemat – Palkkatietoilmoitukset 2027 (pdf)

• Julkaistu 29.5.2026

Vuoden 2026 dokumentti:

• Päivitetty tietoryhmän Allekirjoitus (Signature) käsittelysääntöä:
  • Elementti ei ole sallittu latauspalvelun kautta toimitettavassa aineistossa.

Vuoden 2027 dokumentti:

• Lisätty tietoryhmään Tulonsaajan toimipaikka (PlaceOfBusiness) uusi tietokenttä: Tilastokeskuksen toimipaikkatunnus (StatisticsFinlandId)
• Lisätty käsittelysääntö Loppupäivä-tiedolle (EndDate) -tietoryhmässä Palvelussuhdetiedot (Employment): Loppupäivä on pakollinen, jos palvelussuhde päättyy eläkkeelle siirtymiseen.
• Lisätty käsittelysäännöt Palkallinen poissaolo (PaidAbsence) -tietoryhmän Alku- ja Loppupäiville: Alkupäivän tulee olla kuukauden ensimmäinen ja Loppupäivän kuukauden viimeinen päivä, jos Maksutiedon tyyppi on Kelan vuosilomakustannuskorvaus.
• Lisätty käsittelysääntö Takaisinperinnän lisätiedot (RecoveryData) -tietoryhmän Takaisinperittyyn määrään kohdistuva ennakonpidätys -tiedolle: Ennakonpidätyksen määrän tulee olla 0 tai tyhjä, jos takaisinperintäpäivä on alkuperäisen palkanmaksukauden maksupäivän vuotta seuraavan vuoden 30.4. päivän jälkeen.
• Lisätty käsittelysääntö Takaisinperinnän lisätiedot (RecoveryData) -tietoryhmän Alkuperäiselle palkanmaksukaudelle: jos maksupäivää ei ole annettu, pitää palkanmaksukauden alku- ja loppupäivän olla saman kalenterivuoden aikana.
• Lisätty käsittelysääntö Kansainväliset tilanteet (InternationalData) -tietoryhmän Asuinvaltion maakoodi -tiedolle:
  rajoitetusti verovelvollisen maakoodi ei saa olla Suomi.
• Lisätty käsittelysääntö Takaisinperinnän lisätiedot (RecoveryData) -tietoryhmän Alkuperäiselle palkanmaksukaudelle: ”Alkuperäisiä palkanmaksukausia voi olla vain yksi”. Samalla poistettu aiempi käsittelysääntö ”Alkuperäisiä palkanmaksukausia voi olla useita”.
• Lisätty käsittelysääntö Kansainväliset tilanteet (InternationalData) -tietoryhmän Rajoitetusti verovelvollinen -tiedolle:
  Tulonsaajan lisätiedon tyyppi ei saa olla 4, jos tulonsaaja on rajoitetusti verovelvollinen.
• Lisätty käsittelysääntö Palkallinen poissaolo (PaidAbsence) -tietoryhmän Poissaolopäivien lukumäärä -tiedolle: Osa-aikaisen tuntityön tekijän palkallisten poissaolopäivien lukumäärän on oltava vähintään puolet poissaolojakson pituudesta, mutta korkeintaan yhtä suuri kuin poissaolojakson päivien lukumäärä.
• Lisätty käsittelysääntö Kansainväliset tilanteet (InternationalData) -tietoryhmän Rajoitetusti verovelvollinen -tiedolle: Tulonsaajan tulee olla rajoitetusti verovelvollinen, jos ilmoituksella on annettu tulolaji 404. Poikkeuksena avainhenkilöt.
• Lisätty käsittelysääntö Vakuuttamistiedot (InsuranceData) -tietoryhmän Vakuuttamisen tyyppi -tiedolle: Tyypin arvon tulee olla 1 tai 5, jos on ilmoitettu tulolaji 210, 214, 215 tai 308 ja tulonsaaja on palvelussuhteessa eikä vakuuttamisen poikkeustilanteen tyyppejä 1, 5, 6 tai 9 ole annettu.
• Lisätty oikeellisuustarkistussääntö Aineiston yhteyshenkilöt (ContactPersons) -tietoryhmän Sähköpostiosoite -tiedolle.
• Tarkista kaikki vuoden 2027 muutokset dokumentin versiohistoriasta.

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.

Työnantajan erillisilmoituksen soveltamisohje 2027 (pdf)

• Julkaistu 29.5.2026

Vuoden 2022 dokumentti:

• Lisätty Johdanto ja Lukuohje.

Vuoden 2027 dokumentti:

• Lisätty Tulolajin tiedot (Transactions) uusi ohje.
• Lisätty uusi tietoryhmäTyöntekijäryhmät (EmployeeGroups).

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

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

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

• Julkaistu 29.5.2026

Vuoden 2026 dokumentti:

• Päivitetty tietoryhmän Allekirjoitus (Signature) käsittelysääntöä:
  • Elementti ei ole sallittu latauspalvelun kautta toimitettavassa aineistossa.

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.
• Muokattu tietoryhmän Tulolajit (Transactions) käsittelysääntöä.
• Lisätty uusi tietoryhmä Työntekijäryhmät (EmployeeGroups).
  Kohdekausi (PaymentMonth) ohjeistusta selkeytetty.
  Lisätty oikeellisuustarkistussääntö Aineiston yhteyshenkilöt (ContactPersons) -tietoryhmän Sähköpostiosoite -tiedolle.

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).

Tietojen toimittaminen - Skeemat – Etuustietoilmoitukset 2026 (pdf)

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

Tietojen toimittaminen - Skeemat – Etuustietoilmoitukset 2027 (pdf)

• Julkaistu 29.5.2026

Vuoden 2026 dokumentti:

• Päivitetty tietoryhmän Allekirjoitus (Signature) käsittelysääntöä:
  • Elementti ei ole sallittu latauspalvelun kautta toimitettavassa aineistossa.

Vuoden 2027 dokumentti:

• Lisätty käsittelysääntö Takaisinmaksun lisätiedot (RecoveryData) -tietoryhmän Takaisinmaksuun kohdistuva ennakonpidätys -tiedolle: 
  Ennakonpidätyksen määrän tulee olla 0 tai tyhjä, jos takaisinmaksupäivä on alkuperäisen maksukauden maksupäivän vuotta seuraavan vuoden 30.4. päivän jälkeen.
• Lisätty käsittelysääntö Kansainväliset tilanteet (InternationalData) -tietoryhmän Asuinvaltion maakoodi -tiedolle: rajoitetusti verovelvollisen maakoodi ei saa olla Suomi.
• Lisätty käsittelysääntö Kansainväliset tilanteet (InternationalData) -tietoryhmän Rajoitetusti verovelvollinen -tiedolle: tulonsaajan tulee olla rajoitetusti verovelvollinen, jos ilmoituksella on ilmoitettu tulolaji 1267.
• Lisätty oikeellisuustarkistussääntö Aineiston yhteyshenkilöt (ContactPersons) -tietoryhmän Sähköpostiosoite -tiedolle. 
• Tarkista kaikki vuoden 2027 muutokset dokumentin versiohistoriasta.

Tietojen toimittaminen – Skeemat – Aineistotilaukset 2026 (pdf)

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

• Julkaistu vuoden 2026 tietosisältömuutokset sisältävä versio.

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

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

• Päivitetty tietoryhmän Allekirjoitus (Signature) käsittelysääntöä: 
  • Elementti ei ole sallittu latauspalvelun kautta toimitettavassa aineistossa.

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).

• Palkkojen tietosisällön soveltamisohjeiden aiemmat versiot
• Etuuksien tietosisällön soveltamisohjeiden aiemmat versiot
• Tietojen toimittamisen sisältökuvausten aiemmat versiot

Raportit ja aineistot tulorekisteristä 2026 (pdf)

• Julkaistu 18.2.2026
• 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 29.5.2026

Vuoden 2026 dokumentti:

• Korjattu 1.1 kappaleen taulukkoon raportin 618 tiedostomuoto csv:ksi.

Vuoden 2027 dokumentti:

• Lisätty seuraavat uudet kappaleet:
  • 6.23 Puuttuvat palkkatietoilmoitukset – useita maksajia (xml)
  • 6.24 Puuttuvat palkkatietoilmoitukset – useita maksajia, useita tulonsaajia (xml)
  • 6.25 Puuttuvat etuustietoilmoitukset – useita maksajia (xml)
  • 6.26 Puuttuvat etuustietoilmoitukset – useita maksajia, useita tulonsaajia (xml)
  • 7.12 Puuttuvat palkkatietoilmoitukset - yksi maksaja (xml)
  • 7.13 Puuttuvat palkkatietoilmoitukset – yksi maksaja, yksi tulonsaaja (xml)
  • 7.14 Puuttuvat etuustietoilmoitukset – yksi maksaja, yksi tulonsaaja (xml)
• Lisätty uudet aineistotyypit 325, 326, 327, 328, 412, 413, 414 kappaleeseen 1.3 Tulorekisteristä jaettavat aineistot.
• Lisätty raporttien 700 ja 701 osalta Raportin tiedot -kohtaan maininta siitä, ettei Ilmoitusten lukumäärä -tietoa lasketa aineistotyypeille 325, 326, 327, 328, 412, 413, 414.
• Aineistotyypeille 321, 322, 323, 324, 410 ja 411 on lisätty Tiedonsaantiprofiili -tieto (QueryProfile) Alitilauksen (Subscription) tietoihin. Lisäksi näiden aineistotyyppien poiminnassa käytettävän aikavälin alkuhetken logiikkaa on täsmennetty siten, että tarkastelussa huomioidaan joko luontihetki tai ilmoitettu aikaväli.
• Muutos koskee seuraavia kappaleita:
  • Kappale: 6.19 Puuttuvat palkkatietoilmoitukset - kaikki tulonsaajat (xml)
  • Kappale: 6.20 Puuttuvat palkkatietoilmoitukset - useita tulonsaajia (xml)
  • Kappale: 6.21 Puuttuvat etuustietoilmoitukset - kaikki tulonsaajat (xml)
  • Kappale: 6.22 Puuttuvat etuustietoilmoitukset - useita tulonsaajia (xml)
  • Kappale: 7.10 Puuttuvat palkkatietoilmoitukset - yksi tulonsaaja (xml)
  • Kappale: 7.11 Puuttuvat etuustietoilmoitukset - yksi tulonsaaja (xml)
• Tarkista kaikki vuoden 2027 muutokset dokumentin versiohistoriasta.

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

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

• Täydennetty ”Työnantajan erillisilmoitusten summatiedot kohdekausittain” skeeman ylätason taulukkoon ja päivitetty skeeman kuvaa. 
• Muutettu Poimittujen kohteiden lukumäärän (NrOfReports) käsittelysääntöä siten, että se sisältää myös työnantajan erillisilmoitusten lukumäärän. 

• Raporttien sisältökuvausten aiemmat versiot

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 29.5.2026

Vuoden 2024 dokumentti:

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

Vuoden 2027 dokumentti:

• Lisätty tietoryhmään Tulonsaajan toimipaikka (PlaceOfBusiness) uudet tietokentät: Tilastokeskuksen toimipaikkatunnus (StatisticsFinlandId) ja Tilastokeskuksen toimipaikkatunnus kiistetty (StatisticsFinlandIdDenied)
• Tarkista kaikki vuoden 2027 muutokset dokumentin versiohistoriasta.

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

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

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

• Julkaistu 29.5.2026

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 uusi tietoryhmä Työntekijäryhmät (EmployeeGroups).

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.

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 – 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 29.5.2026
• Dokumentissa kuvataan skeema MissingWageReportsFromIR, jolla toimitetaan puuttuvien palkkatietoilmoitusten tiedot.

• Lisätty kohtaan 2.1 Aineistotilauksen tiedot (Subscription) uusi tietoelementti Tiedonsaantiprofiili (QueryProfile).
• Muutettu Maksajan tiedot (Payer) -tietoryhmä pakollisesta vapaaehtoiseksi.
• Muutettu Maksajan tunniste (PayerId) -tietoryhmän sisältämät Tunnisteen tyyppi (Type) ja Tunniste (Code) -tiedot pakollisista vapaaehtoisiksi.

Tietojen jakelu – Skeemat – Puuttuvat etuustietoilmoitukset 2027 (pdf)

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

• Lisätty kohtaan 2.1 Aineistotilauksen tiedot (Subscription) uusi tietoelementti Tiedonsaantiprofiili (QueryProfile).
• Muutettu Maksajan tiedot (Payer) -tietoryhmä pakollisesta vapaaehtoiseksi.
• Muutettu Maksajan tunniste (PayerId) -tietoryhmän sisältämät Tunnisteen tyyppi (Type) ja Tunniste (Code) -tiedot pakollisista vapaaehtoisiksi.

• Tietojen jakelun sisältökuvausten aiemmat versiot

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

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

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

• Julkaistu 29.5.2026

Vuoden 2026 dokumentti:

• Poistettu TLS-salausasetuksista seuraavat kryptoalgoritmien yhdistelmät (cipher suite):
  • TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
  • TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
  • TLS_DHE_DSS_WITH_AES_256_CBC_SHA256
  • TLS_DHE_DSS_WITH_AES_128_CBC_SHA256

Vuoden 2027 dokumentti:

• Tarkennettu luvussa 10.2.4 Henkilötietojen käsittelyn rajoittaminen ja sen alaluvuissa 10.2.4.1 Ilmoitetun tiedon kiistäminen, 10.2.4.2 Ilmoitukselta puuttuvan tiedon kiistäminen sekä 10.2.4.3 Puuttuvat ilmoitukset kuvattuja kiistomerkintöjen jakelun sääntöjä.
• Päivitetty luvun 10.2.4 ja 13.2. terminologiaa kiistomerkintöjen osalta.
• Päivitetty luvun 13.2.2 Päätilauksen yleistiedot tiedon Muutosten poimintavälin alkuhetki ja loppuhetki (ModifiedTimespanStart, ModifiedTimespanEnd) kuvausta kiistomerkintöjen osalta. Lisätty esimerkki kiistomerkintöjen jakelusta.
• Päivitetty luvun 13.2.4 Alitilauksen yleistiedot tiedon Kaikkien ilmoitusversioiden poiminta (IncludeAllVersions) kuvausta. Kuvauksessa huomioidaan nyt myös kiistomerkintöjen jakelu.
• Tarkista kaikki vuoden 2027 muutokset dokumentin versiohistoriasta.

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 29.5.2026

Vuoden 2025 dokumentti:

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

Vuoden 2027 dokumentti:

• Päivitetty vuoden 2027 tietosisältömuutoksiin DataRequestToIR.xsd skeematiedoston muutokset.
• Tarkista kaikki vuoden 2027 muutokset dokumentin versiohistoriasta.

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