KOKKULEPE ANDMEEDASTUSE KOHTA
Tööinspektsioon (edaspidi TI) registrikood 70001969, mida esindab põhikirja alusel
peadirektor Maret Maripuu ühelt poolt,
Tervise ja Heaolu Infosüsteemide Keskus (edaspidi TEHIK), registrikood 70009770, mida
esindab direktor Katrin Reinhold teiselt poolt ja
Maksu- ja Tolliamet (edaspidi MTA), registrikood 70000349, mida esindab põhimääruse ja
peadirektori 06.02.2018 käskkirja nr 35-P alusel e-büroo juhataja Anne Leisner kolmandalt
poolt (edaspidi ühiselt pooled), lepivad kokku alljärgnevas:
1 KOKKULEPPE OBJEKT JA EESMÄRK
1.1 Kokkuleppe objekt on võimaldada juurdepääs maksukohustuslaste registri (edaspidi
MKR) andmetele:):
1.1.1 TI-le maksukorralduse seaduse (edaspidi MKS) § 251 lg 1 ja lg 2 alusel
töövaidluskomisjonile seaduses nimetatud juhtudel kandemuudatuste tegemiseks;
1.1.2 TI-le MKS § 29 punkt 18 alusel riikliku järelevalve teostamiseks tööalaste õigusaktide
täitmise üle ettevõtetes tööohutuse tagamise eesmärgil;
1.1.3 TEHIKule MKS § 26 lg 21 alusel info- ja sidesüsteemide hooldamiseks ja
arendamiseks.
1.2 Juurdepääs võimaldatakse töötamise registri andmetele X-tee kaudu:
1.2.1 TORIK ja TORSYNK üksikpäring, lisa 1;
1.2.2 TORIK masspäring UploadMime ja DownloadMime, lisa 2;
1.2.3 TORRGNO üksikpäring, lisa 3;
1.2.4 TOOTREG_AMETNIK, lisa 4;
1.2.5 TORINFO, lisa 5;
1.2.6 TORTI, Lisa 6.
1.3 MKS § 255 p 4 alusel töötamise registrisse kannete tegemiseks võimaldatakse juurdepääs
töötamise registrile e-MTA ametnikuportaali kaudu.
2 TEHIKu KOHUSTUSED
2.1 TEHIKul on kohustus:
2.1.1 tagada, et TEHIKu töötajad ei kasuta juurdepääsuga saadud andmeid muudel
eesmärkidel, kui TIle tehnilise toe tagamiseks kooskõlas seadusega;
2.1.2 töödelda saadud andmeid vastavalt MKRile omistatud turvaklassile K2T2S2;
2.1.3 töödelda isikuandmeid kooskõlas isikuandmete kaitse üldmäärusega (Euroopa
Parlamendi ja Nõukogu määrus (EL) 2016/679) ja muude isikuandmete töötlemist
käsitlevate teiste Eesti Vabariigis kehtivate õigusaktidega;
2.1.4 rakendada punktis 2.1.3. nimetatud õigusaktidest tulenevaid asjakohaseid
organisatsioonilisi, infotehnilisi ja füüsilisi turvameetmeid andmete kaitsmiseks, et ära
hoida;
2.1.4.1 volitamata isikute juurdepääs andmetele, sealhulgas isikuandmete töötlemiseks
kasutatavatele andmetöötlusseadmetele;
2.1.4.2 andmetöötlussüsteemi kasutamine andmesidevahendite abil volitamata isikute
poolt;
2.1.5 määrata töötajad, kellele on tööülesannete täitmiseks vajalik juurdepääs andmetele;
töötajatel, kellele on antud juurdepääsuõigus, peab olema personaalne
kasutajatunnus, mille järgi on kasutajat võimalik tuvastada;
2.1.6 tagada järelevalve tehtud päringute ja saadud andmete õiguspärase kasutamise üle,
juurdepääs andmetele on lubatud ainult tööülesannete täitmiseks;
2.1.7 sulgeda juurdepääs töötajale koheselt, kui töötajal kaob vajadus juurdepääsuks või
töösuhe temaga lõpeb;
2.1.8 tagada, et TEHIK ei edasta ega anna muul viisil üle saadud andmeid kolmandatele
isikutele, v.a seaduses sätestatud alustel ja seadusest tulenevate ülesannete
täitmiseks.
2.2 Isikuandmete töötlemise rikkumisest teadasaamisel või avastamisel teavitada MTAd
viivitamatult e-posti aadressil
[email protected]
3 TI KOHUSTUSED
3.1 TI-l on kohustus:
3.1.1 tagada, et saadud andmeid kasutatakse üksnes seaduses sätestatud tööülesannete
täitmiseks;
3.1.2 töödelda saadud andmeid vastavalt MKRile omistatud turvaklassile K2T2S2;
3.1.3 töödelda isikuandmeid kooskõlas isikuandmete kaitse üldmäärusega (Euroopa
Parlamendi ja Nõukogu määrus (EL) 2016/679) ja muude isikuandmete töötlemist
käsitlevate teiste Eesti Vabariigis kehtivate õigusaktidega;
3.1.4 rakendada punktis 3.1.3. nimetatud õigusaktidest tulenevaid asjakohaseid tehnilisi ja
füüsilisi turvameetmeid isikuandmete kaitsmiseks, et ära hoida:
3.1.4.1 volitamata isikute juurdepääs isikuandmete töötlemiseks kasutatavatele
andmetöötlusseadmetele;
3.1.4.2 andmetöötlussüsteemi kasutamine andmesidevahendite abil volitamata isikute
poolt;
3.1.5 tagada automatiseeritud andmetöötlussüsteemi kasutamise luba omavale kasutajale
juurdepääs üksnes nendele isikuandmetele, mida hõlmab tema juurdepääsuluba;
3.1.6 määrata teenistujad, kellele on tööülesannete täitmiseks vajalik juurdepääs andmetele;
teenistujatel, kellele on antud juurdepääsuõigus, peab olema personaalne
kasutajatunnus, mille järgi on kasutajat võimalik tuvastada;
3.1.7 tagada järelevalve tehtud päringute üle ja saadud andmete õiguspärase kasutamise
üle, juurdepääs andmetele on lubatud ainult teenistusülesannete täitmiseks;
3.1.8 sulgeda juurdepääs teenistujatele koheselt, kui teenistujal kaob vajadus juurdepääsuks
või teenistussuhe temaga lõpeb;
3.1.9 tagada, et TI ei edasta ega anna muul viisil üle saadud andmeid kolmandatele isikutele,
v.a seaduses sätestatud alustel ja seadusest tulenevate ülesannete täitmiseks.
3.1.10 tagada, et TI poolt ei asutata ühtede ja samade andmete kogumiseks eraldi
andmekogu.
3.2 TI vastutab talle väljastatud andmete osas andmete saamisest, nende kasutamisest või
muul moel töötlemisest tulenevate kolmandate isikute esitatud nõuete ja neile tekitatud
kahjude hüvitamise eest.
3.3 Andmesubjekti päringutele tema isikuandmete töötlemise kohta TI poolt vastab TI.
3.4 Isikuandmete töötlemise rikkumisest teadasaamisel või avastamisel on TIl kohustus
edastada kogu asjassepuutuv teave viivitamatult MTAle e-posti aadressil
[email protected].
4 MTA ÕIGUSED
4.1 MTAl on õigus:
4.1.1 katkestada juurdepääs andmetele hooldustööde korral MTAs kehtestatud
süsteemihoolduseks ettenähtud ajal (tööpäeviti 7:00–8:00 ja täiendavalt kolmapäeviti
17:00–20:00);
4.1.2 katkestada juurdepääs teenusele hooldustööde korral muul ajal, teavitades sellest
kontaktisikut kolm tööpäeva ette;
4.1.3 katkestada koheselt juurdepääs teenusele, kui TI töötaja rikub kokkuleppega pandud
kohustusi, või ilmneb sellekohane põhjendatud kahtlus.
5 KOKKULEPPE KEHTIVUS, MUUTMINE JA LÕPETAMINE
5.1 Kokkulepe jõustub selle allakirjutamise hetkest ning on sõlmitud tähtajatult.
5.2 Kokkuleppe muudatused ja täiendused tehakse poolte kokkuleppe alusel kirjalikult ja
vormistatakse kokkuleppe lahutamatu lisana.
5.3 Pooltel on õigus kokkulepe ühepoolselt üles öelda, teatades sellest teistele poolele
kirjalikult üks kuu ette.
6 VAIDLUSTE LAHENDAMINE JA VASTUTUS
6.1 Kõik kokkuleppest tulenevad erimeelsused lahendatakse läbirääkimiste teel.
Läbirääkimiste ebaõnnestumisel lahendatakse vaidlused Eesti Vabariigi õigusaktidega
ettenähtud korras.
6.2 Kokkuleppega võetud kohustuste täitmata jätmise eest või mittenõuetekohase täitmise
eest astutavad pooled Eesti Vabariigi õigusaktidega kehtestatud korras.
7 LÕPPSÄTTED
7.1 Poolte kontaktid kokkuleppe täitmisel on:
Tööinspektsioon e-post
[email protected], telefon 640 6000
TEHIK e-post
[email protected], telefon 7943 943
MTA: MTA klienditugi:
[email protected].
Tehniline tugi IT HelpDesk:
[email protected], tel 8800880, .
7.2 Pooled on kohustatud viivitamatult teatama kontaktandmete muutmisest teisele poolele.
7.3 Kokkulepe allkirjastatakse digitaalselt.
Tööinspektsioon Tervise ja Heaolu Maksu- ja Tolliamet
Infosüsteemide
Keskus
/allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/
Maret Maripuu Katrin Reinhold Anne Leisner
Lisa 1
Töötamise registri isikukoodi järgi päringu TORIK ja TORSYNK andmekoosseis
Päringu sisend:
TORSYNK - Töötamiste otsimine TÖRist sünnikuupäeva järgi. Päringu sisendiks on nõutav
sünniaeg, perekonnanimi, eesnimi. Kodakondsuse etteandmine on vabatahtlik.
TORIK päringu sisendiks on isikukood
paringu_liik (xsd:string[1]) - Liik määrab, millist infot küsitakse (A/T/P/AM/TM/PM)
A – Tänase seisuga aktiivsed kanded etteantud isikute kohta. Kumbagi perioodi ei ole vaja
ette anda.
T - Tänase seisuga kõik töötamise kanded etteantud isikute kohta, ka lõpetatud kanded.
Kumbagi perioodi ei ole vaja ette anda.
P - Töötamisperioodil aktiivsed kanded etteantud isikute kohta (töötamisperioodi sisestamine
kohustuslik). Vastuseks need, kes töötamisperioodi jooksul töötasid vähemalt 1 päeva.
Praegu võivad olla ka lõpetanud seisus.
AM - Tänase seisuga aktiivsed kanded etteantud isikute kohta koos muutuste perioodil
tehtud muutustega (muutuste perioodi sisestamine kohustuslik). Vastuseks isikute iga
aktiivse töötamise kande kõik read alates muutuste perioodi algusest kuni tänaseni.
TM - Täna seisuga kõik töötamise kanded nende isikute kohta koos muutuste perioodil
tehtud muutustega (muutuste perioodi sisestamine kohustuslik). Vastuseks isikute iga
töötamise kande kõik read alates muutuste perioodi algusest kuni tänaseni.
PM - Töötamisperioodil kehtinud kanded koos muutuste perioodil tehtud muutustega,
(töötamisperioodi ja muutuste perioodi sisestamine kohustuslik). Vastuseks need, kes
töötamisperioodi jooksul töötasid vähemalt 1 päeva ja kõik muudatused, mis nende kannete
kohta tehti muutuste perioodi jooksul.
toot_algus (xsd:date[1]) - Töötamisperioodi algus (aaaa-kk-pp)
toot_lopp (xsd:date[1]) - Töötamisperioodi lõpp (aaaa-kk-pp)
muut_alg (xsd:date[1]) - Muutuste perioodi algus (aaaa-kk-pp)
muut_lopp (xsd:date[1]) - Muutuste perioodi lõpp (aaaa-kk-pp)
isikukoodid (xsd:string [1]) – loetelu töötajate isikukoodidest (max 100 isikukoodi ühes
päringus, komadega eraldatud
Vastussõnum:
Töötamise andmed
kood (xsd:integer[1]) – päringu töötlemise tulemuse kood
0 – päring oli OK
50 – vigane päring
52 - ei leidnud töötamisi
100 – vastuseks liiga palju ridu (üle parameetriga
IK_PARINGU_MAX_KIRJETE_ARV määratud arvu)
leitud_kannete_arv (xsd:integer[1]) – päringu vastuseks saadud kannete arv
kannete_jada (xsd:element [0..1])
kanne (xsd:string [0..1000]) – iga töötamise kohta leitud kõik kanded sisaldavad järgmisi
välju:
toot_id (xsd:integer[1]) - Töötamise kande ID TÖR-s - ühe töötamise (kande) kohta leitud
kõik muudatuskirjed kannavad sama TÖR ID-d;
isikukood (xsd:string[1]) – töötava isiku isikukood RR andmete alusel;
synniaeg (xsd:date[0...1]) – töötava isiku sünniaeg kui IK ei ole (aaaa-kk-pp);
perenimi (xsd:string[0...1]) – Töötaja nimi RR andmete alusel;
eesnimi (xsd:string[0...1]) – Töötaja nimi RR andmete alusel;
kodakondsus_kood (xsd:string[0...1]) – Töötaja kodakondsuse ISO 3166-1 kood RR alusel;
kodakondsus_nimi (xsd:string[0...1]) – Töötaja kodakondsuse riigi nimi;
ta_kood (xsd:string[1]) – Tööd võimaldava isiku identifikaator (isikukood või äriregistri kood);
ta_nimi (xsd:string[1]) - Tööd võimaldava isiku nimetus;
tegeliku_ta_kood (xsd:string[0...1]) – Tegeliku tööd võimaldava isiku identifikaator (isikukood
või äriregistri kood) - kasutavad 2 ministeeriumi, võib täita peale töösuhte lõppu;
tegeliku_ta_nimi(xsd:string[0...1]) - Tegeliku tööd võimaldava isiku nimetus;
tootamise_algus (xsd:date[1]) – tööle asumise aeg (aaaa-kk-pp);
tootamise_liik_kood (xsd:string [0...1]) – töötamise liigi kood TÖR klassifikaatorist;
tootamise_liik_nimi (xsd:string [0...1]) – töötamise liigi nimetus TÖR klassifikaatorist;
tooaja_maar (xsd:decimal [0...1]) - tööaja määr;
leping (xsd:string [0...1]) – Samaaegsete samaliigiliste lepingute eristamiseks, vaba tekst;
tootamise_lopp (xsd:date[0...1])– töötamise lõpetamise aeg (aaaa-kk-pp);
tootamise_lopetamise_alus_ kood (xsd:string [0...1]) – aluse kood TLP klassifikaatorist;
tootamise_lopetamise_alus_nimi (xsd:string [0...1]) – aluse nimetus TLP klassifikaatorist;
amet_kood (xsd:string [0...1]) – ameti kood Statistika klassifikaatorist;
amet_nimi (xsd:string [0...1]) – ameti nimetus Statistika klassifikaatorist;
koht_id (xsd:integer [0...1]) - Töötamise asukoha aadressi ID –
(http://xgis.maaamet.ee/adsavalik/ads);
koht (xsd:string [0...1]) - Töötamise asukoht (töö asukoha aadress) ADS järgi;
riigi_kood – Töötamise asukoha riik väljalt TOOTAMINE.RIIGI_KOOD
peatamiste_jada (xsd:element [0..unbounded]) - selle töötamise kohta registreeritud
peatamised
peatamine (xsd:string [0..20]) – Iga peatamise kohta leitud kõik kanded sisaldavad järgmisi
välju:
peat_id (xsd:integer[1]) - Peatamise ID tabelist PEAT;
peat_algus (xsd:date[1]) – töötamise peatamise alguse kuupäev (aaaa-kk-pp);
peat_alus_kood (xsd:string [1]) – töötamise peatamise aluse kood peatamise aluste
klassifikaatorist;
peat_alus_nimi (xsd:string [1]) – töötamise peatamise aluse nimetus peatamise aluste
klassifikaatorist;
peat _lopp(xsd:date[1]) – töötamise peatamise lõpu kuupäev (aaaa-kk-pp);
peat_ehk_aeg (xsd:datetime [1]) – Viimati EHK-sse saadetud peatamise sõnumi
saatmise_aeg tabelist PEAT_EHK (aaaa-kk-ppTtt:mi:ss);
kande_olek_kood (xsd:string [1])– kande oleku kood TÖR klassifikaatorist
kande_olek_nimi (xsd:string [1])– kande oleku nimetus TÖR klassifikaatorist
ta_markus(xsd:string [0…1]) – Tööd võimaldava isiku märkus;
mta_markus (xsd:string [0…1]) – Ametniku märkus;
algkp_otsuse_liik_kood (xsd:string [0...1]) - Algkuupäeva kohta tehtud otsuse liigi kood
klassifikaatorist;
algkp_otsuse_liik_nimi (xsd:string [0...1]) - Algkuupäeva kohta tehtud otsuse liigi nimetus
klassifikaatorist;
algkp_otsus (xsd:string [0...1]) – lisaväli TVK/Kohtu otsuse numbri jaoks (alguse kuup kohta);
tootliik_otsuse_liik_kood (xsd:string [0...1]) - Töötamise liigi kohta tehtud otsuse liigi kood
klassifikaatorist;
tootliik_otsuse_liik_nimi (xsd:string [0...1]) - Töötamise liigi kohta tehtud otsuse liigi nimetus
klassifikaatorist;
tootliik_otsus (xsd:string [1]) – lisaväli TVK/ Kohtu otsuse numbri jaoks (töötamise liigi kohta);
loppkp_otsuse_liik_kood (xsd:string [0..1]) – Lõpu kuupäeva kohta tehtud otsuse liigi kood
klassifikaatorist;
loppkp_otsuse_liik_nimi (xsd:string [0...1]) – Lõpu kuupäeva kohta tehtud otsuse liigi nimetus
klassifikaatorist;
loppkp_otsus (xsd:string [1]) – lisaväli TVK/ Kohtu otsuse numbri jaoks (lõpu kuup kohta);
lopalus_otsuse_liik_kood (xsd:string [0...1]) – Lõpetamise aluse kohta tehud otsuse liigi kood
klassifikaatorist;
lopalus_otsuse_liik_nimi (xsd:string [0...1]) – Lõpetamise aluse kohta tehud otsuse liigi
nimetus klassifikaatorist;
lopalus_otsus (xsd:string [0...1]) – lisaväli TVK/ Kohtu otsuse numbri jaoks (lõpetamise aluse
kohta);
sisestamise_aeg (xsd:datetime [1]) (aaaa-kk-ppTtt:mi:ss);
muutmise_aeg (xsd:datetime [1]) (aaaa-kk-ppTtt:mi:ss);
reg_tel_nr (xsd:string [0...1]) –lihtsustatud registreerimisel (SMS kaudu või helistamise teel )
telefoni number, millelt registreerimine tehti;
toot_ehk_aeg (xsd:datetime [0...1]) – Viimati EHK-sse saadetud töötamise sõnumi
saatmise_aeg tabelist TOOT_EHK (aaaa-kk-ppTtt:mi:ss);
toot_ehk_sonumi_liik (xsd:string [0...1]) – (K/L/I) - kas viimati saadetud töötamise sõnum oli
alustamise või lõpetamise sõnum või lõpetamise muutmise sõnum.
Ettevõtluskonto andmed
toot_id (xsd:integer[1]) - Ettevõtlsukonto ID;
isikukood (xsd:string[1]) – Ettevõtluskonto omaniku isikukood
ta_kood (xsd:string[1]) - ettevõtluskonto omaniku isikukood;
ta_nimi (xsd:string[1]) - ettevõtluskonto omaniku nimi;
tootamise_algus (xsd:date[1]) – ettevõtluskonto alguskuupäev;
tootamise_liik_kood (xsd:string [0..1]) – töötamise liigi kood TÖR klassifikaatorist
(Ettevõtluskonto_kood);
tootamise_liik_nimi (xsd:string [0..1]) – töötamise liigi nimetus (’Ettevõtluskonto’);
tootamise_lopp (xsd:date[0..1]) – ettevõtluskonto lõppkuupäev (aaaa-kk-pp) kui eksisteerib;
kande_olek_kood (xsd:string [1])– kande oleku kood TÖR klassifikaatorist
kande_olek_nimi (xsd:string [1])– oleku nimetus TÖR klassifikaatorist
sisestamise_aeg (xsd:datetime [1]) - EV konto sisestamise aeg (aaaa-kk-ppTtt:mi:ss);
muutmise_aeg (xsd:datetime [1]) - EV konto muutmise aeg (aaaa-kk-ppTtt:mi:ss);
Tagastatavad teated:
0 Päring oli korrektne.
50 Viga päringu töötlemisel.
51 Päringus puuduvad sisendandmed
52 Töötamisi ei leidnud
57 Sisendandmetes puudub päringu tüüp.
58 Päringusse pole sisestatud kõiki vajaminevaid andmeid.
59 Päringu tüübil "P" puudub algus või lõpukuupäev.
60 Päringu tüübil AM/TM puudub muutmise algus või lõpukuupäev
61 Päringu tüübil PM puuduvad nõutud kuupäevad.
63 Päringu tüüp ei ole korrektne.
68 Sisendandmetes puudub isikukood.
69 Isikukoodi pikkus ei sobi
70 Üldine viga, andmete laadimine andmebaasist ebaõnnestus
71 Üldine viga, süsteemiparameetri laadimine andmebaasist ebaõnnestus
100 Sõnumi vastus sisaldab liiga palju kirjeid.
Vastuse koostamine
Töötamise kanded
A – Tänased aktiivsed
Kanded võetakse ainult põhitabelist, tyhistatud ja lõpetatud kandeid ei võeta. Alustamise
ootel kanded on kaasa arvatud.
T – Tänane seis
Kanded võetakse ainult põhitabelist, tyhistatud kandeid ei võeta. Lõpetatud ja alustamise
ootel kanded on kaasa arvatud.
P – Perioodi jooksul vähemalt 1 päev aktiivsed olnud
Perioodi jooksul töötanuks loetakse need töötajad, kelle töötamise ajast vähemalt 1 päev
langeb küsitud töötamise perioodi sisse.
Esialgu jäävad kõik lõpetatud kanded edasi põhitabelisse, aga hiljem viiakse 3 (5?) aastat
tagasi lõpetatud kanded üle ajaloo tabelitesse ja sellepärast peaks selle päringu puhul
otsima viimast (max muutmiskuupäevaga) kannet üle 2 tabeli juhul, kui etteantud töötamise
periood ulatub nii kaugele, et osa lõpetatud kandeid on ajaloo tabelise üle viidud.
Leitakse põhitabelist TOOTAMINE ja ajaloo tabelist TOOTAMISE_AJALUGU selle isiku
kõikide töötamiste viimased (max muutmiskuupäevaga) kanded, kus vähemalt 1 päev
uuritavast perioodist langeb kokku tegeliku töötamise perioodiga - olenemata kande
praegusest olekust:
Kui LOP_AEG on täidetud ja PER_ALG > LOP_AEG - kannet ei valita vastusesse
Kui PER_LOP < ALG_AEG – kannet ei valita vastusesse, olenemata sellest kas LOP_AEG
on täidetud või ei ole.
Kõik ülejaanud (selle isiku töötamiste max muutmiskuupäevaga) kanded valitakse
vastusesse.
PEATAMINE tabelist valitakse alati need read, mis on seotud eespool valitud töötamise
kannetega.
AM, TM ja PM - samad variandid koos muutustega
AM, TM ja PM puhul leitakse samade TOOTAMINE tabeli kannete TOOT_ID-d, mis A, T ja P
puhul aga nende TOOT_ID-de TOOTAMISE_AJALUGU tabeli read valitakse vastusesse
lisaks põhitabeli ridadele juhul kui nende kannete MUUTMISE_AEG langeb uuritavasse
muutuste perioodi:
Kui MUUTMISE_AEG <MUUT_PER_ALG või MUUTMISE_AEG >MUUT_PER_LOP , siis
neid ajaloo tabeli ridu ei valita v.a. siis kui nad oleksid A,T või P puhul nagunii valituks
osutunud. Kõik teised read valitakse vastusesse.
PEATAMINE ja PEATAMISE_AJALUGU tabelist valitakse alati kõik read, mis on seotud
eespool valitud töötamise kannetega.
Ettevõtluskonto andmed
kande olek – Kehtiv, Tulevikus, Lõpetatud
-kui EV konto alguskuupäev on olevikus VÕI minevikus ja lõppkuupäev puudub VÕI on
olevikus VÕI tulevikus, siis olek on Kehtiv;
-kui alguskuupäev on tulevikus, siis olek on Tulevikus;
-kui lõppkuupäev on minevikus siis olek on Lõpetatud.
Tööinspektsioon Tervise ja Heaolu Maksu- ja Tolliamet
Infosüsteemide
Keskus
/allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/
Maret Maripuu Katrin Reinhold Anne Leisner
Lisa 2
Töötamise registri TORIK X-tee masspäringu kirjeldus
Teenuse tehniline nimi on „UploadMime“ „DownloadMime“
uploadMime
< request>
<target>TOR_MASS</target>
<operation>torik</operation>
<file href="cid:5f2ae6b558a015e9b97abc658cf3c204"/>
<props>
<prop key="UPLOAD_ID">d5c93252-bc57-4e6b-9a99-2dff26126727</prop>
</props>
</request>
downloadMime
< request>
<target>TOR_MASS</target>
</request>
uploadMime ja downloadMime teenuse kohta saab lugeda täpsemalt MTA veebilehel
aadressidel:
https://www.emta.ee/sites/default/files/ariklient/tulu-kulu-kaive-
kasum/maksudeklaratsioonid/tsd-esd-ja-toendid/2018/xtee-emtav6-uploadmime.pdf
https://www.emta.ee/sites/default/files/ariklient/tulu-kulu-kaive-
kasum/maksudeklaratsioonid/tsd-esd-ja-toendid/2018/xtee-emtav6-downloadmime.pdf
Tööinspektsioon Tervise ja Heaolu Maksu- ja Tolliamet
Infosüsteemide
Keskus
/allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/
Maret Maripuu Katrin Reinhold Anne Leisner
Lisa 3
Töötamise registri päring registrikoodi järgi TORRGNO
TI-l on õigus pärida infot iga tööd võimaldava isiku töötamiste kohta välja arvatud
Siseministeeriumi ja Kaitseministeeriumi haldusalas olevate töötajate kohta.
Päringu sisend:
paringu_liik (xsd:string[1]) - Liik määrab, millist infot küsitakse (A/T/P/AM/TM/PM)
A – Tänase seisuga aktiivsed kanded etteantud isikute kohta. Perioodi ei ole vaja ette anda.
T - Tänase seisuga kõik töötamise kanded etteantud isikute kohta, ka lõpetatud
kanded.Perioodi ei ole vaja ette anda.
P - Töötamisperioodil aktiivsed kanded etteantud isikute kohta (töötamisperioodi sisestamine
kohustuslik). Vastuseks need, kes töötamisperioodi jooksul töötasid vähemalt 1 päeva.
Praegu võivad olla ka lõpetanud seisus.
toot_ algus (xsd:date[0…1]) - Töötamisperioodi algus (aaaa-kk-pp)
toot_ lopp (xsd:date[0…1]) - Töötamisperioodi lõpp (aaaa-kk-pp)
tvoim_id (xsd:string [1])– äriregistri kood või IK , kelle töötamiste kohta andmeid küsitakse
alates_kandest (xsd:integer) – alates mitmendast kandest soovime vastussõnumis kandeid
näha (esimesel küsimisel panna alati 1)
Päringu vastus:
kood (xsd:integer[1]) – päringu töötlemise tulemuse kood
0 - päring oli OK
50 - vigane päring
100 – vastuseks liiga palju ridu
leitud_kannete_üldarv (xsd:integer[1]) – päringu vastuseks saadud kannete koguarv selle
tööandja juures
alates_kandest (xsd:integer) – selles päringus vastuseks saadetud esimese kande
järjekorranumber leitud kannete hulgas (sama mida sisendsõnumis küsiti)
kuni_kandeni (xsd:integer) – selles päringus vastuseks saadetud viimase kande
järjekorranumber leitud kannete hulgas
kannete_jada (xsd:element [0…1])
kanne (xsd:string [0..1000])– - iga töötamise kohta leitud kõik kanded sisaldavad järgmisi
välju:
toot_id (xsd:integer[1]) - Töötamise kande ID TÖR-s
isikukood (xsd:string[1]) – töötava isiku isikukood RR andmete alusel;
synniaeg (xsd:date[1]) – töötava isiku sünniaeg kui IK ei ole (aaaa-kk-pp);
perenimi (xsd:string[1]) – Töötaja nimi RR andmete alusel või SYNN_ISIK tabelist kui IK ei
ole;
eesnimi (xsd:string[1]) – Töötaja nimi RR andmete alusel või SYNN_ISIK tabelist kui IK ei
ole;
kodakondsus_kood (xsd:string[1]) – Töötaja kodakondsuse ISO 3166-1 kood RR alusel;
kodakondsus_nimi (xsd:string[1]) – Töötaja kodakondsuse riigi nimi;
ta_kood (xsd:string[1]) – Tööd võimaldava isiku identifikaator (isikukood või äriregistri kood);
ta_nimi(xsd:string[1]) - Tööd võimaldava isiku nimetus;
tegeliku_ta_kood (xsd:string[1]) – Tegeliku tööd võimaldava isiku identifikaator (isikukood või
äriregistri kood) - kasutavad 2 ministeeriumi, võib täita peale töösuhte lõppu;
tegeliku_ta_nimi(xsd:string[1]) - Tegeliku tööd võimaldava isiku nimetus;
tootamise_algus (xsd:date[1]) – tööle asumise aeg (aaaa-kk-pp);
tootamise_liik_kood (xsd:string [1]) – töötamise liigi kood TÖR klassifikaatorist
tootamise_liik_nimi (xsd:string [1]) – töötamise liigi nimetus TÖR klassifikaatorist;
tooaja_maar (xsd:decimal [0...1]) – tööaja määr;
leping (xsd:string [1]) – Samaaegsete samaliigiliste lepingute eristamiseks, vaba tekst;
tootamise_lopp (xsd:date[1]) – töötamise lõpetamise aeg (aaaa-kk-pp);
tootamise_lopetamise_alus_kood (xsd:string [1]) – lõpetamise aluse kood TLP
klassifikaatorist
tootamise_lopetamise_alus_nimi (xsd:string [1]) – lõpetamise aluse nimetus TLP
klassifikaatorist
amet_kood (xsd:string [1]) – ameti kood Statistika klassifikaatorist (väli
TOOTAMINE.AMETI_KOOD)
amet_nimi (xsd:string [1]) – ameti nimetus Statistika klassifikaatorist (välja
TOOTAMINE.AMETI_KOOD järgi väli AMET.NIMETUS_EST)
amet_vabatekstina (xsd:string [1]) - käsitsi sisestatud ametinimetus vabatekstina (väli
TOOTAMINE.AMET_VABATEKSTINA)
amet_kommentaar (xsd:string [1]) - tööülesannete kirjeldus vabatekstina (väli
TOOTAMINE.AMET_KOMMENTAAR)
koht_id (xsd:integer [1]) - Töötamise asukoha aadressi ID –
(http://xgis.maaamet.ee/adsavalik/ads) (väli TOOTAMINE.ADS_ADR_ID)
koht (xsd:string [1]) - Töötamise asukoht (töö asukoha aadress) ADS järgi (väli
TOOTAMINE.ADS_AADRESS_TEKSTINA)
aadress_vabatekstina (xsd:string[1]) - ADS aadressi vabatekstiline täpsustus (väli
TOOTAMINE.AADRESS_VABATEKSTINA)
riigi_kood – Töötamise asukoha riik väljalt TOOTAMINE.RIIGI_KOOD;
peatamiste_jada (xsd:string [0..unbounded]) - selle töötamise kohta registreeritud
peatamised
peatamine (xsd:string [0..20]) – Iga peatamise kohta leitud kõik kanded sisaldavad järgmisi
välju:
peat_id(xsd:integer[1]) - Peatamise ID tabelist PEAT;
peat_algus (xsd:date[1]) – töötamise peatamise alguse kuupäev (aaaa-kk-pp);
peat_alus_kood (xsd:string [1]) – töötamise peatamise aluse kood peatamise aluste
klassifikaatorist;
peat_alus_nimi (xsd:string [1]) – töötamise peatamise aluse nimetus peatamise aluste
klassifikaatorist;
peat_lopp(xsd:date[1]) – töötamise peatamise lõpu kuupäev (aaaa-kk-pp);
peat_ehk_aeg (xsd:datetime [1]) – Viimati EHK-sse saadetud peatamise sõnumi
saatmise_aeg tabelist PEAT_EHK (aaaa-kk-ppTtt:mi:ss);
kande_olek_kood (xsd:string [1])– kande oleku kood TÖR klassifikaatorist;
kande_olek_nimi (xsd:string [1])– kande oleku nimetus TÖR klassifikaatorist;
ta_markus(xsd:string [0…1]) – vaba teksti väli TA märkuste jaoks;
mta_markus (xsd:string [0…1]) – Ametniku märkus;
rka_marge - RKA märge (tühi, kui TOOTAMINE.RKA_MARGE väärtus on 0/null; muudel
juhtudel TOOTAMINE.RKA_MARGE väljal olev väärtus)
algkp_otsuse_liik_kood (xsd:string [1]) - Algkuupäeva kohta tehtud otsuse liigi kood
klassifikaatorist;
algkp_otsuse_liik_nimi (xsd:string [1]) - Algkuupäeva kohta tehtud otsuse liigi nimetus
klassifikaatorist;
algkp_otsus (xsd:string [1]) – lisaväli TVK/Kohtu otsuse numbri jaoks (alguse kuup kohta);
tootliik_otsuse_liik_kood(xsd:string [1]) - Töötamise liigi kohta tehtud otsuse liigi kood
klassifikaatorist;
tootliik_otsuse_liik_nimi (xsd:string [1]) - Töötamise liigi kohta tehtud otsuse liigi nimetus
klassifikaatorist;
tootliik_otsus (xsd:string [1]) – lisaväli TVK/ Kohtu otsuse numbri jaoks (töötamise liigi kohta);
loppkp_otsuse_liik_kood (xsd:string [1]) – Lõpu kuupäeva kohta tehtud otsuse liigi kood
klassifikaatorist;
loppkp_otsuse_liik_nimi (xsd:string [1]) – Lõpu kuupäeva kohta tehtud otsuse liigi nimetus
klassifikaatorist;
loppkp_otsus (xsd:string [1]) – lisaväli TVK/ Kohtu otsuse numbri jaoks (lõpu kuup kohta);
lopalus_otsuse_liik_kood (xsd:string [1]) – Lõpetamise aluse kohta tehud otsuse liigi kood
klassifikaatorist;
lopalus_otsuse_liik_nimi (xsd:string [1]) – Lõpetamise aluse kohta tehud otsuse liigi nimetus
klassifikaatorist;
lopalus_otsus (xsd:string [1]) – lisaväli TVK/ Kohtu otsuse numbri jaoks (lõpetamise aluse
kohta);
sisestamise_aeg (xsd:datetime [1]) (aaaa-kk-ppTtt:mi:ss);
muutmise_aeg (xsd:datetime [1]) (aaaa-kk-ppTtt:mi:ss);
reg_tel_nr (xsd:string [1]) –lihtsustatud registreerimisel (SMS kaudu või helistamise teel )
telefoni number, millelt registreerimine tehti;
toot_ehk_aeg(xsd:datetime [1]) – Viimati EHK-sse saadetud töötamise sõnumi saatmise_aeg
tabelist TOOT_EHK (aaaa-kk-ppTtt:mi:ss);
toot_ehk_sonumi_liik (xsd:string [1]) – (K/L/I) - kas viimati saadetud töötamise sõnum oli
alustamise või lõpetamise sõnum või lõpetamise muutmise sõnum.
Tagastatavad teated
0 Päring oli korrektne
50 Viga päringu töötlemisel
51 Päringus puuduvad sisendandmed
52 Ei leitud ühtegi tulemust
53 Puuduvad õigused salastatud tööandja kohta andmeid pärida
57 Sisendandmetes puudub päringu tüüp
58 Päringusse pole sisestatud kõiki vajaminevaid andmeid
59 Päringu tüübil "P" puudub algus või lõpukuupäev
62 Sisendandmetes puudub tööandja kood
63 Päringu tüüp ei ole korrektne
67 Tööandjal puuduvad õigused
70 Üldine viga, andmete laadimine andmebaasist ebaõnnestus
71 Üldine viga, süsteemiparameetri laadimine andmebaasist ebaõnnestus
72 "Alates_kandest" peab olema > 0
73 "Alates_kandest" on suurem kogu kannete arvust
100 Sõnumi vastus sisaldab liiga palju kirjeid
Tööinspektsioon Tervise ja Heaolu Maksu- ja Tolliamet
Infosüsteemide
Keskus
/allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/
Maret Maripuu Katrin Reinhold Anne Leisner
Lisa 4
TOOTREG_AMETNIK teenuse kirjeldus
Sisendsõnumite kirjeldus:
tootregRequestType elemendid:
kanne_jada (xsd:element[1]) – loetelu töötamise kannetest:
item (xsd:string[1..80]) – iga töötamise kanne/kirje sisaldab järgmisi välju:
toot_id (xsd:integer[0…1]) – (M ja T tüüpi kannete puhul kohustuslik, R puhul tühi);
kande_tyyp (xsd:string[1]) – kande tüüp(Kohustuslik)
R – esmane reg-ne
M – kande muutmine (k.a. lõpetamine ja peatamine)
T – kande tühistamine
kande_aeg (xsd:datetime[1]) – (Kohustuslik) kande sisestamise/muutmise aeg
andmeedastaja juures (aaaa-kk-ppTtt:mi:ss.sss);
isikukood (xsd:string[0…1]) – töötava isiku isikukood RR andmete alusel;
tootaja_synniaeg (xsd:date[0…1]) – kui IK ei ole, siis sünniaeg (aaaa-kk-pp);
tootaja_perenimi (xsd:string[0…1]) – kui IK ei ole, siis sisestada lisaks sünniajale ka töötaja
perenimi;
tootaja_eesnimi (xsd:string[0…1]) – kui IK ei ole, siis sisestada lisaks sünniajale ka töötaja
eesnimi;
tegeliku_tooandja_kood (xsd:string[0…1]) – tööandja identifikaator (äriregistri kood) –see väli
on kasutusel ainult valitud ministeeriumides, võib täita alles töötamise lõpetamise hetkel;
tootamise_algus (xsd:date[0…1]) – tööle asumise aeg või VÕS puhul lepingu jõustumise
aeg, R tüüpi kandes kohustuslik (aaaa-kk-pp);
tootamise_liik (xsd:integer[0…1]) – töötamise liigi kood TÖR klassifikaatorist (vajalik täieliku
kande tegemiseks);
leping (xsd:string[0…1]) - mitme samaaegselt algava samaliigilise töötamise puhul
identifitseerib kande üheselt;
ameti_kood (xsd:integer[0…1]) – ameti kood Statistikaameti Ametite klassifikaatorist;
tootamise_asukoha_aadressi_ID (xsd:integer[0…1]) -
(http://xgis.maaamet.ee/adsavalik/ads);
tootamise_lopp (xsd:date[0…1]) – töötamise lõpetamise aeg (aaaa-kk-pp);
tootamise_lopetamise_aluse_kood (xsd:integer[0…1]) – kood TLP klassifikaatorist;
peatamise_perioodi_algus (xsd:date[0…1]) – töötamise peatamise alguse kuupäev (aaaa-kk-
pp);
esmane_peatamise_algus (xsd:date[0…1]) - kasutatakse peatamise kande
identifitseerimiseks, kui peatamise algust, alust või lõppu tahetakse muuta (aaaa-kk-pp);
peatamise_aluse_kood (xsd:integer[0…1]) – töötamise peatamise alus klassifikaatorist;
peatamise_perioodi_lopp (xsd:date[0…1]) – töötamise peatamise lõpu kuupäev (aaaa-kk-
pp);
tvoim_markus (xsd:string[0..1]) – koht tööd võimaldavale isikule märkuste tegemiseks kande
kohta;
tootregAmetnikRequestType – järgnevad elemendid on lisaks tootregRequestType-s
kirjeldatud elementidele kasutatavad ainult sõnumis TOOTREG_AMETNIK.
mta_markus (xsd:string[0..1]) - Tööinspektsiooni vm. ametniku jaoks;
algkp_otsuseliik_kood (xsd:string[0..1]) – klassifikaatorist OTSUSE_LIIK alguskuupäeva
kohta tehtud otsuse liigi kood, tööd võimaldav isik ei täida;
otsus_algkp (xsd:string[0..1]) – lisaväli TVK/Kohtu otsuse numbri jaoks, tööd võimaldav isik
ei täida;
tliik_otsuseliik_kood (xsd:string[0..1]) – klassifikaatorist OTSUSE_LIIK töötamise liigi kohta
tehtud otsuse liigi kood, tööd võimaldav isik ei täida;
otsus_tliik (xsd:string[0..1]) – lisaväli TVK/ Kohtu otsuse numbri jaoks, tööd võimaldav isik ei
täida;
loppkp_otsuseliik_kood (xsd:string[0..1]) – klassifikaatorist OTSUSE_LIIK lõpu kuupäeva
kohta tehtud otsuse liigi kood, tööd võimaldav isik ei täida;
otsus_loppkp (xsd:string[0..1]) – lisaväli TVK/ Kohtu otsuse numbri jaoks, tööd võimaldav isik
ei täida;
lopalus_otsuseliik_kood (xsd:string[0..1]) – klassifikaatorist OTSUSE_LIIK lõpetamise aluse
kohta tehtud otsuse liigi kood, tööd võimaldav isik ei täida;
otsus_lopalus (xsd:string[0..1]) – lisaväli TVK/ Kohtu otsuse numbri jaoks, tööd võimaldav
isik ei täida.
Vastussõnumi kirjeldus
Vastussõnumis saadetakse tagasi kõik edukad registreerimiskanded (R) koos kandele
omistatud TÖR ID-ga. Muutmiskannete ja tühistamiste kohta saadetakse ainult veateated.
kood (xsd:integer[1]) – sõnumi töötlemise kood
teade (xsd:string[0..1]) – sõnumi töötlemise tulemuse teade
ok_ kannete_arv (xsd:integer[1]) – korrektselt töödeldud kannete arv;
vigaste_kannete_arv (xsd:integer[1]) – töötlemisel vea saanud kannete arv;
korrektsed_kanded (xsd:element [ 1]) – info TÖR-i registreeritud kannete kohta (saadetud R
kannete kohta)
item (xsd:string [1..80])– korrektne kanne/kirje
toot_id (xsd:integer[0…1]) – kande ID TÖR-s
kande_tyyp (xsd:string[1]) – kande tüüp R - siin on ainult esmase reg-se kanded
kande_aeg (xsd:datetime[1]) – kande sisestamise/muutmise aeg andmeedastaja juures
(pp.kk.aaaaTtt:mi:ss.sss)
isikukood (xsd:string[0…1]) – töötava isiku isikukood RR andmete alusel;
tootaja_synniaeg (xsd:date[0…1]) – kui IK ei ole, siis sünniaeg (aaaa-kk-pp);
tootaja perenimi (xsd:string[0…1]) – kui IK ei ole, siis sisestada lisaks sünniajale ka
tootaja_perenimi;
tootaja_eesnimi (xsd:string[0…1]) – kui IK ei ole, siis sisestada lisaks sünniajale ka töötaja
eesnimi;
tootamise_algus (xsd:date[1]) – tööle asumise aeg või VÕS puhul lepingu jõustumise aeg
(aaaa-kk-pp);
tootamise_liik (xsd:integer[0…1]) – töötamise liigi kood;
leping – samaaegseid samaliigilisi lepinguid identifitseeriv väli
vigased_kanded (xsd:element[1]) – töötlemisel tekkinud teated: informatiivsed, ja vead;
item (xsd:string [1..80])– vigane kanne/kirje sisaldab järgmisi välju (samad väljad mis
sisendsõnumis):
kande_tyyp (xsd:string[1]) – kande tüüp
R - esmane reg-ne
M - kande muutmine (k.a. lõpetamine)
T - kande tühistamine
kande_aeg (xsd:datetime[1]) – kande sisestamise/muutmise aeg andmeedastaja juures
(aaaa-kk-ppTtt:mi:ss.sss);
toot_id (xsd:integer[0…1]) – (M ja T tüüpi kannete puhul kohustuslik, R puhul tühi);
isikukood (xsd:string[0…1]) – töötava isiku isikukood RR andmete alusel;
tootaja_synniaeg (xsd:date[0…1]) – kui IK ei ole, siis sünniaeg (aaaa-kk-pp);
tootaja_perenimi (xsd:string[0…1]) – kui IK ei ole, siis sisestada lisaks sünniajale ka töötaja
perenimi;
tootaja_eesnimi (xsd:string[0…1]) – kui IK ei ole, siis sisestada lisaks sünniajale ka töötaja
eesnimi;
tegeliku_tooandja_kood (xsd:string[0…1]) – tööandja identifikaator (äriregistri kood) –see väli
on kasutusel ainult valitud ministeeriumides, võib täita töötamise lõpetamise hetkel;
tootamise_algus (xsd:date[0…1]) – tööle asumise aeg või VÕS puhul lepingu jõustumise
aeg, R tüüpi kandes kohustuslik (aaaa-kk-pp);
tootamise_liik (xsd:integer[0…1]) – töötamise liigi kood TÖR klassifikaatorist (täieliku kande
tegemiseks vajalik);
leping (xsd:string[0…1]) - mitme samaaegselt algava samaliigilise töötamise puhul
identifitseerib kande üheselt;
ameti_kood (xsd:integer[0…1]) – ameti kood Statistikaameti Ametite klassifikaatorist;
tootamise_asukoha_aadressi_ID (xsd:integer[0…1]) –
(http://xgis.maaamet.ee/adsavalik/ads);
tootamise_lopp (xsd:date[0…1]) – töötamise lõpetamise aeg (aaaa-kk-pp);
tootamise_ lopetamise_ aluse_kood (xsd:integer[0…1]) – lõpetamise kood TLP
klassifikaatorist;
peatamise_perioodi_algus (xsd:date[0…1]) – töötamise peatamise alguse kuupäev (aaaa-kk-
pp);
esmane_peatamise_algus (xsd:date[0…1]) - kasutatakse peatamise kande
identifitseerimiseks, kui peatamise algust, alust või lõppu tahetakse muuta (aaaa-kk-pp);
peatamise_aluse_kood (xsd:integer[0…1]) – töötamise peatamise alus –klassifikaatorist;
peatamise_perioodi_lopp (xsd:date[0…1]) – töötamise peatamise lõpu kuupäev (aaaa-kk-
pp);
tvoim_markus (xsd:string[0..1]) – koht tööd võimaldavale isikule märkuste tegemiseks kande
kohta;
mta_markus (xsd:string[0..1]) -. ametniku jaoks;
algkp_otsuseliik_kood (xsd:integer[0…1]) – klassifikaatorist OTSUSE_LIIK alguskuupäeva
kohta tehtud otsuse liigi kood, tööd võimaldav isik ei täida;
otsus_algkp (xsd:string[0..1]) – lisaväli TVK/Kohtu otsuse numbri jaoks, tööd võimaldav isik
ei täida;
tliik_otsuseliik_kood – klassifikaatorist OTSUSE_LIIK töötamise liigi kohta tehtud otsuse liigi
kood, tööd võimaldav isik ei täida;
otsus_tliik (xsd:string[0..1]) – lisaväli TVK/ Kohtu otsuse numbri jaoks, tööd võimaldav isik ei
täida;
loppkp_otsuseliik_kood – klassifikaatorist OTSUSE_LIIK lõpu kuupäeva kohta tehtud otsuse
liigi kood, tööd võimaldav isik ei täida;
otsus_loppkp (xsd:string[0..1]) – lisaväli TVK/ Kohtu otsuse numbri jaoks, tööd võimaldav isik
ei täida;
lopalus_otsuseliik_kood (xsd:integer[0…1]) – klassifikaatorist OTSUSE_LIIK Lõpetamise
aluse kohta tehtud otsuse liigi kood, tööd võimaldav isik ei täida;
otsus_lopalus (xsd:string[0..1]) – lisaväli TVK/ Kohtu otsuse numbri jaoks, tööd võimaldav
isik ei täida.
vigade_jada_kande_kohta (xsd:element [1]) – loetelu teadetest antud kande kohta:
item (xsd:string [1..unbounded]) – teate kirjeldus:
tyyp (xsd:string[1]) – teate tüüp.
Vead – E
Hoiatused – W
element_name (xsd:string[0..1]) – vigase välja tunnus/viide;
kood (xsd:string[1]) – teate kood;
kirjeldus (xsd:string[1]) – teate kirjeldus.
Reeglid
Masin-masin (M-M) liides on mõeldud vähemalt ühe töötamise registreerimise või muutmise
kande edastamiseks MTA-le TÖR jaoks. Sisse tulnud TOOTREG sõnumi lahti parsimise järel
saadakse täpselt sama kujuga objekt nagu TÖR-s andmete failist sisse lugemisel ja
töödeldakse ka sama mooduliga. Sõnumi read tuleb järjestada ja töödelda sõnumis oleva
kande tegemise aja järgi kasvavalt, et varasemad muudatused saaksid tehtud enne kui
hilisemad.
Sisendsõnum
TÖR-i saadetavate kannete töötlemise järjekord sõltub väljast kande_aeg (kohustuslik) –
ühes sõnumis olevad kanded töödeldakse selle välja ajalises järjekorras. Sellepärast peaks
välja sisuna kasutama personalisüsteemis teostatud muudatuse aega, mitte sõnumi
edastamise aega. Kui sama töötamist puudutavad kanded on ka sama kellaajaga, siis
töödeldakse nad sõnumis esinemise järjekorras. Peatamise kuupäevade ja aluse muutmine
M-M liidese/faili kaudu nõuab esialgse peatamise alguse kuupäeva etteandmist, et selle
alusel saaks identifitseerida, millist peatamise kannet tahetakse muuta. Kohustuslik on R
tüüpi kande puhul täita kas Isikukood või siis väljad Eesnimi, Perenimi ja Sünniaeg. X-tee
sõnumi kaudu peatamise tühistamise käskluse andmiseks tuleb saata T (tühistamise) liigiga
sõnum, milles peab olema näidatud: TOOT_ID; "peatamise esmane alguskuupäev" (mis
tähendab tühistatava peatamise parajasti kehtivat alguskuupäeva). TOOTREG_AMETNIK
sisendsõnumis peab olema näidatud tööandja, kelle kohta kannet tehakse
(representedParty/partyCode).
Vastussõnum
Vastus annab M-M sõnumi saatjale teada, kas õnnestus kõikide kannete
sisestamine/muutmine või esines vigu või puuduseid (pluss veateated kannete kaupa koos
välja nimega, millega see viga seotud oli).
Registreerimiskannete puhul saadetakse tagasi ka õnnestunud kannete TÖR ID-d.
Kood Teade Kirjeldus
0 Andmed MTA-sse edukalt edastatud Dokument on edukalt kogu ulatuses
töödeldud. Kõik OK. Kui mõne kande
töötlemisel tekkis informatiivne teade, siis
need on esitatud kannete kaupa vastuses
vigade_jada elemendis.
5 Andmed MTA-sse edukalt edastatud, Kõik dokumendi kanded on edukalt
kuid tekkisid hoiatused. töödeldud, kuid vähemalt ühe kande puhul
tekkisid teated, mis võivad viidata
sisulistele probleemidele isiku
registreerimises. Teated on esitatud
kannete kaupa vastuses vigade_jada
elemendis.
10 Esitatud andmetes olid vead, kontrolli Dokumendi töötlemisel esines vähemalt
andmeid! ühe kande töötlemisel viga, mis ei
võimaldanud vea saanud kannet TÖRi
kanda. Vea, hoiatuse või informatiivse
teatisega kanded on esitatud kannete
kaupa vastuses vigade_jada elemendis.
110 Kande aeg on puudu Vähemalt ühel kandel puudus kande
saatmise/koostamise aeg.
150 Andmeedastajat ei ole MTA registris Andmeedastajat (määratud päringu
päises) ei ole MTA ISIKUD tabelis.
Tuleks pöörduda MTA poole, et selgitada
välja, miks andmeedastajat süsteemis ei
ole. Kõik esitatud kanded on töötlema
155 Saatja IK ei ole olemas Saatja IK ei ole ISIKUD tabelis olemas.
Kõik esitatud kanded on töötlemata.
160 Viga TÖR registris Kannete töötlemisel registris tekkis tõrge.
Kõik esitatud kanded on töötlemata. Klient
võiks edastamist korrata.
170 Päring aegus töötlemise käigus Kannete töötlemine võttis oodatust rohkem
aega. Palume päringut korrata ja
võimalusel kannete arvu vähendada.
Tuleb eeldada, et kõik kanded said
töötlemise käigus vea ning uuesti saata.
180 Viga adapterserveris(probleem vastendustes)Tõrge adapterserveri töös. Tasub
Palun kontrollige esitatud andmete formaati. kontrollida päringu formaalset korrektsust.
Kõik kanded on töötlemata.
280 Sõnum ei sisaldanud ühtegi kannet Registrisse esitati tühi sõnum. Tasub
kontrollida sõnumi formaalset korrektsust.
290 Sõnum sisaldab liiga palju kandeid Registrisse esitatud sõnumis oli liiga palju
(max arv on parameetri kandeid (üle max lubatava kannete arvu)
SISENDSONUMI_MAX_KIRJETE_ARV) mistõttu võib eeldada, et sõnum enne
töötlemise lõppu aegub ning töötlemise
tulemuse tagasi saatmine võib osutuda
võimatuks. Kõik kanded on töötlemata ning
tuleb uuesti esitada.
Kande valideerimise vead
300 Kandes puudub töötaja isikukood.
301 Kandes puudub töötaja sünniaeg.
302 Kandes puudub töötaja eesnimi.
303 Kandes puudub töötaja perekonnanimi.
304 Kandes puudub töötamise liik.
305 Kandes puudub töötamise algusaeg.
306 Kandes puudub töötamise lõpu aeg.
307 Kandes puudub töötamise lõpetamise alus.
308 Kandes puudub peatamise alus.
309 Kandes puudub töötamine.
310 Kandes puudub töötamise ID.
311 Kandes puudub telefoninumber.
312 Kandes puudub tööd võimaldava isiku kood.
500 TÖR-is on selline kanne juba olemas. Kui on tegemist mitme samaaegse ja sama
tüüpi lepinguga, siis tuleb iga lepingu identifitseerimiseks sisestada LEPING välja kas lepingu
number, töötaja amet või VÕS puhul lepingu objekt.
Sõnumiga teise täpselt samasuguse kande avamise katsel antakse vea teade
vastussõnumis.
501 Kande tüüp ei ole R/M/T
502 T või M kande puhul ei leita eelnevalt registreeritud kannet TÖR ID alusel.
503 R kande puhul IK ja sünniaeg mõlemad tühjad
504 Sünniajaga kandel puudub töötaja nimi
505 Töötaja IK ei ole kehtiv
506 Tööd võimaldava isiku kood ei ole registreeritud
507 Saatjaks on RTK aga TA ei ole riigiasutus (kood ei alga 7-ga)
508 Töötamise alguse kuupäev on rohkem kui 3 kuud tagasi või puudub
509 Töötamise liigi kood vale või puudub
510 Ameti kood on vale
511 Töökoha aadressi kood on vale
512 Töötamise lõpu kuupäev on rohkem kui 3 kuud tagasi
513 Töötamise lõpetamise aluse kood on vale
514 Töötamise lõpetamise kuupäev ja töötamise lõpetamise alus peavad olema
samaaegselt täidetud
515 Peatamise alguse aeg on rohkem kui 3 kuud tagasi
516 Peatamise aluse kood on vale
517 Peatamise alguse kuupäev ja peatamise alus peavad olema samaaegselt täidetud
518 Peatamise lõpu kuupäev on rohkem kui 3 kuud tagasi
519 Ei saa peatamist lõpetada kui seda ei ole alustatud
520 Ei saa alustada uut peatamist kui eelmine ei ole lõpetatud
521 Kahe peatamise perioodid kattuvad
522 Tegelikku tööd võimaldavat isikut ei tohi antud juhul sisestada
523 Töötamise alguupäeva otsuse kood on vale.
524 Töötamise lõpu kuupäeva otsuse kood on vale.
525 Töötamise liigi otsuse kood on vale.
526 Töötamise lõpetamise aluse otsuse kood on vale.
527 Muutmisel või lõpetamisel on Töötaja kande ID puudu.
528 Tegeliku Tööandja koodi sisetamisel kontrolli kande tüübi õigsust ja lõppkuupäeva
olemasolu.
529 Tööd võimaldaval isikul puuduvad õigused kande muutmiseks.
530 Kandel ei ole lubatud isikukoodi muuta.
600 {0} peab olema määratud
601 Määratud koodiga tööd võimaldav isik puudub
602 Tööd võimaldav isik on surnud. Kannet võib teha vastutav ametnik.
603 Tööd võimaldav isik on likvideeritud. Kannet võib teha vastutav ametnik.
604 Määratud koodiga isik puudub
605 Määratud koodiga isik on surnud
606 Määratud koodiga isik ei saa endale töötamist luua
607 Kontrolli eesnime!
608 Kontrolli perenime!
609 Viga Rahvastikuregistri teenuse väljakutsel
610 Märkuses on lubatud ainult Eesti-Ladina tähed, numbrid, ning sümbolid . , : ; - ( ) /
611 Ametniku märkuses on lubatud ainult Eesti-Ladina tähed, numbrid, ning
sümbolid . , : ; - ( ) /
612 Lubatud sümbolid on ainult numbrid 0-9
613 Alguskuupäeva väljas lubamatud sümbolid
614 Töötamise liigi väli võib sisaldada ainult Eesti-Ladina tähti, numbreid, ning sümboleid
.,:;-()/
615 Lõppkuupäeva väljas lubamatud sümbolid
616 Lõpetamise aluse väli võib sisaldada ainult Eesti-Ladina tähti, numbreid, ning
sümboleid . , : ; - ( ) /
617 Lepingu väli võib sisaldada ainult Eesti-Ladina tähti, numbreid, ning sümboleid . , : ; -
()/
618 Töötamise alguskuupäev vale. Peab olema hilisem kui jooksev kuupäev -110 aastat.
619 Töötamise alguskuupäev vale. Peab olema varasem kui jooksev kuupäev.
620 Kontrolli sünnikuupäeva!
621 Kontrolli sünnikuupäeva!
622 Alguskuupäev peab olema hilisem kui {0}
623 Alguskuupäev peab olema varasem kui {0}
624 Lõppkuupäev peab olema hilisem kui {0}
625 Lõppkuupäev peab olema varasem kui {0}
626 Töötamise lõppkuupäev on võrreldes isiku sünniajaga lubamatult suur
627 Lõppkuupäev ei saa olla hilisem kui {0}
628 Lõppkuupäev ei või olla varasem kui alguskuupäev
629 Lõppkuupäev ei saa olla hilisem kui {0}
630 Lõppemise aeg peab olema määratud kui on määratud lõpetamise alus
631 Lõpetamise alus peab olema määratud kui on määratud lõpetamise aeg
632 Töötamise lõpp ja alus peavad olema määratud
633 Antud lõpetamise alust ei saa valida määratud töötamise liigi korral
635 Töötamise registreerimisel lubatud suhe ainult ühe töötajaga
636 Alguskuupäev ei saa olla peatamise algusest hilisem
637 Töötamise peatamiseks peab kanne olema täielik
638 Töötamise peatamiseks peab kanne olema kehtiv
639 Töötamise peatamise muutmiseks peab kanne olema kehtiv, peatatud või lõpetatud
640 Töötamise peatamiseks peab olema määratud töötamise liik
641 Leidub tulevikus algav peatamine
642 Leidub mitu tulevikus algavat peatamist
643 Peatamise algus peab olema hilisem kui töötamise algus
644 Peatamise algus peab olema varasem kui töötamise lõpp
645 Peatamise lõpp peab olema hilisem kui peatamise algus
646 Peatamise lõpp peab olema varasem või sama kui töötamise lõpp
647 Samal ajal on juba registreeritud peatamine
648 Samal ajal on juba registreeritud peatamine
649 Samal ajal on juba registreeritud peatamine
650 Puuduvad tegevuseks vajalikud õigused
654 Lõpetatud kannet ei saa lõpetada
655 Tühistatud kannet ei saa muuta
656 Alguskuupäeva väli on lukus
657 Lõppkuupäeva väli on lukus
658 Lõpetamise aluse väli on lukus
659 Töötamise liigi väli on lukus
660 Tööd võimaldava isiku muutmine ei ole lubatud
661 Tööd võimaldava isiku muutmine ei ole lubatud
662 Töövõtja muutmine ei ole lubatud
663 Töövõtja muutmine ei ole lubatud
664 Töövõtja muutmine ei ole lubatud
665 Töötamise alguskuupäeva muutmine ei ole lubatud
666 Töö liigi muutmine ei ole lubatud
667 Töötamise lõpukuupäeva muutmine ei ole lubatud
668 Töötamise lõpetamise aluse muutmine ei ole lubatud
669 Lepingu muutmine ei ole lubatud
670 Ameti muutmine ei ole lubatud
671 Aadressi muutmine ei ole lubatud
672 Töötamise alguskuupäeva otsuse muutmine ei ole lubatud
673 Töötamise liigi otsuse muutmine ei ole lubatud
674 Töötamise lõpukuupäeva otsuse muutmine ei ole lubatud
675 Töötamise lõpetamise aluse muutmine ei ole lubatud
676 Tegeliku tööandja muutmine ei ole lubatud
677 Märkuse muutmine ei ole lubatud
678 Ametniku märkuse muutmine ei ole lubatud
679 Peatamist saab muuta {0} kuu jooksul töötamise lõpu kuupäevast
680 Peatamise alguse kuupäeva saab muuta {0} kuu jooksul esmasest peatamise
alguskuupäevast
681 Peatamise alust saab muuta {0} kuu jooksul esmasest peatamise alguskuupäevast
682 Peatamise lõpu kuupäeva saab muuta {0} kuu jooksul peatamise lõpu kuupäevast
683 Kannet saab tühistada {0} kuu jooksul esmasest töötamise alguse kuupäevast
684 Alguskuupäeva otsuse liik peab olema määratud, kui on määratud alguskuupäeva
otsus
685 Alguskuupäeva otsus peab olema määratud, kui on määratud alguskuupäeva otsuse
liik
686 Töötamise liigi otsuse liik peab olema määratud, kui on määratud töötamise liigi otsus
687 Töötamise liigi otsus peab olema määratud, kui on määratud töötamise liigi otsuse liik
688 Lõppkuupäeva otsuse liik peab olema määratud, kui on määratud lõppkuupäeva
otsus
689 Lõppkuupäeva otsus peab olema määratud, kui on määratud lõppkuupäeva otsuse
liik
690 Lõpetamise aluse otsuse liik peab olema määratud, kui on määratud lõpetamise
aluse otsus
691 Lõpetamise aluse otsus peab olema määratud, kui on määratud lõpetamise aluse
otsuse liik
692 Kandes antud peatamise esmasele alguskuupäevale vastavat kirjet ei leitud
693 Peatamise muutmine ei ole lubatud
694 Peatamise algus või esmane peatamise algus peavad olema samaaegselt täidetud
/allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/
Maret Maripuu Katrin Reinhold Anne Leisner
Lisa 5
Töötamise registri muudatuste päringu TORINFO andmekoosseis
Päringus sisend
kuupaev (xsd:date[0…1]) - kuupäev, mille muudatusi küsitakse (aaaa-kk-pp). Tagastatakse
vastava kuupäeva muudatuste viimane seis.
alates_kandest (xsd:integer) – alates mitmendast kandest soovime vastussõnumis kandeid
näha (esimesel küsimisel panna alati 1)
Päringu vastussõnum
kood (xsd:integer[1]) – päringu töötlemise tulemuse kood (Tagastatavad teated)
0 - päring oli OK
50 - vigane päring
100 – vastuseks liiga palju ridu
leitud_kannete_yldarv (xsd:integer[1]) – päringu vastuseks saadud kannete koguarv
alates_kandest (xsd:integer) – selles päringus vastuseks saadetud esimese kande
järjekorranumber leitud kannete hulgas (sama mida sisendsõnumis küsiti)
kuni_kandeni (xsd:integer) – selles päringus vastuseks saadetud viimase kande
järjekorranumber leitud kannete hulgas
kannete_jada (xsd:element [0…1])
kanne (xsd:string [0..1000])– - iga töötamise kohta leitud kõik kanded sisaldavad järgmisi
välju:
toot_id (xsd:integer[1]) - Töötamise kande ID TÖR-s
isikukood (xsd:string[1]) – töötava isiku isikukood RR andmete alusel;
synniaeg (xsd:date[1]) – töötava isiku sünniaeg kui isikukoodi ei ole (aaaa-kk-pp);
perenimi (xsd:string[1]) – Töötaja nimi RR andmete alusel (TOR.MA_ISIKUD tabelist) või
SYNNIKUUPAEVAGA_ISIK tabelist kui isikukoodi ei ole;
eesnimi (xsd:string[1]) – Töötaja nimi RR andmete alusel (TOR.MA_ISIKUD
tabelist) või SYNNIKUUPAEVAGA_ISIK tabelist kui isikukoodi ei ole;
ta_kood (xsd:string[1]) – Tööd võimaldava isiku identifikaator (isikukood või äriregistri kood);
ta_nimi(xsd:string[1]) - Tööd võimaldava isiku nimetus (eraisiku või FIE puhul
perekonnanimi);
ta_eesnimi(xsd:string[1]) - Tööd võimaldava isiku eesnimi (eraisiku või FIE puhul; juriidiliste
isikute puhul null);
ta_synniaeg(xsd:string[1]) - Tööd võimaldava isiku sünniaeg (eraisiku või FIE puhul;
juriidiliste isikute puhul null);
tegeliku_ta_kood (xsd:string[1]) – Tegeliku tööd võimaldava isiku identifikaator (isikukood või
äriregistri kood) - kasutavad 2 ministeeriumi, võib täita peale töösuhte lõppu, võib olla
väärtustatud ainult Lõpetatud staatusega töötamiste puhul, muidu null;
tootamise_algus (xsd:date[1]) – töötamise alguse kuupäev (aaaa-kk-pp);
tootamise_liik_kood (xsd:string [1]) – töötamise liigi kood TÖR klassifikaatorist
tooaja_maar (xsd:decimal [0...1]) – tööaja määr;
leping (xsd:string [1]) – Samaaegsete samaliigiliste lepingute eristamiseks, vaba tekst;
tootamise_lopp (xsd:date[1]) – töötamise lõpetamise aeg (aaaa-kk-pp);
tootamise_lopetamise_alus_kood (xsd:string [1]) – lõpetamise aluse kood TÖR
klassifikaatorist
amet_kood (xsd:string [1]) – ameti kood Statistikaameti klassifikaatorist
(https://estat.stat.ee/codelists/codelist/AK2008ap);
amet_vabatekstina (xsd:string [1]) – vabatekstina sisestatud ametinimetus;
amet_kommentaar (xsd:string[1]) – tööülesannete kirjeldus vabatekstina;
koht_id / ads_adr_id (xsd:integer[1]) – Töötamise asukoha aadressi ID (ADR_ID) –
(http://xgis.maaamet.ee/adsavalik/ads);
ads_oid (xsd:string[1]) - ADS sisene objekti identifikaator, identifitseerib objekti üle kõikide
liikide. Kood koosneb 10 sümbolist: 2 esimest on objektiliiki väljendav tähtedest koosnev
lühend ning 8 numbrit, mis genereeritakse süsteemi poolt. (TOOTAMINE.ADS_OID)
aadress_vabatekstina (xsd:string [1]) – vabatekstina sisestatud aadress
riigi_kood (xsd:string [1]) – Riigi kood, kus töötamine toimub (sh EE)
peatamiste_jada (xsd:string [0..unbounded]) - selle töötamise kohta registreeritud
peatamised
peatamine (xsd:string [0..20]) – Iga peatamise kohta leitud kõik kanded sisaldavad järgmisi
välju:
peat_id(xsd:integer[1]) - Peatamise ID tabelist PEATAMINE;
peat_algus (xsd:date[1]) – töötamise peatamise alguse kuupäev (aaaa-kk-pp);
peat_alus_kood (xsd:string [1]) – töötamise peatamise aluse kood TÖR klassifikaatorist;
peat_lopp(xsd:date[1]) – töötamise peatamise lõpu kuupäev (aaaa-kk-pp);
peat_olek_kood (xsd:string [1]) – peatamise oleku kood TÖR klassifikaatorist;
peat_sisestamise_aeg (xsd:datetime [1]) (aaaa-kk-ppTtt:mi:ss);
peat_muutmise_aeg (xsd:datetime [1]) (aaaa-kk-ppTtt:mi:ss);
esmane_peat_algus (xsd:date[1]) – peatamise esmane alguskuupäev;
kande_olek_kood (xsd:string [1])– kande oleku kood TÖR klassifikaatorist;
ta_markus(xsd:string [1]) – vabateksti väli tööandja märkuste jaoks;
esmane_toot_algus (xsd:date[1]) – töötamise esmane alguskuupäev (aaaa-kk-pp);
vms_tegija (xsd:string[1]) – väljamakse tegija registrikood
(TVOIM_ISIKU_VOLITUS.TEINE_ISIK_ID järgi, kus TOOTAMINE.TVOIM_ISIK_ID =
TVOIM_ISIKU_VOLITUS.TOOT_VOIM_ISIK_ID)
toot_sisestamise_aeg (xsd:datetime [1]) (aaaa-kk-ppTtt:mi:ss);
toot_muutmise_aeg (xsd:datetime [1]) (aaaa-kk-ppTtt:mi:ss);
Tagastatavad teated
0 Päring oli korrektne
50 Viga päringu töötlemisel
51 Päringus puuduvad sisendandmed
52 Ei leitud ühtegi tulemust
63 Päringu tüüp ei ole korrektne
67 Puuduvad õigused toimingu tegemiseks
70 Üldine viga, andmete laadimine andmebaasist ebaõnnestus
71 Üldine viga, süsteemiparameetri laadimine andmebaasist ebaõnnestus
72 "Alates_kandest" peab olema > 0
73 "Alates_kandest" on suurem kogu kannete arvust
100 Sõnumi vastus sisaldab liiga palju kirjeid
300 Päringut saab teha kõige hilisemalt eelmise päeva kohta
Tööinspektsioon Tervise ja Heaolu Maksu- ja Tolliamet
Infosüsteemide
Keskus
/allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/
Maret Maripuu Katrin Reinhold Anne Leisner
Lisa 6
Töötamise registris andmepäring TORRGNOTI
Sisend:
- parameeter, millega saab juhtida, millisest arvust rohkem peab ettevõttel töötajaid
olema – puudumisel tingimust ei arvestata.
- requestId, juhuks, kui tullakse küsima vastust
Küsimus: Kui suur on töötajate arv töötamise kohtade, töötamise liikide ja ametite lõikes?
Vastus: andmed ettevõtete kohta, milles on kehtivaid töötamise kandeid päringu käivitamise
ajal. Vastus antakse zipitud xmliga.
Kannete koguarv TÖRis
Kehtivate kannete koguarv TÖRis
Peatatud kannete koguarv TÖRis
Alaealiste kehtivate kannete koguarv TÖRis
Alaealiste peatatud kannete koguarv TÖRis
Kehtivate ja peatatud kannete grupeerimine ja koguarvud liikide kaupa
Kehtivate ja peatatud kannete grupeerimine ja koguarvud tööandjate ja liikide kaupa
Kehtivate ja peatatud kannete grupeerimine ja koguarvud tööandjate ja ametikoodide kaupa
Kehtivate ja peatatud kannete grupeerimine ja koguarvud tööandjate ja asukohtade kaupa
Tööinspektsioon Tervise ja Heaolu Maksu- ja Tolliamet
Infosüsteemide
Keskus
/allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/
Maret Maripuu Katrin Reinhold Anne Leisner