Testauksen ohjeet sidosryhmille

Ohjetta on viimeksi päivitetty 1.4.2026. Ohjeesta on poistettu viittaukset rekisterin ensimmäiseen ja toiseen vaiheeseen, sidosryhmätestausympäristöjen nimet on päivitetty ja lisäksi ohjeeseen on tehty selkeytyksiä. 

1 Tarkoitus ja tavoitteet

Tämä ohje on tarkoitettu positiivisen luottotietorekisterin sidosryhmätestaukseen osallistuville. Ohje koskee sekä rekisterin käytössä olevien että tulevien toiminnallisuuksien sidosryhmätestausta.

Sidosryhmätestaukseen osallistuvat

•    luottojen tietoja positiiviseen luottotietorekisteriin ilmoittavat organisaatiot
•    luottotietorekisteriotetta hyödyntävät luotonantajat
•    luottotietoyhtiöt
•    rekisterin tietoja hyödyntävät viranomaiset.

Testauksen kohteena ovat tekniset rajapinnat. Positiiviseen luottotietorekisteriin tietoja voi ilmoittaa ja niitä voi kysellä ainoastaan rajapintojen kautta, joten kaikkien tietoja ilmoittavien on varauduttava rajapintaratkaisuun ja rajapinnan toimivuus on varmistettava sidosryhmätestauksella ennen käyttöönottoa.

Testauksella sidosryhmä voi varmistua siitä, että se pystyy teknisesti ilmoittamaan tiedot rekisteriin ja kyselemään niitä. Testausympäristöissä voi tehdä esimerkiksi jatkuvaa regressiotestausta tai mahdollisten uusien toiminnallisuuksien testausta. Rajapintojen testauksen yhteydessä sidosryhmä voi varmistua siitä, että omat järjestelmät ja prosessit toimivat halutulla tavalla. Sidosryhmä on itse vastuussa omien rajapintojensa rakentamisesta ja niiden lainmukaisuudesta.

Testauksessa on käytettävä keinotekoista tai anonymisoitua aineistoa, joka ei saa olla yhdistettävissä luonnollisiin henkilöihin tai heidän tietoihinsa. Henkilötunnusten lisäksi mitään muutakaan luonnollisiin henkilöihin yhdistettävää aineistoa ei missään tilanteessa saa käyttää testiaineistona.

Käytettävissä on kaksi sidosryhmätestausympäristöä:

ExtTest: Rekisterin tuotannossa olevia toiminnallisuuksia vastaava testausympäristö, jossa voi testata rekisterin tuotantoa vastaavaa ratkaisua. Tässä testausympäristössä voi joskus olla myös samoja tuleviin muutoksiin liittyviä toiminnallisuuksia kuin ExtTest2:ssa. Ne ilmenevät sidosryhmätestauksen toimitusselosteilta. 

Tuotannon toiminnallisuudet kuvataan Dokumentaatio-sivun kohdassa Tuotannon dokumentaatio.

ExtTest2: Rekisterin tulevia muutoksia vastaava testausympäristö, jossa voi testata tulevien toiminnallisuuksien mukaista ratkaisua. Jos toteutukseen tehdään muutos tai korjaus, se julkaistaan yleensä ensin tähän sidosryhmätestausympäristöön. Tämä testausympäristö sisältää myös tuotannon mukaiset ominaisuudet siltä osin kuin tulevat muutokset eivät niihin vaikuta.

Tulevista muutoksista viestitään 6 kuukautta ennen tuotantoon vientiä ja muutokset kuvataan Dokumentaatio-sivun kohdassa Tulossa olevat muutokset. 

Tutustu myös muihin keskeisiin ohjeisiin ennen testauksen aloittamista

•    Yleisohjeet, Tuotannon dokumentaatio ja Tulossa olevat muutokset
•    Tietojen ilmoittaminen positiiviseen luottotietorekisteriin
•    Tietojen luovuttaminen positiivisesta luottotietorekisteristä
•    Ohje testiaineiston anonymisoinnista
•    Testivarmenneohje

2 Ilmoittautuminen testaukseen

Testaukseen ilmoittaudutaan sidosryhmätestauksen aloitusilmoituksella, jonka täyttää yksi sidosryhmän edustaja. 

Testaukseen ilmoittautumisen yhteydessä sidosryhmä

•    hyväksyy sidosryhmätestauksen käyttöehdot
•    ilmoittaa testauksen yhteyshenkilön sekä teknisen yhteyshenkilön
•    voi ilmoittautua sekä tietojen ilmoittamisen että tietojen kyselyn testauksiin.

