Pöördumine

Tehniline kirjeldus – SRT arvete failist laadimine Mõisted, lühendid Mõiste/lühend Kirjeldus SKA Sotsiaalkindlustusamet SKA iseteenindus Sotsiaalkindlustusameti iseteenindus ( https://iseteenindus.sotsiaalkindlustusamet.ee/ ) SKAIS 1 Sotsiaalkaitse infosüsteem (vana platvorm) SRT Sotsiaalne rehabilitatsiooni teenus TO Teenuse osutaja SO Sotsiaalteenuse osutaja Ä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 koondaruande i d, 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. 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. Tööde kirjeldus Funktsionaalsed nõuded 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. 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. 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. 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. Automatiseerimise erandid Üksikud aruanded, lisaaruanded ja varasemate perioodide parandusaruanded ei kuulu automaatse töötluse alla. Menetleja sisestab need käsitsi. 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. 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 . Hangitav skoop Lepingu skoobiks on : analüüsi-, arendus- ja juurutustööd koos (automaat)testimistega ning seotud komponentide ühise töökindluse tagamine; m uud tööd, mis on vajalikud arendustöö tõrgeteta toimimise tagamiseks. Täitja peab tegema vajadusel koostööd teiste väliste osapooltega . 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. Dokumentatsioon Vastavalt punktis 5 kirjeldatud skoobile tuleb töö käigus luua ja täiendada SKAIS 1 dokumentatsiooni . Dokumentatsiooni täpsed liigid ja sisu formaat lepitakse kokku tööde käigus . Mittefunktsionaalsed nõuded Mittefunktsionaalsete nõuete täitmisel tuleb lähtuda TEHIKu Mittefunktsionaalse te nõu ete viimasest versioonist ja raamlepingus (3-9/2978-1) ning selle lisades kirjeldatud nõuetest. 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. 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 . Tööde teostamise tähtaeg E elnevalt kirjeldatud tööd antakse üle (so Jira piletid "Ready for AT" ja toodangu keskkonda paigaldatav kvaliteetne lähtekood) hiljemalt 28.1 2 .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 . Lisad Lisa 1- SRT arvete CSV failist laadimi se analüüs Lisa 2 – tabeli näidisfail SRT arvete CSV failist laadimine Versioon Kuupäev Analüütik Muudatuse sisu Jira issue Kinnitus Kinnitaja kommentaarid nr 4 5.09.2025 - - Liina Olgo Kinnitan äri poolt analüüsi koos S1DEV-303 - Analüüs: juhtivspetsi piletis olevate kommentaaride SRT arvete CSV failist alist ja täiendustega. Vajalik ka Ove laadimine andmebaasi Kangur kinnitus. CONFIRMED 4 6.09.2025 Ove Kinnitan äri poolt analüüsi koos S1DEV-303 - Analüüs: Kangur piletis olevate kommentaaride SRT arvete CSV failist analüütik ja täiendustega. laadimine andmebaasi CONFIRMED Analüüsi Nimi, kes Kui esialgset versiooni muudetakse siis Kinnitaja Kinnitus ja kinnitamise kuupäev valmimise analüüsi vastav info, et mis ümber tehti või nimi ning vajadusel kommentaarid kuupäev teostas analüütiku täpsustus/kommentaar analüüsi kohta analüüsi kohta Lähtülesanne pileti SKAIS-1839 - SRT arvete CSV failist laadimine andmebaasi. CLOSED alusel SRT teenuse osutajad saadavad meile oma arved isikute ning teenuste kaupa, me määrame nende alusel, mis finantseerimise sihtgruppi nad kuuluvad. Edasi salvestame kõik baasi mineva info csv-sse ning sooviks selle siis rida-rida haaval baasi üles laadida. Hetkel toimub selle info sisestamine käsitsi läbi SKAIS_AE. Samas sooviks, et praegu veebis toimuvad kontrollid toimiksid ka CSV faili üleslaadimisel, näiteks kontroll, mis vaatab kas isikul on vastava teenuse jääki veel alles jne. Programmi muudatused ja täiendused: 1. Kasutaja avab vastava menüüpunkti. Avaneb failide avamise aken, kasutaja valib oma masina failisüsteemist imporditavad failid. 2. Süsteem kuvab valitud failide nimekirja. Iga faili kohta kuvatakse kokkuvõtlik kontrollstatistika (arveid kokku, ridu kokku, summa kokku) . 3. Kasutaja käivitab impordiprotsessi vajutades nuppu "Sisesta arved". Tulemusena laetakse korrektsed failid andmebaasi. Laadimise käigus teostatakse samad kontrollid mis praegu sisestusvormidel arve sisestamisel. Iga faili kohta kuvatakse ebakorrektsete kirjete arv. 4. Kui failis on viga siis ei jäetakse laadimata kogu fail ka korrektsed kirjed. 5. Kasutaja saab laadida alla vigaste failide puhul vigade raporti. Vigade raportis sisalduvad csv formaadis vigased kirjed, kus lisaks on täidetud märkuste lahter, mis sisaldab vea kirjeldust. 6. Kasutaja saab laadida alla kõikide failide vearaportid ühe zip failina vajutades "Laadi vearaportid alla" 7. Arved kinnitatakse automaatselt st. (KUUP_KINN ja KUUP_KINN2) kuupäevad täidetakse automaatselt. Kasutaja ei pea arveid ükshaaval üle kinnitama. Faili formaat Näidisfail on lisatud dokumendi manuste hulka. Väli Päis/Rida Kirjeldus otsuse_nr P Otsuse number teenuse ostuaja reg_kood P Osutaja reg kood arve_nr P Arve number arve_valjastamise_kp P Arve väljastamise kuupäev formaadis pp.kk.aaaa (nt 07.05.2024) arve_saabumise_kp P Arve saabumise kuupäev formaadis pp.kk.aaaa (nt 07.05.2024) summa_kokku P Arve summa. Murdosa eraldaja on koma (nt 216,84) kas_teenus_jatkub P Kas teenus jätkub JAH/EI markused P Märkused arve kohta osutamise_algus R Teenuse osutamise alguse aeg formaadis pp.kk.aaaa (nt 01.04.2024) ostuamise_lopp R Teenuse osutamise lõpu aeg formaadis pp.kk.aaaa (nt 30.04.2024) teenuse_kood R Teenuse kood nt 2001 teenuse_kogus R Teenuse kogus nt 2 teenuse_yhiku_hind R Teenuse ühiku hind. Murdosa eraldaja on koma nt 31,4 hind_kokku R Teenuse hind kokku. Murdosa eraldaja on koma nt 62,8  1. Kui arvel on mitu rida siis esitatakse iga reaga päise andmed uuesti. 2. Failis tuleb sama arve read esitada üksteise järel 3. Päise väärtused loetakse esimesest kirjest, järgnevad read seotakse päisega välja arve_nr alusel. Mittefunktsionaalsed nõuded 1. Faili laadimist saab teha ainult kõige kõrgema SKA osakonna töötaja (osakonna nimi "Sotsiaalkindlustusamet"). Faili laadimisel ei kontrollita töötaja õigust vastavat arvet sisestada osakonna põhiselt. otsuse_nr;teenuse ostuaja reg_kood;arve_nr;arve_valjastamise_kp;arve_saabumise_kp;summa_kokku;kas_teenus_jatkub;markused;osutamise_algus;ostuamise_lopp;teenuse_kood;teenuse_kogus;teenuse_yhiku_hind;hind_kokku K00076389;11043484;04.25_1;30.04.2024;07.05.2024;216,84;JAH;;01.04.2024;30.04.2024;2001;2;31,4;62,8 K00076389;11043484;04.25_1;30.04.2024;07.05.2024;216,84;JAH;;01.04.2024;30.04.2024;2003;1;31,64;31,64 K00076389;11043484;04.25_1;30.04.2024;07.05.2024;216,84;JAH;;01.04.2024;30.04.2024;2007;4;30,6;122,4 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: Lepingu ese Lepingu esemeks on hanke „ SRT arvete CSV failist laadimine “ olevas tehnilises kirjelduses nimetatud tööd (edaspidi tööd ). Lepingu tööde maht tundides/kuudes/maksumusena/maksimaalse mahuna . Töö üleandmise ja vastuvõtmise tingimused Täitja annab töö d üle etappide kaupa vastavalt hankelepingu tehnilises kirjelduses oleva te le tähtaegadele (Lisa 1 punkt 13) . Tellitavad tööd antakse vastuvõtutestimiseks üle vastavalt lepingu tehnilises kirjelduses kokkulepitud tingimustele. Tellija vaatab töö üle vastavalt raamlepingu tingimustele. Koos üle antava tööga annab täitja tellijale üle kõik tööde intellektuaalse omandi õigused vastavalt raamlepingus kirjeldatule. Lepingu hind Tellija tasub lepingu alusel tellitud tööde eest kokku ___ (maksumus sõnadega) eurot käibemaksuta. Täitja esitab tellijale e-arve pärast töö üleandmise-vastuvõtmise akti allkirjastamist. Poolte vahelised teated ja kontaktisikud Teadete edastamisel ja kätte toimetamisel lähtutakse raamlepingu regulatsioonist. Tellija kontaktisikuks lepingu täitmisel on Ranel Tasane , tel + 372 7943 900 , e-post ranel.tasane @tehik.ee või tema asendaja. Täitja kontaktisikuks lepingu täitmisel on ________, tel ________, e-post ______ või tema asendaja. Lõppsätted Leping jõustub sellele poolte poolt allakirjutamise hetkest ja kehtib kuni poolte poolt oma lepinguliste kohustuste täitmiseni. Lepingu dokumendid koosnevad riigihanke alusdokumentidest, sh lepingu lisadest, lepingu muudatustest ja pakkumusest. Lepingu lahutamatuteks osadeks lepingu sõlmimise hetkel on järgmised dokumendid , mida ei allkirjastata koos lepinguga : Lisa 1 - Tehniline kirjeldus; Lisa 2 – Pakkumus ; 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 2 9 . 09 .202 5 kell 1 5 :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 meeskonnalii kmed isikuliselt, tuues välja ka meeskonnaliikme te 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 ranel.tasane @tehik.ee . Pakkumusettepanekuga koos edastatavad dokumendid: Lisa 1. Hankelepingu eseme tehniline kirjeldus; Lisa 2 . Hankelepingu projekt.