Versio 1.2. Kansallisen tulorekisterin perustamishanke. Sidosryhmätestaussuunnitelma

Versio 1.2 Kansallisen tulorekisterin perustamishanke Sidosryhmätestaussuunnitelma

Tulorekisterihanke Sidosryhmätestaussuunnitelma 1(22) Versiohistoria Versio Päivämäärä Kuvaus 1.0 25.10.2017 Dokumentti julkaistu. 1.1 21.12.2017 - Lisätty kohtaan 4.1.2 tiedon käyttäjien palveluihin: aineistotilaus (uusi tilaus, tilauksen mitätöiminen), aineistotilauksen sisältävä aineisto (aineiston mitätöiminen) ja viesti (uusi viesti). - Lisätty kohtiin 4.2.1.1 ja 4.2.1.2 maininta teknisestä yhteyshenkilöstä. - Poistettu testaussopimuksen tiedoista keinotekoinen Y-tunnus. - Poistettu liiteluettelosta liite 9: Sidosryhmätestauksen varautumissuunnitelma. 1.2 9.2.2018 - Kappale 1: otsikko muutettu Dokumentin tarkoitus > Sidosryhmätestauksen tarkoitus. - Kappale 1: lisätty vuoden 2020 tuotantokäytön aloittavien palkkatiedon käyttäjien rajapintatestauksen aloitusaikataulu. - Kappale 2: päivitetty kuva Sidosryhmätestauksen aikataulu. - Kappale 3: lisätty tarkennus luettelon kolmanteen kohtaan. - Kappale 4.2.1.2: tarkennettu tietoa tiedonsaantiprofiileista. - Kappale 6.1: tarkennettu, miten asiakasaineisto luovutetaan sidosryhmien käyttöön. - Kappale 6.3: sisältö muutettu vastaamaan tämän hetken suunnitelmaa. - Kappale 7: muokattu tekstiä siten, että tulorekisteri.fisivulla julkaistaan vain olennaisesti testaukseen vaikuttavat virheet. - Kappale 7.1: tarkennettu ensimmäistä lausetta. - Kappale 7.1: tarkennettu tietoa siitä, että linkkiä havaintolomakkeeseen ei lisätä ohjeeseen, vaan se toimitetaan testauksen aloittavalle sidosryhmälle sähköpostitse. - Kappale 7.1: kuvaan lisätty nuoli havainnon tunnisteen toimittamisesta sähköpostitse sidosryhmälle. - Kappale 11: tarkennettu viidennen kohdan tekstiä. - Kappale 12: poistettu liite 3 Suunnitelma testiaineiston simuloinnista tulevaisuuteen (kyseinen asia sisältyy liitteessä 5 kuvattuihin päivämääräkonfiguraatioihin)

Tulorekisterihanke Sidosryhmätestaussuunnitelma 2(22) KESKEISET TERMIT JA NIIDEN SELITTEET Termi Anonymisointi Asiointipalvelu Pilottitestaus Rajapinta Sidosryhmät Testaussopimus Määritelmä Anonymisoinnilla pyritään siihen, että tiedosta tulee sellaista, ettei sitä voida missään tilanteessa (edes jonkin toisen hallussa olevan tiedon avulla) yhdistää tiettyyn luonnolliseen henkilöön. Esimerkiksi henkilötietojen käsittely niin, että henkilötiedot muutetaan peruuttamattomasti sellaiseen muotoon, ettei mikään taho voi tunnistaa henkilöä niistä suoraan tai välillisesti. Tulorekisterin sähköinen asiointipalvelu on selaimella käytettävä palvelu tulorekisterin osapuolille tarkoitettujen toimintojen käyttämiseen. Tulorekisterissä on sähköinen asiointipalvelu tiedon tuottajille, tiedon käyttäjille ja tulonsaajille. Pilottitestauksessa testataan esimerkiksi toimintosarjaa, ympäristöä tai yhteyksiä ennakkoon valitun tekijän tai ryhmän kanssa. Testaus suoritetaan valitulla aineistolla. Standardin mukainen käytäntö tai yhtymäkohta, joka mahdollistaa tietojen siirron laitteiden, ohjelmien tai käyttäjän välillä. Tulorekisterin sidosryhmiä ovat kaikki tulorekisterin käyttäjät: palkkojen, eläkkeiden ja etuuksien maksajat sekä heidän valtuuttaminaan tilitoimistot ja muut palkkahallinnon ulkoistuskumppanit sekä tulorekisterin tietojen käyttäjätahot. Tämän lisäksi sidosryhmiä ovat järjestelmätoimittajat. Sopimus, jonka sidosryhmä tekee Verohallinnon kanssa tulorekisterin rajapintojen testaamisesta sidosryhmätestausympäristössä. Sellaiset toimijat, joilla on lainsäädäntöön perustuva oikeus saada tulorekisteristä tulo- tai muita tietoja oman tehtävänsä hoitamiseen. Tiedon käyttäjät 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 Tuotantodata Kaikki yritykset ja muut toimijat, joilla on palkka-, eläke- tai etuustietojen ilmoitusvelvollisuuksia Suomeen jollekin tulorekisterin tiedon käyttäjälle. Järjestelmän tuotantoympäristössä käyttämä tietoaineisto, joka sisältää todellisia henkilö- ja tulotietoja.

