Hvað er bókhaldsvefþjónusta? Leiðbeiningar á mannamáli fyrir kerfissmiði

Einföld skilgreining á bókhaldsvefþjónustu, hvernig hún greinist frá skattavefþjónustu eða greiðsluþjónustu og hvað þarf að athuga áður en forritað er gegn henni.

Bókhaldsvefþjónusta (accounting API) er viðmót sem gerir einu forriti kleift að halda bókhald annars forrits. Hugbúnaðurinn þinn sendir fjárhagslegan atburð yfir HTTP. Vefþjónustan breytir þeim atburði í jafnaða tvíþætta færslu (double-entry journal entry) á móti aðalbók (chart of accounts), geymir hana þannig að ekki sé hægt að breyta henni í leyni, beitir tilskildum skattameðferðum og skilar þér skýrslum, skjölum og útflutningi í gegnum sama viðmót.

Sú skilgreining vinnur nánast allt verkið. Allt annað í þessari grein er afleiðing af henni.

Útgáfan í einni setningu

Bókhaldsvefþjónusta tekur við fjárhagslegum atburðum úr forritinu þínu, breytir hverjum og einum í jafnaða færslu, geymir hana óbreytanlega ásamt skattameðferð og tiltækum gögnum, og birtir tilheyrandi höfuðbók (ledger), skjöl og skýrslur sem forritanlega endaða (endpoints).

Ef vara kallar sig bókhaldsvefþjónustu en skilar ekki færslum, þá er hún eitthvað annað með góðu nafni. Það þarf ekki að vera slæmt. Það þýðir einfaldlega að hún mun ekki leysa það verkefni sem þú ætlar að fela henni.

Hvað bókhaldsvefþjónusta er ekki

Fjórir skyldir vöruflokkar renna oft saman við bókhaldsvefþjónustur, venjulega seint í verkefni.

Flokkur	Hvað hún gerir	Hvað hún gerir ekki
Skattreikningsvefþjónusta (Tax calculation API)	Skilar réttu skatthlutfalli eða skattfjárhæð fyrir viðskipti	Heldur utan um bókhald þitt eða geymir gögnin sem lágu til grundvallar ákvörðuninni yfir varðveislutímabilið
Greiðsluvefþjónusta (Payments API)	Flytur peninga á milli aðila og skýrir frá þeim hreyfingum	Skráir þóknunartekjur, virðisaukaskatt sem ber að greiða eða skuldbindingu gagnvart seljanda á milli greiðslu og útborgunar
Samþætt eða safnvefþjónusta (Unified or aggregator API)	Les og skrifar gögn í núverandi bókhaldskerfi viðskiptavinar þíns	Virkar sem upprunakerfi (system of record); bókhald þitt býr í því tól sem hver viðskiptavinur notar nú þegar
Skýrslu- eða viðskiptagreiningarvefþjónusta (Reporting or BI API)	Les tölur úr fyrirliggjandi höfuðbók og birtir þær á myndrænan hátt	Býr til færslurnar sem tölurnar eru dregnar af

Hvert þessara tækja á sín raunverulegu notkunarsvið. Vettvangur sem þarf að vera upprunakerfi þarf bókhaldsvefþjónustuna undir sig, en ekki í staðinn fyrir hana.

Fimm hlutirnir sem bókhaldsvefþjónusta verður að gera

1. Skrá jafnaðar færslur. Hver atburður verður að debet- og kreditfærslum sem samtals gera upp í nákvæmlega sömu töku. Þegar kaupandi greiðir 100 € á markaðstorgi sem tekur 15 € þóknun, þá færist debet á millireikning (clearing account) upp á 100 €, kredit á skuldbindingu við seljanda upp á 85 €, og kredit á þóknunartekjur upp á 15 €. Þetta er ekki bókhaldslegur formsatriði. Þetta er byggingarleg athugun sem grípur heila flokka samþættingarvillna áður en þær skila sér í skýrslu.

2. Halda sögu. Færslu sem hefur verið bókuð er ekki breytt. Mistök eru leiðrétt með endurgreiðslufærslu ásamt leiðréttri færslu, þar sem báðar tengjast hinni ursrunalegu færslu. Lokuðum mánuðum er læst þannig að ekki sé hægt að bóka nýjar færslur inn í þá.

