kutsetunnistus

kutsetunnistus

Sisukord



Ülevaade

Antud teenus on mõeldud kutsetunnistuste pärimiseks. Teenus tagastab sisendparameetritele vastavate kutsetunnistuste 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 kutsetunnistus vastamiseks otsitakse kutseregistri andmebaasist tunnistuste kirjeid, mis vastavad sisendis antud parameetritele. Päringu väljundis tagastatakse leitud kirjed, mis vastavad päringu piirangutele. 

Kasutuses on versioonid:

  • kutsetunnistus.v2

  • kutsetunnistus.v3

Kolmanda versiooni korral on täiendatud päringu sisend ja 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

registrinumber

string

ei

Kutsetunnistuse registrinumber.
Alati otsitakse täpset vastet.

nimi

string

ei

Kutsetunnistuse isiku ees- ja perekonnanimi.
Alati otsitakse täpset vastet.

isikukood

string

ei

Kutsetunnistuse omaniku isikukood.
Alati otsitakse täpset vastet.

tyyp

integer

ei

Kutsetunnistuse tüüp. Valikuvariandid on järgmised:

  • 1 - Kutsetunnistus

  • 2 - Osakutsetunnistus

  • 3 - Koolilõpudokumendile kantud kutse

  • 4 -  Koolilõpudokumendile kantud osakutse

  • 30 - Kutseõppe lõpetaja kutsetunnistus

  • 40 - Kutseõppe lõpetaja osakutsetunnistus

kutsestandard

string

ei

Kutsestandardi või spetsialiseerumise nimetus või selle osa.

osakutse

string

ei

Osakutse nimetus või selle osa.
Kui sisendparameetrites on tunnistuse tüübiks määratud "kutsetunnistus", "koolilõpudokumendile kantud kutse" või "kutseõppe lõpetaja kutsetunnistus", siis seda parameetrit ignoreeritakse.

ekrtase

integer

ei

Kutsestandardi tase Eesti kvalifikatsiooniraamistiku järgi.
Võimalikke kvalifikatsioonitasemeid on kaheksa: 1, 2, 3, 4, 5, 6, 7, 8.

eqftase

integer

ei

Kutsestandardi tase Euroopa kvalifikatsiooniraamistiku järgi.
Võimalikke kvalifikatsioonitasemeid on kaheksa: 1, 2, 3, 4, 5, 6, 7, 8.

valjastaja

string

ei

Kutsetunnistuse väljastaja.
Kutsetunnistuse väljaandnud asutuse nimetus või selle osa.

valjastatudalgus

date

ei

Kutsetunnistuse väljastamise vahemiku algus.
Alguskuupäev päeva täpsusega. Täpsustatud kuupäeval väljastatud kutsetunnistused on tulemustesse kaasa arvatud.

valjastatudlopp

date

ei

Kutsetunnistuse väljastamise vahemiku lõpp.
Lõpukuupäev päeva täpsusega. Täpsustatud kuupäeval väljastatud kutsetunnistused on tulemustesse kaasa arvatud.

kehtibalatesalgus

date

ei

Kutsetunnistuse kehtima hakkamise vahemiku algus.
Alguskuupäev päeva täpsusega. Täpsustatud kuupäeval kehtima hakanud kutsetunnistused on tulemustesse kaasa arvatud.

kehtibalateslopp

date

ei

Kutsetunnistuse kehtima hakkamise vahemiku lõpp.
Lõpukuupäev päeva täpsusega. Täpsustatud kuupäeval kehtima hakanud kutsetunnistused on tulemustesse kaasa arvatud.

kehtibkunialgus

date

ei

Kutsetunnistuse kehtivuse lõppemise vahemiku algus.
Alguskuupäev päeva täpsusega. Täpsustatud kuupäeval lõppevad kutsetunnistused on tulemustesse kaasa arvatud.

kehtibkunilopp

date

ei