Tulorekisterihanke Sidosryhmätestaussuunnitelma 3(22) Varmenne (Sertifikaatti) Sähköinen todistus, jolla vahvistetaan, että todistuksen haltija on tietty henkilö, organisaatio tai järjestelmä. Varmenteella voidaan todeta tietoliikenteen, toisen osapuolen tai tiedoston aitous sekä muodostaa tarvittaessa salattu ja luotettava yhteys toisen osapuolen kanssa.

Tulorekisterihanke Sidosryhmätestaussuunnitelma 4(22) SISÄLLYSLUETTELO 1 Sidosryhmätestauksen tarkoitus... 6 2 Aikataulu... 7 3 Testauksen kulku... 8 4 Testauksen kohde... 9 4.1 Testattavat rajapinnat Palkkatiedot... 9 4.1.1 Tiedon tuottajien (suorituksen maksajan) palvelut... 9 4.1.2 Tiedon käyttäjien palvelut... 10 4.2 Käyttöoikeudet... 12 4.2.1 Käyttöoikeudet rajapinnat... 12 4.2.2 Käyttöoikeudet sähköinen asiointipalvelu... 13 4.3 Sähköinen asiointipalvelu (suunnitelma julkaistaan 4/2018)... 13 4.3.1 Tiedon tuottaja... 13 4.3.2 Tiedon käyttäjä... 13 4.3.3 Yhteiset (Tiedon tuottajat ja tiedon käyttäjät)... 14 4.3.4 Sähköisen asiointipalvelun tuetut selaimet... 14 5 Testausympäristöt... 15 5.1 Testausympäristön käyttöaika... 15 5.2 Testausympäristön konfiguraatiot... 15 6 Testiaineistot... 16 6.1 Asiakasaineisto... 16 6.2 Palkkatietoaineisto... 16 6.3 Testiaineiston simulointi tulevaisuuteen... 16 7 Testauksen havainnot... 17 7.1 Havaintojen hallinnan prosessi... 17 7.2 Virheiden luokittelu... 18 7.3 Korjausten toimittaminen sidosryhmätestaukselle... 18 8 Laajojen aineistojen erillistestit... 19 9 Testauksen lopetus... 19 10 Testauksen osapuolet ja kommunikointi... 19

Tulorekisterihanke Sidosryhmätestaussuunnitelma 5(22) 10.1 Tulorekisterihankkeen sidosryhmätestauksen yhteystahot... 20 10.2 Sidosryhmätestauksen tiedotus... 20 11 Rajaukset... 20 12 Liitteet... 21

Tulorekisterihanke Sidosryhmätestaussuunnitelma 6(22) 1 Sidosryhmätestauksen tarkoitus Tässä sidosryhmätestaussuunnitelmassa kuvataan, miten 1.1.2019 käyttöönotettavan tulorekisterijärjestelmän sidosryhmätestaus organisoidaan ja toteutetaan. Sidosryhmätestaus jaetaan kahteen vaiheeseen. Ensimmäisessä vaiheessa 1.3.2018 lähtien testataan tulorekisterin palkkatietojen toimittamiseen ja jakeluun liittyviä teknisiä rajapintoja. Sidosryhmätestaukseen osallistuvat tulorekisterin teknisen rajapintayhteyden rakentavat palkkatietojen tuottajat kuten ohjelmistotalot ja yritykset sekä tulorekisterin tietoja vuonna 2019 käyttävät tahot Verohallinto, Kela, työeläkelaitokset ja ETK sekä työttömyysvakuutusrahasto. Tuotantokäytön vuonna 2020 aloittavien palkkatiedon käyttäjien rajapintatestaus alkaa portaittain alla olevan aikataulun mukaisesti: 1.6.2018 Tilastokeskus, Koulutusrahasto 1.10.2018 Työtapaturma- ja ammattitautivakuuttajat, Liikennevakuuttajat, TVK, PVK, Valtiokonttori 1.2.2019 TEM, Työsuojeluviranomaiset, Työttömyyskassat, Kunnat Vuoden 2018 sidosryhmätestauksen tavoitteena on testata tulorekisterijärjestelmän toimivuus tiedon tuottajan ja tiedon käyttäjän näkökulmasta. Tiedon tuottajan testauksessa varmistetaan, että palkkaohjelmisto tai matkahallintajärjestelmä tuottaa vaatimusten mukaisia sanomia tulorekisteriin. Palkkatietojen käyttäjien testaus keskittyy tilattujen palkkatietoaineistojen testaamiseen. Toisessa sidosryhmätestauksen vaiheessa maaliskuusta 2019 lähtien testataan 2020 käyttöönotettavia palveluita ts. etuustietojen toimittamiseen ja jakeluun liittyviä rajapintoja sidosryhmien kanssa. Lisäksi palkkatietojen jakelun testaus jatkuu toisen vaiheen käyttäjien osalta. Sidosryhmätestaussuunnitelma päivitetään syksyllä 2018 etuustiedon ilmoittamiseen ja jakeluun liittyvien rajapintapalveluiden osalta. Sähköisen asiointipalvelun testauksesta laaditaan erillinen sidosryhmätestaussuunnitelma (Liite 2). Suunnitelma julkaistaan huhtikuussa 2018.

