1 (5) Tulorekisteriyksikkö TOIMITUSSELOSTE PL 5 Tulorekisteri 1.1.2019 00055 TULOREKISTERI TULOREKISTERIN TOIMITUSSELOSTE 31.12.2018 Tulorekisteri otetaan käyttöön 1.1.2019 klo 12. Tulorekisterin tuotantoversio 1.1.2019 sisältää tulorekisterin toiminnallisuudet palkkatietojen osalta. Ilmoittamisen kanavat: tekninen rajapinta, sähköinen asiointipalvelu (verkkolomake ja tiedostojen lähettäminen latauspalvelussa), ilmoittaminen paperilomakkeella. Jakelun kanavat: tekninen rajapinta, sähköinen asiointipalvelu. Sähköinen asiointipalvelu on toteutettu kolmella kielellä (suomi, ruotsi, englanti). Sähköisessä asiointipalvelussa on tiedon tuottajien (suorituksen maksajien), tiedon käyttäjien ja kansalaisen näkymät. Tulorekisterin sähköinen asiointipalvelu on käytettävissä kaikkina vuorokaudenaikoina. Palveluun kirjaudutaan sivulta tulorekisteri.fi. TIEDON TUOTTAJIEN PALVELUT Teknisen rajapinnan palvelut tiedon tuottajille: Palkkatietoilmoitus (uusi, korvaava ja mitätöivä ilmoitus) o WS reaaliaikainen, yksi ilmoitus kerrallaan o WS viivästetty o SFTP viivästetty Työnantajan erillisilmoitus (uusi, korvaava ja mitätöivä ilmoitus) o WS reaaliaikainen, yksi ilmoitus kerrallaan o WS viivästetty o SFTP viivästetty Palkkatietoilmoituksia sisältävä aineisto, Työnantajan erillisilmoituksia sisältävä aineisto (aineiston mitätöiminen) Aineistotilaus (uusi tilaus, tilauksen mitätöinti) o WS reaaliaikainen, yksi aineistotilaus kerrallaan o WS viivästetty, yksi aineistotilaus kerrallaan
2 (5) o SFTP viivästetty, yksi aineistotilaus kerrallaan Aineistotilauksen sisältävä aineisto (aineiston mitätöiminen) Sähköisen asiointipalvelun toiminnot tiedon tuottajille: Palkkatietoilmoitus ja työnantajan erillisilmoitus (tietojen ilmoittaminen, korjaaminen ja mitätöinti) o Palkkatietoilmoituksen sisältö on jaettu osiin: palkkatietoilmoitus tiedot kansainvälisestä työskentelystä vuokratyöntekijän aloittamisilmoitus Aineistojen haku ja katselu, tulorekisteriin teknisen rajapinnan ja latauspalvelun kautta lähetetyt aineistot Annettujen ilmoitusten haku ja katselu, kaikkien kanavien kautta tulorekisteriin annetut ilmoitukset Yrityksen tulotietojen haku ja katselu: kaikkien kanavien kautta tulorekisteriin annetut ilmoitukset, joissa yritys on tulonsaajana Määrämuotoisten raporttien tilaaminen ja tehtyjen tilausten katselu Latauspalvelu: Latauspalvelussa voi lähettää XML-muotoisia tiedostoja TIEDON KÄYTTÄJIEN PALVELUT Teknisen rajapinnan palvelut tiedon käyttäjille: Aineistotilaus (uusi tilaus, tilauksen mitätöinti) o WS reaaliaikainen, yksi aineistotilaus kerrallaan o WS viivästetty, yksi aineistotilaus kerrallaan o SFTP viivästetty, yksi aineistotilaus kerrallaan Aineistotilauksen sisältävä aineisto (aineiston mitätöiminen) Sähköisen asiointipalvelun toiminnot tiedon käyttäjille: Tulorekisteriin ilmoitettujen tietojen haku ja katselu organisaation tiedonsaantioikeuksien mukaisesti Raporttien tilaaminen ja tehtyjen tilausten katselu Aineistojen haku ja katselu, tulorekisteriin teknisen rajapinnan ja latauspalvelun kautta lähetetyt aineistot Latauspalvelu: Latauspalvelussa voi lähettää XML-muotoisia tiedostoja
3 (5) KANSALAISEN PALVELUT Sähköisen asiointipalvelun toiminnot kansalaiselle: Omien tulotietojen haku ja katselu Kotitaloustyönantaja: palkkatietoilmoitus ja työnantajan erillisilmoitus (tietojen ilmoittaminen, korjaaminen ja mitätöinti) o Palkkatietoilmoituksen sisältö on jaettu osiin: palkkatietoilmoitus tiedot kansainvälisestä työskentelystä vuokratyöntekijän aloittamisilmoitus. Kotitaloustyönantaja: Annettujen ilmoitusten haku ja katselu, kaikkien kanavien kautta tulorekisteriin annetut ilmoitukset Latauspalvelu: Latauspalvelussa voi lähettää XML-muotoisia tiedostoja RAJAUKSET PALVELUIHIN: Sähköinen asiointipalvelu: Toisen yksityishenkilön puolesta asiointi otetaan käyttöön 11.1.2019. Raportit: Maksajan käyttölokitiedot -raportin voi tilata 11.1.2019 alkaen teknisen rajapinnan tai latauspalvelun kautta. Kansalainen: Tulonsaajan tulorekisteriotteen voi tilata sähköisessä asiointipalvelussa 25.1.2019 alkaen. Aineistotilausta tai aineistotilauksen sisältävää aineistoa ei voi mitätöidä, jos aineistopoiminta on jo käynnistetty. Jos aineistotilaus pitää päättää tai poiminta keskeyttää, kun poiminta on jo aloitettu, ota yhteys tulorekisterin asiakaspalveluun tai täytä havaintolomake. Viestit-toiminnallisuus otetaan vaiheittain käyttöön vuoden 2019 aikana. Perustietojen ylläpito sähköisessä asiointipalvelussa otetaan käyttöön myöhemmin. Nyt palvelussa ovat perusrekistereistä saadut tiedot. Raportit: Sähköisessä asiointipalvelussa ei voi tilata kaikkia samoja raportteja kuin rajapinnassa ja latauspalvelussa. Sähköisessä asiointipalvelussa tilattavat raportit ovat 600 ja 610. Kotitaloustyönantaja: Lähetetyt aineistot -toiminnallisuus. Lähetettyjä ilmoituksia voi katsella Annetut ilmoitukset -näkymässä. Tunnetut puutteet sähköisessä asiointipalvelussa Latauspalvelu: Aineistotilauksissa käsittelypalautteeseen muodostuu <ItemVersion>0</ItemVersion>, joka ei ole palautteen skeeman mukainen. Tämä pitää ottaa huomioon vastaanottavassa järjestelmässä, jos käyttäjä haluaa ladata käsittelypalautteen omaan järjestelmäänsä. Virhe korjataan mahdollisimman pian.
4 (5) Latauspalvelu: Käsittelypalautteesta puuttuu <IRItemId> tiedot silloin, kun kyse on palkkatietoilmoituksen tai työnantajan erillisilmoituksen mitätöinnistä. Tämä tarkoittaa, että palautesanomasta ei käy ilmi, mitkä ilmoitukset (ilmoitusviitteet) on mitätöity aineiston perusteella. Latauspalvelu: Käsittelypalautteessa lukee virheellisesti "palkkatietoilmoitukset" tilanteissa, joissa kyse on erillisilmoituksien mitätöinnistä. Virheilmoitukset ovat yleisiä eivätkä yksilöi virhettä kaikissa tilanteissa. Osa virheilmoituksista on englanniksi. Latauspalvelu: mitätöinnin yhteydessä alkuperäinen tiedosto muutetaan tilaan hylätty. Annetut ilmoitukset: Poissaolotietojen haku palauttaa virheellisesti palkkatietoilmoitusten lisäksi työnantajan erillisilmoituksia. Poissaolotietojen haku on rajattava koskemaan vain palkkatietoilmoituksia, muuten haku palauttaa tulokseksi myös työnantajan erillisilmoituksia haetulla aikavälillä. Annetut ilmoitukset: sivulla näkyvissä tulolajien yhteenlasketuissa määrissä ei ole huomioitu takaisinperintänä toimitettuja osuuksia. Esimerkiksi palkka yhteissumma 133,00 euroa ja Palkka yhteissumma takaisinperintä 33,00 euroa tuottaa tiedon: Palkka yhteissumma 166,00 euroa). Raportit: 600 Maksajan palkkatietojen yhteenveto (kertatilaus) ja 602 Maksajan palkkatietoilmoitusten yhteenveto (kertatilaus) muodostetaan 1.1.2019 julkaistavassa versiossa dokumentin Raportit tulorekisteristä (versio 1.01, 26.9.2018) perusteella. Tulolajin 407 laskentasääntöön on tulossa muutos, joka toteutetaan myöhemmin. Raportit toimitetaan suomeksi, vaikka asiointikieli olisi ruotsi tai englanti tai sähköistä asiointipalvelua käytettäisiin ruotsiksi tai englanniksi. Sähköinen asiointipalvelu aukeaa aina suomeksi, vaikka asiakas siirtyisi palveluun ruotsin- tai englanninkieliseltä tulorekisteri.fi-sivulta. Kielen voi vaihtaa sähköisen asiointipalvelun etusivulla ruotsiksi tai englanniksi. Sähköisen asiointipalvelun virheilmoitukset näytetään suurimmassa osassa tapauksia sillä kielellä, jolla sähköistä asiointipalvelua käytetään, mutta tietyt virheilmoitukset näytetään vain englanniksi. Sähköinen asiointipalvelu: Kun aikaisemmin annettua ilmoitusta korjataan, ja ilmoituksella on annettu esimerkiksi autoedun tyyppi tai päivärahan tyyppi, näitä tietoja ei esitäytetä korjattavalle ilmoitukselle. Käyttäjän pitää tarkistaa, että kaikki tiedot on esitäytetty oikein ja korjata niitä tarvittaessa. Sähköisen asiointipalvelun kieliversiot: englanninkielisessä asiointipalvelussa on käännöspuutteita. Yleiset huomiot 1.1. käyttöönotossa tuetaan Google Chrome -selainta. Muiden selainten esimerkiksi IE tai Firefox käyttöä ei suositella. Palvelun käyttämistä matkapuhelimella tai tabletilla tuetaan rajoitetusti. Sähköinen asiointipalvelu kirjaa käyttäjän ulos, jos palvelua ei käytetä 30 minuuttiin. Sähköisessä asiointipalvelussa palkkatietoilmoituksen sisältö on jaettu osiin: palkkatietoilmoitus
5 (5) tiedot kansainvälisestä työskentelystä vuokratyöntekijän aloittamisilmoitus Rajapinnan ja latauspalvelun kautta annetaan kerralla koko palkkatietoilmoituksen tietosisältö, jolloin yksittäisessä ilmoituksessa voi olla mukana varsinaisten palkkatietojen lisäksi myös kansainvälisiin tilanteisiin liittyviä tietoja tai vuokratyöntekijän aloittamisilmoituksen tiedot. Sähköisessä asiointipalvelussa nämä tiedot on jaettu usealle eri ilmoitukselle. Jos korjaa sähköisessä asiointipalvelussa ilmoitusta, joka on annettu teknisen rajapinnan tai latauspalvelun kautta, on otettava huomioon, että osa ilmoituksen tiedoista saattaa näkyä palkkatietoilmoituksella ja osa ilmoituksella tiedot kansainvälisestä työskentelystä tai vuokratyöntekijän aloittamisilmoituksella. Sähköinen asiointipalvelu: Aliorganisaation tunnistetta voi käyttää tietojen näkyvyyden rajaamiseen sähköisessä asiointipalvelussa. Aliorganisaation tunniste on huomioitu kirjautumisessa ja ilmoitusten, tilausten ja aineistojen näkymisessä. Uutta ilmoitusta tai raporttitilausta tehtäessä vastuu aliorganisaation tunnisteen käyttämisestä on käyttäjällä. Jos aliorganisaation tunnistetta ei anneta uudella ilmoituksella tai raporttitilauksella, eivät nämä ilmoitukset tai tilaukset näy sellaiselle henkilölle, jolle on tulorekisteriin kirjautumiseen määritelty rajaustarkenteeksi aliorganisaation tunniste. Tulorekisterin ilmoittamisen paperilomakkeet ovat kolmella kielellä (suomi, ruotsi, englanti) osoitteessa www.vero.fi/tulorekisteri/lomakkeet. Lisätietoa Lisätietoa tulorekisteristä osoitteessa www.tulorekisteri.fi