Katseline, mitteametlik projekt — kasutamine omal vastutusel
e-arveldaja MCP server ühendab sinu AI-assistendi otse Eesti e-arveldajaga (RIK). Arved PDF-idest ja piltidest, pangaimport, kuu lõpp ja Eesti maksud — tavakeeles. Sina vaatad üle ja kinnitad.
Uudised
Olulisemad muudatused ja parandused. Tööriist on aktiivses arenduses.
Google'i eestikeelsetel 0% arvetel (Workspace, Cloud, Gemini) luges PDF-i lugeja arveldusperioodi rea „Kokkuvõte – 1. sept 2026 – 30. sept 2026“ kogusummaks. Seetõttu tuli summaks päevanumber (näiteks 30) ja käibemaks arvutati selle ja netosumma vahena. Nüüd tunneb lugeja ära rea „Kogusumma“ ega võta kuupäeva osa enam summaks.
e-arveldaja API tagastab tehingu suuna alati väljaminevana, ka siis, kui see salvestati laekumisena. Seetõttu jäid versioonis 0.26.0 lisatud kontrolli tõttu CAMT- ja Wise'i laekumised kinnitamata. Kontroll on eemaldatud ja suund võetakse väljavõttest. Kui tehingu suund pole teada (käsitsi või muul viisil imporditud read), ei loeta seda enam väljaminekuks. Topeltkannete kontroll vaatab siis mõlemat poolt ja tööriist ei kirjenda tagasimakset kuluna. Lisaks töötab jälle dokumendi lisamine kirjele, millel dokumenti veel pole, ning saldod ja aruanded ei katke enam, kui kannete arv on täpselt 100 kordne.
Konto saldo arvestab endiselt ainult kinnitatud kandeid, kuid näitab nüüd ka, mitu kinnitamata kannet kontole perioodis läheb ja millises summas. Tööriist hoiatab ka, et need tuleb enne väljavõttega võrdlemist kinnitada. Lightyeari tehingute kirjendamine annab kohe ette loodud kinnitamata kanded ja valmis kinnituskäsu. Varem võisid need kinnitamata jääda ja maaklerikonto saldo ei klappinud väljavõttega.
Kui e-arveldaja kirjutamise ajal ei vasta või ühendus katkeb, ei loe tööriist toimingut enam ebaõnnestunuks, vaid teatab, et tulemus on teadmata — kontrolli enne kordamist, sest kanne võis tegelikult salvestuda. Nii ei teki kordamisel topeltkannet ega saadeta e-arvet kaks korda. Duplikaatide ja arvete tasumise kontrollid enne kirjutamist loevad nüüd alati värskeid andmeid, mitte vahemälu.
Kui maksid kulu oma rahast, küsib assistent puuduolevad andmed eraldi jah/ei-küsimustena ja rakendab käibemaksureeglid: näiteks külaliste vastuvõtult sisendkäibemaksu maha ei arvata ja M1-sõiduauto kuludelt, mille erakasutus pole välistatud, üldjuhul ainult 50%. Juhendatud režiimi (guided) töövood jõuavad nüüd algusest lõpuni ilma täisversioonile lülitumata. Dividendipakett näitab vaikimisi eelvaadet — kanded tekivad alles pärast sinu kinnitust.
Aasta sulgemine teeb nüüd need kaks lõpetamiskannet, mida kirjeldab RIK-i e-arveldaja juhend (31.12 tulem kontole 2970, 1.1 edasi jaotamata kasumisse 2960), tunneb ära juba käsitsi tehtud kanded ja lisab ainult puuduva — kaks korda ei broneeri. Kuu lõpu võlgnevuste hulka ei satu enam arved, mille maksetähtaeg pole veel käes, ja suletud aasta kasumiaruanne ei näita enam nulle. Lightyeari müügid kajastuvad väljavõttel näha oleva rahaga ning Wise'i omaülekannet, mis on teise panga kaudu juba kirjendatud, teist korda ei broneerita.
Kui arve tasub keegi teine (näiteks ministeerium sihtasutuse arve), kannab e-arveldaja laekumise maksja, mitte arve kliendi alla ja kliendi võlg jääb rippuma. Tööriist ei kinnita selliseid makseid enam automaatselt, vaid suunab need ülevaatusse. Mitme ettevõttega töötades saab iga kirjutava käsu siduda kindla ettevõttega — kui server on vahepeal taaskäivitunud ja aktiivne on teine firma, käsust keeldutakse.
Seadistusega EARVELDAJA_PROFILE saab valida tööriistakomplekti: juhendatud režiim guided (19 tööriista) igapäevaseks raamatupidamiseks, guided-sales koos müügiarvetega, vaikimisi standard või kõik tööriistad full. Väiksem komplekt tähendab vähem tokeneid igas vestluses.
Tööriist hoiatab nüüd, kui sama pangamakse on raamatus juba olemas — ükskõik mis teed pidi see sisse tuli — ja kontrollib pangaväljavõtte lõppsaldo klappimist raamatupidamisega. Ise midagi ära ei kustuta — annab ainult märku.
Versioonis 0.22.0 võisid laekumised (sh sissemaksed ja tagasimaksed) kirjenduda hoopis raha väljakandmisena. Parandatud versioonis 0.22.1. Viga sai puudutada ainult neid, kes juhtusid öösel vastu 20. juulit, umbes kl 22:30–04:15 (Eesti aeg) oma pangaväljavõtteid importima.
Kahtluse korral võrdle e-arveldaja pangakonto saldot päris saldoga; erinevuse korral impordi mõjutatud väljavõtted uuesti.
Mis see on
e-arveldaja on Eesti riigi raamatupidamistarkvara (RIK). MCP server on väike vahelüli, mis ühendab selle sinu tehisintellekti-assistendiga — olgu selleks Claude, ChatGPT/Codex, Gemini, Cursor või mõni teine.
Tulemus: sa räägid oma assistendiga tavakeeles ja tema teeb e-arveldajas töö ära — loeb arveid PDF-idest ja piltidest, impordib pangaväljavõtteid, sobitab makseid, teeb müügiarveid, koostab aruandeid ja arvutab makse. Sina jääd otsustajaks; assistent teeb rutiini. Töötab nii käibemaksukohustuslastega kui ka mittekohustuslastega.
Päris kõike see siiski ei tee. Igapäevarutiini server katab, aga osa toiminguid — näiteks käibedeklaratsiooni (KMD), TSD-d ja muud Maksu- ja Tolliametiga (EMTA) seonduvat — tee endiselt e-arveldaja veebikeskkonnas.
Server on tasuta ja avatud lähtekoodiga (Apache 2.0). Kood ja kogu dokumentatsioon on GitHubis.
„Impordi LHV väljavõte ja sobita arvetega.“ Ei mingit eksporti-importi ega menüüde otsimist.
Kõik pakettoperatsioonid käivad esmalt dry-run-režiimis — näed täpselt, mida tehakse, enne kui midagi muutub.
Kanded tehakse alles pärast sinu nõusolekut. Iga muudatus läheb loetavasse Markdown-auditilogisse.
Miks ma selle tegin
Algus oli klassikaline „scratching my own itch“ — tahtsin Wise'i ja Lightyeari impordi ning arvete sisestuse endale lihtsamaks teha. Sealt kasvas asi suuremaks.
Nüüd hakkab valmis saama. Kõike see ei tee — käibe- ja TSD-deklaratsioonid jäävad endiselt e-arveldaja veebi kanda — aga teeb päris palju: loeb PDF-id ja pildid arvetena sisse, impordib pangaväljavõtteid, seob kõik kokku, teeb müügiarveid ning kontrollib piirmäärasid ja raamatupidamisreegleid, kus oskab. Ja saad tavakeeles uurida, kuidas su firmal läheb.
Ise majandan sellega paari oma mikrofirmat ja olen juba päris rahul. Liiga palju testitud see veel pole, nii et kontrolli alati üle. Kui teed e-arveldajaga oma mikrofirma raamatupidamist, usun, et on omajagu abiks.
Mida ta oskab
Igapäevane raamatupidamisrutiin loomuliku vestlusega — lõplik otsus jääb sinu teha.
OCR loeb arve PDF-ist või pildilt (JPG/PNG), tuvastab tarnija äriregistrist, täidab KM-määra ja konto varasemate kannete põhjal, loob ostuarve ja seob selle pangamaksega. OCR võib eksida, nii et kontrolli väljad üle.
Impordi LHV, Swedbanki, SEB, Coopi või Luminori väljavõte. Kordusimport säilitab CAMT-i viite ja vastaspoole konto info ka siis, kui API eraldi väljad kaotab, ning leiab duplikaadid kindlamalt.
Impordi Wise'i tehingute CSV — sissetulevad ja väljaminevad maksed, teenustasud eraldatakse omaette kanneteks korrektse kuluarvestuse jaoks.
Seob laekumised ja maksed õigete arvetega. Ülekannete tuvastamisel ettevaatlik — kahtluse korral jätab kinnitamata, mitte ei oleta.
Kuu lõpu kontroll-loend, kasumiaruanne, bilanss, nõuete ja kohustuste vananemine — kuupäevavahemiku järgi, valitud seisuga. Aasta lõpus teeb lõpetamiskanded RIK-i juhendi järgi.
Dividendipakett 22/78 tulumaksuga, jaotamata kasumi ja netovara kontroll (ÄS § 157). Omaniku makstud kulude hüvitamine koos käibemaksu mahaarvamise piirangutega.
Loob kanded Lightyeari tehingutest, dividendidest ja intressidest ning arvutab kapitalikasumi FIFO-aruande põhjal.
Skannib töökausta ja ütleb, mida saab teha automaatselt, mis vajab üht otsust ja mis raamatupidaja pilku. Tagastab soovitatud järgmise sammu, ülevaateküsimused ja kinnituse eelvaated.
Koosta ja saada müügiarveid, halda kliente, artikleid ja arvete seeriaid. Sissetulevad maksed seob hiljem pangaimport ise arvetega.
Neid ei pea pähe õppima — assistent valib su soovi põhjal ise õige töövoo. Aga kui tahad näha, mis kõik olemas on:
accounting-inboxAlusta siit: skannib kausta, tuvastab sisendid ja pakub järgmised ohutud sammud.book-invoiceOstuarve PDF-ist: loe, valideeri, tuvasta tarnija, eelvaade, loo, lae üles, kinnita.receipt-batchKviitungipakk: loo ja lae üles projekti ostuarved (kinnitus eraldi).import-camtCAMT.053 väljavõte: eelvaade, kanded pärast kinnitust.import-wiseWise'i CSV eelvaade: teenustasud, duplikaadid, vahelejätud.reconcile-bankSobita pangaread arvetega, seejärel autokinnitus või käsitsi ülevaatus.classify-unmatchedRühmita sobitamata pangaread, eelvaade, rakenda pärast kinnitust.month-end-closeKuu lõpp: kontroll-loend, proovibilanss, kasumiaruanne, bilanss.company-overviewFinantsülevaade: bilanss, kasumiaruanne, nõuded, kohustused.vat-registration-thresholdKontrolli 40 000 € käibemaksukohustuse piiri (finants-, kindlustus- ja kinnisvaratulu eraldi).new-supplierLoo tarnija äriregistri otsinguga.lightyear-bookingKanna Lightyeari tehingud ja väljamaksed CSV-st.resolve-accounting-reviewTee ülevaatuskirjest konkreetne tegevusplaan.prepare-accounting-review-actionValmista ette lahendatud kirje järgmine tegevus.setup-credentialsKontrolli ja impordi API-võti failist apikey.txt.setup-e-arveldajaSelgita API-võtme seadistust seadistusrežiimis.Usaldus ja privaatsus
Pärisandmetega töötab vaid siis, kui sina lubad — ja jätab jälje.
Pangaimport, Wise, Lightyear, kviitungipakid, dividendipakett ja autokinnitus näitavad esmalt eelvaadet. Kirjeid muudetakse alles pärast sinu selget kinnitust.
Iga muutev tegevus kirjutatakse Markdown-logisse (logs/{firma}.audit.md) — lühike tegevuslause, selge väljade tabel, kontod, summad ja vajadusel dimensioonid.
Skannitud arvete tekst pakitakse turvapiiridesse, et pahatahtlik dokument ei saaks su assistendile peidetud käske anda (prompt injection'i kaitse).
Dokumendid loetakse vaikimisi lokaalselt. Server suhtleb väljapoole vaid e-arveldaja API-ga ja sinu valitud AI-mudeliga — ja äriregistriga, kui tarnijat otsid.
Uurib enne, kuidas sarnased kanded on varem tehtud, ja teeb siis samamoodi. KM-käsitlust ta ise välja ei mõtle.
Mitu API-võtit kõrvuti, lülitumine ühe käsuga. Ettevõtte vahetamisel tühjendatakse vahemälu, et andmed ei seguneks.
See on katseline ja mitteametlik projekt — testitud, aga mitte üleliia palju. See ei ole seotud RIK-iga ega e-arveldaja teenusega ega ole nende poolt heaks kiidetud. Tarkvara töötab pärisandmetega ning võib luua, muuta, kinnitada ja kustutada raamatupidamiskirjeid. Kontrolli alati tulemused üle. Autor ei vastuta andmekao ega valede kannete eest.
Tehniline seadistus
Vajad e-arveldaja kontot, MCP-toega AI-assistenti ja Node.js 18+.
Logi sisse e-arveldajasse → Seadistused → Üldised seadistused → Lisa uus juurdepääsuluba. Lisa oma avalik IP-aadress ja salvesta. Laadi alla fail apikey.txt. Ära kunagi lisa seda faili gitti.
Enamik AI-assistente oskab serveri ise paika panna — ütle lihtsalt: „Lisa e-arveldaja MCP server siia projekti, pakett on npm-is: e-arveldaja-mcp.“
Kui eelistad käsitsi — Claude Code'is piisab ühest reast:
Muudes klientides (Cursor, Windsurf, Cline, Gemini CLI, Codex CLI, Antigravity) lisa sama oma MCP-seadistusse — või lase assistendil fail ise luua:
Soovitus — lisa server projektipõhiselt. e-arveldaja MCP toob iga vestluse algul mudeli konteksti vaikimisi 127 tööriista; see on püsiv token-kulu igas seansis. Lisa server seetõttu ainult sinna kausta, kus raamatupidamist teed. claude mcp add teeb seda vaikimisi — server kehtib ainult selles projektis. Väldi globaalset paigaldust (-s user): muidu laeksid kõik tööriistad konteksti igas projektis, ka raamatupidamisega mitteseotutes, ja kulutaksid asjata tokeneid. Teistes klientides eelista samuti projektisisest seadistust (nt Cursoris .cursor/mcp.json) globaalse asemel.
Tööriistakomplekti saab valida profiiliga: EARVELDAJA_PROFILE=guided annab igapäevaseks raamatupidamiseks kitsa, 19 tööriistaga komplekti (guided-sales lisab müügiarved, 20 tööriista); vaikimisi on standard (127) ja full toob kõik 147 tööriista.
Konteksti saab kärpida ka kasutamata tööriistagruppe välja lülitades:EARVELDAJA_DISABLE_LIGHTYEAR=1, EARVELDAJA_DISABLE_TAX_TOOLS=1, EARVELDAJA_DISABLE_REFERENCE_ADMIN=1, EARVELDAJA_DISABLE_ANNUAL_REPORT=1, EARVELDAJA_DISABLE_SALES=1 ja EARVELDAJA_DISABLE_PRODUCTS=1. Ostupoolele keskendunud seadistus jääb kõigi kärbetega 86 tööriista juurde.
Pane apikey.txt töökausta. Server tunneb selle ära ja pakub importi — või ütle assistendile: „Impordi mu API-võti failist apikey.txt.“ Seejärel proovi: „Skanni see kaust ja ütle, mida saab automaatselt teha.“
Töötab nende klientidega
Tahad enne päris andmeid proovida? Sea EARVELDAJA_SERVER=demo ja server töötab e-arveldaja demoserveris.
Vajad abi seadistamise või kohandamisega? Kirjuta Indrekule.
Korduma kippuvad küsimused
import_opening_balances). Server kontrollib, et deebet ja kreedit klapivad, näitab eelvaadet (dry-run) ja salvestab alles pärast sinu kinnitust. Edaspidi arvestab algbilanssi automaatselt kontojääkides, proovibilansis, bilansis, kasumiaruandes, aastaaruandes ja dividendide § 157 kontrollis. See samm on vabatahtlik — ka ilma selleta töötab kõik, lihtsalt ilma algsaldodeta.