Tulorekisterihanke Sidosryhmätestaussuunnitelma 7(22) 2 Aikataulu Kuvassa 1 on kuvattu aikajanalla sidosryhmätestauksen merkittävät päivämäärät. Kuva 1: Sidosryhmätestauksen aikataulu.

Tulorekisterihanke Sidosryhmätestaussuunnitelma 8(22) 3 Testauksen kulku Alla on listattu teknisten rajapintojen sidosryhmätestausvaiheet sekä viite, josta aiheesta on lisäinformaatiota saatavilla. Tulorekisterihanke julkaisee testausohjeen (Liite 1) joulukuussa 2017 tulorekisteri.fi-sivustolla. Tiedon tuottajille tarkoitettu testaussopimuspohja (Liite 6) ja testausympäristön käyttöehdot julkaistaan joulukuussa 2017 tulorekisteri.fi-sivustolla. Kun sidosryhmän oma ohjelmisto on valmis sidosryhmätestaukseen, sidosryhmätestauksen aloittava sidosryhmä täyttää testaussopimuksen ja hyväksyy testausympäristön käyttöehdot. Testausopimus on toimitettava tulorekisterihankkeelle viimeistään 2 viikkoa ennen testauksen aloitusta, jotta testivarmenteet ehditään toimittaa. Sopimuksen tekemiseen liittyvät yksityiskohdat tarkennetaan testausohjeessa (Liite 1). Sidosryhmä noutaa testivarmenteen ohjeistuksen perusteella. Varmenteen noutamiseen liittyvät yksityiskohdat tarkennetaan testausohjeessa (Liite 1). Sidosryhmä ottaa yhteyden testivarmenteella sidosryhmätestausympäristöön. Yhteystestin jälkeen sidosryhmä voi aloittaa oman testauksensa. Testauksessa käytetään asiakasdatana tulorekisterin muodostamaa asiakasaineistoa, jollei toisin sovita. Kappaleessa 6 Testiaineistot on kuvattu testiaineistoon liittyvät periaatteet. Sidosryhmä toimittaa testauksen aikana havaitut virheet ja muut havainnot tulorekisterihankkeelle. Havaintojen hallinnan prosessi on kuvattu kappaleessa 7 Testauksen havainnot. Tulorekisterihanke tiedottaa virheistä ja virheiden korjauksista sidosryhmiä. Virhekorjausten prosessi on kuvattu kappaleessa 7 Testauksen havainnot. Sidosryhmä ilmoittaa tulorekisterihankkeelle, kun testaus on sidosryhmän osalta suoritettu (kappale 9 Testauksen lopetus).

Tulorekisterihanke Sidosryhmätestaussuunnitelma 9(22) 4 Testauksen kohde 1.3.2018 alkavan ensimmäisen vaiheen sidosryhmätestauksen kohde on 1.1.2019 käyttöönotettavat tulorekisterin palkkatietojen toimittamiseen ja jakeluun liittyvät teknisen rajapinnan palvelut. 4.1 Testattavat rajapinnat Palkkatiedot Alla on kuvaus testattavista palkkatietojen palveluista ja niiden toimituskanavista. Tietojen toimittaminen ja jakelu tapahtuvat SFTP-rajapinnan kautta tiedoston siirtona sekä reaaliaikaisilla ja viivästetyillä Web Service -palveluilla (WS). Tarkemmat kuvaukset testattavista palveluista on kuvattu tulorekisteri.fi-sivuston dokumentaatiossa: Teknisen rajapinnan kuvaukset > Yleiskuvaukset 1. Tekninen rajapinta Tietojen toimittaminen tulorekisteriin 2. Tekninen rajapinta Tietojen jakelu tulorekisteristä. 4.1.1 Tiedon tuottajien (suorituksen maksajan) palvelut Alla on listattuna tiedon tuottajien teknisen rajapinnan palvelut sekä kanavat, joiden kautta kukin palvelu on käytettävissä. 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) o WS reaaliaikainen, yksi aineisto kerrallaan o WS viivästetty, yksi aineisto kerrallaan o SFTP viivästetty, yksi aineisto kerrallaan Aineistotilaus (uusi tilaus, tilauksen mitätöiminen) o WS reaaliaikainen, yksi aineisto kerrallaan o WS viivästetty, yksi aineisto kerrallaan o SFTP viivästetty, yksi aineisto kerrallaan Aineistotilauksen sisältävä aineisto (aineiston mitätöiminen) o WS reaaliaikainen, yksi aineisto kerrallaan o WS viivästetty, yksi aineisto kerrallaan o SFTP viivästetty, yksi aineisto kerrallaan Viesti (uusi viesti) o WS reaaliaikainen, yksi viesti kerrallaan o WS viivästetty o SFTP viivästetty.