Käsittelyn jälkeen aloitusilmoituksen täyttänyt henkilö saa sähköpostilla sidosryhmän käyttöön keinotekoisen luotonantajan Y-tunnuksen sekä keinotekoisia luotonsaajan henkilötunnuksia ja Y-tunnuksia, joilla sidosryhmä voi testata.

Ilmoitusvelvollisuutta rekisteriin tai oikeutta tietojen hyödyntämiseen rekisteristä ei tutkita silloin, kun sidosryhmä ilmoittautuu testaukseen. Tämä tarkoittaa sitä, että testaukseen osallistuminen ei takaa oikeutta esimerkiksi tietojen hyödyntämiseen tuotantovaiheessa. Ennen rekisterin käyttöönottoa sidosryhmät ilmoittautuvat ilmoitusvelvollisiksi rekisteriin ja hakevat mahdollista tietolupaa.

2.1 Puolesta testaaminen

Sidosryhmä voi sopia siitä, että jokin toinen taho testaa sen puolesta. Näin voidaan toimia esimerkiksi silloin, kun sidosryhmä on ulkoistanut teknisen ratkaisun toiselle toimijalle. Tällöin ilmoitusvelvollinen tai tietoja hyödyntävä sidosryhmä voi ilmoittautua testaukseen itse tai testaava taho voi ilmoittautua sidosryhmän puolesta.

Testauksen aloitusilmoituksen lisätiedoissa on selvennettävä, minkä organisaation puolesta ilmoittautuja testaa tai mikä taho testaa ilmoittautujan puolesta. Testaukseen ilmoittautumisen yhteydessä ilmoitetaan testausta suorittavan tahon teknisen yhteyshenkilön tiedot.

3 Testivarmenne

Testirajapintojen käyttö vaatii, että rajapintaa kutsuva käyttäjä tunnistetaan kutsun yhteydessä. Testivarmenne on sähköinen tunniste, jolla käyttäjä tunnistetaan sidosryhmätestausympäristöissä. Sidosryhmä saa keinotekoiseen Y-tunnukseen liittyvät testivarmenteet testaukseen ilmoittautumisen jälkeen. Samoja testauksen varmenteita voi käyttää kummassakin testausympäristössä.

Testaukseen ilmoittautumisen jälkeen tekninen yhteyshenkilö saa turvasähköpostilla testivarmenteen noutotunnukset ja tekstiviestillä turvasähköpostin avaamiseen tarvittavan PIN-koodin.

Jos sidosryhmä testaa sekä tietojen ilmoittamista että tietojen kyselyä, se saa kaksi eri varmennetta, sillä tietojen ilmoittajalla ja hyödyntäjällä on eri varmennetyypit.

Varmenne on noudettava 14 vuorokauden sisällä viestien saamisesta. Jos varmennetta ei noudeta 14 vuorokauden sisällä, sidosryhmä voi tilata uuden varmenteen varmennepalvelussa tai testauksen yhteydenottolomakkeella.

Lisätestivarmenteista sekä varmenteiden sulkemisesta ja uusimisesta ohjeistetaan testivarmenneohjeessa. Varmenteet ovat voimassa 2 vuotta. Sidosryhmän pitää itse uusia varmenne varmennepalvelun rajapinnassa.

Sidosryhmän testauksen yhteyshenkilö ja tekninen yhteyshenkilö saavat myös sähköpostin, jossa on kirjautumislinkki Verohallinnon varmennepalvelun sähköiseen asiointipalveluun. 

Tutustu testivarmenneohjeeseen
Tutustu varmennepalvelun ohjeisiin

4 Testaus

Sidosryhmän on hyvä testata kaikki ne rajapinnat, joita se tulee käyttämään tuotantokäytössäkin. Testauksessa kannattaa edetä yksinkertaisista perustapauksista monimutkaisempiin testitapauksiin, niin että kaikki omat luottotuotteet, erilaisten prosessien kaikki vaiheet ja tilanteet testataan. Kannattaa myös suunnitella itselleen relevantit testitapaukset erilaisista ilmoittamisen ja kyselyn tilanteista ja huomioida muun muassa muutos- ja virhetilanteet.

Luotonantajien rajapinnoista on tehty demovideot testauksen tueksi. Katso demovideot luotonantajien rajapinnoista YouTubesta.

Tietojen ilmoittamisen testaus

Testauksen tarkoituksena on varmistaa, että:

