REST X-tee teenused

Pidevalt täienevad arendus- ja testkeskkonna teenuste kirjeldused on leitavad X-tee teenuste kataloogist.

Isiku andmete teenus

Teenus, mis tulevikus asendab kõiki seniseid rahvastikuregistri X-tee teenuseid, mille sisendiks on isikukood või isikukoodid.
Teenus on seadistatav tagastama andmeid nii pärijale vajalike andmeväljade lõikes kui ka näiteks lubatud dokumentide, aadresside, suhte liikide jms suhtes.

Isikute muudatuse teenus

Teenus, mis tulevikus asendab kõiki seniseid rahvastikuregistri X-tee teenused, mis tagastavad pärijale isikutega teatud perioodil toimunud muudatusi.

Teenus on seadistatav tagastama andmeid pärijale vajalike muudatuste lõikes. Uuendusena on (vajaduse ja õiguse põhiselt) võimalik saada ka loend muudatustest, mis isikuga on toimunud.

Pidevalt täienevad arendus- ja testkeskkonna teenuste kirjeldused on leitavad X-tee teenuste kataloogist.

Isiku otsingu teenus

Teenus, mis tulevikus asendab kõiki seniseid rahvastikuregistri X-tee teenuseid, mis peavad tagastama mingite kriteeriumite alusel isikute loendi. Näiteks:

• perioodil sündinud või surnud isikud;
• mingil aadressil elavad isikud.

Teenuse valmimise aeg sõltub uue rahvastikuregistri menetlustarkvara valmimisest.

Kandeteenused

Teenused, millega kantakse rahvastikuregistrisse andmeid nagu näiteks:

• viibimiskoha teenus;
• lisa-aadresside ja kontaktide teenus;
• lahutuste kandmise teenus;
• sünni korral isikukoodide tellimine;
• surma kandmise teenus;
• jne.

Olulisemad kuupäevad rahvastikuregistri REST X-tee teenustele üleminekul:

NB! Teenuste toodangukeskkonnas kasutuselevõtuks tuleb lähtuda seniste ja uute teenuste omavahelisest vastavusest ning esitada juurdepääsutaotlus Siseministeeriumi juurdepääsude menetlemise infosüsteemis aadressil https://rr-taotlus.smit.ee.

• 31.03.2025 – Teenused on testitavad DEV ja TEST keskkonnas. NB! Teenuste testimise soovist tuleb teada anda aadressile ....
• 31.08.2025 – Isiku andmete ja Isikute muudatuste teenused on toodangus ja kasutusele võetavad.
• 02.09.2026 – Isikute otsingu teenus on toodangus ja kasutusele võetav.
• 01.12.2026 - 31.08.2027 – Kandeteenused on toodangus ja kasutusele võetavad (täpsem teave valmivate teenuste kaupa lisandub jooksvalt).
• 01.01.2027 – Dokumentide otsingu teenus on toodangus ja kasutusele võetav. (Täna juba DEV ja TEST keskkondades leitav).

Dubleerivate, sama funktsionaalsust võimaldavate, teenuste töös hoidmine on väga kulukas, mistõttu sulgeme tänased teenused ajakava alusel:

• 31.12.2026 – Teenused, mida asendavad isiku andmete ja isikute muudatuste teenus.
• 31.12.2027 – Teenused, mida asendavad isikute ja dokumentide otsinguteenused.
• 31.12.2027 – Teenused, mida asendavad kandeteenused.

Uute teenuste kasutamiseks on vaja taotleda nendele uuesti juurdepääsu. Palume seda teha aegsasti, kuna juurdepääsu andmisel vaatame üle ka senised juurdepääsud, mis võtab oma aja ning samuti on üheaegselt paljude uute juurdepääsude andmisel menetluste ajad senisest pikemad.

