WooCommerce ja Merit Aktiva
arved, laekumised ja tagastused
WooCommerce’i tellimus võib olla makstud, kuid raamatupidamises võib arve või laekumine veel puududa. Merit Aktiva liidestuse tellimisel tasub kokku leppida kogu teekond: millal tekib arve, kuidas lisandub makse ja mis juhtub tagastusega.
See juhend aitab e-poe omanikul, arendajal ja raamatupidajal enne töö alustamist samad küsimused läbi käia. Fookus on kontrollitaval tulemusel, mitte pelgalt sellel, kas moodul on paigaldatud. Kontode, maksukäsitluse ja dokumentide kuupäevade valikud kinnita oma raamatupidajaga.
Lepi kokku neli eraldi sündmust
- Tellimus: ostja valib kaubad, tarne ja makseviisi. See ei kinnita veel raha laekumist.
- Müügiarve: tellimuse andmetest tekib kokkulepitud hetkel raamatupidamisdokument.
- Laekumine: konkreetse arvega seotakse tasutud summa, vajadusel osade kaupa.
- Makseteenuse väljamakse: makseteenuse kogutud raha jõuab ettevõtte kontole, võimalik et teenustasu võrra väiksema summana.
Kirjelda iga makseviisi kohta, milline süsteem sündmuse kinnitab. Pangalingi, kaardimakse ja arvega tasumise teekonnad võivad erineda. Kui kasutad näiteks Montoniot, Maksekeskust või Stripe’i, kontrolli valitud mooduli tegelikku tuge, mitte ainult teenuse nime müügikirjelduses.
Meriti API dokumentatsioon lubab müügiarvele edastada tasumise infot ja olemasolevale arvele laekumisi ka mitmes osas. See on API võimalus, mitte kinnitus, et iga WooCommerce’i liides kõik need olukorrad automaatselt lahendab.
Millal ja millistest andmetest arve tekib?
Pane kirja, milline WooCommerce’i tellimuse staatus käivitab arve koostamise. Makse õnnestumine, kauba väljasaatmine ja tellimuse lõpetamine ei pruugi toimuda samal ajal. Määra ka see, mis saab ootel, tühistatud või hiljem muudetud tellimusest ning kumb süsteem saadab kliendile lõpliku arve.
- Seo toote ja variatsiooni kood Meriti artikliga. Leppige kokku, kuidas käsitletakse puuduvat või muutunud koodi.
- Kontrolli kliendi nime, ettevõtte andmeid ja arve aadressi; tellija ja arve saaja ei pruugi olla sama.
- Kaasa tarne, allahindlused ja muud tellimuse read. Kontrolli maksukoode ning hindade esitamist koos käibemaksuga või ilma.
- Võrdle rea- ja kogusummasid ka ümardamise korral. Ühes süsteemis nähtav korrektne lõppsumma ei tõenda teise süsteemi ridade õigsust.
- Säilita tellimuse ja arve vaheline viide, et sama tehing oleks hiljem mõlemast süsteemist leitav.
Võta testimiseks päris müügiloogikat esindavad näited, kuid eemalda neist kliendi isikuandmed. Arenduse vastuvõtmisel peab saama iga näite puhul näidata, milline arve tekkis ja miks just sellise sisuga.
Kuidas vältida laekumise topeltkajastamist?
Kui e-poe liides saadab laekumise ja pangatehingute import püüab sama makset uuesti siduda, vajab töövoog selget reeglit. Määra iga makseviisi jaoks, kust laekumise info tuleb, kes selle kinnitab ja kuidas hilisem pangatehing sama müügi juurde sobitatakse.
Kaardimakse puhul võib klient tasuda täissumma, samal ajal kui makseteenus kannab ettevõttele hiljem üle koondsumma, millest teenustasu on maha arvatud. Meriti juhend käsitleb selle jaoks kaardilaekumiste kontot, teenustasu ja saldo kontrolli. Täpne seadistus tuleb sobitada sinu makseteenuse aruannete ja raamatupidamisega.
Osamakse korral kontrolli, et arvel jääks õige tasumata summa. Korduv makseteavitus ei tohi tekitada teist laekumist. Kui teavitus saabub enne arve loomist, peab ühendus suutma olukorra hiljem lahendada või näitama selgelt, et inimese sekkumine on vajalik.
Tagastus peab jõudma mõlemasse süsteemi
Tagastuse puhul kontrolli eraldi raha tagastamist makseteenuses, kreeditarvet Merit Aktivasse ning vajadusel laokauba tagastust. Ühe sammu õnnestumine ei tõenda ülejäänuid. Meriti API kirjeldab kreeditarve koostamist, kuid valitud mooduli osalise tagastuse tuge tuleb eraldi proovida.
Näiteks tagastab klient kolmest tootest ühe. Kas kreeditarvele jõuab õige kogus, allahindluse osa ja maksusumma? Kas tagastatakse ka tarnekulu ja millises ulatuses? Need otsused tuleb enne automatiseerimist kokku leppida, mitte lasta mooduli vaikeseadistusel neid märkamatult määrata.
Kust tuleb tagastatud laokauba omahind?
Meriti müügiarve API nõuab laokauba krediteerimisel omahinna summat väljas ItemCostAmount. Kui e-pood teab müügihinda, aga mitte omahinda, tuleb sobiv andmeallikas eraldi lahendada. Küsi pakkujalt, kust see väärtus tuleb ja kuidas raamatupidaja selle õigsust kontrollib. Müügihinda ei tasu vaikimisi omahinnaks pidada.
Kaheksa testi enne liidestuse vastuvõtmist
Lisa need olukorrad pakkumise või lähteülesande juurde. Iga testi jaoks leppige kokku oodatav arve, laekumine ja saldo ning tõrke korral nähtav veateade. Nii saab kontrollida tervet töövoogu, mitte ainult edukat API vastust.
- Tavaline tasutud tellimus: õiged tooted, tarne, maksud ja üks arve ning üks laekumine.
- Kupong ja mitu tooterida: allahindluse jaotus ning ümardus annavad kokkulepitud tulemuse.
- Tasumata või tühistatud tellimus: ei teki ekslikku laekumist ega kokkuleppevastast arvet.
- Osamakse: makse seotakse õige arvega ja ülejäänud saldo jääb alles.
- Osaline tagastus: krediteeritakse ainult tagastatud osa, koos kokkulepitud tarne- ja allahindluse käsitlusega.
- Korduv teavitus või käsitsi kordussaatmine: uut arvet ega topeltlaekumist ei teki.
- Katkestus või päringupiirang: töö jääb nähtavalt ootele, korduskatse ei dubleeri varem loodud dokumenti.
- Päeva lõpu võrdlus: tellimused, arved, tagastused ja laekumised on viidete abil võrreldavad ning lahendamata erinevused leitavad.
Meriti API kasutab päringupiirangu ületamisel vastust 429. Mahukama poe puhul küsi, kuidas järjekord pärast katkestust taastub, kes veast teada saab ja kuidas juba edastatud dokument ära tuntakse. Piiramatu reaalajas sünkroonimise lubaduse asemel leppige kokku sinu müügimahtudele sobiv käitumine.
Praktiline näide: Vitamate’i e-pood
Raha Netise Vitamate’i projektikirjelduses on koos Montonio makselahendus ja Merit Aktiva raamatupidamisliidestus. See on näide e-poest, kus ostmine, maksmine ja raamatupidamine moodustavad ühe terviku.
Vitamate’i uus pood on ehitatud Astroga. WooCommerce’i puhul tuleb eraldi kontrollida kasutatava mooduli võimalusi, sealhulgas osaliste tagastuste käsitlemist. Sinu olemasoleva poe puhul tuleb hinnata just selle andmeid ja töökorraldust.
Vaata Vitamate’i e-poe projekti

