muutunudKutsetunnistused

Sisukord

1 Ülevaade
2 Teenuse töö kirjeldus
3 Päringu sisend
4 Päringu väljund
5 Veakirjeldus
6 Migratsiooni juhised

Ülevaade

Antud teenus on mõeldud neile, kellel on vaja uuendada kutsetunnistuste andmeid (sünkroniseerimine). Teenus tagastab muutunud kutsetunnistuste (kehtivate ja kehtetud) andmed.

Päringu täpne spetsifikatsioon on välja toodud WSDL-kirjelduse failis, mille leiab X-tee kataloogis https://x-tee.ee/catalogue/ee-test/NGO/90006414/kutseregister (otsides sõna "kutseregister"), sest kataloogi masinkogutud WSDL lingid on numbrilised ja võivad jooksvalt muutuda.

Allpool on lahti seletatud WSDL failides esitatud info.

Teenuse töö kirjeldus

Päringule muutunudKutsetunnistused vastamiseks otsitakse kutseregistri andmebaasist muutunud kutsetunnistuste kirjeid, mis vastavad sisendis antud parameetritele. Päringu väljundis tagastatakse leitud kirjed, mis vastavad päringu piirangutele.

Muutud tunnistuste alla lähevad tunnistused, millel muutub:

staatus;
väljastamise kuupäev;
kehtiv alates kuupäev;
kehtib kuni kuupäev;
taotleja nõusolek isikuandmete avaldamiseks;
tunnistuse number (nt duplikaadi korral);
tunnistuse tüüp.

Päringut võib teha kuupäeva või sekundi täpsega (kui muudatusi liiga palju, siis võib kasutada sekundi täpsust).

Kasutuses on versioonid:

muutunudKutsetunnistused.v1
muutunudKutsetunnistused.v2

Teise versiooni korral on täiendatud päringu väljund: lisatud uued andmeväljad ja täiendatud olemasolevate elementide väärtuste näitamine. Täpsemalt muudatustest vt peatükist "Migratsiooni juhised".

Päringu sisend

Päringu sisendis on järgmised elemendid:

Element	Andmetüüp	Kohustuslik	Kirjeldus

Element	Andmetüüp	Kohustuslik	Kirjeldus
alates	dateTime	jah	Kutsetunnistuse muutuse ajavahemiku algus. Muutuse alguskuupäev päeva ja/või sekundi täpsusega. Täpsustatud kuupäeval muutunud kutsetunnistused on tulemustesse kaasa arvatud.
kuni	dateTime	ei	Kutsetunnistuse muutuse ajavahemiku lõpp. Muutuse lõpukuupäev päeva ja/või sekundi täpsusega. Täpsustatud kuupäeval muutunud kutsetunnistused on tulemustesse kaasa arvatud. Kuni kuupäeva puudumine tähendab praegust hetke.

Päringu väljund

Päringu väljundis tagastatakse nimekiri elementidest "kutsetunnistus", kus iga element vastab ühele muutunud kutsetunnistuse kirjele. Iga kutsetunnistuse kohta tagastatakse järgmised andmed:

Element	Andmetüüp	Kirjeldus

