Anvisningar för testning för intressentgrupper

Anvisningen har senast uppdaterats den 7 mars 2023. Ändringen gäller anmälan om inledning av testning och startpaketet: endast administratören kan göra anmälan om inledning av testning och ta emot startpaketet för testning.

1 Syfte och mål

Den här anvisningen är avsedd för sådana som deltar i intressentgruppstestningen för det positiva kreditupplysningsregistret. Anvisningen gäller den första fasen av registret, det vill säga anmälan och förfrågan av uppgifter som gäller konsumentkrediter och därmed likställda krediter. I intressentgruppstestningen deltar organisationer som anmäler uppgifter om krediter till det positiva kreditupplysningsregistret, organisationer som använder kreditupplysningarna, kreditupplysningsföretag samt myndigheter som använder registrets uppgifter. Objektet för testningen är de tekniska gränssnitten. Det kan ännu göras ändringar i anvisningens innehåll.

Syftet med intressentgruppstestningen är att intressentgrupperna testar hur gränssnitten för det positiva kreditupplysningsregistret fungerar. Testmiljön kan användas i intressentgruppernas eget utvecklingsarbete och testning. Alla parter kan smidigt ta i bruk registret när funktionerna har prövats och testats före ibruktagandet. Tack vare testningen fungerar också registret smidigare och mer felfritt i produktionen.

Genom att testa kan intressentgrupperna försäkra sig om att de tekniskt klarar av att anmäla uppgifterna och göra förfrågningar om dem. I samband med testningen av gränssnitten kan intressentgrupperna också försäkra sig om att deras egna system och processer fungerar på önskat sätt. Intressentgrupperna ansvarar själva för uppbyggnaden av sina egna gränssnitt och för att de är lagenliga.

2 Gränssnitt och tjänster som testas

Objektet för intressentgruppstestningen är de tekniska gränssnitt som används för att anmäla uppgifter och göra förfrågningar om uppgifter.

Anmälan av uppgifter:

• Gränssnitt för anmälan om kredituppgifter (REST)
  • Ny kredit
  • Ändring av kreditens uppgifter
  • Betalningsdröjsmål
  • Betalningstransaktion
  • Avslutande av kredit
• Förfrågan om materialets status (REST)
• Kontroll av uppgifterna för en anmäld kredit (REST)

Förfrågan av uppgifter, kreditgivare:

• Kreditgivares gränssnitt för förfrågan om utdrag ur kreditupplysningsregistret (REST)
  • Förfrågan om utdrag ur kreditupplysningsregistret

Förfrågan av uppgifter, myndigheter:

• Beställningstjänst för material (REST)
  • ny beställning, förteckning över beställningar eller avslutande av beställning
• Distribution av material (SFTP)
  • Helhetsbild av kreditstocken
    • Alla krediter
    • Nya och avslutade krediter
  • Anmälningsflöde för krediter
    • Anmälningar av krediter
  • Inriktade urval
    • Kredittagarens krediter
    • Kreditgivarens krediter
    • Inriktade anmälningar av krediter
  • Förfrågningar om utdrag ur kreditupplysningsregistret
    • Kreditgivarens förfrågningar om utdrag ur kreditupplysningsregistret
    • Förfrågningar om utdrag ur kreditupplysningsregistret som gäller kredittagaren
    • Alla förfrågningar om utdrag ur kreditupplysningsregistret
  • Dataflöde för anmälningar om inkomstuppgifter
    • Anmälningar om inkomstuppgifter
  • Dataflöde för anmälningar om kreditförbud
    • Anmälningar om kreditförbud

Förfrågan av uppgifter, kreditupplysningsföretag:

• Beställningstjänst för material (REST)
  • ny beställning, förteckning över beställningar eller avslutande av beställning
• Distribution av material (SFTP)
  • Dataflöde för anmälningar om kreditförbud
    • Anmälningar om kreditförbud

2.1 Avgränsningar

I den här intressentgruppstestningen ingår inte

• testning av e-tjänsterna för privatpersoner och organisationer i det positiva kreditupplysningsregistret
• testning av anmälan av kreditgivarnas befintliga kreditstock.

