1

TÖR-i X-tee liidesed

1. Töötamise registreerimine/muutmine masin-masin liidese kaudu

Masin-masin (M-M) liidese kaudu saadab tööd võimaldav isik oma töötajate andmed TÖR-i

registreerimise/muutmise sõnumiga TOOTREG.

Töötamise registreerimine M-M liidese teel

Ühe TOOTREG sõnumi abil võib registreerida töötamise kandeid kas Sünnikuupäevaga kannetena,

Lihtsustatud või Täielike kannetena. Registreerimise hetkel on TÖR-is kannet identifitseerivateks väljadeks

Töötaja IK, Tööd võimaldava isiku RegNo või IK, Töö alguse kuupäev, Töö liik ja samaaegsete sama liiki

töötamiste puhul lisaks ka LEPING väli. LEPING väljale sisestab tööd võimaldav isik lepingut üheselt määrava

info (vaba tekst) kui esineb lepinguid, millel kõik eelmised 4 välja on täpselt samad. Selle välja sisuks võib olla

lepingu number, täidetav ametikohustus või projekti teema vms. Kaht täpselt samade identifitseerivate

väljadega kannet TÖR ei luba registreerida. Esimene kanne registreeritakse ja teine saab vastuseks veateate,

millest järeldub, et tuleb LEPING välja täiendada või muuta selle kande identifitseerimiseks.

Kui sisendsõnumis on töö liik määramata, siis tehakse selle töötamise kohta Lihtsustatud TÖR kanne.

Lihtsustatud kannet peab tööd võimaldav isik 7 päeva jooksul täiendama. Muus mõttes EHK-isse saatmise

kriteeriumitele vastavat kannet ei saadeta Haigekassasse enne, kui töö liik on teada ja kanne muutub

Täielikuks kandeks.

Sünnikuupäevaga kandes (kui isikul veel ei ole isikukoodi) on identifitseerivateks väljadeks Sünniaeg, Perenimi,

Eesnimi, Tööd võimaldava isiku RegNo või IK, Töö alguse kuupäev, Töö liik ja samaaegsete sama liiki

töötamiste puhul lisaks ka LEPING väli.

Sünnikuupäevaga kandel peab tööd võimaldav isik andma ette kehtivusaja mitte rohkem kui 5 päeva, võib ka

alla 5 päeva olla. Kui isik saab selle aja jooksul isikukoodi, siis tuleb tema töötamise kannet muuta, saates TÖR

ID abil süsteemile tema saadud IK või sisestades selle eMTA veebilehelt. Kui IK nende päevade jooksul ei

sisestata, siis tuleb registreerida uus kuni 5-päevane kanne sünniajaga, mida võib siis nende päevade jooksul

muuta IK-ga kandeks – kanne muutub IK lisamisel täielikuks kandeks ja kui see on EHK-isse saatmise

kriteeriumitele vastav kanne, siis saadetakse see Haigekassasse. IK saab sisestada ka peale kande lõppemist,

juhul kui seda on vaja. Kui IK-ga täiendati juba lõpetatud Sünniajaga kannet, siis seda kannet enam

Haigekassasse ei saadeta. Eduka registreerimise tulemusel saadab TÖR tagasi seda töötamist edaspidi

identifitseeriva TÖR kande ID, mille abil tuleb teha edasisi muudatusi selles töötamise kandes.

TÖR-i kande muutmine M-M liidese teel

Muutmise all mõeldakse nii töötamise lõpetamist, peatamist, peatamise lõpetamist kui ka kõiki teisi

töötamise väljade väärtuste lubatud muudatusi.

M-M liidese puhul tuleb muudetava kande identifitseerimiseks kasutada kande TÖR ID-d, mille süsteem

saadab registreerimise vastussõnumis iga registreeritud töötamise kohta. Seda ID-d saab tööd võimaldava

isikuna sisse logides vaadata ka eMTA lehelt.

2

Tööd võimaldava isiku koodi ei saa muuta. Valesti sisestatud kanne tuleb tühistada ja avada uus kanne.

Töötaja isikukoodi saab muuta ainult Sünniajaga kandes seni kuni isikukoodi väli on tühi, hiljem enam muuta

ei saa (kanne on muutunud Täielikuks). Kui IK on sisestatud valesti, siis tuleb kanne tühistada ja avada uus

kanne.

Teiste väljade muutmise tingimused

