SISÄLLYSLUETTELO - Verohallinto...Verohallinto, Kela, Työllisyysrahasto sekä työeläkelaitokset ja ETK. Toisessa vaiheessa 1.1.2020 lähtien tiedon käyttäjiksi tulevat Potilasvakuutuskeskus,

1 (35) Kansallisen tulorekisterin SÄHKÖISEN ASIOINTIPALVELUN perustamishanke TESTAUSOHJE TIEDON TUOTTAJILLE Liite 2 sidosryhmätestaussuunnitelmaan

SISÄLLYSLUETTELO

1 Yleistä ................................................................................................................................ 6

2 Testauksessa käytettävät ympäristöt ja julkaisuversiot ....................................................... 6

3 Testauksen aloitus ............................................................................................................. 7

4 Testauksen aloitusilmoitus ja sen käsittely ......................................................................... 7

5 Testiasiakasaineistot .......................................................................................................... 8

5.1 Testitunnukset ............................................................................................................. 8

5.2 Asiakasaineistot .......................................................................................................... 9

5.2.1 Tulorekisterin testiasiakasaineistot ....................................................................... 9

5.2.2 Sidosryhmän omien testiasiakkaiden lisäys tulorekisterin sidosryhmätestausympäristöön .......................................................................................... 9

5.3 Koodistot ................................................................................................................... 10

6 Kirjautuminen sähköisen asiointipalvelun testausympäristöön .......................................... 11

6.1 Tunnistautuminen Suomi.fi-tunnuksilla ...................................................................... 12

6.2 Erityisryhmien ja ulkomaisten organisaatioiden tunnistautuminen Katso-tunnisteella 13

7 Valtuuksien testaus .......................................................................................................... 14

7.1 Valtuuksien myöntäminen Suomi.fi-valtuuksissa ....................................................... 14

7.2 Useiden asiakkaiden puolesta asiointi ....................................................................... 17

8 Tulotietojen ilmoittamisen testaus, verkkolomakkeet ........................................................ 18

8.1 Palkkatietoilmoitus .................................................................................................... 18

8.2 Työnantajan erillisilmoitus ......................................................................................... 18

8.3 Etuustietoilmoitus ...................................................................................................... 18

8.4 Ilmoitusten täyttäminen ............................................................................................. 19

8.4.1 Maksajan tiedot .................................................................................................. 19

8.4.2 Tulotietoilmoituksen tiedot .................................................................................. 20

8.4.3 Esikatselu .......................................................................................................... 20

8.4.4 Vastaanottokuittaus ............................................................................................ 21

8.4.5 Virhetilanteet ...................................................................................................... 21

9 Latauspalvelun testaus ..................................................................................................... 22

9.1 Tiedoston muotovaatimukset ..................................................................................... 22

9.2 Latauspalvelussa testattavat tiedon tuottajan palvelut ............................................... 23

9.3 Latauspalvelun testaaminen ...................................................................................... 23

9.4 Latauspalvelun virhetilanteet ..................................................................................... 24

10 Ilmoitusten haun ja katselun testaus ................................................................................. 24


10.1 Haun tarkentaminen .................................................................................................. 25

10.2 Ilmoituksen korjaaminen ............................................................................................ 27

10.3 Käytä ilmoitusta uuden pohjana ................................................................................ 28

10.4 Ilmoituksen mitätöinti ................................................................................................. 28

11 Aineistojen haun ja katselun testaus ................................................................................ 29

12 Raporttien testaus ............................................................................................................ 30

13 Sopimushallinnan testaus ................................................................................................ 31

14 Testausprosessi ............................................................................................................... 32

15 Testauksen havaintojen raportointi ................................................................................... 32

15.1 Ohje havaintolomakkeen kenttien täyttöön ................................................................ 32

15.2 Esimerkki kirjatusta havainnosta ............................................................................... 33

15.3 Virhe, joka estää testaamisen ................................................................................... 33

15.4 Havainnon käsittely tulorekisterissä ........................................................................... 34

15.5 Muutospyyntö ............................................................................................................ 34

16 Testauksen lopettaminen ................................................................................................. 34

17 Lisätietoa .......................................................................................................................... 35


VERSIOHISTORIA

Versio Päivämäärä Kuvaus

1.0

09.04.2018 Dokumentti julkaistu.

1.1 14.08.2018 Täydennetty dokumenttiin sähköisen asiointipalvelun toimin-nallisuudet: - 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 asiointi-palvelun testausohje. Toimitusselosteen julkaisuajankohdan muutos.

2.0 30.4.2019 Dokumentti päivitetty vastaamaan sidosryhmätestauksen ny-kytilannetta 2019. Tähän liitteeseen on yhdistetty vuoden 2018 kaksi liitettä: Liite 2, Sähköisen asiointipalvelun sidos-ryhmätestaussuunnitelma (pdf), ja Liite 9, Sähköisen asiointi-palvelun testausohje tiedon tuottajille (pdf).


KESKEISET TERMIT JA NIIDEN SELITTEET

Lyhenne tai termi Selite

GDPR EU:n laajuinen tietosuoja-asetus, EU general data protection re-gulation 2016/679.

Testauksen aloitusilmoitus Lomake, jolla sidosryhmä ilmoittaa tulorekisterille testauksen aloittamiseen tarvittavat tiedot, testattavat palvelut sekä hyväk-syy testausympäristön käyttöehdot.

Sähköinen asiointipalvelu

Selaimella käytettävä tulorekisterin verkkopalvelu, jota voivat käyttää tulorekisterin tiedon tuottajat, tiedon käyttäjät ja tulon-saajat. Sähköisessä asiointipalvelussa käyttäjä voi ilmoittaa tie-toja tulorekisteriin. Käyttäjä voi hakea ja katsella niitä tulorekiste-rin tietoja, joita hänellä on oikeus tarkastella.

Palkat-sidosryhmätestaus-ympäristö (EXT1)

Ensisijainen palkkojen testausympäristö sidosryhmille vuonna 2019. EXT1-ympäristössä voi testata palkkojen uutta julkaisu-versiota noin 1–2 viikkoa ennen kuin se julkaistaan tuotantoon. Muina aikoina testattavana on palkkojen tuotannossa oleva ver-sio.

Palkat ja etuudet -sidosryh-mätestausympäristö (EXT2)

Etuuksien ja palkkojen sidosryhmätestausympäristö vuonna 2019. EXT2-ympäristössä voi testata viimeisintä etuuksiin liitty-vää julkaisuversiota. Lisäksi EXT2-ympäristössä on tarkoitus pi-tää testattavissa palkkojen tuotannossa oleva versio tai seuraa-vaksi tuotantoon vietävä palkkojen julkaisuversio eli sama versio kuin EXT1-ympäristössä.

Asiakasaineisto Tulorekisterin sidosryhmätestauksessa käytettävä anonymisoitu aineisto, joka koostuu testiasiakkaiden Y-tunnuksista ja henkilö-tunnuksista.

Testaava organisaatio Tulorekisterin sidosryhmätestaukseen osallistuva yritys tai orga-nisaatio.


Testauksen yhteyshenkilö

Testaavan organisaation ensisijainen yhteyshenkilö tulorekiste-rin 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 liit-tyvät tiedotteet ja kyselyt sekä testauksessa tarvittavat testiai-neistot 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öllisyysrahasto sekä työeläkelaitokset ja ETK.

Toisessa vaiheessa 1.1.2020 lähtien tiedon käyttäjiksi tulevat Potilasvakuutuskeskus, Tapaturmavakuutuskeskus, vahinkova-kuutusyhtiöt, Valtiokonttori, kunnat ja kuntayhtymät, työttömyys-kassat, Työllisyysrahasto (aikuiskoulutusetuudet), työsuojeluvi-ranomaiset, Tilastokeskus, TEMin hallinnonala, Ahvenanmaan maakunta ja sen viranomaiset ja kunnat.

