Dokumendiregister | Registrite ja Infosüsteemide Keskus |
Viit | 2/47-24 |
Registreeritud | 29.11.2024 |
Sünkroonitud | 02.12.2024 |
Liik | Leping |
Funktsioon | 4 Finantseerimine ja raamatupidamise arvestus |
Sari | 4-3 Lepingud juriidiliste isikutega, aktid |
Toimik | 4-3-1/2024 |
Juurdepääsupiirang | Avalik |
Juurdepääsupiirang | |
Adressaat | |
Saabumis/saatmisviis | |
Vastutaja | Ave Liina Tennokese (Registrite ja Infosüsteemide Keskus, Õigusteenuse tiim) |
Originaal | Ava uues aknas |
Andmevahetusleping 2/47-24
Tallinnas kuupäev digitaalallkirjas
Maksu- ja Tolliamet (edaspidi MTA), mida esindab peadirektori 31.01.2024 käskkirja nr 23-P
„Volituste andmine arendusosakonna juhatajale“ alusel arendusosakonna juhataja Alvar Pihlapuu,
Konkurentsiamet (edaspidi KA), mida esindab mida esindab põhimääruse alusel peadirektor
Evelin Pärn-Lee ja
Registrite ja Infosüsteemide Keskus (edaspidi RIK), mida esindab põhimääruse alusel direktor
Rivo Reitmann (edaspidi koos ja ühiselt pooled ning eraldi ja üksikult pool), sõlmisid käesoleva
andmevahetuslepingu (edaspidi leping) alljärgnevas:
1. MÕISTED
1.1. Andmed – maksukohustuslaste registri (edaspidi MKR) andmed, mida teenuse osutamise
käigus töödeldakse.
1.2. Päring – teenuse osutamiseks kokkulepitud sisend- ja väljundandmehulgad. Üheks
päringuks loetakse sisendandmehulga alusel andmete otsimist võimaldava funktsiooni
rakendamist ja väljundandmehulga tagastamist, sõltumata tagastatavate andmehulkade
arvust.
1.3. Teenus – andmevahetus üle X-tee võimaldamaks KA-le juurdepääsu MKR andmetele MISP
portaali vahendusel.
1.4. Teenuse kasutaja – ametnik ja töötaja, kellel on tööülesannete täitmiseks vajalik juurdepääs
andmetele ning kellele on antud päringute tegemise õigus.
1.5. Konfidentsiaalne teave – lepingu täitmisel väljastatavad andmed, teenuse kasutamiseks
kasutatavad infotehnoloogilised lahendused ning muu teave, mille avalikuks tulek võiks
kahjustada poole huve või mille avalikustamine ei ole kooskõlas isikuandmete kaitse
nõuetega, v.a avalik teave avaliku teabe seaduse (edaspidi AvTS) kohaselt.
1.6. Teade – lepingust tulenevate ülesannete täitmiseks vajalik vormikohane teave, mille
edastamist poolte vahel peetakse vajalikuks.
1.7. Rike – teenuse eesmärgipärast kasutamist mittevõimaldav olukord.
1.8. Turvaintsident – situatsioon, kus infosüsteemi ja/või infosüsteemis töödeldava
informatsiooni konfidentsiaalsust, terviklikkust ja käideldavust rikutakse, mh kui süsteemi on
üritatud volitamata kasutada, nii edukalt kui ebaedukalt.
1.9. Tööaeg – esmaspäev kuni neljapäev kell 08.00-16.45 ja reede kell 08.00-15.30.
2. LEPINGU EESMÄRK JA ÕIGUSLIK ALUS
2.1. Lepingu eesmärk on sätestada poolte õigused ja kohustused teenuse osutamisel ning
võimaldada juurdepääs maksukohustuslaste registri (edaspidi MKR) andmetele järgmiselt:
MTA on andmeandja, kes edastab lepingu lisades loetletud MKR-i andmeid KA-le.
KA on andmesaaja, kes töötleb lisades loetletud andmeid maksukorralduse seaduse
(edaspidi MKS) § 29 punkti 1, punkti 2 ja punkti 31 alusel oma pädevuse piires.
2
RIK osutab KA-le MISP portaali kasutajahaldust ja tehnilist tuge ning haldab MISP portaali ja
X-tee turvaserveri logisid. RIK töötleb andmeid MKS § 26 lg 21 ja 3 alusel info- ja
sidesüsteemide hooldamiseks ja arendamiseks.
3. TEENUSE OSUTAMINE JA KASUTAMINE
3.1. Teenuse kasutamine toimub andmevahetuskihi X-tee kaudu.
3.2. Teenuse kasutamiseks algatab teenuse kasutaja KA-s MISP portaalis päringu
maksukohustuslaste registrisse. Päringu sisend- ja väljundandmekomplektid on toodud
lepingu lisades.
3.3. Andmed loetakse KA-le väljastatuks päringule vastuse saamisest arvates.
3.4. Teenust osutatakse infosüsteemide andmevahetuskihi X-tee tehniliste võimaluste piires, mis
võimaldab lepingus ettenähtud tingimustel andmete töötlemist.
3.5. MTA pakub teenust viisil, mis võimaldab KA poolt teenuse kasutamise digitaalse arvestuse
pidamise ja järelevalve teostamise võimaluse.
3.6. MTA võib keelduda teenuse osutamisest põhjendatud kahtluse korral teenuse kasutaja
volitustes, teenuse kasutamise seaduslikkuses või kui teenuse kasutamine ei vasta lepingus
kokkulepitud nõuetele.
3.7. Andmeid, mille õigsust on vaidlustatud, ei edasta MTA kuni andmete õigsus on kindlaks
tehtud või õiged andmed on välja selgitatud.
4. KA KOHUSTUSED
4.1. KA-l on kohustus:
4.1.1. määrata teenuse kasutajad, kellele on tööülesannete täitmiseks vajalik juurdepääs andmetele; teenuse kasutajatel, kellele on antud juurdepääsuõigus, peab olema personaalne kasutajatunnus, mille järgi on teenuse kasutajat võimalik tuvastada;
4.1.2. tutvustada enne oma töötajatele andmetele juurdepääsuõiguse andmist teenuse
osutamist puudutavaid õigusi ja kohustusi;
4.1.3. tagada, et kõikidel tema poolt määratud juurdepääsuõigusega isikutel on piisavad
teadmised isikuandmete töötlemise nõuetest ning neil on konfidentsiaalsuskohustus,
mis jääb kehtima ka pärast teenistusest vabastamist või võlaõigusliku lepingu
lõppemist;
4.1.4. tagada järelevalve tehtud päringute ja saadud andmete õiguspärase kasutamise üle, juurdepääs andmetele on lubatud ainult tööülesannete täitmiseks;
4.1.5. tagada juurdepääsu sulgemine teenuse kasutajale koheselt, kui teenuse kasutajal kaob vajadus juurdepääsuks või teenistussuhe temaga lõpeb.
5. RIKi KOHUSTUSED
5.1. RIKil on kohustus:
5.1.1. määrata RIK-i töötajad, kellele on tööülesannete täitmiseks vajalik juurdepääs
andmetele; töötajatel, kellele on antud kasutaja õigused, peab olema personaalne
kasutajatunnus, mille järgi on kasutajat võimalik tuvastada;
5.1.2. tutvustada enne oma töötajatele andmetele juurdepääsuõiguse andmist teenuse
osutamist puudutavaid õigusi ja kohustusi;
5.1.3. tagada, et kõikidel tema poolt määratud juurdepääsuõigusega isikutel on piisavad
teadmised isikuandmete töötlemise nõuetest ning neil on konfidentsiaalsuskohustus,
mis jääb kehtima ka pärast teenistusest vabastamist või võlaõigusliku lepingu
lõppemist;
3
5.1.4 sulgeda töötajale andmetele juurdepääs koheselt, kui töötajal kaob vajadus
juurdepääsuks või töösuhe temaga lõpeb.
6. ANDMEKAITSE
6.1. Pooltel on kohustus:
6.1.1. tagada MKS § 26 lg 3 kohaselt maksusaladuse hoidmise kohustus. Maksusaladuse hoidmise kohustus ei lõpe teenistus- või töösuhte lõppemisega;
6.1.2. 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;
6.1.3. rakendada asjakohaseid organisatsioonilisi, infotehnilisi ja füüsilisi turvameetmeid andmete kaitsmiseks, et ära hoida volitamata isikute juurdepääs andmetele, sealhulgas andmete töötlemiseks kasutatavatele andmetöötlusseadmetele ja -süsteemidele.
6.2. Pooled ei tohi andmeid töödelda muudel eesmärkidel, kui neile seadusega pandud
ülesannete täitmiseks.
6.3. Turvaintsidendist, isikuandmete töötlemise rikkumisest või selle kahtlusest, teadasaamisest
või avastamisest teavitavad pooled viivitamatult e-posti aadressil [email protected].
6.4. KA on kohustatud teostama järelevalvet teenuse kasutajate tegevuse üle teenuse
kasutamisel ja andmete töötlemisel (eelkõige päringute põhjendatuse ja eesmärgipärasuse
üle).
6.5. Pooled on kohustatud omapoolsete tehniliste ja organisatsiooniliste vahenditega ära hoidma
juhuslikke ja tahtlikke teenuse kasutamist takistavaid ründeid (Denial of Service Attack) ja
koormusrünnete toimumist MTA andmekogule ja rakendusele, mis võivad toimuda seoses
lepingus toodud teenuse osutamise ja kasutamisega.
6.6. Kui teenuse kasutamisel on tekkinud turvaintsident, jätab MTA endale õiguse teenuse
osutamine ühepoolselt katkestada kuni turvaintsidendi lahendamiseni. MTA edastab vastava
teabe esimesel võimalusel enne teenuse katkestamist poolte kontaktisikule.
6.7. Kui teenuse kasutamisel on tekkinud põhjendatud kahtlus lepinguga pandud kohustuste
rikkumise kohta, on MTA-l õigus sulgeda juurdepääs teenusele koheselt, teavitades sellest
esimesel võimalusel poolte kontaktisikuid.
6.8. MTA-l on õigus piirata MTA süsteemide jõudluse probleemide tekkimisel teenuste
kasutamist, teavitades sellest esimesel võimalusel poolte kontaktisikuid.
6.9. Pooled ei edasta ega anna muul viisil üle andmeid kolmandatele isikutele, v.a seadusest
tulenevate ülesannete täitmiseks. Lepingu poolel või tema poolt volitatud isikul on keelatud
sõlmida kolmandate isikutega lepinguid andmete töötlemiseks, loovutamiseks või muul viisil
edasi andmiseks kolmandatele isikutele.
6.10. Juhul kui andmesubjekt, kelle isikuandmeid on pooled töödelnud, pöördub MTA poole
saamaks infot tema isikuandmete töötlemise kohta, edastab MTA päringu vastamiseks
pooltele lähtuvalt päringu sisust.
7. LOGIDE TÖÖTLEMINE
7.1. KA logid peavad võimaldama tuvastada lubatavaid ja lubamatuid infosüsteemi poole
pöördumisi või pöörduskatseid, nende täpset aega ja lähtekohta. Sisaldades muuhulgas
järgnevaid andmeid:
7.1.1. andmetöötluse teostaja;
7.1.2. teenuse nimetus;
7.1.3. infosüsteemi identifikaator;
7.1.4. ajamärgistus, mis sisaldab täpset sündmuse kuupäeva ning kellaaega;
7.1.5. päringu sisendparameetrid, mille alusel päring teostati;
4
7.1.6. teostatud andmetöötluse väljund või andmetöötluse tulem.
7.2. MTA fikseerib päringu kohta järgmised andmed:
7.2.1. asutuse nimi, kellele andmeid väljastati;
7.2.2. isik, kellele andmeid väljastati;
7.2.3. teenuse nimetus;
7.2.4. päringu sisendparameetrid, mille alusel päring teostati;
7.2.5. väljastatud andmete koosseis;
7.2.6. andmete väljastamise aeg.
7.3. MTA ja RIK peavad tagama logide muutmatuse.
7.4. MTA ja RIK säilitavad auditlogisid vähemalt 2 aastat.
8. TEATED
8.1. Pooltevahelised lepinguga seotud teated peavad olema edastatud vähemalt kirjalikku
taasesitamist võimaldavas vormis lepingus määratletud kontaktaadressidel vastavatele
kontaktisikutele. Teade loetakse kätte antuks e-kirja saatmise kuupäevast.
9. MUUD TINGIMUSED JA VASTUTUS
9.1. Pooled kannavad iseseisvalt kulud teenuse osutamiseks ja kasutamiseks vajaliku tehnilise
lahenduse loomiseks, hooldamiseks ning andmekaitse nõuete, organisatsiooniliste, füüsiliste
ja infotehniliste turvameetmete järgimiseks.
9.2. Väljaspool tööaega tagavad pooled võimalusel riketele reageerimise ja nende kõrvaldamise.
9.3. Pooled vastutavad rikete kõrvaldamise eest oma vastutusala piires.
9.4. Pooled ei vastuta viivituste ja rikete eest, mis tulenevad nende mõjualast väljaspool olevast
tegurist, mida ei suuda ennetada ja mille tagajärgi ei oleks saanud vältida või ära hoida.
9.5. Pooled ei vastuta kolmandate isikute poolt osutatavate teenuste, sh infosüsteemide
andmevahetuskihi X-tee, sideliinide rikete, telefoniside katkestuste ja muude pooltest
mitteolenevate takistuste eest.
9.6. MTA-l on õigus katkestada juurdepääs andmetele MTA poolt kehtestatud
süsteemihoolduseks ettenähtud ajal (tööpäeviti 7:00–8:00 ja lisaks kolmapäeviti 17:00–
20:00).
9.7. MTA-l on õigus katkestada juurdepääs teenusele muul ajal, teavitades KA ja RIK
kontaktisikuid üks (1) tööpäev ette.
10. KONTAKTISIKUD
10.1. KA kontaktisik lepingu sõlmimise hetkel on teabehalduspartner Gerda Šein, e-post:
10.2. RIK kontaktisik lepingu sõlmimise hetkel on tugiinfosüsteemide tiimi tootejuht Albert
Lamartson, e-post: [email protected].
10.3. MTA kontakt on [email protected].
10.4. Kontaktisiku muutmisest teavitavad pooled teineteist hiljemalt 5 tööpäeva jooksul.
11. LÕPPSÄTTED
11.1. Leping jõustub hetkest, mil pooled on lepingu allkirjastanud ja kehtib tähtajatult.
11.2. Juhul, kui lepingu mõni säte osutub vastuolus olevaks Eestis kehtivate õigusaktidega, ei
mõjuta see ülejäänud sätete kehtivust.
11.3. Lepingu täitmisel tekkivad vaidlused lahendavad pooled läbirääkimiste teel.
5
11.4. Lepingu lisad on lepingu lahutamatud osad. Kõik lepingu muudatused sõlmitakse lepingu
lisadena ning jõustuvad pärast nende allkirjastamist poolte poolt või nende määratud
tähtajal. Kontaktisikute või –andmete muutmine toimub teise poole teavitamisega ning
selleks lepingu lisasid ei sõlmita.
11.5. Lepingu sõlmise hetkel on lepingu lisad järgnevad:
Lisa 1 - EDASTATAVATE ANDMETE JA ANDMEVAHETUSE KIRJELDUS teenuse
„Juriidilise isiku või FIE töötajad“ kohta.
Lisa 2 – EDASTATAVATE ANDMETE JA ANDMEVAHETUSE KIRJELDUS teenuse
„Juriidilise isiku või FIE KMD andmed“ kohta.
Lisa 3 – EDASTATAVATE ANDMETE JA ANDMEVAHETUSE KIRJELDUS teenuse
„Isiku keskmine päevasissetulek“ kohta.
Lisa 4 – EDASTATAVATE ANDMETE JA ANDMEVAHETUSE KIRJELDUS teenuse
„Töötamise registri üksikpäring“ kohta.
Lisa 5 – EDASTATAVATE ANDMETE JA ANDMEVAHETUSE KIRJELDUS teenuse
„Töötamiste otsimine TÖRist tööd võimaldava isiku järgi“ kohta.
11.6. Leping lõppeb poolte kokkuleppel või juhul, kui sellekohased muudatused on sisse viidud
õigusaktidesse või kui lepingu täitmisest tekkivaid vaidluseid ei lahendata mõistliku aja
jooksul.
11.7. Pooled on kokku leppinud, et käesoleva lepingu allkirjastamisega loevad pooled lõppenuks
poolte vahel 06.11.2017 a. sõlmitud kokkuleppe ja selle juurde kuuluvad lisad.
12. POOLTE REKVISIIDID
Konkurentsiamet Maksu- ja Tolliamet
Aadress: Tatari tn 39, 10134 Tallinn Aadress: Lõõtsa 8A, 15176 Tallinn
Registrikood: 70000303 Registrikood: 70000349
Tel: +372 6672400 Tel: +372 8800811
E-post: [email protected]
E-post: [email protected]
[allkirjastatud digitaalselt]
[allkirjastatud digitaalselt]
Evelin Pärn-Lee Alvar Pihlapuu
peadirektor arendusosakonna juhataja
Registrite ja Infosüsteemide Keskus
Aadress: Lubja 4, 19081 Tallinn
Registrikood: 70000310
Tel: +372 6636300
E-post: [email protected]
[allkirjastatud digitaalselt]
Rivo Reitmann
direktor
6
Lisa 1
EDASTATAVATE ANDMETE JA ANDMEVAHETUSE KIRJELDUS teenuse
„Juriidilise isiku või FIE töötajad“ kohta
Teenuse kasutaja nimeks X-teel on KA ning registrikood on 70000303.
Teenuse tehniline nimetus: EE/GOV/70000349/tsd/xteeJFTootajad/v1
Teenuse WSDL: https://x-tee.ee/catalogue/EE
Teenuse eesmärk:
Töötajatele deklareeritud väljamaksete andmete pärimiseks (Juriidilise isiku ja FIE töötajad)
Päringu tüüp ja sagedus:
masspäring/ üksikpäring
võimalik pärida andmeid eelneva kui ka jooksva aasta kohta
Teenuse sisend:
Teenuse sisendi element
Kommentaar
1 registrikood või FIE isikukood
Tööandja registrikood või FIE isikukood, sh ettevõtluskonto puhul isikukood
2 Perioodi algus (kk.aaaa) Päringut saab teha nii eelneva kui ka jooksva aasta kohta
3 Perioodi lõpp (kk.aaaa)
4 Lehekülg sisestada lehekülje nr alates millest tulemust kuvab (1 - 1000 rida (1-1000), 2 - 1000 rida (1001-2000), ... )
5 Toimiku number ei ole kohustuslik
Teenuse väljund:
Päringu vastus väljastatakse valitud tööandja iga töötaja lõikes eraldi tabelitena valitud perioodi
kohta. Kui valitud perioodis on mitu TSD perioodi (kalendrikuud), siis iga TSD perioodi kohta
näidatakse omakorda andmed eraldi tabelina.
Kui ühe TSD perioodi kohta on valitud tööandja teinud töötajale väljamakseid erinevate
väljamakseliikidega, siis kuvatakse väljamakseliigid ühel real VML koodidega (näiteks 10, 54).
Väljamakseliigid kuvatakse koodidena, väljamaksu- ja maksusummad summeeritakse.
Teenuse väljundi element
Definitsioon
1 Töötaja isikukood
2 Töötaja nimi Ees- ja perekonnanimi
3 Väljamakse summa Erinevate TSD lisa 1,lisa 2 ja INF 1 väljamakseliikidega tehtud väljamaksed summeeritakse kokku. Ettevõtluskonto summa (laekunud summa - sotsiaalmaks)
7
Teenuse väljundi element
Definitsioon
4 Väljamakseliigid Näidatakse kõik TSD lisa 1,lisa 2 ja INF 1 väljamakseliigi kood(id). Ettevõtluskonto, kui isikul on laekumine ettevõtluskontole.
5 Tulumaksu summa Kinnipeetud tulumaks summeeritakse kokku
6 Sotsiaalmaksu summa Arvestatud sotsiaalmaks summeeritakse kokku
7 Töötuskindlustusmakse summa
Kinnipeetud töötuskindlustusmakse summeeritakse kokku
8 Kogumispensionimakse summa
Kinnipeetud kogumispensionimakse summeeritakse kokku
9 Periood (kk.aaaa) TSD periood, mille andmeid tabelis kuvatakse
8
Lisa 2
EDASTATAVATE ANDMETE JA ANDMEVAHETUSE KIRJELDUS teenuse
„Juriidilise isiku või FIE KMD andmed“ kohta
Teenuse kasutaja nimeks X-teel on KA ning registrikood on 70000303.
Teenuse tehniline nimetus: EE/GOV/70000349/kmd/xteeJFKMD/v2
Teenuse WSDL: https://x-tee.ee/catalogue/EE
Teenuse sisend:
Registrikood perioodi algus kk.aaaa perioodi lõpp kk.aaaa Teenuse väljund:
ettevõtte/FIE nimi registrikood/isikukood periood Käibedeklaratsiooni (KMD) rea number ja deklareeritud summa, „abi“ all on KMD vastava rea
numbri kirjeldus.
9
Lisa 3
EDASTATAVATE ANDMETE JA ANDMEVAHETUSE KIRJELDUS teenuse
„Isiku keskmine päevasissetulek“ kohta
Teenuse kasutaja nimeks X-teel on KA ning registrikood on 70000303.
Teenuse tehniline nimetus: EE/GOV/70000349/tsd/paSissetulek/v1
Teenuse WSDL: https://x-tee.ee/catalogue/EE
Päringu tüüp ja sagedus:
Üksikpäring.
Päringut saab teha eelmise aasta tulude kohta. Kuna tuludeklaratsiooni (FIDEK) esitamise tähtpäev on 30.aprill, siis eelmise aasta tulude kohta saab teha päringut pärast 30.aprilli. Kui tuludeklaratsioon (FIDEK) on kinnitatud enne 30.aprilli, siis saab päringut teostada ka varem eeldusel, et X-tee teenuse süsteem on vastava aasta arvutuspõhimõttega uuendatud.
Pärida saab ka eelmiste aastate kohta. Varaseim aasta, mille kohta saab päringut teha on 2010. aasta.
Teenuse sisend:
Teenuse sisendi element Definitsioon
Isikukood Päringut ei ole võimalik teostada mitteresidendi kohta
Aasta Päringut saab teha eelmise ja varasemate aastate tulude kohta. Jooksva aasta tulude kohta päringut teha ei saa.
Toimik Ei ole kohustuslik
Teenuse väljund:
Teenuse väljundi element
Definitsioon Selgitus
1 Isik ees- ja perekonnanimi Etteantud aasta ja isikukoodiga otsitakse isiku andmed ja isiku residentsuse andmed antud aastal ja aasta varem. Mõlema aasta mitteresidendi puhul tagastatakse teade, et isik polnud residendiks.
2 Vastus Andmed on leitud aastast xxxx. Isiku deklareeritud tulu pärast tulumaksu mahaarvamist X eurot
Päringu vastus väljastatakse valitud aasta kohta. Vastuses kuvatakse isiku valitud aasta maksustatav tulu summa, millest on tulumaks maha arvestatud.
10
Teenuse väljundi element
Definitsioon Selgitus
Kui isikul oli päritud aasta kohta esitatud tuludeklaratsioon (FIDEK), siis antakse vastuseks tuludeklaratsioonil deklareeritud andmed. Kui tuludeklaratsiooni andmed puuduvad, siis antakse vastuseks isiku kohta TSD-l deklareeritud tulu. Kui päritud aastal puuduvad andmed ka TSD-l, siis otsitakse eelmise aasta FIDEK-i andmetest tulu. Kui eelmise aasta FIDEK-l andmed puuduvad, siis antakse vastus päringu aastale eelneva aasta TSD-l deklareeritud tulu. Kui vastuse tulemus kokku on <0, siis päring peab tulemuseks kuvama 0.
Päringu vastus väljastatakse valitud isiku ja aasta kohta. Vastuses kuvatakse valitud isiku valitud aasta netosissetulek. Aastanetosissetulek leitakse vastavalt Vabariigi Valitsuse 13.08.2002 määruse nr 264 § 1 alusel: aastanetosissetulek leitakse kahtlustatava või süüdistatava (edaspidi süüdistatav) maksustatavast tulust „Tulumaksuseaduse” § 12 tähenduses, millest on maha arvatud tulumaks.
11
Lisa 4
EDASTATAVATE ANDMETE JA ANDMEVAHETUSE KIRJELDUS teenuse
„Töötamise registri üksikpäring“ kohta
Teenuse kasutaja nimeks X-teel on KA ning registrikood on 70000303.
Teenuse tehniline nimetus: EE/GOV/70000349/tor/TORIK/v2
Teenuse WSDL: https://x-tee.ee/catalogue/EE
Teenuse sisend:
Päringu 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.
Töötamisperioodi algus (aaaa-kk-pp) Töötamisperioodi lõpp (aaaa-kk-pp) Muutuste perioodi algus (aaaa-kk-pp) Muutuste perioodi lõpp (aaaa-kk-pp) Loetelu töötajate isikukoodidest (max 100 isikukoodi ühes päringus, komadega eraldatud) Teenuse väljund:
Töötamise andmed 1. kood – päringu töötlemise tulemuse kood
0 - päring oli OK
50 - vigane päring
100 - vastuseks liiga palju ridu (üle parameetriga määratud arvu) 2. leitud kannete arv – päringu vastuseks saadud kannete arv 3. Iga töötamise kohta leitud kõik kanded sisaldavad järgmisi välju:
töötamise kande ID TÖR-s - ühe töötamise (kande) kohta leitud kõik muudatuskirjed kannavad sama TÖR ID-d;
töötava isiku isikukood RR andmete alusel;
töötava isiku sünniaeg kui IK ei ole (aaaa-kk-pp);
töötaja perenimi RR andmete alusel;
töötaja eesnimi RR andmete alusel;
töötaja kodakondsuse ISO 3166-1 kood RR alusel;
töötaja kodakondsuse riigi nimi;
12
Tööd võimaldava isiku identifikaator (isikukood või äriregistri kood);
tööd võimaldava isiku nimetus;
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 tööd võimaldava isiku nimetus;
tööle asumise aeg (aaaa-kk-pp);
töötamise liigi kood TÖR klassifikaatorist;
töötamise liigi nimetus TÖR klassifikaatorist;
tööaja määr;
leping - samaaegsete samaliigiliste lepingute eristamiseks, vaba tekst;
töötamise lõpetamise aeg (aaaa-kk-pp);
lõpetamise aluse kood TLP klassifikaatorist;
lõpetamise aluse nimetus TLP klassifikaatorist;
ameti kood Statistika klassifikaatorist;
ameti nimetus Statistika klassifikaatorist;
töötamise asukoha aadressi ID ADS järgi;
töötamise asukoht (töö asukoha aadress) ADS järgi;
töötamise asukoha riik;
töötamise kohta registreeritud peatamised - iga peatamise kohta leitud kõik kanded sisaldavad järgmisi välju:
o peatamise ID; o töötamise peatamise alguse kuupäev (aaaa-kk-pp); o töötamise peatamise aluse kood peatamise aluste klassifikaatorist; o töötamise peatamise aluse nimetus peatamise aluste klassifikaatorist; o töötamise peatamise lõpu kuupäev (aaaa-kk-pp); o viimati EHK-sse saadetud peatamise sõnumi aeg;
kande oleku kood TÖR klassifikaatorist;
kande oleku nimetus TÖR klassifikaatorist;
tööd võimaldava isiku märkus;
ametniku märkus;
algkuupäeva kohta tehtud otsuse liigi kood klassifikaatorist;
algkuupäeva kohta tehtud otsuse liigi nimetus klassifikaatorist;
lisaväli TVK/Kohtu otsuse numbri jaoks (alguse kuup kohta);
töötamise liigi kohta tehtud otsuse liigi kood klassifikaatorist;
töötamise liigi kohta tehtud otsuse liigi nimetus klassifikaatorist;
lisaväli TVK/ Kohtu otsuse numbri jaoks (töötamise liigi kohta);
lõpu kuupäeva kohta tehtud otsuse liigi kood klassifikaatorist;
lõpu kuupäeva kohta tehtud otsuse liigi nimetus klassifikaatorist;
lisaväli TVK/ Kohtu otsuse numbri jaoks (lõpu kuup kohta);
lõpetamise aluse kohta tehtud otsuse liigi kood klassifikaatorist;
lõpetamise aluse kohta tehtud otsuse liigi nimetus klassifikaatorist;
lisaväli TVK/ Kohtu otsuse numbri jaoks (lõpetamise aluse kohta);
sisestamise aeg (aaaa-kk-ppTtt:mi:ss);
muutmise aeg (aaaa-kk-ppTtt:mi:ss);
lihtsustatud registreerimisel (SMS kaudu või helistamise teel) telefoni number, millelt
registreerimine tehti;
viimati EHK-sse saadetud töötamise sõnumi aeg;
(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 Ettevõtlsukonto ID; Ettevõtluskonto omaniku isikukood;
13
ettevõtluskonto omaniku isikukood; ettevõtluskonto omaniku nimi; ettevõtluskonto alguskuupäev; töötamise liigi kood TÖR klassifikaatorist (Ettevõtluskonto_kood); töötamise liigi nimetus (’Ettevõtluskonto’); ettevõtluskonto lõppkuupäev (aaaa-kk-pp) kui eksisteerib; kande oleku kood TÖR klassifikaatorist; oleku nimetus TÖR klassifikaatorist; EV konto sisestamise aeg (aaaa-kk-ppTtt:mi:ss); EV konto muutmise aeg (aaaa-kk-ppTtt:mi:ss); Ettevõtluskonto andmed
kande olek
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.
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.
14
Lisa 5
EDASTATAVATE ANDMETE JA ANDMEVAHETUSE KIRJELDUS teenuse
„Töötamiste otsimine TÖRist tööd võimaldava isiku järgi“ kohta
Teenuse kasutaja nimeks X-teel on KA ning registrikood on 70000303.
Teenuse tehniline nimetus: EE/GOV/70000349/tor/TORRGNO/v2
Teenuse WSDL: https://x-tee.ee/catalogue/EE
Kirjeldus:
Päringu sisendiks on:
Registrikood, FIE töötamiste kannete otsimisel on sisendiks FIE isikukood. Päring
võimaldab otsida tööd võimaldava isiku töötamise kandeid välja arvatud
Siseministeeriumi ja Kaitseministeeriumi haldusalas olevaid töötamise kandeid. Ühes
päringus saab küsida ühe tööd võimaldava isiku kohta.
Päringu liik - Liik määrab, millist infot küsitakse (A/T/P/AM/TM/PM)
o A – Tänase seisuga aktiivsed kanded etteantud isikute kohta. Perioodi ei ole vaja ette anda.
o T - Tänase seisuga kõik töötamise kanded etteantud isikute kohta, ka lõpetatud kanded. Perioodi ei ole vaja ette anda.
o 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.
- Töötamisperioodi algus (aaaa-kk-pp)
- Töötamisperioodi lõpp (aaaa-kk-pp)
- äriregistri kood, mitteresidendi kood MTA mitteresidentide registrist või IK , kelle töötamiste kohta andmeid küsitakse
- alates mitmendast kandest soovime vastussõnumis kandeid näha (esimesel küsimisel panna alati 1.
Vastussõnumis kuvatakse
kood (xsd:integer[1]) – päringu töötlemise tulemuse kood
o 0 - päring oli OK o 50 - vigane päring o 100 – vastuseks liiga palju ridu
- leitud_kannete_üldarv – päringu vastuseks saadud kannete koguarv selle tööandja juures
- alates_kandest – selles päringus vastuseks saadetud esimese kande järjekorranumber leitud kannete hulgas (sama mida sisendsõnumis küsiti)
- kuni_kandeni – selles päringus vastuseks saadetud viimase kande järjekorranumber leitud kannete hulgas
- kannete_jada (xsd:element [0…1]) o kanne 0..1000])– - iga töötamise kohta leitud kõik kanded sisaldavad järgmisi
välju: töötamise kande ID TÖR-s töötava isiku isikukood RR andmete alusel; töötava isiku sünniaeg kui IK ei ole (aaaa-kk-pp);
15
töötaja nimi RR andmete alusel või SYNN_ISIK tabelist kui IK ei ole; töötaja nimi RR andmete alusel või SYNN_ISIK tabelist kui IK ei ole; töötaja kodakondsuse ISO 3166-1 kood RR alusel; töötaja kodakondsuse riigi nimi; tööd võimaldava isiku identifikaator (isikukood või äriregistri kood); tööd võimaldava isiku nimetus; 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 tööd võimaldava isiku nimetus; tööle asumise aeg (aaaa-kk-pp); töötamise liigi kood TÖR klassifikaatorist töötamise liigi nimetus TÖR klassifikaatorist; tööaja määr; samaaegsete samaliigiliste lepingute eristamiseks, vaba tekst; töötamise lõpetamise aeg (aaaa-kk-pp); lõpetamise aluse kood TLP klassifikaatorist lõpetamise aluse nimetus TLP klassifikaatorist ameti kood Statistika klassifikaatorist ameti nimetus Statistika klassifikaatorist käsitsi sisestatud ametinimetus vabatekstina tööülesannete kirjeldus vabatekstina töötamise asukoha aadressi ID –
(http://xgis.maaamet.ee/adsavalik/ads) töötamise asukoht (töö asukoha aadress) ADS järgi ADS aadressi vabatekstiline täpsustus riigi_kood – Töötamise asukoha riik väljalt TOOTAMINE.RIIGI_KOOD; selle töötamise kohta registreeritud peatamised
iga peatamise kohta leitud kõik kanded sisaldavad järgmisi välju:
o Peatamise ID tabelist PEAT; o töötamise peatamise alguse kuupäev (aaaa-kk-pp); o töötamise peatamise aluse kood peatamise aluste
klassifikaatorist; o töötamise peatamise aluse nimetus peatamise aluste
klassifikaatorist; o töötamise peatamise lõpu kuupäev (aaaa-kk-pp); o Viimati EHK-sse saadetud peatamise sõnumi saatmise
aeg kande oleku kood TÖR klassifikaatorist; kande oleku nimetus TÖR klassifikaatorist; vaba teksti väli TA märkuste jaoks; ametniku märkus; RKA märge algkuupäeva kohta tehtud otsuse liigi kood klassifikaatorist; algkuupäeva kohta tehtud otsuse liigi nimetus klassifikaatorist; lisaväli TVK/Kohtu otsuse numbri jaoks (alguse kuup kohta); töötamise liigi kohta tehtud otsuse liigi kood klassifikaatorist; töötamise liigi kohta tehtud otsuse liigi nimetus klassifikaatorist; lisaväli TVK/ Kohtu otsuse numbri jaoks (töötamise liigi kohta); lõpu kuupäeva kohta tehtud otsuse liigi kood klassifikaatorist; lõpu kuupäeva kohta tehtud otsuse liigi nimetus klassifikaatorist; lisaväli TVK/ Kohtu otsuse numbri jaoks (lõpu kuup kohta); lõpetamise aluse kohta tehtud otsuse liigi kood klassifikaatorist; lõpetamise aluse kohta tehtud otsuse liigi nimetus klassifikaatorist; lisaväli TVK/ Kohtu otsuse numbri jaoks (lõpetamise aluse kohta);
16
sisestamise_aeg (aaaa-kk-ppTtt:mi:ss); muutmise_aeg (aaaa-kk-ppTtt:mi:ss); lihtsustatud registreerimisel (SMS kaudu või helistamise teel ) telefoni
number, millelt registreerimine tehti; viimati Tervisekassasse saadetud töötamise sõnumi saatmise_aeg
tabelist TOOT_EHK (aaaa-kk-ppTtt:mi:ss); Tervisekassa sõnumi liik 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.
0 Päring oli korrektne.
50 Viga päringu töötlemisel.
51 Päringus puuduvad sisendandmed
52 Töötamisi ei leitud
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 andmete pärimiseks
70 Üldine viga, andmete laadimine andmebaasist ebaõnnestus
71 Üldine viga, süsteemiparameetri laadimine andmebaasist ebaõnnestus
72 „Alates kandest“ peab olema > 0
100 Sõnumi vastus sisaldab liiga palju kirjeid.