•    sidosryhmien tietojärjestelmät tuottavat oikeanlaista vaatimusten mukaista tietoa, jonka sidosryhmä pystyy ilmoittamaan positiiviseen luottotietorekisteriin
•    sidosryhmä saa ilmoituksistaan oikeanlaisen käsittelypalautteen ja pystyy hyödyntämään sitä
•    sidosryhmä voi yhä ilmoittaa oikeanlaista tietosisältöä, jos toiminnallisuudet muuttuvat
•    sidosryhmän omat prosessit ja järjestelmät käsittelevät erilaiset tilanteet, muun muassa virhetilanteet, halutulla tavalla.

Luoton tietojen tarkistamisen rajapintaa käyttämällä voi testauksen eri vaiheissa tarkistaa, että luoton tiedot ovat oikein.

Luottotietorekisteriotteen kyselyn testaus

Testauksen tarkoituksena on varmistaa, että:

•    sidosryhmä pystyy tilaamaan luottotietorekisteriotteen ja tiedot näkyvät oikein sidosryhmän omissa järjestelmissä
•    sidosryhmä voi yhä vastaanottaa luottotietorekisteriotteen, jos toiminnallisuudet muuttuvat
•    rekisteristä kyseltyä tietoa voi hyödyntää sidosryhmän omissa järjestelmissä
•    sidosryhmän omat prosessit ja järjestelmät käsittelevät erilaiset tilanteet, muun muassa virhetilanteet, halutulla tavalla.

Regressiotestaus

Regressiotestauksen tavoitteena on varmistaa, että muutokset eivät ole rikkoneet aikaisemmin toiminutta toiminnallisuuta. Tee regressiotestausta aina, kun omissa järjestelmissänne tai positiivisen luottotietorekisterin toiminnallisuuksiin on tehty muutoksia.

4.1 Sidosryhmätestausympäristöt

Sidosryhmät voivat testata positiivisen luottotietorekisterin rajapintoja kahdessa eri sidosryhmätestausympäristössä eli ExtTest - tuotannossa olevien toiminnallisuuksien testausympäristössä ja ExtTest2 - tulevien toiminnallisuuksien testausympäristössä. Sidosryhmätestausympäristöt ovat käytössä koko ajan, lukuun ottamatta suunniteltuja käyttökatkoja tai mahdollisia vikatilanteita, joihin reagoidaan arkisin virka-aikana.

Sidosryhmätestausympäristöt ovat kaikille testaaville sidosryhmille yhteiset, eli testauksessa ilmoitetut tiedot voivat tietojen kyselyn testauksessa päätyä muille testaajille.

ExtTest - testausympäristö (api-testi)

Rekisterin tuotannossa olevia toiminnallisuuksia vastaava testausympäristö, jossa voi testata rekisterin tuotantoa vastaavaa ratkaisua. Tässä testausympäristössä voi joskus olla myös samoja tuleviin muutoksiin liittyviä toiminnallisuuksia kuin ExtTest2:ssa. Ne ilmenevät sidosryhmätestauksen toimitusselosteilta.

Tuotannon toiminnallisuudet kuvataan Dokumentaatio-sivun kohdassa Tuotannon dokumentaatio.

ExtTest2 - testausympäristö (api-testi2)

Rekisterin tulevia muutoksia vastaava testausympäristö, jossa voi testata tulevien toiminnallisuuksien mukaista ratkaisua. Jos toteutukseen tehdään muutos tai korjaus, se julkaistaan yleensä ensin tähän sidosryhmätestausympäristöön. Tämä testausympäristö sisältää myös tuotannon mukaiset ominaisuudet siltä osin kuin tulevat muutokset eivät niihin vaikuta.

Tulevista muutoksista viestitään 6 kuukautta ennen tuotantoon vientiä ja muutokset kuvataan Dokumentaatio-sivun kohdassa Tulossa olevat muutokset. 

Sidosryhmätestausympäristöillä on eri rajapintaosoitteet. Kummassakin testausympäristössä toimivat samat testiasiakastunnisteet ja testivarmenteet. Yhteen testausympäristöön ilmoitetut luottojen tiedot eivät ole käytössä toisessa testausympäristössä.

4.2 Testattavat rajapinnat ja niiden osoitteet

Tuotantokäytössä ja sidosryhmätestauksessa on omat rajapintaosoitteet. Tuotantoympäristöön ei saa missään tilanteessa lähettää testiaineistoa eikä testausympäristöön tuotantoaineistoa. 

