Pöördumine

Tehniline kirjeldus – SRT arvete failist laadimine

1. Mõisted, lühendid

Mõiste/lühend
Kirjeldus
SKA
Sotsiaalkindlustusamet
SKA iseteenindus
Sotsiaalkindlustusameti iseteenindus (https://iseteenindus.sotsiaalkindlustusamet.ee/)
SKAIS1
Sotsiaalkaitse infosüsteem (vana platvorm)
SRT
Sotsiaalne rehabilitatsiooni teenus
TO
Teenuse osutaja
SO
Sotsiaalteenuse osutaja

2. Äriline taust

Praegune SRT arvete menetlemise protsess on ressursimahukas ja aeganõudev. TO esitavad arveid isikute ja osutatud teenuste kaupa. Igakuiselt esitab umbes 120 teenuseosutajat koondaruandeid, mis hõlmavad keskmiselt 7200 isikut ja 20 000 teenuse rida. Need aruanded sisaldavad iga teenuseosutaja kuu jooksul teenuseid saanud isikute ja neile osutatud teenuste koondvaadet. Selle alusel omakorda määratakse finantseerimise sihtgrupp ja koondatakse kogu baasi minev info CSV faili, kuid andmete SKAIS-AEsse kandmine toimub praegu käsitsi.
Kuigi SKASI-AEs on olemas erinevad kontrollimehhanismid, näiteks teenuse jäägi kontroll, ei rakendu need praegu CSV faili üleslaadimisel. See tähendab, et potentsiaalsed vead, nagu teenuse jäägi ületamine või vale sihtgrupi määramine, võivad jääda tuvastamata. See omakorda võib kaasa tuua vajaduse andmete korrigeerimiseks, lisatööd menetlejatele ja viivitusi arvete menetlemisel ja teenuse eest tasumisel.

3. Töö eesmärk

Töö eesmärgiks on luua SKAIS-AE süsteemi funktsionaalsus, mis võimaldab SRT koondaruannete automaatset üleslaadimist, eelkontrolli, vigaste aruannete tagasisidestamist ja korrektsete aruannete automaatset kinnitamist, selleks, et vähendada menetlejate käsitööd, tagada andmete kvaliteet ja kiirendada arvete töötlemise protsessi.

4. Tööde kirjeldus

4.1. Funktsionaalsed nõuded

4.1.1. Failide üleslaadimine ja eelkontroll
• Kasutaja saab avada failide üleslaadimise menüüpunkti ja valida oma arvutist CSV või ZIP formaadis failid.
• Süsteem kuvab valitud failide kokkuvõtte (faili nimi, ridade arv, arvete arv, summa).
• Kasutaja saab käivitada impordiprotsessi nupuga „Sisesta arved”.
• Impordi käigus:
◦ Teostatakse automaatsed eelkontrollid (teenuseõiguse kontroll, puude/rehabilitatsiooniplaani kontroll, rahastuse sihtrühma määramine, MISP2 registreeringu kontroll, kuupäevade õigsus, topelt SO-de tuvastamine, kehtivuse kontroll teenuse perioodil).
◦ Kontrollitakse kehtivaid ärireegleid (nt limiitide kontroll).
◦ Kui fail sisaldab vigu, jäetakse kogu fail laadimata.

4.1.2. Vigaste aruannete käsitlemine

• Süsteem genereerib iga vigase koondaruande kohta tagasiside CSV faili, kus säilitatakse algsed andmed ja lisatakse veakirjeldus viimasesse lahtrisse.
• Kasutaja saab:
◦ Alla laadida üksikute failide vearaporteid.
◦ Alla laadida kõigi failide vearaportid korraga ZIP formaadis.
• ZIP konteinerite tugi: süsteem peab suutma töödelda mitut vigast koondaruannet sisaldavat ZIP faili ning genereerima iga aruande kohta eraldi tagasisidefaili.

4.1.3. Korrektsete aruannete käsitlemine

• Kui fail läbib kõik kontrollid, imporditakse andmed andmebaasi.
• Kõik read märgitakse automaatselt seisu 3 (EXP ja PEA roll lõpetatud).
• Süsteem genereerib kinnituseks korrektse koondaruande CSV faili.
• Süsteem täidab automaatselt väljad KUUP_KINN ja KUUP_KINN2 – kasutaja ei
pea arveid eraldi kinnitama.

4.1.4. Tagasiside ja paranduste kordustsükkel

• Menetleja saab süsteemilt teavituse vigasest aruandest koos veakirjeldusega.
• Menetleja võtab ühendust teenuseosutajaga vigade parandamiseks.
• Kui parandatud aruanne on saadud, laaditakse see uuesti üles ning protsess käivitatakse algusest.

4.1.5. Automatiseerimise erandid

• Üksikud aruanded, lisaaruanded ja varasemate perioodide parandusaruanded ei kuulu automaatse töötluse alla. Menetleja sisestab need käsitsi.

4.2. Failiformaat

• Fail on CSV, kus igal real on:
◦ Päise väljad: otsuse_nr, teenuse_ostaja_reg_kood, arve_nr, arve_valjastamise_kp, arve_saabumise_kp, summa_kokku, kas_teenus_jatkub, markused.
◦ Reaväljad: osutamise_algus, osutamise_lopp, teenuse_kood, teenuse_kogus, teenuse_yhiku_hind, hind_kokku.
• Kui arvel on mitu rida, tuleb iga rea kohta korrata päise väljad.
• Sama arve read peavad olema failis järjestikku.
• Päise väärtused loetakse esimesest kirjest, järgmised read seotakse arve_nr järgi.
• Tabeli näidis on TK Lisa 2.

4.3. Täiendavad nõuded

• Failide üleslaadimist saab teostada ainult SKA kõrgeima taseme osakonna töötaja (osakonna nimi: „Sotsiaalkindlustusamet”).
• Failide laadimisel ei kontrollita kasutaja õigust osakonna põhiselt.
• Süsteem peab suutma töödelda keskmiselt 120 teenuseosutaja koondaruannet kuus.

Arendustöö aluseks teostatud analüüs on TK lisa 1.

5. Hangitav skoop

Lepingu skoobiks on:
• analüüsi-, arendus- ja juurutustööd koos (automaat)testimistega ning seotud komponentide ühise töökindluse tagamine;
• muud tööd, mis on vajalikud arendustöö tõrgeteta toimimise tagamiseks.
Täitja peab tegema vajadusel koostööd teiste väliste osapooltega.

6. Tööprotsess

Tööraamistik peab tuginema etapiviisilisele planeerimisele, võimaldades arendusmeeskonna prioriteete jooksvalt muuta. Täitja peab tagama piisava kaasamise ja ülevaadete andmise Tellijale.
• Tööde loetelu tekib eelnevalt kokkulepitud backlogi alusel ja hallatakse Jiras;
• Tööraamistik peab võimaldama süsteemset ülevaadet iga kokkulepitud töö saavutustest;
• Täpsem protsess lepitakse kokku tööde käigus.

7. Dokumentatsioon

Vastavalt punktis 5 kirjeldatud skoobile tuleb töö käigus luua ja täiendada SKAIS1 dokumentatsiooni.
Dokumentatsiooni täpsed liigid ja sisu formaat lepitakse kokku tööde käigus.

8. Mittefunktsionaalsed nõuded

Mittefunktsionaalsete nõuete täitmisel tuleb lähtuda TEHIKu Mittefunktsionaalsete nõuete viimasest versioonist ja raamlepingus (3-9/2978-1) ning selle lisades kirjeldatud nõuetest.

9. Tööde üleandmine

Arendustööde lähtekoodi tarne toimub pideva integreerimise (continuous integration) teel.
Tööde järjekord, üleandmise aeg ja UAT tagasiside andmise aeg lepitakse kokku tööde käigus taasesitamist võimaldavas vormis (tellija ja täitja poolt).
Töö üleandmisel kontrollib tellija üle töö nõuetekohasuse ning annab vajadusel tähtaja töö parandamiseks.

10. Tulemid

Valminud tööde tulemid antakse üle käesoleva dokumendi p-s 11 märgitud ajahetkel üleandmise-vastuvõtmise aktiga, tööde tulemid peavad sisaldama:
• Viiteid dokumentatsioonile Confluence’is;
• Viited tehtud töödele (Jira piletitena);
• Viiteid koodile versioonihaldus keskkonnas.

11. Tööde teostamise tähtaeg

Eelnevalt kirjeldatud tööd antakse üle (so Jira piletid "Ready for AT" ja toodangu keskkonda paigaldatav kvaliteetne lähtekood) hiljemalt 28.12.25.
Tööde üleandmisele järgneb tellija poolne tööde testimine mõistliku aja jooksul ja vajadusel täitja poolne paranduste tegemine üle antud töödes, kui testimise käigus ilmneb, et tööd ei ole lõpptähtajaks teostatud nõuetekohaselt. Tööd loetakse teostatuks tööde üleandmise-vastuvõtmise akti tellija poolt allkirjastamise hetkest.

12. Lisad

◦ Lisa 1- SRT arvete CSV failist laadimise analüüs
◦ Lisa 2 – tabeli näidisfail

Hankeleping nr...
SRT arvete CSV failist laadimine

Tervise ja Heaolu Infosüsteemide Keskus (edaspidi tellija), registrikood 70009770, aadress Pärnu mnt 132, 11317 Tallinn, keda esindab põhimääruse alusel direktor Margus Arm ja
­­­_____, registrikood_______., aadress ________, keda esindab põhikirja alusel _____ (edaspidi täitja),
edaspidi eraldi pool või koos pooled, sõlmisid raamlepingu nr 3-9/2978-1 alusel käesoleva hankelepingu (edaspidi leping) alljärgnevas:
1. Lepingu ese
1.1. Lepingu esemeks on hanke „SRT arvete CSV failist laadimine“ olevas tehnilises kirjelduses nimetatud tööd (edaspidi tööd).
1.2. Lepingu tööde maht tundides/kuudes/maksumusena/maksimaalse mahuna.
2. Töö üleandmise ja vastuvõtmise tingimused
2.1. Täitja annab tööd üle etappide kaupa vastavalt hankelepingu tehnilises kirjelduses olevatele tähtaegadele (Lisa 1 punkt 13).
2.2. Tellitavad tööd antakse vastuvõtutestimiseks üle vastavalt lepingu tehnilises kirjelduses kokkulepitud tingimustele.
2.3. Tellija vaatab töö üle vastavalt raamlepingu tingimustele.
2.4. Koos üle antava tööga annab täitja tellijale üle kõik tööde intellektuaalse omandi õigused vastavalt raamlepingus kirjeldatule.
3. Lepingu hind
3.1. Tellija tasub lepingu alusel tellitud tööde eest kokku ___ (maksumus sõnadega) eurot käibemaksuta. 
3.2. Täitja esitab tellijale e-arve pärast töö üleandmise-vastuvõtmise akti allkirjastamist.
4. Poolte vahelised teated ja kontaktisikud1
4.1. Teadete edastamisel ja kätte toimetamisel lähtutakse raamlepingu regulatsioonist.
4.2. Tellija kontaktisikuks lepingu täitmisel on Ranel Tasane, tel +372 7943 900, e-post [email protected] või tema asendaja.
4.3. Täitja kontaktisikuks lepingu täitmisel on ________, tel ________, e-post ______ või tema asendaja.
5. Lõppsätted
5.1. Leping jõustub sellele poolte poolt allakirjutamise hetkest ja kehtib kuni poolte poolt oma lepinguliste kohustuste täitmiseni.
5.2. Lepingu dokumendid koosnevad riigihanke alusdokumentidest, sh lepingu lisadest, lepingu muudatustest ja pakkumusest.
5.3. Lepingu lahutamatuteks osadeks lepingu sõlmimise hetkel on järgmised dokumendid, mida ei allkirjastata koos lepinguga:
5.3.1. Lisa 1 - Tehniline kirjeldus;
5.3.2. Lisa 2 – Pakkumus;
6. Poolte allkirjad

Tellija:


Täitja:

HANKIJA NIMI: Tervise ja Heaolu Infosüsteemide Keskus

Pakkumusettepaneku nimetus: „SRT arvete CSV failist laadimine“

Käesolevaga teeb Tervise ja Heaolu Infosüsteemide Keskus (Hankija) Teile ettepaneku esitada pakkumus „SRT arvete CSV failist laadimine“ teostamiseks raamlepingu nr 3-9/2978-1 alusel.

Pakkumuse esitamise tähtaeg on järjekorras esimesel partneril 29.09.2025 kell 15:00. Pakkumus saata e-posti aadressile [email protected].

Pakkumus tuleb esitada eesti keeles ja digitaalselt allkirjastatult.
Pakkumus esitatakse Hankelepingu eseme tehnilises kirjelduses (lisa 1) toodud tööde teostamiseks. Alternatiivsete pakkumuste esitamine ei ole lubatav.
Pakkumusena tuleb esitada:
• Tööde teostamiseks planeeritud meeskonnaliikmed isikuliselt, tuues välja ka meeskonnaliikmete roll;

Töid teostatakse jooksva tunnihinna arvestuse põhiselt. Tööde ajaaruandes tuuakse välja tööde teostamiseks kulunud töötunnid isikute lõikes, seostades nimetatud isikud Jiras logitud tööülesannete ja kirjeldatud tegevustega.

Töid tellitakse mahus kuni 22 400 eurot (ilma km-ta). Pakkumuse esitamisega kinnitab pakkuja, et lepingu tähtaja saabumiseks on teostatud Hankelepingu eseme tehnilises kirjelduse (lisas 1) punktis 4 toodud tööd. Pakkujal ei ole õigust tööde teostamiseks nõuda täiendavat tasu või väljamakseid.
Küsimuste tekkimise korral palun võtke ühendust enne pakkumuse esitamise tähtaega aadressil [email protected].

Pakkumusettepanekuga koos edastatavad dokumendid:

Lisa 1. Hankelepingu eseme tehniline kirjeldus;
Lisa 2. Hankelepingu projekt.