Versio 1.0 Koodistot Kansallisen tulorekisterin perustamishanke
Koodistot 2 (13) Versiohistoria Versio Päivämäärä Kuvaus 1.0 12.6.2017 Dokumentti julkaistu.
Koodistot 3 (13) SISÄLLYS 1 KOODISTOT... 5 1.1 Aineiston tila (DeliveryDataStatus)... 5 1.2 Aineiston tyyppi, tulorekisteriin toimitettava (DeliveryDataType)... 5 1.3 Aineiston tyyppi, tulorekisteristä jaettava (QueryDataType)... 5 1.4 Aineistotilauksen tyyppi (SubscriptionType)... 5 1.5 Aineistotilauksen poimintaehdon tyyppi (ParameterType)... 6 1.6 Aineistotilauksen poimintaehtoluettelon tyyppi (CodeListType)... 6 1.7 Aliorganisaation tunnisteen tyyppi (SubOrgType)... 6 1.8 Ammattiluokan tai nimikkeistön tyyppi (ProfessionType)... 6 1.9 Asiointikieli (Language)... 6 1.10 Autoedun tyyppi (CarBenefitCode)... 6 1.11 Auton ikäryhmä (AgeGroupCode)... 6 1.12 Eläkevakuutuslaki (PensionActCode)... 7 1.13 Ilmoituksen tila (ReportStatus)... 7 1.14 Jakelukanava (DeliveryChannelCode)... 7 1.15 Kaikkien ilmoitusversioiden poiminta (IncludeAllVersions)... 7 1.16 Liitteen tyyppi (AttachmentType)... 7 1.17 Lokitapahtuman tyyppi (LogActivityType)... 7 1.18 Lomaketyyppi (FormCode)... 7 1.19 Maksajan tyyppi (PayerType)... 7 1.20 Maksutiedon tyyppi (ReimbPaymentType)... 8 1.21 Muun korvauksen ja edun tyyppi (RenumerationCode)... 8 1.22 Muun luontoisedun tyyppi (BenefitCode)... 8 1.23 Osoitteen tyyppi (AddressType)... 8 1.24 Palkallisen poissaolon syy (PaidAbsenceCauseCode)... 8 1.25 Palkattoman poissaolon syy (UnpaidAbsenceCauseCode)... 8 1.26 Palkkauksen muoto (PaymentType)... 9 1.27 Palvelussuhteen kesto (TermCode )... 9 1.28 Palvelussuhteen päättymisen syykoodisto (EmploymentEndingType)... 9 1.29 Palvelussuhteen päättymisen syykoodi (EmploymentEndingCode)... 9 1.30 Palvelussuhteen tyyppi (EmploymentCode)... 9 1.31 Päivärahan tyyppi (AllowanceCode)... 9 1.32 Rekisteröinnin perusteen tyyppi (EmploymentRegType)... 10 1.33 Sosiaaliturvaa koskeva todistus (PostedCertCode)... 10 1.34 Sukupuoli (Gender)... 10 1.35 Toimenpiteen tyyppi (ActionCode)... 10 1.36 Tulonsaajan lisätiedon tyyppi (IncomeEarnerType)... 10 1.37 Tulotietoilmoituksen tyyppi (ReportType)... 10 1.38 Tunnisteen tyyppi (IdType)... 10 1.39 Tuotantoympäristö (ProductionEnvironment)... 11 1.40 Työeläkelaitoksen yhtiötunnus (PensionProvIdCode)... 11 1.41 Vakuuttamisen poikkeustilanteen tyyppi (InsuranceExceptionCode)... 11 1.42 Vakuuttamistiedon tyyppi (InsuranceCode)... 12 1.43 Vastuualue (ResponsibilityCode)... 12 1.44 Viestin aihe (MessageSubjectCode)... 12 1.45 Viestin kohdeasiakkaan tyyppi (MessageIdTargetItemType)... 13 1.46 Viestin tyyppi (MessageCategory)... 13 1.47 Virheellisten tietojen käsittelyn ohjaus (FaultyControl)... 13
Koodistot 4 (13) 1.48 Yksikköpalkan yksikkö (WageUnitCode)... 13
Koodistot 5 (13) 1 KOODISTOT 1.1 Aineiston tila (DeliveryDataStatus) 0 Tuntematon 1 Vastaanotettu 2 Käsittelyssä 3 Voimassa 4 Hylätty vastaanotossa 5 Hylätty käsittelyssä 6 Mitätöity 1.2 Aineiston tyyppi, tulorekisteriin toimitettava (DeliveryDataType) 100 Palkkatietoilmoitukset 101 Työnantajan erillisilmoitukset 102 Etuustietoilmoitukset 103 Aineistotilaus 104 Viestit 105 Palkkatietoilmoitusten mitätöiminen 106 Työnantajan erillisilmoitusten mitätöiminen 107 Etuustietoilmoitusten mitätöiminen 108 Aineistotilauksen mitätöiminen 109 Palkkatietoilmoituksia sisältävän aineiston mitätöiminen 110 Työnantajan erillisilmoituksia sisältävän aineiston mitätöiminen 111 Etuustietoilmoituksia sisältävän aineiston mitätöiminen 112 Aineistotilauksen sisältävän aineiston mitätöiminen 1.3 Aineiston tyyppi, tulorekisteristä jaettava (QueryDataType) 300 Palkkatietoilmoitukset - kaikki tulonsaajat 301 Palkkatietoilmoitukset - useita tulonsaajia 302 Palkkatietoilmoitukset - useita maksajia 303 Palkkatietoilmoitukset - useita maksajia, useita tulonsaajia 304 Palkkatietoilmoitukset - useita työeläkevakuutusyhtiöitä 305 Palkkatietoilmoitukset - puuttuva työeläkejärjestelynumero 306 Työnantajan erillisilmoitukset - kaikki maksajat 307 Työnantajan erillisilmoitukset - useita maksajia 308 Työnantajan erillisilmoitukset - useita työeläkelaitoksia 309 Osapuolelle lähetetyt viestit 310 Osapuolen käyttäjien käyttölokitiedot 400 Palkkatietoilmoitukset - yksi tulonsaaja (WS reaaliaikainen) 401 Palkkatietoilmoitukset - yksi maksaja (WS reaaliaikainen) 402 Palkkatietoilmoitukset - yksi työeläkejärjestelynumero (WS reaaliaikainen) 403 Työnantajan erillisilmoitukset - yksi maksaja (WS reaaliaikainen) 404 Työnantajan erillisilmoitukset - yksi työeläkejärjestelynumero (WS reaaliaikainen) 405 Osapuolelle lähetetyt viestit (WS reaaliaikainen) 1.4 Aineistotilauksen tyyppi (SubscriptionType) 1 Kertatilaus 2 Jatkuva tilaus
Koodistot 6 (13) 1.5 Aineistotilauksen poimintaehdon tyyppi (ParameterType) Koodi Selite 2 Muutosten poimintaväli 3 Kohdekauden aikaväli 4 Maksupäivän aikaväli 5 Ansaintakauden aikaväli 6 Maksaja 7 Tulonsaaja 8 Työtapaturmavakuutuksen vakuutusnumero 9 Työeläkejärjestelynumero 10 Työeläkelaitoksen yhtiötunnus 11 Osapuoli 12 Eläkevakuutuslaki 1.6 Aineistotilauksen poimintaehtoluettelon tyyppi (CodeListType) 1 Lista tulosaajia 2 Lista maksajia 1.7 Aliorganisaation tunnisteen tyyppi (SubOrgType) 1 Kevan ilmoittajakoodisto 2 Maksajan oma koodisto 1.8 Ammattiluokan tai nimikkeistön tyyppi (ProfessionType) 1 Tilastokeskuksen ammattiluokitus (TK10) 2 Kevan nimikkeistö 3 Suomen Pankin nimikkeistö 4 Trafin nimikkeistö 1.9 Asiointikieli (Language) 1 Suomi 2 Ruotsi 3 Englanti 1.10 Autoedun tyyppi (CarBenefitCode) 1 Käyttöetu 2 Vapaa autoetu 1.11 Auton ikäryhmä (AgeGroupCode) 1 A 2 B 3 C 4 U
Koodistot 7 (13) 1.12 Eläkevakuutuslaki (PensionActCode) Koodi Selite 1 Työeläkevakuutus 2 MYEL 3 YEL 1.13 Ilmoituksen tila (ReportStatus) 1 Voimassa 2 Mitätöity 1.14 Jakelukanava (DeliveryChannelCode) 1 Tekninen rajapinta SFTP 2 Tekninen rajapinta WS reaaliaikainen 4 Tiedostojen latauspalvelu 1.15 Kaikkien ilmoitusversioiden poiminta (IncludeAllVersions) Koodi true false Selite Poimitaan kaikki ilmoitusversiot Poimitaan vain viimeisin ilmoitusversio 1.16 Liitteen tyyppi (AttachmentType) 1 txt 2 pdf/a 3 jpeg 4 png 1.17 Lokitapahtuman tyyppi (LogActivityType) 1 Tiedon hakeminen 2 Tiedon katselu 3 Tiedon lisääminen 4 Tiedon ylläpito 5 Tiedon mitätöiminen 1.18 Lomaketyyppi (FormCode) 1 NT1 2 NT2 3 Työnantajan ilmoitus ulkomaanpalkasta 4 Vuokratyöntekijän aloittamisilmoitus 1.19 Maksajan tyyppi (PayerType) 1 Julkisyhteisö 2 Kotitalous
Koodistot 8 (13) 3 Tilapäinen työnantaja 4 Ulkomainen työnantaja 1.20 Maksutiedon tyyppi (ReimbPaymentType) 1 Kela 2 Työeläkelaitos 1.21 Muun korvauksen ja edun tyyppi (RenumerationCode) 1 Päiväraha 2 Asuntoetu 3 Autoetu 4 Muu etu 1.22 Muun luontoisedun tyyppi (BenefitCode) 1 Asuntoetu 2 Puhelinetu 3 Ravintoetu 4 Muut edut 1.23 Osoitteen tyyppi (AddressType) 1 Osoite kotivaltiossa 2 Osoite työskentelyvaltiossa 1.24 Palkallisen poissaolon syy (PaidAbsenceCauseCode) 1 Sairaus 2 Osa-aikainen sairauspoissaolo 3 Äitiys-, isyys- ja vanhempainvapaa 4 Erityisäitiysvapaa 5 Kuntoutus 6 Lapsen sairaus tai pakottava perhesyy 7 Osittainen hoitovapaa 8 Koulutus 13 Virkavapaa 14 Kertausharjoitus 18 Arkipyhä 19 Pekkasvapaa 20 Työtapaturma 21 Vuosiloma 22 Osittainen poissaolo kuntoutuksen vuoksi 99 Muu syy 1.25 Palkattoman poissaolon syy (UnpaidAbsenceCauseCode) 1 Sairaus 2 Osa-aikainen sairauspoissaolo 3 Äitiys-, isyys- ja vanhempainvapaa
Koodistot 9 (13) 4 Erityisäitiysvapaa 5 Kuntoutus 6 Lapsen sairaus tai pakottava perhesyy 7 Osittainen hoitovapaa 8 Koulutus 9 Vuorotteluvapaa 10 Opintovapaa 11 Lakko tai työsulku 12 Työtarjonnan keskeytyminen 13 Virkavapaa 14 Kertausharjoitus 15 Varusmiespalvelus tai siviilipalvelus 16 Lomautus 17 Hoitovapaa 99 Muu syy 1.26 Palkkauksen muoto (PaymentType) 1 Kuukausipalkka 2 Tuntipalkka 3 Urakkapalkka 1.27 Palvelussuhteen kesto (TermCode ) 1 Toistaiseksi voimassa oleva 2 Määräaikainen 1.28 Palvelussuhteen päättymisen syykoodisto (EmploymentEndingType) 1 Kevan koodisto 2 Suomen Pankin koodisto 3 Tulorekisterin koodisto 1.29 Palvelussuhteen päättymisen syykoodi (EmploymentEndingCode) 1 Oma irtisanoutuminen 2 Muu syy 3 Henkilöstä riippuva syy 4 Tuotannolliset ja taloudelliset syyt 5 Työsuhteen päättyminen yhteisestä sopimuksesta 6 Eläkkeelle siirtyminen 1.30 Palvelussuhteen tyyppi (EmploymentCode) 1 Kokoaikainen 2 Osa-aikainen 3 Tietoa ei ole saatavilla 1.31 Päivärahan tyyppi (AllowanceCode) 1 Ateriakorvaus
Koodistot 10 (13) 2 Osapäiväraha 3 Kokopäiväraha 4 Ulkomaan päiväraha 1.32 Rekisteröinnin perusteen tyyppi (EmploymentRegType) 1 Kevan rekisteröinnin peruste 2 Suomen pankin rekisteröinnin peruste 1.33 Sosiaaliturvaa koskeva todistus (PostedCertCode) 1 Suomesta A1-todistus tai sopimus 2 Suomeen A1-todistus tai sopimus 3 EU/ETA alueen ulkopuolinen tai ei-sosiaaliturvasopimusmaa (ns. 3. maa) 1.34 Sukupuoli (Gender) 1 Nainen 2 Mies 1.35 Toimenpiteen tyyppi (ActionCode) 1 Uusi ilmoitus 2 Korvaava ilmoitus 1.36 Tulonsaajan lisätiedon tyyppi (IncomeEarnerType) 1 Valtion työllisyys- ja työttömyysetuusmäärärahoilla työllistetty 2 Osakasasemassa maksajaan 3 Osaomistaja 1.37 Tulotietoilmoituksen tyyppi (ReportType) 1 Palkkatietoilmoitus 2 Työnantajan erillisilmoitus 3 Etuustietoilmoitus 1.38 Tunnisteen tyyppi (IdType) 1 Y-tunnus 2 Henkilötunnus (suomalainen) 3 Alv-tunniste (VAT) 4 GIIN-tunniste 5 Verotunniste(TIN) 6 Kaupparekisteritunnus 7 Ulkomainen yritystunnus 9 Ulkomainen henkilötunnus 99 Muu tunnus
Koodistot 11 (13) 1.39 Tuotantoympäristö (ProductionEnvironment) Koodi true false Selite Tuotantoympäristö Testiympäristö 1.40 Työeläkelaitoksen yhtiötunnus (PensionProvIdCode) 10 Eläketurvakeskus 11 Kansaneläkelaitos 20 Keva 24 Ålands landskapsregering 25 Kirkon keskusrahasto 27 Suomen Pankki 29 Kelan toimisuhde-eläkkeet 30 Valtion eläkkeet 34 Merimieseläkekassa 35 Maatalousyrittäjien eläkelaitos 40 Försäkringsaktiebolaget Pensions-Alandia 46 Keskinäinen Eläkevakuutusyhtiö Ilmarinen 54 Keskinäinen Työeläkevakuutusyhtiö Elo 55 Keskinäinen työeläkevakuutusyhtiö Varma 56 Eläkevakuutusosakeyhtiö Veritas 90 Keskinäinen Eläkevakuutusyhtiö Etera 70014 Kymin Eläkesäätiö 70047 Sanoman Eläkesäätiö 70072 Sandvik Eläkesäätiö 70074 Maataloustuottajain eläkesäätiö 70076 Kontinon yhteiseläkesäätiö 70077 Eläkesäätiö Polaris Pensionsstiftelse 70078 Yleisradion eläkesäätiö 70088 Abb Eläkesäätiö 70093 L-Fashion Group Oy:n eläkesäätiö 70109 Honeywell Oy:n Henkilökunnan Eläkesäätiö 70195 Vr Eläkesäätiö 70199 Soneran Eläkesäätiö 70200 Yara Suomen Eläkesäätiö 70202 Orionin Eläkesäätiö 70205 Nordean eläkesäätiö 80001 Valion Eläkekassa 80005 Op-Eläkekassa 80008 Eläkekassa Verso 80009 Apteekkien Eläkekassa 80012 Liikennepalvelualojen Eläkekassa Viabek 80014 Reka Eläkekassa 1.41 Vakuuttamisen poikkeustilanteen tyyppi (InsuranceExceptionCode) 1 Ei vakuuttamisvelvollisuutta (työeläke-, sairaus-, työttömyys- sekä työtapaturma- ja ammattitautivakuutus) 2 Ei vakuuttamisvelvollisuutta (sairausvakuutus) 3 Ei vakuuttamisvelvollisuutta (työeläkevakuutus) 4 Ei vakuuttamisvelvollisuutta (työtapaturma- ja ammattitautivakuutus) 5 Ei vakuuttamisvelvollisuutta (työttömyysvakuutus) 6 Ei kuulu Suomen sosiaaliturvan soveltamispiiriin (työeläke-, sairaus-, työttömyys- sekä työtapaturma- ja ammattitautivakuutus) 7 Ei kuulu Suomen sosiaaliturvan soveltamispiiriin (työeläkevakuutus) 8 Ei kuulu Suomen sosiaaliturvan soveltamispiiriin (työtapaturma- ja ammattitautivakuutus) 9 Ei kuulu Suomen sosiaaliturvan soveltamispiiriin (työttömyysvakuutus) 10 Ei kuulu Suomen sosiaaliturvan soveltamispiiriin (sairausvakuutus)
Koodistot 12 (13) 11 Vapaaehtoinen vakuuttaminen Suomessa (työeläkevakuutus) 1.42 Vakuuttamistiedon tyyppi (InsuranceCode) 1 Sosiaalivakuutusmaksujen alainen (koodit 2-6) 2 Työeläkevakuutusmaksun alainen 3 Sairausvakuutusmaksun alainen 5 Työttömyysvakuutusmaksun alainen 6 Työtapaturma- ja ammattitautivakuutusmaksun alainen 1.43 Vastuualue (ResponsibilityCode) 1 Sisällölliset asiat 2 Tekniset asiat 1.44 Viestin aihe (MessageSubjectCode) Koodi Aihealue Aihe Osapuoli voi lähettää 1 Aineistotilaus Aineistotilaus on ladattavissa sähköisessä asiointipalvelussa X 2 Aineistotilaus Aineistotilaus X X 3 Aineistotilaus Aineistotilaus on virheellinen X X 4 Aineistotilaus Aineistotilaus on puutteellinen X 5 Aineistotilaus Aineistotilaukseen ei ole oikeutta X 6 Aineistotilaus Muu aineistotilauksiin liittyvä asia X X 7 Ilmoittaminen Ilmoitustiedot ovat virheelliset X X 8 Ilmoittaminen Tulotietojen ilmoittaminen X X 9 Ilmoittaminen Tuplailmoitus havaittu X 10 Ilmoittaminen Tietojen toimittaminen virheettömästi Tulorekisteriin X 11 Ilmoittaminen Ilmoituksen antamisen eräpäivä X 12 Ilmoittaminen Ilmoitustietojen korjaaminen X 13 Ilmoittaminen Ilmoitustietojen poistaminen X 14 Ilmoittaminen Muu tietojen ilmoittamiseen liittyvä asia X X 15 Perustiedot Perustietojen päivityspyyntö X X 16 Perustiedot Muu perustietoihin liittyvä asia X X 17 Sopimusasiat Uusi sopimus X X 18 Sopimusasiat Sopimustietojen päivitys X X 19 Sopimusasiat Muu sopimusasioihin liittyvä asia X X 21 Tekniset asiat Tekninen ongelma lähetyksessä X X 22 Tekniset asiat Tekninen ongelma vastaanotossa X X 23 Tekniset asiat Teknisen palvelurajapinnan käyttö X X 24 Tekniset asiat Sähköisen asiointipalvelun käyttö X X 25 Tekniset asiat Käyttöoikeudet ja käyttövaltuudet X X 26 Tekniset asiat Tunnistaminen ja käyttövaltuudet X X 27 Tekniset asiat Tiedote sovelluspäivityksistä X 28 Tekniset asiat Muut tekniset asiat X X 29 Yleiset asiat Toimintaohjeistus X 30 Yleiset asiat Tiedote käyttökatkosta X 31 Yleiset asiat Tiedote häiriötilanteesta X 32 Yleiset asiat Tiedote toimintamenettelyn muutoksesta X 33 Yleiset asiat Asiakirjojen välitys X 34 Yleiset asiat Muut yleiset asiat X X 35 Aineistotilaus Palaute X X 36 Ilmoittaminen Palaute X X 37 Perustiedot Palaute X X 38 Sopimustiedot Palaute X X 39 Tekniset asiat Palaute X X 40 Yleiset asiat Palaute X X Osapuoli voi vastaanottaa
Koodistot 13 (13) 1.45 Viestin kohdeasiakkaan tyyppi (MessageIdTargetItemType) Koodi Selite 1 Tulonsaaja 2 Maksaja 1.46 Viestin tyyppi (MessageCategory) Osapuoli voi lähettää Osapuoli voi vastaanottaa 1 Ilmoitus X X 2 Ohjauspyyntö X X 3 Pyyntö X X 4 Tilaus X X 5 Virheilmoitus X X 6 Neuvonta X 7 Ohje X 8 Selvityspyyntö X 9 Tiedote X 10 Valvontaviesti X 1.47 Virheellisten tietojen käsittelyn ohjaus (FaultyControl) 1 Vain virheelliset kohteet (ilmoitukset, viestit, mitätöintitiedot) hylätään 2 Koko aineisto hylätään 1.48 Yksikköpalkan yksikkö (WageUnitCode) 1 Tunti 2 Päivä 3 Viikko 5 Jakso