Tulorekisterihanke Sidosryhmätestaussuunnitelma 10(22) 4.1.2 Tiedon käyttäjien palvelut Alla puolestaan on listattuna tiedon käyttäjien teknisen rajapinnan palvelut sekä kanavat, joiden kautta palvelu on käytettävissä. Aineistotilaus (uusi tilaus, tilauksen mitätöiminen) o WS reaaliaikainen, yksi aineisto kerrallaan o WS viivästetty, yksi aineisto kerrallaan o SFTP viivästetty, yksi aineisto kerrallaan Aineistotilauksen sisältävä aineisto (aineiston mitätöiminen) o WS reaaliaikainen, yksi aineisto kerrallaan o WS viivästetty, yksi aineisto kerrallaan o SFTP viivästetty, yksi aineisto kerrallaan Viesti (uusi viesti) o WS reaaliaikainen, yksi viesti kerrallaan o WS viivästetty o SFTP viivästetty. Palkkatietoilmoitukset kaikki tulonsaajat o SFTP Palkkatietoilmoitukset useita tulonsaajia o SFTP Palkkatietoilmoitukset useita maksajia o SFTP Palkkatietoilmoitukset useita maksajia, useita tulonsaajia o SFTP Palkkatietoilmoitukset useita työeläkelaitoksia o SFTP Palkkatietoilmoitukset puuttuva työeläkejärjestelynumero o SFTP Työnantajan erillisilmoitukset kaikki maksajat o SFTP Työnantajan erillisilmoitukset useita maksajia o SFTP Työnantajan erillisilmoitukset useita työeläkelaitoksia o SFTP Osapuolelle lähetetyt viestit o SFTP Osapuolen käyttäjien käyttölokitiedot o SFTP Palkkatietoilmoitukset yksi tulonsaaja o WS reaaliaikainen Palkkatietoilmoitukset yksi maksaja o WS reaaliaikainen Palkkatietoilmoitukset yksi työeläkejärjestelynumero o WS reaaliaikainen Työnantajan erillisilmoitukset yksi maksaja o WS reaaliaikainen Työnantajan erillisilmoitukset yksi työeläkejärjestelynumero

Tulorekisterihanke Sidosryhmätestaussuunnitelma 11(22) o WS reaaliaikainen Osapuolelle lähetetyt viestit o WS reaaliaikainen.

Tulorekisterihanke Sidosryhmätestaussuunnitelma 12(22) 4.2 Käyttöoikeudet 4.2.1 Käyttöoikeudet rajapinnat 4.2.1.1 Tiedon tuottajat Rajapinnan testauksen edellytyksenä on Verohallinnon myöntämä testivarmenne. Jokaisella teknisen rajapinnan testaajataholla tulee olla uniikki testivarmenne omaa testausta varten. Sidosryhmätestauksen varmennetta käytetään sidosryhmätestauksen aikana sidosryhmätestausympäristössä. Varmenteen avulla varmistutaan testausosapuolen aitoudesta sekä huolehditaan tietoliikenteen tietoturvallisuudesta testauksen aikana. Varmenneratkaisun rajapintakuvaus julkaistaan loka-marraskuun vaihteessa 2017 ja testaussopimuksen tekeminen ja varmenneratkaisun hakeminen kuvataan testausohjeessa (Liite 1), joka julkaistaan joulukuussa 2017. Tuotantokäyttöön liittyvä varmenne ja palvelusopimus tehdään erikseen syksyllä 2018. Tiedon tuottajan teknisen rajapinnan palveluiden testaajana voi toimia palkkahallinnon ohjelmistotalo, tai vaihtoehtoisesti palkkatiedon tuottaja, joka rakentaa oman teknisen rajapinnan tulorekisteriin. Testivarmenteet toimitetaan joko suoraan palkkatiedon tuottajalle tai ohjelmistotaloille, jolloin jokaiselle ohjelmistotalon palkka-aineistoja tuottavalle asiakasyritykselle luodaan tarvittaessa oma testivarmenne. Ohjelmistotalo tai palkkatiedon tuottaja tekee testaussopimuksen, josta ilmenevät muun muassa seuraavat tiedot: Tiedon tuottajan organisaation tiedot Testauksen yhteyshenkilö Tekninen yhteyshenkilö Käytettävät palvelut testausvaiheessa. 4.2.1.2 Tiedon käyttäjät Testaussopimuksen perusteella tulorekisterihanke toimittaa testaajataholle tiedot varmenteen noutamista varten. Tiedon käyttäjä tekee ennen sidosryhmätestauksen aloittamista testaussopimuksen, josta ilmenevät muun muassa seuraavat tiedot: Tiedon käyttäjän organisaation tiedot Käytettävät palvelut testausvaiheessa Testauksen yhteyshenkilö Tekninen yhteyshenkilö Testaussopimuksen perusteella tulorekisterihanke toimittaa testaajataholle tiedot varmenteen noutamista varten.