Tiedon tuottajat Kaikki yritykset ja muut toimijat, joilla on palkka-, eläke- tai etuustietojen ilmoitusvelvollisuuksia Suomeen jollekin tulorekis-terin tiedon käyttäjälle.

Valtuus

Oikeus toimia toisen puolesta. Organisaation nimenkirjoitusoi-keudellisella henkilöllä on kaikki valtuudet ilmoittaa tietoja orga-nisaation puolesta ja katsella ilmoitettuja tietoja. Nimenkirjoitus-oikeudellinen henkilö voi valtuuttaa toisen henkilön tai yrityksen toimimaan tulorekisterissä organisaation puolesta.


1 YLEISTÄ

Sidosryhmätestaussuunnitelmassa kuvataan tulorekisterin sidosryhmätestauksen toteutus. Tulorekisterin teknisten rajapintojen testaus ohjeistetaan liitteessä 1, Tek-nisten rajapintojen testausohje.

Tässä testausohjeessa kuvataan, mitä sähköisen asiointipalvelun toimintoja tiedon tuottajat voivat sidosryhmätestauksessa palkoista ja etuuksista testata. Lisäksi oh-jeessa käsitellään mm. sähköiseen asiointipalveluun kirjautumista, valtuuksia, testi-tunnuksia ja -aineistoja sekä havaintojen raportointia. Sähköisen asiointipalvelun testaus noudattaa samoja periaatteita ja ohjeistuksia, jotka on kuvattu tulorekisterin sidosryhmätestaussuunnitelmassa.

Sidosryhmätestaussuunnitelman aikataulussa ja julkaisuaikataulussa (liite 8) kuva-taan, milloin sähköisen asiointipalvelun eri osa-alueet ja toiminnot ovat testatta-vissa.

Tulorekisterillä on oikeus rajata sidosryhmätestaukseen osallistuvien tahojen mää-rää ja testauksen sisältöä. Tarvittaessa tulorekisteri voi pyytää testausta suunnitte-levalta toimijalta lisätietoja, joiden perusteella arvioidaan testauksen tarpeellisuutta testaajan ja hankkeen näkökulmasta.

2 TESTAUKSESSA KÄYTETTÄVÄT YMPÄRISTÖT JA JULKAISUVERSIOT

Vuonna 2019 tulorekisterissä on käytössä kaksi testausympäristöä sidosryhmätes-tausta varten:

1. Palkat-sidosryhmätestausympäristö (EXT1), jossa voi testata palkkatietojen toimittamista ja jakelua (palkkatietoilmoitukset, työnantajan erillisilmoituk-set). EXT1-ympäristössä voi testata palkkojen uutta julkaisuversiota noin 1–2 viikkoa ennen kuin se julkaistaan tuotantoon. Muina aikoina testattavana on palkkojen tuotannossa oleva versio.

2. Palkat ja etuudet -sidosryhmätestausympäristö (EXT2), jossa voi testata en-sisijaisesti etuustietojen toimittamista ja jakelua (etuustietoilmoitukset). Li-säksi EXT2-ympäristössä on tarkoitus pitää testattavissa palkkojen tuotan-nossa oleva versio tai seuraavaksi tuotantoon vietävä palkkojen julkaisuver-sio eli sama versio kuin EXT1-ympäristössä.

Etuustietojen toimittamisen ja jakelun toiminnallisuudet julkaistaan testaukseen vai-heittain. Sidosryhmätestauksen testaussuunnitelmassa on kuvattu, miten tulorekis-terijärjestelmän sidosryhmätestaus organisoidaan ja toteutetaan vuonna 2019. Si-dosryhmätestaussuunnitelman liitteessä 8 on kuvattu versioiden julkaisuaikataulu: Julkaisuaikataulu (pdf).

Tulorekisteri julkaisee kehitysversioita ja korjausjulkaisuja sidosryhmätestausympä-ristöihin. Sidosryhmätestaussuunnitelman liitteessä 8 on kuvattu versioiden julkai-suaikataulu: Julkaisuaikataulu (pdf). Tulorekisteri julkaisee jokaisesta versiosta toi-

https://www.vero.fi/globalassets/tulorekisteri/testaussuunnitelma_sidosryhmat.pdf

https://www.vero.fi/globalassets/tulorekisteri/liite1_testausohje.pdf

https://www.vero.fi/globalassets/tulorekisteri/liite1_testausohje.pdf


https://www.vero.fi/globalassets/tulorekisteri/liite8_tulorekisterin-julkaisuaikataulu.pdf





mitusselosteen. Toimitusselosteessa luetellaan uudessa versiossa tehdyt korjauk-set ja muutokset. Toimitusseloste julkaistaan tulorekisteri.fi-sivustolla ja lähetetään sidosryhmätestauksen uutiskirjeenä.

Samoja testitunnuksia ja testiasiakasaineistoja voi käyttää molemmissa ympäris-töissä. EXT1-ympäristöstä on tehty kopio EXT2-ympäristöön 19.3.2019. Tämän jäl-keen lähetettyjä tulotietoilmoituksia ei kopioida ympäristöstä toiseen. EXT1 on tar-koitettu ensisijaisesti palkkojen testaamiseen ja EXT2 etuuksien testaamiseen vuonna 2019.

3 TESTAUKSEN ALOITUS

Kuvassa 1 kuvataan testauksen aloitus. Sähköisessä asiointipalvelussa ei käytetä varmenteita.

Kuva 1: Testauksen aloitus

4 TESTAUKSEN ALOITUSILMOITUS JA SEN KÄSITTELY

Testaava organisaatio täyttää ennen testauksen aloitusta testauksen aloitusilmoi-tuksen ja hyväksyy tulorekisterin sidosryhmätestausympäristön käyttöehdot. Aloi-tusilmoituksella organisaatio ilmoittaa, mitä kanavia haluaa testata. Aloitusilmoituk-sen käsittelyaika tulorekisterissä on kaksi viikkoa siitä, kun sidosryhmä on toimitta-nut oikein täytetyn testauksen aloitusilmoituksen. Allekirjoitettu ja skannattu aloi-tusilmoitus lähetetään osoitteeseen: [email protected].

mailto:[email protected]


Testauksen aloitusilmoitus ja testausympäristön käyttöehdot ovat tulorekisteri.fi-si-vulla.

Palkkatiedon tuottamista testaava organisaatio täyttää lomakkeen 6111, Testauksen aloitusilmoitus, palkkatiedon tuottajat.

Etuustiedon tuottamista testaava organisaatio täyttää lomakkeen 6116, Testauksen aloitusilmoitus, etuustiedon tuottajat.

Palkkatietojen, etuustietojen tai molempien käyttämistä testaava tiedon käyttäjän organisaatio saa testauksen aloitusilmoituslomakkeen osoitteesta [email protected].

Jos testaava organisaatio toimii sekä tiedon tuottajana että käyttäjänä, sen pitää täyttää erikseen tiedon tuottajan ja tiedon käyttäjän aloitusilmoitukset. Testauksen aloitusilmoituksessa pitää ilmoittaa mm. testauksen yhteyshenkilön ja teknisen yhteyshenkilön tiedot:

Etunimi

Sukunimi

Matkapuhelinnumero (maakoodin sisältävässä muodossa, esimerkiksi +35840 123 4567)

Sähköpostiosoite.

