Anvisningar för testning för intressentgrupper

Anvisningen har senast uppdaterats 1.4.2026. Hänvisningarna till den första och andra fasen av registret har tagits bort. Namnen på testmiljöerna för intressentgrupper har uppdaterats och dessutom har texten förtydligats. 

1 Syfte och mål

Den här anvisningen är avsedd för dem som deltar i intressentgruppstestningen för det positiva kreditupplysningsregistret. Anvisningen gäller både intressentgruppstestningen av funktionerna som används i registret nu och kommande funktioner.

I intressentgruppstestningen deltar

•    organisationer som anmäler uppgifter om krediter till det positiva kreditupplysningsregistret
•    kreditgivare som använder utdraget ur kreditupplysningsregistret
•    kreditupplysningsföretag
•    myndigheter som använder registrets uppgifter.

Målet för testningen är de tekniska gränssnitten. Det går att anmäla uppgifter till och göra förfrågningar om uppgifter från det positiva kreditupplysningsregistret endast via gränssnitten. Sålunda ska alla som anmäler uppgifter förbereda sig för gränssnittslösningen och före ibruktagandet ska man genom intressentgruppstestning säkerställa att gränssnittet fungerar.

Genom testningen kan intressentgrupperna försäkra sig om att de tekniskt klarar av att anmäla uppgifterna till registret och göra förfrågningar om dem. Man kan till exempel i testmiljön utföra fortlöpande regressionstestning eller testning av eventuella nya funktioner. I samband med testningen av gränssnitten kan intressentgrupperna försäkra sig om att deras egna system och processer fungerar på önskat sätt. Intressentgrupperna ansvarar själva för att bygga upp sina egna gränssnitt och för att de är lagenliga.

Det är obligatoriskt att använda konstgjort eller anonymiserat material vid testningen. Materialet ska inte kunna kopplas till fysiska personer eller deras uppgifter. Utöver personbeteckningarna får under inga omständigheter inte heller några andra data som kan kopplas till fysiska personer användas som testdata.

Det finns två testmiljöer för intressentgrupper:

ExtTest: En testmiljö som innehåller de funktioner som finns i registrets produktionsversion, där man kan testa lösningar som motsvarar registrets produktionsfas. I denna testmiljö kan det ibland också finnas samma funktioner som ansluter till kommande ändringar som i ExtTest2. Dessa framgår av leveransbeskrivningarna för intressentgruppstestningen.

Funktionerna i produktionsmiljön beskrivs i avsnittet Dokumentation för produktionsfasen på sidan Dokumentation. 

ExtTest2: En testmiljö som motsvarar de kommande ändringarna i registret, där man kan testa lösningar som motsvarar de kommande funktionerna. Om implementeringen ändras eller korrigeras publiceras ändringen eller korrigeringen i allmänhet först i denna testmiljö för intressentgrupper. Denna testmiljö innehåller även de egenskaper som finns i produktionsmiljön i den utsträckning som kommande ändringar inte påverkar dem.
 
Information om kommande ändringar ges 6 månader före införandet i produktionen och ändringarna beskrivs i avsnittet Kommande ändringar på sidan Dokumentation.

Bekanta dig också med andra centrala anvisningar innan testningen inleds

•    Allmänna anvisningar, Dokumentation för produktionsfasen och Kommande förändringar
•    Anmälan av uppgifter till det positiva kreditupplysningsregistret
•    Utlämnande av uppgifter ur det positiva kreditupplysningsregistret
•    Anvisning för anonymisering av testdata
•    Anvisningar för testcertifikat

2 Anmälan till testning

Anmälan till testning sker genom anmälan om inledning av intressentgruppstestning, som fylls i av en representant för intressentgruppen. 

I samband med anmälan till testning

•    godkänner intressentgruppen användarvillkoren för intressentgruppstestningen
•    meddelar intressentgruppen en kontaktperson för testningen och en teknisk kontaktperson
•    kan intressentgruppen anmäla sig både för testning av anmälan av uppgifter och testning av förfrågan av uppgifter.

