Dokumentaatio 2020

Tällä sivulla julkaistaan vuoden 2020 tulorekisterin tekniset ohjeet ja skeemakuvaukset ohjelmistokehittäjille. Sivu täydentyy myöhemmin.

Tulorekisterin palkka- ja etuustietojen toimittamiseen ja jakeluun liittyvät rajapintakuvaukset ja niihin liittyvät soveltamisohjeet.

Tietosisällön soveltamisohjeet

Palkat

1. Tulolajien ja tuloista vähennettävien erien selitteet 2020 (pdf), 6.11.2019, versio 1.0

   • Palkkatietoilmoituksella olevien tulolajien ja tuloista vähennettävien erien selitteet

   • Dokumentissa kuvataan tilanteet, joissa tulolajeja käytetään

   • Lisäksi kuvataan ennakonpidätyksen toimittaminen ja sosiaalivakuutusmaksujen maksaminen kunkin tulolajin osalta

2. Palkkatietoilmoituksen tietosisällön soveltamisohje 2020 (pdf), 6.11.2019, versio 1.0
   • Dokumentissa kuvataan palkkatietoilmoituksen tietosisältö ja mitä tietosisällön kussakin yksittäisessä kohdassa ilmoitetaan
3. Työnantajan erillisilmoituksen soveltamisohje 2020 (pdf),6.11.2019, versio 1.0
   • Dokumentissa kuvataan työnantajan erillisilmoituksen tietosisältö ja mitä tietosisällön kussakin yksittäisessä kohdassa ilmoitetaan

Etuudet

1. Etuudet – Tulolajien ja tuloista vähennettävien erien selitteet (pdf), 21.5.2019, versio 1.03

   • Etuustietoilmoituksella olevien tulolajien ja tuloista vähennettävien erien selitteet.

   • Dokumentissa kuvataan tilanteet, joissa tulolajeja käytetään.

2. Etuustietoilmoituksen tietosisällön soveltamisohje (pdf), 30.1.2020, versio 1.04

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

Teknisen rajapinnan kuvaukset

Yleiskuvaukset

1. Tekninen rajapinta - Tietojen toimittaminen tulorekisteriin 2020 (pdf), 6.11.2019, versio 1.0

   • Dokumentti on yleiskuvaus tietojen toimittamisesta tulorekisteriin teknisen rajapinnan kautta. Dokumentissa esitellään tulorekisteriin tietoa vastaanottavat palvelut ja tulorekisteriin toimitettava tietosisältö yleisellä tasolla.

2. Tekninen rajapinta – Tietojen jakelu tulorekisteristä 2020 (pdf), 9.12.2019, versio 1.01

   • Dokumentti on yleiskuvaus tietojen jakelusta tulorekisteristä teknisen rajapinnan kautta. Dokumentissa esitellään tulorekisteristä tietoa jakavat palvelut ja tulorekisteristä toimitettava tietosisältö yleisellä tasolla.

3. Tulotiedot - Laskentasääntöjä 2020 (pdf), 7.11.2019, versio 1.0

4. Raportit tulorekisteristä 2020 (pdf), 26.11.2019, versio 1.0

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

Skeemojen sisältökuvaukset

1. Tietojen toimittaminen - Skeemat - Palkkatietoilmoitukset 2020 (pdf), 6.11.2019, versio 1.01

   • Dokumentissa esitellään skeema WageReportsToIR, jolla palkkatietoilmoitukset toimitetaan tulorekisteriin.

2. Tietojen toimittaminen - Skeemat - Työnantajan erillisilmoitukset 2020 (pdf), 6.11.2019, versio 1.01

   • Dokumentissa esitellään skeema PayerSummaryReportsToIR, jolla työnantajan erillisilmoitukset toimitetaan tulorekisteriin.

