Dokumentaatio

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

Palkkatietoilmoituksen tietosisällön soveltamisohje 2027 (pdf)

• Julkaistu 6.11.2025

Vuoden 2026 dokumentti:

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

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

• Palkkojen tietosisällön soveltamisohjeiden aiemmat versiot
• Etuuksien tietosisällön soveltamisohjeiden aiemmat versiot

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

• Tulolajin 366 Tekijänoikeuskorvaus ansiotuloa selitettä on tarkennettu.

Etuudet – Koodistot – Tulolajit 2026 (xls)

• Julkaistu 8.10.2025
• 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.

• Päivitetty seuraavien tulolajien selite: 1024 ja 1424.
• Lisätty uusi tulolaji 1446 (Osittainen erityisraskausraha).

Koodistot 2026 (xls)

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

Koodistot 2027 (xls)

• Julkaistu 27.10.2025

Vuoden 2026 dokumentti:

• Lisätty koodistoon Aineiston skeeman versio QueryDataSchemaVersion) uusi arvo: Palkkatietoilmoitukset – kaikki maksajat
• Lisätty koodistoon Aineiston tyyppi, tulorekisteristä jaettava (QueryDataType) uusi arvo: 320 "Palkkatietoilmoitukset - Kaikki maksajat (xml)"
• Lisätty koodistoon palkallisen poissaolon syy (PaidAbsenceCauseCode) arvo: 24 Osittainen erityisraskausvapaa
• Lisätty koodistoon palkattoman poissaolon syy (UnpaidAbsenceCauseCode) arvo: 18 Osittainen erityisraskausvapaa
• Lisätty koodistoon Sovellettava työehtosopimus (CBACode) uudet arvot: 225, 226, 227 ja 228.
• Poistettu koodistosta Sovellettava työehtosopimus (CBACode) arvot: 4 ja 187.
• Korjattu ParameterTypen selitteen 30 arvo: Aineiston omistajan aineistoviite tilalle 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

Koodistot – Virhekoodit 2026 (xls)

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

Koodistot – Virhekoodit 2027 (xls)

• Julkaistu 6.11.2025

Vuoden 2026 dokumentti:

• 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 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 2026 dokumentti:

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

• Raporttien sisältökuvausten aiemmat versiot

Tietojen toimittaminen – Skeemat – Palkkatietoilmoitukset 2026 (pdf)

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

Tietojen toimittaminen – Skeemat – Palkkatietoilmoitukset 2027 (pdf)

• Julkaistu 6.11.2025

Vuoden 2026 dokumentti:

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

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

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

• Lisätty white space merkistö (1.2)

Tietojen toimittaminen - Skeemat – Etuustietoilmoitukset 2026 (pdf)

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

Tietojen toimittaminen - Skeemat – Etuustietoilmoitukset 2027 (pdf)

• Julkaistu 27.10.2025

Vuoden 2026 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 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.

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

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

• 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

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 2026 (pdf)

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

• 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 – 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
  • 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 27.10.2025

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