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 |
---|---|---|---|
registrinumber | string | ei | Kutsetunnistuse registrinumber. |
nimi | string | ei | Kutsetunnistuse isiku ees- ja perekonnanimi. |
isikukood | string | ei | Kutsetunnistuse omaniku isikukood. |
tyyp | integer | ei | Kutsetunnistuse tüüp. Valikuvariandid on järgmised:
|
kutsestandard | string | ei | Kutsestandardi või spetsialiseerumise nimetus või selle osa. |
osakutse | string | ei | Osakutse nimetus või selle osa. |
ekrtase | integer | ei | Kutsestandardi tase Eesti kvalifikatsiooniraamistiku järgi. |
eqftase | integer | ei | Kutsestandardi tase Euroopa kvalifikatsiooniraamistiku järgi. |
valjastaja | string | ei | Kutsetunnistuse väljastaja. |
valjastatudalgus | date | ei | Kutsetunnistuse väljastamise vahemiku algus. |
valjastatudlopp | date | ei | Kutsetunnistuse väljastamise vahemiku lõpp. |
kehtibalatesalgus | date | ei | Kutsetunnistuse kehtima hakkamise vahemiku algus. |
kehtibalateslopp | date | ei | Kutsetunnistuse kehtima hakkamise vahemiku lõpp. |
kehtibkunialgus | date | ei | Kutsetunnistuse kehtivuse lõppemise vahemiku algus. |
kehtibkunilopp | date | ei | Kutsetunnistuse kehtivuse lõppemise vahemiku lõpp. |
kirjetearv | integer | ei | Tagastatav kutsetunnistuste arv. |
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 |
---|---|---|
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:
|
kutsenimetus | string | Kutsenimetus. |
standard | string | Kutsestandardi nimetus. |
ekrtase | integer | Kutsestandardi EKR tase. |
eqftase | integer | Kutsestandardi EQF tase. |
spetsialiseerumine | string | Spetsialiseerumise nimetus. |
osakutse | string | Osakutse nimetus. |
osakutse_ekrtase | integer | Osakutse EKR tase. |
osakutse_eqftase | integer | Osakutse EQF tase. |
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. |
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. |
oppekavanimetus | string | Õppekava nimetus, mille raames eksami tulemuste pealt tunnistus väljastati. |
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) |
---|---|---|---|
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:
|
Väljund
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. |
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. |
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. |