Teenuse kasutuse leping

Leping nr 2/29-24 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 edasipakkuja klient

3

1.3 Planeeritud katkestus

1.3.1 Planeeritud katkestusest etteteatamisaeg, mille kestus on alla 60 minuti

6 h

1.3.2 Planeeritud katkestusest etteteatamisaeg, mille kestus on üle 60 minuti

48 h

1.3.2 Planeeritud katkestuste maksimaalne kogukestvus aastas 96 h

1.3.3 Ühe planeeritud katkestuse maksimaalne kestvus 8 h

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 6 h

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.

Lepingu nr 2/29-24

Lisa 1

Teenuse tehniline spetsifikatsioon V2

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! 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).

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)

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

invoice_pdf_file BASE64 formaadis arve pdf fail.

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.

E-ARVELDAJA E-ARVE OPERAATORTEENUSE VAHENDUSLEPING 2/29-24

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

Sviby OÜ (edaspidi edasipakkuja) (registrikoodiga 14497487), asukohaga Fortuuna 35, Tartu Eesti, mida

põhikirja alusel esindab Jaan Naaber,

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.

2

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.

3

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.

4

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 Jaan Naaber (tel: 5819 0890, e-post: [email protected]);

Tehnilistes küsimustes kontaktisik Toomas Naaber (tel: 5672 4638, 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 Sviby OÜ

Registrikood: 70000310 Registrikood: 14497487

Aadress: Lubja tn 4, 10115 Tallinn, Eesti Aadress: Tartu maakond, Tartu linn,

Tartu linn, Fortuuna tn 35-31, 50603

Telefon: +372 663 6300 Telefon: 58190890

Faks: +372 646 0165 Faks: -

E-post: [email protected] E-post: [email protected]

KMKR (VAT) number: EE100523377 KMKR (VAT) number: EE102104082

/allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/

Direktor Rivo Reitmann Juhatuse liige Jaan Naaber

5

Leping nr 2/29-24 Lisa 1

Teenuste tehnilised spetsifikatsioonid Teenuste tehnilise spetsifikatsioon dokument asub lepingu asice konteineris eraldi pdf failina.

6

Leping nr 2/29-24 Lisa 2

Teenustaseme lepe

Teenustaseme leppe dokument asub lepingu asice konteineris eraldi pdf failina.