Sidosryhmätestauksessa on käytössä alla olevat rajapinnat. ExtTest-testausympäristön rajapintaosoite sisältää tekstin api-testi. ExtTest2-testausympäristön rajapintaosoite sisältää tekstin api-testi2.

Uusi luotto 
•    https://api-testi.positiivinenluottotietorekisteri.fi/AddLoans
•    https://api-testi2.positiivinenluottotietorekisteri.fi/AddLoans

Luoton tietojen muutos 
•    https://api-testi.positiivinenluottotietorekisteri.fi/UpdateLoans
•    https://api-testi2.positiivinenluottotietorekisteri.fi/UpdateLoans

Maksutapahtuma 
•    https://api-testi.positiivinenluottotietorekisteri.fi/Repayments
•    https://api-testi2.positiivinenluottotietorekisteri.fi/Repayments

Maksuviive 
•    https://api-testi.positiivinenluottotietorekisteri.fi/DelayedRepayments
•    https://api-testi2.positiivinenluottotietorekisteri.fi/DelayedRepayments

Luoton päättyminen
•    https://api-testi.positiivinenluottotietorekisteri.fi/TerminateLoans
•    https://api-testi2.positiivinenluottotietorekisteri.fi/TerminateLoans

Lähetetyn aineiston tilan kysely
•    https://api-testi.positiivinenluottotietorekisteri.fi/GetBatchStatus
•    https://api-testi2.positiivinenluottotietorekisteri.fi/GetBatchStatus

Luoton tietojen tarkistaminen
•    https://api-testi.positiivinenluottotietorekisteri.fi/GetLoan
•    https://api-testi2.positiivinenluottotietorekisteri.fi/GetLoan

Rajapinta luottotietorekisteriotteen kyselyyn
•    https://api-testi.positiivinenluottotietorekisteri.fi/GetCreditRegisterExtract
•    https://api-testi2.positiivinenluottotietorekisteri.fi/GetCreditRegisterExtract

Lisäksi kaikki testaukseen osallistuvat organisaatiot voivat testata käyttökatkotilanteita lähettämällä rajapintakutsun osoitteeseen https://api-testi.positiivinenluottotietorekisteri.fi/Servicebreak ja https://api-testi2.positiivinenluottotietorekisteri.fi/Servicebreak. Tämän osoitteen kutsuminen palauttaa saman sanoman kuin rajapinnat käyttökatkon aikana.

4.3 Julkaisut testauksen aikana

Sidosryhmätestausympäristöihin viedään uusia versioita julkaisuaikataulun mukaisesti. Julkaisu aiheuttaa käyttökatkon testausympäristöissä. Käyttökatkot toteutetaan molempiin testiympäristöihin samanaikaisesti. 

Uuden version sisällöstä tuotetaan tarvittaessa toimitusseloste. Toimitusselosteessa eritellään kumpaankin ympäristöön tehdyt muutokset tai ympäristöissä olevat puutteet, jos sellaisia on tiedossa.

Katkojen ajankohdat ja julkaistut toimitusselosteet ovat sivulla Palvelukatkot ja toimitusselosteet. 

Järjestelmätiedotteen tilaajat saavat sähköpostiin muun muassa ennakkotiedon sidosryhmätestauksen käyttökatkoista. Tilaa järjestelmätiedote sähköpostiisi.

4.4 Testausaineisto

Testauksessa käytetään vain keinotekoisia testiasiakastunnuksia, jotka sidosryhmätestauksen aloitusilmoituksen täyttänyt sidosryhmän edustaja saa positiiviselta luottotietorekisteriltä ilmoittautumisen jälkeen. Keinotekoisten henkilötunnusten loppuosa alkaa numerolla 9, eikä testiympäristöissä saa käyttää muun muotoisia henkilötunnuksia.

Molemmissa testausympäristöissä voi käyttää samaa sidosryhmän saamaa keinotekoista luotonantajan Y-tunnusta ja siihen liitettyä testivarmennetta. Jos sidosryhmä haluaa uuden keinotekoisen Y-tunnuksen testaukseen, sitä voi pyytää sidosryhmätestauksen yhteydenottolomakkeella.

Kaikki testausympäristöön toimitettu tieto on muiden ympäristössä toimivien testaajien käytettävissä. Tietojen ilmoittamisen testauksessa testausympäristöön toimitettua tietoa hyödynnetään tietojen kyselyn testauksessa. Esimerkiksi viranomaiset voivat kysellä luotonantajien ilmoittamaa testiaineistoa.

4.4.1 Yhteiskäyttöinen testiaineisto rekisteriotteen kyselyn testaukseen