Efter behandlingen får den person som har fyllt i anmälan om inledning av testning per e-post ett konstgjort FO-nummer för kreditgivare samt konstgjorda personbeteckningar och FO-nummer för kredittagare som intressentgruppen kan använda vid testningen.

Anmälningsskyldigheten till registret eller rätten att använda uppgifter ur registret undersöks inte när intressentgruppen anmäler sig till testningen. Detta innebär att ett deltagande i testningen till exempel inte garanterar att man har rätt att använda uppgifterna i produktionsfasen. Innan registret tas i bruk anmäler sig intressentgrupperna som anmälningsskyldiga till registret och ansöker om ett eventuellt dataanvändningstillstånd.

2.1 Testning för någon annans räkning

Intressentgruppen kan komma överens om att någon annan aktör testar för intressentgruppens räkning. Man kan göra så till exempel när intressentgruppen har gett en annan aktör i uppgift att sköta om den tekniska lösningen. I dessa fall kan den anmälningsskyldige eller intressentgruppen som använder uppgifter anmäla sig till testningen själv eller så kan aktören som utför testningen anmäla sig för intressentgruppens räkning.

I tilläggsuppgifterna i anmälan om inledning av testning ska man specificera för vilken organisation den som anmäler sig till testningen testar eller vilken aktör som utför testningen för den som anmält sig. I samband med anmälan till testning meddelas informationen om den tekniska kontaktpersonen för aktören som utför testningen.

3 Testcertifikat

Användningen av gränssnitten kräver att användaren som anropar gränssnittet identifieras i samband med anropet. Testcertifikatet är en elektronisk kod som används för att identifiera användaren i testmiljön för intressentgrupper. Intressentgruppen får testcertifikaten som anknyter till det konstgjorda FO-numret efter att intressentgruppen har anmält sig till testningen. Samma testcertifikat kan användas i båda testmiljöerna.

Efter anmälan till testningen får den tekniska kontaktpersonen per säker e-post testcertifikatets hämtningskoder och per SMS en PIN-kod som behövs för att öppna det säkra e-postmeddelandet.

Om intressentgruppen testar både anmälan av uppgifter och förfrågan av uppgifter får den två olika certifikat, eftersom olika typer av certifikat används för att anmäla och använda uppgifter.

Certifikatet måste hämtas inom 14 dygn efter att meddelandet har mottagits. Om certifikatet inte hämtas inom 14 dygn kan intressentgruppen beställa ett nytt certifikat i certifikattjänsten eller med kontaktblanketten för testning.

I anvisningarna för testcertifikat finns information om tilläggscertifikat för testning och om spärrning och förnyande av certifikat. Certifikaten är i kraft i 2 år. Intressentgruppen ska själv förnya certifikatet i certifikattjänstens gränssnitt.

Intressentgruppens kontaktperson för testningen och tekniska kontaktperson får också ett e-postmeddelande med en inloggningslänk till e-tjänsten i Skatteförvaltningens certifikattjänst. 

Bekanta dig med anvisningarna för testcertifikatet
Bekanta dig med anvisningarna för certifikattjänsten

4 Testning

Det lönar sig för intressentgruppen att testa alla gränssnitt som den kommer att använda i produktionsbruket. Det lönar sig att vid testningen börja med enkla grundfall och därefter framskrida mot mer komplicerade testfall, så att alla de egna kreditprodukterna, alla skeden och situationer för olika processer testas. Det lönar sig också för intressentgrupperna att göra upp relevanta testfall för sig själva för olika situationer som gäller anmälan och förfrågan och även beakta bland annat ändrings- och felsituationer.

Demovideor om kreditgivarnas gränssnitt har utarbetats som stöd för testningen. Se demovideor om kreditgivarnas gränssnitt i YouTube.

Testning av anmälan av uppgifter