Töötamise algust ja töö liiki saab muuta 3 kuu jooksul peale esialgset alguse kuupäeva kättejõudmist, kuid

mitte rohkem kui 3 kuu võrra algsest kuupäevast.

Töötamise lõpetamise kuupäeva ja lõpetamise alust saab 3 kuu jooksul peale lõpu kuupäeva kättejõudmist

veel muuta 3 kuu võrra tahapoole. Tuleviku poole muutmisel piirangut ei ole.

Peatamise andmete muutmine nõuab alati esialgse peatamise alguse kuupäeva etteandmist, et selle alusel

saaks identifitseerida, millist selle töötamise peatamise kannet tahetakse muuta. Kui tahetakse alustada uut

peatamist, siis tuleb täita peatamise alguse kuupäev ja esmase alguse kuupäeva ei pea täitma.

TÖR-is ei saa alustada uut peatamist enne, kui eelmine ei ole suletud ja kahe peatamise ajad samal töötamisel ei tohi kattuda. Lihtsustatud kandes saab teisi välju muuta, aga lõpetada või peatada ei saa enne, kui töö liik on ka sisestatud (kanne on muutunud Täielikuks). Sünniajaga kandes saab teisi välju muuta, aga peatada ei saa enne kui isikukood on sisestatud (kanne on

muutunud Täielikuks).

Peale muutmist oleneb uutest andmetest, mis olekusse kanne pannakse (kui sisestan peatamise alguse aja ja

see aeg on käes, siis olekuks saab Peatatud, kui peatamise lõpu aja ja see aeg on käes, siis olekuks taastatakse

Täielik jne).

Tähtajalist töötamist või peatamist saab muuta tähtajatuks, näidates vastavalt töötamise või peatamise

lõppkuupäevana spetsiaalse kuupäeva 01.01.0001.

TÖR-i kande tühistamine muudab kande oleku Tühistatuks ja ei muuda teisi andmeid. Kui kanne on varem

EHK-sse saadetud, siis saadetakse peale kande tühistamist EHK-sse töötamise lõpetamise sõnum.

Peatamise tühistamine muudab peatamise oleku Tühistatuks. Kui peatamine on varem EHK-isse saadetud, siis

saadetakse peale peatamise tühistamist EHK-sse peatamise lõpetamise sõnum.

1.1. TOOTREG sisendi kirjeldus

TOOTREG sõnum on mõeldud tööandjatele töötamiste registreerimiseks.

xtee:consumer (X-Tee päringu päise väli, xsd:string[1]) – andmeedastaja identifikaator – võib olla RTK ID, Tööinspektsiooni või tööd võimaldava isiku ID X-tee keskkonnas;

xtee:unit (X-Tee päringu päise väli, xsd:string[1]) – tööd võimaldava isiku ID, selle koodi alusel tuleb leida tvoim_isik_id või tvoim_fie_id TOOTAMINE tabelisse; FIE korral näidata FIE ärikood (v.a kui tegu on ärikoodita FIE-ga, nt notar);

xtee:userid (X-Tee päringu päise väli, xsd:string[1]) – sõnumi saatja IK ja selle ees isikukoodi väljastanud riigi kahekohaline kood (EE);

3

kanne_jada (xsd:element[1]) – loetelu töötamise kannetest: o 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-i 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-i 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.

1.2. 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; • hoiatusega kannete arv (xsd:integer[1]) – töötlemisel hoiatuse saanud kannete arv;

o vigased_kanded(xsd:element[1]) – töötlemisel tekkinud teated: informatiivsed, hoiatused 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)

4

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-i 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-i 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; 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.

o 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-is; 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;

5

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-i 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.

1.3. Reeglid

Masin-masin (M-M) liides on mõeldud vähemalt ühe töötamise registreerimise või muutmise kande

edastamiseks MTA-le TÖR-i jaoks.

1.4. Sisendsõnum

1. 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. 2. 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. 3. Kohustuslik on R tüüpi kande puhul täita kas Isikukood või siis väljad Eesnimi, Perenimi ja Sünniaeg. 4. 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).

1.5. 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.

6

1.6. Tagastatavad teated terve sõnumi kohta

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, kuid tekkisid hoiatused

Kõik dokumendi kanded on edukalt 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 andmeid!

Dokumendi töötlemisel esines vähemalt ühe kande töötlemisel viga, mis ei võimaldanud vea saanud kannet TÖR-i 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öötlemata.

