1(14) SISÄLLYSLUETTELO 1 Testauksen aloitus... 4 2 Testaussopimus... 4 3 Testiosoitteet... 5 4 Varmennepalvelun testivarmenteen muodostusohje... 5 4.1 Testivarmenteen muodostamisen edellytykset... 5 5 Varmenteen käyttö tulorekisterin rajapinnoissa... 6 5.1 Aineiston allekirjoitus... 6 5.2 Tunnistaminen Web Service -kanavissa... 6 5.3 Tunnistaminen SFTP-kanavassa... 7 6 Testiaineistot... 7 6.1 Asiakasaineistot... 7 6.1.1 Tulorekisterin testiasiakasaineistot... 7 6.1.2 Sidosryhmän omien testiasiakkaiden lisäys tulorekisterin sidosryhmätestausympäristöön... 8 6.1.3 Toimitettavan aineiston muodostus... 8 6.2 Palkkatietoaineistot... 10 6.3 Koodistot... 10 7 Sidosryhmätestaus... 10 8 Suositeltavia testitapauksia tiedon tuottajille... 11 9 Havaintojen raportointi... 11 9.1 Ohje havaintolomakkeen kenttien täyttöön:... 11 9.2 Esimerkki kirjatusta havainnosta... 12 9.3 Havainnon ohjaus korjaukseen... 12 9.4 Virhe, joka estää testaamisen... 12 9.5 Muutospyyntö... 13 9.6 Toimitusseloste... 13 9.7 Viimeinen julkaisu sidosryhmätestausympäristöön... 13 10 Testauksen lopettaminen... 13 11 Lisätietoa... 14
2(14) Versiohistoria Versio Päivämäärä Kuvaus 1.0 21.12.2017 Dokumentti julkaistu. KESKEISET TERMIT JA NIIDEN SELITTEET Lyhenne tai termi Asiakasaineisto CSR (Certificate Signing Request) varmenteen allekirjoituspyyntö SMS-viesti Testivarmenne Testaava organisaatio Tekninen yhteyshenkilö Testauksen yhteyshenkilö Tiedon käyttäjät Selite Tulorekisterin sidosryhmätestauksessa käytettävä anonymisoitu aineisto, joka koostuu testiasiakkaiden tiedoista. Varmennepalvelun käyttäjän tekemä varmennepyyntö. Tekstiviesti. Lyhytsanoma, joka sisältää vain aakkosnumeerisia merkkejä ja erikoismerkkejä. Tulorekisterin varmennepalvelun myöntämä varmenne sidosryhmätestausta varten. Tulorekisterin sidosryhmätestaukseen osallistuva yritys tai organisaatio. Testaavan organisaation ilmoittama henkilö, jolle toimitetaan siirtotunnukset varmenteen noutoa varten. 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. 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. Varmennepalvelu Tulorekisterin käyttämä varmenteita tuottava palvelu.
3(14) Testaussopimus XML-allekirjoitus Sopimus, jonka sidosryhmä tekee Verohallinnon kanssa tulorekisterin rajapintojen 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. Voimassaolevalla varmenteella muodostettu XML-muotoinen allekirjoitus. Tulorekisterin sidosryhmätestauksessa testaava organisaatio allekirjoittaa lähettämänsä aineistot tulorekisterin varmennepalvelun myöntämällä testivarmenteella. Allekirjoituksella varmistetaan aineistojen eheys ja muuttumattomuus.
4(14) 1 Testauksen aloitus Kuvassa 1 kuvataan testauksen aloittamisen toimenpiteet. Kuva 1: Testauksen aloitus 2 Testaussopimus Testaussopimukset ovat sisällöltään erilaisia riippuen siitä, tehdäänkö testaussopimus tiedon tuottajana vai tiedon käyttäjänä. Jos sidosryhmä toimii sekä tuottajan että käyttäjän roolissa, tulee sopimukset tehdä erikseen tuottajan testaukseen ja käyttäjän testaukseen. Tiedon käyttäjien kanssa testauksesta ja sopimuksista sovitaan erikseen. 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, lähetetään sopimuksella ilmoitetulle testauksen yhteyshenkilölle sähköpostitse testauksessa tarvittavat tiedot ja tekniselle yhteyshenkilölle sähköpostilla ja tekstiviestillä varmenteen muodostamiseen tarvittavat tiedot. Sopimus tulee tehdä kaksi viikkoa ennen suunniteltua testauksen aloittamista. Sopimuksen voi tehdä helmikuussa 2018.
5(14) 3 Testiosoitteet Tulorekisterihanke toimittaa varmennepalvelun testiosoitteen sekä rajapintojen testiosoitteet testauksen yhteyshenkilölle sen perusteella, mitä palveluja ja teknisiä rajapintoja sidosryhmä on sopimuksella ilmoittanut testaavansa. 4 Varmennepalvelun testivarmenteen muodostusohje Testivarmenteiden pyytäminen ja nouto voidaan aloittaa, kun testaussopimus on toimitettu tulorekisterihankkeelle, testaussopimus on käsitelty ja tekninen yhteyshenkilö on saanut testivarmenteen noutoon tarvittavat tunnukset. Testausyhteyshenkilö saa voimassa olevasta testaussopimuksesta palauteviestin tulorekisterihankkeelta. Testausyhteyshenkilölle toimitetaan varmenteen muodostamista varten keinotekoinen Y-tunnus. Jos sidosryhmä on tehnyt testaussopimuksen sekä tuottajan että käyttäjän roolissa, myös varmenteita tarvitaan kaksi. Testivarmenne on määräaikainen ja voimassa kaksi vuotta myöntöpäivästä. Jos varmenteen haussa tai käyttämisessä ilmenee ongelmia, testaava organisaatio lähettää viestin osoitteeseen YHT_Tulorekisteri_testaus@vero.fi. Tulorekisterihanke aloittaa toimenpiteet ongelman selvittämiseksi viimeistään seuraavana arkipäivänä. 4.1 Testivarmenteen muodostamisen edellytykset 1. Testaussopimus on täytetty ja toimitettu tulorekisterihankkeelle ja käyttöehdot on hyväksytty. 2. Testaussopimuksessa on ilmoitettu teknisen yhteyshenkilön tiedot: Etunimi Sukunimi Matkapuhelinnumero (maakoodin sisältävässä muodossa, esimerkiksi +35840 123 4567) Sähköpostiosoite 3. Tekninen yhteyshenkilö saa tulorekisterin lähettämänä SMS-viestin, joka sisältää PIN-koodin. Vastaanottaja saa myös turvapostilla viestin, joka sisältää kaksi yksilöivää tunnusta: siirtotunnuksen (TransferId) ja kertakäyttöisen salasanan (OTP). Kyseinen viesti on mahdollista avata vain SMSviestissä lähetetyllä PIN-koodilla. Nämä viestit toimitetaan kahden viikon kuluessa siitä, kun sidosryhmä on toimittanut sopimuksen tulorekisterihankkeelle. Tekninen yhteyshenkilö liittää siirtotunnuksen ja kertakäyttösalasanan muodostamaansa varmennepyyntöön ja lähettää sen varmennepalveluun noutotunnuksen (RetrivalId) muodostamista varten. 4. Varmennepalvelu vastaanottaa varmennepyynnön ja muodostaa noutotunnuksen ja toimittaa sen vastaanottajalle. 5. Tekninen yhteyshenkilö saa vastaanottokuittauksessa noutotunnuksen, jonka avulla tekninen yhteyshenkilö lähettää varmennehaun.
6(14) 6. Varmennepalvelu vastaanottaa varmennehaun ja palauttaa testivarmenteen tekniselle yhteyshenkilölle. 7. Tekninen yhteyshenkilö vastaanottaa testivarmenteen ja tallentaa sen ohjelmistoonsa 8. Rajapintatestaus voi alkaa. Kuva 2: Varmenneprosessin tekninen eteneminen varmenteiden muodostamiseksi. Testivarmenteet muodostetaan WS-kuvausten mukaisesti. Tulorekisterin dokumentaatio -sivulla on tarkemmat tekniset ohjeet toteutukseen. 5 Varmenteen käyttö tulorekisterin rajapinnoissa Varmenteen käyttötavat on dokumentoitu tulorekisterin dokumentissa Tekninen rajapinta Soveltamisohje (pdf). Testivarmennetta käytetään aineistojen allekirjoittamiseen sekä osapuolen tunnistamiseen. 5.1 Aineiston allekirjoitus Testaava organisaatio allekirjoittaa aineiston XML-allekirjoituksella varmennepalvelun organisaatiolle myöntämällä testivarmenteella. Allekirjoitus muodostetaan rajapintakuvauksen mukaisesti ja se liitetään aineistoon rajapintakuvauksen skeeman mukaisesti ennen aineiston lähettämistä tulorekisteriin. 5.2 Tunnistaminen Web Service -kanavissa
7(14) Web Service -kanavissa lähettävä organisaatio tunnistetaan varmenteen avulla. Organisaatio käyttää varmennetta Web Service -kanavassa SSL/TLSasiakasvarmenteena, jonka perusteella tulorekisteri tunnistaa lähettävän organisaation. 5.3 Tunnistaminen SFTP-kanavassa 6 Testiaineistot 6.1 Asiakasaineistot SFTP-kanavassa organisaatio tunnistetaan varmenteeseen liittyvien julkisen ja yksityisen avainparin avulla. Tunnistamisessa ei siis suoraan käytetä varmenteita vaan niihin liittyviä avaimia. Tunnistamisessa organisaatio käyttää omaa yksityistä avaintaan ja tulorekisterin hallussa on tätä avainta vastaava organisaation julkinen avain. 6.1.1 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 protection 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 anonymisoitu siten, että ne ovat muodollisesti oikeanlaisia ja läpäisevät tarkistukset. Ohje testiaineiston anonymisoinnista ks. Liite 7. Testaussopimuksen käsittelyn jälkeen lähetetään sidosryhmän ilmoittamalle testauksen yhteyshenkilölle sähköpostilla (pdf-tiedosto) testauksessa käytettävät anonymisoidut Y-tunnukset ja henkilötunnukset nimitietoineen. Palkkatietoilmoitukset menevät läpi vaikka nimi olisikin erilainen, mutta silti suositellaan, että käytetään tulorekisterihankkeen ilmoittamia nimiä. Jokaiselle testaavalle organisaatiolle toimitetaan 40 Y-tunnusta ja 200 henkilötunnusta. Tunnukset valitaan sattumanvaraisesti. Sidosryhmät voivat itse valita, kuinka monta palkansaajaa kullakin Y-tunnuksellisella maksajalla on. Myös henkilötunnukset voi liittää Y-tunnukseen omavalintaisesti. Testiasiakkaita saa tulorekisterihankkeelta tarvittaessa lisää. Jos testaava organisaatio haluaa enemmän testiasiakkaita, lähetetään pyyntö osoitteeseen YHT_Tulorekisteri_testaus@vero.fi. Pyydetyt testiasiakkaat lähetetään yhteyshenkilölle viimeistään kolmantena arkipäivänä pyynnön saapumispäivästä.
8(14) 6.1.2 Sidosryhmän omien testiasiakkaiden lisäys tulorekisterin sidosryhmätestausympäristöön Tulorekisterihanke voi tarvittaessa viedä sidosryhmän omia anonymisoituja testiasiakkaita tulorekisterin sidosryhmätestausympäristöön niiden testiasiakkaiden lisäksi, jotka tulorekisterihanke on testauksen aloittamisen hetkellä toimittanut. Omia testiasiakkaita voi toimittaa kohtuullisen määrän, esimerkiksi 10 Y-tunnusta ja 40 henkilötunnusta. Tätä varten sidosryhmä toimittaa asiakastiedot CSV-formaatissa 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ö- tai Y-tunnus eri nimellä), olemassa olevan testiasiakkaan tietoja ei muuteta tulorekisterin sidosryhmätestausympäristöön. Tunnus löytyy jatkossakin niillä tiedoilla, jolla se on sinne ensimmäisenä 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.csv / Arek_y_tunn_testiasiakkaat1.csv Anna lähetettävälle tiedostolle numero, jotta on tarvittaessa mahdollista lähettää jatkossa useampia samantyyppisiä testiasiakasaineistoja. 6.1.3 Toimitettavan aineiston muodostus Sidosryhmän oman testiaineiston muodostamista varten henkilötunnusten ja Y- tunnusten tiedot toimitetaan erillisinä tiedostoina.tiedostomuoto on CSV, ja merkistö UTF-8. Jokaisen testiasiakkaan tiedot annetaan omalla rivillään (rivinvaihto = CRLF) tässä järjestyksessä: ASTUNNUS = testiasiakkaan Y-tunnus tai henkilötunnus NIMI = yhteisön/yrityksen nimi (käytetään vain Y-tunnuksellisilla yrityksillä) ETUNIMI = testiasiakkaan etunimi SUKUNIMI = testiasiakkaan sukunimi TONIMI = toiminimen/elinkeinonharjoittajan nimi LUONN_LY = luonnollisen henkilön Y-tunnus (esim. toiminimissä) Ne kentät, joihin ei tule tietoa, merkitään tyhjinä erotinmerkkeinä. Kunkin rivin tulee sisältää kaikki tietokentät, jotta rakenne pysyy ehjänä. Jos kenttään ei tule tietoa, se merkitään kuitenkin kahden peräkkäisen lainausmerkin sarjana, pilkulla erotettuna. Henkilöasiakkaat Testiasiakkaille, joilla on henkilötunnus, ilmoitetaan vain seuraavat tiedot: ASTUNNUS ETUNIMI SUKUNIMI TONIMI (jos se on tiedossa, voi jättää myös tyhjäksi)
9(14) LUONN_LY Esimerkki henkilötunnuksista: ASTUNNUS,"NIMI","ETUNIMI","SUKUNIMI","TONIMI","LUONN_LY" 010658-803B,"","Aarno Ilmari","Pokkanen","","" 010527-800E,"","Helmi","Tahti","","" 010100A818U,"","Maria","Päki","","" Yritysasiakkaat Testiasiakkaille, joilla on Y-tunnus, ilmoitetaan seuraavat tiedot: ASTUNNUS NIMI Esimerkki Y-tunnuksista: ASTUNNUS,"NIMI","ETUNIMI","SUKUNIMI","TONIMI","LUONN_LY" 7085239-9,"Çlpo Testifirma OY","","","","" 7085600-7,"Huuli Testifirma OY","","","","" 7320145-2,"Ennajajoottii Testifirma KY","","","","" 7489520-6,"Vacaret Testifirma Muu kiint.oy","","","",""
10(14) 6.2 Palkkatietoaineistot 6.3 Koodistot Tiedon käyttäjät tarvitsevat testaukseen erilaisia palkkatietoaineistoja. Tulorekisterin sidosryhmätestauksessa käytetään lähtökohtaisesti palkkatietoilmoituksia, jotka muodostetaan tiedon tuottajien toimesta. Näiden lisäksi tulorekisterihanke voi tarvittaessa muodostaa palkkatietoaineistoja tulorekisterin sidosryhmätestausympäristöön käyttäjien tarpeisiin. Palkkatietoilmoitusten muodostamisessa hyödynnetään tulorekisterihankkeen tarjoamaa Excel-taulukkoa. Esimerkki taulukosta toimitetaan liitetiedostona sitä tarvitseville tiedon käyttäjille. Excel-pohjassa on alkuvaiheessa yksinkertainen esimerkki palkkatietoilmoituksesta ja exceliä laajennetaan testauksen edetessä ja tarpeiden tarkentuessa. Päivitetty versio taulukosta toimitetaan kaikille tahoille, joilla Excel-taulukko on käytössä. Excel-taulukon saa pyytämällä osoitteesta YHT_Tulorekisteri_testaus@vero.fi ja täytetty taulukko palautetaan samaan osoitteeseen. Excel-taulukossa lähetetyt palkkatietoaineistot ovat käytettävissä viimeistään kolmantena arkipäivänä saapumispäivästä, jos tiedot eivät sisällä virheitä. Virheellisistä tiedoista toimitetaan palaute viimeistään kolmantena arkipäivänä saapumispäivästä. Palaute palkkatietoaineiston onnistuneesta muodostamisesta sekä mahdollisista virheistä toimitetaan taulukon lähettäneelle taholle sähköpostitse. Sidosryhmätestauksessa käytettävät tulorekisterin koodistot on kuvattu dokumentissa Koodistot (pdf). Listaus eri tulolajien koodeista on 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. 7 Sidosryhmätestaus Kun sidosryhmätestauksen aloittamisen toimenpiteet on suoritettu, sidosryhmä voi aloittaa testauksen. Kuvassa 3 on kuvattu testauksen kulku sidosryhmätestauksen edetessä. Kuva 3: Sidosryhmätestausprosessi
11(14) 8 Suositeltavia testitapauksia tiedon tuottajille Palkkatietoja tulorekisteriin tuottavan ohjelmiston käyttämät rajapintapalvelut tulee testata sidosryhmätestausympäristössä jokaisessa kanavassa, joiden kautta aineistoja tullaan tuotannossa lähettämään. Mahdolliset kanavat tietojen lähettämiseen rajapinnan kautta ovat viivästetty ja reaaliaikainen Web Service sekä SFTP. Testaavan tahon vastuulla on suunnitella ja toteuttaa oman ohjelmistonsa testaus. Testattavia skenaariota ja kokonaisuuksia ovat esimerkiksi seuraavat. - Palkkatiedot o uusi palkkatietoaineisto yhdelle tulonsaajalle o uusi palkkatietoaineisto usealle tulonsaajalle o uusi palkkatietoaineisto erilaisilla maksajan tunnisteilla o palkkatietoaineiston korvaaminen o palkkatietoaineiston mitätöiminen o ilmoitustavat 1 ja 2 o sosiaalivakuuttamiseen liittyvät tilanteet o vakuuttamisen poikkeustilanteet o kansainväliset tilanteet - Työnantajan erillisilmoitus o uusi työnantajan erillisilmoitus o työnantajan erillisilmoituksen korvaaminen o työnantajan erillisilmoituksen mitätöiminen - Virheellisten aineistojen ja ilmoitusten lähettäminen ja virheilmoituksen sisältävän käsittelypalautteen ja vastaussanoman käsittely o skeemavirheet o liiketoimintasääntöjen tarkastusten virhetilanteet - Viestin lähettäminen 9 Havaintojen raportointi Testauksen havainnot toimitetaan tulorekisterihankkeelle käyttämällä havaintolomaketta. Lomake on yksisuuntainen ja jatkon kommunikointi havaintoon liittyen tapahtuu sähköpostitse. Lomakkeen käyttöön liittyvistä yksityiskohdista kerrotaan testaavalle taholle sopimuksen tekemisen jälkeen. 9.1 Ohje havaintolomakkeen kenttien täyttöön: 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. Havainnon tekijä: Testaava organisaatio. Havainnon tekijän sähköpostiosoite: Havainnon kirjaajan sähköpostiosoite. Havainnon havaitsemisajankohta: Päivämäärä ja kellonaika, jolloin tilanne havaittiin. Liite: Lähetetyn sanoman xml. Jos tilanteessa palautui sanoma tai jokin virheilmoitus, se liitetään myös tähän. Kuvaus: Mitä palvelua testattiin? (Esim. palkkatietoilmoitus, uusi/korvaava/mitätöinti) Mitä kanavaa testataan? (reaaliaikainen/viivästetty Web Service, SFTP) Mitä testaaja teki? Mitä testauksessa tapahtui? Mikä oli odotettu lopputulos, mitä olisi pitänyt tapahtua?
12(14) 9.2 Esimerkki kirjatusta havainnosta Otsikko: Uusi palkkatietoilmoitus tulolajilla 404 Lähdevero ei hyväksy negatiivista arvoa Virheluokka: 3 Medium / Keskivakava Havainnon tekijä: Ohjelmistotalo Testi Havainnon tekijän sähköpostiosoite: hemmo.testaaja@testi.fi Havainnon havaitsemisajankohta: 9.11.2017 klo 16:20 Liite: 404_palkkatietoilmoitus.xml, 404_response.xml Kuvaus: Testattiin uuden palkkatietoilmoituksen lähettämistä viivästetyssä Web Service - rajapinnassa. 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öpostilla 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öpostilla ja käyttää virheen tunnistetta viestin otsikossa. 9.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 yhteydessä, jos tulorekisterihankkeen virheraati muuttaa virheluokkaa tai jos havainnosta tarvitaan lisätietoa. Sidosryhmätestaukseen vaikuttavista virheistä tiedotetaan tulorekisteri.fi-sivustolla. 9.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. Virheen havaitsija saa tiedon virheen ohjauksesta korjaukseen sekä arvion vian korjausajasta. Lisäksi virhetilanteesta tiedotetaan tulorekisteri.fi-sivustolla. 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 reaaliaikaisessa Web Service -rajapinnassa ei onnistu. Perustelut: kriittinen virhe, koska estää palkkatietoilmoitusten lähetyksen kokonaan yhdessä kanavassa. Estää testaamisen kokonaan niiltä palkkatietojen tuottajilta, jotka käyttävät reaaliaikaista Web Service -rajapintaa.
13(14) 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. 9.5 Muutospyyntö 9.6 Toimitusseloste 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öpostilla osoitteeseen YHT.Tulorekisteri_toiminnallinen@vero.fi ja täytetty lomake palautetaan samaan osoitteeseen. Kun virheen korjaus on tehty ja testattu tulorekisterihankkeessa, se toimitetaan sidosryhmätestausympäristöön seuraavan julkaisun yhteydessä. Tulorekisterihanke laatii toimitusselosteen ennen uuden version asennusta. Toimitusselosteella luetellaan korjaukset sekä muutokset, jotka ovat versiossa mukana. Toimitusseloste lähetetään sidosryhmän testauksen yhteyshenkilöille julkaisua edeltävän torstain aikana. Lisäksi toimitusselosteet julkaistaan tulorekisteri.fi-sivustolla. Sidosryhmätestaussuunnitelman liitteessä 8 on kuvattu versioiden julkaisuaikataulu: Julkaisuaikataulu (pdf) 9.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, 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 lopettaminen Kun sidosryhmä on saanut oman rajapinta testauksensa päätökseen, sidosryhmä lähettää tästä sähköpostilla 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 tarkoitus on antaa tulorekisterihankkeen valmiusarviointia varten tieto siitä, että testanneen sidosryhmän näkökulmasta toteutetut liittymät ovat valmiit tuotantokäyttöön.
14(14) 11 Lisätietoa Sidosryhmätestaussuunnitelma (pdf) Koodistot Tulolajit (pdf) Julkaisuaikataulu (pdf) Koodistot (pdf) Tulorekisterin dokumentaatio Varmennepalvelu Yleiskuvaus (pdf) Varmennepalvelu Rajapintakuvaus (pdf) Varmennepalvelun tekninen rajapinta ZIP Sovelluskehittäjille Tekninen rajapinta - Soveltamisohje (pdf)