Merit Aktiva oskab API keelt. Paneme ta ülejäänud ettevõttega rääkima.
AlusLabs ehitab Merit Aktiva API-liidestusi: seome Merit Aktiva e-poe, CRM-i, tabelite ja ettevõtte enda töövoogudega, nii et andmeid ei pea käsitsi ümber trükkima.
Merit Aktiva on Eestis üks levinumaid raamatupidamisprogramme ja tal on avalik liides. Enamik ettevõtteid ei kasuta seda, sest iga päring tuleb eraldi allkirjastada ja lõpp-punktid tuleb selgeks teha. See osa on meie töö, mitte sinu oma.
Kes ehitab Merit Aktiva liidestuse?
AlusLabs ehitab Eesti ettevõtetele Merit Aktiva liidestusi. Töö käib üle Merit Aktiva avaliku REST-API: päringud allkirjastatakse HMAC-SHA256 algoritmiga ja andmed liiguvad otse, ilma vahepealsete failideta. Sinu käest vajame vaid ligipääsu ning vastust küsimusele, millised andmed ja mis suunas peavad liikuma.
Merit Aktiva päringute allkirjastamise kood on avaldatud MIT-litsentsiga tööriistakomplektina aadressil github.com/arturl95/merit-aktiva-skills, seega saad enne otsustamist koodi ise lugeda.
Mida me ühendame
Merit Aktiva API kaudu saab arveid, kliente ja artikleid nii lugeda kui kirjutada. Sellest tulevad suunad, mida me ehitame. Iga liidestus pannakse kokku sinu enda andmete ja protsessi järgi.
E-pood
WooCommerce või Shopify tellimusest sünnib Merit Aktivas müügiarve koos õige kliendi, artikli ja käibemaksumääraga. Tellimuste käsitsi ülekandmine kaob.
CRM
Kliendikaardid ja arved liiguvad CRM-i ja Merit Aktiva vahel ühes või mõlemas suunas. Müügiinimene näeb ise, mis on makstud ja mis mitte.
Google Sheets ja tabelid
Aruanne, mis uueneb ise. Käibed, laekumata arved ja kliendipõhised kokkuvõtted loetakse API kaudu tabelisse, ilma igakuise eksportimiseta.
Sisemised töövood
Kinnitusringid, ülevaated Slacki või e-postile, hoiatus üle tähtaja läinud arvest. Voog jookseb ise ja puudutab Merit Aktivat ainult siis, kui vaja.
E-arved
E-arvete liikumine seotakse Merit Aktiva andmetega, nii et sama arvet ei pea kahes kohas sisestama ega üle kontrollima.
Kuidas see tehniliselt käib
Merit Aktiva API ootab iga päringu juures HMAC-SHA256 allkirja. API ID, ajatempel ja päringu sisu pannakse kokku ning allkirjastatakse API võtmega. Vale allkiri tähendab, et päring lihtsalt ei lähe läbi, ja just seda kohta on liidestust kirjutades kõige lihtsam valesti teha.
Selle koha oleme enda jaoks korra ära lahendanud ja tulemuse avalikuks teinud. Allolev tööriistakomplekt teeb allkirjastamise ära ja katab v2 lõpp-punktid, nii et iga uus projekt ei alga sellest samast kohast uuesti.
Avatud lähtekood
github.com/arturl95/merit-aktiva-skillsHMAC-SHA256 päringute allkirjastamine, Merit Aktiva v2 lõpp-punktide kate, MIT-litsents, dokumentatsioon eesti ja inglise keeles. Loetav ja kasutatav ka ilma meieta.
Merit Tarkvara API-partner
www.merit.ee/partnerid/?type=api&partner=AluslabsAlusLabs on Merit Tarkvara avalikus API-partnerite nimekirjas alates oktoobrist 2026. Kirje Merit Tarkvara lehel: Merit Aktiva API-liidestused e-poodide, CRM-süsteemide, AI ja muude tarkvarasüsteemidega.
- checkAutentimine ja allkirjastamine on juba lahendatud, mitte iga projekti alguses uuesti kirjutatud.
- checkAndmed liiguvad API kaudu, mitte käsitsi eksporditud failide peal.
- checkKui midagi läheb valesti, tuleb see kohe välja, mitte alles kuu lõpus.
Käibedeklaratsioon ja e-arved
Käibedeklaratsiooni lisa täidetakse nende arvete põhjal, mis on reaalselt Merit Aktivas olemas. Kui osa neist sisestatakse käsitsi ja hiljem, tuleb kuu lõpus eraldi kontrollida, kas midagi on puudu. Liidestus viib arved üle kohe, kui need tekivad, ja see kontroll jääb ära.
E-arvetega on lugu vastupidine. Sissetulev e-arve võib jõuda raamatupidamisse ilma, et keegi peaks seda uuesti sisestama. Merit Aktiva API kaudu saab need kaks liikumist kokku siduda, et sinu meeskond ei peaks sama dokumenti kahes kohas töötlema.
Millal tasub liidestada
Liidestus tasub ära siis, kui sama tööd tehakse korduvalt käsitsi. Neli tüüpilist märki:
Samad andmed on kahes kohas
Klient on nii e-poes kui Merit Aktivas ja keegi hoiab neid käsitsi sünkroonis. Iga uus klient tähendab kaht sisestust.
Keegi impordib käsitsi CSV-faile
Iga import on eraldi töö ja iga vormingumuutus on uus viga. API kaudu liigub sama info ilma failita.
Kuu lõpp on käsitöö
Eksport programmist, valemid, filtrid ja kontroll, kas summad klapivad. Sama töö kordub iga kuu samamoodi.
Numbrit tuleb raamatupidajalt küsida
Kui müügi- või juhtimisinfo saamiseks peab kellelegi kirjutama ja ootama, on see andmete kättesaadavuse küsimus.
KKK
Kas Merit Aktival on API?
Jah. Merit Aktival on avalik REST-API, mille kaudu saab lugeda ja kirjutada arveid, kliente, artikleid ja muid andmeid. Ligipääsuks on vaja API ID-d ja API võtit, mille saab Merit Aktiva seadistustest.
Kas peame Merit Aktivast loobuma?
Ei. Liidestus ehitatakse olemasoleva programmi peale ja raamatupidaja töötab edasi samas keskkonnas. Muutub ainult see, kui palju andmeid sinna käsitsi sisestatakse.
Kui kaua liidestus võtab?
See sõltub mahust. Ühesuunaline voog ühe süsteemi ja Merit Aktiva vahel on tunduvalt kiirem kui mõlemasuunaline sünkroonimine mitme süsteemi vahel, kus tuleb lahendada ka erandid ja duplikaadid. Ütleme aja alles siis, kui oleme näinud, millised andmed ja millised erandid liikuma peavad.
Kas saame seda ise hallata?
Jah. Voog jääb sinu enda keskkonda ja kontodele ning üle antakse nii ligipääsud kui ka dokumentatsioon. Kui tahad hiljem ise muudatusi teha, saad seda teha; kui ei taha, hoiame voogu edasi meie.
Seotud liidestused
WooCommerce'i ja Merit Aktiva liidestus: tellimusest arveni
Tellimusest saab Merit Aktivas müügiarve koos õige kliendi, artikli ja käibemaksukoodiga ning tagastusest kreeditarve. AlusLabs ehitab liidestusi WooCommerce'i ja Merit Aktiva vahel.
Pipedrive ja Merit Aktiva: võidetud tehingust müügiarveni
Võidetuks märgitud tehing muutub Merit Aktivas müügiarveks koos õige kliendi ja ridadega ning laekumise info jõuab tagasi tehingule. AlusLabs ehitab liidestuse CRM-i ja raamatupidamistarkvara vahele.
E-arve saatmine: operaatorid, formaadid ja Finbite liidestus
E-arve liigub sinu tarkvarast välja andmetena, ostjale sobivas formaadis ja kanalit pidi, mis on kirjas tema äriregistri kaardil. Sageli on selleks kanaliks e-arve operaator nagu Finbite. AlusLabs ehitab sinna vahele liidestuse, mis teeb ka registripäringu ja otsustab, kuhu iga arve saata.
Pangaväljavõtte sobitamine: mida Merit Aktiva teeb ise ja mis jääb üle
Pangaliidestus sobib kokku need väljavõtte read, millel on korrektne viitenumber. Osalised maksed, mitme arve tasumine ühe ülekandega ja netomaksed jäävad sidumata. AlusLabs ehitab reeglid, mis täidavad selle lünga Merit Aktivas.
Kes teeb süsteemide liidestusi Eestis? Merit Aktiva, SimplBooks ja kõik teised programmid sinu majas
Eesti majandustarkvaradel on olemas avalikud API-liidesed, kuid nendevahelist osa ei paku valmis kujul keegi. AlusLabs ehitab selle puuduva osa, annab üle ligipääsud ning dokumentatsiooni ja ütleb sulle, kui sinu juba makstud programmid katavad selle teekonna ise.
EIS digitoetus tarkvara liidestamiseks: kuni 5000 eurot, toetusmäär kuni pool kuludest, taotlemine on jooksev
Eesti riiklik toetus tarkvara kasutuselevõtuks või liidestamiseks on avatud jooksvana: toetus on kuni 5000 eurot ja kuni pool projekti kuludest, ning tarkvara liidestamise arenduskulud on abikõlblikud. AlusLabs ehitab liidestuse, koostab taotluse jaoks hinnapakkumise ja vormistab lõpparuande jaoks vajaliku kirjaliku dokumentatsiooni.
Räägime sinu Merit Aktiva andmetest
Kirjuta paari lausega, millised süsteemid on kasutuses ja mis liigub praegu käsitsi. Ütleme ausalt, kas liidestust tasub ehitada ja millest alustada.