3. Leysa úr skattamálum. Fyrir viðskipti innan Evrópubandalagsins þýðir þetta afhendingarstað, skattskyldu í kaupandans hönd (reverse charge), staðfestingu á virðisaukaskattsnúmerum gegn opinberum skrám og þau gögn sem réttlættu ákvörðunina, allt geymt með færslunni í stað þess að vera hent eftir útreikninginn.

4. Jafna við útlæga peninga. Bókhald sem hittir aldrei bankayfirlit er ágiskun. Vefþjónustan verður að flytja inn yfirlit eða uppgjör frá þjónustuaðilum og passa þeim saman við það sem var skráð.

5. Útflutningur. Skýrslur, skjöl og endurskoðunarskrár á sniðum sem mannlegur endurskoðandi og skattyfirvöld samþykkja.

Vara sem gerir fyrstu þrjú atriðin en ekki síðustu tvö mun samt sem áður skilja eftir manneskju í vinnu við töflureikna í hverjum mánuði.

Hvernig kall lítur út í raun og veru

Vélbúnaðurinn er einfaldari en bókhaldstæknin. Í vefþjónustu Nordlet er öll aðgerð RPC-stíls POST beiðni með fyrirsjáanlegusniði:

POST /v1/{module}/{resource}/{action}
Authorization: Bearer <api key>
Idempotency-Key: <your event id>

Þú býrð til sölureikning og gefur hann síðan út. Útgáfan er það augnablik sem bókhaldsaðgerðin á sér stað: skjalið fær sitt samfellda númer, jöfnuð færslan bókast og virðisaukaskattslínurnar eru skráðar með henni. Vettvangurinn þinn setur aldrei saman debet og kredit í höndunum.

Þrjár smáatriði í þessum kóðabút skipta meira máli en heiti endapunktarins:

Heimildasvið lykilsins (scope). Lykill bera með sér heimildum eins og sales:write, þannig að samþætting fær aðeins það aðgangshlutverk sem hún þarf á að halda.
Ítrekunarlykillinn (idempotency key). Endurtaktu sömu beiðni með sama gagnapakka og þú færð geymdu svörin til baka í stað annars reiknings. Sendu sama lykil með öðruvísi gagnapakka og beiðninni er hafnað með idempotency_key_reuse í stað þess að vera tekið við henni í þögn.
Peningar sem strengir. Upphæðir eru tugabrotastrengir, ekki fleytitölur (floating-point numbers), vegna þess að fleytitölur tapa aurum á þann hátt sem kemur í ljós við árslok.

Hvar hún stendur í kerfishönnuninni þinni

Forritið þitt er áfram framendi og uppspretta viðskiptaatburða. Bókhaldsvefþjónustan verður fjárhagslegt upprunakerfi á bak við það. Flæðið er venjulega svona:

Eitthvað gerist í vörunni þinni: pöntun, endurgreiðsla, útborgun, áskriftarendurnýjun.
Bakendinn þinn kallar á bókhaldsvefþjónustuna með atburðinum og ítrekunarlykli.
Vefþjónustan bókar færsluna, beitir virðisaukaskatti og skilar auðkendum sem þú geymir á móti þínum eigin skrám.
Vefkall (webhook) eins og sale_invoice.paid lætur kerfið þitt vita þegar staða breytist, þannig að þú bregst við atburðum í stað þess að leita stöðugt (poll).
Bankafærslur berast í gegnum bankastraum eða innflutning á yfirliti og eru jafnaðar á móti skráðum skjölum.
Við lok tímabils eru skýrslur og skattaskrár búnar til úr sömu gögnum og lokaða mánuðinum er læst.

Ekkert á þessum lista krefst þess að manneskja opni bókhaldsforrit. Það er einmitt tilgangurinn með þessum vöruflokki.

Hvernig hún ber sig saman við valkostina

Nálgun	Erfiðleiki við upphaf	Endurskoðunarstaða	Skalerast með magni viðskipta
Töflureiknar og handvirk skráning	Lægstur	Veik; saga er breytileg	Nei
Bókhaldsforrit og CSV útflutningur	Lágur	Fer algjörlega eftir aga	Slæmt; einhver flytur inn skrár
Safnvefþjónusta inn í bókhaldið hjá hverjum viðskiptavini	Miðlungs	Erfir það sem tól viðskiptavinarins gerir	Já, en þú átt aldrei færsluna
Innbyggð bókhaldsvefþjónusta (Embedded accounting API)	Miðlungs	Sterk ef höfuðbókin er óbreytanleg og tímabilum er læst	Já
Smíða eigin höfuðbók	Hæstur	Sterk aðeins ef þú smíðir líka stýringarnar	Já, og þú viðheldur henni að eilífu

