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.
Använd gränssnittsadresser och certifikat omsorgsfullt och på rätt sätt. Använd produktionsadresser och certifikat endast för att anmäla produktionsuppgifter. Om du vill testa gränssnitten ska du använda gränssnittsadresser och testcertifikat för intressentgruppernas testning. Ange aldrig riktiga produktionsuppgifter i gränssnitten för intressentgruppernas testning.
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.
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.
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.
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.
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.
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.
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.
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.
Adresser för testmiljöns gränssnitt
Adresser för testmiljöns gränssnitter hittar du på sidan anvisningar för testning för intressentgrupper.