Till programutvecklare

På den här sidan hittar du samlade uppgifter och anvisningar om gränssnitten i registret och intressentgruppstestningen:

• Sidan Dokumentation: olika tekniska anvisningar, såsom gränssnittsbeskrivningar
• Sidan Intressentgruppstestning: anvisningar för intressentgruppstestningen
• Sidan Certifikat: information om de certifikat som behövs för att använda gränssnitten.

Läs förutom de tekniska anvisningarna även de viktiga anvisningarna för anmälan och förfrågan av uppgifter:

• Anvisningen Anmälan av uppgifter till det positiva kreditupplysningsregistret: vad anmälningsskyldigheten betyder, vilka krediter som ska anmälas till registret, vilka informationsinnehåll som anmäls för krediterna, vilka tidsfrister som gäller och hur anmälan görs.
• Sidan Utlämnande av uppgifter ur det positiva kreditupplysningsregistret: vilka uppgifter som kan förfrågas ur registret, det vill säga vilka uppgifter som utlämnas från registret, till vem de utlämnas och för vilka användningsändamål.

De tekniska gränssnitten och hur de används

Registrets användare, det vill säga de som anmäler och använder uppgifter, använder gränssnitt. Med ett tekniskt gränssnitt avses en anslutning som motsvarar vissa specifikationer och som används för informationsutbyte mellan en utomstående aktör och registret. Registret använder REST-gränssnitt med JSON-informationsinnehåll.

För att gränssnittet ska kunna användas behöver användaren ett certifikat som beviljas av Skatteförvaltningen. Certifikatet används för att identifiera organisationen som använder gränssnittet och garantera materialets oföränderlighet. Mer information om certifikatet och hur det hämtas finns på sidan Certifikat. Under produktionsfasen används andra certifikat än i testmiljön.

Gränssnitten för anmälan och deras adresser

Kreditgivarna har tillgång till gränssnitten nedan för anmälan av uppgifter. För att använda dem behöver kreditgivaren ett certifikat för anmälan av uppgifter.

Ny kredit: https://api.positiivinenluottotietorekisteri.fi/AddLoans

• Anmäl en befintlig kreditstock i gränssnittet. Anmäl också uppgifter för nya krediter i det här gränssnittet.
• Anmälan om kredituppgifter – gränssnittsbeskrivning på sidan dokumentation.
• Anmälan av uppgifter till det positiva kreditupplysningsregistret -anvisning.

Ändring av kreditens uppgifter: https://api.positiivinenluottotietorekisteri.fi/UpdateLoans

• Anmäl vissa ändringar som sker i uppgifterna om krediterna i gränssnittet. Observera att följande ändringar inte anmäls i detta gränssnitt: betalningstransaktioner, betalningsdröjsmål, uppgift om uppsägning av kredit samt avslutande eller överföring av kredit. De anmäls i andra gränssnitt.
• Anmälan om kredituppgifter – gränssnittsbeskrivning på sidan dokumentation.
• Anmälan av uppgifter till det positiva kreditupplysningsregistret -anvisning.

Betalningstransaktion: https://api.positiivinenluottotietorekisteri.fi/Repayments

• Anmäl betalningstransaktionerna för krediterna i gränssnittet.
• Anmälan om kredituppgifter – gränssnittsbeskrivning på sidan dokumentation.
• Anmälan av uppgifter till det positiva kreditupplysningsregistret -anvisning.

Betalningsdröjsmål: https://api.positiivinenluottotietorekisteri.fi/DelayedRepayments

• Anmäl i gränssnittet betalningsposter som har fördröjts i över 60 dagar från förfallodagen samt uppgiften om att krediten har sagts upp.
• Anmälan om kredituppgifter – gränssnittsbeskrivning på sidan dokumentation.
• Anmälan av uppgifter till det positiva kreditupplysningsregistret -anvisning.

Avslutande av kredit: https://api.positiivinenluottotietorekisteri.fi/TerminateLoans

• Anmäl i gränssnittet när krediten avslutas eller överförs till en annan kreditgivare.
  Anmälan om kredituppgifter – gränssnittsbeskrivning på sidan dokumentation.
• Anmälan av uppgifter till det positiva kreditupplysningsregistret -anvisning.

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

• Fråga alltid om materialets status med materialreferensen efter att materialet har skickats. I svarsmeddelandet returneras eventuella fel i materialet.
  Anmälan om kredituppgifter – gränssnittsbeskrivning på sidan dokumentation.
• Anmälan av uppgifter till det positiva kreditupplysningsregistret -anvisning.

Kontroll av kreditens uppgifter: https://api.positiivinenluottotietorekisteri.fi/GetLoan

• Du kan kontrollera uppgifterna om en enskild kredit i gränssnittet med kreditens nummer.
  Kontroll av kreditens uppgifter – gränssnittsbeskrivning på sidan dokumentation.
• Anmälan av uppgifter till det positiva kreditupplysningsregistret -anvisning.

Gränssnittet för förfrågan av uppgifter

Kreditgivarna har tillgång till gränssnittet nedan för förfrågan av uppgifter. För att använda gränssnittet behöver kreditgivaren certifikatet för användning av uppgifter.

Förfrågan om utdrag ur kreditupplysningsregistret: https://api.positiivinenluottotietorekisteri.fi/GetCreditRegisterExtract

• Gör en förfrågan om utdraget ur kreditupplysningsregistret med personbeteckningen i gränssnittet.
  Förfrågan om utdrag ur kreditupplysningsregistret – gränssnittsbeskrivning på sidan dokumentation.
• Utlämnande av uppgifter ur det positiva kreditupplysningsregistret -anvisning.