Tulorekisterihanke Sidosryhmätestaussuunnitelma 13(22) Jokaisella tiedon käyttäjällä on tiedonsaantiprofiili, joka on määritelty yhteistyössä tulorekisterihankkeen kanssa syksyllä 2017. Sidosryhmätestauksessa käytetään samoja profiilinimiä kuin tuotannossa. 4.2.2 Käyttöoikeudet sähköinen asiointipalvelu Sähköisen asiointipalvelun roolien ja käyttövaltuuksien testaus tapahtuu osana sähköisen asioinnin testausta. Tähän liittyvä käyttövaltuustestaus kuvataan sähköisen asiointipalvelun sidosryhmätestaussuunnitelmassa (Liite 2). 4.3 Sähköinen asiointipalvelu (suunnitelma julkaistaan 4/2018) 4.3.1 Tiedon tuottaja Sähköisen asiointipalvelun testauksesta laaditaan erillinen sidosryhmätestaussuunnitelma (Liite 2). Asiointipalvelun testaussuunnitelma julkaistaan huhtikuussa 2018. Sähköisen asiointipalvelun testaus avataan testausympäristöön sidosryhmille kesällä 2018. Seuraavissa kappaleissa luetellaan ne asiointipalvelun toiminnot, jotka tulevat testattavaksi. Sähköisen asiointipalvelun latauspalvelu julkaistaan sidosryhmätestausympäristöön huhtikuussa 2018. Testausohje (Liite 1) päivitetään latauspalvelun osalta helmikuussa 2018. Alla on listattu sähköisen asiointipalvelun toiminnot, joita tiedon tuottajat voivat testata: Palkkatietoilmoitusten lisääminen (verkkolomake) Palkkatietoilmoitusten haku ja katselu Palkkatietoilmoituksen korjaaminen Palkkatietoilmoituksen mitätöiminen Työnantajan erillisilmoituksen lisääminen (verkkolomake) Työnantajan erillisilmoituksen haku ja katselu Työnantajan erillisilmoituksen korjaaminen Työnantajan erillisilmoituksen mitätöiminen Palkkatietoilmoitus Aineistojen haku ja katselu (latauspalvelu) Palkkatietoilmoitus Aineiston lisääminen (latauspalvelu) Palkkatietoilmoitus Aineiston mitätöiminen (latauspalvelu). 4.3.2 Tiedon käyttäjä Tässä puolestaan tiedon käyttäjien testattavissa olevat sähköisen asiointipalvelun toiminnot: Palkkatietoilmoitusten haku ja katselu Työnantajan erillisilmoituksen haku ja katselu Aineistotilauksen lisääminen

Tulorekisterihanke Sidosryhmätestaussuunnitelma 14(22) Aineistotilausten haku ja katselu Aineistotilauksen ylläpito Aineistotilauksen päättäminen Asiakkaan perustiedot Haku ja katselu. 4.3.3 Yhteiset (Tiedon tuottajat ja tiedon käyttäjät) Toiminnot, joita sekä tiedon tuottajat että tiedon käyttäjät voivat testata: Aineistotilauksen lisääminen Aineistotilausten haku ja katselu Aineistotilauksen ylläpito Aineistotilauksen päättäminen Asiakirjat Haku ja katselu Käyttöloki Haku ja katselu Viestit Lähettäminen Viestit Haku ja katselu Omat perustiedot Katselu Omat perustiedot, Henkilöasiakas Ylläpitäminen Omat perustiedot, Yritysasiakas Ylläpitäminen. 4.3.4 Sähköisen asiointipalvelun tuetut selaimet Taulukossa 1 on lueteltu tulorekisterin sähköisen asiointipalvelun tuetut selaimet. Selain/Käyttöjärjestelmä Versiot Internet Explorer IE 11 Edge Tuetaan alkaen versiosta 14 (kevät 2016) Safari Tuetaan alkaen versiosta 10 (syksy 2016) Chrome Firefox Tuetaan juoksevasti kahta viimeisintä versiota Tuetaan juoksevasti kahta viimeisintä versiota Android Tuetaan selainten (Chrome, Firefox, AOSP Browser, Samsung Internet) viimeisintä versiota laitteilla, joissa Android 6.0 (Marshmallow) ja ylöspäin (2015 syksy). ios Tuetaan alkaen ios 10 (syksy 2016) Taulukko 1: Tuetut selaimet tulorekisterin asiointipalvelussa.

Tulorekisterihanke Sidosryhmätestaussuunnitelma 15(22) 5 Testausympäristöt Tässä testaussuunnitelmassa kuvattava testaus tapahtuu sidosryhmätestausympäristössä. Sidosryhmätestausympäristön toiminta ja suorituskyky testataan ja tietoturva-auditoidaan ennen ympäristön avausta sidosryhmätestausta varten 1.3.2018. 5.1 Testausympäristön käyttöaika Sidosryhmätestausympäristö on käytössä ja ympäristön vikatilanteisiin reagoidaan virkaaikana ma pe klo 8.00 16.00 (ei arkipyhinä). Testaus on sallittua muinakin aikoina, mutta ympäristön toimivuutta ei voida tällöin taata. 5.2 Testausympäristön konfiguraatiot Testausympäristön tuotannosta poikkeavat konfiguraatiot/käsittelysäännöt listataan ja toimitetaan sidosryhmille tiedoksi (Liite 5) ennen testauksen aloitusta. Tällaisia ovat esimerkiksi palkkatietoilmoituksen palkanmaksukausi, jossa päivämäärä 1.1.2019 tullaan korvaamaan testausympäristössä testauksen kannalta sopivalla päivämäärällä: Suorituksen maksupäivä tai muu ilmoituspäivä (PaymentDate) Käsittelysääntö: Tieto ei saa olla aikaisempi kuin 1.1.2019 eikä yli 45 päivää kuluvasta päivästä eteenpäin.