Kutsetunnistuse kehtivuse lõppemise vahemiku lõpp.
Lõpukuupäev päeva täpsusega. Täpsustatud kuupäeval lõppevad kutsetunnistused on tulemustesse kaasa arvatud.

kirjetearv

integer

ei

Tagastatav kutsetunnistuste arv.
Valikuvariandid on: 10, 30, 50, 100, 200, 500.

 

 

Päringu väljund

Päringu väljundis tagastatakse nimekiri elementidest "kutsetunnistus", kus iga element vastab ühele 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 kokku kaheksa. 

eqftase

integer

Kutsestandardi EQF tase.
Kutsestandardi tase Euroopa kvalifikatsiooniraamistiku järgi. Võimalikke kvalifikatsioonitasemeid 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 kokku kaheksa. 

osakutse_eqftase

integer

Osakutse EQF tase.
Osakutse tase Euroopa kvalifikatsiooniraamistiku järgi. Võimalikke kvalifikatsioonitasemeid 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

Sisend

Element

Andmetüüp

Kirjeldus (v2)

Kirjeldus (v3)

Element

Andmetüüp

Kirjeldus (v2)

Kirjeldus (v3)

tyyp

integer

V2 ja varasemates versioonides päringu sisendis ei olnud lubatud eraldi kutseõppe lõpetaja (osa)kutsetunnistusi pärida. Need tunnistused olid leitavad koolilõpudokumendile kantud (osa)kutsete alt.

Alates v3 on võimalik pärida ka kutseõppe lõpetaja kutsetunnistusi, nende tüübid on järgmised:

  • 30 - Kutseõppe lõpetaja kutsetunnistus;

  • 40 - Kutseõppe lõpetaja osakutsetunnistus.

 

Väljund

Element

Andmetüüp

Kirjeldus (v2)

Kirjeldus (v3)

Element

Andmetüüp

Kirjeldus (v2)

Kirjeldus (v3)

kutsenimetus

string

See element v2 ja varasemates versioonides päringu väljundis puudub.

Alates v3 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 v2 ja varasemates versioonides päringu väljundis puudub.

Kuna osakutse tase võib kutsestandardi tasemest erineda, alates v3 on antud element päringu väljundis olemas, näidatakse siis, kui väärtus on olemas.

osakutse_eqftase

integer

See element v2 ja varasemates versioonides päringu väljundis puudub.

Kuna osakutse tase võib kutsestandardi tasemest erineda, alates v3 on antud element päringu väljundis olemas, näidatakse siis, kui väärtus on olemas.

kehtibkuni

date

See element võis v2 ja varasemates versioonides päringu väljundis puududa, mis tähendas seda, et tunnistus on tähtajatu.

Alates v3 on antud element päringu väljundis alati olemas ja tunnistuse tähtajatust märgib nil="true".

isco

string

See element oli v2 ja varasemates versioonides päringu väljundis olemas, aga väärtuseks oli ametite klassifikaatori 1. ja 2. taseme koodid ja nimetused.

Alates v3 on antud element päringu väljundis olemas, näidatakse ametite klassifikaatori 4. taseme kood ja nimetus.

duplikaat

boolean

See element võis v2 versiooni päringu väljundis puududa, mis tähendas seda, et tunnistus ei ole duplikaat.

Alates v3 on antud element päringu väljundis alati olemas.
"True" korral on tegemist kutsetunnistuse duplikaadiga.

kehtetu

boolean

See element võis v2 versiooni päringu väljundis puududa, mis tähendas seda, et tunnistus on nii staatuselt kui ajaliselt kehtiv.

Alates v3 on antud element päringu väljundis alati olemas.
"True" korral on tegemist kehtetuks tunnistatud või ajaliselt kehtetu kutsega.

oppekavakood

string

See element v2 versiooni päringu väljundis puudub.

Alates v3 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 v2 versiooni päringu väljundis puudub.

Alates v3 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.