Syftet med testningen är att försäkra sig om att

•    intressentgruppernas datasystem producerar rätt slags uppgifter som uppfyller specifikationerna och att intressentgrupperna kan anmäla dessa uppgifter till det positiva kreditupplysningsregistret
•    intressentgrupperna får rätt typ av behandlingsrespons om sina anmälningar och kan använda responsen
•    intressentgrupperna fortfarande kan anmäla korrekt informationsinnehåll om funktionerna ändras
•    intressentgruppens egna processer och system behandlar olika situationer, bland annat felsituationer, på önskat sätt.

Med gränssnittet för kontroll av kreditens uppgifter går det att i olika skeden av testningen kontrollera att kreditens uppgifter är korrekta.

Testning av förfrågan om utdrag ur kreditupplysningsregistret

Syftet med testningen är att försäkra sig om att

•    intressentgruppen kan beställa utdrag ur kreditupplysningsregistret och uppgifterna visas korrekt i intressentgruppens egna system
•    intressentgrupperna fortfarande kan ta emot utdraget ur kreditupplysningsregistret om funktionerna ändras
•    de uppgifter som har förfrågats från registret kan användas i intressentgruppens egna system
•    intressentgruppens egna processer och system behandlar olika situationer, bland annat felsituationer, på önskat sätt.

Regressionstestning

Syftet med regressionstestningen är att säkerställa att ändringarna inte har söndrat funktioner som fungerat tidigare. Utför regressionstestning alltid när det har gjorts ändringar i funktionerna i ert eget system eller i det positiva kreditupplysningsregistret.

4.1 Testmiljöerna för intressentgrupper

Intressentgrupperna kan testa gränssnitten för det positiva kreditupplysningsregistret i två olika testmiljöer för intressentgrupper, det vill säga i testmiljön för funktionerna i produktionsversionen och testmiljön för kommande funktioner. Testmiljöerna för intressentgrupper kan användas hela tiden med undantag för vid planerade driftsavbrott och eventuella felsituationer, vilka det reageras på vardagar under tjänstetid.

Testmiljöerna för intressentgrupper är gemensamma för alla intressentgrupper som testar och sålunda kan uppgifter som anmälts vid testningen eventuellt lämnas ut till andra testare vid testningen av förfrågan av uppgifter.

ExtTest - testmiljön (api-testi)

En testmiljö som innehåller de funktioner som finns i registrets produktionsversion, där man kan testa lösningar som motsvarar registrets produktionsfas. I denna testmiljö kan det ibland också finnas samma funktioner som ansluter till kommande ändringar som i ExtTest2. Dessa framgår av leveransbeskrivningarna för intressentgruppstestningen.
 
Funktionerna i produktionsmiljön beskrivs i avsnittet Dokumentation för produktionsfasen på sidan Dokumentation. 

ExtTest2 - testmiljön (api-testi2)

En testmiljö som motsvarar de kommande ändringarna i registret, där man kan testa lösningar som motsvarar de kommande funktionerna. Om implementeringen ändras eller korrigeras publiceras ändringen eller korrigeringen i allmänhet först i denna testmiljö för intressentgrupper. Denna testmiljö innehåller även de egenskaper som finns i produktionsmiljön i den utsträckning som kommande ändringar inte påverkar dem.
 
Information om kommande ändringar ges 6 månader före införandet i produktionen och ändringarna beskrivs i avsnittet Kommande ändringar på sidan Dokumentation.

4.2 Gränssnitten som testas och deras adresser

Gränssnittsadresserna för produktionsbruket och intressentgruppstestningen är olika. Testdata får under inga som helst omständigheter skickas till produktionsmiljön och produktionsdata får inte heller någonsin skickas till testmiljön. 

Vid intressentgruppstestningen används gränssnitten nedan. Gränssnittsadressen som gäller för testmiljön för funktionerna i produktionsversionen innehåller texten api-testi. Gränssnittsadressen som gäller för testmiljön för kommande funktioner innehåller texten api-testi2.