Að smíða eigin lausn er fullgilt val fyrir sum teymi. Það er fjallað nánar um það í leiðbeiningum okkar um að smíða eða kaupa fyrir markaðstorg.

Hvað skal athuga áður en þú forritar gegn vefþjónustu

Er staðan reiknuð eða geymd? Spyrðu hvort staða seljanda sé fyrirspurn yfir færslulínur eða dálkur sem einhver uppfærir. Aðeins annað þeirra lifir af endurskoðun.
Hvað gerist við endurtekningu (retry)? Sendu sömu beiðni tvisvar og teldu færslurnar.
Getur þú breytt bókaðri færslu? Svarið ætti að vera nei, með skráðri leiðréttingarleið.
Hafnar læst tímabil raunverulega bókun? Prófaðu það í sandkassa. Nordlet skilar 409 fyrir færslu sem dagssett er innan lokaðs tímabils.
Hvernig er peningum komið á framfæri? Tugabrotastrengir eða heiltölur í undireiningum. Aldrei fleytitölur.
Hvað er í endurskoðunarskránni (audit record)? Aðili, aðgerð, eining og breytingin sjálf, þannig að hægt sé að gera fyrirspurnir í stað þess að það sé grafið í annálaskrám (log files).
Hver takmörkun á hraða er (rate limits)? Nordlet leyfir 300 beiðnir á mínútu á hvern API-lykil og gefur upp eftirstandandi fjármagn í svörum hausanna. Hver sem talan er, vertu meðvitaður um hana áður en þú hönnun samstillinguna.
Hvernig sækir þú gögnin þín út? Skýrslur, skjöl og færslubækur á sniðum sem þú getur afhent endurskoðanda.

Hvert einasta atriði þarna má prófa á einum síðdegis gegn sandkassafyrirtæki. Eiginleikalistar söluaðila eru ekki sönnunargögn; endurtekningarhæft próf er það.

FAQ

Er bókhaldsvefþjónusta það sama og bókhaldshugbúnaður?

Hún er bókhaldshugbúnaður þar sem viðmóti hefur verið breytt. Hefðbundinn bókhaldshugbúnaður setur manneskju fyrir framan höfuðbókina; bókhaldsvefþjónusta setur kóðann þinn þar. Undirliggjandi skyldur, tvíþætt skipulag og skýrslur eru þær sömu.

Þarf ég enn endurskoðanda ef ég nota svona þjónustu?

Já. Vefþjónusta sjálfvæðir skráningu, útreikning og skýrslugjöf. Hún tekur ekki ákvarðanir um flokkun, afskriftir eða hvernig meðhöndla eigi tiltekinn samning, og í flestum löndum undirritar hún ekki eða skilar lögboðnum ársreikningum þínum.

Get ég notað bókhaldsvefþjónustu án þess að skilja tvíþætt bókhald?

Að hluta til. Góð vefþjónusta býr til færslubækurnar fyrir þig út frá viðskiptaskjali eins og reikningi. Þú þftir samt að skilja hvað reikningarnir þýða þegar þú lest skýrslu eða útskýrir stöðu fyrir endurskoðanda.

Hver er munurinn á bókhaldsvefþjónustu og höfuðbókarvefþjónustu (ledger API)?

Höfuðbókarvefþjónusta skráir jafnaðar færslur milli reikninga. Bókhaldsvefþjónusta gerir það og bætir lagalegu laginu ofan á: skjöl með lögboðinni tölusetningu, virðisaukaskattsmeðferð, skattaskrár, varanlegan rekstrarfjármuni, lokun tímabils og skýrslurnar sem umjörðin krefst. Hver einasta bókhaldsvefþjónusta felur í sér höfuðbók; ekki hver höfuðbók er bókhaldskerfi.

Hversu langur tími tekur að samþætta hana?

Fyrir fyrsta virka flæðið - stofna viðskiptavin, gefa út reikning, taka við greiðslu, sjá færslubókina - skaltu gera ráð fyrir dögum frekar en vikum með slóðabundnu SDK og sandkassa. Framleiðslusamþætting sem nær yfir endurgreiðslur, leiðréttingar, fjölmiðla (multi-currency), jöfnun og lokun tímabils er stærra verkefni og heiðarlega matið fer eftir því hversu margar af þeim tilfellum sem varan þín skapar í raun.