Tulorekisterihanke Sidosryhmätestaussuunnitelma 16(22) 6 Testiaineistot 6.1 Asiakasaineisto Tulorekisterihanke muodostaa testauksessa käytettävän asiakasaineiston, jota sidosryhmät käyttävät testauksessa. Testiaineiston muodostamisessa ei käytetä pohjana tuotantodataa, vaan aineisto muodostetaan generoimalla fiktiivistä asiakasdataa. Testiaineisto muodostetaan mahdollisimman tuotannon kaltaiseksi ja aineisto sisältää sekä henkilötunnuksia että Y-tunnuksia. Tulorekisterihanke on saanut testiaineistoihin liittyviä toiveita sidosryhmiltä ja asiakasaineiston muodostamisessa huomioidaan mahdollisuuksien mukaan nämä tarpeet. Tulorekisterihanke toimittaa jokaiselle testaavalle sidosryhmälle asiakasaineiston ennen testauksen aloitusta. Tulorekisterihankkeen muodostaman aineiston lisäksi sidosryhmät voivat käyttää testauksessa omia testiasiakkaitaan. Koska kyseessä on rakenteilla olevan järjestelmän testausympäristö, ei käytettävä testiaineisto saa olla tuotantodataa. Tämä perustuu EU:n tietosuoja-asetukseen (artiklat 25 ja 32). Jos testiaineisto on muodostettu hyödyntämällä tuotannon dataa, tietojen tulee olla anonymisoitu siten, että asiakastietoja ei voi yhdistää eikä palauttaa tuotannon asiakastietoihin. Ohje tuotantodatasta muodostetun asiakasdatan anonymisointiin toimitetaan sidosryhmille erikseen hyvissä ajoin ennen testauksen aloitusta (Liite 7). Jos testauksessa käytetään sidosryhmän omia testiasiakkaita, käytettävien asiakkaiden tiedot tulee toimittaa ennen testauksen aloitusta tulorekisterihankkeelle. Tulorekisterihanke tallentaa testiasiakkaat tulorekisterin sidosryhmätestausympäristön tietokantaan. Tarkemmat ohjeet ja pohja asiakastietojen toimittamiseen kuvataan testausohjeessa (Liite 1). 6.2 Palkkatietoaineisto Tiedon tuottajan lähettämä palkkatietoaineisto ei saa sisältää tuotannon dataa. Koska kyseessä on rakenteilla olevan järjestelmän testausympäristö, ei käytettävä testiaineisto saa olla tuotantodataa. Tämä perustuu EU:n tietosuoja-asetukseen (artiklat 25 ja 32). Jos palkkatietojen testiaineisto on muodostettu hyödyntämällä tuotannon dataa, tietojen tulee olla anonymisoitu siten, että tietoja ei voi yhdistää eikä palauttaa tuotannon tietoihin. Ohje tuotantodatasta muodostetun palkkatietoaineiston anonymisointiin toimitetaan sidosryhmille erikseen hyvissä ajoin ennen testauksen aloitusta (Liite 7). Tiedon käyttäjien end-to-end-testausta varten tulorekisterihanke voi muodostaa tiedon käyttäjän tarpeisiin sopivaa palkkatietoaineistoa tulorekisterijärjestelmään. Palkkatietoaineistojen muodostamista varten tiedon käyttäjä toimittaa tulorekisterihankkeelle palkkatietoaineiston tiedot sovitussa muodossa. Tarkemmat ohjeet ja pohja palkkatietoilmoitusten toimittamiseen kuvataan testausohjeessa (Liite 1). 6.3 Testiaineiston simulointi tulevaisuuteen Aineistoja on tarve testata tulevaisuuden päivämäärillä, jotta voidaan varmistua aineistojen eheydestä myös tulevaisuudessa. Tämä otetaan testauksessa huomioon sallimalla päivämäärien asettaminen pitkälle tulevaisuuteen. Päivämääriä koskevat testiympäristön konfiguraatiot on kuvattu liittessä 5: Sidosryhmätestausympäristön konfiguraatiot.

Tulorekisterihanke Sidosryhmätestaussuunnitelma 17(22) 7 Testauksen havainnot Tulorekisterihanke ylläpitää tulorekisteri.fi-sivustolla listaa sellaisista testauksessa havaituista virheistä, jotka vaikuttavat olennaisesti testaukseen. Seuraavassa luvussa ja kuvassa 2 esitetään havaintojen hallinnan käsittelyprosessi. 7.1 Havaintojen hallinnan prosessi Kaikki testauksessa esiin nousevat tulorekisterin toimintoihin liittyvät havainnot toimitetaan tulorekisterihankkeelle havaintolomakkeella. Linkki lomakkeeseen toimitetaan testaavalle taholle testaussopimuksen käsittelyn jälkeen. Kaikki havainnot käsitellään ja järjestelmän virheet ohjataan korjattavaksi. Virhe: Jos havainto on virhe, tulorekisterihankkeen testauskoordinaattori ohjaa virheen korjaukseen ja priorisoi korjauksen yhdessä hankkeen virheraadin kanssa. Arvio virheen korjausaikataulusta ilmoitetaan havainnon tekijälle. Muutos: Jos havainto ei ole virhe vaan muutos olemassa olevaan toimintaan, tulorekisterihanke käsittelee havainnon muutospyyntönä. Muutospyyntö joko hyväksytään tai hylätään, ja havainnon tekijä saa tästä tiedon sähköpostitse. Ohjeistus: Jos havainto on sellainen, jossa käyttäjä on ymmärtänyt toiminnon väärin tai on mahdollisesti käyttänyt toimintoa ohjeen vastaisesti, tulorekisterihankkeen testauskoordinaattori ohjeistaa havainnon laatijaa ja tarkistaa olemassa olevan ohjeen oikeellisuuden. Kysymys: Jos havainto on sellainen, johon on jo valmis vastaus, tulorekisterihankkeen testauskoordinaattori lähettää vastauksen kysymyksen tekijälle. Lisäksi tulorekisteri.fi-sivuston Kysymyksiä ja vastauksia -osioon lisätään usein kysyttyjä kysymyksiä. Kuva 2: Havaintojen hallinnan prosessi.

