Dokumentaatio 2020

Tällä sivulla julkaistaan vuoden 2020 tulorekisterin tekniset ohjeet ja skeemakuvaukset ohjelmistokehittäjille. Sivu täydentyy syksyllä 2019.

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

Tietosisällön soveltamisohjeet

Palkat

  1. Työnantajan erillisilmoituksen soveltamisohje (pdf),11.3.2019, versio 1.03

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

Etuudet

  1. Etuudet – Tietojen ilmoittaminen tulorekisteriin (pdf), 8.3.2019, versio 1.02
    • Dokumentti on yleisesitys etuustietojen ilmoittamisesta tulorekisteriin.

    • Dokumentissa kuvataan esimerkkien avulla yleisimpiä tulorekisterin etuustietojen ilmoitustilanteita.
  2. 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.

  3. Etuustietoilmoituksen tietosisällön soveltamisohje (pdf), 8.3.2019, versio 1.03

    • 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 (pdf), 11.6.2018, versio 1.04

    • 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ä (pdf), 7.1.2019, versio 1.07

    • 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ä (pdf), 19.2.2019, versio 1.04

  4. Raportit tulorekisteristä (pdf), 19.2.2019, versio 1.04

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

Skeemojen sisältökuvaukset

  1. Tietojen toimittaminen - Skeemat - Palkkatietoilmoitukset 2020 (pdf), 27.6.2019, versio 1.0

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

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

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

  3. Tietojen toimittaminen - Skeemat - Etuustietoilmoitukset (pdf), 24.6.2019, versio 1.04

    • Dokumentissa esitellään skeema BenefitReportsToIR, jolla etuustietoilmoitukset toimitetaan tulorekisteriin.
  4. Tietojen toimittaminen - Skeemat - Aineistotilaukset (pdf), 7.1.2019, versio 1.07

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

  5. Tietojen toimittaminen-Skeemat-Viestit (pdf), 26.9.2018, versio 1.05

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

  6. Tietojen toimittaminen - Skeemat - Mitätöintitiedot (pdf), 26.9.2018, versio 1.05

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

  7. Tietojen toimittaminen - Skeemat - Vastaanottokuittaus (pdf), 26.9.2018, versio 1.04

    • 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 (pdf), 26.9.2018, versio 1.05

    • 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 (pdf), 26.9.2018, versio 1.04

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

  10. Tietojen jakelu – Skeemat - Palvelupyyntö (pdf), 7.1.2019, versio 1.06

    • 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 (pdf), 26.9.2018, versio 1.05

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

  13. Tietojen jakelu – Skeemat – Etuustietoilmoitukset (pdf), 8.3.2019, versio 1.02
    • Dokumentissa esitellään skeema BenefitReportsFromIR, jolla etuustietoilmoitukset toimitetaan tulorekisteristä.

  14. Tietojen jakelu - Skeemat - Viestit (pdf), 26.9.2018, versio 1.04

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

  15. Tietojen jakelu - Skeemat - Lokitiedot (pdf), 26.9.2018, versio 1.04

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

  16. Tietojen jakelu – Skeemat – Maksajan palkkatietojen yhteenveto (pdf), 26.9.2018, versio 1.02
    • Dokumentissa esitellään skeema WageReportSummaryFromIR, jolla maksajan palkkatietoilmoitusten yhteenvetotiedot toimitetaan tulorekisteristä.

Koodistot

  1. Koodistot 2020 (pdf), 27.6.2019, versio 1.0 

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

    • Koodistot 2020 (xls), 27.6.2019, versio 1.0

  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

4. Koodistot - Virhekoodit (xls), 11.6.2019, versio 1.09

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 (pdf), 22.10.2018, versio 1.06

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

  2. Tekninen rajapinta – ZIP – Sovelluskehittajalle 2020 (zip) 27.6.2019, versio 1.0

    • 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. 1. Esimerkki 001: Ansionmenetyskorvaus (liikennevakuutus), siihen liittyvä palkansaajamaksujen vähennys ja ennakonpidätys (pdf), 8.3.2019, versio 1.0
  2. 2. Esimerkki 002: Takautuvasti maksettava osatyökyvyttömyyseläke, kun tulonsaaja on jo saanut sairauspäivärahaa (pdf), 8.3.2019, versio 1.0
  3. Sanomaesimerkit – Tietojen toimittaminen – Etuustietoilmoitukset – ZIP,  27.6.2019, versio 1.1
    • ZIP-tiedosto, joka sisältää sanomaesimerkkeihin liittyvät xml-tiedostot. Jokaiseen esimerkkiin liittyy kaksi tiedostoa: skeema, jolla tiedot toimitetaan tulorekisteriin sekä käsittelypalaute, jonka ilmoittaja esimerkkitapauksessa saa.

Sanomaesimerkit: Tietojen toimittaminen – Aineistotilaus

Julkaistaan myöhemmin.

Esimerkkitoteutus sanoman allekirjoittamisesta

Julkaistaan myöhemmin.