Dokumentaatio

Palkat – Tulolajien ja tuloista vähennettävien erien selitteet 2024 (pdf)

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

• Seuraavien tulolajien selitteitä on tarkennettu:
  • 213 Lomaraha
  • 224 Työaikapankin rahakorvaus
  • 225 Työajantasauskorvaus
  • 321 Sijaismaksajan maksama palkka, josta työnantaja maksaa työnantajan sosiaalivakuutusmaksut (työeläke-, sairaus-, työttömyys- sekä työtapaturma- ja ammattitautivakuutus)
  • 322 Sijaismaksajan maksama palkka, josta työnantaja maksaa työnantajan työeläkemaksun
  • 323 Sijaismaksajan maksama palkka, josta työnantaja maksaa työnantajan työttömyysvakuutusmaksun
  • 324 Sijaismaksajan maksama palkka, josta työnantaja maksaa työnantajan työtapaturma- ja ammattitauti vakuutusmaksun
  • 325 Sijaismaksajan maksama palkka, josta työnantaja maksaa työnantajan sairausvakuutusmaksun
  • 327 Perhehoitajan kustannusten korvaus
  • 328 Perhehoitajan palkkio
  • 316 Muu veronalainen ansiotulo
  • 353 Veronalainen kustannusten korvaus
  • 354 Yksityisen hoidon tuen kuntalisä

Palkkatietoilmoituksen tietosisällön soveltamisohje 2024 (pdf)

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

• 22.5.2023:
  • Julkaistu dokumentista vuoden 2024 tietosisältömuutokset ja muut Tulorekisteriyksikön päivitykset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2024 tai sen jälkeen.
  • Lisätty kohtaan Tulonsaajan lisätiedot (IncomeEarnerTypes) uusi tulonsaajan lisätiedon tyyppi: Laskutuspalvelua käyttävä henkilö, jolla ei ole Y-tunnusta.
• 12.12.2023:
  • Korjattu cross-trade -aika -termi muotoon cross trade -aika.

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

Etuudet – Tulolajien ja tuloista vähennettävien erien selitteet 2023 (pdf)

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

• Muutettu dokumentin ulkoasua.

Etuustietoilmoituksen tietosisällön soveltamisohje 2024 (pdf)

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

• 22.5.2023:
  • Julkaistu dokumentista vuoden 2024 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2024 tai sen jälkeen.
  • Muutettu tietoryhmässä Takaisinmaksun lisätiedot (RecoveryData) tiedon Alkuperäinen ansaintakausi (OrigEarningPeriod) nimeksi Alkuperäinen maksukausi.
• 12.12.2023:
  • Tarkennettu tiedon Alkuperäinen maksukausi (OrigEarningPeriod) ohjeistuksessa sitä, milloin alkuperäisen maksukau-den loppupäiväksi voi ilmoittaa takaisinmaksupäivän tai muun päivän samalta kuukaudelta.
  • Korjattu kohdassa ’Sijaissaajan tyyppi’ Kunta tai muu sosiaalihuollon toimielin -tyypin selitettä siten, että kunta on muutettu hyvinvointialueeksi. Lisätty myös maininta, että kunta on voinut olla sijaissaajana ilmoituksissa, joiden maksupäivä tai muu ilmoituspäivä on 31.12.2022 tai aikaisemmin.
  • Tarkennettu tiedon Etuuden yksikkö (BenefitUnit) ohjeistuksessa yksikkötietojen ilmoittamista, kun ilmoitetaan osittaista vanhempainrahaa.

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

• 22.5.2023:
  • Julkaistu dokumentista vuoden 2024 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2024 tai sen jälkeen.
  • Lisätty uudet tulolajit:
    • 366 Tekijänoikeuskorvaus ansiotuloa
    • 367 Rahana maksettu osakepalkkio
    • 368 Rahana maksettu työsuhdeoptio
    • 369 JuEL-työnantajan maksama työansio, jonka työn suorittaja on laskuttanut laskutuspalveluyrityksen kautta