Tulorekisterihanke Sidosryhmätestaussuunnitelma 18(22) 7.2 Virheiden luokittelu Virheet luokitellaan taulukon 2 mukaisesti. Testaaja antaa virheelle sopivaksi katsomansa virheluokan havainnon kirjaamisen yhteydessä. Lopullisen luokittelun tekee tulorekisterihankkeen virheraati, joka koostuu tulorekisterihankkeen asiantuntijoista. Jos virheraati päättää laskea 1- tai 2-tason virheeksi luokitellun virheen virheluokkaa matalammaksi, havainnon ilmoittaja saa tästä tiedon. Virheen kriittisyys käydään läpi testaajan kanssa ja tarvittaessa virheluokkaa voidaan muuttaa. Virheluokka Kuvaus 1 Critical / Kriittinen Virhe korjataan mahdollisimman nopeasti. Vika, joka estää testauksen jatkumisen. Lisäksi hyväksyttävää tapaa kiertää ongelma ei ole. 2 High / Vakava Vika, joka estää yhden tai useamman järjestelmäkomponentin toiminnan. On kuitenkin olemassa hyväksyttävä tapa kiertää ongelma. 3 Medium / Keskivakava Vika, joka aiheuttaa järjestelmän väärän, vaillinaisen tai epäjohdonmukaisen tuloksen. 4 Low / Vähäinen Pieni tai kosmeettinen vika, jolla on hyväksyttäviä kiertotapoja halutun lopputuloksen saamiseksi. Taulukko 2: Virheluokat. 7.3 Korjausten toimittaminen sidosryhmätestaukselle Virheet korjataan prioriteettijärjestyksessä virheluokan mukaisesti. Virheluokkaan 1 ja 2 luokitellut virheet otetaan aina käsittelyyn ja korjataan. Virheluokan 3 ja 4 virheilmoitukset käsitellään ja päätös korjauksesta tehdään tapauskohtaisesti. Korjaukset järjestelmään toimitetaan liitteessä 8 kuvatun julkaisuaikataulun mukaisesti. Järjestelmän julkaisun yhteydessä tulorekisterihanke laatii toimitusselosteen, joka sisältää järjestelmään päivitetyt muutokset sekä korjaukset. Toimitusseloste lähetetään sähköpostitse sidosryhmien testausyhteyshenkilöille hyvissä ajoin ennen uutta järjestelmän julkaisua. Lisäksi toimitusselosteet julkaistaan tulorekisteri.fi-sivustolla. Virheet, jotka on luokiteltu virheluokkaan 1 (Critical / Kriittinen) korjataan mahdollisimman pian, ja korjaukset toimitetaan sidosryhmätestausympäristöön tarvittaessa myös ennalta määritellyn julkaisuaikataulun ulkopuolella. Järjestelmäpäivitykset tehdään arkipäivinä aktiivisen testausajan (ma pe klo 8 16) ulkopuolella. Päivityksestä ja mahdollisesta testauskatkosta tiedotetaan sidosryhmiä.

Tulorekisterihanke Sidosryhmätestaussuunnitelma 19(22) 8 Laajojen aineistojen erillistestit 9 Testauksen lopetus Tulorekisterihanke tekee suorituskykytestauksen sidosryhmätestausympäristölle ennen testauksen aloitusta. Suorituskykytestaus toteutetaan syksyllä 2017. Tulorekisterin oman suorituskykytestauksen lisäksi eri sidosryhmillä on mahdollisuus testata rajapintoja suurilla massoilla. Massatestaukset sovitaan erikseen jokaisen sidosryhmän kanssa. Eri sidosryhmien massatestaus aikataulutetaan siten, että kaikki sidosryhmät eivät testaa samanaikaisesti. Sidosryhmien laajojen aineistojen erillistestauksesta laaditaan oma testaussuunnitelma (Liite 4). Jokaisen sidosryhmän tulee suorittaa testaus niiden palveluiden osalta, joita sidosryhmä tulee käyttämään tulorekisterissä. Kun testaus on tehty, toimitetaan tieto testauksen päättymisestä sähköpostitse osoitteeseen yht_tulorekisteri_testaus@vero.fi. Tulorekisterihanke tarvitsee tiedon testausten valmiusasteesta voidakseen arvioida jäljellä olevaa testauksen määrää. Tulorekisterihanke tulee olemaan yhteydessä sidosryhmiin testauksen etenemisestä ja valmiusasteesta myös testauksen aikana. Sellaiset tulorekisteriin kohdistuvat virheilmoitukset, jotka sidosryhmä toivoo käsiteltävän ja korjattavan ennen 1.1.2019 käyttöönottoa, tulee toimittaa 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. 10 Testauksen osapuolet ja kommunikointi Tulorekisterihanke edellyttää sidosryhmiltä yhteyshenkilöiden yhteystietoja viestinnän varmistamiseksi. Oman organisaation testausyhteyshenkilöt voi ilmoittaa osoitteseen: yht_tulorekisteri_testaus@vero.fi

