1(30) SISÄLLYSLUETTELO 1 Yleistä sähköisen asiointipalvelun testauksesta... 4 2 Testauksen aloitus... 4 2.1 Testaussopimus... 4 2.2 Sähköisen asiointipalvelun testauksen aloitus... 4 3 Testiaineistot... 5 3.1 Yleistä testitunnuksista... 5 3.2 Tulorekisterin testiasiakasaineistot... 5 3.3 Sidosryhmän omien testiasiakkaiden lisäys tulorekisterin sidosryhmätestausympäristöön... 6 3.3.1 Toimitettavan aineiston muodostus... 7 3.4 Koodistot... 7 4 Latauspalvelun testaus... 7 4.1 Kuka voi testata latauspalvelua... 7 4.2 Tiedoston muotovaatimukset... 8 4.3 Latauspalvelussa käytössä olevat tiedon tuottajan palvelut... 8 4.4 Latauspalvelun toiminnot... 8 4.5 Latauspalvelun virhetilanteet... 9 5 Ilmoittaminen, verkkolomakkeet... 9 5.1 Ilmoitusten täyttäminen... 10 5.1.1 Maksajan tiedot... 10 5.1.2 Ilmoituksen tiedot... 11 5.1.3 Esikatselu... 12 5.1.4 Vastaanottokuittaus... 12 5.1.5 Virhetilanteet... 13 5.2 Palkkatietoilmoitus... 13 5.3 Työnantajan erillisilmoitus... 13 6 Ilmoitusten haku ja katselu... 14 6.1 Haun tarkentaminen... 15 6.2 Ilmoituksen korjaaminen... 16 6.3 Käytä ilmoitusta uuden pohjana... 17 6.4 Ilmoituksen mitätöinti... 17 7 Aineistojen haku ja katselu... 18 8 Tunnistautuminen ja valtuudet... 19 8.1 Tiedon tuottajan testitunnukset... 19 8.2 Tiedon tuottajan kirjautuminen sähköiseen asiointipalveluun... 20 8.3 Suomi.fi-tunnistautuminen... 20
2(30) 8.4 Asiointi oman organisaation puolesta... 22 8.5 Tiedon tuottajan valtuudet... 22 8.5.1 Suomi.fi-valtuudet... 23 8.6 Asiointi asiakkaan puolesta (esimerkiksi tilitoimisto)... 26 8.6.1 Erityisryhmät ja valtuuttaminen Katso-palvelussa... 26 9 Testausprosessi... 27 10 Havaintojen raportointi... 27 10.1 Ohje havaintolomakkeen kenttien täyttöön... 27 10.2 Esimerkki kirjatusta havainnosta... 28 10.3 Havainnon ohjaus korjaukseen... 28 10.4 Virhe, joka estää testaamisen... 29 10.5 Muutospyyntö... 29 10.6 Toimitusseloste... 29 10.7 Viimeinen julkaisu sidosryhmätestausympäristöön... 30 11 Testauksen lopettaminen... 30 12 Lisätietoa... 30 VERSIOHISTORIA Versio Päivämäärä Kuvaus 1.0 9.4.2018 Dokumentti julkaistu. 1.1 14.8.2018 Täydennetty dokumenttiin sähköisen asiointipalvelun toiminnallisuudet: - Ilmoittaminen - Ilmoitusten haku ja katselu - Aineistojen haku ja katselu Poistettu dokumentista tiedon käyttäjien testausta koskevat osiot. Tiedon käyttäjille toimitetaan oma sähköisen asiointipalvelun testausohje. Toimitusselosteen julkaisuajankohtaa muutettu.
3(30) KESKEISET TERMIT JA NIIDEN SELITTEET Termi Asiakasaineisto Selite Tulorekisterin sidosryhmätestauksessa käytettävä anonymisoitu aineisto, joka koostuu testiasiakkaiden tiedoista. Testaava organisaatio Tulorekisterin sidosryhmätestaukseen osallistuva yritys tai organisaatio. Testauksen yhteyshenkilö Testaavan organisaation ensisijainen yhteyshenkilö tulorekisterin testaukseen liittyvissä asioissa. Testauksen yhteyshenkilöitä voi olla vain yksi, mutta testaamista tekeviä henkilöitä voi olla useita. Testauksen yhteyshenkilölle lähetetään testaukseen liittyvät tiedotteet ja kyselyt, sekä testauksessa tarvittavat testiaineistot ja testiosoitteet. Tiedon käyttäjät Sellaiset toimijat, joilla on lainsäädäntöön perustuva oikeus saada tulorekisteristä tulo- tai muita tietoja oman tehtävänsä hoitamiseen. Ensimmäisessä vaiheessa 1.1.2019 lähtien tiedon käyttäjiä ovat Verohallinto, Kela, Työttömyysvakuutusrahasto (TVR) sekä työeläkelaitokset ja ETK. Toisessa vaiheessa 1.1.2020 lähtien tiedon käyttäjiä ovat lisäksi mm. Tilastokeskus, Koulutusrahasto, vahinkovakuuttajat, työttömyyskassat, TEMin hallinnonala, kunnat ja työsuojeluviranomainen. Tiedon tuottajat Kaikki yritykset ja muut toimijat, joilla on palkka-, eläke- tai etuustietojen ilmoitusvelvollisuuksia Suomeen jollekin tulorekisterin tiedon käyttäjälle. Testaussopimus Sopimus, jonka sidosryhmä tekee Verohallinnon kanssa tulorekisterin rajapintojen ja sähköisen asiointipalvelun testaamisesta sidosryhmätestausympäristössä. Tiedon käyttäjät tekevät erillisen testaussopimuksen. Tiedon tuottajien testaussopimus tehdään hyväksymällä sidosryhmätestausympäristön käyttöehdot.
4(30) 1 YLEISTÄ TESTAUKSESTA Tulorekisterin sähköistä asiointipalvelua testataan kahdessa vaiheessa. Ensimmäisessä vaiheessa sidosryhmätestaukseen julkaistiin 14.5.2018 tulorekisterin latauspalvelu. Sähköisen asiointipalvelun seuraavat toiminnallisuudet julkaistiin sidosryhmien testattavaksi 13.8.2018. Sähköisen asiointipalvelun testauksesta on julkaistu erillinen sidosryhmätestaussuunnitelma 31.5.2018. Testauksen 14.5.2018 aloittivat palkkatiedon tuottajat sekä ne tulorekisterin tiedon käyttäjien organisaatiot, jotka aloittavat palkkatietojen käyttämisen 2019 käyttöönotossa. Nämä sidosryhmät voivat aloittaa sähköisen asiointipalvelun muiden toiminnallisuuksien testaamisen 13.8.2018. Muiden sidosryhmien latauspalvelun ja sähköisen asiointipalvelun testaus on vaiheistettu alkamaan 1.10.2018 ja 1.2.2019 välisenä aikana. 2 TESTAUKSEN ALOITUS 2.1 Testaussopimus Testaussopimukset ovat sisällöltään erilaisia riippuen siitä, tekeekö sidosryhmä testaussopimuksen tiedon tuottajana vai tiedon käyttäjänä. Jos sidosryhmä toimii sekä tuottajan että käyttäjän roolissa, sopimukset on tehtävä erikseen tuottajan testaukseen ja käyttäjän testaukseen. Tiedon käyttäjien kanssa testauksesta ja sopimuksista sovitaan erikseen. Testaussopimuksessa sovitaan sekä rajapintojen että sähköisen asiointipalvelun käytöstä. Tiedon tuottajat ilmoittautuvat tulorekisterin testaajiksi toimittamalla allekirjoitetun ja skannatun sopimuksen osoitteeseen YHT_Tulorekisteri_testaus@vero.fi. Täytettävä sopimuspohja on saatavilla tulorekisteri.fi-sivustolla. Tulorekisterihanke lähettää kuittauksen sähköpostilla, kun sopimus on vastaanotettu. Kun sopimus on käsitelty tulorekisterihankkeessa, sopimuksessa ilmoitetulle testauksen yhteyshenkilölle lähetetään sähköpostitse testauksessa tarvittavat tiedot. Sopimus täytyy tehdä kaksi viikkoa ennen suunniteltua testauksen aloittamista. 2.2 Sähköisen asiointipalvelun testauksen aloitus Testaaja voi kirjautua sähköiseen asiointipalveluun sen jälkeen, kun testaava organisaatio on tehnyt seuraavat toimenpiteet: - Testaava organisaatio on hyväksynyt tulorekisterin sidosryhmätestausympäristön käyttöehdot. - Testaussopimuksessa nimetty testauksen yhteyshenkilö on pyytänyt sähköpostilla osoitteesta yht_tulorekisteri_testaus@vero.fi testitunnukset, joilla hän tunnistautuu tulorekisterin sähköisen asiointipalvelun testausympäristöön.
5(30) - Testitunnukset toimitetaan testauksen yhteyshenkilölle kolmen arkipäivän kuluessa pyynnöstä. - Testauksessa käytettävä asiakasaineisto toimitetaan testauksen yhteyshenkilölle testitunnusten lähettämisen yhteydessä. - Testaava organisaatio on tehnyt tarvittavat valtuutukset Suomi.fivaltuuksien testausympäristössä. 3 TESTIAINEISTOT 3.1 Yleistä testitunnuksista Sähköisen asiointipalvelun testauksessa palkkatietoilmoituksia ja työnantajan erillisilmoituksia voi ilmoittaa vain niille keinotekoisille Y- tunnuksille, joihin testaajalla on valtuudet Suomi.fi- tai Katso-palvelussa. Sähköisen asiointipalvelun testausta varten jokaiselle palkkatietojen ilmoittamista testaavalle organisaatiolle toimitetaan kaksi Y-tunnusta, joilla palvelua voi testata. Jos palkkatiedon tuottaja osallistuu rajapintatestaukseen, tuottaja käyttää myös sähköisen asiointipalvelun testauksessa toisena Y-tunnuksena samaa keinotekoista Y-tunnusta, jota se käytti rajapintaan tarvittavassa varmenteessa. Tuottaja saa sähköisen asiointipalvelun testausta varten tähän Y-tunnukseen liittyvän keinotekoisen henkilötunnuksen sekä toisen keinotekoisen Y-tunnuksen ja henkilötunnuksen. Nämä keinotekoiset henkilötunnukset toimivat ns. yrityksen nimenkirjoitusoikeudellisina edustajina. Lisäksi testaava organisaatio saa yhden tai kaksi henkilötunnusta valtuutuksien testaamista varten. Jos tiedon tuottaja tarvitsee lisää testitunnuksia, niitä pitää erikseen pyytää tulorekisterihankkeelta osoitteesta yht_tulorekisteri_testaus@vero.fi. Pelkkää sähköistä asiointipalvelua testaaville tiedon tuottajille toimitetaan kaksi keinotekoista Y-tunnusta ja niihin liittyvät henkilötunnukset. Lisäksi testaava organisaatio saa yhden tai kaksi henkilötunnusta valtuutuksien testaamista varten. Käytännön toimenpiteet tunnusten saamiseksi on kuvattu luvussa 8. 3.2 Tulorekisterin testiasiakasaineistot Tulorekisterihankkeen testiasiakasaineisto koostuu sekä henkilötunnuksista, joihin on liitetty etunimi ja sukunimi, että Y-tunnuksista, joissa on oikeushenkilön (esim. OY, Oyj) nimitieto. Testiasiakasaineisto on muunnettu tunnistamattomaksi niin, ettei testiasiakasaineistoa pysty palauttamaan alkuperäiseksi jonkin arvon tai esimerkiksi salausavaimen avulla. Näin ollen testiasiakasaineisto täyttää GDPR:n (= 25.5.2018 voimaan tuleva EU:n laajuinen tietosuoja-asetus, EU general data pro-tection regulation 2016/679) mukaiset vaatimukset eikä näiden tietojen perusteella voida lisätietoja käyttämällä yhdistää tietojen koskevan tunnistettavissa olevaa luonnollista henkilöä. Testiasiakkaiden henkilö- ja Y-tunnukset on
6(30) anonymisoitu siten, että ne ovat muodollisesti oikeanlaisia ja läpäisevät tarkistukset. Ohje testiaineiston anonymisoinnista ks. Liite 7. Testaussopimuksen käsittelyn jälkeen sidosryhmän ilmoittamalle testauksen yhteyshenkilölle lähetetään sähköpostitse (pdf-tiedosto) testauksessa käytettävät anonymisoidut Y-tunnukset ja henkilötunnukset nimitietoineen. Palkkatietoilmoitusten lähettäminen ei edellytä saman nimen käyttämistä, mutta on silti suositeltavaa käyttää tulorekisterihankkeen ilmoittamia nimiä. Sidosryhmät voivat itse valita, kuinka monta palkansaajaa kullakin Y- tunnuksellisella maksajalla on. Jokaiselle testaavalle sidosryhmälle toimitetaan 200 keinotekoista henkilötunnusta sopimuksen tekemisen jälkeen. Tiedon tuottaja käyttää näitä keinotekoisia henkilötunnuksia palkansaajina testauksessa. Jos tiedon tuottaja haluaa lisäksi käyttää omia keinotekoisia henkilötunnuksiaan testauksessa, ne pitää lisätä tulorekisterin testausympäristöön. Katso lisätietoa luvussa 3.3. Sidosryhmän omien testiasiakkaiden lisäys tulorekisterin sidosryhmätestausympäristöön. 3.3 Sidosryhmän omien testiasiakkaiden lisäys tulorekisterin sidosryhmätestausympäristöön Tulorekisterihanke toimittaa testauksen alkaessa sidosryhmälle testiasiakkaita. Tulorekisterihanke voi tarvittaessa viedä myös sidosryhmän omia anonymisoituja testiasiakkaita eli palkansaajia tulorekisterin sidosryhmätestausympäristöön. Omia testiasiakkaita voi toimittaa kohtuullisen määrän. Tätä varten sidosryhmä toimittaa asiakastiedot Excel taulukkona (.xlsx) tulorekisterihankkeelle. Tiedostot lähetetään osoitteeseen YHT_Tulorekisteri_testaus@vero.fi. Tiedostossa lähetetyt testiasiakkaat ovat käytettävissä viimeistään kolmantena arkipäivänä saapumispäivästä. Jos sidosryhmän ilmoittama testiasiakas on jo tulorekisterin sidosryhmätestausympäristössä (esimerkiksi sama henkilötunnus eri nimellä), olemassa olevan testiasiakkaan tietoja ei muuteta tulorekisterin sidosryhmätestausympäristöön. Tunnus löytyy jatkossakin niillä tiedoilla, joilla se on testausympäristöön ensimmäisen kerran lisätty. Sidosryhmälle ilmoitetaan, mitkä heidän toimittamistaan testiasiakkaista on lisätty tulorekisterin sidosryhmätestausympäristöön ja mitkä tunnukset mahdollisesti olivat jo ennestään sidosryhmätestausympäristössä. Jotta testiasiakasaineistoja on helpompi hallita, käytä lähetettävän tiedoston nimessä lähettävän organisaation nimeä. Muodosta lähetettävän tiedoston nimi seuraavasti: organisaation nimi tunnusten tyyppi testiasiakkaat. Esimerkiksi: Kela_henkilötunnukset_testiasiakkaat1.xlsx / Arek_y_tunn_testiasiakkaat1.xlsx Anna lähetettävälle tiedostolle numero, jotta jatkossa voidaan tarvittaessa lähettää useampia saman tyyppisiä testiasiakasaineistoja.
7(30) 3.3.1 Toimitettavan aineiston muodostus Sidosryhmän oman testiaineiston muodostamista varten henkilötunnukset toimitetaan tulorekisterihankkeelle Excel-tiedostona. Jokaisen testiasiakkaan tiedot annetaan nimetyn sarakkeen mukaisesti ja omalla rivillään. Henkilöasiakkaat Testiasiakkaille, joilla on henkilötunnus, ilmoitetaan seuraavat tiedot tässä sarakejärjestyksessä (A,B,C): Henkilötunnus, Etunimi/etunimet, Sukunimi 3.4 Koodistot Sidosryhmätestauksessa käytettävät tulorekisterin koodistot on kuvattu dokumentissa Koodistot (pdf). Eri tulolajien koodit luetellaan dokumentissa Koodistot Tulolajit (pdf). Ulkoisissa koodistoissa käytetään sidosryhmätestausvaiheessa samoja koodistoja kuin tuotannossakin. Eri tilanteissa käytettävät koodistot on kuvattu skeemojen sisältökuvauksissa. Skeemojen sisältökuvaukset ovat tulorekisteri.fi-sivuston dokumentaatiossa. 4 LATAUSPALVELUN TESTAUS Tulorekisterin sähköisen asiointipalvelun latauspalvelussa tiedon tuottaja voi ladata tulorekisteriin talletettavaksi tulorekisterin rajapintadokumenttien ja skeemojen mukaisia xml-muotoisia tiedostoja. Tulorekisterin tiedon käyttäjä voi tehdä latauspalvelussa aineistotilauksia. Tulorekisterin latauspalvelu on yhdensuuntainen palvelu, jossa sidosryhmä lähettää tiedostoja tulorekisteriin ja saa lähettämistään aineistoista käsittelypalautteen. Aineistojen nouto ei ole mahdollista latauspalvelun kautta. Latauspalvelun kautta ladattavia aineistoja ei tarvitse allekirjoittaa varmennetta käyttämällä. 4.1 Kuka voi testata latauspalvelua Latauspalvelua voivat testata kaikki palkkatiedon tuottajat, esimerkiksi tilitoimistot, yritykset sekä kunnat, yhdistykset, yhtymät ja ulkomaiset organisaatiot. Latauspalvelua voivat testata myös tulorekisterin tiedon käyttäjät, jotka tekevät latauspalvelun kautta aineistotilauksia.
8(30) 4.2 Tiedoston muotovaatimukset Latauspalveluun ladattavaksi tarkoitetun tiedoston on oltava XMLmuotoinen. Tiedoston tarkemmat vaatimukset on kuvattu tulorekisterin skeemavaatimuksissa. https://www.vero.fi/tulorekisteri/ohjelmistokehittäjät/dokumentaatio/ 4.3 Latauspalvelussa käytössä olevat tiedon tuottajan palvelut Palkkatietoilmoitus, uusi ja korvaava ilmoitus Palkkatietoilmoituksen mitätöinti Palkkatietoilmoituksia sisältävän aineiston mitätöinti Työnantajan erillisilmoitus, uusi ja korvaava ilmoitus Työnantajan erillisilmoituksen mitätöinti Työnantajan erillisilmoituksia sisältävän aineiston mitätöinti 4.4 Latauspalvelun toiminnot Latauspalvelussa voi testata seuraavia toimintoja: Testaaja voi lähettää erityyppisiä aineistoja tulorekisterin sidosryhmätestausympäristöön. Testaaja voi valita yhden tai useamman tiedoston koneeltaan lähetettäväksi. Testaaja voi lisätä tiedostoja ja poistaa yksittäisiä tiedostoja ennen aineistojen lähettämistä tai tyhjentää koko valittujen tiedostojen listan. Testaaja voi valita latauspalveluun useamman erityyppisen tiedoston ja lähettää nämä latauspalveluun yhdellä kertaa. Lähetyskerralla lähetetyt tiedostot voivat olla eri yritysten aineistoja. Yksi aineisto voi sisältää vain yhden yrityksen yhden maksukerran ja yhdenlaisia ilmoituksia. Palkkatietoaineisto sisältää palkkatietoilmoituksia, erillisilmoitusaineisto sisältää erillisilmoituksia ja aineistotilausaineisto sisältää aineistotilauksia. Yhden aineiston kokoraja on sama kuin rajapinnan kautta toimitettavissa aineistoissa eli 50 MB. Kun testaaja painaa Lähetä tiedostot -painiketta: Aineistot siirretään Lähetetyt aineistot -listalle. Aineiston tilaksi muutetaan Käsitellään. Käsittelyn valmistumisesta näytetään aika-arvio. Testaaja voi siirtyä pois sivulta tai sulkea selaimen ilman, että se vaikuttaa käsittelyyn. Testaaja voi lähettää uusia aineistoja myös silloin, kun edellisen lähetyksen aineistoja vielä käsitellään. Kun aineisto on käsitelty, muutetaan aineiston tilaksi Tallennettu tulorekisteriin, jos aineistossa ei havaittu virheitä. Jos aineiston sisällössä on virheitä, aineiston tilaksi muutetaan joko Hylätty tai Osittain hylätty riippuen siitä, hylättiinkö koko aineisto vai osa aineistosta. Rivin tiedoissa näytetään vastaanottohetki ja linkki käsittelypalautteeseen.
9(30) Aineistot tyhjennetään listalta kolmen kuukauden kuluttua niiden vastaanottamisesta. 4.5 Latauspalvelun virhetilanteet Jos testaaja yrittää ladata latauspalveluun virheellistä tiedostoa, hän saa virheilmoituksen seuraavista tilanteista: Virheellinen tiedostomuoto: jos testaaja yrittää lähettää tiedostoa, jonka pääte on muu kuin xml tai tiedostomuoto on muilla tavoin virheellinen, testaaja saa latauspalvelussa ilmoituksen Virheellinen tiedosto. Tällöin Lähetä tiedostot -painike ei ole aktiivinen. XML-tiedosto ei läpäise skeemavalidointia: jos testaaja yrittää lähettää XML-tiedostoa, jonka sisältö ei vastaa tulorekisterin skeemaa, testaaja saa latauspalvelussa ilmoituksen Tiedoston luku epäonnistui. Tämän lisäksi testaaja saa lisätietona Lataa tekninen virheilmoitus -linkin. Virheilmoitus on tekstimuotoinen, ja siinä esitetään skeemavalidoinnin virheet. Tällöin Lähetä tiedostot -painike ei ole aktiivinen. Testaajalla ei ole oikeutta lähettää aineistoa: jos testaaja yrittää lähettää aineistoa, jonka lähetykseen testaajalla ei ole oikeuksia, testaaja saa latauspalvelussa ilmoituksen valtuutusvirheestä. Tällöin Lähetä tiedostot -painike ei ole aktiivinen. Lähetetty tiedosto sisältää virheitä: jos testaaja lähettää aineiston Lähetä tiedostot -painikkeella ja aineiston sisällössä on virheitä, testaajalle näytetään Lataa käsittelypalaute -linkki. o Jos virhe on aineistotasolla (DeliveryErrors), linkistä avautuu AckFromIR-skeeman mukainen palaute. o Jos virhe on sisällössä (InvalidItems), linkistä avautuu StatusResponseFromIR-skeeman mukainen palaute. o Käsittelypalautteessa esitetään tulorekisterin palauttamat virhekoodit kuvauksineen. Useita tiedostoja, joista osa virheellisiä: jos testaajalla on lähetettävänä useita tiedostoja, joista osa on virheellisiä ja osa virheettömiä, testaaja voi lähettää virheettömät tiedostot latauspalvelun kautta tulorekisteriin. Tällöin Lähetä tiedostot -painike on aktiivinen ja ainoastaan virheettömät tiedostot lähetetään tulorekisteriin. Virheelliset tiedostot jäävät edelleen listalle. 5 ILMOITTAMINEN, VERKKOLOMAKKEET Ilmoittamisen pääsivulla voi valita palkkatietoilmoituksen tai työnantajan erillisilmoituksen.
10(30) 5.1 Ilmoitusten täyttäminen 5.1.1 Maksajan tiedot Ilmoitusten täyttö on kolmivaiheinen. Ensimmäinen vaihe on tarkistaa esitäytetyt maksajan tiedot, täydentää niitä tarvittaessa ja tallentaa ne järjestelmään. Alla käytetään esimerkkinä palkkatietoilmoitusta. Työnantajan erillisilmoituksen täyttö etenee vastaavasti. Muokkaa-painikkeella siirrytään täyttämään Maksajan tietoja ja Tallenna-painike tallentaa tiedot. Sivulla näytetään toimintopainikkeet, joiden avulla sivujen välillä voi liikkua eteenpäin ja taaksepäin. Poistu: Poistuu ilmoituksesta ja palaa ilmoittamisen pääsivulle. Edellinen: Palaa edelliselle ilmoituksen sivulle. Sivulle syötetyt tiedot eivät katoa, vaikka sivulta palattaisiin edelliseen vaiheeseen.
11(30) Seuraava: Siirtyy ilmoituksen täytössä seuraavalle sivulle. Jos ilmoituksessa on virheitä, Seuraava-painike ei ole valittavissa. Kaikki virheet eivät kuitenkaan estä siirtymistä seuraavalle sivulle. 5.1.2 Ilmoituksen tiedot Toinen vaihe on varsinainen ilmoituksen täyttäminen. Kappaleissa 5.2 ja 5.3 kuvataan tarkemmin ilmoitusten sisältöä. Jos tässä vaiheessa havaitaan puutteita tai virheellistä tietoa, voi ilmoituksen täyttämisvaiheeseen palata Edellinen-painikkeella. Varsinainen virheiden tarkistus kuvataan kappaleessa 5.1.5. Kun ilmoitus on täytetty, päästään esikatseluvaiheeseen Seuraavapainikkeella.
12(30) 5.1.3 Esikatselu Kolmas vaihe on esikatselu. Esikatselunäytöllä käyttäjä voi vielä tarkistaa syöttäneensä tiedot oikein. Esikatselussa näytetään kaikki ilmoitukseen täytetyt tiedot yhdellä sivulla tekstimuodossa, samassa järjestyksessä kuin ne on täytetty aiemmilla sivuilla. Kun ilmoituksen tiedot on tarkistettu esikatselunäkymästä, voidaan ilmoitus lähettää tulorekisteriin. Lähetä-painike tallentaa ilmoituksen tiedot tulorekisteriin. Lähettämisen virhetilanteita kuvataan kappaleessa 5.1.5. 5.1.4 Vastaanottokuittaus Virheettömän ilmoituksen vastaanotosta käyttäjä saa vastaanottokuittauksen.
13(30) 5.1.5 Virhetilanteet Ohjelmisto tarkistaa käyttäjän ilmoitukseen syöttämät tiedot virheiden varalta, kun käyttäjä yrittää lähettää ilmoitusta. Vain virheettömän ilmoituksen voi lähettää tulorekisteriin. Jos ilmoituksessa on virheitä, tulee lista virheistä näkyviin painikkeiden läheisyyteen. Kun käyttäjä on korjannut virheet, ilmoitus pitää lähettää uudelleen. Jos ilmoitus on nyt virheetön, se lähetetään ja tallennetaan tulorekisteriin. 5.2 Palkkatietoilmoitus Tulorekisterin sähköisessä asiointipalvelussa tiedon tuottaja voi toimittaa palkkatietoilmoituksia tulorekisteriin käyttämällä sähköisen asiointipalvelun verkkolomaketta. Palkkatietoilmoituksen täyttämiseen siirrytään valitsemalla vasemmasta navigaatiosta Ilmoittaminen Palkkatietoilmoitus. Lisätietoja palkkatietoilmoituksen sisällöstä: Tietojen toimittaminen - Skeemat - Palkkatietoilmoitukset (pdf) Palkkatietoilmoituksen tietosisällön soveltamisohje (pdf) 5.3 Työnantajan erillisilmoitus Tulorekisterin sähköisessä asiointipalvelussa tiedon tuottaja voi toimittaa työnantajan erillisilmoituksia tulorekisteriin käyttämällä sähköisen asiointipalvelun verkkolomaketta. Työnantajan erillisilmoituksen täyttämiseen siirrytään valitsemalla vasemmasta navigaatiosta Ilmoittaminen Työnantajan erillisilmoitus. Lisätietoja työnantajan erillisilmoituksen sisällöstä: Tietojen toimittaminen - Skeemat - Työnantajan erillisilmoitukset (pdf)
14(30) Työnantajan erillisilmoituksen soveltamisohje (pdf) 6 ILMOITUSTEN HAKU JA KATSELU Tulorekisterin sähköisessä asiointipalvelussa on mahdollista hakea ja katsella kaikkia ilmoituksia, jotka organisaatio on toimittanut tulorekisteriin. Ilmoitusten hakuun siirrytään vasemmasta navigaatiosta valitsemalla Annetut ilmoitukset. Oletuksena näytölle haetaan kuluvan vuoden ilmoitukset.
6.1 Haun tarkentaminen 15(30) Hakua voi tarkentaa esimerkiksi ilmoitusviitteen tai tulorekisterin vastaanottopäivän mukaan. Hakuehtoja voi antaa useita. Käyttäjä voi rajata hakutuloksia edelleen valitsemalla rivin, jossa on vain tietyn tyyppisiä ilmoituksia. Esimerkiksi valitsemalla tulolajin 201 näytetään listaus, jossa ovat vain ne ilmoitukset, jotka sisältävät kyseisen tulolajin suorituksia.
16(30) 6.2 Ilmoituksen korjaaminen Kun etsitty ilmoitus on löytynyt, voidaan sitä tarvittaessa muokata ilmoituksen yläreunassa olevan Korjaa-painikkeen kautta. Ilmoitusta muokataan samalla tavalla kuin uusi ilmoitus täytetään (katso kappale 5.1).
17(30) 6.3 Käytä ilmoitusta uuden pohjana Haettua ilmoitusta voidaan käyttää myös pohjana uuden ilmoituksen täyttämiseksi. Ilmoitus voidaan ottaa pohjaksi Käytä pohjana -painikkeella. Ilmoitus täytetään samalla tavalla kuin kappaleessa 5.1 on kuvattu. 6.4 Ilmoituksen mitätöinti Tarvittaessa ilmoituksen voi myös mitätöidä. Tämä tapahtuu Poistapainikkeella. Järjestelmä pyytää vielä ilmoituksen poistamisesta varmistuksen. Poistaminen luo ilmoituksesta uuden version, jonka tila on mitätöity.
18(30) 7 AINEISTOJEN HAKU JA KATSELU Tulorekisterin sähköisessä asiointipalvelussa on mahdollista hakea ja katsella kaikkia aineistoja, jotka organisaatio on toimittanut xmltiedostomuodossa rajapinnan tai latauspalvelun kautta tulorekisteriin. Aineistojen hakuun siirrytään vasemmasta navigaatiosta valitsemalla Lähetetyt aineistot. Hakua voi tarkentaa esimerkiksi aineistoviitteen tai tulorekisterin vastaanottopäivän mukaan. Hakuehtoja voi antaa useita. Aineistot listautuvat vastaanottopäivän mukaan. Aineistojen tiedoissa näkyvät myös aineiston tila ja aineiston toimituskanava eli se, onko aineisto toimitettu rajapinnan vai latauspalvelun kautta. Aineiston tila voi olla Voimassa, Käsittelyssä, Hylätty käsittelyssä tai Mitätöity. Voimassa: Jos aineistossa ei havaittu virheitä, aineisto ja sen sisältämät kohteet on tallennettu tulorekisteriin. Käsittelyssä: Aineisto on käsiteltävänä tulorekisterissä ja käsittely ei ole vielä päättynyt. Hylätty käsittelyssä: Aineisto ja kaikki sen sisältämät kohteet on hylätty. Käsittelypalaute sisältää kohdetason virheiden vuoksi hylätyt kohteet. Aineiston toimittajan pitää toimittaa aineisto uudelleen korjatuin tiedoin. Mitätöity: Aineisto ja sen sisältämät tiedot on mitätöity tulorekisteristä. Aineiston tarkempia tietoja voi katsella valitsemalla haluamansa aineiston.
19(30) 8 TUNNISTAUTUMINEN JA VALTUUDET 8.1 Tiedon tuottajan testitunnukset Sähköistä asiointipalvelua testaava organisaatio saa testitunnukset tekemänsä testaussopimuksen perusteella. Testitunnuksilla voi käyttää palveluja Suomi.fi-tunnistus ja Suomi.fi-valtuudet tulorekisterin sidosryhmätestauksessa. Testaaja testaa vain sähköistä asiointipalvelua Tulorekisterihanke toimittaa organisaation testauksen yhteyshenkilölle keinotekoiset Y-tunnukset ja henkilötunnukset sähköisen asiointipalvelun testaamiseen sen jälkeen, kun testaussopimus on käsitelty. Testaaja on aloittanut sidosryhmätestauksen teknisten rajapintojen testauksella Tulorekisterihanke toimittaa organisaation testauksen yhteyshenkilölle keinotekoiset Y-tunnukset ja henkilötunnukset sähköisen asiointipalvelun testaamiseen. Pyyntö lähetetään osoitteeseen yht_tulorekisteri_testaus@vero.fi. Jos organisaatio haluaa testata jonakin alla listatuista tahoista, tästä on mainittava erikseen testitunnuksia pyydettäessä tai testaussopimusta lähetettäessä, jos testaava organisaatio testaa vain sähköistä asiointipalvelua. o o o o o o kunta seurakunta oppilaitos yhdistys säätiö elinkeinoyhtymä
o o o kuolinpesä julkinen viranomainen ulkomainen yritys 20(30) HUOM! Ulkomaisilla yritystunnuksilla testaavat tahot tunnistautuvat Katsotestitunnisteilla. Katso-testitunnisteaihioita jaetaan pyynnöstä. 8.2 Tiedon tuottajan kirjautuminen sähköiseen asiointipalveluun Tulorekisterin sähköisen asiointipalvelun testausympäristöön kirjaudutaan tulorekisteri.fi-sivulta (Tulorekisteri Ohjelmistokehittäjät Sidosryhmätestaus Sähköisen asiointipalvelun testausympäristö). Ruotsinkieliseen sähköisen asiointipalvelun testausympäristöön kirjaudutaan inkomstregister.fi-sivulta ja englanninkieliseen testausympäristöön incomesregister.fi-sivulta. Testaaja valitsee Kirjaudu testausympäristöön 8.3 Suomi.fi-tunnistautuminen Valittuaan Kirjaudu testausympäristöön testaaja valitsee Suomi.fitestitunnistusvalikosta tunnistustavaksi Testitunnistaja ja siirtyy sen avulla Suomi.fi-tunnistuksen testitunnistukseen.
21(30) Testitunnistaja-näytöllä testaaja syöttää tulorekisterihankkeen toimittaman keinotekoisen henkilötunnuksen kenttään Henkilötunnus, ja tunnistautunut testaaja kirjautuu tulorekisterin sidosryhmätestausympäristön sähköiseen asiointipalveluun. Edellytyksenä on, että testaajalla on riittävät valtuudet asiointipalveluun kirjautumiseen (ks. luku 8.5.1 Suomi.fi-valtuudet tai luku 8.6.1 Erityisryhmät ja valtuuttaminen Katso-palvelussa). Testitunnistus Testitunnistaja keinotekoinen henkilötunnus
22(30) 8.4 Asiointi oman organisaation puolesta Asiointi tulorekisterin sähköisen asiointipalvelun testausympäristössä yrityksen nimenkirjoitusoikeudellisena edustajana onnistuu ilman erillistä valtuutusta. Testaaja kirjautuu tulorekisterin sähköisen asiointipalvelun testausympäristöön tulorekisterihankkeelta saadulla testitunnuksella (henkilötunnuksella), ja Suomi.fi-valtuudet ilmoittaa henkilötunnukseen liitetyn keinotekoisen organisaation valtuustiedot tulorekisterin sähköisen asiointipalvelun etusivulla. Yrityksen puolesta asiointi onnistuu seuraavilla toimielinrooleilla: Toimitusjohtaja Toimitusjohtajan sijainen Varatoimitusjohtaja Hallituksen puheenjohtaja Hallituksen jäsen Selvitysmies Isännöitsijä Päävastuullinen isännöitsijä Elinkeinonharjoittaja Vastuunalainen yhtiömies (Ky) Yhtiömies (Ay) Oikeutettu Prokuristi Lisätietoa tunnistautumisesta ja valtuuttamisesta on sivulla Ilmoittamisen kanavat. 8.5 Tiedon tuottajan valtuudet Tiedon tuottaja eli suorituksen maksaja voi valtuuttaa työntekijänsä tai toisen organisaation asioimaan tulorekisterin sähköisen asiointipalvelun testausympäristössä puolestaan sidosryhmille toimitetuilla keinotekoisilla henkilötunnuksilla ja keinotekoisilla Y-tunnuksilla. Valtuutukset tehdään lähtökohtaisesti Suomi.fi-valtuuksien testausympäristössä. Osa tiedon tuottajista (erityisryhmät) myöntää valtuudet Katsotestipalvelussa, koska kaikkia organisaatiomuotoja ei ole vielä mahdollistettu Suomi.fi-valtuuksissa. Näitä niin kutsuttuja erityisryhmiä ovat ne tahot, joiden nimenkirjoitusoikeudellisesta henkilöstä ei ole tietoa kaupparekisterissä tai YTJ:ssä. Tällaisia toimijoita ovat esimerkiksi kunnat, seurakunnat, oppilaitokset, yhdistykset, säätiöt, elinkeinoyhtymät, kuolinpesät ja julkiset
23(30) viranomaiset. Nämä tahot tekevät valtuutukset Katso-testipalvelussa mutta käyttävät tunnistautumiseen Suomi.fi-testitunnistusta. Lisäksi erityismenettely koskee ulkomaisia organisaatioita, joita ei ole rekisteröity kaupparekisteriin tai joiden nimenkirjoitusoikeudellisella henkilöllä ei ole suomalaista henkilötunnusta. Ulkomaiset organisaatiot käyttävät Katso-testipalvelua sekä tunnistautumiseen että valtuuttamiseen. 8.5.1 Suomi.fi-valtuudet Tiedon tuottajalle myönnettyjen testitunnusten tarkoituksena on mahdollistaa valtuuksien myöntäminen palvelun Suomi.fi-valtuudet testausympäristössä, jotta palkkatiedon tuottaja voi testata sähköisen asiointipalvelun käyttöä. Organisaation puolesta toimivan testaajan valtuuskoodit tulorekisterin käyttöön ovat Palkkatietojen ilmoittaminen ja Palkkatietojen katselu. Valtuutukset voi tehdä yhdellä kertaa molempiin rooleihin, vaikka sähköisen asioinnin palvelut tulevat testaukseen porrastetusti 14.5. ja 13.8. Palkkatietojen ilmoittaminen Tällä valtuudella valtuutettu voi valtuuttajan puolesta palkkatietoihin liittyen: - ylläpitää valtuuttajan perustietoja ja palkkatietoilmoituksia - toimittaa valtuuttajan tuottamia palkkatietoilmoituksia - tilata valtuuttajaa koskevia raportteja (ei ole mahdollista testata 13.8.2018) - lähettää viestejä (ei ole mahdollista testata 13.8.2018). Valtuus Palkkatietojen ilmoittaminen sisältää myös valtuuden Palkkatietojen katselu. Palkkatietojen katselu Tällä valtuudella valtuutettu voi katsella palkkatietoihin liittyen: - valtuuttajan perustietoja - valtuuttajan tuottamia palkkatietoilmoituksia - valtuuttajaa koskevia raportteja (ei ole mahdollista testata 13.8.2018) - valtuuttajan lähettämiä ja saamia viestejä (ei ole mahdollista testata 13.8.2018). Suomi.fi-valtuudet myönnetään osoitteessa https://valtuusrekisteri.test.suomi.fi/landing.html#!/ (Suomi.fi-valtuudet, asiakastestausympäristö).
24(30) Valtuuden tyypin valinta: Valtuus valtuutan toisen osapuolen asioimaan puolestani valitsemissani asioissa (Oy AB on valtuuttanut työntekijänsä A:n). Valtuutusoikeus annan henkilöille oikeuden luoda valtuuksia tämän yrityksen nimissä valitsemissani asioissa. Valitsemalla tämän voi antaa valtuutusoikeuden oman organisaation työntekijöille, jotka voivat myöntää valtuuksia oman organisaation asioissa (Oy AB on antanut valtuuden työntekijälleen A, joka voi valtuuttaa työntekijän B). Edustamisvaltuus annan henkilöille oikeuden asioida tälle yritykselle myönnettyjen valtuuksien perusteella valitsemissani asioissa (esim. Oy AB on valtuuttanut Tilitoimisto AB:n ja tilitoimisto on valtuuttanut edelleen työntekijänsä C:n, joka voi hoitaa Oy AB:n asiointia). Edustajan valtuutusoikeus annan henkilöille oikeuden valtuuttaa tämän yrityksen nimissä toisia henkilöitä, jotta he voivat asioida tämän yrityksen saamien valtuuksien perusteella valitsemissani asioissa. Valitsemalla tämän voi antaa valtuutusoikeuden toiselle henkilölle, joka voi myöntää oikeuksia yrityksen puolesta asiointiin (Oy AB on valtuuttanut Tilitoimisto AB:n ja tilitoimisto antaa työntekijälleen A oikeuden valtuuttaa muita henkilöitä, jotka voivat hoitaa Oy AB:n asiointia).
25(30) Valtuuden osapuolet lisää henkilö (keinotekoinen henkilötunnus) tai lisää yritys (keinotekoinen Y- tunnus). Voimassaolo voimassaolo on aina määräaikainen. Valtuuden luominen Valitse valtuuden asia listasta Asiakategoria Ansiotulot Valtuuskoodit Palkkatietojen ilmoittaminen ja Palkkatietojen katselu
26(30) 8.6 Asiointi asiakkaan puolesta (esimerkiksi tilitoimisto) Valtuuden saanut taho, esimerkiksi tilitoimisto, voi asioida useiden asiakkaidensa puolesta sähköisessä asiointipalvelussa. Tilitoimisto voi asioida kaikkien niiden asiakasyritysten puolesta, jotka ovat valtuuttaneet tilitoimiston. Yhdellä tunnistautumisella voi asioida useamman eri asiakkaan puolesta. Kun lähettää tiedostoja latauspalvelussa, yksi tiedosto voi kuitenkin sisältää vain yhden asiakkaan palkkatietoaineistoja. o Asiointivaltuudet tarkistetaan aineiston lähettämisen yhteydessä. Sähköistä asiointipalvelua testattaessa palveluun tunnistautunut henkilö valitsee yhden asiakkaan, jonka puolesta on asioimassa. o Asiakasta voi vaihtaa saman istunnon aikana. 8.6.1 Erityisryhmät ja valtuuttaminen Katso-palvelussa Osa tiedon tuottajista myöntää valtuudet testausta varten Katsotestipalvelussa, koska kaikkia organisaatiomuotoja ei ole vielä mahdollistettu Suomi.fi-palveluissa. Erityisryhmiä ovat ne tahot, joiden nimenkirjoitusoikeudellisesta henkilöstä ei ole saatavilla tietoa kaupparekisterissä tai YTJ:ssä. Tällaisia toimijoita ovat esimerkiksi kunnat, seurakunnat, oppilaitokset, yhdistykset, säätiöt, elinkeinoyhtymät, kuolinpesät ja julkiset viranomaiset. Palveluun tunnistaudutaan Katso-testitunnisteilla. Erityisryhmään kuuluvan testaajan pitää muodostaa itselleen Katso-testitunniste (pääkäyttäjyys) voidakseen myöntää valtuuksia muille organisaation edustajille, aliorganisaation työntekijälle tai toiselle organisaatiolle. Pääkäyttäjyyden perustaminen sekä Katso-testitunnisteen muodostaminen ja valtuuksien myönnettävissä osoitteessa: https://htesti.katso.tunnistus.fi (Katso-testipalvelun osoite) 8.6.1.1 Ulkomaiset organisaatiot Erityismenettely koskee myös ulkomaisia organisaatioita, joita ei ole rekisteröity kaupparekisteriin tai joiden nimenkirjoitusoikeudellisella henkilöllä ei ole suomalaista henkilötunnusta. Ulkomaiset organisaatiot käyttävät tunnistautumisessa Katsotestipalvelussa käytettäviä Katso-testitunnisteita. Testaaja muodostaa Katso-testitunnisteen testipalvelussa osoitteessa (https://yritys.tunnistus.fi/eidm2/wf/register/person), perustaa uuden pääkäyttäjyyden https://htesti.katso.tunnistus.fi ja myöntää organisaation työntekijöille valtuudet tulorekisterin sidosryhmätestaukseen sähköisen asiointipalvelun testausta varten tai valtuuttaa toisen yrityksen toimimaan
27(30) puolestaan osoitteessa https://htesti.katso.tunnistus.fi (Katso-testipalvelun osoite). Ulkomaisten organisaatioiden mahdollisuudesta kirjautua tulorekisterin sähköiseen asiointipalveluun ilmoitetaan myöhemmin. 9 TESTAUSPROSESSI Kun sidosryhmätestauksen aloittamisen toimenpiteet on suoritettu, sidosryhmä voi aloittaa testauksen. Alla olevassa kuvassa on kuvattu testauksen kulku sidosryhmätestauksen edetessä. Sidosryhmätestausprosessi 10 HAVAINTOJEN RAPORTOINTI Testauksen havainnot toimitetaan tulorekisterihankkeelle käyttämällä havaintolomaketta. Lomake on yksisuuntainen, ja ilmoitetusta havainnosta viestitään jatkossa sähköpostitse. Testauksen yhteyshenkilö saa sähköpostitse linkin havaintolomakkeeseen, kun testaussopimus on käsitelty. 10.1 Ohje havaintolomakkeen kenttien täyttöön Häiriötilanne, joka estää järjestelmän käytön (kyllä): Jos havaitset tulorekisterin sidosryhmätestauksessa vakavan häiriön, merkitse kyllä. Tulorekisterin testausorganisaatio arvioi häiriön vakavuuden. Vakavissa häiriötilanteissa tulorekisterin sidosryhmätestaus keskeytyy. Tulorekisteri tiedottaa häiriötilanteen laajuudesta ja korjausaikataulusta testaaville sidosryhmäorganisaatioille. Otsikko: Havaintoa mahdollisimman hyvin kuvaava otsikko. Virheluokka: Neliportainen asteikko, jolla kuvataan virheen kriittisyyttä. Ohjeistus virheluokan käyttöön on dokumentin Sidosryhmätestaussuunnitelma (pdf) kappaleessa Virheiden luokittelu.
28(30) Havainnon tekijän nimi: Testaajan nimi Organisaation nimi: Testaajan organisaatio Havainnon tekijän sähköpostiosoite: Havainnon kirjaajan sähköpostiosoite. Havaitsemisajankohta: Päivämäärä ja kellonaika, jolloin tilanne havaittiin. Kanava: Valitse kanava, jolla testaus tehtiin (Reaaliaikainen Web Service / Viivästetty Web Service / SFTP / Latauspalvelu). Palvelut: Valitse palvelu, jota testattiin. Liite: Lähetetyn sanoman xml. Jos tilanteessa palautui sanoma tai jokin virheilmoitus, se liitetään myös tähän. Kuvaus havainnosta: Mitä palvelua testattiin? (Esim. palkkatietoilmoitus, uusi/korvaava/mitätöinti) Mitä kanavaa testataan? (Reaaliaikainen/viivästetty Web Service, SFTP, Latauspalvelu) Mitä testaaja teki? Mitä testauksessa tapahtui? Mikä oli odotettu lopputulos, mitä olisi pitänyt tapahtua? 10.2 Esimerkki kirjatusta havainnosta Otsikko: Uusi palkkatietoilmoitus tulolajilla 404 Lähdevero ei hyväksy negatiivista arvoa Virheluokka: 3 Medium / Keskivakava Havainnon tekijän nimi: Hemmo Testaaja Organisaation nimi: Ohjelmistotalo X Havainnon tekijän sähköpostiosoite: hemmo.testaaja@ohjelmistotalox.fi Havaitsemisajankohta: 9.11.2017 klo 16:20 Kanava: Latauspalvelu Palvelut: Palkkatietoilmoitusten toimittaminen (WageReportsToIR) Liite: 404_palkkatietoilmoitus.xml, 404_response.xml Kuvaus havainnosta: Testattiin uuden palkkatietoilmoituksen lähettämistä latauspalvelussa. Lähetettiin uusi palkkatietoilmoitus, jossa tulolajilla 404 annettu summa = -89,15. StatusResponse-sanomalla palautui vastaus Negatiivinen arvo ei sallittu kentässä amount. Palkkatietoilmoituksen olisi pitänyt mennä läpi tulorekisteriin. Tulolajilla 404 negatiivinen summa on sallittu. Havainnon tekijä saa kuittauksen havainnon vastaanotosta sähköpostitse 1 2 työpäivän kuluessa. Jos havainto on virhe, lähetetään sähköpostissa myös virheen tunniste (ID). Tämän jälkeen havainnon tekijä lähettää kyseiseen havaintoon liittyvät mahdolliset kommentit sähköpostitse ja ilmoittaa virheen tunnisteen viestin otsikossa. 10.3 Havainnon ohjaus korjaukseen Havainto käsitellään tulorekisterihankkeessa. Virheet käsitellään hankkeen virhehallintaprosessin mukaisesti. Kaikki tulorekisterihankkeelle saapuneet virheiksi luokitellut havainnot käsitellään virheraadissa, jossa virheille määritellään korjausjärjestys. Tulorekisterihanke on havainnon tekijään
29(30) yhteydessä, jos tulorekisterihankkeen virheraati muuttaa virheluokkaa tai jos havainnosta tarvitaan lisätietoa. Sidosryhmätestaukseen vaikuttavista virheistä tiedotetaan tulorekisteri.fisivustolla. 10.4 Virhe, joka estää testaamisen Jos havainto on sellainen virhe, joka estää sidosryhmätestauksen etenemisen, havainnon tekijä valitsee virheluokaksi 1 Critical / Kriittinen. Tällöin tulorekisterihanke priorisoi havainnon käsittelyn. Jos virheraati säilyttää virheluokan ennallaan, kriittinen virhe ohjataan korjaukseen. Kriittiset virheet ohjataan korjaukseen ohi normaalin virhehallintaprosessin. Havainnon tekijä saa tiedon virheen ohjauksesta korjaukseen sekä arvion vian korjausajasta. Lisäksi virhetilanteesta tiedotetaan tulorekisteri.fisivustolla. Tulorekisterihanke voi myös laskea virheluokan tasolta 1 alemmaksi, jolloin virhe käsitellään normaalin virhehallintaprosessin mukaisesti. Tässä tapauksessa tulorekisterihanke ilmoittaa virheluokan muuttumisesta havainnon tekijälle. Esimerkki kriittisestä virheestä (virheluokka 1): Palkkatietoilmoitusten lähetys latauspalvelussa ei onnistu. Perustelut: kriittinen virhe, koska estää palkkatietoilmoitusten lähetyksen kokonaan yhdessä kanavassa. Estää testaamisen kokonaan niiltä palkkatietojen tuottajilta, jotka käyttävät latauspalvelua. Esimerkki muusta kuin kriittisestä virheestä (virheluokat 2 4): Palkkatietoilmoitus: Palkkatietoilmoituksen mitätöinti ei onnistu maksajan ilmoitusviitteellä mutta onnistuu tulorekisterin ilmoitusviitteellä. Perustelut: ei-kriittinen virhe, koska ei estä testauksen etenemistä. Mitätöinnin voi tehdä tulorekisterin ilmoitusviitteellä ja testausta voi jatkaa. 10.5 Muutospyyntö Jos testauksen yhteydessä havaitaan muutostarve, tästä laaditaan muutospyyntölomake, joka toimitetaan sähköpostitse tulorekisterihankkeelle. Tulorekisterihanke ilmoittaa muutospyynnön käsittelyn etenemisestä muutospyynnön tekijälle. Muutospyyntölomakkeen saa lähettämällä pyynnön sähköpostitse osoitteeseen YHT.Tulorekisteri_toiminnallinen@vero.fi. Täytetty lomake palautetaan samaan osoitteeseen. 10.6 Toimitusseloste
30(30) Kun virheen korjaus on tehty ja testattu tulorekisterihankkeessa, se toimitetaan sidosryhmätestausympäristöön seuraavan julkaisun yhteydessä. Tulorekisterihanke laatii toimitusselosteen ennen uuden version asennusta. Toimitusselosteessa luetellaan korjaukset sekä muutokset, jotka ovat versiossa mukana. Toimitusseloste lähetetään sidosryhmän testauksen yhteyshenkilöille julkaisua edeltävän maanantain aikana. Lisäksi toimitusselosteet julkaistaan tulorekisteri.fi-sivustolla. Sidosryhmätestaussuunnitelman liitteessä 8 on kuvattu versioiden julkaisuaikataulu: Julkaisuaikataulu (pdf) 10.7 Viimeinen julkaisu sidosryhmätestausympäristöön Sellaiset tulorekisteriin kohdistuvat virheilmoitukset, jotka sidosryhmä toivoo käsiteltävän ja korjattavan ennen 1.1.2019 käyttöönottoa, on toimitettava tulorekisterihankkeelle viimeistään 1.10.2018. Viimeinen korjauspaketti asennetaan sidosryhmätestausympäristöön 1.11.2018. Tämän jälkeen korjataan ainoastaan tuotannon käyttöönoton estävät kriittiset virheet. Sidosryhmätestausympäristö on käytössä myös tämän jälkeen ja havaintoja voi edelleen toimittaa tulorekisterihankkeelle. 1.10.2018 jälkeen ilmoitetut havainnot käsitellään, mutta korjaukset aikataulutetaan käyttöönoton jälkeiseen erikseen ilmoitettavaan aikaan. 11 TESTAUKSEN LOPETTAMINEN 12 LISÄTIETOA Kun sidosryhmä on saanut oman sähköisen asiointipalvelun testauksensa päätökseen, sidosryhmä lähettää tästä sähköpostitse tiedon tulorekisterihankkeelle osoitteeseen YHT_Tulorekisteri_testaus@vero.fi. Testaus voidaan katsoa suoritetuksi, kun sidosryhmä on todentanut oman järjestelmänsä ja tulorekisterin välisten liittymien toimivuuden eikä sidosryhmällä ole tiedossa tuotantokäytön aloittamisen estäviä virheitä. Sidosryhmä saa ilmoituksensa jälkeen jatkaa testausta tulorekisterin sidosryhmätestausympäristössä esimerkiksi regressiotestauksen, järjestelmän uuskehityksen tai alemman prioriteetin virheenkorjausten tiimoilta. Testauksen lopetusviestin tarkoituksena on antaa tulorekisterihankkeen valmiusarviointia varten tieto siitä, että toteutetut liittymät ovat testanneen sidosryhmän näkökulmasta valmiit tuotantokäyttöön. Sidosryhmätestaussuunnitelma (pdf) Koodistot Tulolajit (pdf) Julkaisuaikataulu (pdf) Koodistot (pdf) Tulorekisterin dokumentaatio