kutseAndjaInfo

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 nende kutse andja andmete pärimiseks, mida kasutatakse kutsetunnistuse lisamise teenuses kutsetunnistuseLisamine2.
Teenus tagastab kutse andja nime, väljastada lubatud kutsetunnistuste tüübid, kehtivate standardite (uue versiooni v2 korral ka arhiivsete standardite) nimekirja, mille kutseid on kutse andjal lubatud väljastada, kutse andjaga seotud aktiivsete kutsekomisjonide ja nende liikmete nimekirja ning kutseeksami keelte nimekirja.

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 kutseAndjaInfo vastamiseks otsitakse kutseregistri andmebaasist kutse andja ja talle lubatud väljastada kutsestandardite ning kutse andjaga seotud kutsekomisjonide kirjeid, mis vastavad sisendis antud parameetritele. Päringu väljundis tagastatakse leitud kirjed, mis vastavad päringu piirangutele.

Kasutuses on versioonid:

kutseAndjaInfo.v2
kutseAndjaInfo.v1

Päringu sisend

Päringu sisendis on järgmised elemendid:

Element	Andmetüüp	Kohustuslik	Kirjeldus

Element	Andmetüüp	Kohustuslik	Kirjeldus
asutus	string	jah	Kutse andja registrikood. Selle kutse andja registrikood, kellele on teenuse kasutamine lubatud (kutseregistris on kutse andja kirje juures X-tee teenuse kasutamine lubatud). See võib olla ka kutse andja allasutuse registrikood, kui see on kutseregistris kutse andja juures X-tee kasutaja registrikoodiks märgitud.

Päringu väljund

Päringu väljundis tagastatakse kutse andja andmed ja nimekiri elementidest "kutsestandard", "kutsekomisjon" ja "keel", kus iga element vastab ühele kutsestandardi, kutsekomisjoni ja keele kirjele. Kutse andja kohta tagastatakse järgmised andmed:

Element	Andmetüüp	Kirjeldus

Element	Andmetüüp	Kirjeldus
kutseandja		Kutse andja andmed.
nimetus	string	Kutse andja nimi.
tunnistusetyybid		Kutse andjale lubatud väljastada kutsetunnistuse tüüpide nimekiri.
tunnistusetyyp	integer	Kutsetunnistuse tüübi ID. Tüübid on järgmised: 1 - kutsetunnistus; 2 - osakutsetunnistus; 3 - koolilõpudokumendile kantud kutse; 4 - koolilõpudokumendile kantud osakutse. Kutseõppe lõpetaja kutse ja osakutse ei ole lubatud. Neid lisatakse süsteemi läbi kutseeksamihalduse.
lisavali	boolean	Kas kutsetunnistusel on vabatekstiline lisaväli lubatud.
voibinfotpeita	boolean	Kas kutse andjal on kutsetunnistusel isiku nime ja sünniaja peitmine on lubatud.
kutsestandardid		Kutsestandardite nimekiri.
kutsestandard		Kutsestandardi andmed.
id	int	Kutsestandardi ID.
nimetus	string	Kutsestandardi nimetus.
tyybid		Kutsestandardi tüüpide nimekiri.
tyyp	integer	Kutsestandardi tüübi ID. Tüübid on järgmised: 1 - Kutsestandard; 2 - Osakutse standard; 3 - Esmase kutse standard; 4 - Esmase osakutse standard.
spetsialiseerumised		Spetsialiseerumiste nimekiri.
spetsialiseerumine		Spetsialiseerumise andmed.
id	integer	Spetsialiseerumise ID.
nimetus	string	Spetsialiseerumise nimetus.
osakutsed		Osakutsete nimekiri.
osakutse		Osakutse andmed.
id	integer	Osakutse ID.
nimetus	string	Osakutse nimetus.
kompetentsid		Kompetentside nimekiri. Kui standard on korraga mitut tüüpi, siis võib kompetentsid elementi olla mitu.
tunnistusetyybid		Tunnistuse tüüpide nimekiri, millele antud kompetentsid sobivad.
tunnistusetyyp	integer	Kutsetunnistuse tüübi ID, millele on valitavad kompetentsid lubatud. Tüübid on järgmised: 1 - kutsetunnistus; 2 - osakutsetunnistus; 3 - koolilõpudokumendile kantud kutse; 4 - koolilõpudokumendile kantud osakutse. Kompetentsid on lubatud ainult tüüpidele 1 (kutsetunnistus) ja 3 (koolilõpudokumendile kantud kutse).
kompetentsinimekiri		Kompetentside nimekiri.
kompetents		Kompetentsi andmed.
id	integer	Kompetentsi ID.
nimetus	string	Kompetentsi nimetus.