3. Tietojen toimittaminen - Skeemat - Etuustietoilmoitukset (pdf), 19.2.2020, versio 1.06
   
   
   • Dokumentissa esitellään skeema BenefitReportsToIR, jolla etuustietoilmoitukset toimitetaan tulorekisteriin.

4. Tietojen toimittaminen - Skeemat - Aineistotilaukset 2020 (pdf), 6.11.2019, versio 1.0

   • Dokumentissa esitellään skeema SubscriptionsToIR, jolla aineistotilaukset toimitetaan tulorekisteriin.

5. Tietojen toimittaminen-Skeemat-Viestit 2020 (pdf),6.11.2019, versio 1.0

   • Dokumentissa esitellään skeema MessagesToIR, jolla viestit toimitetaan tulorekisteriin.

6. Tietojen toimittaminen - Skeemat - Mitätöintitiedot 2020 (pdf), 6.11.2019, versio 1.0

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

7. Tietojen toimittaminen - Skeemat - Vastaanottokuittaus 2020 (pdf), 6.11.2019, versio 1.0

   • Dokumentissa esitellään skeema AckFromIR, jolla tulorekisteri toimittaa vastaanottokuittauksen tulorekisteriin lähetettyyn aineistoon (viivästetty Web Service -rajapinta).

8. Tietojen toimittaminen - Skeemat - Käsittelypalautteen kysely 2020 (pdf), 6.11.2019, versio 1.0

   • Dokumentissa esitellään skeema StatusRequestToIR, jolla aineiston toimittaja voi kysyä käsittelypalautetta tulorekisteriin toimitetusta aineistosta (viivästetty Web Service -rajapinta).

9. Tietojen toimittaminen - Skeemat - Käsittelypalaute 2020 (pdf), 6.11.2019, versio 1.0

   • Dokumentissa esitellään skeema StatusResponseFromIR, jolla tulorekisteri toimittaa käsittelypalautteen tulorekisteriin toimitetusta aineistosta.

10. Tietojen jakelu – Skeemat - Palvelupyyntö 2020 (pdf), 9.12.2019, versio 1.01

    • Dokumentissa esitellään skeema DataRequestToIR, jolla tietojen jakelun palvelupyyntö toimitetaan tulorekisteriin (reaaliaikainen Web Service -rajapinta).

11. Tietojen jakelu – Skeemat - Palkkatietoilmoitukset 2020 (pdf), 27.6.2019, versio 1.0

    • Dokumentissa esitellään skeema WageReportsFromIR, jolla palkkatietoilmoitukset toimitetaan tulorekisteristä.

12. Tietojen jakelu - Skeemat - Työnantajan erillisilmoitukset 2020 (pdf), 6.11.2019, versio 1.0

    • Dokumentissa esitellään skeema PayerSummaryReportsFromIR, jolla työnantajan erillisilmoitukset toimitetaan tulorekisteristä.

13. Tietojen jakelu – Skeemat – Etuustietoilmoitukset (pdf), 30.1.2020, versio 1.03

    • Dokumentissa esitellään skeema BenefitReportsFromIR, jolla etuustietoilmoitukset toimitetaan tulorekisteristä.

14. Tietojen jakelu - Skeemat - Viestit 2020 (pdf), 6.11.2019, versio 1.0

    • Dokumentissa esitellään skeema MessagesFromIR, jolla viestit toimitetaan tulorekisteristä.

15. Tietojen jakelu - Skeemat - Lokitiedot 2020 (pdf), 6.11.2019, versio 1.0

    • Dokumentissa esitellään skeema LogDataFromIR, jolla lokitiedot toimitetaan tulorekisteristä.

16. Tietojen jakelu – Skeemat – Maksajan palkkatietojen yhteenveto 2020 (pdf), 6.11.2019, versio 1.0

• • Dokumentissa esitellään skeema WageReportSummaryFromIR, jolla maksajan palkkatietoilmoitusten yhteenvetotiedot toimitetaan tulorekisteristä.

Koodistot

