Vanglateenistus
Vanglate osakond
Justiits- ja Digiministeerium
Suur-Ameerika 1
10122 Tallinn
KINNIPEETAVATE ARSTIKÜLASTUSE
ANDMETE EDASTAMINE HAIGLATE
INFOSÜSTEEMIST HEDA
PAKKUMUS
23.09.2026
Pakkumus kehtib 30 päeva alates pakkumise esitamise hetkest
1. PAKKUMUSE EESMÄRK
Pakkumuse eesmärk on realiseerida haiglate infosüsteemis HEDA (edaspidi HEDA)
kinnipeetavate arstikülastuste andmete edastamine Kinnipeetavate Registrile (edaspidi KIR) X-tee
kaudu. Lahendus toetab arstikülastuse loomist, muutmist ja tühistamist ning võimaldab KIR-il
kasutada saadud infot kinnipeetava kalendri ja vajaliku liikumise korraldamiseks.
Tehniline lahendus lähtub Vanglateenistuse edastatud teenuse spetsifikatsioonist
„EdastaMedArstikylastuseAndmed“, mille kohaselt kasutatakse REST-teenust ja JSON-
andmeformaati.
Pakkumuse aluseks on Vanglateenistuse 07.09.2026 edastatud teenuse spetsifikatsioon ja
pakkumuse koostamise ajaks saadud täpsustused.
2. TÖÖDE KIRJELDUS
Alljärgnevalt on toodud loetelu peamistest arendustöödest ja muudatustest, mis on vajalikud
teenuse implementeerimiseks HEDA-s. HEDA kasutajaliideses kasutatakse olemasolevaid vorme
ja komponente.
2.1. Päringute ja vastuste logimine
HEDA integratsioonilogidesse lisatakse „EdastaMedArstikylastuseAndmed“ teenusele saadetud
päringute ja KIR-ist saadud vastuste logimine. Kui KIR ei vasta päringule, märgitakse päring HEDA
tavapärase taustatöö loogika järgi taassaatmisele. Sama broneeringu kohta jäetakse taassaatmist
ootama ainult viimane sõnum.
2.2. Broneeringu loomise, muutmise ja tühistamise edastamine
Vangla osakonna teenusele tehtud broneeringu loomisel, muutmisel või tühistamisel saadab HEDA
KIR-i vastava sõnumi juhul, kui patsiendil on kinnipeetava tunnus ja Eesti isikukood. Tegevuse järgi
kasutatakse KIR-i teenuse loomise, uuendamise või tühistamise meetodit:
Edastatakse nõutud identifikaatorid: Vangla_ID, kinnipeetava isikukood ja Med_ID;
Lisamisel ja muutmisel edastatakse kohtumise algus- ja lõpuaeg ning võimalusel sihtkoht ja
vastuvõtja;
Vajadusel edastatakse kande tegija ja kommentaar. Lisainfo jääb tühjaks;
Ruumi/sihtkoha väärtus seotakse HEDA asukoha tunnusega vastavalt KIR-i
klassifikaatorile.
ELORA broneerimissüsteem pakkumus
2.3. Kasutajateavitused ja veateadete haldus
Päringu algatanud HEDA kasutajale kuvatakse KIR-i vastuse põhjal teade. Veakood „200“ korral
kuvatakse isetühistuv eduteade. Kõigi teiste veakoodide korral kuvatakse veateade kujul
„Kinnipeetavate Register: [vea kirjeldus]“. Lahendus arvestab teenuse spetsifikatsioonis kirjeldatud
teadaolevate valideerimis- ja veajuhtudega.
2.4. Analüüs ja testimine
Arendustööd sisaldavad vajaliku lahenduse detailanalüüsi ja arenduste testimist. Enne tööde
vastuvõtmist läbitakse Tellijaga ja piloteeriva Ida-Viru Keskhaiglaga eelnevalt kokku lepitud olulised
kasutusjuhud. Vastuvõtutestimise täpne korraldus ja testjuhtumid fikseeritakse projekti käigus ja
testimine hõlmab arendatud funktsionaaluste tavapärast funktsionaalset ja integratsioonitestimist
teenuse „„EdastaMedArstikylastuseAndmed“ implementeerimiseks. Pakkumus ei sisalda
automaattestide väljatöötamist ega eriliigiliste testide (sh koormus-, jõudlus-, turbe- ja
penetratsioonitestide) läbiviimist.
3. MAKSUMUS
Maht Maksumus
Töö nimetus /sisu KM-ta*
(h)
(EUR)
Kinnipeetavate arstikülastuste andmete edastamine KIR-i x-
tee teenusega „EdastaMedArstikylastuseAndmed“. Teenuse 240 19 680.00
implementeerimine HEDA-s
* lisandub käibemaks
4. TINGIMUSED JA EELDUSED
Pakkumus hõlmab käesolevas dokumendis kirjeldatud HEDA-poolseid arendus-, analüüsi-
ja testimistöid. Uued või oluliselt muutunud nõuded käsitletakse eraldi lisatööna;
KIR-i teenuse, X-tee ligipääsu, -testkeskkonna, vajalike klassifikaatorite/konfiguratsioonide
olemasolu ja toimivus on Tellija vastutusalas ja ei kuulu HEDA arendusse;
KIR-i spetsifikatsiooni pakkumuse tegemise hetkest lisanduvad veakoodide loetelu
täienemine ja sellest tulenevad sisulised lisamuudatused hinnatakse vajadusel eraldi;
Vastuvõtmise aluseks on kokkulepitud kasutusjuhtude edukas läbimine ja lahenduse
toimimine kokkulepitud testkeskkonnas;
ELORA broneerimissüsteem pakkumus
Pakkumus ei sisalda automaattestide ja eriliigiliste testide (sh koormus-, jõudlus-, turbe- ja
penetratsioonitestide) loomist ja läbiviimist;
Pakkumuse skoopi ei kuulu HEDA arendustööd, mis ei ole seotud teenuse
„EdastaMedArstikylastuseAndmed“ implementeerimise ja juurutamisega.
5. PROJEKTI AJAKAVA
Tööde teostamise täpne ajakava koos kick-off-i ja regulaarsete kohtumistega lepitakse kokku
pärast pakkumuse kinnitamist ja arenduslepingu sõlmimist.
Projekti tähtaja 11.12.2026 puhul on projekti hiliseim algusaeg 12.10.2026
Austusega
Heiki Sissask
Juhatuse liige Gennet Laboratories
ELORA broneerimissüsteem pakkumus
Kinnipeetava arstikülastuse andmete edastamine - uus
(EdastaMedArstikylastuseAndmed)
Kui meditsiini infosüsteemi poolel sisestatakse vastaval lehel KIRi isiku kohta uus arstikülastuse aeg, siis saadetakse KIR-ile see info
edasi (teenus võimaldab vajadusel edastada ka kirje muutmise ja kustutamise infot). KIRi pool lisatakse kinnipeetava kalendrisse kirje
ning tehakse vajalik liikumine.
(rest teenus, json andmeformaat)Kinnipeetava arstikülastuse andmete edastamine - uus (EdastaMedArstikylastuseAn
Teenuses on 3 erinevat tegevust - Xtee endpoint/teenus on sama, tegevus ja sisend oleneb HTTP meetodist:
1. LooMedArstikylastuseAndmed (POST päring) - Kinnipeetava arstikülastuse andmete loomine - (teenuse kirjelduses Lisamine)
1. Lisamisel lähtume edastatud kohtumise Med_ID-st, kui seda oma süsteemist ei leia, siis lisame uue kirje. Kui selle ID-
ga kirje on juba olemas, siis midagi enam ei tee, vaid ütleme, et OK on juba lisatud (sest vb tuleb asünkroonselt mitu
korda lisamise soov)
2. UuendaMedArstikylastuseAndmed (PUT päring) - Kinnipeetava arstikülastuse andmete uuendamine - (teenuse kirjelduses
Muutmine)
1. Kui leiame baasist saadetud Med_ID (sh edastatud vangla ning isikukoodi - need kolm välja peavad muudetava kirjega
klappima), siis muudame kohtumise ning liikumise andmeid.
1. Lisanduvad äriloogilisi kontrollid:
1. Kui leia sellist kombinatsiooni, kus ühtiksid Med_ID, Vangla_ID ja isikukood (vang), siis tuleb
veateade (Ei leidnud arstikülastust kombinatsiooniga..).
2. muutmise puhul ei kontrolli, et kas isik on veel samas vanglas
3. 07.09.2026 seisuga kinnipidamise lõppedes, kui tahetakse muuta, siis saab veateate (tühistamisel ei saa,
laseb tühistada).
4. täpsemad võimalikud veateated allpool
5. Samas, kui meie süsteemis on kirje tühistatud, liikumine alanud vms, siis see ei anna veateadet. Sellisel
juhul meie andmeid ei muudeta. Lahkunud/vabanenud isikute osas tuleb tagada kohtumiste tühistamine
läbi töökorralduse.
2. Kui saadetud Med_ID-ga (sh edastatud vangla ning isikukoodiga) kohtumise kirjet ei leia, siis veateade (Ei leidnud
arstikülastust kombinatsiooniga..) ning andmeid ei muuda (ega lisa).
3. TyhistaMedArstikylastuseAndmed (DELETE päring) - Kinnipeetava arstikülastuse andmete tühistamine - (teenuse kirjelduses
Tühistamine)
1. Kui leiame baasist saadetud Med_ID (sh edastatud vangla ning isikukoodiga - need kolm välja peavad muudetava
kirjega klappima), mis on kehtiv, siis tühistame.
1. isanduvad äriloogilisi kontrollid:
1. Kui leia sellist kombinatsiooni, kus ühtiksid Med_ID, Vangla_ID ja isikukood (vang), siis tuleb
veateade (Ei leidnud arstikülastust kombinatsiooniga..).
2. tühistamise juures ei kontrolli eraldi kas isik on veel samas vanglas
3. 07.09.2026 seisuga kinnipidamise lõppedes, kui tahetakse muuta, siis saab veateate (tühistamisel ei saa,
laseb tühistada).
4. täpsemad võimalikud veateated allpool
5. Samas, kui meie süsteemis on kirje tühistatud, liikumine alanud vms, siis see ei anna veateadet. Sellisel
juhul meie andmeid ei muudeta. Lahkunud/vabanenud isikute osas tuleb tagada kohtumiste tühistamine
läbi töökorralduse.
(teenuse struktuuri näide (võib muutuda arenduse käigus):
https://x-tee.ee/catalogue-data/ee-dev/ee-dev/GOV/70000310/kir-arendus/api_6.json
)
Sisend:
Kohustuslik Kohustuslik
(tegevused: (tegevus:
Nimetus Andmetüüp Semantika
Lisamine Tühistamine)
Muutmine)
Alati täidetud.
Vangla ID KIRis.
Vangla ID bigint Jah Jah
Peab alati sisendis täitma, et kontrollida, kuhu andmed saadetakse.
Edastatud vangla id peab ühtima med. süsteemi vangla id-ga vangla
klassifikaatoris.
Alati täidetud.
Kinnipeetava isikukood, kelle andmed edastatakse.
Muudatusi ei salvestata, kui isik ei ole selles vanglas kinnipidamisel st
Isikukood bigint Jah Jah Kinnipidamisel on Jah st on kinnipidamisel med. süsteemi vangla järgi
selles vanglas.
Erand muutmise ja tühistamise puhul, kui isik on teises vanglas või ei ole
enam vanglas, siis lubame nii muutmist kui ka tühistamist.
Töökorraldusega tagatakse lahkunute kohtumistega tegelemine.
Alati täidetud.
Med süsteem saadab oma süsteemi sisese ID, selle alusel teeme kindlaks,
et kas meil on olemas see kohtumine.
Med_ID varchar Jah Jah
Med. süsteem peab ise unikaalsuse tagama asutuse st vangla piires. Kui
ühes vanglas on kaks erinevat teenuspakkujat, siis peavad nad tagama, et
neil omavahel ei tekiks MED_ID edastamisega konflikti. Nt lisama
MED_ID-le ette mingi unikaalse tunnuse, nt "hambar" vms.
datetime Jah - Edastatakse kohtumise alguskuupäev ja kellaaeg
AlgusAeg
Kui algusaeg on minevikus, siis liikumist ei looda enam.
Loppaeg datetime Jah - Edastatakse kohtumise lõppkuupäev ja kellaaeg
varchar Ei - Palve, et edastaksite med.süsteemi poolsed ruumide ID-d (kujul nagu
hakkate neid teenuses edastama), et hakata seoseid looma KIRi ruumide
klassifikaatoriga
Edastatakse vastava med. süsteemi ruumi ID, millele oleme loonud
vastavuse KIRi ruumidega.
Kirje lisamisel ja muutmisel kohustuslik täita.
Sihtkoht (Vastuvõtu tühistamisel välja ei ole)
KIRi pool püütakse leida vastav ruum KIRi KL-ist ning kui ei leita, siis
täidetakse üldise med. osakonna väärtusega vastavas vanglas.
(Kaasnev korralduslik pool:
Kui klassifikaator meditsiini pool muutub, siis tuleb sellest meid
teavitada, saame võrdlustabelit täiendada. Infosüsteemide vahel seda
suhtlust ei hakka tegema.)
Meditsiini infosüsteem edastab med. töötaja isikukoodi, kes vastuvõttu
teostab.
Kui isikukoodi põhjal leiame KIRi töötamise, siis täidame KIRi töötamise
andmetega. Kui ei ole, siis selle isiku andmeid ei salvestata, täidame
siitpoolt kokkulepitud konstandiga vastavas vanglas - 'tervishoiu
Vastuvõtja /Isikukood/ Ei - töötaja' (uus kl-i väärtus).
(TÄIENEMISEL/TÄPSUSTAMISEL 07.09.2026): kui med
infosüsteemist tahetakse edastada mingit konkreetset väärtust, kus
vastuvõtja oleks "valvemeedik" ja ka KIRis oleks nii, siis seda saab teha.
Hetkel see lahenemisel/täpsustamisel, et mis väärtus see täpsemalt on, et
mida med IS saatma selleks peab
Meditsiini infosüsteem edastab med. töötaja isikukoodi, kes andmed
edastab.
Kui isikukoodi põhjal leiame KIRi töötamise, siis täidame KIRi töötamise
Kande tegija /Isikukood/ Ei Ei andmetega. Kui ei ole, siis selle isiku andmeid ei salvestata, täidame
siitpoolt kokkulepitud konstandiga.
Tekitame siia iga asutuse med. poole jaoks vähemalt 1 fiktiivse töötamise
ning siis kasutame seda, kui ei suuda sisendist töötamist tuvastada.
Vajadusel lisatakse kirjele kommentaar. See kommentaar on mõeldud
info lisamiseks saatmist teostavale ametnikule. Kui on mingi oluline
nüanss.
Lisamise ja muutmise puhul selle kommentaari lisame nii kalendrisse kui
Kommentaar varchar Ei Ei
ka liikumise kirje juurde. Kirje muutmisel jäetakse vana kirje alles ja
lisatakse uus juurde kujul "muudetud xx.xx.xxxx kell xx:xx: text"
Tühistamise puhul salvestatakse tühistamise põhjuse lahtrisse ettetäidetud
tekstiga 'Tühistatud meditsiiniinfosüsteemist'.
Jätame selle välja teenuse struktuuri, aga esialgu ei kasutata
Lisainfo varchar Ei -
Eesmärk info kuvamiseks kinnipeetavale vangiportaalis tulevikus
Väljund:
Nimetus Andmetüüp Kohustuslik Sisu
Med_ID varchar jah Haigla süsteemist päringuga sissetulnud ID
Veakood faultcode Tingimuslik Kui esineb viga, siis päringu vastuses vastava vea kood.
Vea kirjeldus faultstring Tingimuslik Tagastatakse veakoodile vastava vea kirjeldus.
Võimalikud (teadaolevad) veakoodid nimetatud teenuste puhul:
Kood Sisu
200 OK, lisamine / muutmine/ tühistamine õnnestus. / Kirje oli juba lisatud. / Kirje on juba tühistatud
10 VanglaId väärtus on puudu.
20 Kinnipeetava puhul peab olema täidetud isikukood.
400 Isikukood: The Isikukood field is required.
80 Isikut ei leitud.
90 Isik ei viibi arvel.
100 Isik ei ole kinnipidamisel vanglas.
100 Isik on kinnipidamisel teises vanglas.
400 AlgusKp hilisem kui LoppKp. /Kohtumise algus ei saa olla hilisem kui lõpp.
404 Ei leidnud arstikülastust kombinatsiooniga MED_ID=xxxxx, VanglaId=y, Isikukood=zzzzzzzzzzz.
400 Liikumise kommentaari pikkus ületab 1000 tähemärki.
400 Arstikülastus on juba tühistatud.
400 AlgusAeg: The AlgusAeg field is required.
400 Loppaeg: The Loppaeg field is required.
..
Loetelu võib täieneda arendustööde ja testi käigus
TÖÖVÕTULEPINGU NR 4-13/3-26/63-1 ERITINGIMUSED
Viru Vangla, registrikood 70008144, asukoht Ülesõidu tn 1/3, 41536 Jõhvi, mida esindab
Vanglateenistuse haldusosakonna juhataja Risto Lindeberg (edaspidi nimetatud „Tellija“) ja
Gennet Laboratories AS, registrikood 10210164, asukoht Tehase tn 16, 50107 Tartu, keda esindab
juhatuse liige Heiki Sissask (edaspidi nimetatud “Töövõtja”),
edaspidi koos nimetatud „Pooled“ ja eraldi „Pool“,
sõlmisid käesoleva töövõtulepingu (edaspidi “leping”) alljärgnevas:
1. Lepingu objekt
Lepingu objektiks on töövõtja poolt kinnipeetavate arstikülastuse andmete edastamise arenduse
teostamine (edaspidi „tööd“), mida töövõtja kohustub tegema vastavalt lepingus ja lepingu lisades
sätestatud tingimustele. Tööde täpsem kirjeldus on toodud lepingu lisas 1 teenuse kirjeldus.
2. Tööde teostamise aeg ja tähtpäevad
Töövõtja teostab lepingu objektiks olevad tööd ja annab need elektrooniliselt tellijale üle hiljemalt
11.12.2026.a.
3. Lepingu hind
3.1. Lepingu alusel töövõtja poolt teostatavate tööde kogumaksumuseks on 19 680 eurot, millele
lisandub käibemaks õigusaktidega sätestatud korras (edaspidi nimetatud „lepingu hind“).
3.2. Lepingu hind on lõplik ja sisaldab kõiki lepingu täitmise kulusid.
3.3. Tellija tasub lepingu hinna ühe maksena pärast tööde vastuvõtmist üleandmise-vastuvõtmise
aktiga ja selle alusel töövõtja esitatud arve saamist.
3.4. Pärast tööde üleandmist kontrollib tellija 10 tööpäeva jooksul töö vastavust nõuetele ja annab
töövõtjale teada, kas tööd on teostatud nõuetekohaselt. Töö loetakse vastuvõetuks kui tellija on
allkirjastanud üleandmise-vastuvõtmise akti.
3.5. Töövõtja esitab Tellijale arve e-arvena. E-arvet on võimalik saata e-arvete operaatori vahendusel.
E-arve loetakse laekunuks selle operaatorile laekumise kuupäevast. Arve maksetähtaeg peab
olema vähemalt 15 tööpäeva arvates selle kättesaamisest.
4. Erisätted
4.1. Pooled lepivad kokku, et Lepingu esemeks oleva KIR-i jätkuarenduse käigus HEDA infosüsteemis
tehtavad muudatused, täiendused, integratsioonid ja muu tarkvaraline funktsionaalsus on HEDA
infosüsteemi lahutamatu osa. HEDA infosüsteemi, selle lähtekoodi, arhitektuuri, komponentide
ning HEDA infosüsteemis Lepingu täitmiseks loodud või täiendatud tarkvaralise funktsionaalsuse
intellektuaalomandi õigused kuuluvad Töövõtjale.
4.2. Tellijale antakse Lepingu täitmise tulemusena HEDA infosüsteemis realiseeritud funktsionaalsuse
kasutamiseks territoriaalselt piiramatu ja täiendava tasuta lihtlitsents ajaks, mil Ida-Viru Keskhaigla
kasutab HEDA infosüsteemi. Lihtlitsents lõpeb automaatselt Ida-Viru Keskhaigla HEDA
infosüsteemi kasutusõiguse lõppemisel. Juhul kui HEDA infosüsteemi (uus)kasutajaks saab
tulevikus täiendavalt muu haigla ja eesmärgiliselt soovib kasutada tervishoiuteenuse osutamiseks
käesoleva Lepingu täitmise käigus loodud funktsionaalsust - on Töövõtjal õigus anda vastavale
haiglale funktsionaalsuse kasutamiseks lihtlitsents HEDA infosüsteemi kasutusõiguse kehtivuse
ajaks, sh Tellija nõusolek loetakse etteulatuvalt vaikimisi antuks. Kasutusõigus ei hõlma HEDA
lähtekoodi ega selle komponentide eraldiseisvat kasutamist, võõrandamist või edasiarendamist
väljaspool HEDA infosüsteemi.
4.3. Töövõtjal säilib õigus Lepingu täitmisel HEDA infosüsteemis loodud või täiendatud
funktsionaalsust, komponente, tehnilisi lahendusi ja integratsioonimehhanisme kasutada, muuta,
edasi arendada ja taaskasutada ning võimaldada nende kasutamist teistele HEDA infosüsteemi
kasutavatele tervishoiuteenuse osutajatele ilma Tellija täiendava nõusolekuta.
4.4. Käesolevad eritingimused ei piira Tellija õigusi KIR jätkuarendustele, Tellija materjalidele,
andmetele ega muudele Lepingu alusel loodud tulemitele, mis on HEDA infosüsteemist ja selle
tarkvaralisest funktsionaalsusest iseseisvalt eristatavad.
4.5. Käesolevas punktis sätestatu on HEDA infosüsteemi ja selles realiseeritud funktsionaalsuse osas
ja lepingulise vastuolu korral kuuluvad kohaldamisele käesolevad eritingimused ja mitte Lepingu
üldtingimuste punktides 7.1 ja 11 sätestatud tingimused.
5. Volitatud esindajad
5.1. Tellija volitatud esindajaks lepingu täitmisega seotud küsimustes, sh täitmise kontrollimisel ja tööde
vastuvõtmisel on Argo Lauk, tel +372 750 0881, e-post
[email protected], või teda
asendav isik.
5.2. Töövõtja volitatud esindajaks lepingu täitmisega seotud küsimustes, sh tööde üleandmisel on Birgit
Ärm, tel +372 529 1991, e-post
[email protected] .
6. Lepingu lisad
Lepingu juurde kuuluvad allkirjastamise hetkel lisadena alljärgnevad dokumendid:
6.1. Lisa 1 – Teenuse kirjeldus;
6.2. Lisa 2 – Töövõtja pakkumus.
7. Muud sätted
7.1. Lepingu osaks on lisaks käesolevatele eritingimustele ja nende lisadele töövõtulepingute
üldtingimused. Töövõtja kinnitab, et on üldtingimustega tutvunud elektroonselt Justiits- ja
Digiministeeriumi kodulehel aadressil https://www.justdigi.ee/majandusteave-ja-
riigihanked#justiitsministeeriumi_lepingute_uldtingimused ning tal oli võimalik nende kohta küsida
selgitusi ja teha ettepanekuid eritingimustes üldtingimuste kohaldamata jätmiseks või muutmiseks.
Pooled kinnitavad, et kõik üldtingimused on mõistlikud ega saa seetõttu olla tühised.
7.2. Kui konkreetsest sättest ei tulene teisiti, tähendab mõiste „leping” lepingu eritingimusi ja
üldtingimusi koos kõikide lisadega. Lepingu dokumentide prioriteetsus on järgmine: eritingimused
(I), lepingu lisad (II) ja üldtingimused (III). Vastuolude korral lepingu dokumentide vahel prevaleerib
prioriteetsem dokument. Lepingu sõlmimisega kaotavad kehtivuse kõik töövõtja hinnapakkumises
või muus sarnases dokumendis sisalduvad tingimused niivõrd, kuivõrd need on vastuolus lepingu
eritingimuste ja üldtingimustega.
Tellija Töövõtja
/allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/