> ## Documentation Index > Fetch the complete documentation index at: https://docs.begin.eu/llms.txt > Use this file to discover all available pages before exploring further. # Tervisekassa andmeteenuste vahendamise kord > Kuidas Begin vahendab oma klientidele Tervisekassa X-tee andmeteenuseid, autendib teenuseid kasutavaid inimesi ja säilitab logisid. ![Tervisekassa Beginis](https://mintcdn.com/beginltd/BRY4HutgAYlm2EDK/images/cover/integrations-tervisekassa-light.png?fit=max\&auto=format\&n=BRY4HutgAYlm2EDK\&q=85\&s=6645cc377e221208633b64fe9b307b7e) Begin OÜ (registrikood 12100876) on X-tee liige ja andmeteenuste vahendaja. Selle alamsüsteem `EE/COM/12100876/begin` edastab Tervisekassa tööandjateenuseid ettevõtetele, kes kasutavad Beginit. See leht on Begini vahendamise kord, mis on avaldatud X-teega liitumise lepingu punkti 5.4.6.1 alusel. See kirjeldab, mis alusel Begin vahendab, kuidas ta autendib ja autoriseerib inimesi, kes kasutavad teenuseid Begini kaudu, kuidas ta kaitseb saadud andmeid ning kuidas tekkivaid logisid arhiveeritakse ja säilitatakse. Viimati uuendatud: 27. september 2026. ## Vahendamise alus Begin vahendab kahte Tervisekassa teenust, mõlemad alamsüsteemis `kirst`: | Teenus | Mida see teeb | | - | - | | `kirst.tvl_loetelu_ta.v1` | Loetleb tööandja töövõimetuslehed | | `kirst.tvl_taiendamine.v1` | Esitab töövõimetuslehe tööandja osa | Tervisekassa on avanud mõlemad Begini alamsüsteemile. Iga tööandja, kelle nimel Begin tegutseb, annab Beginile volituse portaalis [eesti.ee](https://www.eesti.ee): **Volitused → Tervisekassa alamplokk → Tööandja X-tee teenused**, registrikoodile **12100876**. Ilma selle volituseta pole Beginil õigust tööandja nimel tegutseda. Iga tööandja on ka Begini klient Begini kasutustingimuste alusel, mis aktsepteeritakse tööruumi loomisel. Tööandja, keda päring puudutab, on märgitud päringus endas. Begin loeb selle tööruumist, millel on ettevõtte registrikood. Üks kood kuulub korraga ühele tööruumile ning on Tervisekassa ja TÖR-i jaoks ühine: koodi salvestamine esitab sellele nõude, kui ükski teine tööruum seda ei hoia. Nõue ei anna juurdepääsu. Enne kui kumbagi integratsiooni saab ühendada, kontrollivad Begini töötajad, et ettevõte kiitis heaks just selle tööruumi. Ühendamiseks on vaja nii kinnitatud nõuet kui ka riigi enda volitust. Kui tööruum on koodi jaoks kinnitatud, keeldutakse sellest koodist kõigile teistele tööruumidele. Nõue, mida keegi pole kinnitanud, ei takista teisel tööruumil koodi salvestamast, ja kui Begini töötajad selle teise tööruumi kinnitavad, vabaneb nõue. ## Kes võib teenuseid Begini kaudu kasutada Inimene jõuab nende teenusteni ainult oma tööandja enda Begini tööruumist ja alles pärast nelja kontrolli läbimist. 1. **Isik.** Ta logib Beginisse sisse kinnitatud e-posti aadressi või telefoninumbriga, ühekordse koodiga või pääsuvõtmega. 2. **Liikmesus.** Sisselogimine viib ühte tööruumi. Inimesel, kes pole selle tööruumi liige, pole selle andmetele juurdepääsu. 3. **Õigus.** Tema rollil selles tööruumis peab olema integratsioonide haldamise õigus, mida kontrollitakse integratsiooni ühendamisel, töövõimetuslehe liikide vastendamisel ja tööandja osa saatmisel. 4. **Tööandja kinnitus.** Ettevõte tuleb kehtivast seosest, mille Begini töötajad kinnitasid. Begin kontrollib seda seost enne saatmist ja enne asünkroonse vastuse rakendamist. Õnnestunud API vastus ei tõenda tööruumi volitust. Tööandja osa saatmisel kehtib veel üks nõue: saatja isikukood X-tee päises `userId`. Tervisekassa on seda nõudnud alates 15. septembrist 2025. Begin keeldub saatmast, kui see kood inimese profiililt puudub või selle kontrollnumber ei klapi, nii et iga esitus sisaldab sellelt profiililt struktuurselt kehtivat isikukoodi. Tööandja lõpetab vahendamise, kui katkestab Beginis integratsiooni ühenduse või võtab eesti.ee volituse tagasi. Ühenduse katkestamine peatab päringud: järgmise ajastatud päringu ja kõik sellele järgnevad. Ka tööruumi kustutamine peatab need. Juba saadetud päringut ei saa tagasi võtta. Ühenduse katkestamine ei vabasta ettevõtte koodi ega tühista volitust eesti.ee-s. Kood liigub ainult siis, kui tööandja muudab seda tööruumi seadetes, kui mõlema riigiasutuse integratsiooni ühendus on katkestatud, kui koodi hoidnud tööruum on kustutatud ja teine tööruum selle nõuab või kui Begini töötajad kinnitavad koodi jaoks teise tööruumi, mille nõuet pole keegi kinnitanud. Ühendusvead, tühjad tulemused ja kaotatud välised õigused seda ei vabasta. Kui Begini töötajad kinnituse tühistavad, katkeb mõlema integratsiooni ühendus; kood jääb tööruumile kinnitamata kujul, kuni töötajad kinnitavad selle või mõne teise tööruumi selle koodi jaoks. ## Autentimise ja autoriseerimise logid Begin salvestab tööruumi enda auditilogisse iga toimingu, mis autoriseerib Tervisekassa päringu: * integratsiooni ühendamine ja ühenduse katkestamine ning see, kes seda tegi; * ettevõtte registrikoodi nõudmine või vabastamine; * Begini töötajate poolt ettevõtte kinnitamine või kinnituse tühistamine; * eesti.ee volituse kinnituse salvestamine või tagasivõtmine; * muudatus selles, milline töövõimetuslehe liik millise puudumisena kajastub; * tööandja osa saatmine, koos saatja, töövõimetuslehe ja saadetud näitajatega. **Arhiveerimine.** Neid kirjeid ei viida eraldi arhiivi. Need jäävad tööruumi enda auditilogisse Begini tootmisandmebaasis, kus tööandja neid loeb; andmebaasist tehakse varukoopia tervikuna ja taastamine taastab logi koos kõige muuga. Pole ekspordisammu, arhiivikandjat ega eraldi arhiivi, millele juurdepääsu taotleda: elav logi ongi arhiiv. **Säilitamine.** Neid kirjeid säilitatakse seni, kuni tööruum on olemas, ja need eemaldatakse koos sellega. Kui inimese kirje kustutatakse tema või tema tööandja taotlusel, eemaldatakse tema isikuandmed kirjetest, mis tema toimingutest jäid; kirje ise säilib ilma nendeta, sest auditijälg, mida saab tühjendada, ei ole auditijälg. Tööandja loeb oma auditilogi Beginis vastavalt oma paketile. Begini rakenduse logisid, mis salvestavad iga ajastatud päringu tulemuse, säilitatakse Begini majutusplatvormi säilitusaja jooksul ja need on lühemaealised. Need on töölogid, mitte autoriseerimise kirje. Ettevõtte koodi nõuete register säilib pärast tööruumi kustutamist kui kirje sellest, milline tööruum millist koodi hoidis. Kustutatud tööruumi nõue ei blokeeri enam koodi: järgmine tööruum, kes seda nõuab, saab selle. Register sisaldab ettevõtte ja tööruumi identifikaatoreid ning seda, kes ja millal koodi nõudis, kinnitas, tühistas või vabastas. Esindaja isikut tõendavad dokumendid jäävad Begini kasutajatoe juurde, mitte registrisse. ## X-tee päringute logid Iga sõnum Begini ja Tervisekassa vahel läbib Begini turvaserverit, mida haldab Begini nimel Novian Eesti OÜ. Serveri sõnumilogi on iga päringu ja vastuse autoriteetne kirje ning see on allkirjastatud. Begin ei hoia sellest eraldi koopiat. **Arhiveerimine.** Turvaserveri haldaja pakib ja ekspordib sõnumilogi kord tunnis ning eemaldab arhiveeritud sõnumid turvaserverist endast ühe päeva möödudes. Eksporditud arhiivi hoiab haldaja: sellest tehakse varukoopia neli korda päevas, see kopeeritakse kord kuus arhiivikandjale ja veel kord teisele arhiivikandjale pikaajaliseks säilitamiseks. **Säilitamine.** Turvaserveri haldaja säilitab arhiveeritud sõnumilogi neli aastat. **Juurdepääs arhiivile.** Tervisekassa, RIA või järelevalveasutuse taotlus arhiivi lugemiseks esitatakse Beginile aadressil [support@begin.eu](mailto:support@begin.eu); Begin saab kirjed turvaserveri haldajalt. Tööandja võib samal viisil küsida oma päringute kirjeid. Arhiiviga tegelevad ainult haldaja enda töötajad ning haldaja annab välja taotlusele vastavad kirjed, mitte kogu sõnumilogi. Nende väljaotsimine võtab haldajal aega, seega fikseeritud tähtaega siin ei nimetata. Ülal kirjeldatud arhiveerimiskord, säilitusaeg ja juurdepääsu viis kirjeldavad seda, mida turvaserveri haldaja kirjutamise ajal teeb, nii nagu haldaja seda kirjeldab. Haldaja võib neid muuta ja Begin uuendab siis seda lehte. Begin hoiab ka iga töövõimetuslehe kohta selle päringu tulemust, millega see saadi: millal see viimati sünkrooniti ning kas ja kes saatis tööandja osa. See kirje on töövõimetuslehe juures ja kustutatakse koos sellega. Tööandja osa saatmise auditilogi kirje jääb tööruumi auditilogisse, nagu eespool kirjeldatud. ## Andmekaitse **Rollid.** Tööandja on vastutav töötleja: tema otsustab teenuse ühendada ja temal on seadusest tulenev kohustus, mida andmed teenivad. Begin OÜ on volitatud töötleja ja tegutseb tööandja dokumenteeritud juhiste alusel isikuandmete kaitse üldmääruse (GDPR) artikli 28 järgi. Tervisekassa on oma registri eraldi vastutav töötleja. Begini alamtöötlejad selle töötlemise jaoks on Novian Eesti OÜ, kes haldab turvaserverit, mida sõnumid läbivad, ja Convex, kes majutab Begini tootmisandmebaasi. Teated töövõimetuslehe kohta jõuavad ainult integratsioone haldavate inimesteni Beginis, mitte kunagi e-postiga. **Eesmärk ja õiguslik alus.** Töötlemine võimaldab tööandjal täita Eesti ravikindlustuse õigusest tulenevat kohustust täiendada suletud töövõimetuslehte seitsme päeva jooksul ja kajastab puudumist graafikus. Tööandja alus on GDPR artikli 6 lõike 1 punkt c, juriidiline kohustus, ning asjaomaseid terviseandmeid lubab töödelda artikli 9 lõike 2 punkt b. **Mida Begin saab.** Iga töövõimetuslehe kohta: selle liik, põhjuse kood, periood, avamise ja sulgemise aeg, olek, number ja Tervisekassa identifikaator ning töötaja nimi ja isikukood. Tervisekassa vastus sisaldab ka välju, mida Begin ei hoia, näiteks arsti tingimused kergema töö kohta ja raviskeemi rikkumised; Begini rakendus loobub neist vastust lugedes. Nagu iga sõnum, jääb täielik vastus turvaserveri arhiveeritud sõnumilogisse selle säilitusaja jooksul. Begin pärib ainult töövõimetuslehti, mis on avatud või ootavad tööandja osa. **Diagnoosi ei pärita, saadeta ega salvestata** ja teenus seda ei paku. Begin käsitleb siiski kogu kirjet terviseandmetena, sest liik ja põhjuse kood kirjeldavad tervist. **Mida Begin saadab.** Tööandja osa jaoks: töövõimetusleht, millele see vastab; tööandja sisestatud tasunäitajad; kuidas inimene töövõimetuslehe ajal tegelikult töötas, kergema töö periood ja hüvitise õiguseta periood koos põhjusega; kontaktisiku nimi, telefoninumber ja e-posti aadress, kui tööandja need annab; ning saatja isikukood. **Kes mida näeb.** Töövõimetusleht ise jääb integratsioonide haldamise õiguse taha. Selle broneeritud puudumist näidatakse nagu iga teist puudumist. Kolleeg, kellel pole õigust **Vaata teiste puudumiste üksikasju**, näeb ainult seda, et inimene on eemal, kui tööandja pole selle puudumise liigi jaoks sisse lülitanud valikut **Näita puudumise liiki kolleegidele**. Põhjuse kood jõuab puudumiseni, kus seda näevad graafikus ja aruannetes need, kellel on õigus **Vaata teiste puudumiste üksikasju**. Puudumise ajalugu salvestab, et see tuli Tervisekassast, ja seda kirjet näeb igaüks, kes saab puudumise avada, ka siis, kui puudumise liik on peidetud. Töötaja nimi ja isikukood on salvestatult krüpteeritud, iga tööruumi jaoks eraldi. **Säilitamine.** Begin säilitab lahendatud töövõimetuslehte seitse aastat alates selle aasta 31. detsembrist, mil selle periood lõpeb, ehk raamatupidamise seaduse § 12 järgi tööandja raamatupidamisdokumentidele kehtestatud aja. Töövõimetusleht, mis on veel avatud või ootab tööandja osa, jääb alles, kuni see lahendatakse. Põhjuse kood eemaldatakse Begini töövõimetuslehe koopiast, kui Tervisekassa võtab juhtumi üle või selle sulgeb. Kui juhtumi viimane töövõimetusleht jõuab selle perioodi lõppu ja kustutatakse, eemaldatakse põhjuse kood ka puudumiselt ja puudumise taotluselt, kuhu see kopeeriti. Kui tööandja kustutab oma Begini konto, kustutab Begin selle tööandja töövõimetuslehed pärast 90-päevast taastamisperioodi; tööandja võtab enne seda kõik kirjed, mida ta peab säilitama. **Kus andmeid hoitakse.** Begini tootmisandmebaas asub EL-is, AWS-is Iirimaal. Turvaserver asub Eestis. **Andmesubjektide õigused.** Töötaja kasutab oma õigusi tööandja kaudu, kes on vastutav töötleja. Begin edastab iga saadud taotluse tööandjale. Kui tööandja eemaldab inimese Beginist, kustutatakse tema töövõimetuslehed 90-päevase taastamisperioodi lõpus. Kui inimene palub oma andmed eemaldada ja tööandja peab tema töösuhte dokumente säilitama, eemaldab Begin selle asemel tema töövõimetuslehtedelt nime ja isikukoodi. Töövõimetuslehe liik, kuupäevad, number ja palgaarvestuse andmed jäävad alles säilitusaja lõpuni; neid saab tööandja muude kirjete kaudu endiselt inimesega seostada, seega on need jätkuvalt isikuandmed. Vale töövõimetuslehe parandab arst Tervisekassas ja Begin pärib parandatud lehe. ## Kontakt Begin peab registrit klientidest, kelle Tervisekassa päringuid ta vahendab, ja esitab selle Tervisekassa taotlusel. Kõigis selle korraga seotud küsimustes kirjuta aadressil [support@begin.eu](mailto:support@begin.eu). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.