Integratsioon

Montonio teeb väljamakse ühe summana. Merit Aktiva ootab selle taga olevaid arveid.

AlusLabs ehitab Eesti e-poodidele Montonio liidestusi: muudame makstud tellimuse Merit Aktiva müügiarveks ja väljamakse pangareaks, mis läheb automaatselt kokku, et Montonio mahaarvatud teenustasu kajastuks kuluna ega vähendaks märkamatult käivet.

Raha e-poe kassast ei laeku arve kaupa. See jõuab pangakontole väljamaksena, mis katab tervet rühma tellimusi ning millest on kaardimaksete teenustasu juba maha arvatud. Raamatupidamine vajab mõlemat poolt: nii seda, mida klient maksis, kui ka seda, mille Montonio endale jättis.

Räägi oma liidestusest

Kuidas Montonio maksed raamatupidamisse jõuavad?

Raha liigub kahte eri teed pidi ja nende segiajamine ongi koht, kus raamatupidamine sassi läheb. Makstud tellimus on müük ning sellest saab müügiarve koos kliendi, ridade ja käibemaksukoodiga. Väljamakse on aga ülekanne ehk üks koondsumma paljude tellimuste eest, millest Montonio on kaardimaksete teenustasu juba maha võtnud. AlusLabs ehitab mõlemad töövood ja see teine pool ongi osa, mida tavaliselt ei osata oodata.

Montonio dokumenteerib mõlemat poolt, mis teebki sellest reeglipärase süsteemi, mitte igakuise tabeli käsitsi täitmise. Tellimus luuakse ja seda loetakse üle API ning Montonio enda dokumentatsioon näeb ette, et tellimus peab kattuma üks-ühele sinu e-poe, majandustarkvara või raamatupidamissüsteemi tellimusega. Väljamaksed on näha sama API kaudu ja üksiku väljamakse saab eksportida Exceli, XML-i, JSON-i või CSV kujul, kus on kirjas maksete kogusumma, tagasimaksete kogusumma ja tegelikult üle kantud summa.

Mida me ühendame

Müük on protsessi ilmselge pool. Teine pool on kõik see, mida Montonio teeb rahaga alates kliendi maksest kuni rea ilmumiseni sinu pangakontol.

receipt_long

Makstud, mitte lihtsalt vormistatud

Montonio saadab igal tellimuse staatuse muutusel päringu sinu määratud aadressile, nii et arve koostatakse hetkel, kui tellimus saab staatuse makstud, mitte siis, kui keegi järgmine kord e-poe halduse avab. Montonio tellimuse identifikaator salvestatakse koos arvega ja see on ainus tunnus, mille abil väljamakse selle nädal aega hiljem üles leiab.

account_balance

Väljamaksed ja nendes sisalduvad tellimused

Väljamakse näitab, milliseid makseid see sisaldab. API kaudu loetuna saab sellest sild ühe pangarea ja sellega tasutud arvete rühma vahel. Just seepärast lahendatakse see küsimus Montonio poolel, mitte pangaväljavõtet uurides.

percent

Teenustasu, mille laekumist sa kunagi ei näe

Kaardimaksete teenustasud võetakse maha enne väljamakset, kuid väljamakse aruanne näitab endiselt klientide makstud brutosummat. See vahe on müügikulu ja see kajastatakse kuluna, mitte ei lasta käibel näida salapäraselt väiksemana, kui e-pood tegelikult näitas.

undo

Tagasimaksed tehakse väljamaksest

Tagasimakse ei toimu eraldi väljamineva maksena, vaid see vähendab järgmist väljamakset. Kuna väljamakse sisaldab lisaks maksete kogusummale ka tagasimaksete kogusummat, saab kreeditarve ja vähenenud väljamakse omavahel klappima panna.

schedule

Osta kohe, maksa hiljem ja järelmaks

Osta kohe, maksa hiljem ja järelmaksu puhul toimub müük ostuhetkel, kuid raha liigub kellegi teise graafiku alusel. Arve kuupäev ja laekumise kuupäev ei ole enam sama päev ning nende vahele jääv nõue peab raamatupidamises kellelegi kuuluma.

Kuidas see tehniliselt käib

Montonio API autentimiseks kasutatakse JSON Web Tokenit, mis saadetakse bearer-tokenina ja see token koostatakse kahest eraldi tunnusest. Access Key liigub tokeni sees ja tähistab poodi; Secret Key ei liigu kunagi võrgus ja seda kasutatakse tokeni allkirjastamiseks HS256 abil. Mõlemad väljastatakse Montonio partnerisüsteemis ja mõlemad kuuluvad ainult sinu enda süsteemide serveri poolele.

Tellimus on kogu süsteemi alusüksus. Montonio dokumentatsioon näeb ette, et tellimus peab kattuma üks-ühele tellimusega e-poes, majandustarkvaras või raamatupidamissüsteemis ning igal staatuse muutusel saadetakse päring sinu aadressile. Töövoog, mis kuulab staatuse muutusi, mitte ei küsi nimekirja iga paari minuti tagant, teab täpselt hetke, mil tellimus saab staatuse makstud, ja see hetk ongi müügiarve koostamise aeg.

Väljamakse on teistsugune objekt ja teise ülesandega. API kaudu saab poe väljamaksed nimekirjana ja ühe väljamakse saab eksportida Exceli, XML-i, JSON-i või CSV kujul koos maksete kogusumma, tagasimaksete kogusumma ja üle kantud summaga. Sellest ekspordist laekumiste sidumine teebki ühest pangareast sellega tasutud arvete kogumi, selle asemel et keegi peaks seda kuu lõpus käsitsi mõistatama.