3 Tidsplan

Anmälan om deltagande

Anmälan om deltagande i testningen sker 1.3–30.4.2023 och 1–31.8.2023.

Om intressentgruppen som testar är en anmälare av uppgifter eller både en anmälare och användare av uppgifter är anmälningstiden 1.3–30.4.2023.

Om intressentgruppen som testar endast är en användare av uppgifter, såsom till exempel myndigheter och kreditupplysningsföretag, är anmälningstiden 1–31.8.2023.

Testning

Intressentgruppstestningen delas upp i två faser och intressentgrupperna deltar antingen i båda eller endast den ena, beroende på deras roller:

• testning av anmälan av uppgifter 2.5–31.10.2023
• testning av förfrågan av uppgifter 1.9.2023–31.1.2024

Denna tidsplan har gjorts upp för att det ska gå att försäkra sig om att observationerna har beaktats och eventuella korrigeringar hinner genomföras före produktionsfasen börjar. Efter tidsintervallen i fråga är testmiljön fortfarande tillgänglig och de senaste versionerna kan testas där.

Innan testningen inleds och medan testningen pågår ordnas det evenemang för intressentgrupper och mottagningar för testningen där intressentgrupperna kan diskutera tillsammans med projektet och övriga intressentgrupper om frågor som kommit upp under testningen.

Bild 1. Tidsplan.

3.1 Myndigheternas tidigarelagda testning

Som ett undantag från denna tidsplan kan de myndigheter som använder uppgifter testa gränssnitten redan från och med den 2 maj 2023. I den tidigarelagda testningen går det i praktiken att anropa gränssnitten i testmiljön. I detta skede finns det dock ingen testdatabas i testmiljön för testning av den egentliga förfrågan av uppgifter. Förfrågan av uppgifter kan i enlighet med den ursprungliga tidsplanen testas från och med den 1 september 2023.

Om intressentgruppen som testar är en myndighet som använder uppgifter som vill delta i tidigarelagd begränsad testning innan den egentliga testningen av förfrågan av uppgifter börjar kan myndigheten anmäla sig 1.3–30.4.2023.

• Det är möjligt att anropa gränssnitten från och med den 2 maj 2023.
• Den egentliga testningen av förfrågan av uppgifter ordnas 1.9.2023–31.1.2024.

4 Enter-portalen

Enter-portalen är kanalen för att hålla kontakt. Den är primär kontaktkanal mellan intressentgruppen och projektet för inrättandet av det positiva kreditupplysningsregistret i frågor som gäller testningen.

En person i intressentgruppen som testar registrerar sig som administratör för sin organisation i portalen. Efter registreringen kan administratören lägga till personer som deltar i testningen som användare. Som användare av portalen lönar det sig att lägga till alla sådana personer som deltar i testningen och har kontakt med projektet till exempel vid felsökning.

Via portalen kan man bland annat skicka frågor som anknyter till testningen, testobservationer eller felmisstankar till projektet. Svaren på kontakterna kommer till portalen och den som har ställt frågan får också en notifikation per e-post om denna. Administratören kan följa med situationen för den egna organisationens tickets och via dessa tickets går det också lätt att till exempel få en helhetsbild av de testningsobservationer som den egna organisationen har skickat. Basanvändare ser endast sina egna tickets.

I portalen finns det också annan information som anknyter till testningen, bland annat länkar till anvisningarna för testningen. I portalen kan man också informera om till exempel aktuella frågor som anknyter till testmiljön, såsom olika observationer och korrigeringar av fel.

Enter-portalen tas i bruk den 1 mars 2023 för de intressentgrupper som deltar i testningen. Bekanta dig med bruksanvisningen för Enter-portalen.

5 Hur framskrider testningen?

Testningen inleds med anmälan till testning. Intressentgrupperna testar tekniska gränssnitt och rapporterar om eventuella fel och övriga observationer till projektet under testningsfasen, som sker enligt tidsplanen.

Testandets olika faser gås mer noggrant igenom senare i denna anvisning.

Bild 2. Testningens faser.

6 Anmälan till testning