• 21.8.2023:
  • Muutettu dokumentin ulkoasua.

Etuudet – Koodistot – Tulolajit 2023 (xls)

Etuudet – Koodistot – Tulolajit 2023 (pdf)

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

• Muutettu dokumentin ulkoasua.

Koodistot 2024 (xls)

Koodistot 2024 (pdf)

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

• Lisätty koodistoon Sovellettava työehtosopimus (CBACode) seuraavat arvot, joiden voimassaolo on alkanut 1.4.2024:
  • 220 Matkailu-, ravintola- ja vapaa-ajan palveluita koskeva työehtosopimus – esihenkilöt
  • 221 Kaupan logistiikan esihenkilöiden työehtosopimus
  • 222 Vähittäiskaupan esihenkilöiden työehtosopimus
  • 223 Henkilöstöalan työehtosopimus
• Koodistossa Sovellettava työehtosopimus (CBACode) seuraavien arvojen voimassaolo on päättynyt 31.3.2024 ja ne on poistettu:
  • 36 Henkilöstöpalvelualan työehtosopimus
  • 88 Matkailu-, ravintola- ja vapaa-ajan palveluita koskeva työehtosopimus – esimiehet
  • 170 Varasto- ja kuljetusesimiesten työehtosopimus
  • 185 Vähittäiskaupan esimiesten työehtosopimus

Koodistot - Virhekoodit 2024 (xls)

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

• Korjattu seuraavien virhekoodien selitteitä: BEV0060, BEV0350, DDVS0115, DDVS0270, IEBV0080, MSE0010

Tulorekisterin TK10-ammattiluokitus (stat.fi)

• Tulorekisterissä on käytössä Tulorekisterin TK10-ammattiluokitus, joka on julkaistu Tilastokeskuksen sivuilla.
• Tulorekisterijärjestelmässä koodiston nimi on Tilastokeskuksen ammattiluokitus (TK10).

• Ammattiluokituksen nimi on muuttunut:
  • uusi nimi Tulorekisterin TK10-ammattiluokitus
  • aiemmin Tilastokeskuksen ammattiluokitus (TK10)

• Koodistojen aiemmat versiot

Raportit tulorekisteristä 2023 (pdf)

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

• Lisätty raporttiin 500 (Tulonsaajan tulorekisteriote) uudet tiedot Tulonsaajalle palautetut ennakonpidätykset (BenefitWithholdingReturn) ja Tulonsaajalle palautetut lähdeverot (BenefitTaxAtSourceReturn).
• Muutettu raportin 620 Maksajan etuustietoilmoitusten tulolajikohtainen yhteenveto (csv) tietoelementin termi alkuperäinen ansaintakausi muotoon alkuperäinen maksukausi.

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

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

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

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

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

Tietojen toimittaminen - Skeemat - Palkkatietoilmoitukset 2024 (pdf)

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

