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.
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 osa oleme avaldanud avatud lähtekoodiga. merit-aktiva-skills on MIT-litsentsiga tööriistakomplekt, mis katab allkirjastamise ja Merit Aktiva v2 lõpp-punktid ning on dokumenteeritud nii eesti kui inglise keeles. Seda saab kasutada igaüks, ka ilma meieta.
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.
- 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.
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.
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.