Tulorekisteri lähettää kuittauksen aloitusilmoituksen vastaanotosta sähköpostilla. Kun tulorekisteri on käsitellyt aloitusilmoituksen, lähetetään testauksen yhteyshenki-lölle ja tekniselle yhteyshenkilölle sähköpostitse testauksessa tarvittavat testitun-nukset, testiasiakkaat, testausympäristön testiosoitteet ja muut ohjeet.

5 TESTIASIAKASAINEISTOT

5.1 Testitunnukset

Sähköistä asiointipalvelua testaava organisaatio saa keinotekoisen Y-tunnuksen (CustomerID) ja organisaation nimen sekä keinotekoisen henkilötunnuksen, jolla on nimenkirjoitusoikeus tähän yritykseen. Jos organisaatio on jo aikaisemmin testannut tulorekisteriä, se voi halutessaan käyttää samaa Y-tunnusta myös sähköisen asioin-tipalvelun testaamisessa ja ilmoittaa tästä testauksen aloitusilmoituksessa.

Lisäksi jokainen testaava organisaatio saa 10 keinotekoista Y-tunnus-henkilötun-nus-paria (Suomi.fi-listan tunnuksia). Jokaisella henkilötunnuksella on nimenkirjoi-tusoikeus yhteen yritykseen. Näillä tunnuksilla voi testata sekä valtuuksien anta-mista muille että tulotietojen ilmoittamista. Tunnuksia voi käyttää myös tulonsaajina. Myös Y-tunnuksia voi käyttää tulonsaajina, jos tuloa maksetaan yritykselle. Tämä on kuitenkin harvinaisempaa. Kun tuloja ilmoitetaan sähköisessä asiointipalvelussa, maksaja on aina se Y-tunnus, jonka valtuuttamalla henkilötunnuksella testaaja on kirjautunut tulorekisteriin ja jonka puolesta testaaja sillä hetkellä asioi.

Jos Suomi.fi-tunnistautuminen ei ole mahdollista (katso tarkemmin luku 6), organi-saatio voi testata Katso-testitunnisteella.

https://www.vero.fi/globalassets/tulorekisteri/6111.pdf

https://www.vero.fi/globalassets/tulorekisteri/6116.pdf



5.2 Asiakasaineistot

5.2.1 Tulorekisterin testiasiakasaineistot

Tulorekisterin muodostama 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 mukaiset vaatimukset eikä näiden tietojen perusteella voida lisätietoja käyttämällä yhdistää tietojen koskevan tunnistettavissa olevaa luonnollista henkilöä. Testiasiak-kaiden henkilö- ja Y-tunnukset on anonymisoitu siten, että ne ovat muodollisesti oi-keanlaisia ja läpäisevät tarkistukset. Ohje testiaineiston anonymisoinnista ks. Liite 7.

Testauksen aloitusilmoituksen käsittelyn jälkeen tulorekisteri lähettää organisaation ilmoittamalle testauksen yhteyshenkilölle sähköpostilla (pdf-tiedosto) testauksessa käytettävät anonymisoidut Y-tunnukset ja henkilötunnukset nimitietoineen. Tulotie-toilmoitukset menevät läpi, vaikka nimi olisikin erilainen, mutta silti suositellaan, että käytetään tulorekisterin ilmoittamia nimiä. Jokaiselle testaavalle organisaatiolle toimitetaan 200 henkilötunnusta, joita voi käyt-tää kaikkien kanavien testauksessa. Tulorekisteri vie tunnukset molempiin testaus-ympäristöihin. Organisaatio voi itse valita, kuinka monta tulonsaajaa kullakin Y-tun-nuksellisella maksajalla on. Tässä listassa mainitut henkilötunnukset voi liittää Y-tunnukseen omavalintaisesti. Jos testaava organisaatio haluaa enemmän testiasiakkaita, lähetetään pyyntö osoit-teeseen [email protected].

Jos tiedon tuottaja haluaa lisäksi käyttää omia keinotekoisia henkilötunnuksiaan testauksessa, ne pitää lisätä tulorekisterin testausympäristöön. Katso lisätietoa lu-vussa 5.2.2.

Jos testaava organisaatio haluaa testata tulojen ilmoittamista yksittäisille ulkomai-sille tulonsaajille, tällöin testaava organisaatio voi antaa tulonsaajalle keinotekoisen ulkomaisen asiakastunnisteen (esimerkiksi tunnisteen tyyppi 4 TIN, tunniste 112233, tunnisteen maakoodi EE). Testaava organisaatio voi keksiä tunnisteen itse, sillä tulorekisteri muodostaa uuden ulkomaisen asiakkaan, jos asiakasta ei löydy kannasta, sillä tunnisteella, joka ilmoituksessa on annettu. Tunnisteen täytyy kuitenkin olla muodoltaan oikea, jotta ilmoittaminen onnistuu.

5.2.2 Sidosryhmän omien testiasiakkaiden lisäys tulorekisterin sidosryhmätestaus-ympäristöön

Tulorekisteri voi tarvittaessa viedä sidosryhmän omia anonymisoituja testiasiakkaita eli palkansaajia tulorekisterin sidosryhmätestausympäristöön niiden testiasiakkai-den lisäksi, jotka tulorekisteri on testauksen aloittamisen yhteydessä toimittanut.



Omia testiasiakkaita voi toimittaa kohtuullisen määrän. Näitä testiasiakkaita voi käyt-tää molemmissa testausympäristöissä. Testiasiakkaiden lisäämistä varten sidosryh-män pitää toimittaa tiedot Excel-tiedostona tulorekisterille. Kaiken testauksessa käy-tettävän asiakasaineiston pitää olla anonymisoitua, katso tarkemmin liite 7, Ohje Testiaineiston anonymisoinnista. Tiedostot lähetetään osoitteeseen [email protected].

Tiedostossa lähetetyt testiasiakkaat ovat käytettävissä viimeistään kolmantena arki-päivänä saapumispäivästä.

Jos sidosryhmän ilmoittama testiasiakas on jo tulorekisterin sidosryhmätestausym-päristöissä (esimerkiksi sama henkilötunnus eri nimellä), olemassa olevan testi-asiakkaan tietoja ei muuteta tulorekisterin sidosryhmätestausympäristöihin. Sidos-ryhmälle ilmoitetaan, mitkä heidän toimittamistaan testiasiakkaista on lisätty tulore-kisterin sidosryhmätestausympäristöihin ja mitkä tunnukset mahdollisesti olivat jo ennestään sidosryhmätestausympäristöissä.

Jotta testiasiakasaineistoja on helpompi hallita, käytä lähetettävän tiedoston ni-messä lähettävän organisaation nimeä. Muodosta lähetettävän tiedoston nimi seu-raavasti: organisaation nimi – tunnusten tyyppi – testiasiakkaat. Esimerkiksi:

Kela_henkilötunnukset_testiasiakkaat1.xlsx Arek_y_tunn_testiasiakkaat1.xlsx

Anna lähetettävälle tiedostolle numero, jotta on tarvittaessa mahdollista lähettää jat-kossa useampia samantyyppisiä testiasiakasaineistoja.

Toimita henkilötunnukset ja Y-tunnukset erillisinä tiedostoina. Jokaisen testiasiak-kaan tiedot annetaan eri sarakkeissa ja omalla rivillään.

Henkilöasiakkaat Testiasiakkaille, joilla on henkilötunnus, ilmoitetaan seuraavat tiedot tässä sarake-järjestyksessä (A,B,C): Henkilötunnus, Etunimi/etunimet, Sukunimi Yritysasiakkaat Testiasiakkaille, joilla on Y-tunnus, ilmoitetaan seuraavat tiedot tässä sarakejärjes-tyksessä (A,B): Y-tunnus, Nimi