Juurdepääsu saamiseks tuleb esitada taotlus rahvastikuregistri andmetele juurdepääsu menetlemise infosüsteemis, aadressil https://rr-taotlus.smit.ee/. Olenevalt sellest, kas tegemist on avaliku ülesande täitja või erasektori asutusega, tuleb valida õige taotlusvorm: Asutus (avalik ülesanne) või Äriühing (õigustatud huvi) –> Juurdepääs rahvastikuregistri teenustele. Taotluse võib esitada asutuse esindusõiguslik isik või tema poolt volitatud isik.

Enne taotluse esitamist on oluline välja selgitada, milline on andmete kasutamise eesmärk, mis on andmete töötlemise õiguslik alus ning milline on eesmärgi täitmiseks vajalik täpne andmete koosseis. Kuna uute teenuste kasutuselevõtu üks eesmärke on vältida liiasusega andmete töötlemist, siis ei piisa ainult olemasoleva(te) teenus(t)e senise andmekoosseisu ümber tõstmisest. Senise andmete kasutamise eesmärgi ja kasutusel olnud andmekoosseisu üle vaatamine annab ka teile kindluse, et andmetöötlus vastab isikuandmete töötlemisele kohalduvatele nõuetele.

Taotlemise lihtsustamiseks oleme koostanud vormid (Micresoft Forms), milles saab valida just enda eesmärgist ja õiguslikust alusest lähtuva andmekoosseisu. Palume hoolikalt läbi mõelda, mis on minimaalselt vajalikud andmed eesmärgi saavutamiseks ja vastavad andmete töötlemise õiguslikule alusele. Need vormid ei sobi kasutamiseks taotluste puhul, mis on mõeldud asutusesiseseks kasutamiseks.

• Isikuteenuse (domesticDataExchange/isikud) andmete taotlemise vorm asub lingil: https://forms.office.com/e/nj9iiuQbQV
• Muudatuse teenuse (domesticDataExchange/isikud/muudatused) andmete taotlemise vorm asub lingil: https://forms.office.com/e/F62fiiW83f

Viited nendele vormidele asuvad ka rahvastikuregistri andmetele juurdepääsu menetlemise infosüsteemis vastavate taotlusvormide juures.

Vaikimisi antakse juurdepääs aktuaalsetele andmetele. Juhul kui on vajalikud erisused (nt andmed lõppenud suhete kohta, endised elukohad, kehtetute dokumentide andmed jms), siis tuleb nende andmete saamise vajadus eraldi kirja panna.

Palume andmeväljade kohta lisada ka selle kasutamise eesmärgi ja õigusliku aluse selgituse, et lihtsustada ja kiirendada andmetele juurdepääsu otsuse tegemist. Ei piisa ainult sellest, kui on märgitud mingi seaduse nimi, vaid vaja on märkida ka täpsemad sätted, mis tõendavad küsitud andmete töötlemise põhjendatust.

Küsimustele vastab ....

Kust näeb suletavate teenuste nimekirja ja uute teenustega asendamise vastavustabelit?

Tabel asub ülaltoodud kirjelduse teises lõigus.

Kas teenuseid saab kasutada MISPi kaudu?

REST teenuseid ei saa MISP kaudu kasutada. RIA teavituse kohaselt MISP2 suletakse 31.12.2025.

Milline hakkab olema uute teenuste maksumus?

Uute teenuste maksustamise mudel on välja töötamisel, aga tõenäoliselt Isiku info päringu puhul maksustatakse jätkuvalt küsitud/tagastatud isikute arvu. Kehtiv tasude määrus on kättesaadav SIIT: https://www.riigiteataja.ee/akt/112012021002

Avaliku ülesande täitmiseks väljastatakse andmed endiselt tasuta. Päringute eest peavad tasuma need kasutajad, kellel on juurdepääs õigustatud huvi alusel.

Kas nimetatud muudatused toovad asutustele kaasa ka muudatusi senistes juurdepääsudes ja nende dokumenteerimises?