Lisaks on olemas konteerimine ja Montonio avaldab kuju, mida ta ootab, mitte ei jäta seda lugeja otsustada. Nende juhis on kajastada müüki nõudena Montonio vastu, vähendada seda nõuet summas, mille väljamakse tegelikult üle kandis, sisestada Montonio teenustasude arve, mis näitab neid juba mahaarvatuna ja seetõttu tasumist ei vaja, ning tasaarveldada see kohustus nõude jäägiga. Töövoog, mis teeb esimesed sammud ja unustab viimase, jätab üles saldo, mida keegi ei oska selgitada.

Avatud lähtekood

github.com/arturl95/merit-aktiva-skills

HMAC-SHA256 päringute allkirjastamine, Merit Aktiva v2 lõpp-punktide kate, MIT-litsents, dokumentatsioon eesti ja inglise keeles. Loetav ja kasutatav ka ilma meieta.

checkMontonio tellimuse identifikaator salvestatakse arvele, et väljamakse leiaks selle hiljem üles.
checkTeenustasu kajastatakse kuluna, mitte ei arvata seda vaikselt tuludest maha.
checkVäljamakse, mis ei kattu selle taga olevate arvetega, peatub ja jääb nähtavale koos vahe näitamisega.

Millal tasub liidestada

Kassa peidab raamatupidamisprobleeme seni, kuni keegi hakkab pangakontot kontrollima. Kõik järgnev tähendab, et midagi on peidus ka praegu:

Käive on raamatupidamises väiksem kui e-poes

E-pood näitab ühte numbrit ja raamatupidamine veidi väiksemat ning see kordub iga kuu. Vahe on teenustasu, mis on kajastatud väiksema tuluna, mitte kuluna.

Tagasimakse tõttu ei klapi kuu kokkuvõte

Väljamakse laekus oodatust väiksemana ja keegi ei oska öelda, millise tellimuse tõttu. Kreeditarve, kui see üldse tehti, sisestati eraldi ja teisel päeval.

Maksa-hiljem tellimused on jäänud õhku

Osamaksetega tasutud tellimuse kohta tehakse arve ostuhetkel, kuid raha laekub palju hiljem. Vahepealset nõuet ei kajastata kellegi all, mistõttu avastatakse see alles siis, kui keegi küsib, miks saldo muutub.

Montonio kontrollimine tähendab tabeli uuesti koostamist

Keegi ekspordib väljamaksed, kleebib need tellimuste kõrvale ja otsib käsitsi, mis ei klapi. Sama tabel koostatakse järgmisel kuul uuesti, sest sellest ei saanud kunagi süsteemi.

KKK

Miks Montonio väljamakse ei kattu kunagi ühegi arvega?

Sest see polegi nii mõeldud. Väljamakse katab korraga mitut tellimust ja sealt on kaardimaksete teenustasu juba maha arvatud, mistõttu on panka laekuv summa väiksem kui klientide makstud summa. Väljamakse aruanne säilitab brutonumbri, mis teebki need kaks poolt omavahel kokkuviidavaks.

Kuidas teenustasu raamatupidamisse jõuab?

Kuluna, Montonio esitatud arve alusel. Montonio enda raamatupidamisjuhis on kajastada müüki nõudena Montonio vastu, vähendada seda nõuet tegelikult üle kantud summaga, sisestada Montonio teenustasude arve, mis näitab neid juba mahaarvatuna ja seetõttu maksmist ei vaja, ning tasaarveldada see kohustus nõude jäägiga.

Mis saab tagasimaksetest?

Need vähendavad väljamakset, mitte ei lähe sinu kontolt välja eraldi maksena. Iga väljamakse sisaldab tagasimaksete kogusummat lisaks maksete kogusummale, nii et kreeditarve saab siduda väljamaksega, mida see vähendas. Kas osaline tagasimakse vormistatakse kreeditarvena tagastatud ridade või kogu summa kohta, on raamatupidamislik otsus ja sinu raamatupidaja teeb selle enne liidestuse ehitamist.

Kas see sõltub sellest, millise makseviisi klient valis?

Vähem, kui võiks arvata. Montonio dokumenteerib pangamakseid, kaardimakseid, MobilePayd, BLIKi, osta kohe, maksa hiljem lahendusi ja järelmaksu ning müük on müük neist igaühe puhul. Erineb vaid see, millal raha laekub ja mis teel maha arvatakse, mis ongi põhjus, miks tellimust ja väljamakset käsitletakse kahe eraldi asjana.

Mis juhtub, kui väljamakse ei lähe kokku?

Protsess peatub ja väljamakse jääb nähtavale koos vahe suurusega. Midagi ei jaotata arvete vahel ära lihtsalt selleks, et summad klappima saada, sest paari euro suurune vahe on tavaliselt tagasimakse, teenustasu või kahekordselt laekunud tellimus ja igaühel neist on oma lahendus. Selgitamata vahe on info ja selle peitmine maksab rohkem kui näitamine.

Saada meile üks väljamakse ja selle taga olevad tellimused

Kirjuta paari lausega, millised süsteemid on kasutuses ja mis liigub praegu käsitsi. Ütleme ausalt, kas liidestust tasub ehitada ja millest alustada.

Võta ühendust Majandustarkvara automatiseerimine