Sidosryhmien käytettävissä on yhteiskäyttöinen testiasiakasaineisto, jolla voi testata erityisesti luottotietorekisteriotteen kyselyä. Osaan yhteiskäyttöisistä testihenkilötunnuksista on liitetty monipuolisia tulo- ja etuustietoja sekä esimerkiksi luottojen tietoja, luottokieltoja ja tietojen kiistämistä koskevia merkintöjä. Näitä tietoja tarvitaan luottotietorekisteriotteen kyselyn testaamiseen. 

Testiasiakastunnukset yhteiseen käyttöön (Excel-tiedosto).

Tiedostosta löytyy yhdeltä välilehdeltä keinotekoisia organisaatiotunnisteita, joita voidaan käyttää siirronsaajana, kun testataan luoton siirtoa.

Yhteiskäyttöisille testiasiakkaille ei saa ilmoittaa luottoja.

4.4.2 Tietojen ilmoittamista testaavien omassa käytössä oleva testiaineisto

Tietojen ilmoittamista testaavat sidosryhmät saavat lisäksi vain oman organisaation käyttöön rajattuja keinotekoisia asiakastunnisteita. Testaukseen ilmoittautumisen jälkeen sidosryhmä saa listauksen näistä testiasiakastunnisteista.

Testausympäristöön ilmoitettua testiaineistoa ei voi poistaa muuten kuin päättämällä tai mitätöimällä luotot. Tämä kannattaa ottaa huomioon testauksen suunnittelussa.

Sidosryhmän omassa käytössä oleva testiaineisto voi päätyä muille testaajille, esimerkiksi viranomaisten tietojen kyselyn testauksissa.

4.4.3 Testiaineiston keinotekoisuus ja anonymisointi

Kun sidosryhmät toimittavat testauksen aikana keinotekoiseen henkilötunnukseen liitettyjä aineistoja testausympäristöön, niiden pitää varmistaa, että aineistojen tiedot ovat keinotekoisia tai ne on anonymisoitu testiaineiston anonymisointiohjeen vaatimusten mukaisesti. Sidosryhmät vastaavat siitä, että niiden toimittamat testiaineistot ovat keinotekoisia tai anonymisoituja. Lue lisää testiaineiston anonymisoinnin ohjeesta.

Jos sidosryhmä on erehdyksessä kuitenkin ilmoittanut sidosryhmätestausympäristöön oikeaa tuotantoaineistoa tai muutoin anonymisointiohjeen vastaista tietoa tai epäilee ilmoittaneensa, täytyy sidosryhmän olla välittömästi yhteydessä sidosryhmätestauksen yhteydenottolomakkeella ja ilmoittaa asiasta. Ilmoita, milloin tietoa on ilmoitettu, millaista tietoa ja miten olette itse asiaa mahdollisesti jo pyrkineet korjaamaan. Testausympäristö tai testausrajapintoja joudutaan mahdollisesti sulkemaan kokonaan selvitysten ajaksi. Sidosryhmän pitää tarvittaessa tehdä ilmoitus tietoturvaloukkauksesta tietosuojavaltuutetulle.

5 Testauksen havainnot ja raportointi

Sidosryhmä raportoi havainnoistaan ja virhe-epäilyistään sidosryhmätestauksen havaintolomakkeella.

Toimitusselosteesta voi tarkistaa, onko kyseinen virhe jo tiedossa. Kannattaa myös varmistaa, että testauksessa on käytetty toteutuksen oikeaa versiota eli oikeaa testirajapintaosoitetta.

Havaintolomakkeen voi täyttää, jos virhettä ei ole jo raportoitu toimitusselosteessa, kyseessä ei ollut käyttökatko, josta olisi tiedotettu, ja rajapintaosoite oli oikea. Lomakkeessa on raportoitava mahdollisimman tarkasti, missä tilanteessa virhe on havaittu, ja siihen voi liittää mahdolliset kuvakaappaukset ja muut liitteet, esimerkiksi lähetetyn aineiston tai vastaussanoman.

6 Testauksen tuki ja viestintä

Sidosryhmätilaisuuksissa kerrotaan esimerkiksi uusista ominaisuuksista, ohjeistuksista ja ajankohtaisista asioista. Niissä on myös sidosryhmätestaukseen liittyvää sisältöä. Lue lisää sidosryhmätilaisuuksista.

Suunniteltujen käyttökatkojen ajankohdat ja julkaistut toimitusselosteet ovat sivulla Palvelukatkot ja toimitusselosteet.