Man måste anmäla sig till testningen med en anmälningsblankett (anmälan om inledning av testning) som finns i Enter-portalen. Administratören lämnar in anmälan om inledning av testning. I samband med anmälan godkänner intressentgruppen användningsvillkoren för testningen. Före anmälan måste organisationens administratör till portalen minst lägga till de personer som verkar som kontaktpersoner för testningen och tekniska kontaktpersoner.

I samband med anmälan till testning

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

Projektet behandlar anmälan om inledning av testning inom två veckor. Efter det får administratören som har fyllt i anmälan om inledning av testning konstgjorda personbeteckningar och ett konstgjort FO-nummer för testningen. Informationen som anknyter till testcertifikatet skickas till den tekniska kontaktpersonen för testningen. Om intressentgruppen anmäler sig både till testningen av anmälan av uppgifter och testningen av förfrågan av uppgifter skickar projektet först informationen som gäller testningen av anmälan av uppgifter och före den 1 september 2023 motsvarande uppgifter för testningen av utdraget ur kreditupplysningsregistret eller förfrågan av uppgifter.

Om uppgifterna som meddelats i samband med anmälan till testning ändras medan testningen pågår (om till exempel kontaktpersonen för testningen eller den tekniska kontaktpersonen byts ut) ska intressentgruppen meddela om detta så snabbt som möjligt i Enter-portalen. Närmare anvisningar finns i bruksanvisningen för Enter-portalen.

Anmälan till testning om man anmäler och använder uppgifter

• Anmälan 1.3–30.4.2023
  • Testning av anmälan av uppgifter 2.5–31.10.2023
  • Testning av förfrågan om utdrag ur kreditupplysningsregistret 1.9.2023–31.1.2024

Anmälan till testning om man endast anmäler uppgifter

• Anmälan 1.3–30.4.2023
  • Testning 2.5–31.10.2023

Anmälan till testning om man endast använder uppgifter

• Anmälan 1–31.8.2023
  • Testning 1.9.2023–31.1.2024

7 Testcertifikat

Varje intressentgrupp behöver ett eget testcertifikat för testningen av gränssnittet. Certifikaten är separata för anmälare och användare av uppgifter. Om intressentgruppen testar både anmälan och förfrågan av uppgifter behöver den alltså två olika typer av certifikat.

Utifrån anmälan till testning ges intressentgruppen ett konstgjort FO-nummer för testningen samt ett testcertifikat. Det behövs koder för hämtning av testcertifikatet och dessa skickas med säker e-post till intressentgruppens tekniska kontaktperson efter anmälan. Den tekniska kontaktpersonen får ett meddelande per säker e-post med koderna för att hämta certifikatet. Detta meddelande skickas inom två veckor från att anmälan om inledning av testning har gjorts. Den tekniska kontaktpersonen får som ett sms-meddelande den PIN-kod som behövs för att öppna den säkra e-posten. Certifikatet måste hämtas inom 14 dygn efter att meddelandet har erhållits. Certifikatet måste alltså hämtas redan innan den egentliga testningen inleds.

Om certifikatet dock inte hinner hämtas inom 14 dygn kan intressentgruppen beställa ett nytt genom att skicka kontaktblanketten för testningen i Enter-portalen och på den begära ett nytt certifikat.

Certifikatet för intressentgruppstestningen används endast i testmiljön för intressentgrupper under intressentgruppstestningen. Under produktionsbruket används separata certifikat.

Bekanta dig med anvisningarna för testcertifikatet

7.1 Övriga situationer

Beställning av tilläggscertifikat

Om intressentgruppen behöver tilläggscertifikat för testningen går det att beställa sådana genom att skicka kontaktblanketten för testningen i Enter-portalen.

Begäran om spärrning av certifikat

Om intressentgruppen vill att testcertifikatet ska spärras kan man göra en begäran om spärrning genom att skicka kontaktblanketten för testningen i Enter-portalen. Certifikatets serienummer ska anges på blanketten.

Certifikatets giltighetstid

Testcertifikatet gäller i två år.

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