Tulorekisterihanke Sidosryhmätestaussuunnitelma 20(22) 10.1 Tulorekisterihankkeen sidosryhmätestauksen yhteystahot Taulukossa 3 on luettelo tulorekisterihankkeen kontaktipisteistä. Sidosryhmätestauksen kommunikointikanava toimii myös tiedon välittäjänä end-to-end-testauksessa ja auttaa sopivien testauskumppaneiden etsimisessä tiedon tuottajien ja tiedon käyttäjien välillä. Kontakti Sidosryhmätestauksen kommunikointikanava Tekniset kysymykset Toiminnalliset kysymykset Sähköposti YHT_tulorekisteri_testaus@vero.fi YHT.Tulorekisteri_tekninen@vero.fi YHT.Tulorekisteri_toiminnallinen@vero.fi Taulukko 3: Tulorekisterihankkeen kontaktit. 10.2 Sidosryhmätestauksen tiedotus Sidosryhmätestauksesta järjestetään infotilaisuus helmikuussa 2018. Tilaisuudessa käydään läpi rajapintatestauksen testausohje (Liite 1) ja havaintojen kirjaamiseen liittyvät yksityiskohdat. Yhteisiä testaukseen keskittyviä tilaisuuksia tullaan järjestämään tarpeen mukaan. Näistä tiedotetaan erikseen. Sidosryhmätestaukseen ja sidosryhmätestausympäristöön liittyvistä asioista tiedotetaan sidosryhmiä sähköpostitse sekä tulorekisteri.fi-sivustolla. Alla on lueteltu aihealueita, joista tulorekisterihanke tiedottaa sidosryhmiä: Testausympäristön häiriötiedotteet Testausympäristön uudet versiot Toimitusselosteet Testausympäristöön versioiden ulkopuolella asennettavat ylimääräiset korjaukset Testausympäristön mahdolliset käyttökatkot Muut tiedotettavat asiat. 11 Rajaukset Tämä testaussuunnitelma kuvaa sidosryhmätestauksen pääperiaatteet seuraavin rajauksin: Sidosryhmätestaussuunnitelmassa ei kuvata tulorekisterihankkeen sisäisiä testausvaiheita eikä testauksen tuloksia. Sidosryhmätestaussuunnitelmassa ei määritellä, milloin kukin sidosryhmä oman testauksensa aloittaa. Sidosryhmät vastaavat itse oman osuutensa suunnittelusta ja läpiviennistä. Sidosryhmätestaussuunnitelmassa ei määritellä, milloin kunkin sidosryhmän testaus on valmis. Testauksen hyväksyntä on jokaisen sidosryhmän oman testausorganisaation vastuulla.

Tulorekisterihanke Sidosryhmätestaussuunnitelma 21(22) Tulorekisterihanke ei koordinoi kokonaisuutena tiedon tuottajien ja tiedon käyttäjien välistä testausta. Tulorekisterihanke voi tarvittaessa avustaa sopivan testauskumppanin löytymisessä end-to-end-testauksessa, mutta testauksen varsinainen koordinointi tulee hoitaa sidosryhmien kesken. Sidosryhmätestaussuunnitelmassa ei kuvata sidosryhmien omissa ohjelmistoissa havaittujen virheiden seurantaa ja koordinointia. Ohjelmistotoimittajan ja tämän asiakkaan pitää selvittää ja koordinoida sidosryhmien ohjelmistojen virhetilanteet. Sidosryhmätestaussuunnitelmassa ei kuvata tiedon tuottajien ja tiedon käyttäjien liiketoiminnallista testausta. Sidosryhmät vastaavat itse omien järjestelmiensä toiminnallisuuksista ja välitettävistä tietosisällöistä. Tulorekisterihanke pidättää itsellään oikeuden muuttaa mitä tahansa aikataulua tai tässä ilmoitettua suunnitelmaa. 12 Liitteet Kaikki liitteet julkaistaan tulorekisteri.fi-sivustolla Nro Nimi Julkaisuajankohta 1 Testausohje 12/2017 2 Sähköisen asiointipalvelun sidosryhmätestaussuunnitelma 04/2018 4 Laajojen aineistojen erillistestaussuunnitelma 04/2018 5 Sidosryhmätestausympäristön konfiguraatiot 12/2017 6 Testaussopimuspohja 12/2017 7 Ohje testiaineiston anonymisoinnista 12/2017 8 Tulorekisterin julkaisuaikataulu 25.10.2017