Element	Andmetüüp	Kirjeldus
registrinumber	string	Kutsetunnistuse registrinumber.
nimi	string	Kutsetunnistuse isiku ees- ja perekonnanimi.
isikukood	string	Kutsetunnistuse omaniku isikukood.
tyyp	string	Kutsetunnistuse tüüp. Tüübid on järgmised: Kutsetunnistus Osakutsetunnistus Koolilõpudokumendile kantud kutse Koolilõpudokumendile kantud osakutse Kutseõppe lõpetaja kutsetunnistus Kutseõppe lõpetaja osakutsetunnistus
kutsenimetus	string	Kutsenimetus. Selleks on põhikutse nimetus, spetsialiseerumise nimetus (kui spetsialiseerumine muudab kutsenimetust) või osakutse nimetus.
standard	string	Kutsestandardi nimetus.
ekrtase	integer	Kutsestandardi EKR tase. Kutsestandardi tase Eesti kvalifikatsiooniraamistiku järgi. Võimalikke kvalifikatsioonitasemeid on kokku kaheksa.
eqftase	integer	Kutsestandardi EQF tase. Kutsestandardi tase Euroopa kvalifikatsiooniraamistiku järgi. Võimalikke kvalifikatsioonitasemeid on kokku kaheksa.
spetsialiseerumine	string	Spetsialiseerumise nimetus.
osakutse	string	Osakutse nimetus.
osakutse_ekrtase	integer	Osakutse EKR tase. Osakutse tase Eesti kvalifikatsiooniraamistiku järgi. Võimalikke kvalifikatsioonitasemeid on kokku kaheksa.
osakutse_eqftase	integer	Osakutse EQF tase. Osakutse tase Euroopa kvalifikatsiooniraamistiku järgi. Võimalikke kvalifikatsioonitasemeid on kokku kaheksa.
lisavali	string	Vabatekstiline lisaväli.
kompetentsid	string	Valitavad kompetentsid.
valdkond	string	Valdkond kutsesüsteemi klassifikaatori järgi.
kutseala	string	Kutseala kutsesüsteemi klassifikaatori järgi.
hariduslikkval	string	Hariduslik kvalifikatsioon. Kasutatakse koolilõpudokumendile kantud kutsete ja osakutsete korral.
keel	string	Kutseeksami keel.
valjastaja	string	Kutsetunnistuse väljastaja ehk kutsetunnistuse väljaandnud asutuse nimetus.
valjaantud	date	Kutsetunnistuse väljastamise kuupäev.
kehtibalates	date	Kutsetunnistuse kehtib alates kuupäev.
kehtibkuni	date	Kutsetunnistuse kehtib kuni kuupäev. NB! Väärtuse puudumisel on tegemist tähtajatu kutsega.
isco	string	4-kohaline ameti kood ja nimetus ISCO ametite klassifikaatori järgi.
duplikaat	boolean	"True" korral on tegemist kutsetunnistuse duplikaadiga.
kehtetu	boolean	"True" korral on tegemist kehtetuks tunnistatud või ajaliselt kehtetu kutsega.
reaid	string	Kutsetunnistuse kirje ID.
kustutatud	boolean	"True" korral on tegemist kustutatud tunnistusega.
oppekavakood	string	Õppekava kood, mille raames eksami tulemuste pealt tunnistus väljastati. Reserveeritud väli, hetkel on selle väärtus on alati tühi.
oppekavanimetus	string	Õppekava nimetus, mille raames eksami tulemuste pealt tunnistus väljastati. Reserveeritud väli, hetkel on selle väärtus on alati tühi.
kirjeid	integer	Tagastatavate kirjete arv.

Veakirjeldus

Kui sisendparameetritele vastavat tunnistust ei leita, näidatakse teadet: Ei leitud ühtegi otsingukriteeriumitele vastavat kutsetunnistust.

Migratsiooni juhised

Element	Andmetüüp	Kirjeldus (v1)	Kirjeldus (v2)

Element	Andmetüüp	Kirjeldus (v1)	Kirjeldus (v2)
kutsenimetus	string	See element v1 versiooni päringu väljundis puudub.	Alates v2 on antud element päringu väljundis alati olemas Kutsenimetus on: põhikutse nimetus, spetsialiseerumise nimetus, kui spetsialiseerumine muudab kutsenimetust ja osakutse nimetus.
osakutse_ekrtase	integer	See element v1 versiooni päringu väljundis puudub.	Kuna osakutse tase võib kutsestandardi tasemest erineda, alates v2 on antud element päringu väljundis olemas, näidatakse siis, kui väärtus on olemas.
osakutse_eqftase	integer	See element v1 versiooni päringu väljundis puudub.	Kuna osakutse tase võib kutsestandardi tasemest erineda, alates v2 on antud element päringu väljundis olemas, näidatakse siis, kui väärtus on olemas.
kehtibkuni	date	See element võis v1 versiooni päringu väljundis puududa, mis tähendas seda, et tunnistus on tähtajatu.	Alates v2 on antud element päringu väljundis alati olemas ja tunnistuse tähtajatust märgib nil="true".
isco	string	See element oli v1 versiooni päringu väljundis olemas, aga väärtuseks oli ametite klassifikaatori 1. ja 2. taseme koodid ja nimetused.	Alates v2 on antud element päringu väljundis olemas, näidatakse ametite klassifikaatori 4. taseme kood ja nimetus.
duplikaat	boolean	See element võis v1 versiooni päringu väljundis puududa, mis tähendas seda, et tunnistus ei ole duplikaat.	Alates v2 on antud element päringu väljundis alati olemas. "True" korral on tegemist kutsetunnistuse duplikaadiga.
kehtetu	boolean	See element võis v1 versiooni päringu väljundis puududa, mis tähendas seda, et tunnistus on nii staatuselt kui ajaliselt kehtiv.	Alates v2 on antud element päringu väljundis alati olemas. "True" korral on tegemist kehtetuks tunnistatud või ajaliselt kehtetu kutsega.
oppekavakood	string	See element v1 versiooni päringu väljundis puudub.	Alates v2 on antud element päringu väljundis alati olemas, aga alati tühja väärtusega, sest tegu on reserveeritud elemendiga, mida on plaanis kasutada tulevikus.
oppekavanimetus	string	See element v1 versiooni päringu väljundis puudub.	Alates v2 on antud element päringu väljundis alati olemas, aga alati tühja väärtusega, sest tegu on reserveeritud elemendiga, mida on plaanis kasutada tulevikus.