Uutele X-tee teenustele üleminek annab võimaluse korrastada olemasolevad juurdepääsud, vaadata üle senised andmete kasutamise eesmärgid ning õiguslikud alused. Eesmärk on tagada igale kasutajale just talle vajalik andmekoosseis, mis vastab tema andmete kasutamise eesmärgile ja õiguslikule alusele ning ei toimuks liiasusega andmete töötlemist. Nii saame ühiselt tagada, et isikuandmete töötlemine toimub igati vastavuses isikuandmete töötlemisele kohalduvate nõuetega.

Kuivõrd seni on antud juurdepääs üldjuhul asutusele, kuid uued teenused avatakse alamsüsteemile, toob see kaasa ka seniste juurdepääsude ümbervormistamise. Uutele X-tee teenustele juurdepääsu saamiseks tuleb esitada taotlus rahvastikuregistri andmetele juurdepääsu menetlemise infosüsteemis (https://rr-taotlus.smit.ee/). Taotluse peavad esitama nii uued kasutajad kui ka need, kellel juba on varasemast juurdepääs antud.

Anname jooksvalt teada, kui on võimalik uutele teenustele juurdepääsu taotleda ning kuidas seda peaks tegema. Teeme endast kõik oleneva, et saaksime selleks anda teile võimalikult palju eelnevat teavet teenuste asendamise kohta ning vältida liigset asjaajamist.

Kas teenuste testimiseks on tarvis esitada taotlus läbi Juurdepääsu menetlemise infosüsteemi?

Ei, piisab kirjast aadressile ...

Kas uued teenused on seotud ka Andmejälgijaga?

Jah, nii nagu muud rahvastikuregistrisse tehtud päringud, kuvatakse ka need andmejälgija teenuses.

Kas teenuste kasutajatel on võimalik taotleda keskset raha teenuste arendamiseks?

Oleme uurinud keskse rahastuse võimalust MKM-st. Nende vastus on, et kahjuks selline võimalus täna puudub.

Kas teenuste tehniline kirjeldus on ka inglise keeles?

Ei ole. Tehniline kirjeldus on hõlpsasti tõlgitav mõne tõlkeprogrammi abil.

Kuidas kasutaja saab aru, kas andmeväli on talle keelatud või päritaval isikul see andmeühik puudub?

Isikute info teenusele lisatakse päisesse (masinloetav) infoväli, kuhu loetletakse väljad, mis on pärijale keelatud.

Kas Isikute info teenusega saab korraga pärida korraga ühe või mitme isiku kohta?

Hetkeseisuga ei ole veel kindlat otsust, aga kaldub selle poole, et saab pärida ühe isiku infot korraga.

Kas teenustele tekib lisaks OpenAPI dokumentatsioonile ka täiendav spetsifikatsioon?

Tänase seisuga ei teki. Täiendame ja parandame pidevalt OpenAPI dokumentatsiooni, sealhulgas lisame võimalikud väljade väärtused, kus see mõistlik on. OpenAPI dokumentatsiooni viimane versioon on alati saadaval X-tee kataloogist.

Kust saada infot võimalike RR-s kasutatavate andmekomplektide liikide ning staatuste kohta, kui on tarvis Isiku info päringut kuidagi filtreerida?

RR-s kasutatavad andmekomplektide liigid ning nende staatused on kirjeldatud kodifikaatoritena. Kodifikaatorite kohta saab infot X-tee teenusega Kodifikaator/Info. Selle, mille kohta täpselt küsida, kirjeldame teenuse OpenAPI dokumentatsioonis.

Kas uute teenustega kaasneb ka jõudluse kasv või langus?

Teenuste loomisel lähtume eesmärgist, et olulist jõudluse langust teenuse kasutamisega ei kaasne.

Kas uute teenustega säilib võimalus kasutada representedParty funktsionaalsust?

Jah, säilib.

Kas on olemas testisikud, kellega päringut proovida?

Isikukoodid, kellel on RR DEV ja TEST keskkondades keskmisest rohkem andmeid, on:

• 47507194712
• 47303144913
• 38211025218