pohikutse	boolean	Võib omistada põhikutset. TRUE - spetsialiseerumine pole nõutud; FALSE - spetsialiseerumine peab olema määratud (ei kehti osakutsetunnistuse puhul).
versioon	integer	Kutsestandardi versiooni number.
kehtibalates	date	Kutsestandardi kehtivuse alguskuupäev.
kehtibkuni	date	Kutsestandardi kehtivuse lõpukuupäev.
kutsekomisjonid		Kutsekomisjonide nimekiri.
kutsekomisjon		Kutsekomisjoni andmed.
nimetus	string	Kutsekomisjoni nimetus.
liikmed		Kutsekomisjoni liikmete nimekiri.
liige		Kutsekomisjoni liikme andmed.
id	integer	Kutsekomisjoni liikme ID.
nimi	string	Kutsekomisjoni liikme nimi.
roll	integer	Kutsekomisjoni liikme rolli ID. Rollid on järgmised: 1 - Kutsekomisjoni esimees; 2 - Kutsekomisjoni aseesimees; 3 - Kutsekomisjoni liige.
kutseeksamikeeled		Kutseeksami keelte nimekiri.
keel		Kutseeksami keele andmed.
id	integer	Kutseeksami keele ID. Keeled on järgmised: 1 - eesti keel; 2 - vene keel; 3 - inglise keel; 4 - läti keel; 5 - soome keel.
nimetus	string	Kutseeksami keele nimetus.
vigadearv	integer	Vigade arv.
vead		Vigade nimekiri.
viga		Vea andmed.
element	string	Vea tekitanud element.
teade	string	Veateade

Veakirjeldus

Kui sisendparameetritele vastavaid kirjeid ei leita, näidatakse vea tekitanud elementi ja vastavat teadet.

Migratsiooni juhised

V2 versioonist alates tagastatakse päringu väljundis nii kehtivad kui kehtetud kutsestandardid, mille kutseid on kutse andjal lubatud väljastada.

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

Element	Andmetüüp	Kirjeldus (v1)	Kirjeldus (v2)
tunnistusetyyp	integer	See element v1 versiooni päringu väljundis olemas, aga tagastatakse ainult kolm kutse tunnistuse tüüpi: 1, 2 ja 3.	Alates v2 olemas ka neljas kutsetunnistuse tüüp: 4 - koolilõpudokumendile kantud osakutse.
voibinfotpeita	boolean	See element v1 versiooni päringu väljundis olemas, aga seda ei kasutata.	Alates v2 nime peitmise elementi ei ole. See võib sisendis olla, aga seda ignoreeritakse. Tegu on ajaloolise elemendiga (kutsetunnistuse isiku andmete peitmise võimaldamine), mida kasutati enne terve kutsetunnistuse registri avalikust vaatest peitmise võimaluse tekkimist.
tyyp	integer	See element v1 versiooni päringu väljundis olemas, aga tagastatakse ainult kolm kutsestandardi tüüpi: 1, 2 ja 3.	Alates v2 olemas ka neljas kutsestandardi tüüp: 4 - Esmase osakutse standard.
kompetentsid		Kompetentside nimekirja element v1 versiooni päringu väljundis olemas, aga tagastatakse kompetentse ka tunnistuse tüüpi 2 (osakutse) korral (need on kutsestandardi kohustuslikud kompetentsid).	Alates v2 tagastatakse ainult valitavaid kompetentse ja ainult tunnistuse tüübi 1 või 3 korral. Osakutsete korral (tunnistuse tüüp 2 või 4) valitavaid kompetentse ei ole.
versioon	integer	See element v1 versiooni päringu väljundis puudub.	Alates v2 versioonist on väljundis olemas kutsestandardi versiooni numbri element.
kehtibalates	date	See element v1 versiooni päringu väljundis puudub.	Alates v2 versioonist on väljundis olemas kutsestandardi kehtivuse alguse kuupäeva element.
kehtibkuni	date	See element v1 versiooni päringu väljundis puudub.	Alates v2 versioonist on väljundis olemas kutsestandardi kehtivuse lõpu kuupäeva element.