5.3 Koodistot

Sidosryhmätestauksessa käytettävät tulorekisterin koodistot on kuvattu dokumen-taatiossa.

Sidosryhmätestauksessa käytettävät koodistot on kuvattu dokumentissa Koodistot (pdf).

Palkkatietojen eri tulolajien koodit luetellaan dokumentissa Palkat – Koodis-tot – Tulolajit (pdf).

Etuustietojen eri tulolajien koodit luetellaan dokumentissa Etuudet – Koodis-tot – Tulolajit (pdf).

https://www.vero.fi/globalassets/tulorekisteri/liite7_ohje-testiaineiston-anonymisoinnista.pdf

https://www.vero.fi/globalassets/tulorekisteri/liite7_ohje-testiaineiston-anonymisoinnista.pdf



https://www.vero.fi/tulorekisteri/ohjelmistokehitt%C3%A4j%C3%A4t/dokumentaatio/

https://www.vero.fi/tulorekisteri/ohjelmistokehitt%C3%A4j%C3%A4t/dokumentaatio/

https://www.vero.fi/globalassets/tulorekisteri/koodistot.pdf

https://www.vero.fi/globalassets/tulorekisteri/koodistot-tulolajit.pdf


https://www.vero.fi/globalassets/tulorekisteri/etuudet-koodistot-tulolajit.pdf



Virhekoodit luetellaan dokumentissa Koodistot - Virhekoodit (xls).

Ammattiluokitukseen liittyvät koodit luetellaan Tilastokeskuksen dokumen-tissa Koodistot - Ammattiluokitus.

Ulkoisissa koodistoissa käytetään sidosryhmätestausvaiheessa samoja koodistoja kuin tuotannossakin. Eri tilanteissa käytettävät koodistot on kuvattu skeemojen si-sältökuvauksissa. Skeemojen sisältökuvaukset ovat tulorekisteri.fi-sivuston doku-mentaatiossa.

6 KIRJAUTUMINEN SÄHKÖISEN ASIOINTIPALVELUN TESTAUSYMPÄ-RISTÖÖN

Tulorekisterin sähköisen asiointipalvelun testausympäristöön kirjaudutaan tulorekis-teri.fi-sivulta sähköisen asiointipalvelun testausympäristö.

Sähköisen asiointipalvelun testaus EXT2-ympäristössä alkaa aikataulun mukaan, katso tarkemmin Julkaisuaikataulu (pdf).

Sähköisen asiointipalvelun testausympäristöön kirjaudutaan tulorekisteristä saa-dulla keinotekoisella henkilötunnuksella (joko organisaation ensisijaisella henkilö-tunnuksella tai jollakin 10:stä Suomi.fi-listan tunnuksesta). Erityistapauksissa kirjau-tumiseen voi käyttää Katso-tunnistetta.

Ruotsin- ja englanninkielistä sähköistä asiointipalvelua voi testata vaihtamalla kir-jautumisen jälkeen kielen sivun oikeasta yläkulmasta.

Kuva 2. Kirjautumissivu siinä vaiheessa, kun EXT2-ympäristön testaus alkaa.

Suomi.fi-tunnuksilla testaava valitsee ”Kirjaudu EXT1-ympäristöön (Palkat)” tai ”Kir-jaudu EXT2-ympäristöön (Palkat ja etuudet)”. Katso-tunnisteella testaava valitsee "Testaus Katso-tunnisteella".

https://www.vero.fi/globalassets/tulorekisteri/koodistot-virhekoodit.xlsx

http://www.stat.fi/meta/luokitukset/ammatti/versio.html

https://www.vero.fi/tulorekisteri/ohjelmistokehittäjät/dokumentaatio/


https://www.vero.fi/tulorekisteri/ohjelmistokehittäjät/sidosryhmätestaus/sähköisen-asiointipalvelun-testausympäristö/



Kirjautumissivulle lisätään painike EXT2-ympäristöön kirjautumista varten ennen kuin EXT2-ympäristön testaus alkaa, katso tarkemmin Julkaisuaikataulu (pdf).

6.1 Tunnistautuminen Suomi.fi-tunnuksilla

Valittuaan ”Kirjaudu testausympäristöön” testaaja valitsee Suomi.fi-testitunnistusva-likosta tunnistustavaksi ”Testitunnistaja” ja siirtyy sen avulla Suomi.fi-tunnistuksen testitunnistukseen.

Testitunnistaja-näytöllä testaaja syöttää tulorekisterin toimittaman keinotekoisen henkilötunnuksen kenttään ”Henkilötunnus” ja painaa "Tunnistaudu". Tämän jäl-keen testaajalle avautuu tulorekisterin sähköisen asiointipalvelun sidosryhmätes-tausympäristö.



Testitunnistus – Testitunnistaja – keinotekoinen henkilötunnus

6.2 Erityisryhmien ja ulkomaisten organisaatioiden tunnistautuminen Katso-tunnisteella

Osa tiedon tuottajista (erityisryhmät) tunnistautuu ja myöntää valtuudet testausta varten Katso-testipalvelussa, koska kaikkia organisaatiomuotoja ei ole vielä mah-dollistettu Suomi.fi-palveluissa. Erityisryhmiä ovat ne tahot, joiden nimenkirjoitusoi-keudellisesta henkilöstä ei ole saatavilla tietoa kaupparekisterissä tai YTJ:ssä. Täl-laisia toimijoita ovat:

o kunta o seurakunta o oppilaitos o yhdistys o säätiö o elinkeinoyhtymä o kuolinpesä o julkinen viranomainen o ulkomainen yritys.

Erityisryhmään kuuluvan testaajan pitää muodostaa itselleen Katso-testitunniste (pääkäyttäjyys) voidakseen myöntää valtuuksia muille organisaation edustajille, ali-organisaation työntekijälle tai toiselle organisaatiolle. Jos haluat testata jonakin yllä-mainituista toimijoista, mainitse asiasta sähköpostissa, jonka liitteenä palautat tes-tauksen aloitusilmoituksen osoitteeseen YHT_Tulorekisteri_testaus@ vero.fi. Aloi-tusilmoituksen käsittelyn jälkeen saat keinotekoisen henkilötunnuksen, jonka avulla Katso-tunnisteen voi perustaa.

Pääkäyttäjyys perustetaan, Katso-testitunniste muodostetaan ja valtuudet myönnet-tään Katso-testipalvelussa osoitteessa: https://htesti.katso.tunnistus.fi.


https://htesti.katso.tunnistus.fi/