155 Saatja IK ei ole olemas Saatja IK ei ole ISIKUD tabelis olemas. Kõik esitatud kanded on töötlemata.

160 Viga TÖR-i 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 tuleb uuesti saata.

180 Viga adapterserveris (probleem vastendustes). Palun kontrollige esitatud andmete formaati.

Tõrge adapterserveri töös. Tasub 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 (max arv on parameetris SISENDSONUMI_MAX_KIRJETE_ARV)

Registrisse esitatud sõnumis oli liiga palju kandeid (üle maksimaalse lubatava kannete arvu, 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.

7

1.7. Tagastatavad teated sõnumis sisalduva kande kohta

Kande valideerimise vead (See kanne ei ole TÖR-i viidud) 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-i 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.

8

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.

9

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.

1.8. Sõnumi TOOTREG töötlemine

TOOTREG sõnumi saatjal tööd võimaldava isiku kohta kannete tegemise ja muutmise õiguste kontroll.

Sõnumit saatval kasutajal (sõnumis väli userid) peab olema eMTA volituste süsteemis kehtiv TöR-i

volitus selle tööd võimaldava isiku (sõnumis väli unit) esindajana tegutsemiseks.

FIE-st tööd võimaldava isiku korral on kohustuslik sõnumis väljal unit näidata FIE ärikood.

Ärikoodita FIE korral võib unit väljal olla isikukood.

Juhul kui sõnumit edastava x-tee ühenduse valdaja (sõnumis väli consumer) ei ole tööd võimaldav

isik (unit), kelle kohta üritatakse toimingut teha, siis peab consumer’il olema eMTA volituste

süsteemis kehtiv TöR-i volitus seda unit’it esindada.

10

2. Tööd võimaldava isiku järgi TÖR-ist andmete pärimine Tööd võimaldavatel isikutel endal on õigus üle masin-masin liidese pärida ja saada infot ainult oma töötamiste kohta.

Vastussõnumis on selle tööd võimaldava isiku kohta nii Sünniajaga kui ka IK-ga registreeritud kanded ja Lihtsustatud kanded (ilma töö liigita kanded).

Kehtivate kannete või kõikide kannete valik määratakse sisendparameetriga.

2.1. Päringu TORRGNO sisendsõnum

xtee:consumer (X-Tee päringu päise väli, xsd:string[1]) – andmeedastaja identifikaator;

xtee:unit (X-Tee päringu päise väli, xsd:string[0..1]) – andmeedastaja identifikaator;

xtee:userID (X-Tee päringu päise väli, xsd:string[1]) ‒ andmeedastaja isiku ID;

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.

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);

toot_perioodi_algus (xsd:date[0…1]) ‒ töötamisperioodi algus (aaaa-kk-pp);

toot_perioodi_lopp (xsd:date[0…1]) ‒ töötamisperioodi lõpp (aaaa-kk-pp).

2.2. Päringu TORRGNO vastussõnum

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])

o 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-is;

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;

11

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-i klassifikaatorist;

tootamise_liik_nimi (xsd:string [1]) – töötamise liigi nimetus TÖR-i klassifikaatorist;

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-i

klassifikaatorist;

tootamise_lopetamise_alus_nimi (xsd:string [1]) – lõpetamise aluse nimetus TLP-i

klassifikaatorist;

amet_kood (xsd:string [1]) – ameti kood Statistika klassifikaatorist;

amet_nimi (xsd:string [1]) – ameti nimetus Statistika klassifikaatorist;

koht_id (xsd:integer [1]) – töötamise asukoha aadressi ID –

(http://xgis.maaamet.ee/adsavalik/ads);

koht (xsd:string [1]) – töötamise asukoht (töö asukoha aadress) ADS-i järgi;

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-isse 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-i klassifikaatorist;

kande_olek_nimi (xsd:string [1]) – kande oleku nimetus TÖR-i klassifikaatorist;

ta_markus(xsd:string [0…1]) – vaba teksti väli TA märkuste jaoks;

mta_markus (xsd:string [0…1]) – ametniku märkus;

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;

12

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 tehtud otsuse liigi kood

klassifikaatorist;

lopalus_otsuse_liik_nimi (xsd:string [1]) – lõpetamise aluse kohta tehtud 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-i kaudu või helistamise teel)

telefoninumber, millelt registreerimine tehti;

toot_ehk_aeg(xsd:datetime [1]) – viimati EHK-isse 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.

2.3. Tagastatavad teated Kood Teade 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.