Ny kredit 
•    https://api-testi.positiivinenluottotietorekisteri.fi/AddLoans
•    https://api-testi2.positiivinenluottotietorekisteri.fi/AddLoans

Ändring av kreditens uppgifter
•    https://api-testi.positiivinenluottotietorekisteri.fi/UpdateLoans
•    https://api-testi2.positiivinenluottotietorekisteri.fi/UpdateLoans

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

Betalningsdröjsmål
•    https://api-testi.positiivinenluottotietorekisteri.fi/DelayedRepayments
•    https://api-testi2.positiivinenluottotietorekisteri.fi/DelayedRepayments

Avslutande av kredit
•    https://api-testi.positiivinenluottotietorekisteri.fi/TerminateLoans
•    https://api-testi2.positiivinenluottotietorekisteri.fi/TerminateLoans

Förfrågan om status för avsänt material
•    https://api-testi.positiivinenluottotietorekisteri.fi/GetBatchStatus
•    https://api-testi2.positiivinenluottotietorekisteri.fi/GetBatchStatus

Kontroll av kreditens uppgifter
•    https://api-testi.positiivinenluottotietorekisteri.fi/GetLoan
•    https://api-testi2.positiivinenluottotietorekisteri.fi/GetLoan

Gränssnitt för förfrågan om utdrag ur kreditupplysningsregistret
•    https://api-testi.positiivinenluottotietorekisteri.fi/GetCreditRegisterExtract
•    https://api-testi2.positiivinenluottotietorekisteri.fi/GetCreditRegisterExtract

Dessutom kan alla organisationer som deltar i testningen testa driftsavbrott genom att skicka gränssnittsanrop till adresserna https://api-testi.positiivinenluottotietorekisteri.fi/Servicebreak och https://api-testi2.positiivinenluottotietorekisteri.fi/Servicebreak. Anrop till dessa adresser returnerar samma meddelande som gränssnitten under driftsavbrott.

4.3 Publiceringar medan testningen pågår

Testmiljöerna för intressentgrupper får nya versioner i enlighet med tidsplanen för publiceringar. Publiceringen orsakar ett driftsavbrott i testmiljöerna. Driftsavbrotten genomförs samtidigt i de båda testmiljöerna. 

Det utarbetas vid behov en leveransbeskrivning om innehållet i den nya versionen. I leveransbeskrivningen beskrivs ändringarna som gjorts i vardera miljön eller brister i miljöerna, om sådana är kända.

Tidpunkterna för avbrotten och leveransbeskrivningarna som har publicerats finns på sidan Serviceavbrott och leveransbeskrivningar. 

Prenumeranterna på systemmeddelandet får e-post om bland annat förhandsbesked om driftsavbrott i intressentgruppstestningen. Prenumerera på systemmeddelande till din e-post.

4.4 Testningsdata

Vid testningen används endast konstgjorda testkundbeteckningar, vilka den representant för intressentgruppen som har fyllt i anmälan om inledning av intressentgruppstestning får av det positiva kreditupplysningsregistret efter anmälan. Slutdelen av de konstgjorda personbeteckningarna börjar med siffran 9 och inga andra än sådana personbeteckningar får användas i testmiljöerna.

I båda testmiljöerna kan man använda samma konstgjorda FO-nummer för kreditgivaren som intressentgruppen fått och testcertifikatet som kopplats till det. Om intressentgruppen vill ha ett nytt konstgjort FO-nummer för testningen kan intressentgruppen begära ett sådant med kontaktblanketten för intressentgruppstestningen.

Alla data som har levereras till testmiljön kan användas av övriga testare som verkar i miljön. De data som har levererats till testmiljön vid testningen av anmälan av uppgifter används vid testningen av förfrågan av uppgifter. Till exempel myndigheter kan göra förfrågningar som gäller de testdata som kreditgivare har anmält.