Intressentgruppen kan befullmäktiga en annan part att testa för sin räkning. Man kan göra så till exempel när intressentgruppen har gett en annan part i uppgift att sköta om den tekniska anmälan eller förfrågan av uppgifter. I dessa fall kan den anmälningsskyldiga eller intressentgruppen som använder uppgifter anmäla sig till testningen själv eller så kan parten som utför testningen anmäla sig för intressentgruppens räkning.

Organisationen som anmäler sig måste före anmälan till testningen försäkra sig om vilken person som verkar som teknisk kontaktperson och hämtar certifikatet i den organisation som utför testningen. I samband med anmälan till testning meddelas informationen om den tekniska kontaktpersonen för parten som utför testningen. Den tekniska kontaktpersonen tar emot informationen som anknyter till certifikatet och hämtar certifikatet.

Det är möjligt att använda Enter-portalen också i situationer då en part testar för en annans räkning i situationer då intressentgruppen har gett en annan part i uppgift att utföra testningen. Personerna som utför testningen kan läggas till i portalen för att hålla kontakt. Även dessa personer kan behandla observationsblanketter i portalen.

9 Suomi.fi-informationsleden

Anvisningarna som anknyter till Suomi.fi-informationsleden ges ut senare.

10 Testning

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

• gränssnitten som erbjuds till intressentgrupperna fungerar
• intressentgruppernas datasystem producerar rätt slags uppgifter som uppfyller specifikationerna och att intressentgrupperna kan anmäla dessa uppgifter till det positiva kreditupplysningsregistret samt kontrollera att uppgifterna är korrekta i registret
• intressentgrupperna får rätt slags behandlingsrespons för sina anmälningar
• det går att beställa och skapa ett utdrag ur kreditupplysningsregistret
• uppgifterna visas rätt i utdraget ur kreditupplysningsregistret
• materialförfrågningarna som myndigheter och kreditupplysningsföretag gör lyckas.

Intressentgruppen testar alla de gränssnitt som det använder även under produktionsbruket. Det lönar sig att vid testningen börja med enkla grundfall och därefter framskrida mot mer komplicerade testfall, så att alla skeden och situationer för olika processer testas.

Intressentgrupperna ska göra upp relevanta testfall för sig själva för olika situationer som gäller anmälan och förfrågan om utdrag ur kreditupplysningsregistret samt även beakta ändrings- och felsituationer samt sina egna processer.

10.1 Testmiljö

Intressentgrupperna kan testa det positiva kreditupplysningsregistret i testmiljön för intressentgrupper. Testmiljön för intressentgrupper kan användas dygnet runt, med undantag för planerade driftsavbrott och eventuella felsituationer, som det reageras på vardagar under tjänstetid.

Testmiljön för intressentgrupper öppnas den 2 maj 2023 för testning av anmälan av kreditens uppgifter och den 1 september 2023 för testning av förfrågan av uppgifter. Medan testningen pågår publiceras det nya versioner och korrigeringspublikationer i testmiljön för intressentgrupper. I samband med att en ny version publiceras ges intressentgrupperna för kännedom en leveransbeskrivning av nya funktioner, korrigeringar och kända brister.

Testmiljön för intressentgrupper är gemensam för alla intressentgrupper som testar och sålunda går det också att där utföra gemensam testning mellan olika intressentgrupper.

10.2 Avvikande behandlingsregler i testmiljön för intressentgrupper

I testmiljön för intressentgrupper finns vissa inställningar (konfigurationer) och behandlingsregler som avviker från dem som används i produktionen. Det går endast att testa med sådana konstgjorda kundbeteckningar som har sparats i registrets testmiljö för intressentgrupper. Det går inte att testa med andra kundbeteckningar, eftersom det inte finns uppgifter som gäller sådana beteckningar i registret.

Behandlingsreglerna för datum i testmiljön för intressentgrupper avviker inte från reglerna i produktionsmiljön för registret.

10.3 Testningsdata

Vid testningen används konstgjorda testkunder som administratören för intressentgruppen får efter anmälan till testningen. Kundtestdata innehåller personbeteckningar. Dessutom ges det konstgjorda FO-nummer som vid testningen av överföring av kredit kan användas som förvärvare.

