E-ARVELDAJA E-ARVE OPERAATORTEENUSE VAHENDUSLEPING 2/7-26
Registrite ja InfosĂŒsteemide Keskus (edaspidi RIK), (registrikoodiga 70000310), asukohaga Lubja tn 4,
10115 Tallinn, mida pÔhimÀÀruse alusel esindab direktor Rivo Reitmann ja
VKV KĂŒte OĂ (edaspidi edasipakkuja) (registrikoodiga 12115843), asukohaga Harju maakond, Saue vald,
Laagri alevik, Pilliroo tn 37, 76401, mida pÔhikirja alusel esindab Eik Valma,
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 Eik Valma (tel: +37256934944, e-post:
[email protected]);
Tehnilistes kĂŒsimustes kontaktisik Jarmo Kallasmaa (tel: +358406495944 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 VKV KĂŒte OĂ
Registrikood: 70000310 Registrikood: 12115843
Aadress: Lubja tn 4, 10115 Tallinn, Eesti Aadress: Pilliroo 37, 76401, Laagri
Telefon: +372 663 6300 Telefon: +37256934944
Faks: +372 646 0165 Faks: -
E-post:
[email protected] E-post:
[email protected]
KMKR (VAT) number: EE100523377 KMKR (VAT) number: EE101483487
/allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/
Direktor Rivo Reitmann Juhatuse liige Eik Valma
4
Leping nr 2/7-26
Lisa 1
Teenuste tehnilised spetsifikatsioonid
Teenuste tehnilise spetsifikatsioon dokument asub lepingu asice konteineris eraldi pdf failina.
5
Leping nr 2/7-26
Lisa 2
Teenustaseme lepe
Teenustaseme leppe dokument asub lepingu asice konteineris eraldi pdf failina.
6
Lepingu nr 2/7-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/7-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.