Kui lisaks raamatupidamisele on vaja juhtida mitme lao jääke või B2B kliendihindu, tasub eraldi läbi mõelda, milline süsteem neid andmeid haldab. Erply ja e-poe ühendamise juhend käsitleb seda laiemat valikut.
Millest liidestuse töömaht ja hind sõltuvad?
Kõigepealt kontrolli Merit Aktiva paketti ning olemasoleva WooCommerce’i mooduli võimalusi. Meriti järgi on tavapärane andmevahetus teiste tarkvaradega API kaudu Pro ja Premium pakettides; juhendis on eraldi kirjeldatud erandid. Iga ühendatava tarkvara jaoks kasutatakse eraldi API võtit ja ID-d, mille loob peakasutaja. Võtmeid ei tohi lisada avalikku lähteülesandesse ega saata esimeses hinnapäringus.
- Toodete ja variatsioonide arv, koodide kvaliteet ning Meriti artiklitega sidumine. E-poe ehitamise või ümbertegemise hinnas on toodete arv kindlasti eraldi tegur.
- Tellimuste tavaline ja tipptunni maht, korraga kasutatavate poodide ja ettevõtete arv.
- Makseviisid, osamaksed, valuutad, tarne- ja allahindlusreeglid.
- Tagastuste ning laokauba omahinna töövoog.
- Olemasolevad moodulid, erikohandused ja varasemate dokumentide korrastamise vajadus.
- Veateavitused, kontrollvaade, testimine ja edasine hooldus.
Palu pakkumises eristada seadistust, vajalikku eriarendust, andmete korrastamist ning võimalikke korduvaid litsentsi- ja hoolduskulusid. Kõiki toimivaid osi ei pea uuesti ehitama. Oluline on näidata, milline olemasolev lahendus nõuded katab ja milline puuduv osa vajab arendust.
Mida esimesse hinnapäringusse lisada?
Saada poe aadress, kasutatav Merit Aktiva pakett ja liidese nimi, kui see on juba olemas. Lisa makseviisid, toodete ja variatsioonide ligikaudne arv, tellimuste maht ning üks konkreetne probleem: näiteks osaline tagastus ei jõua Meritisse või laekumine tuleb topelt.
Näidisest piisab ilma kliendi nime, aadressi, kontaktide ja muude isikuandmeteta. Ära saada API võtmeid ega paroole. Nende lähteandmete põhjal saab arutada, kas vaja on seadistuse parandust, olemasoleva liidese täiendust või suuremat e-poe arendust.
Allikad ja lisalugemine
Allikad kontrollitud 14. novembril 2026. API võimalused põhinevad Meriti ametlikel juhenditel, projektinäide Raha Netise avalikul portfooliol.