För testningen av förfrågan om utdrag ur kreditupplysningsregistret skapar projektet mångsidiga uppgifter om inkomster och förmåner samt bland annat uppgifter om krediter, kreditförbud och anteckningar om situationer då någon bestrider uppgifter.

En del av testkundbeteckningarna ges till intressentgruppen för eget bruk och en del av dem är i gemensamt bruk. Efter att intressentgruppen har anmält sig till testningen får den en förteckning över dessa testkundbeteckningar och deras egenskaper.

Alla data som har levereras till testmiljön kan användas av övriga testare som verkar i kundmiljö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 be om de testdata som kreditgivare har anmält.

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 den separata anvisningen om anonymisering. Intressentgrupperna ansvarar för att de testdata som de levererar är konstgjorda eller anonymiserade. Anvisningen om anonymisering publiceras senare.

10.4 Intressentgruppens egna kundtestdata

Intressentgruppen kan lägga till rimliga mängder egna kundtestdata i testmiljön för intressentgrupper. Då ansvarar intressentgruppen själv för att dessa data absolut inte innehåller produktionsdata. Projektet kontrollerar eller anonymiserar inte data som intressentgrupper levererar. Om intressentgruppen vill leverera egna kundtestdata ska intressentgruppen använda kontaktblanketten i Enter-portalen för att ta kontakt.

Om testdata har bildats utifrån produktionsdata ska uppgifterna anonymiseras så att kunduppgifter inte kan kopplas eller återföras till verkliga kunduppgifter. Alla personuppgifter ska avidentifieras på ett sådant sätt att kunden inte längre kan identifieras. Anvisningen om anonymisering publiceras senare.

Läs mer om den lagstiftning som testdata ska följa:

• Artikel 25 i EU:s allmänna dataskyddsförordning (gdprinfo.eu)
• Artikel 32 i EU:s allmänna dataskyddsförordning (gdprinfo.eu)

11 Observationer under testningen och rapporteringen av dem

Intressentgrupperna rapporterar om observationer via Enter-portalen.

Om testaren misstänker att det finns ett fel går det att kontrollera i Enter-portalen om felet i fråga redan är känt. Observationsblanketten kan fyllas i om felet inte redan har rapporterats. På blanketten ska man så noggrant som möjligt rapportera i vilken situation felet har observerats. Eventuella skärmbilder och andra bilagor kan bifogas. Observationsblanketten har fält för olika uppgifter och sålunda hjälper blanketten att lämna den information som behövs.

Felen klassificeras enligt tabellen nedan (Tabell 1). När testaren registrerar observationen ger denne också en lämplig felklass för observationen. Vid behov kan felklassificeringen ändras. Den slutgiltiga klassificeringen fastställs av dem som handlägger felmeddelanden.

Felklass	Beskrivning
1 Kritiskt	Ett fel som förhindrar fortsatt testning. Det finns inget godtagbart sätt på vilket problemet kan kringgås.
2 Allvarligt	Ett fel som förhindrar att minst en systemkomponent fungerar. Det finns dock ett godtagbart sätt på vilket problemet kan kringgås.
3 Medelstort	Ett fel som leder till att systemet ger ett felaktigt, bristfälligt eller ologiskt resultat.
4 Litet	Ett litet eller kosmetiskt fel som kan kringgås på ett godtagbart sätt.

Tabell 1. Beskrivning av felklasserna.

12 Kommunikation och stöd medan testningen pågår

Information som anknyter till intressentgruppstestningen finns på registrets webbplats och i Enter-portalen. Medan testningen pågår ordnas det också evenemang för intressentgrupperna om testningen.

Projektet för inrättandet av det positiva kreditupplysningsregistret informerar intressentgrupperna medan testningen pågår om bland annat följande:

• gränssnittsbeskrivningarna och uppdateringar av dem
• störningar i testmiljön
• nya versioner av testmiljön
• extraordinära korrigeringar i testmiljön utanför versionerna
• eventuella driftsavbrott i testmiljön
• leveransbeskrivningar
• kommande evenemang för intressentgrupper
• övrigt som behöver meddelas och nyheter om aktuella frågor.

