TL;DR: All five programs we checked have a public API, and four of them are genuinely usable. RIK e-arveldaja is the surprise: the free state accounting program publishes a full OpenAPI 3.1 spec with CRUD on sales invoices, purchase invoices, payments and journal entries, plus a demo environment. Merit Aktiva has the widest endpoint surface but locks the API to Pro and Premium licences. SimplBooks has the simplest auth (a header token) but requires Premium. SmartAccounts includes the API in every paid monthly plan and is the only one that publishes a proper changed-since sync contract. ERPLY has a strong API but is a retail ERP, not a bookkeeping ledger.
Eesti raamatupidamisprogramme võrreldes ei vaata tavaliselt keegi nende API-sid. See on viga, sest API määrab ära, kas programm on koht, kuhu teie andmed "surema" lähevad, või on see toimiv osa suuremast süsteemist. Alljärgnevalt on toodud info, mida kontrollisime otse tarkvarapakkujate dokumentatsioonist 2026. aasta juulis.
API võimekuse võrdlus: viis Eesti raamatupidamisprogrammi
Iga alloleva tabeli lahter on üle kontrollitud tarkvarapakkuja enda dokumentatsioonist 2026. aasta juulis, mitte blogipostitustest või kataloogidest. Kui pakkuja pole konkreetset numbrit avaldanud, on lahtris vastav märge, mitte oletus.
| Võimekus | Merit Aktiva | SmartAccounts | SimplBooks | RIK e-arveldaja | ERPLY |
|---|---|---|---|---|---|
| Avalik API dokumentatsioon | Jah, HTML-formaadis juhend | Jah, PDF-fail (v1.3, kuupäevaga 01.06.2021) | Jah, OpenAPI 3.0 läbi ReDoc-i | Jah, OpenAPI 3.1 otse API serverist | Jah, learn-api.erply.com |
| Masinloetav spetsifikatsioon | Ei ole avaldatud | Ei ole avaldatud | Jah | Jah | Osaline (ainult uuemad REST alam-API-d) |
| Autentimine | HMAC-SHA256 allkirjastatud päringu parameetrid | HMAC-SHA256 hex-allkiri | Staatiline X-Simplbooks-Token päis | HMAC-SHA384 päises X-AUTH-KEY | verifyUser tagastab 1-tunnise sessioonivõtme |
| Kordusrünnete kaitse (replay protection) | Ajamärk on osa allkirjastatavast sõnest | Rohkem kui 15 min vanused päringud lükatakse tagasi | Puudub (staatiline token) | Ajamärk on osa HMAC-i sisendist | Ainult sessiooni aegumine |
| Müügiarved | Lugemine + kirjutamine, kreeditarved, saatmine | Lugemine + kirjutamine, sh SendEinvoice | Lugemine + kirjutamine, PDF ja XML | Lugemine + kirjutamine | Lugemine + kirjutamine |
| Ostuarved | Lugemine + kirjutamine, sh kinnitamist ootavad arved | Lugemine + kirjutamine | Lugemine + kirjutamine, sh e-arve XML-ist | Lugemine + kirjutamine | Ei ole dokumenteeritud pearaamatu osa |
| Kontaktid | Lugemine + kirjutamine, kliendid ja tarnijad | Lugemine + kirjutamine | Täielik CRUD, lisaks kontaktid ja asukohad | Täielik CRUD | Lugemine + kirjutamine |
| Laekumised ja maksed | Lugemine + kirjutamine, pangaväljavõtte import | Lugemine + kirjutamine | Lugemine + kirjutamine, sh makstuks märkimine | Täielik CRUD läbi /transactions | Ei ole dokumenteeritud pearaamatu osa |
| Pearaamat | Lugemine + kirjutamine | Lugemine + kirjutamine (general/entries) | Ainult lugemisõigusega kontode nimekirjad | Täielik CRUD läbi /journals | Pearaamatu otspunktid puuduvad |
| Avaldatud päringulimiit | Ei ole avaldatud (kirjeldatud on 429 piirangut) | 1000 / 24h ja 60 / min | 60 / min | Ei ole avaldatud | 1000 / tunnis konto kohta |
| Testkeskkond (Sandbox) | Ei ole avaldatud | Ei ole avaldatud | Ei ole avaldatud | Jah, demo-server + testleht | Jah |
| Vajalik pakett | Ainult Pro või Premium | Kõik tasulised kuupaketid | Premium | Tasuta (kasutuslepinguga) | Ei ole avalikult märgitud |
Selle tabeli detailsem versioon koos täpsete otspunktide nimede ja dokumentatsiooni linkidega on saadaval CSV-failina selle postituse kõrval.
Millistel Eesti raamatupidamisprogrammidel on tegelikult avalik API?
Kõigil viiel. Merit Aktiva, SmartAccounts, SimplBooks, RIK e-arveldaja ja ERPLY avaldavad arendajate dokumentatsiooni, mida saab lugeda ilma ühegi lepinguta. Neid ei erista mitte API olemasolu, vaid see, kas see on piisavalt hästi spetsifitseeritud integratsiooni ehitamiseks ja milline hinnapakett selle sisse lülitab.
See on parem tulemus, kui turg ehk oodatagi oskaks. Kuid "API olemasolu" on koht, kus enamik võrdlusi lõpeb ja kus tegelikult kasulik osa alles algab.
Miks RIK e-arveldaja on nimekirja suurim üllatus
Riigi tasuta raamatupidamisprogrammil on viiest võrreldust kõige paremini spetsifitseeritud API. RIK avaldab OpenAPI 3.1 dokumendi aadressil https://rmp-api.rik.ee/openapi.yaml, pakub samast serverist visuaalset dokumentatsiooni ja interaktiivset testlehte ning hoiab töös eraldi demokeskkonda aadressil demo-rmp-api.rik.ee. Ükski kommertstoode selles võrdluses ei pakku midagi samaväärset.
Ressursside nimekiri katab reaalset raamatupidamist, mitte ainult arveldust: /sale_invoices, /purchase_invoices, /journals, /transactions (laekumised, maksed ja tasaarveldused), /clients, /products, /bank_accounts, lisaks ainult lugemisõigusega /accounts, /vat_info ja /currencies. Enamik neist toetab GET, POST, PATCH ja DELETE päringuid.
Autentimiseks kasutatakse HMAC-SHA384 algoritmi. Päringuga saadetakse X-AUTH-QUERYTIME koos UTC ajamärgiga ja X-AUTH-KEY, mis sisaldab avaliku võtme ID-d ning allkirja, mis on arvutatud kujul apikeyid:time:url. Juhatuse liige saab võtme genereerida menüüst Seaded, Üldised seaded, e-arveldaja API pääsuõigused, ning vajalik on kehtiv e-arveldaja kasutusleping.
Avalikku päringulimiiti ei ole märgitud. Küll aga on olemas brute-force kaitse: RIK blokeerib IP-aadressi pärast umbes 10 ebaõnnestunud autentimiskatset 5 minuti jooksul, 30 katset tunnis või 60 katset ööpäevas. Kui panete vigase allkirjastamisega koodi tsüklisse jooksu, blokeerite end enne, kui arugi saate.
Konks on aga funktsionaalsuse ulatuses. e-arveldaja on mõeldud väikestele ja lihtsa raamatupidamisega ettevõtetele ning see ei ole programm, kuhu kiiresti kasvav ettevõte igaveseks jääb. Kuid kui valite oma esimest raamatupidamisprogrammi ja teate juba ette, et soovite protsesse automatiseerida, on OpenAPI spetsifikatsiooni ja demokeskkonnaga alustamine igati mõistlik otsus.
Merit Aktiva pakub kõige laiemat funktsionaalsust, kuid litsentsipiiranguga
Merit Aktiva API katab raamatupidamismudelit laiemalt kui ükski teine siinne programm: müügiarved (sh kreeditarved, PDF-ide allalaadimine ja e-arvena saatmine), ostuarved koos kinnitusringi toega, kliendid ja tarnijad koos gruppidega, maksed koos pangaväljavõtte impordi ja tasaarveldustega, laoseisud ja laoliikumised, pearaamatu kanded, artiklid ning rida aruannete otspunkte nagu klientide võlgnevused ja finantsaruanded.
Autentimiseks kasutatakse HMAC-SHA256 allkirjastamist kujul apiId + timestamp + httpBody, mis on base64-kodeeritud ja edastatakse päringu parameetritena. Me ei hakka siin allkirjastamise protsessi uuesti kirjeldama, sest Merit Aktiva API juhend katab selle juba samm-sammult, ning me hoiame töös avatud lähtekoodiga pluginat, mis teeb allkirjastamise teie eest ära (merit-aktiva-skills, MIT).
Enne sidumist tasub teada kahte asja. Esiteks märgib Merit Aktiva enda dokumentatsioon, et API on kasutatav ainult Pro- ja Premium-litsentsidega. Kui kasutate odavamat paketti, siis teie jaoks seda API-t olemas ei ole. Teiseks ei avalda Merit ühtegi numbrilist päringulimiiti. Dokumentatsioonis kirjeldatakse HTTP 429 piiranguid ja soovitatakse uuesti proovimisel genereerida uus ajamärk. See on aga lõks: algse allkirjastatud päringu uuesti saatmine pärast ooteaega ebaõnnestub autentimisvea tõttu, kuna ajamärk on allkirja sees.
SmartAccounts on ainus, mis on loodud sünkroniseerimiseks, mitte lihtsalt päringute tegemiseks
SmartAccounts on ainus tarkvara selles võrdluses, mis pakub korralikku inkrementaalset sünkroniseerimist. Muudatusi saab pärida parameetriga dateType=modifydate ja dateFrom ajamärgiga, vastused on jagatud lehekülgedeks (100 objekti lehel) koos hasMoreEntries lipuga ning muudatuste päringu esimene lehekülg tagastab deleted massiivi objektidest, mis on pärast viimast sünkroniseerimist kustutatud. See viimane detail on midagi, mille kõik teised ära unustavad, kuid just see määrab ära, kas sünkroniseerimine püsib korrektne või hakkab teie süsteemi vaikselt kogunema kustutatud "kummituskirjeid".
Limiidid on avalikud ja konkreetsed: 1000 päringut 24 tunni jooksul ja 60 päringut minutis, limiidi ületamisel tagastatakse HTTP 503. 1000 päringut päevas ei ole palju, kui teha päringuid ebaefektiivselt, ja just seepärast ongi muudatuste-põhine sünkroniseerimine nii oluline.
Autentimiseks kasutatakse HMAC-SHA256 algoritmi hex-formaadis, mis on arvutatud üle URL-i parameetrite ja päringu sisu (ilma nendevaheliste eraldajateta) ning saadetakse parameetritena apikey, timestamp ja signature. Rohkem kui 15 minutit vanad päringud lükatakse aegununa tagasi ning ajamärk peab olema Eesti ajas, mitte UTC-s. Kasutajaliideses (Seaded, Seotud teenused) on olemas allkirja kalkulaator, mis on kiireim viis tuvastada, kas teie koodis on mõni märk valesti kokku liidetud.
API sisaldub igas tasulises kuupaketis ilma lisatasuta, mis on kommertstarkvarade seas kõige kliendisõbralikum hinnapoliitika. Nõrgaks kohaks on aga dokumentatsioon ise: tegemist on 43-leheküljelise PDF-failiga, mille viimane versioon pärineb kuupäevast 01.06.2021. See on küll täpne ja põhjalik, kuid OpenAPI spetsifikatsioon puudub, mis tähendab, et te ei saa automaatselt API klienti genereerida.
Üks hoiatus, mis säästab teie aega: otsides SmartAccounts API dokumentatsiooni, võite sattuda lehele docs.accounts.smartfintech.eu. See on täiesti teine toode (avatud panganduse kontoteabe teenus nimega Smart Accounts), mitte raamatupidamisprogramm. Õige spetsifikatsioon on PDF-fail aadressil smartaccounts.eu.
Kui kaalute just nende kahe vahel, oleme teinud põhjalikuma võrdluse siin: Merit Aktiva vs SmartAccounts.
SimplBooks: kõige lihtsam alustada, kuid pearaamatu osas piiratud
SimplBooks pakub viiest programmist kõige lihtsamat autentimist. Loote API kasutaja (Seaded, Kasutajad), genereerite tokeni ja saadate selle päises X-Simplbooks-Token. Ei mingit allkirjastamist, ajamärke ega kellade erinevuse probleeme. WooCommerce-i sünkroniseerimise või kassaaparaadi liidese puhul saate arved liikuma juba paari tunniga.
Otspunktide nimekiri on lai ja dokumenteeritud OpenAPI 3.0 formaadis: invoices (create, update, delete, list, get_pdf, get_xml, create_from_xml), purchases ostuarvete jaoks koos sama XML-i toega, payments, clients koos kontaktide ja asukohtadega, articles, warehouses, price_offers, sales_orders, purchase_orders, employees ja tasks. Päis X-Input-Format aktsepteerib väärtusi FormData, JSON või Raw ning Raw võimaldab saata otse e-arve XML-i. See on suurepärane lahendus kõigile, kes tegelevad e-arvete automatiseerimisega.
Arvestada tuleb kahe piiranguga. Päringulimiit on 60 päringut minutis ja SimplBooks märgib eraldi, et limiiti ületavad päringud lähevad samuti kvoodi arvestusse - seega vigane korduskatsete tsükkel süvendab probleemi veelgi. Pearaamatu poolel kuvab API otspunkte financial_accounts ja income_accounts ainult lugemiseks ning dokumenteeritud pearaamatu kannete kirjutamise otspunkt puudub. Saate hallata osaregistreid, kuid suvalisi pearaamatu kandeid teha ei saa.
Lihtne token tähendab ka turvalisuse kompromissi. Kuna puudub seos ajamärgiga ja allkiri, tähendab lekkinud token lekkinud kontot, kuni keegi selle uuesti genereerib. Suhtuge sellesse vastava ettevaatlikkusega.
API kasutamiseks on vajalik Premium-pakett. SimplBooks teeb selget vahet sisemistel liidestel (WooCommerce, Shopify, Envoice, Telema, Finbite, pangad, EMTA), mis töötavad ilma API-moodulita, ja välistel liidestel, mis seda vajavad. Kui teile vajalik integratsioon on juba tarkvarasse sisse ehitatud, ei pruugi teil Premium-paketti üldse vaja minna. Kontrollige seda enne paketi vahetamist.
ERPLY-l on hea API, kuid see ei ole raamatupidamisprogramm
ERPLY on selles võrdluses peamiselt selleks, et saaksite selle õigel põhjusel välistada. Selle API on hästi dokumenteeritud ja küps: autentimine toimub kliendikoodi, kasutajanime ja parooliga läbi verifyUser päringu, mis tagastab umbes tunni kehtiva sessioonivõtme, ning seejärel tehakse POST-päringud form-encoded parameetritega. Päringulimiit on avalikult 1000 päringut tunnis konto kohta (viga 1002) ning olemas on ka demokeskkond.
Kuid dokumenteeritud API-d katavad valdkondi nagu tooted, kliendid, müük, e-pood, kassa (POS), ettevõte, ladu, aruanded ja hoiustamine. Pearaamatu otspunktid puuduvad. ERPLY on jaekaubanduse majandustarkvara ja kassasüsteem ning ERPLY enda dokumentatsioon kirjeldab selle liidestamist Merit Aktivaga raamatupidamise poole lahendamiseks. Kui peate poodi, kasutate tõenäoliselt ERPLY-t koos päris raamatupidamisprogrammiga ning peamine automatiseerimise küsimus on see, kuidas andmeid nende vahel liigutada, mitte see, kas ERPLY suudab teie pearaamatut asendada.
Milline programm valida, kui eesmärk on automatiseerimine?
Valige RIK e-arveldaja, kui alustate uue ja lihtsa ettevõttega ning soovite parimat tasuta API-t. Valige SmartAccounts, kui teil on vaja hoida välist süsteemi sünkroonis ilma andmete lahknevuseta. Valige Merit Aktiva, kui vajate kõige põhjalikumat raamatupidamise tuge ja kasutate juba Pro- või Premium-paketti. Valige SimplBooks, kui kõige olulisem on esimese töötava liidestuse kiire valmimine.
Aus pingerida sõltub sellest, mida te ehitate:
-
Pidev kahesuunaline sünkroniseerimine e-poe või CRM-iga. SmartAccounts, sest see on ainus, mis annab teada, mis on kustutatud. Kõik teised programmid sunnivad teid andmeid võrdlema täisnimekirjade kaudu, mis muutub 1000 päringu päevalimiidi juures kiiresti kulukaks.
-
Tehisintellekti agent või töövoog, mis loeb ja kirjutab reaalseid raamatupidamisdokumente. Merit Aktiva, sest selle otspunktid katavad reaalselt ostuarveid koos kinnitusringi staatustega, tasaarveldusi ja pearaamatu kandeid. Juhend AI raamatupidaja ehitamine kirjeldab täpsemalt, kuidas see praktikas välja näeb.
-
Arvete ühesuunaline saatmine teie enda tarkvarast. SimplBooks. Päise token tähendab, et te ei pea kirjutama ega haldama allkirjastamise koodi, ja e-arve XML-i otse saatmine on suurepäraselt toetatud.
-
Väike OÜ, mis soovib automatiseerimist ilma tarkvarakuludeta. RIK e-arveldaja. OpenAPI spetsifikatsioon, demokeskkond ja täielik CRUD arvete, maksete ning pearaamatu kannete jaoks - ja seda kõike tasuta - on midagi, mida riigiasutuselt ei osatud oodata.
Millal ei tasu neist ühegi API-t automatiseerida
Kui teie igakuine maht on alla paarikümne dokumendi, ei ole API teie pudelikael ja liidestuse ehitamine maksab rohkem, kui see säästab. Kui vajate ranget töökindluse garantiid, siis ükski neist pakkujatest ei avalda API kättesaadavuse SLA-d. Ja kui teie raamatupidaja on ainus, kes andmetega tegeleb ja on programmiga rahul, tekitab integratsioon sageli lihtsalt teise andmeallika, mida keegi peab hiljem käsitsi klapitama. Automatiseerige süsteemide vahelisi piire, mitte raamatupidajat ennast.
Kuidas enne ostu API lubadusi ise kontrollida
Ärge uskuge pimesi tarkvarapakkuja turunduslehte ega ka seda artiklit. API-d muutuvad. Kolm kontrolli võtavad aega kümme minutit ja annavad selge vastuse:
- Leidke masinloetav spetsifikatsioon. Proovige
{docs-host}/openapi.yamlvõi vaadake dokumentatsiooni lehe lähtekoodi ja otsige sealtspec-urlatribuuti. Nii SimplBooks kui ka RIK kuvavad oma dokumentatsiooni ReDoc-i abil, mis tähendab, et tegelik OpenAPI fail on vaid ühe HTTP-päringu kaugusel. Kui spetsifikatsiooni pole, tuleb teil hakata lugema tavalist teksti. - Otsige dokumentatsioonist paketi piiranguid. See oluline lause on tavaliselt lühike ja seda on lihtne kahe silma vahele jätta. Merit märgib selgelt, et API vajab Pro- või Premium-paketti. Kontrollige oma paketti enne tööde planeerimist.
- Leidke päringulimiidid ja korduskatsete loogika. Avalikustatud number on hea märk. Veelgi olulisem on aga see, mis juhtub limiidi ületamisel ja kas autentimisskeem võimaldab päringut pärast ooteaega uuesti saata. Allkirjastatud ajamärgiga lahenduste puhul (nagu Merit, SmartAccounts ja RIK) see nii ei ole.
Kui tarkvarapakkuja ei suuda oma dokumentatsioonis neile kolmele küsimusele vastata, on see juba iseenesest vastus.
KKK
Millisel Eesti raamatupidamisprogrammil on parim API?
Spetsifikatsiooni kvaliteedi poolest RIK e-arveldaja, kuna see pakub OpenAPI 3.1 dokumenti ja demokeskkonda. Raamatupidamise funktsionaalsuse ulatuse poolest Merit Aktiva. Kahe süsteemi sünkroonis hoidmiseks ilma andmekadudeta SmartAccounts, sest see on ainus, mis annab teada kustutatud kirjetest.
Kas Merit Aktiva API on saadaval igas paketis?
Ei. Merit Aktiva enda dokumentatsioon märgib, et API on kasutatav ainult Pro- ja Premium-litsentsidega. Kontrollige oma paketti enne, kui hakkate integratsiooni planeerima.
Kas tasuta RIK e-arveldajal on tõesti API?
Jah. Tegemist on JSON REST API-ga aadressil rmp-api.rik.ee, mis põhineb avalikul OpenAPI 3.1 spetsifikatsioonil, ning olemas on ka demokeskkond aadressil demo-rmp-api.rik.ee. Juhatuse liige saab selle seadetest sisse lülitada ning vajalik on kehtiv e-arveldaja kasutusleping.
Millised on päringulimiidid?
SmartAccounts lubab 1000 päringut 24 tunni jooksul ja 60 päringut minutis. SimplBooks lubab 60 päringut minutis. ERPLY lubab 1000 päringut tunnis konto kohta. Merit Aktiva ja RIK ei avalda numbrilisi limiite, kuigi Merit kirjeldab HTTP 429 piiranguid ja RIK blokeerib IP-aadresse pärast korduvaid ebaõnnestunud autentimiskatseid.
Kas nende API-de kaudu saab teha pearaamatu kandeid?
Merit Aktiva, SmartAccounts ja RIK e-arveldaja võimaldavad pearaamatusse kirjutamist. SimplBooks pakub ainult lugemisõigusega kontode nimekirju ilma dokumenteeritud pearaamatu kande otspunktita ning ERPLY-l puuduvad pearaamatu otspunktid täielikult.
Kas mul on vaja arendajat või saan kasutada platvorme n8n või Make?
HMAC-allkirjastatud lahendused (Merit, SmartAccounts, RIK) vajavad allkirja arvutamiseks koodisammusid, mida toetavad nii n8n kui ka Make. SimplBooks töötab tavalise HTTP-päringu ja päisega. Vaadake täpsemat juhendit siit: Merit Aktiva automatiseerimine Make ja n8n abil.
Kuhu see kõik välja viib
Just API on see, mis määrab ära, kas teie raamatupidamisprogramm on tupiktee või mitte. Programmide funktsioonide nimekirjad on sarnased, kuid integratsioonivõimalused mitte. Dokumenteeritud ja kirjutatava API-ga programm tähendab, et teie arved, ostudokumendid ja käibemaksudeklaratsiooni andmed liiguvad automaatselt ilma käsitsi sisestamiseta. Ilma API-ta programm tähendab aga seda, et keegi sisestab neid andmeid käsitsi seni, kuni te seda ettevõtet omate.
Kui valite praegu programmi ja automatiseerimine on osa plaanist või olete hätta jäänud mõne olemasoleva API käivitamisega, andke meile teada, mida soovite liidestada, ja me ütleme teile enne raha kulutamist, kas see on teostatav.