dokumendiregister.ee
OtsingAsutusedMCP
Otsingâ€șRegistrite ja InfosĂŒsteemide Keskus
LepingAvalik

Teenuse kasutuse leping

Registrite ja InfosĂŒsteemide Keskus · 3. mĂ€rts 2026
Viit
2/20-26
Registreeritud
3. mÀrts 2026
Dokumendi liik
Leping
Funktsioon
4 Finantseerimine ja raamatupidamise arvestus
Sari
4-3 Lepingud juriidiliste isikutega, aktid
Toimik
4-3-1/2026
Vastutaja
Aleksandr Beloussov (Registrite ja InfosĂŒsteemide Keskus, Teenuste arenduse valdkond, Null-aruandluse tiim)

Failid

  • 📎220-26 03.03.2026 Leping (1).asice1463 KB

Sisu (failidest)

E-ARVELDAJA E-ARVE OPERAATORTEENUSE VAHENDUSLEPING nr 2/20-26 Registrite ja InfosĂŒsteemide Keskus (edaspidi RIK), (registrikoodiga 70000310), asukohaga Lubja tn 4, 10115 Tallinn, mida pĂ”himÀÀruse alusel esindab asedirektor direktori ĂŒlesannetes Aive Normak ja Fitek OÜ (edaspidi edasipakkuja) (registrikoodiga 16869243), asukohaga Veerenni 38b, Tallinn 10138, mida pĂ”hikirja alusel esindab juhatuse esimees Mait Sooaru, keda edaspidi nimetatakse Lepingus pool vĂ”i koos poolteks, sĂ”lmisid e-arvete operaatorteenuse vahenduslepingu (edaspidi nimetatud leping) alljĂ€rgnevas: 1. Lepingu objekt ja Lepingu dokumendid 1.1. KĂ€esoleva lepingu alusel vĂ”imaldab RIK edasipakkuja tarkvara kaudu pÀÀseda ligi e-arveldaja e- arve operaatori teenusele, mille tulemusena saavad edasipakkuja tarkvara kliendid vĂ”imaluse saada e-arveldaja klientideks ulatuses, mis annab neile Ă”iguse e-arveldaja vĂ”rgustiku vahendusel piiramatus koguses e-arveid vastu vĂ”tta ja edastada (edaspidiselt nimetatud ka kui teenus). 1.2. Lepingu dokumendid koosnevad lepingu tekstist, lepingu lisadest, mis on lisatud lepingu allkirjastamisel ja lisadest, millistes vĂ”idakse kokku leppida pĂ€rast lepingu allkirjastamist. Lepingu allkirjastamisel on lepingu lisad jĂ€rgmised: 1.2.1. Teenuste tehnilised spetsifikatsioonid – Lisa 1; 1.2.2. Teenustaseme lepe – Lisa 2. 2. Teenuse kasutamise tingimused 2.1. Teenuse tehnilised spetsifikatsioonid on tĂ€psustatud lepingu lisas 1. Pooled vĂ”ivad vahetada teenuse osutamiseks vajalikku informatsiooni, nt turvavĂ”tmed, kontaktisikute vahendusel kirjalikku taasesitamist vĂ”imaldavas vormis. 2.2. Pooled lepivad kokku, et neil ei teki lepingu kehtivuse perioodil ja pĂ€rast lepingu lĂ”ppemist rahalisi nĂ”udeid seoses teenuse osutamiseks teostatavate arenduste loomise ja elluviimise protsessiga, poolte poolt nende tarkvara klientidele antud vĂ”imalike lubadustega jne. 2.3. RIK ei vastuta edasipakkuja klientide poolt teenuse kasutamisega seotud toimingute tegemise sisulise Ă”iguspĂ€rasuse eest. 2.4. Edasipakkujal ei teki Ă”iguspĂ€rast ootust teenuse kehtima jÀÀmiseks lepingus mĂ€rgitud kujul. RIKil on Ă”igus teenust muuta, teavitades sellest edasipakkujat vastavalt lepingu punktile 4.1.5. 2.5. RIK tagab edasipakkujale teenuse tehnilise kasutajatoe e-maili teel tööpĂ€eviti. TööpĂ€evana kĂ€sitletakse kalendripĂ€eva, mis ei ole laupĂ€ev, pĂŒhapĂ€ev ega Eesti Vabariigi seadustega kehtestatud riiklik pĂŒha. Kasutajatugi nĂ”ustab ainult Teenuse tehnilist kasutamist puudutavates kĂŒsimustes. 3. Tasu ja maksetingimused 3.1. Teenuse vahendamise tasu arvestatakse kuutasuna edasipakkuja aktiivsete klientide arvu pĂ”hiselt. Aktiivseks kliendiks loetakse edasipakkuja klienti, kes on edasipakkuja vahendusel andnud nĂ”usoleku e-arveldaja e-arve operaatori vahendusteenuse kasutamiseks. Kuutasu on 0,5 EUR (koos kĂ€ibemaksuga) kuus iga edasipakkuja aktiivse kliendi eest. Kuutasu hakatakse arvestama lepingu sĂ”lmimisele jĂ€rgneva kuu eest. 3.2. Edasipakkuja kohustub tasuma teenuse kasutamisega seotud tasu eelneva kuu eest ĂŒks kord kuus RIKi poolt esitatud arve alusel. Kui pooled ei ole kokku leppinud teisiti, edastab RIK arve edasipakkujale ainult elektroonilisel kujul (kas e-mailile vĂ”i e-arvena kui e-arve vastuvĂ”tmine on edasipakkujal e-arvete vastuvĂ”tjate registrist tuvastatav). Arve tuleb tasuda 14 kalendripĂ€eva jooksul arvates arve vĂ€ljastamisest. 3.3. RIKil on Ă”igus muuta kuutasu. Kuutasu muutmine ei ole kĂ€sitletav lepingu muutmisena lepingu punkti 11.2 tĂ€henduses. RIK on kohustatud muudatusest edasipakkujat ette teavitama vĂ€hemalt 30 kalendripĂ€eva. 3.4. Arve loetakse tasutuks, kui kogu arvel esitatud summa on laekunud arvel nĂ€idatud Rahandusministeeriumi pangakontole. Tasu maksmisega viivitamisel on RIKil Ă”igus nĂ”uda edasipakkujalt viivist 0,2% tĂ€htajaks tasumata summalt pĂ€evas iga viivitatud kalendripĂ€eva eest. 3.5. VĂ”lgnevuse tekkimisest teavitab RIK teenuse edasipakkujat meeldetuletusega, mis vĂ€ljastatakse kui arve tasumise tĂ€htajast on möödunud 14 kalendripĂ€eva, mĂ€rkides tasumise tĂ€htajaks 14 kalendripĂ€eva. Kui edasipakkuja ei tasu vĂ”lgnevust meeldetuletusel mĂ€rgitud tĂ€htajaks, on RIKil Ă”igus koheselt katkestada juurdepÀÀs teenusele ja leping lĂ”petada. 4. RIK Ă”igused ja kohustused 4.1. RIK kohustub: 4.1.1.vĂ”imaldama edasipakkujale juurdepÀÀsu teenusele ja osutama teenust, vastavalt Ă”igusaktidele, lepingule ja lepingu lisadele ning vastutama teenuse tĂ”rgeteta kĂ€ttesaadavuse eest vastavalt teenustaseme leppele (Lisa 2); 4.1.2.mitte nĂ”uda edasipakkuja klientidelt eraldi lepingu sĂ”lmimist e-arveldaja teiste teenuste kasutamiseks ja teenustasu e-arveldaja e-arve operaatorteenuse kasutamise eest. Teenuse kasutamine muutub olemasolevatele ja tulevastele edasipakkuja klientidele vĂ”imalikuks automaatselt pĂ€rast poolte poolt vastava lahenduse loomist ning selle avamist; 4.1.3.rakendada e-arvete ja nimetatus sisalduvate andmete turvaliseks töötlemiseks vajalikud turvameetmed; 4.1.4.tagada e-arvete ja nimetatus sisalduvate andmete elektroonilisel teel edastamise turvalisus (et edastamine toimuks edasipakkuja kliendi poolt mĂ€rgitud isikule); 4.1.5.teavitada edasipakkujat teenuse sisu muutmist tingivate tööde teostamise kavatsusest esimesel vĂ”imalusel. Nimetatud tööde teostamisel on RIK kohustatud edastama kĂ”ik vĂ”imalikud info, millega peaks arvestama teenuse sisu muutmisel ja tegema kĂ”ik muu vajaliku selleks, et RIKi poolt tehtavatest töödest tingitud edasipakkuja teenuste muudatused realiseeritakse samaaegselt RIKi tööde tulemiga. Juhul kui samaaegne realiseerimine ei ole vĂ”imalik on RIKil Ă”igus peatada vastava teenuse osutamine; 4.1.6.tagada juurdepÀÀs arendus- ja/vĂ”i testkeskkonnale vajalike muudatuste testimiseks eesmĂ€rgiga veenduda teenuste toimimises kokkulepitud kujul. 4.2. RIKil on Ă”igus: 4.2.1.saada edasipakkuja kontaktisikult igakĂŒlgset informatsiooni ja abi lepingu tĂ€itmist puudutavates kĂŒsimustes; 4.2.2.vĂ”imaldada teenuse kasutamist ĂŒksnes lepingus kokkulepitud tingimustel; 4.2.3.katkestada koheselt juurdepÀÀs teenusele, kui edasipakkuja rikub talle lepinguga pandud vĂ”i Ă”igusaktidest tulenevaid kohustusi vĂ”i ilmneb sellekohane pĂ”hjendatud kahtlus. 5. Edasipakkuja Ă”igused ja kohustused 5.1. Edasipakkuja kohustub: 5.1.1.tasuma RIKile teenuse eest vastavalt lepingu punktile 3; 5.1.2.kasutama ja tagama teenuse kasutamine klientide poolt kooskĂ”las Ă”igusaktide, lepingu ja lepingu lisadega, heas usus ja hoidudes RIKi vĂ”i kolmandaid isikuid kahjustavast tegevusest; 5.1.3.rakendada e-arvete ja nimetatus sisalduvate andmete turvaliseks töötlemiseks vajalikud turvameetmed; 5.1.4.tagada e-arvete ja nimetatus sisalduvate andmete elektroonilisel teel edastamise turvalisus (et edastamine toimuks edasipakkuja kliendi poolt mĂ€rgitud isikule); 5.1.5.hoiduma mistahes toimingutest, mis vĂ”ivad ohustada teenuse turvalisust; 5.1.6.hoidma saladuses talle lepingu tĂ€itmisega teatavaks saanud asjaolusid, v.a. juhul, kui RIK on andnud avalikustamiseks loa vĂ”i kui see tuleneb seadusest; 5.1.7.tagada, et edasipakkuja klientide nimel edastatud e-arved on edastatud autenditud klientide poolt. Autentimisvahenditeks on ID-kaart, mobiil-ID, pangalink, vĂ€lismaalase ID-kaart vĂ”i muu turvalistautentimist vĂ”imaldav vahend. RIK ei vastuta olukorra eest, mil tarkvara klient on edastanud oma autentimisvahendi (ID-kaart jne) kolmandale isikule; 5.1.8.jĂ€rgima punktis 4.1.5 nimetatud teenuste muudatuste realiseerimise kava; 5.1.9.punktis 4.1.5 toodud tööde teostamisel osalema RIKi nĂ”udmisel testprotsessis. 5.2. Edasipakkujal on Ă”igus: 5.2.1.saada teenust vastavalt Ă”igusaktidele, lepingule, lepingu lisadele, s.h teenustaseme leppele. 5.2.2.saada RIKi kontaktisikult igakĂŒlgset informatsiooni ja abi lepingu tĂ€itmist puudutavates kĂŒsimustes. 2 6. Poolte vastutus 6.1. Pooled vastutavad lepinguga vĂ”etud kohustuste tĂ€itmata jĂ€tmise vĂ”i mittekohase tĂ€itmise eest Eesti Vabariigi Ă”igusaktides ning lepingus ettenĂ€htud korras. 6.2. Edasipakkuja on vastutav kĂ”ikide oma klientide eest ning tagab oma klientide poolt tehtavate toimingute vastavuse kĂ€esolevas lepingus ja nimetatu lisades ning Ă”igusaktides toodud tingimustele. 6.3. Oluliseks lepingu rikkumiseks loetakse muu hulgas, kuid mitte ainult, jĂ€rgmisi rikkumisi: 6.3.1.Pool on rikkunud mis tahes lepingust tulenevat kohustust ega ole rikkumist kĂ”rvaldanud teise poole poolt antud tĂ€iendava tĂ€htaja jooksul; 6.3.2.edasipakkuja on rikkunud intellektuaalse omandi Ă”igusi; 6.3.3.pool on rikkunud konfidentsiaalsuskohustust; 6.3.4.pool on rikkunud avalikustamise keelu kohustust. 6.4. Olulise lepingu rikkumise korral on poolel Ă”igus nĂ”uda teiselt poolelt igakordsel rikkumisel leppetrahvi kuni 3000 eurot. Leppetrahvi nĂ”ude esitamine ei vĂ”ta poolelt Ă”igust nĂ”uda tekitatud kahju hĂŒvitamist vĂ”i kasutada muid seadusest tulenevaid Ă”iguskaitsevahendeid. 6.5. Pooled vastutavad lepingu rikkumisega teisele poolele tekitatud varalise kahju eest, vĂ€lja arvatud juhul, kui pool ei vastuta kahju tekkimise eest vastavalt lepingu punktile 10. 6.6. Pooled ei ole vastutavad mis tahes muu teisel poolel tekkida vĂ”iva kahju eest ega ole kohustatud hĂŒvitama teisele poolele saamata jÀÀnud tulu, katkenud Ă€ritegevusega seotud kulu vĂ”i kasumi vĂ€henemist vĂ”i muud sarnast kahju. Poole vastutus teisele poolele sĂŒĂŒliselt tekitatud kahju korral on piiratud kuni 3000 euroga. 6.7. RIK ei vastuta, kui teenustaseme leppes (SLA) kokku lepitud teenustase jÀÀb saavutamata alljĂ€rgnevatel juhtudel: 6.7.1.teenuse edasipakkuja on asunud kasutama teenust eirates soovitusi, mis on antud RIKi vĂ”i muu teenusepakkuja poolt; 6.7.2.muu teenusepakkuja teenus ei tööta; 6.7.3.on ilmnenud vead, viivitused vĂ”i hĂ€ired, mis on tekkinud teenuse edasipakkuja poolt teenuse kasutamisel sisestatud ebakorrektsetest- vĂ”i valeandmetest; 6.7.4.teenusetaseme mitte saavutamine ajaperioodil on kokku lepitud. 7. Intellektuaalne omand KaubamĂ€rkide, RIK logode ja muu intellektuaalomandi kasutamisega ei teki edasipakkujal ĂŒhelgi juhul omandi- vms. Ă”igusi kaubamĂ€rkide, RIK logode vĂ”i muu intellektuaalomandi suhtes. KaubamĂ€rke, RIK logosid ja muud intellektuaalomandit vĂ”ib kasutada vaid RIKi eelneval kirjalikul nĂ”usolekul. Edasipakkujal ei ole ĂŒhelgi juhul Ă”igust kaubamĂ€rke, RIK logosid vĂ”i muud intellektuaalomandit muuta, tĂ€iendada vms. 8. Konfidentsiaalsus 8.1. Lepingu tĂ€itmisel teatavaks saanud isiku- ja turvaandmed ning muu teave ja asjaolud, mille avalikuks tulemine vĂ”iks kahjustada kummagi poole huve, on konfidentsiaalne. Konfidentsiaalsuskohustuse rikkumist kĂ€sitletakse kokkuleppe olulise rikkumisena. 8.2. Konfidentsiaalne informatsioon ei hĂ”lma endas informatsiooni, mille avalikustamise kohustus tuleneb seadusest vĂ”i selle alusel antud Ă”igusaktist, tingimusel, et selline avaldamine viiakse lĂ€bi vĂ”imalikest variantidest kĂ”ige piiratumal viisil. 8.3. KonfidentsiaalsusnĂ”ue on tĂ€htajatu, kui seadusest vĂ”i selle alusel antud Ă”igusaktidest ei tulene teisiti. 9. Avalikud suhted Pooled ei tegele seoses lepinguga avalike suhetega ega anna teateid pressile, elektroonilisele meediale, ĂŒldsusele vĂ”i teistele auditooriumidele, vĂ€lja arvatud teise poole eelneval kirjalikul nĂ”usolekul. Avaldada vĂ”ib vaid teateid, mis on teise poolega eelnevalt kooskĂ”lastatud. 10. VÀÀramatu jĂ”ud 10.1. VÀÀramatuks jĂ”uks on sĂ”da, mĂ€ss, terroriakt, rahutused, loodusĂ”nnetus vĂ”i mingi muu mĂ”jult sama oluline ja ebatavaline, pooltest sĂ”ltumatu asjaolu. 3 10.2. Kumbki pool ei vastuta lepingujĂ€rgsete kohustuste mittetĂ€itmise eest vÀÀramatu jĂ”u tĂ”ttu, st tingimuste tĂ”ttu, mis on poolte mĂ”istliku kontrolli alt vĂ€ljas. Pool peab teist poolt selliste asjaolude saabumisest ja lĂ”ppemisest koheselt informeerima. Kui vÀÀramatu jĂ”ud kestab vĂ€hemalt 3 kuud, on mĂ”lemal poolel Ă”igus leping ĂŒles öelda. 11. Lepingu kehtivus, muutmine ja lĂ”petamine 11.1. KĂ€esolev leping jĂ”ustub selle sĂ”lmimise hetkest ja kehtib tĂ€htajatult. 11.2. Lepingut vĂ”ib muuta poolte kirjalikul kokkuleppel. Muudatused jĂ”ustuvad pĂ€rast nende allkirjastamist mĂ”lema poole poolt vĂ”i poolte poolt mÀÀratud tĂ€htajal. Kirjaliku vormi mittejĂ€rgimisel on muudatused tĂŒhised. 11.3. Pooltel on Ă”igus leping korraliselt ĂŒles öelda igal ajal ja sĂ”ltumata pĂ”hjusest, teatades sellest teisele poolele kirjalikult ette vĂ€hemalt 3 kuud. 11.4. RIK-il on Ă”igus leping ilma punktis 11.3 toodud etteteatamistĂ€htaega jĂ€rgimata ĂŒles öelda, kui teenuse edasipakkuja rikub lepingus ja Ă”igusaktides toodud nĂ”udeid ning ei ole rikkumist kĂ”rvaldanud 5 kalendripĂ€eva jooksul, arvates RIK-ilt vastava nĂ”ude saamisest. 12. Kontaktandmed 12.1. RIKi kontaktisikuks on Aleksandr Beloussov (tel: +372 663 6533, e-post: [email protected] 12.2. RIK tehniline kasutajatugi: e-post: [email protected] 12.3. Teenuse edasipakkuja kontaktisikuks on Voote Rom (tel: 56 89 1400, e-post: [email protected]); Tehnilistes kĂŒsimustes kontaktisik Voote Rom (tel: 56 89 1400, e-post: [email protected]). 12.4. Pool on kohustatud viivitamatult teatama kontaktandmete muutumisest teisele poolele. 13. LĂ”ppsĂ€tted 13.1. Lepingust tulenevad ja/vĂ”i lepinguga seonduvad teated ja muud tahteavaldused tuleb teha kirjalikku taasesitamist vĂ”imaldavas vormis. 13.2. Lepingule ning kĂ”ikidele lepingu osaks olevatele dokumentidele kohaldatakse Eesti Vabariigi seadusi ja teisi Eesti Vabariigis kehtivaid Ă”igusakte. 13.3. Lepinguga seotud vaidlused pĂŒĂŒavad pooled lahendada lĂ€birÀÀkimiste teel. Kui Lepingust tulenevaid vaidlusi ei Ă”nnestu lahendada poolte lĂ€birÀÀkimiste teel, lahendatakse vaidlus Harju Maakohtus. 13.4. Leping on allkirjastatud digitaalselt. 14. Poolte rekvisiidid Registrite ja InfosĂŒsteemide Keskus Fitek OÜ Registrikood: 70000310 Registrikood: 16869243 Aadress: Lubja tn 4, 10115 Tallinn, Eesti Aadress: Harju maakond, Tallinn, Kesklinna linnaosa, Veerenni tn 40a, 10138 Telefon: +372 663 6300 Telefon: +372 5599 9600 Faks: +372 646 0165 Faks: - E-post: [email protected] E-post: [email protected] KMKR (VAT) number: EE100523377 KMKR (VAT) number: EE102682290 /allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/ Asedirektor direktori ĂŒlesannetes Juhatuse liige Aive Normak Mait Sooaru 4 Leping nr 2/20-26 Lisa 1 Teenuste tehnilised spetsifikatsioonid Teenuste tehnilise spetsifikatsioon dokument asub lepingu asice konteineris eraldi pdf failina. 5 Leping nr 2/20-26 Lisa 2 Teenustaseme lepe Teenustaseme leppe dokument asub lepingu asice konteineris eraldi pdf failina. 6 Lepingu nr 2/20-26 Lisa 1 Teenuse tehniline spetsifikatsioon V3 Lepingu loomine ja lĂ”petamine Selleks, et edasipakkuja klient saaks saata/vĂ”tta vastu e-arveid lĂ€bi e-arveldaja, peab edasipakkuja kliendile looma lepingu kirje e-arveldajas. Lepingu kirje loomisega deklareerib edasipakkuja klient e- arveldaja e-arve operaatori valiku ning e-arveldajas aktiveeritakse bitt „vĂ”tab e-arved vastu“. E-arve saatmise/vastuvĂ”tmise aktiveerimisega edastatakse andmed e-arvete vastuvĂ”tjate registrisse ning edasipakkuja klient peab seost kinnitama ettevĂ”tjaportaalis mille jĂ€rel aktiveerub edasipakkuja kliendil e-arve vastuvĂ”tmise vĂ”imalus. E-arveid saab saata koheselt. Kui e-arvete vastuvĂ”tu operaatori seost ei kinnitata tĂ€htajaks (igal kliendil on aktiveerimise hetkest tĂ€pselt 7 pĂ€eva seose kinnitamiseks ettevĂ”tjaportaalis), muutub e-arveldaja leping mitte-aktiivseks kaheksandal pĂ€eval andmete registriga sĂŒnkroniseerimisel. Kinnitamise vajadusest teavitatakse edasipakkuja klienti eraldi Ă€riregistri poolt Ă€riregistris mÀÀratud e-mailile 5 minuti jooksul alates lepingu algatamisest e-arveldajas. Tulenevalt asjaolust, et RIK ei saa garanteerida e-maili teavituse kĂ€tte toimetamist peab edasipakkuja oma klienti teavitama ning paluma seos ettevĂ”tjaportaalis kinnitada. CreateForwardingContractService Lepingu loomise pĂ€ring Sisend: CreateForwardingContractQuery VĂ€li Kirjeldus provider_code Edasipakkuja unikaalne kood forwarder_regcode Edasipakkuja kliendi registrikood transfer_datetime PĂ€ringu tegemise aeg Signature PĂ€ringu allkiri. RSA(sha-256(provider_code || '#' || transfer_datetime.strftime('%d.%m.%Y HH24:MI:SS') || '#' || forwarder_regcode), privekey) only_send_einvoice Mittekohustuslik bitt, mĂ”eldud edasipakkuja klientidele, kes sooviks aktiveerida ĂŒksnes e-arve saatmist vĂ”imaldavat funktsionaalsust. Selle aktiveerimisel ei edastata pĂ€ringut e-arvete vastuvĂ”tjate registrisse ning e-arvete saatmne on pĂ€rast lepingu aktiveerimist koheselt vĂ”imalik. Alates aprill 2019 saavad selle bittiga e-arve saatmislepingud aktiveerida iga ĂŒhingu nimel kĂ”ik edasipakkujad (st sama ĂŒhingut saab ainult e-arvete saatmise osas teenindada N edasipakkujat, kui selleks on vajadus). Alates 01.01.2020 vĂ”ib selle bittiga ĂŒheaegselt olla kliendil paralleelselt ka pĂ€ris e-arveldaja leping kui selleks on kliendil vajadus. NB! Lahtri sisu on tĂ”stutundlik (case sensitive), korrektse kasutamiseks vÀÀrtus peab olema kas true vĂ”i false (mitte True/False). NB! pĂ€ringu "transfer_datetime" on yyyy-MM-ddTHH:mm:ss+00:00 formaadis (ilma offset’ita pĂ€ring ei tööta), aga samas pĂ€ringu allkirja arvutamisel on transfer_datetime pp.kk.aaaa HH:mm:ss formaadis ning ilma ajavööndita. VĂ€ide kehtib ka kĂ”igi jĂ€rgnevate pĂ€ringute kohta. NB! Kui saatjaks soovitakse kasutada registrikoodina fĂŒĂŒsilise isiku isikukoodi (nt Notari, Pankrotihalduri, KohtutĂ€ituri puhul), siis vastavad isikukoodid tuleb registreerida edasipakkujal e- arveldaja tehnilise toe abil. Isikukoodide eemaldamiseks tuleb samuti vĂ”tta ĂŒhendust tehnilise toega. VĂ€ljund: CreateForwardingContractResponse VĂ€li Kirjeldus Status PĂ€ringu tulemus: - „FAIL“ – viga; - „OK“ –pĂ€ring oli edukas. - Message Staatuse kirjeldus eesti keeles. Informatiivne. Olulised Ă€riloogilised vastuste variandid: - „Leping loodud!“ - „Aktiivne leping (%s) teise edasipakkuja juures, lepingu moodustamiseks peab eelnevalt vana edasipakkuja juures lepingu lĂ”petama!“. – tagastatakse juhul kui ĂŒritatakse luua ROAMING tĂŒĂŒpi leping, kuid see on hetkel kehtiv teise edasipakkuja juures (ĂŒheaegselt e-arvete vastuvĂ”tt vĂ”ib olla seotud ainult ĂŒhe edasipakkujaga). - „EttevĂ”ttel on kehtiv tasuta leping e-arveldaja kasutamiseks. E-arvete saatmiseks tuleb see leping esmalt lĂ”petada. Lepingu lĂ”petamiseks palun vĂ”tke ĂŒhendust e-arveldaja kasutajatoega.“ – tagastatakse juhul kui ĂŒritatakse luua ROAMING tĂŒĂŒpi leping kuid eksisteerib tasuta e- arveldaja kasutuse leping - „EttevĂ”ttel on kehtiv tasuline leping e-arveldaja kasutamiseks. E-arvete saatmiseks tuleb see leping esmalt lĂ”petada."– tagastatakse juhul kui ĂŒritatakse luua ROAMING tĂŒĂŒpi leping, kuid eksisteerib tasuline e- arveldaja kasutuse leping, mida klient e-arveldajas saab ise lĂ”petada, mille jĂ€rel saab ROAMING leping algatada. - „Kehtiv leping (%s) on juba olemas. Kui soovite lepingut muuta vĂ”i lisada teist tĂŒĂŒpi lepingu, siis peate kehtiva lepingu tĂŒhistama.“ – tagastatakse juhul kui ĂŒritatakse luua leping uuesti hetkel kui eelnev ROAMING/FORWARDING leping veel aktiivne. NB! aktiveeritud lepingu jĂ€rgselt saab e-arveid saatmata hakata mĂ”ne sekundi pĂ€rast peale lepingu aktiveerimist (st selle aja jooksul replikeeritakse loodud lepingu andmed). TerminateForwardingContractService Lepingu lĂ”petamise pĂ€ring Sisend: TerminateForwardingContractQuery VĂ€li Kirjeldus provider_code Edasipakkuja unikaalne kood forwarder_regcode Edasipakkuja kliendi registrikood transfer_datetime PĂ€ringu tegemise aeg Signature PĂ€ringu allkiri. RSA(sha-256(provider_code || '#' || transfer_datetime.strftime('%d.%m.%Y HH24:MI:SS') || '#' || forwarder_regcode), privekey) VĂ€ljund: TerminateForwardingContractResponse VĂ€li Kirjeldus Status PĂ€ringu tulemus: - „FAIL“ – viga; - „OK“ –pĂ€ring oli edukas. Message Staatuse kirjeldus eesti keeles. Informatiivne. Olulised Ă€riloogilised vastuste variandid: - „Leping lĂ”petatud!“ - „Leping ei kehti veel. Lepingut saab tĂŒhistada alates %s!“ – tagastatakse olukorras, kus eelnev leping on tĂŒhistatud, kuid kehtib vaikimisi jooksva pĂ€eva lĂ”puni ning uut lepingut alustatakse jĂ€rgmisest pĂ€evast. - „'Viga: e-arvete vastuvĂ”tu lepingut ei saa tĂŒhistada kui ei olnud e- arvete vastuvĂ”tt kinnitatud e-arvete vastuvĂ”tjate registris (ettevĂ”tjaportaalis). Leping aegub automaatselt 8 pĂ€eva möödudes alates lepingu algatamisest kui ei tuvastata e-arvete vastuvĂ”tu kinnitust e-arvete vastuvĂ”tjate registrist.“ – tagastatakse olukorras kui ĂŒritatakse tĂŒhistada ROAMING tĂŒĂŒpi leping mille kohta lĂ€ks e-arve registrisse pĂ€ring e-arve registris seose kinnitamiseks, kuid infot kinnitamise kohta pole veel e-arveldajaga sĂŒnkroniseeritud. EesmĂ€rgiks on vĂ€hendada ekslikku lepingu tĂŒhistamist. Tulevikus on plaanis see funktsionaalsus muuta, kui e-arve registri funktsionaalsust on tĂ€iendatud. GetProviderContractsService Edasipakkuja kehtivate lepingute saamise teenus. Teenus vĂ€ljastab kĂ”ik edasipakkujaga seotud aktiivsed lepingud (sh ka homse kehtivuse algusega). Sisend: GetProviderContractsQuery VĂ€li Kirjeldus provider_code Edasipakkuja unikaalne kood transfer_datetime PĂ€ringu tegemise aeg signature PĂ€ringu allkiri. RSA(sha-256(provider_code || '#' || transfer_datetime.strftime('%d.%m.%Y HH24:MI:SS')), privekey) VĂ€ljund: GetProviderContractsResponse VĂ€li Kirjeldus status PĂ€ringu tulemus: - „FAIL“ – viga; - „OK“ –pĂ€ring oli edukas. message Staatuse kirjeldus eesti keeles. Informatiivne. contracts SĂ”lmitud lepingute nimekiri, kus kuvatakse edasipakkujate kĂ”ik pĂ€ringute teostamise hetkel kehtivad lepingud (sh ka homsest kehtivad, kui sellised esinevad). Lepingute variandid: ROAMING (e-arvete saatmine ning vastuvĂ”tmine), FORWARDING (ainult e-arvete saatmine). VĂ€li Kirjeldus registry_code Ühingu registrikood, kelle kohta aktiivne leping e- arveldajas olemas contract_type Lepingu tĂŒĂŒp (ROAMING/FORWARDING) start_date Lepingu algatamise kuupĂ€ev Arvete vastuvĂ”tmine E-arvete vastuvĂ”tmiseks on 2 pĂ€ringut: e-arvete nimekiri ning e-arve sisu (ĂŒks e-arve pĂ€ringu kohta). E- arvete vastuvĂ”tmine e-arveldaja operaatori teenuse kasutajatele on asĂŒnkroonne, mis tĂ€hendab, et edasipakkuja klientidele saadetud e-arved peab aeg ajalt kontrollima ning olemasolul alla laadima. GetInvoiceListService – Edasipakkuja klientidele saabunud e-arvete nimekiri Teenuse kasutamise soovituslik aeg on iga 5-10 minuti tagant, teenuse kasutamise piirang on ĂŒks kord 2 minuti jooksul. Sisend: GetInvoiceListQuery VĂ€li Kirjeldus provider_code Edasipakkuja unikaalne kood from_datetime e-arve saabumine e-arveldajasse alates kuupĂ€ev ja kellaaeg. Soovitatav kasutada viimase arve (GetInvoiceList response) „received_datetime“ TĂ€psustus: pĂ€ringusse pandav aeg peaks olema Eesti aja jĂ€rgi viitega ajatsoonile. Ehk kui viimase saadud arve millisekunditega aeg oli 2019-06-25T10:12:05.973642 siis jĂ€rgneva pĂ€ringu sisendisse tuleb panna from_datetime vĂ€ljale vÀÀrtuse: 2019-06-25T10:12:05+03:00. UTC-s töötamisega iga salvestatud saabunud arvete aega peab offsetti jĂ€rgi modifitseerima. to_datetime e-arve saabumine e-arveldajasse kuni kuupĂ€ev ja kellaaeg. Mittekohustuslik. transfer_datetime PĂ€ringu tegemise aeg client_regcode Vabatahtlik vĂ€li, Arve saaja registrikood, mĂ”eldud pĂ€ringuvĂ€ljundi filtreerimiseks ĂŒksikkasutaja/registrikoodi jaoks. Signature PĂ€ringu allkiri. RSA(sha-256(provider_code || '#' || transfer_datetime.strftime('%d.%m.%Y HH24:MI:SS') || '#' || from_datetime.strftime('%d.%m.%Y HH24:MI:SS')), privekey) NB! Kui uus vĂ€li (client_regcode) on pĂ€ringus tĂ€idetud siis pĂ€ringu allkiri peab sisaldama ka vastavat koodi: RSA(sha-256(provider_code || '#' || transfer_datetime.strftime('%d.%m.%Y HH24:MI:SS') || '#' || from_datetime.strftime('%d.%m.%Y HH24:MI:SS') || '#' || client_regcode)), privekey) VĂ€ljund: GetInvoiceListResponse VĂ€li Kirjeldus Status PĂ€ringu tulemus: - „FAIL“ – viga; - „OK“ –pĂ€ring oli edukas. Message Staatuse kirjeldus eesti keeles. Informatiivne. Invoices e-arvete list VĂ€li Kirjeldus invoice_id Arve unikaalne identifikaator e- arveldajas. received_datetime Saabumise aeg (e- arveldajasse). GetInvoiceListService_v2 – Edasipakkuja klientidele saabunud e-arvete nimekiri v2 Teenuse kasutamise soovituslik aeg on iga 5-10 minuti tagant, teenuse kasutamise piirang on ĂŒks kord 2 minuti jooksul. Lisandus vĂ”imalus teada saada kas originaal e-arve on saabunud Peppoli kaudu. Sisend: GetInvoiceListQuery VĂ€li Kirjeldus provider_code Edasipakkuja unikaalne kood from_datetime e-arve saabumine e-arveldajasse alates kuupĂ€ev ja kellaaeg. Soovitatav kasutada viimase arve (GetInvoiceList response) „received_datetime“ TĂ€psustus: pĂ€ringusse pandav aeg peaks olema Eesti aja jĂ€rgi viitega ajatsoonile. Ehk kui viimase saadud arve millisekunditega aeg oli 2019-06-25T10:12:05.973642 siis jĂ€rgneva pĂ€ringu sisendisse tuleb panna from_datetime vĂ€ljale vÀÀrtuse: 2019-06-25T10:12:05+03:00. UTC-s töötamisega iga salvestatud saabunud arvete aega peab offsetti jĂ€rgi modifitseerima. to_datetime e-arve saabumine e-arveldajasse kuni kuupĂ€ev ja kellaaeg. Mittekohustuslik. transfer_datetime PĂ€ringu tegemise aeg client_regcode Vabatahtlik vĂ€li, Arve saaja registrikood, mĂ”eldud pĂ€ringuvĂ€ljundi filtreerimiseks ĂŒksikkasutaja/registrikoodi jaoks. Signature PĂ€ringu allkiri. RSA(sha-256(provider_code || '#' || transfer_datetime.strftime('%d.%m.%Y HH24:MI:SS') || '#' || from_datetime.strftime('%d.%m.%Y HH24:MI:SS')), privekey) NB! Kui uus vĂ€li (client_regcode) on pĂ€ringus tĂ€idetud siis pĂ€ringu allkiri peab sisaldama ka vastavat koodi: RSA(sha-256(provider_code || '#' || transfer_datetime.strftime('%d.%m.%Y HH24:MI:SS') || '#' || from_datetime.strftime('%d.%m.%Y HH24:MI:SS') || '#' || client_regcode)), privekey) VĂ€ljund: GetInvoiceListResponse VĂ€li Kirjeldus Status PĂ€ringu tulemus: - „FAIL“ – viga; - „OK“ –pĂ€ring oli edukas. Message Staatuse kirjeldus eesti keeles. Informatiivne. Invoices e-arvete list VĂ€li Kirjeldus invoice_id Arve unikaalne identifikaator e- arveldajas. received_datetime Saabumise aeg (e- arveldajasse). peppol_invoice Tagastatakse True vÀÀrtust kui originaal e-arve on saabunud Peppoli vĂ”rgu kaudu. Kui ei ole tegu Peppoli kaudu saabunud e-arvega, siis tag’i vastuses ei tagastata. GetInvoiceService Teenusega pĂ€ritakse konkreetse e-arve sisudokumendid (xml + PDF). On lubatud teha korduvad pĂ€ringud sama e-arve kohta, kuid tiheda korduvate pĂ€ringute tegemisel ignoreerib sĂŒsteem pĂ€ringud, kui nende maht on ebamĂ”istlikult suur. NB! SLA kohaselt sĂ€ilitame saabunud e-arvete logi 7 aastat, kuid XML ning PDF faile 6 kuud. Sisend: GetInvoiceQuery VĂ€li Kirjeldus invoice_id e-arve identifikaator InvoiceList pĂ€ringust. provider_code Edasipakkuja unikaalne kood transfer_datetime PĂ€ringu tegemise aeg signature PĂ€ringu allkiri. RSA(sha-256(provider_code || '#' || transfer_datetime.strftime('%d.%m.%Y HH24:MI:SS') || '#' || invoice_id), privekey) peppol_xml_file Mittekohustuslik boolean, kas tagastada Peppoli kaudu saabunud originaalfail? VĂ€ljund: GetInvoiceResponse VĂ€li Kirjeldus Status PĂ€ringu tulemus: - „FAIL“ – viga; - „OK“ –pĂ€ring oli edukas. Message Staatuse kirjeldus eesti keeles. Informatiivne. Invoice Arve struktuur VĂ€li Kirjeldus invoice_id Arve unikaalne identifikaator e- arveldajas. sender_provider_code Ühingu e-arve kĂ€itlemisteenuse pakkuja kood. sender_regcode Arve vĂ€ljastaja registrikood. sender_name Arve vĂ€ljastaja nimi. receiver_regcode Arve saaja registrikood. receiver_name Arve saaja nimi. invoice_xml_file BASE64 formaadis Eest e-invoice 1.2 standardile vastav xml dokument. Juhul kui pĂ€ringus peppol_xml_file oli vÀÀrtustatud true’ga ning arve kohta olemas originaal formaadis Peppoli kaudu saabunud dokument, siis tagastatakse BASE64 formaadis Peppoli kaudu saabunud e-arvet. invoice_pdf_file BASE64 formaadis arve pdf fail. Juhul kui pĂ€ringus peppol_xml_file oli vÀÀrtustatud true’ga ning arve kohta olemas originaal formaadis Peppoli kaudu saabunud dokument, siis PDF faili ei tagastata. Vajadusel klient vĂ”tab attachmendid otse Peppoli dokumendist vĂ”i genereerib Peppoli XML faili baasil oma PDF/HTML arve pilti. received_datetime Saabumise aeg (e- arveldajasse). *NB! SLA arve sĂ€ilitamise tĂ€htaja saabumisel (6 kuu möödumisel alates arve edastamisest e-arveldaja teenusesse) kustutatakse PDF/XML Ă€ra ning teenuse vĂ€ljundis vĂ€ljadel invoice_xml_file ja invoice_pdf_file on sisu tĂŒhi. Arve saatmine Arve saatja operaatoriks on alati e-arveldaja (arve saaja jaoks). GetClientsFullService e-arve vastuvĂ”tmiseks vĂ”imeliste ĂŒhingute nimekiri Teenus vĂ€ljastab e-arveldaja e-arve operaatori teenuse edasipakkujatele kogu nimekirja, kellele on vĂ”imalik e-arveldaja teenuste vahendusel edastada e-arveid kui ka nende klientide (operaatori) tunnuse. Nimekirjas kuvatakse ĂŒksnes ĂŒhingud, kes on aktsepteerinud seose ettevĂ”tjaportaalis (kinnitanud oma e-arve kĂ€itlemisteenuse pakkuja (operaatori)). Edasipakkuja ei pea liituma e-arvete vastuvĂ”tjate registriga, et kontrollida klientide nimekirja sealt. Piisab, kui teenust on kasutatud ĂŒks kord ööpĂ€evas kuna klientide nimekiri uuendatakse registris ĂŒksnes kord ööpĂ€evas. E-arvete vastuvĂ”tjate sĂŒnkroniseerimist peab teostama Eesti aja jĂ€rgi uuel pĂ€eval enne selle pĂ€eva e-arvete vĂ€ljasaatmist (NĂ€iteks on vĂ”imalik teha sĂŒnkroniseerimist öösel 5 minutit peale uue pĂ€eva saabumis: nt 2019-04- 16T00:05:00+03:00(+02:00)). Sellest teenusest saab teada ettevĂ”tja e-arvete kĂ€itlemisteenuse pakkuja (operaatori) koodi (destination_provider_code). Juhul kui tegemist on edasipakkuja enda kliendiga, tĂ€idetakse vĂ€li real_provider_code edasipakkuja enda koodiga. Sisend: GetClientsFullQuery VĂ€li Kirjeldus provider_code Edasipakkuja unikaalne kood transfer_datetime PĂ€ringu tegemise aeg Signature PĂ€ringu allkiri. RSA(sha-256(provider_code || '#' || transfer_datetime.strftime('%d.%m.%Y HH24:MI:SS')), privekey) VĂ€ljund: GetClientsFullResponse VĂ€li Kirjeldus status PĂ€ringu tulemus: - „FAIL“ – viga; - „OK“ –pĂ€ring oli edukas. message Staatuse kirjeldus eesti keeles. Informatiivne. clients EttevĂ”tjate list VĂ€li Kirjeldus registry_code e-arve saaja registrikood destination_provider_code Ühingu e-arve kĂ€itlemisteenuse pakkuja kood (vĂ€lja vÀÀrtust saab kasutada pĂ€ringu ForwardInvoiceService’e sisendis) real_provider_code TĂ€idetud pĂ€ringu tegija klientidel pĂ€ringu tegija provider_code-ga. Kui edasipakkuja klient vahetab teenuse pakkuja vĂ€lja edasipakkujat teavitamata, edasipakkuja klientidel kuvatakse NULL vÀÀrtus (NULL kuvatud edasipakujaga mitte seotud ĂŒhingutel). Kui e- arveldaja saab registri kaudu teada, et klient on vahetanud kĂ€itlejat (e- arveldaja -> muu e-arve kĂ€itlemisteenuse pakkuja vastu), siis tĂŒhistatakse kliendi operaatorteenuseleping automaatselt. Kui kĂ€itleja jÀÀb samaks, kuid soovitakse vahetada edasipakkujat operaatorteenuse siseselt, tuleb edasipakkuja juures vana leping enne lĂ”petada. ForwardInvoiceService E-arve saatmise pĂ€ring E-arve saatmiseks e-arveldaja vĂ”rgus olevatele klientidele (sh teiste operaatorite klientidele). Baas laiendused (e-arve extensionid) ning muud kĂ€itlemisteenusele edastamiseks vajalikud elemendid lisatakse e-arveldaja teenuse poolt edasipakkuja klientide e-arvetele automaatselt, kui e-arve kĂ€itlemisteenuse pakkuja neid nĂ”uab. Ühe arvega saab edastada ainult 1 xml ning 1 PDF. XML vĂ”ib sisaldada ainult ĂŒhte e-arvet. Iga arve peab olema saadetud unikaalse InvoiceId’ga (sender_invoice_Id). MĂ”ned teised operaatorid vĂ”rdlevad faili unikaalsuse kontrollimise tagamiseks mitte ainult invoiceID vaid ka FileID + InvoiceNumber (teatud tingimustes need ka eraldi). Seega e-arve saatmiseks peab tagama, et nii invoiceID kui ka FileID oleksid unikaalsed iga (sh kordus) e-arve saatmisel kui kordussaatmine on eelnevalt vastuvĂ”tu osapoolega kokkulepitud (sĂ”ltuvalt vastuvĂ”tu operaatorist, vĂ”ib osutuda vajalikuks arve saajal eelnevalt oma operaatoriga kokku leppida kordusarve vastuvĂ”tmine sama FileId’ga vĂ”i InvoiceNumber’iga). Sisend: ForwardInvoiceQuery VĂ€li Kirjeldus provider_code Edasipakkuja unikaalne kood destination_provider_code Ühingu e-arve kĂ€itlemisteenuse pakkuja kood. (Teenuse V2 puhul on see vĂ€li vabatahtlik) transfer_datetime PĂ€ringu tegemise aeg sender_regcode Arve vĂ€ljastaja registrikood vĂ”i isikukood, kui see on registreeritud edasipakkuja juurde. sender_regcode_country Vabatahtlik vĂ€li ainult teenuse V2 puhul, kasutada kolmekohaline riigi tunnus (nt EST), tĂŒhi vÀÀrtus automaatselt tĂ€hendab et tegu Eesti regisitri/isikukoodiga. sender_name Arve vĂ€ljastaja nimi. receiver_regcode Arve saaja registrikood. receiver_regcode_country Vabatahtlik vĂ€li ainult teenuse V2 puhul, kasutada kolmekohaline riigi tunnus (nt EST), tĂŒhi vÀÀrtus automaatselt tĂ€hendab et tegu Eesti regisitri/isikukoodiga. receiver_name Arve saaja nimi. sender_invoice_id Arve unikaalne identifikaator saatja sĂŒsteemis. Peab algama kokkulepitud eesliitega. invoice_xml_file BASE64 formaadis e-invoice standardile vastav xml dokument invoice_pdf_file BASE64 formaadis arve pdf fail. invoice_signature PĂ€ringu allkiri. RSA(sha-256(provider_code || '#' || transfer_datetime.strftime('%d.%m.%Y HH24:MI:SS') || '#' || base64(invoice_xml_file) || '#' || base64(invoice_pdf_file)), privekey) NB! selles teenuses on signaturi tag erinev teistest teenustest! VĂ€ljund: ForwardInvoiceResponse VĂ€li Kirjeldus Status PĂ€ringu tulemus: - „FAIL“ – viga; - „OK“ –pĂ€ring oli edukas. Message Staatuse kirjeldus eesti keeles. Informatiivne. sender_invoice_id Arve unikaalne identifikaator saatja sĂŒsteemis (pĂ€ringust). receiver_invoice_id Arve unikaalne identifikaator e-arveldajas. Teenuse kasutuse lisainfo: e-arve vĂ€lja saatmisel peab veenduma et Invoice tag’i atribuut regNumber on vĂ”rdne pĂ€ringus oleva receiver regcode’ga ning ĂŒhtlasi esineb vĂ€hemalt ĂŒhes Party plokis (nt BuyerParty, RecipientParty). Seotud kontrollid: - Juhul kui receiver_regcode erineb invoice tag’i atribuudiga regNumber tagastatakse message’iks: „Invoice tag attribute regNumber .... does not match receiver_regcode .....“ - Juhul kui saadetavas e-arves ei esine ĂŒhtegi Party plokki, mille sees oleks registrikood, mis on vĂ”rdne Invoice tag’i atribuudiga regNumber tagastatakse message’iks: „Invoice regNumber attribute value .... is not present in any InvoiceParties elements ['....']“ Iga saadetav e-arve peab olema saadetud unikaalse invoiceID ning FileId’ga. Seotud kontrollid: - Korduva kombinatsiooniga (provider_code, sender_regcode, receiver_regcode, sender_invoice_Id, destination_provider_code) e-arve saatmisel tagastatakse staatuseks „FAIL“ ning message’iks „Arve invoiceId'ga %s on juba saadetud %s“. Nimetatud olukorra tulemusel ei toimu e-arve edastamist uuesti. - FileId korduvust kontrollivad teised e-arve operaatorid. Tagamaks et FileID oleks piisavalt unikaalne kogu e-arvete roaming vĂ”rgus, eelistatud on kasutada pikema sĂŒmboliarvuga FileID tunnus, mis ĂŒhtlasi vastaks ka e-arve standardile (st max 20 sĂŒmbolit pikk). Olukorras kui teine operaator tagastab duplikaadi veateadet viitab see asjaolule, et arve oli saadetud FileId’ga mis vastuvĂ”tu operaatoril on sĂŒsteemis varasemalt salvestatud. Arvete staatuste uuendamine ning kontrollimine [NB! operaatoritega kooskĂ”lastamisel] MĂ”lemad teenused on hetkel kontseptuaalselt kirjeldatud, kuid ei ole veel kooskĂ”lastatud e-arve operaatoritega, kui kĂ”igi operaatoritega leitakse ĂŒhine kontseptsioon ning kokkuleped teenuste kasutamiseks jĂ€tkame vastavate teenuste arendustega seni aga info on dokumendi lugejale potentsiaalsest tuleviku funktsionaalsusest. Sisendid/VĂ€ljundid tĂ€psustatakse teenuse valmimisel. UpdateInvoiceStatusService Teenus on mĂ”eldud vastuvĂ”etud (st lĂ€binud esialgse standardi vastu valideerimist) e-arvete staatuste uuendamiseks. Teenuse kaudu saavad e-arveldaja e-arvete teenuste edasipakkujad kui ka operaatorid, kes on e-arveldajaga liidestatud, uuendada e-arveldaja roaming vĂ”rgu vahendusel vahendatud digiarvete staatused (nt Operaatorid tagastavad e-arve kohta staatust, mis e-arvest on saanud operaatori keskkonnas (nt Error, TagasilĂŒkkatud, VastuvĂ”etud, Tasumisele suunatud, Arhiivis, Kustutatud) vĂ”i Edasipakkujad tagastavad e-arve kohta staatust, mis e-arvest on saanud edasipakkuja tarkvaras (nt Error, TagasilĂŒkkatud, VastuvĂ”etud, Tasumisele suunatud, Arhiivis, Kustutatud)). GetInvoiceStatusService Teenus on mĂ”eldud saadetud ning saabunud e-arvete staatuste monitoorimiseks. Teenuse kaudu saavad e-arveldaja e-arvete teenuste edasipakkujad kui ka operaatorid pĂ€rida e-arveldaja roaming vĂ”rgu vahendusel vahendatud digiarvete staatused. Signature Signature komponentides ‘||’ tĂ€histab stringide liitmistehet, transfer datetime peab stringi kujul olema vormingus pp.kk.aaaa hh24:mi:ss. MĂ€rgend ‘#’ tĂ€histab vĂ€ljade separaatorit. PrivaatvĂ”tmele vastav avalikku vĂ”tit sisaldav sertifikaat vahetatakse lepingu sĂ”lmimise kĂ€igus. MĂ”ned nĂ€ited sertifikaadi ja vĂ”tme genereerimise osas: https://devcenter.heroku.com/articles/ssl-certificate-self http://www.akadia.com/services/ssh_test_certificate.html Soovitatav teha max viie-aastase kehtivusega sertifikaat, mĂ”istlike muude vÀÀrtustega (st asutus, kontaktandmed jms). Parooli peale panek vĂ”tmele on omal valikul, ilma selleta piisab teisel poolel vaid vĂ”tmest, et allkirjastada edastatavat pĂ€ringut (lihtsam, kuid vĂ€hem turvaline), muidu on parooli vaja ka teada. RIK’le tuleb saata lĂ”pptulemuseks olev sertifikaat server.crt, endale jĂ€tta key ja kasutada seda allkirjastamiseks. Signature nĂ€idis: test.key - privaatvĂ”ti test.pem - avalik vĂ”ti sertifikaadis ======== hashi genereerimine arve saatmisele e-arveldajasse (Teenus ForwardInvoice) ============ sisend = u"%s#%s#%s#%s" % ( provider_code, transfer_datetime.strftime('%d.%m.%Y %H:%M:%S'), invoice_xml_file, invoice_pdf_file, ) sisend_hash = hashlib.sha256(sisend).digest() ========= hashi genereerimine teistele teenustele ============ analoogselt, vastavalt peavad sisendis siis olema vastava teenuse vĂ€ljad ========= allkirja genereerimine hashist pythoniga ============ rsa = M2Crypto.RSA.load_key("test.key") gen_sig = rsa.private_encrypt(sisend_hash, M2Crypto.RSA.pkcs1_padding) sig = base64.encodestring(gen_sig) ========= allkirja genereerimine hashist openssliga ============ openssl rsautl -sign -in rasi.txt -inkey test.key vĂ€ljund base64-encodeda. ========= enda allkirja kontrollimine openssliga ============ openssl rsautl -verify -certin -inkey test.pem -in sisend.txt kus sisend.txt on base-64-dekodeeritud allkiri sĂ”numist. Leping nr 2/20-26 Lisa 2 E-ARVELDAJA OPERAATOR VAHENDUSTEENUSE TEENUSTASEME LEPE Teenus vĂ”imaldab edasipakkuja tarkvara kaudu pÀÀseda ligi e-arveldaja e-arve operaatori teenusele, mille tulemusena saavad edasipakkuja tarkvara kliendid vĂ”imaluse saada e-arveldaja klientideks ulatuses, mis annab neile Ă”iguse e-arveldaja vĂ”rgustiku vahendusel piiramatus koguses e-arveid vastu vĂ”tta ja edastada. 1.1 ÜldmÀÀratlus Tingimus VÀÀrtus 1.1.1 Kriitilisuse klass I 1.2 Teenuse kĂ€ttesaadavus E-R L, P 1.2.1 Tööaeg II - 1.2.2 SĂŒsteemi sisutoe tööaeg I - 1.2.3 Maksimaalne lubatud e-arvete saatmise maht minutis per 3 edasipakkuja klient 1.3 Planeeritud katkestus 1.3.1 Planeeritud katkestusest etteteatamisaeg, mille kestus on 6h alla 60 minuti 1.3.2 Planeeritud katkestusest etteteatamisaeg, mille kestus on 48 h ĂŒle 60 minuti 1.3.2 Planeeritud katkestuste maksimaalne kogukestvus aastas 96 h 1.3.3 Ühe planeeritud katkestuse maksimaalne kestvus 8h 1.3.4 Maksimaalne planeeritud katkestuste arv kuus 4 tk 1.4 Planeerimata katkestus 1.4.1 Lubatud planeerimata katkestuste kogukestvus aastas 96 h 1.4.2 Maksimaalne ĂŒhekordse planeerimata katkestuse kestvus 6h 1.5 Andmete sĂ€ilitamine Tingimus VÀÀrtus 1.5.1 TĂ€ispresenteerimisega (PDF + XML) e-arve sĂ€ilitamine 6 kuud 1.5.2 E-arve edastamise logi 7 aastat SLA mĂ”isted 1. Kriitilisuse klass – lĂ€htuvalt taasteaegadest jaotatakse teenuse osad jĂ€rgmistesse kriitilisuse klassidesse:  I (tegevuskriitiline) - taasteaeg kuni 2 ööpĂ€eva,  II (kriitiline) - taasteaeg kuni 7 ööpĂ€eva,  III (oluline) - taasteaeg kuni 21 ööpĂ€eva,  IV (vajalik ) - taasteaeg kuni 28 ööpĂ€eva. 2. Logide sĂ€ilitamine – mÀÀratletakse kui kaua sĂ€ilitatakse teenuse jaoks vajalikke (andmebaasi, rakendusserveri) logisid. Logi on kronoloogiline sĂŒndmuste andmestik, mis talletatakse andmefailina jĂ€rgnevaks lĂ€bivaatuseks ja analĂŒĂŒsimiseks. 3. Lubatud planeerimata katkestuste kogukestvus – lubatud planeerimata katkestuse kogukestvus on maksimaalne lubatud planeerimata katkestuste kestvus mingil ajaperioodil (nt kuus, aastas). 4. Maksimaalne ĂŒhekordse planeerimata katkestuse kestvus – maksimaalne ĂŒhekordse planeerimata katkestuse kestvus on maksimaalne lubatud ajavahemik, kus teenus ei ole tööajal kĂ€ttesaadav. 5. Planeeritud katkestus – planeeritud katkestus on eelnevalt kokkulepitud ajavahemik, mille jooksul teenus ei ole kĂ€ttesaadav. Planeeritud katkestused toimuvad ainult teenuse tööajal. 6. Planeerimata katkestus – planeerimata katkestus on tööajal aset leidev mitteplaanipĂ€rane katkestus teenuse toimimises. 7. Tööaeg – tööaeg on ajavahemik, millal teenus peab olema teenuse kasutajatele kĂ€ttesaadav. Tööaeg mÀÀratakse eraldi tööpĂ€evadele ning nĂ€dalavahetustele. Tööaeg on jaotatud klassidesse jĂ€rgnevalt: 7.1 I 8:00 – 18:00 7.2 II 6:00 – 22:00 7.3 III 00:00 – 00:00 8. SĂŒsteemi sisutoe tööaeg – sĂŒsteemi sisutoe tööaeg on ajavahemik, mille jooksul on vĂ”imalik saada halduri tuge teenusele. SĂŒsteemi sisutoe tööaeg on jaotatud klassidesse jĂ€rgnevalt: 8.1 I 9:00 – 17:00 – pöördumised, mis vajavad halduri vĂ”i muu teise osapoole osalemist pöördumise lahendamisel. 8.2 II 7.30 – 18.30 – pöördumised, mis ei vaja halduri vĂ”i muu teise osapoole osalemist pöördumise lahendamisel.
Allikas: Registrite ja InfosĂŒsteemide Keskus dokumendiregister →
dokumendiregister.eeAsutusedEesti avalike dokumendiregistrite otsing · nimistu.ee andmetel