• Julkaistu dokumentista vuoden 2024 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2024 tai sen jälkeen.
•  22.5.2023:
  • Lisätty uusi käsittelysääntö tietoryhmään Ammatti (Professions). Käsittelysäännön mukaan (uusi d-kohta) tietoryhmää ”Ammattiluokka tai -nimike” ei tarvitse antaa, jos ilmoituksella on annettu vain tulolajeja, joissa "Takaisinperintä" on "true".
  • Lisätty uusi käsittelysääntö tietoryhmään Työeläkevakuutus (PensionInsurance). Käsittelysäännön mukaan (uusi d-kohta) tietoryhmää ”Työeläkevakuutus” ei tarvitse antaa, jos ilmoituksella on annettu vain tulolajeja, joissa "Takaisinperintä" on "true".
  • Lisätty tietoryhmän Tulolajin yleistiedot (TransactionBasic) elementin Tulolajin koodi (TransactionCode) käsittelysääntöön tulolajit:
    • 367 Rahana maksettu osakepalkkio
    • 368 Rahana maksettu työsuhdeoptio
    • 366 Tekijänoikeuskorvaus ansiotuloa
  • Lisätty tietoryhmän Tulolajin yleistiedot (TransactionBasic) elementin Määrä (Amount) käsittelysääntöön tulolajit:
    • 367 Rahana maksettu osakepalkkio
    • 368 Rahana maksettu työsuhdeoptio
    • 366 Tekijänoikeuskorvaus ansiotuloa
  • Lisätty uusi käsittelysääntö tietoryhmään Tulolajin yleistiedot (TransactionBasic) elementtiin Tulolajin koodi (TransactionCode): Jos ”Tulolajin koodi” on 369, tiedon Työeläkelaitoksen yhtiötunnus (PensionProvIdCode) on oltava 20, 24, 25, 27, 29, 30.
  • Lisätty uusi käsittelysääntö tietoryhmään Muut tiedot (IncomeEarnerOther) tiedolle Tulonsaajan lisätiedon tyyppi (IncomeEarnerType): Jos "Ammattiluokan tai nimikkeistön tyyppi" on "Tilastokeskuksen ammattiluokitus (TK10)" ja tiedoksi "Ammattiluokan tai nimikkeen tunniste" on annettu arvo "34210" (Urheilijat), tietona "Tulonsaajan lisätiedon tyyppi" on annettava "Urheilija".
• 15.8.2023:
  • Poistettu tietoryhmän Tulolajin yleistiedot (TransactionBasic) elementin Tulolajin koodi (TransactionCode) käsittelysäännöstä tulolaji: 366 Tekijänoikeuskorvaus ansiotuloa
  • Poistettu tietoryhmän Tulolajin yleistiedot (TransactionBasic) elementin Määrä (Amount) käsittelysäännöstä tulolaji: 366 Tekijänoikeuskorvaus ansiotuloa
• 11.9.2023:
  • Lisätty uusi käsittelysääntö tietoryhmän Maksajan tunnisteet (PayerIds) elementtiin Maksajan tunniste (Id): Maksajan tunnisteita voi ilmoittaa enimmillään kolme tunnistetta.
• 12.12.2023: 
  • Korjattu tietoryhmässä Merityötulo (SailorIncome) elementti cross-trade -aika muotoon cross trade -aika.
• 23.1.2024:
  • Korjattu termi Suomalainen työnteettäjä (FinServiceRecipient) muotoon Suomalainen työn teettäjä.

Tietojen toimittaminen - Skeemat - Työnantajan erillisilmoitukset 2023 (pdf)

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

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

Tietojen toimittaminen - Skeemat - Etuustietoilmoitukset 2024 (pdf)

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

Vuoden 2023 dokumentti:

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

Vuoden 2024 dokumentti:

• Julkaistu dokumentista vuoden 2024 tietosisältömuutokset sisältävä versio.
• 22.5.2023:
  • Muutettu tietoryhmässä Takaisinmaksun lisätiedot (RecoveryData) tiedon Alkuperäinen ansaintakausi (OrigEarningPeriod) nimeksi Alkuperäinen maksukausi.
• 11.9.2023:
  • Lisätty uusi käsittelysääntö tietoryhmän Maksajan tunnisteet (PayerIds) elementtiin Maksajan tunniste (Id): Maksajan tunnisteita voi ilmoittaa enimmillään kolme tunnistetta.

Tietojen toimittaminen - Skeemat - Aineistotilaukset 2021 (pdf)

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

• Korjattu kirjoitusvirhe luvun 2.2 tiedossa Aineistotilauksen tyyppi (SubscriptionType). Muoto SubcriptionType on korjattu muotoon SubscriptionType.

Tietojen toimittaminen - Skeemat - Mitätöintitiedot 2023 (pdf)

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