4.4.1 Gemensamma testdata för testning av förfrågan av utdraget ur kreditupplysningsregistret

Intressentgrupperna har tillgång till gemensamma kundtestdata som möjliggör i synnerhet testandet av förfrågan om utdrag ur kreditupplysningsregistret. Till en del av de gemensamma testpersonbeteckningarna har det lagts till mångsidiga uppgifter om inkomster och förmåner samt till exempel uppgifter om krediter, kreditförbud och anteckningar om situationer då uppgifterna bestrids. Dessa uppgifter behövs för testningen av förfrågan om utdrag ur kreditupplysningsregistret. 

Testkundbeteckningar för gemensamt bruk (Excel-fil).

På en flik i filen finns konstgjorda organisationsnummer, som kan användas som förvärvare när överföringen av krediten testas.

Krediter får inte anmälas till gemensamma testkundbeteckningar.

4.4.2 Testdata för eget bruk för testare av anmälan av uppgifter

Intressentgrupperna som testar anmälan av uppgifter får dessutom tillgång till konstgjorda kundbeteckningar som är avsedda att bara användas av den egna organisationen. Efter att intressentgruppen har anmält sig till testningen får den en förteckning över dessa testkundbeteckningar.

Det går inte att ta bort testdata som har anmälts till testmiljön på annat sätt en genom att avsluta eller annullera krediterna. Det lönar sig att beakta detta då testningen planeras.

Testdata som är intressentgruppens eget bruk kan hamna hos andra testare, till exempel vid testning av förfrågan av uppgifter för myndigheter.

4.4.3 Konstgjorda testdata och anonymisering

När intressentgrupperna medan testningen pågår levererar data som anknyter till en konstgjord personbeteckning till testmiljön måste intressentgrupperna försäkra sig om att de data som levereras är konstgjorda eller att de är anonymiserade i enlighet med kraven i anvisningen för anonymisering av testdata. Intressentgrupperna ansvarar för att de testdata som de levererar är konstgjorda eller anonymiserade. Läs mer i anvisningen för anonymisering av testdata.

Om intressentgruppen emellertid av misstag har anmält eller misstänker sig ha anmält riktiga produktionsdata till testmiljön för intressentgrupper eller data som annars står i strid med anvisningen om anonymisering ska intressentgruppen omedelbart ta kontakt genom kontaktblanketten för intressentgruppstestningen och meddela om detta. Meddela när uppgifterna har anmälts, hurdana uppgifter som har anmälts och hur ni eventuellt redan har försökt korrigera situationen. Testmiljön eller testgränssnitten måste eventuellt stängas helt medan utredningen pågår. Intressentgruppen ska vid behov göra en anmälan om säkerhetsincidenten till dataombudsmannen.

5 Observationer under testningen och rapporteringen av dem

Intressentgrupperna rapporterar sina observationer och misstankar om fel på observationsblanketten för intressentgruppstestningen.

Det går att kontrollera i leveransbeskrivningen om felet i fråga redan är känt. Det lönar sig också att försäkra sig om att man vid testningen använder rätt version av implementeringen, det vill säga rätt testgränssnittsadress.

Observationsblanketten kan fyllas i om felet inte redan har rapporterats i leveransbeskrivningen, det inte handlade om ett driftsavbrott som det informerats om och gränssnittsadressen var rätt. På blanketten ska man så noggrant som möjligt rapportera i vilken situation felet har observerats. Eventuella skärmbilder och andra bilagor kan bifogas, till exempel materialet som har skickats eller svarsmeddelandet.

6 Stöd och kommunikation för testningen

På intressentgruppsevenemangen ges till exempel information om nya egenskaper, anvisningar och aktuella frågor. I dem finns också innehåll som anknyter till intressentgruppstestningen. Läs mer om intressentgruppsevenemangen

Tidpunkterna för de planerade driftsavbrotten och leveransbeskrivningarna som har publicerats finns på sidan Serviceavbrott och leveransbeskrivningar.