1. Koodistot 2020 (pdf), 30.1.2020, versio 1.03

   • Tulorekisterin teknisessä rajapinnassa käytettävät koodistot. Tulolajien koodit on esitelty erillisessä dokumentissa.

   • Koodistot 2020 (xls), 30.1.2020, versio 1.03
     
     

2. Palkat - Koodistot – Tulolajit 2020 (pdf), 27.6.2019, versio 1.0

   • Palkkatietoilmoituksen tulolajien ja tuloista vähennettävien erien koodit, ilmoitustavat ja tulolajeissa oletuksena olevat sosiaalivakuutusmaksut.

   • Työnantajan erillisilmoituksen tulolajien koodit.

   • Palkat - Koodistot - Tulolajit 2020 (xls), 27.6.2019, versio 1.0

3. Etuudet – Koodistot – Tulolajit (pdf), 21.5.2019, versio 1.03

• • Etuustietoilmoituksen tulolajien ja tuloista vähennettävien erien koodit ja ilmoitustavat.
  • Etuudet – Koodistot – Tulolajit (xls), 21.5.2019, versio 1.03

4. Koodistot - Virhekoodit 2020 (xls), 14.2.2020, versio 1.02

• • Virhekoodit ruotsiksi: Koduppsättningar – Felkoder 2020 (xls), 14.2.2020, versio 1.02
  • Virhekoodit englanniksi: Codes - Error codes 2020 (xls), 14.2.2020, versio 1.02

5. Koodistot - Ammattiluokitus, 18.5.2018

• • Tulorekisterissä käytettävä Tilastokeskuksen ylläpitämä ammattiluokitus on Tilastokeskuksen sivuilla kohdassa Tulorekisteri.

Sovelluskehittäjän ohjeet

1. Tekninen rajapinta – Soveltamisohje 2020 (pdf), 6.11.2019, versio 1.0

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

2. Tekninen rajapinta – ZIP – Sovelluskehittäjälle 2020 (zip), 14.2.2020, versio 1.15
   

   • ZIP-tiedosto, joka sisältää skeemojen xsd-kuvaukset, esimerkit skeemojen rakenteesta ja palvelujen WSDL-kuvaukset.

3. Tekninen rajapinta – ZIP – Sovelluskehittäjälle 2020 (pdf), 27.6.2019, versio 1.0

   • Dokumentissa esitellään ZIP-tiedoston sisältö.

Sanomaesimerkit: Tietojen toimittaminen - Palkkatietoilmoitus

Julkaistaan myöhemmin.

Sanomaesimerkit: Tietojen toimittaminen - Etuustietoilmoitus

Dokumenteissa on esimerkkejä etuustietoilmoituksen toimittamiseen liittyvistä tilanteista.

1. Esimerkki 001: Ansionmenetyskorvaus (liikennevakuutus), siihen liittyvä palkansaajamaksujen vähennys ja ennakonpidätys (pdf), 8.3.2019, versio 1.0
2. Esimerkki 002: Takautuvasti maksettava osatyökyvyttömyyseläke, kun tulonsaaja on jo saanut sairauspäivärahaa (pdf), 8.3.2019, versio 1.0

Sanomaesimerkit: Tietojen toimittaminen – Aineistotilaus

Julkaistaan myöhemmin.

Esimerkkitoteutus sanoman allekirjoittamisesta

1. Tekninen rajapinta - ZIP- sanoman allekirjoitus, esimerkkitoteutus (pdf), 23.3.2018, versio 1.0

• • Dokumentissa esitellään ZIP-tiedoston sisältö

2. Tekninen rajapinta - ZIP - sanoman allekirjoitus, esimerkkikoodit, 23.3.2018, versio 1.0

• • ZIP-tiedosto sisältää .Net/C#-kielellä laaditun asiakasrajapinnan (client) toteutuksen Echo-palvelun (EchoService) kutsusta ja lähetettävän pyyntösanoman allekirjoittamisesta.