Enter-portalen är primär kontaktkanal mellan intressentgruppen och projektet medan testningen pågår. Intressentgruppen skickar frågor och observationer som anknyter till testningen till projektet i Enter-portalen och får projektets svar i portalen.

I samband med anmälan till testning måste intressentgruppen ge kontaktuppgifterna för kontaktpersonen för testningen. Projektet kan informera kontaktpersonen till exempel om situationer som anknyter till testningen per e-post.

13 Centrala termer

Anonymisering
Permanent radering eller ändring av identifikationsuppgifter så man inte kan känna igen aktörerna.

Enter-portalen
Primär kontaktkanal mellan den testande organisationen och projektet i ärenden som gäller testningen. Anvisningar, meddelanden och aktuell information om intressentgruppstestningen publiceras i Enter-portalen. Intressentgrupperna kan också skicka frågor och testobservationer via portalen.

Projektet
Projektet Inrättandet av det positiva kreditupplysningsregistret ansvarar för utvecklingen av registret. Projektet stöder intressentgrupperna vid testningen.

Gränssnitt
Anslutning som följer vissa specifikationer, som används för informationsutbyte mellan utomstående aktörer och registret. I det positiva kreditupplysningsregistret finns det gränssnittstjänster för anmälan av uppgifter, för förfrågan om utdrag ur kreditupplysningsregistret samt för beställning och mottagning av material. När specifikationerna för gränssnittet görs kommer man överens om dataöverföringssättet (protokollet) samt innehållet och formatet för de uppgifter som överförs.

Intressentgrupper
Som intressentgrupper räknas i det positiva kreditupplysningsregistret alla dess användare, till exempel anmälningsskyldiga, användare av utdrag ur kreditupplysningsregistret, kreditupplysningsföretag, myndigheter och privatpersoner.

Teknisk kontaktperson
Person som organisationen som testar har angett på anmälan om inledning av testning och till vilken informationen om hämtningen av certifikatet levereras.

Anmälan om inledning av testning
Anmälan om inledning av testning görs elektroniskt i Enter-portalen. Intressentgruppen uppger i anmälan om inledning av testning till det positiva kreditupplysningsregistret de uppgifter som behövs för att testningen kan inledas och de tjänster som testas samt godkänner användarvillkoren för testmiljön.

Kontaktperson för testningen
Den primära kontaktpersonen hos organisationen som genomför testningen i ärenden som gäller testningen av det positiva kreditupplysningsregistret. Organisationen kan ha endast en kontaktperson för testningen, men det kan finnas flera testare. Projektet kontaktar vid behov kontaktpersonen för testningen om ärenden som gäller testning.

Testmiljö
Testmiljö för intressentgrupper, vilken är avsedd för testning av det positiva kreditupplysningsregistret.

Testkund
Konstgjorda företag eller kunder med konstgjorda kundbeteckningar i testmiljön för intressentgrupper.

Testdata
Data som testaren använder i testmiljön och som innehåller uppgifter om konstgjorda testkunder.

Användare av uppgifter
Aktörer som använder upplysningarna i det positiva kreditupplysningsregistret och som har lagstadgad rätt att få uppgifter för att sköta sin egen uppgift. Användarna av uppgifter är till exempel kreditgivare, kreditupplysningsföretag samt myndigheter som använder registrets uppgifter och övervakar dess verksamhet.

Anmälare av uppgifter
Aktörer som har en lagstadgad skyldighet att anmäla uppgifter till det positiva kreditupplysningsregistret. Anmälare av uppgifter är till exempel finans-, betalnings- och kreditinstitut samt FPA.

Certifikat
En elektronisk kod som används för att identifiera användaren och som beviljas av Inkomstregisterenheten.

Testcertifikatet är avsett för testmiljön för intressentgrupper. Behörigheten och certifikatet för gränssnittet för produktionsanvändningen av det positiva kreditupplysningsregistret, som inleds 2024, hämtas separat före ibruktagandet.

Fler termer finns i ordlistan för det positiva kreditupplysningsregistret (suomi.fi).