• Julkaistu dokumentista vuoden 2023 tietosisältömuutokset sisältävä versio.
• Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2023 tai sen jälkeen.
• Täydennetty tietoryhmässä Aineiston tiedot (DeliveryData) tiedon Tietolähde (Source) käsittelysääntöä siten, että se kattaa myös aineistot 107 Etuustietoilmoitusten mitätöiminen ja 111 Etuustietoilmoituksia sisältävän aineiston mitätöiminen.

Tietojen toimittaminen - Skeemat - Vastaanottokuittaus 2021 (pdf)

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

• Dokumentin sisältö vastaa vuoden 2020 dokumenttia.

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

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

• Dokumentin sisältö vastaa vuoden 2020 dokumenttia.

• Tietojen toimittamisen sisältökuvausten aiemmat versiot

Tekninen rajapinta – Tietojen jakelu tulorekisteristä 2024 (pdf)

• Julkaistu 12.12.2023
• 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).

• Julkaistu dokumentista vuoden 2024 tietosisältömuutokset sisältävä versio.
• Korjattu luvun 1 taulukkoa 1.
  • Korjattu tilattavien aineistojen 402–406 kuvauksia. Poistettu palvelu 405.
  • Korjattu palvelun 950 tilaajaksi tiedon käyttäjä maksajan sijaan.
• Lisätty lukuun 2.2 aineistotilauksen 950 mukaan jaettavan aineiston skeema Hylätyt paperilomakkeella annetut ilmoitukset – RejectedPaperReportsFromIR. Lisätty skeema myös luvun 2.4 kuvaan 3.
• Lukuun 2.4 ja 4.1 on lisätty tiedot aineistojen 312 ja 313 jakelusta.
• Lukuun 6.12 on lisätty aineistotilauksen tietoihin jakelukanavan arvo 7: Tekninen rajapinta SFTP (palveluntuottaja asioi maksajan puolesta).

Tietojen jakelu - Skeemat - Palkkatietoilmoitukset 2024 (pdf)

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

• Julkaistu dokumentista vuoden 2024 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2024 tai sen jälkeen.
• 22.5.2023:
  • Poistettu elementti Maksajan tietoihin voi sisältyä turvakiellon alaisia tietoja (SensitiveInfoIncluded) tietoryhmästä Maksajan muut tiedot (PayerOther).
  • Poistettu elementti Tulonsaajan tietoihin voi sisältyä turvakiellon alaisia tietoja (SensitiveInfoIncluded) tietoryhmästä Muut tiedot (IncomeEarnerOther).
  • Poistettu elementti Edustajan tietoihin voi sisältyä turvakiellon alaisia tietoja (SensitiveInfoIncluded) tietoryhmästä Edustaja (Representative).
  • Poistettu elementti Toimeksiantajan tietoihin voi sisältyä turvakiellon alaisia tietoja (SensitiveInfoIncluded) tietoryhmästä Toimeksiantaja (ServiceRecipient).
  • Lisätty uusi käsittelysääntö: ”Turvakiellon alaisia osoitetietoja ei jaeta”. Sääntö on lisätty seuraaviin tietoryhmiin:
    • Maksajan osoite (Address)
    • Tulonsaajan osoitteet (Addresses)
    • Edustaja (Representative)
    • Toimeksiantaja (ServiceRecipient).
• 11.9.2023:
  • Lisätty uusi käsittelysääntö tietoryhmän Maksajan tunnisteet (PayerIds) elementtiin Maksajan tunniste (Id): Maksajan tunnisteita voi ilmoittaa enimmillään kolme tunnistetta.
• 12.12.2023:
  • Korjattu tietoryhmässä Merityötulo (SailorIncome) elementti cross-trade -aika muotoon cross trade -aika.
• 23.1.2024:
  • Korjattu termi Suomalainen työnteettäjä (FinServiceRecipient) muotoon Suomalainen työn teettäjä.

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

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