Katso-tunnistetta käyttävät myös ulkomaiset organisaatiot, joita ei ole rekisteröity kaupparekisteriin tai joiden nimenkirjoitusoikeudellisella henkilöllä ei ole suoma-laista henkilötunnusta. Ulkomaiset organisaatiot käyttävät tunnistautumisessa Katso-testitunnisteita. Tes-taaja muodostaa Katso-testitunnisteen testipalvelussa osoitteessa (https://yri-tys.tunnistus.fi/eidm2/wf/register/person), perustaa uuden pääkäyttäjyyden osoit-teessa https://htesti.katso.tunnistus.fi ja myöntää organisaation työntekijöille valtuu-det tulorekisterin sidosryhmätestaukseen sähköisen asiointipalvelun testausta var-ten tai valtuuttaa toisen yrityksen toimimaan puolestaan osoitteessa https://htesti.katso.tunnistus.fi (Katso-palvelun osoite).

7 VALTUUKSIEN TESTAUS

Tulorekisterin sähköisen asiointipalvelun testausympäristössä voi asioida yrityksen nimenkirjoitusoikeudellisena edustajana ilman erillistä valtuutusta. Testaaja kirjau-tuu testausympäristöön tulorekisteriltä saadulla testitunnuksella (henkilötunnuk-sella). Tulorekisterin sähköisessä asiointipalvelussa näytetään henkilötunnukseen liitetyn keinotekoisen organisaation tiedot.

Tiedon tuottaja eli suorituksen maksaja voi valtuuttaa työntekijänsä tai toisen orga-nisaation asioimaan puolestaan tulorekisterin sähköisessä asiointipalvelussa. Val-tuuttamista voi testata sähköisen asiointipalvelun testausympäristössä testaavalle organisaatiolle toimitetuilla keinotekoisilla henkilötunnuksilla ja keinotekoisilla Y-tun-nuksilla.

Valtuutukset tehdään lähtökohtaisesti Suomi.fi-valtuuksien testausympäristössä, josta tieto valtuuksista välittyy tulorekisterin sähköiseen asiointipalveluun. Osa tie-don tuottajista (erityisryhmät) myöntää valtuudet Katso-testipalvelussa (katso tar-kemmin luku 6.2).

Organisaation puolesta toimivan testaajan valtuuskoodit tulorekisterin käyttöön ovat Palkkatietojen ilmoittaminen ja Palkkatietojen katselu sekä Etuustietojen ilmoittami-nen ja Etuustietojen katselu. Palkkatietojen ilmoittaminen sisältää myös valtuuden Palkkatietojen katselu. Etuustietojen ilmoittaminen sisältää myös valtuuden Etuus-tietojen katselu.

Valtuuksien myöntämisen jälkeen valtuutettu voi tehdä valtuuttajan puolesta toi-menpiteitä tiedon tuottajana niissä asioissa, joihin valtuudet on annettu. Lue lisää valtuuskoodeista.

Lue lisää tunnistautumisesta ja valtuuttamisesta.

7.1 Valtuuksien myöntäminen Suomi.fi-valtuuksissa

Valtuudet myönnetään palvelun Suomi.fi-valtuudet testausympäristössä: https://valtuusrekisteri.test.suomi.fi

https://yritys.tunnistus.fi/eidm2/wf/register/person

https://yritys.tunnistus.fi/eidm2/wf/register/person



https://www.vero.fi/tulorekisteri/yritykset-ja-organisaatiot/suorituksen-maksajat/valtuutus/valtuuskoodit/

https://www.vero.fi/tulorekisteri/yritykset-ja-organisaatiot/suorituksen-maksajat/tunnistautuminen/tulorekisterin-k%C3%A4ytt%C3%B6-eidas-tunnisteella/

https://www.vero.fi/tulorekisteri/yritykset-ja-organisaatiot/suorituksen-maksajat/valtuutus/

https://valtuusrekisteri.test.suomi.fi/


Valtuuttajalla pitää olla organisaation nimenkirjoitusoikeus.

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 ni-missä valitsemissani asioissa. Valitsemalla tämän voi antaa valtuutusoikeuden oman organisaation työntekijöille, jotka voivat myöntää valtuuksia oman organisaa-tion 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önnetty-jen valtuuksien perusteella valitsemissani asioissa (esim. Oy AB on valtuuttanut Tili-toimisto XY:n ja tilitoimisto on valtuuttanut edelleen työntekijänsä C:n, joka voi hoi-taa Oy AB:n asiointia).

Edustajan valtuutusoikeus – annan henkilöille oikeuden valtuuttaa tämän yrityk-sen nimissä toisia henkilöitä, jotta he voivat asioida tämän yrityksen saamien val-tuuksien perusteella valitsemissani asioissa. Valitsemalla tämän voi antaa valtuu-tusoikeuden toiselle henkilölle, joka voi myöntää oikeuksia yrityksen puolesta asi-ointiin (Oy AB on valtuuttanut Tilitoimisto XY:n ja tilitoimisto antaa työntekijälleen A oikeuden valtuuttaa muita henkilöitä, jotka voivat hoitaa Oy AB:n asiointia).


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 Valtuuskoodit – Etuustietojen ilmoittaminen ja Etuustietojen katselu: mahdollista vasta syk-syllä 2019.

7.2 Useiden asiakkaiden puolesta asiointi

Valtuuden saanut taho, esimerkiksi tilitoimisto, voi asioida useiden asiak-kaidensa puolesta sähköisessä asiointipalvelussa. Tilitoimisto voi asioida kaikkien niiden asiakasyritysten puolesta, jotka ovat valtuuttaneet tilitoimis-ton.

Yhdellä tunnistautumisella voi asioida monen eri asiakkaan puo-lesta.

Kun tilitoimisto lähettää tiedostoja latauspalvelussa, yksi tiedosto voi sisältää vain yhden asiakkaan tulotietoaineistoja. Samalla kertaa voi kuitenkin lähettää usean eri asiakkaan tulotietoaineistoja, kunhan ne ovat erillisinä tiedostoina. Valtuudet tarkistetaan aineistojen lähettä-misen yhteydessä.

Kun tilitoimisto käyttää muita sähköisen asiointipalvelun osia kuin latauspalvelua, pitää palveluun tunnistautuneen henkilön aluksi va-lita yksi asiakas, jonka puolesta asioi. Asiakasta voi vaihtaa saman istunnon aikana.


Esimerkki: Testauksessa valitaan tulorekisterin toimittamista keinotekoisista Y-tunnuk-sista (Suomi.fi) yksi tunnus, joka toimii tilitoimistona. Tälle valitulle tilitoimis-tolle annetaan valtuudet asioida toisten Suomi.fi-listan Y-tunnusten puo-lesta.

8 TULOTIETOJEN ILMOITTAMISEN TESTAUS, VERKKOLOMAKKEET

Tulorekisterin sähköisessä asiointipalvelussa tiedon tuottaja voi toimittaa tulotietoil-moituksia tulorekisteriin käyttämällä sähköisen asiointipalvelun verkkolomaketta. Ilmoittamisen pääsivulla voi valita palkkatietoilmoituksen, etuustietoilmoituksen, työnantajan erillisilmoituksen, tiedot kansainvälisestä työskentelystä tai vuokratyön-tekijän aloittamisilmoituksen. Julkaisuaikataulussa (pdf) kuvataan, milloin ja missä ympäristössä uudet vuonna 2019 julkaistavat sähköisen asiointipalvelun toiminnot ovat testattavissa.

Lisätietoja: Sähköisen asiointipalvelun käyttöohjeet

8.1 Palkkatietoilmoitus

Palkkatietoilmoituksen täyttämiseen siirrytään valitsemalla vasemmasta navigaa-tiosta Ilmoittaminen – Palkkatietoilmoitus.

Lisätietoja palkkatietoilmoituksen sisällöstä: Sähköisen asiointipalvelun ohje: Uusi palkkatietoilmoitus

8.2 Työnantajan erillisilmoitus

Työnantajan erillisilmoituksen täyttämiseen siirrytään valitsemalla vasem-masta navigaatiosta Ilmoittaminen – Työnantajan erillisilmoitus. Lisätietoja työnantajan erillisilmoituksen sisällöstä: Sähköisen asiointipalvelun ohje: Työnantajan erillisilmoitus

8.3 Etuustietoilmoitus

Etuustietoilmoituksen täyttämiseen siirrytään valitsemalla vasemmasta navigaa-tiosta Ilmoittaminen – Etuustietoilmoitus. Julkaisuaikataulussa (pdf) kuvataan, mil-loin ja missä ympäristössä uudet vuonna 2019 julkaistavat sähköisen asiointipalve-lun toiminnot ovat testattavissa.

Lisätietoja etuustietoilmoituksen sisällöstä:

Etuustietoilmoituksen tietosisällön soveltamisohje (pdf)


https://www.vero.fi/tulorekisteri/tietoa-meist%C3%A4/sahkoisen-asiointipalvelun-kayttoohjeet/

https://www.vero.fi/tulorekisteri/tietoa-meist%C3%A4/sahkoisen-asiointipalvelun-kayttoohjeet/ilmoittaminen-yritykset/yleisohje-ilmoittaminen/uusi-palkkatietoilmoitus/

https://www.vero.fi/tulorekisteri/tietoa-meist%C3%A4/sahkoisen-asiointipalvelun-kayttoohjeet/ilmoittaminen-yritykset/yleisohje-ilmoittaminen/tyonantajan-erillisilmoitus/


https://www.vero.fi/globalassets/tulorekisteri/etuustietoilmoituksen-tietosisallon-soveltamisohje.pdf


8.4 Ilmoitusten täyttäminen

8.4.1 Maksajan tiedot

Ilmoitus täytetään vaiheittain.

Ensimmäinen vaihe on tarkistaa esitäytetyt maksajan tiedot, täydentää niitä tarvitta-vin osin ja tallentaa ne järjestelmään. Alla käytetään esimerkkinä palkkatietoilmoi-tusta. Muiden ilmoitusten täyttö etenee vastaavasti.

Maksajan tiedoista osa on esitäytetty. Tietoja voi täydentää.

Tallenna-painike tallentaa tiedot.

Kumoa muutokset -painikkeella voi peruuttaa tehdyt muutokset.

Tallentamisen jälkeen näytetään maksajan tietojen esikatselusivu. Maksajan tietoja voi palata muokkaamaan Muokkaa tietoja -painikkeesta. Tästä eteenpäin ilmoituk-sessa näytetään myös toimintopainikkeet, joiden avulla sivujen välillä voi liikkua eteenpäin ja taaksepäin.

Poistu: Poistuu ilmoituksesta ja palaa ilmoittamisen pääsivulle. Ilmoitus ei tallennu luonnoksena.

Edellinen: Palaa edelliselle ilmoituksen sivulle. Sivulle syötetyt tiedot eivät katoa, vaikka sivulta palattaisiin edelliseen vaiheeseen.

Seuraava: Siirtyy ilmoituksen täytössä seuraavalle sivulle. Jos ilmoituksessa on vir-heitä tai pakollisista kentistä puuttuu tietoja, Seuraava-painike ei ole valittavissa. Kaikki virheet tai puutteet eivät kuitenkaan estä siirtymistä seuraavalle sivulle.


8.4.2 Tulotietoilmoituksen tiedot

Toinen vaihe on varsinainen ilmoituksen täyttäminen.

Jos tässä vaiheessa havaitaan puutteita tai virheellistä tietoa, voi ilmoituksen täyttä-misvaiheeseen palata Edellinen-painikkeella.

Kun ilmoitus on täytetty ja sisältää tarvittavat tiedot, voi käyttäjä siirtyä esikatselu-vaiheeseen Seuraava-painikkeella.

8.4.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 yh-dellä 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.

8.4.4 Vastaanottokuittaus

Kun ilmoitus on tallennettu tulorekisteriin, käyttäjä saa vastaanottokuittauksen, joka sisältää ilmoitusviitteen. Annettua ilmoitusta voi myöhemmin hakea tulorekisteristä ilmoitusviitteen avulla.

8.4.5 Virhetilanteet

Ohjelmisto tarkistaa lähetyksen yhteydessä käyttäjän ilmoitukseen syöttämät pakol-liset tiedot. Ilmoituksen voi lähettää vain, jos pakolliset tiedot on täytetty oikein. Jos


ilmoituksesta puuttuu tietoja tai tiedoissa on virheitä, näytetään lista virheistä. Katso virhekoodeista luku 5.3 Koodistot.

Kun käyttäjä on korjannut virheet, ilmoituksen voi lähettää tulorekisteriin, jossa se tallentuu järjestelmään.

9 LATAUSPALVELUN TESTAUS

Latauspalvelua voivat testata kaikki palkka- ja etuustiedon tuottajat, esimer-kiksi tilitoimistot, yritykset, kunnat, yhdistykset, yhtymät ja ulkomaiset orga-nisaatiot. Latauspalvelua voivat testata myös tulorekisterin tiedon käyttäjät, jotka tekevät latauspalvelun kautta aineistotilauksia. Tulorekisterin sähköisen asiointipalvelun latauspalvelussa tiedon tuottaja voi ladata tulorekisteriin talletettavaksi tulorekisterin rajapintadokumenttien ja skeemojen mukaisia xml-muotoisia tiedostoja. Tulorekisterin latauspal-velu on yhdensuuntainen palvelu, jossa sidosryhmä lähettää tiedostoja tulo-rekisteriin ja saa lähettämistään aineistoista käsittelypalautteen. Aineistojen nouto ei ole mahdollista latauspalvelun kautta. Latauspalvelussa lähetettä-viä aineistoja ei allekirjoiteta varmenteella.

9.1 Tiedoston muotovaatimukset

Latauspalvelussa ladattavan tiedoston on oltava XML-muotoinen. Tiedos-ton tarkemmat vaatimukset on kuvattu tulorekisterin skeemavaatimuksissa: https://www.vero.fi/tulorekisteri/ohjelmistokehittäjät/dokumentaatio/



9.2 Latauspalvelussa testattavat tiedon tuottajan palvelut

Palkat: 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 Etuudet: Etuustietoilmoitus, uusi ja korvaava ilmoitus Etuustietoilmoituksen mitätöinti Etuustietoilmoituksia sisältävän aineiston mitätöinti Lue lisää testausympäristöistä luvusta 2.

9.3 Latauspalvelun testaaminen

Latauspalvelussa voi testata seuraavia toimintoja:

Testaaja voi lähettää erityyppisiä xml-aineistoja tulorekisterin sidosryh-mätestausympäristöihin.

Testaaja voi valita yhden tai useamman tiedoston koneeltaan lähetettä-väksi.

Testaaja voi lisätä tiedostoja ja poistaa yksittäisiä tiedostoja ennen nii-den 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 ilmoituksia yhdeltä maksukerralta ja niiden on oltava sa-maa aineistotyyppiä. Palkkatietoaineisto sisältää palkkatietoilmoituksia, erillisilmoitusaineisto sisältää työnantajan erillisilmoituksia, etuustietoai-neisto sisältää etuustietoilmoituksia, aineistotilausaineisto sisältää ai-neistotilauksia ja mitätöintiaineisto sisältää mitätöintitietoja.

Yhden aineiston kokoraja on sama kuin rajapinnan kautta toimitetta-vissa aineistoissa eli 50 MB.

Kun testaaja painaa ”Lähetä tiedostot” -painiketta:

Aineistot siirretään Lähetetyt aineistot -listalle.

Aineiston tilaksi muutetaan ”Käsitellään”. 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 tulore-kisteriin”, 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 tie-doissa näytetään vastaanottohetki ja linkki käsittelypalautteeseen.


Aineistot tyhjennetään listalta kolmen kuukauden kuluttua niiden tallentami-sesta.

9.4 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äl-lö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 xml-rakenne on virheelli-nen. Ota yhteyttä ohjelmistotoimittajaasi." Tällöin ”Lähetä tiedos-tot” -painike ei ole aktiivinen.

Testaajalla ei ole oikeutta lähettää aineistoa: jos testaaja yrittää lähet-tää 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ä, testaa-jalle 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 Status-ResponseFromIR-skeeman mukainen palaute.

o Käsittelypalautteessa esitetään tulorekisterin palauttamat virhe-koodit (xls) 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.

10 ILMOITUSTEN HAUN JA KATSELUN TESTAUS

Tulorekisterin sähköisessä asiointipalvelussa on mahdollista hakea ja katsella kaik-kia ilmoituksia, jotka organisaatio on toimittanut tulorekisteriin.

Ilmoitusten hakuun siirrytään vasemmasta navigaatiosta valitsemalla Annetut ilmoi-tukset.

Oletuksena näytölle haetaan viimeisten 30 päivän ilmoitukset.

https://www.vero.fi/globalassets/tulorekisteri/tietojen-toimittaminen-skeemat--vastaanottokuittaus.pdf

https://www.vero.fi/globalassets/tulorekisteri/tietojen-toimittaminen-skeemat-kasittelypalaute.pdf

https://www.vero.fi/globalassets/tulorekisteri/tietojen-toimittaminen-skeemat-kasittelypalaute.pdf




Huom! Sähköisessä asiointipalvelussa ilmoituksia voi katsoa henkilö, joka on tun-nistautunut sellaisella henkilötunnuksella, jolla on oikeus nähdä ilmoitus. Jos ilmoi-tus on lähetetty sidosryhmätestausympäristöön rajapinnan kautta, ilmoituksessa oleva maksajan tunnus voi olla sellainen, että sillä ei voi kirjautua sähköiseen asi-ointipalveluun. Jos tunnistautuneelle henkilötunnukselle ei ole myönnetty valtuutta asioida tällaisen maksajan puolesta, ilmoitus ei näy sähköisessä asiointipalvelussa.

10.1 Haun tarkentaminen

Hakua voi tarkentaa esimerkiksi ilmoitusviitteen tai maksupäivän mukaan. Hakuehtoja voi antaa useita.


Käyttäjä voi rajata hakutuloksia edelleen valitsemalla rivin, jossa on vain tietyn tyyp-pisiä ilmoituksia. Esimerkiksi valitsemalla tulolajin 201 näytetään listaus, jossa ovat vain ne ilmoitukset, jotka sisältävät kyseisen tulolajin suorituksia.


10.2 Ilmoituksen korjaaminen

Ilmoitusta voi tarvittaessa muokata yläreunassa olevan Korjaa-painikkeen kautta. Ilmoitusta muokataan samalla tavalla kuin uusi ilmoitus täytetään (katso kappale 8.4). Jos ilmoituksella näkyvää tietoa ei voi korjata, pitää kyseinen ilmoitus mitä-töidä ja tehdä kokonaan uusi ilmoitus.


10.3 Käytä ilmoitusta uuden pohjana

Haettua ilmoitusta voi käyttää myös pohjana uuden ilmoituksen täyttämiseksi. Ilmoi-tus voidaan ottaa pohjaksi Käytä pohjana -painikkeella. Ilmoitus täytetään samalla tavalla kuin kappaleessa 8.4 on kuvattu.

10.4 Ilmoituksen mitätöinti

Tarvittaessa ilmoituksen voi myös mitätöidä. Tämä tapahtuu Mitätöi-painikkeella. Järjestelmä pyytää vielä ilmoituksen mitätöinnin varmistuksen.

Mitätöinti luo ilmoituksesta uuden version, jonka tila on mitätöity.


11 AINEISTOJEN HAUN JA KATSELUN TESTAUS

Tulorekisterin sähköisessä asiointipalvelussa on mahdollista hakea ja katsella kaik-kia niitä aineistoja, jotka testaava organisaatio on toimittanut xml-tiedostomuodossa rajapinnan tai latauspalvelun kautta tulorekisteriin.

Aineistojen hakuun siirrytään vasemmasta navigaatiosta valitsemalla kohta Lähete-tyt aineistot. Hakua voi tarkentaa omistajan aineistoviitteen, tulorekisterin aineisto-viitteen tai tulorekisterin vastaanottopäivän mukaan. Aineistot listautuvat vastaanot-topäivän mukaan.

Aineiston 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äät-tynyt.

Hylätty käsittelyssä: Aineisto ja kaikki sen sisältämät kohteet on hylätty. Käsittely-palaute 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.

12 RAPORTTIEN TESTAUS

Sähköisessä asiointipalvelussa on mahdollista tilata raportteja. Tulorekisteri muo-dostaa raportit testaavan organisaation tekemän tilauksen perusteella. Raportit ovat pdf-muotoisia ja valmiit raportit ovat saatavilla sähköisen asiointipalvelun Tilaukset-sivulla. Testaaja voi tehdä tilauksen sähköisen asiointipalvelun verkkolomakkeella tai latauspalvelussa sekä tulorekisterin teknisen rajapinnan kautta. Raporteista voi testata seuraavia toimintoja:

Tilaa raportti sähköisessä asiointipalvelussa

Avaa tilattu raportti sähköisessä asiointipalvelussa

Ylläpidä raporttitilausta (tulee testattavaksi myöhemmin)

Tällä hetkellä tiedon tuottaja voi tilata sähköisen asiointipalvelun kautta sidosryh-mätestauksessa seuraavia raportteja:

500 Tulonsaajan tulorekisteriote

600 Maksajan palkkatietojen yhteenveto (kertatilaus)

610 Ilmoituksilla havaittujen virheiden yhteenveto (kertatilaus) Nämä raportit tulevat testattavaksi myöhemmin:

602 Maksajan palkkatietoilmoitusten yhteenveto (kertatilaus)

603 Maksajan palkkatietoilmoitusten yhteenveto (jatkuva tilaus)

604 Työnantajan erillisilmoitusten yhteenveto (kertatilaus)

605 Työnantajan erillisilmoitusten yhteenveto (jatkuva tilaus)

606 Maksajan palkkatietoilmoitusten tulonsaajakohtainen yhteenveto (ker-tatilaus)


607 Maksajan palkkatietoilmoitusten tulonsaajakohtainen yhteenveto (jat-kuva tilaus)

608 Maksajan aineistojen ja tulotietoilmoitusten lukumäärät (kertatilaus)

609 Maksajan aineistojen ja tulotietoilmoitusten lukumäärät (jatkuva tilaus)

611 Ilmoituksilla havaittujen virheiden yhteenveto (jatkuva tilaus)

612 Maksajan käyttölokitiedot

614 Maksajan etuustietoilmoitusten yhteenveto (kertatilaus)

615 Maksajan etuustietoilmoitusten yhteenveto (jatkuva tilaus)

616 Maksajan etuustietoilmoitusten tulonsaajakohtainen yhteenveto (ker-tatilaus)

617 Maksajan etuustietoilmoitusten tulonsaajakohtainen yhteenveto (jat-kuva tilaus)

Jos organisaatio on tilannut rajapinnan tai latauspalvelun kautta xml-muotoisia ai-neistoja, myös niiden tilaukset näkyvät Tilaukset-sivulla.

Lisätietoja raporttien sisällöstä: Raportit tulorekisteristä (pdf)

Sähköisen asiointipalvelun ohje: Tilaukset

13 SOPIMUSHALLINNAN TESTAUS

Jos organisaatio testaa vain tulorekisterin sähköistä asiointipalvelua, se ei tarvitse rajapintapalveluja eikä varmennetta.

Jos taas testaava organisaatio testaa sähköisen asiointipalvelun lisäksi myös raja-pintoja, se voi testata sähköisessä asiointipalvelussa seuraavia sopimushallinnan toimintoja:

Tee hakemus teknisen rajapinnan käyttöönottamiseksi (tiedon tuottaja)

Katsele voimassa olevia oikeuksia teknisen rajapinnan käyttöön (tiedon tuottaja)

Katsele varmenteiden tietoja (tiedon tuottaja)

Hae uutta varmennetta (tiedon tuottaja).

https://www.vero.fi/globalassets/tulorekisteri/raportit-tulorekisterist%C3%A4.pdf

https://www.vero.fi/tulorekisteri/tietoa-meist%C3%A4/sahkoisen-asiointipalvelun-kayttoohjeet/aineistotilaus/raportit/


14 TESTAUSPROSESSI

Alla olevassa kuvassa on kuvattu testauksen kulku sidosryhmätestauksen ede-tessä.

Kuva 3: Sidosryhmätestausprosessi.

15 TESTAUKSEN HAVAINTOJEN RAPORTOINTI

Testauksen havainnot toimitetaan tulorekisterille käyttämällä havaintolomaketta. Linkki lomakkeeseen toimitetaan testaavalle taholle testauksen aloitusilmoituksen käsittelyn jälkeen. Havainnon mahdollinen jatkoselvittely tehdään sähköpostitse.

15.1 Ohje havaintolomakkeen kenttien täyttöön

Häiriötilanne, joka estää järjestelmän käytön: Jos havaitset tulorekisterin sidos-ryhmätestauksessa vakavan häiriön, merkitse ”kyllä”. Tulorekisterin testausorgani-saatio arvioi häiriön vakavuuden. Vakavissa häiriötilanteissa tulorekisterin sidos-ryhmätestaus keskeytyy. Tulorekisteri tiedottaa häiriötilanteen laajuudesta ja kor-jausaikataulusta testaaville sidosryhmäorganisaatioille. Otsikko: Havaintoa mahdollisimman hyvin kuvaava otsikko. Testauksen kohde: Merkitse, koskeeko havainto palkkatietojen vai etuustietojen testausta. Testausympäristö: Merkitse, kumpaa sidosryhmätestausympäristöä havainto koskee (EXT1 vai EXT2). Virheluokka: Neliportainen asteikko, jolla kuvataan virheen kriittisyyttä. Ohjeistus virheluokan käyttöön on dokumentin Sidosryhmätestaussuunnitelma (pdf) kappa-leessa Virheiden luokittelu. 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 (Web Service / SFTP / Latauspalvelu / Sähköinen asiointipalvelu). Palvelut: Valitse palvelu, jota testattiin.



Liite: Lähetetyn sanoman xml. Jos tilanteessa palautui sanoma tai jokin virheilmoi-tus, se liitetään myös tähän. Kuvaus havainnosta:

Mitä palvelua testattiin? (Esim. palkkatietoilmoitus/etuusilmoitus, uusi/kor-vaava/mitätöinti)

Mitä kanavaa testataan? (Web Service, SFTP, Sähköinen asiointipalvelu / Latauspalvelu)

Mitä testaaja teki?

Mitä testauksessa tapahtui?

Mikä oli odotettu lopputulos, mitä olisi pitänyt tapahtua?

15.2 Esimerkki kirjatusta havainnosta

Ohessa kuvattu havaintolomakkeen täyttäminen tarvittavien tietojen osalta kirjatusta havainnosta. Otsikko: Uusi palkkatietoilmoitus tulolajilla 404 Lähdevero ei hyväksy negatiivista arvoa Testauksen kohde: Merkitse, koskeeko havainto palkkatietojen vai etuustietojen testausta. Testausympäristö: Merkitse, kumpaa sidosryhmätestausympäristöä havainto koskee (EXT1 vai EXT2). Virheluokka: 3 Medium / Keskivakava Havainnon tekijän nimi: Hemmo Testaaja Organisaation nimi: Ohjelmistotalo X Havainnon tekijän sähköpostiosoite: [email protected] 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öpostilla 1–2 työ-päivän kuluessa. Jos havainto on virhe, lähetetään sähköpostissa myös virheen tun-niste (ID). Tämän jälkeen havainnon tekijän pitää lähettää kyseiseen havaintoon liit-tyvät mahdolliset kommentit sähköpostilla ja käyttää virheen tunnistetta viestin otsi-kossa.

15.3 Virhe, joka estää testaamisen

Jos havainto on sellainen virhe, joka estää sidosryhmätestauksen etenemisen, ha-vainnon tekijä valitsee virheluokaksi 1 Critical / Kriittinen. Tällöin tulorekisteri priori-soi havainnon käsittelyn. Jos virheraati säilyttää virheluokan ennallaan, kriittinen


virhe ohjataan korjaukseen. Kriittiset virheet ohjataan korjaukseen ohi normaalin vir-hehallintaprosessin. Virheen havaitsija saa tiedon virheen ohjauksesta korjaukseen sekä arvion vian korjausajasta. Lisäksi virhetilanteesta tiedotetaan tulorekisteri.fi-si-vustolla. Tulorekisteri voi myös laskea virheluokan tasolta 1 alemmaksi, jolloin virhe käsitel-lään normaalin virhehallintaprosessin mukaisesti. Tässä tapauksessa tulorekisteri 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 ko-konaan yhdessä kanavassa. Estää testaamisen kokonaan niiltä palkkatieto-jen 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öin-nin voi tehdä tulorekisterin ilmoitusviitteellä ja testausta voi jatkaa.

15.4 Havainnon käsittely tulorekisterissä

Kaikki havainnot käsitellään. Virheiksi luokitellut havainnot käsitellään tulorekisterin virheraadissa, jossa virheille määritellään korjausjärjestys. Tulorekisteri on havain-non tekijään yhteydessä, jos tulorekisterin virheraati muuttaa virheluokkaa tai jos havainnosta tarvitaan lisätietoa. Sidosryhmätestaukseen vaikuttavista virheistä tiedotetaan testauksen työtilassa (Tiimeri). Työtilan osoite lähetetään testauksen yhteyshenkilölle testauksen aloituk-sen yhteydessä.

15.5 Muutospyyntö

Jos sidosryhmä havaitsee testauksen yhteydessä muutostarpeen, esimerkiksi tar-peen uudelle toiminnallisuudelle, sidosryhmä täyttää muutospyyntölomakkeen ja lä-hettää sen sähköpostitse tulorekisterille. Tulorekisteri ilmoittaa muutospyynnön kä-sittelyn etenemisestä muutospyynnön tekijälle.

Muutospyyntölomakkeen saa lähettämällä pyynnön sähköpostilla osoitteeseen [email protected] ja täytetty lomake palautetaan samaan osoitteeseen.

16 TESTAUKSEN LOPETTAMINEN

Kun sidosryhmä on saanut oman sähköisen asiointipalvelun testauksensa päätök-seen, sidosryhmä lähettää tästä sähköpostilla tiedon tulorekisterille osoitteeseen



[email protected]. Testaus voidaan katsoa suoritetuksi, kun sidos-ryhmä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 tar-koituksena on antaa tulorekisterin valmiusarviointia varten tieto siitä, että toteutetut liittymät ovat testanneen sidosryhmän näkökulmasta valmiit tuotantokäyttöön.

17 LISÄTIETOA

Tulorekisterin sidosryhmätestaus Sidosryhmätestaussuunnitelma (pdf) Julkaisuaikataulu (pdf) Palkat – Koodistot – Tulolajit (pdf) Etuudet – Koodistot – Tulolajit (pdf) Koodistot (pdf)


https://www.vero.fi/tulorekisteri/ohjelmistokehittäjät/sidosryhmätestaus/





https://www.vero.fi/globalassets/tulorekisteri/koodistot.pdf

Documents

SISÄLLYSLUETTELO - Verohallinto...Verohallinto, Kela, Työllisyysrahasto sekä työeläkelaitokset ja ETK. Toisessa vaiheessa 1.1.2020 lähtien tiedon käyttäjiksi tulevat Potilasvakuutuskeskus,