• Julkaistu dokumentista vuoden 2024 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2024 tai sen jälkeen.
• 22.5.2023:
  • Poistettu elementti Maksajan tietoihin voi sisältyä turvakiellon alaisia tietoja (SensitiveInfoIncluded) tietoryhmästä Maksajan muut tiedot (PayerOther).
  • Lisätty käsittelysääntö ”Turvakiellon alaisia osoitetietoja ei jaeta” tietoryhmään Maksajan osoite (Address).
• 11.9.2023:
  • 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ä.

• Julkaistu dokumentista vuoden 2024 tietosisältömuutokset sisältävä versio. Muutoksia sovelletaan, kun tulon maksupäivä on 1.1.2024 tai sen jälkeen.
• 22.5.2023:
  • Muutettu tietoryhmässä Takaisinmaksun lisätiedot (RecoveryData) tiedon Alkuperäinen ansaintakausi (OrigEarningPeriod) nimeksi Alkuperäinen maksukausi.
  • Poistettu elementti Tulonsaajan tietoihin voi sisältyä turvakiellon alaisia tietoja (SensitiveInfoIncluded) tietoryhmästä Tulonsaajan tiedot (IncomeEarner).
  • Poistettu elementti Vakuutuksenottajan tietoihin voi sisältyä turvakiellon alaisia tietoja (SensitiveInfoIncluded) tietoryhmästä Vakuutuksen tiedot (Insurance).
  • Poistettu elementti Sijaissaajan tietoihin voi sisältyä turvakiellon alaisia tietoja (SensitiveInfoIncluded) tietoryhmästä Sijaissaajan tiedot (IncomeBeneficiary).
  • Lisätty uusi käsittelysääntö: ”Turvakiellon alaisia osoitetietoja ei jaeta”. Sääntö on lisätty seuraaviin tietoryhmiin:
    • Tulonsaajan osoite (Address)
    • Vakuutuksenottajan osoite (Address)
    • Sijaissaajan osoite (Address).
• 11.9.2023:
  • 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 - 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 2021 (pdf)

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

• Korjattu elementin nimi tietoryhmässä Poiminnan yhteenvetotiedot (Summary): elementin Poimittujen kohteiden lukumäärä (NrOfEvents) nimi (NrOfReports) on muutettu oikeaan muotoon (NrOfEvents). Korjaus ei vaikuta toteutukseen.
• Korjattu Tyyppi-tieto tietoryhmässä Lokitapahtuman kohteet (TargetItems): Tyyppi "mfirt:QueryTargetItem" on muutettu tiedoksi "ldt:QueryTargetItem". Korjaus ei vaikuta toteutukseen.

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.

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

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.

• Julkaistu vuoden 2024 tietosisältömuutokset sisältävä versio.
• 22.5.2023:
  • Poistettu tietoryhmästä Aineistotilauksen tiedot (Subscription) seuraava tieto: Tiedonsaantiprofiili (QueryProfile)
  • Poistettu tietoryhmästä Ilmoitusten tiedot (Reports) seuraava tieto: Suorituksen maksupäivä tai muu ilmoituspäivä (PaymentDate)
• 11.9.2023:
  • Lisätty uusi käsittelysääntö tietoryhmän Maksajan tunnisteet (PayerIds) elementtiin Maksajan tunniste (Id): Maksajalla voi olla enimmillään kolme tunnistetta.

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

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

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

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

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

• Julkaistu dokumentista vuoden 2024 tietosisältömuutokset sisältävä versio.
• Muutokset skeemassa RejectedPaperReportsFromIRTypes:
  • Poistettu tietoryhmästä Aineistotilauksen tiedot (Subscription) seuraava tieto: Tiedonsaantiprofiili (QueryProfile)
  • Poistettu tietoryhmästä Ilmoitusten tiedot (Reports) seuraava tieto: Suorituksen maksupäivä tai muu ilmoituspäivä (PaymentDate)
  • Lisätty PaymentPeriod-tietoryhmän puuttuva maxOccurs-indikaattori (maxOccurs="1")

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