Nordlet

← Blag

APIannaigh Ledgerion Dhá-Iontrála le haghaidh Cuntasaíochta Margaidh

Treoir theicniúil ar an gcaoi a n-oibríonn APIanna ledgerion dhá-iontrála do-athraithe, cén fáth a dteastaíonn siad ó mhargaí, agus cad atá le lorg nuair a bhíonn cuntasaíocht á leabú i d'ardán.

Nordlet Team · · 12 min léite

Faigheann formhór na margaí amach go bhfuil fadhb cuntasaíochta acu ar an gcaoi chéanna: tagann duine airgeadais ar bord, osclaíonn sé an scarbhileog íocaíochtaí, agus fiafraíonn sé cé atá ag taifeadadh an dliteanais i gcoinne na ndíoltóirí idir an nóiméad a íocann an ceannaitheoir agus an nóiméad a fhágann na cistí cuntas an ardáin. Tugann an foireann innealtóireachta le fios tábla transactions. Tugann an duine airgeadais le fios nach sraith leabhar é tábla imeachtaí. Is í an bhearna sin, idir sonraí imeachtaí agus fircuntasaíocht, a bhfuil API ledger dhá-iontrála deartha chun a dhúnadh.

Is ceist theicniúil í seo a bhfuil fiacla rialála aici. Coinníonn margaí airgead daoine eile, ríomhann siad CBL thar dhlínsí, agus eisíonn siad sonrasc thar ceann díoltóirí. Oibríonn sé sin a dhéanamh le tábla idirbhirt baile go dtí go n-iarrann iniúchóir, údarás cánach, nó ceannaitheoir tromchúiseach cruthúnas.

Cad atá i gceist le API ledger dhá-iontrála i ndáiríre

Inneall cuntasaíochta ríomhchláraithe atá nochtaithe thar HTTP is ea API ledger dhá-iontrála. Scríobhtar gach imeacht airgeadais a taifeadann d'ardán mar iontráil irise chothromaithe: debit amháin ar a laghad agus creidiúint amháin ar a laghad, comhionann i lánmhéid, curtha suas chuig cuntais ainmnithe i gcairt chuntas. Forchuireann an API an chothromaíocht sin tráth an scríofa agus stórálann sé iontrálacha sa chaoi nach féidir iad a chur in eagar go ciúin níos déanaí.

Is é an chuid den "dhá-iontráil" an riail cuntasaíochta ceithre chéad bliain d'aois go gcuireann gach idirbheart isteach ar dhá chuntas ar a laghad. Ciallaíonn an chuid "API" gurb é do tháirge, seachas coimeádaí leabhar daonna, an té a chuireann an glaoch. Ciallaíonn an chuid "do-athraithe" go dtarlaíonn ceartúcháin trí iontrálacha droim ar ais, seachas trí stair a chur in eagar. Le chéile, is iad na trí thréith seo a fhágann go bhfuil na leabhair a eascraíonn as réidh le haghaidh iniúchta seachas a bheith néata amháin.

Sainmhíniú oibre úsáideach:

Glacann API ledger dhá-iontrála le himeachtaí airgeadais ó d'fheidhmchlár, déanann sé gach ceann acu a thiontú ina iontráil irise chothromaithe i gcoinne cairt chuntas shainithe, stórálann sé na hiontrálacha sin ar bhealach do-athraithe, agus nochtann sé an ledger a eascraíonn as, an t-iarmhéid trialach, agus na tuarascálacha airgeadais trí chríochnúcháin inháithnithe.

Tá Nordlet tógadaithe timpeall díreach ar an smaoineamh seo: fíorleabhair mar API, agus an ledger, loighic CBL, sonrascadh, agus réiteach uile ar fáil ón tsraith chéanna críochnúchán a labhraíonn do tháirge cheana féin.

Cén fáth a dteastaíonn sé seo ó mhargaí go sonrach

Is minic a éiríonn le SaaS d'éadan aonair sioncronú le huirlis chuntasaíochta ghinearálta uair sa lá. Ní féidir le margaí é sin a dhéanamh, ar thrí chúis.

Ar an gcéad dul síos, suíonn siad i lár an airgid. Íocann ceannaitheoir an t-ardán, coinníonn an t-ardán cistí, ansin íocann sé díoltóirí lúide táillí. Is imeacht cuntasaíochta ar leith gach ceann de na gluaiseachtaí sin a théann i bhfeidhm ar chuntais éagsúla: airgead tirim, iníoctha díoltóra, ioncam ardáin, CBL iníoctha, cúlchistí aisíocaíochta. Ní ghlacann tábla payments le colún status leis sin.

Ar an dara dul síos, oibríonn siad thar dhlínsí cánach. Caithfidh margadh san Aontas Eorpach a bhfuil díoltóirí sa Liotuáin, sa Ghearmáin, agus sa Pholainn aige, agus ceannaitheoirí ar fud an bhloc, an chóireáil CBL cheart a chur i bhfeidhm in aghaidh an idirbhirt, uimhreacha CBL díoltóra a bhailíochtú i gcoinne VIES, agus comhdúcháin a tháirgeadh a shásaíonn gach údarás áitiúil. Is é an áit a mbriseann formhór na margaí go ciúin ná é seo a fháil i gceart i gcód feidhmchláir, ansin é a réiteach i gcoinne córais chuntasaíochta ar leith.

Ar an tríú dul síos, tá an méid mícheart do choimeád leabhar láimhe. Tá ardán a dhéanann deich míle ordú sa mhí ag táirgeadh deich míle iontráil irise. Caithfidh sé sin a bheith uathoibrithe ó cheann go ceann, mura rud é go n-éiríonn leis an bhfoireann airgeadais a bheith ina bhac ar fhás.

Conas a oibríonn an API, céim ar chéim

Tá an mheicnic níos lú coigríche ná mar a fhuaimníonn sé. Seo mar a bhreathnaíonn sreabhadh tipiciúil d'ordú margaidh.

1. Scaoileann d'ardán imeacht airgeadais. Críochníonn ceannaitheoir an tseiceáil amach. Glaonn do chúlchomhéadan ar an API ledger le rud éigin mar seo: ID ordaithe, ceannaitheoir, díoltóir, lánmhéid, ráta CBL, coimisiún an ardáin, airgeadra, agus eochair neamh-athraitheachta (idempotency key).

2. Tógann an ledger iontráil irise. Aistríonn an API an timeacht sin go debits agus creidiúintí. I gcás díolachán margaidh simplí, d'fhéadfadh sé sin a ciallachadh cuntas airgead tirim idirthurais a chur ar fáil mar debit, cuntas iníoctha díoltóra a chur ar fáil mar chreidiúint don mhéid glan, cuntas ioncaim ardáin a chur ar fáil mar chreidiúint don choimisiún, agus cuntas CBL iníoctha a chur ar fáil mar chreidiúint don chuid cánach. Gach rud cothromaithe. Gach rud postáilte go adamhach.

3. Scríobhtar an iontráil ar bhealach do-athraithe. Nuair a bheidh sé postáilte, tá aitheantóir agus stampa ama ag an iontráil agus ní féidir é a chur in eagar. Má tá rud éigin mícheart, postálann tú iontráil droim ar ais agus ceann ceartaithe. Is é an lorg iniúchta an pointe.

4. Nuashonraíonn tuarascálacha in aghaidh an tsrutha i bhfíor-am. Léiríonn an t-iarmhéid trialach, iarmhéid iníoctha díoltóra, achomair CBL, agus P&L an iontráil nua láithreach. Níl aon phost oíche ann, níl aon onnmhairiú ann, níl aon fhuinneog réitigh ann ina bhfuil na huimhreacha "ag socrú".

5. Cuireann webhooks in iúl do do chórais. Spreagann imeachtaí mar sale_invoice.paid nó bank_transaction.matched chuig do chríochphointí, ionas gur féidir le do tháirge freagairt gan vótáil (polling). Mar thoradh air sin, i dteannta le eochracha neamh-athraitheachta, ciallaíonn sé seo go bhfuil athiatach sábháilte agus nach dtig dúblaigh isteach nuair a bhíonn an líonra ag cur corraigh.

An pointe dearadh tábhachtach: is é an ledger an fhoinse fhírinne maidir le cad a tharla go haireach. Is é do bhunachar sonraí feidhmchláir foinse fhírinne stáit an táirge. Réitíonn an dá chóras toisc go scríobhtar an ledger ó imeachtaí feidhmchláir, seachas an bealach eile timpeall.

Is sa chairt chuntas a tharlaíonn an obair dhearaidh

Tá formhór an iarracht intleachtúil maidir le ledger a bhunú do mhargadh sa chairt chuntas. Seo liosta na mbuicéad ainmnithe a dtiteann debits agus creidiúintí iontu: cuntais airgead tirim in aghaidh an bhainc, cuntais iníoctha díoltóra (go minic ceann in aghaidh an díoltóra nó comhiomlán amháin le fochomhaireachtaí), ioncam ardáin de réir catagóire, CBL iníoctha in aghaidh na tíre, cúlchistí aisíocaíochta, cúlchistí muirir mhuirir, agus mar sin de.

Cúpla patrún a athfhaigheann thar mhargaí:

  • Is dliteanas iad cistí díoltóra, ní ioncam. Is iníoctha é an t-airgead a choinníonn tú thar ceann díoltóirí. Is é an clasaicmearbhall a thaispeánann suas i ndícheall cuí é a chóireáil mar ioncam agus an íocaíocht a "chostasú" níos déanaí.
  • Is dliteanas ar leith in aghaidh na tíre é CBL. Má oibríonn tú thar dhlínsí san Aontas Eorpach, teastaíonn cuntais CBL iníoctha ar leith uait in aghaidh na tíre ionas go mapálann comhdúcháin go glan.
  • Caithfear táillí a mhúnlú tráth a thuilltear iad, ní nuair a íocadh amach iad. Ní rogha é cuntasaíocht tíchcniúil anseo.
  • Teastaíonn a gcuntais féin ó aisíocaíochtaí, muirir mhuirir, agus díospóidí ionas go léiríonn an P&L an fhírinne seachas corraigh díolacháin dhearfacha agus dhiúltacha.

Ligeann API ledger maith duit an struchtúr seo a shainiú uair amháin agus ansin postáil a dhéanamh air le muinín, seachas an loighic chuntasaíochta a athchruthú laistigh de do chód seiceála amach.

Do-athraitheacht, glasáil tréimhse, agus cén fáth a mbíonn suim ag iniúchóirí

Fuaimeann do-athraitheacht cosúil le mionsonra bunachair sonraí. Is é an difríocht i ndáiríre é idir leabhair a sínfidh iniúchóir as agus leabhair nach sínfidh siad as.

Más féidir le margadh iontrálacha na ráithe seo caite a chur in eagar go ciúin, akkor, i gcéill chuntasaíochta, ní eol uimhreacha na ráithe seo caite. Forchuireann ledger do-athraithe an riail gur stair an stair. Tá ceartúcháin le feiceáil mar cheartúcháin. Síneann glasáil tréimhse é seo: a luaithe a bhíonn mí dúnta, ní féidir le haon iontrálacha ná eagar nua teacht sa tréimhse sin gan ghníomh athoscachaidh sainráite, a bhfuil sé féin logáilte.

I gcás ardáin a thógfaidh cistí sa deireadh thiar, a dhíolfaidh, nó a a aghaidhfaidh iniúchadh cánach, ní "rud maith le bheith agat" é seo. Is é an rud a fhágann go bhfuil na leabhair inchosanta. Tá ledger Nordlet deartha timpeall air seo go réamhshocraithe, leis an struchtúr dhá-iontrála do-athraithe agus glasáil tréimhse tógtha isteach seachas a bheith ceangailte air.

CBL san Aontas Eorpach: an chuid a itheann am innealtóireachta

Is ann a sháraíonn formhór na dtionscadal cuntasaíochta margaidh nuair a thagann sé go CBL. Níl sna rialacha ach "faoin gcéatadán a chur i bhfeidhm". Braitheann siad ar cá bhfuil an ceannaitheoir, cá bhfuil an díoltóir, cad atá á dhíol, cé acu atá nó nach bhfuil an díoltóir cláraithe le CBL, cé acu an soláthraí measúnaithe é an margadh faoi rialacha ríomhthrá indicada 2021, agus cén réimír tuairiscithe a bhaineann le háitiúil.

Láimhseáil API ledger siriúil don Aontas Eorpach ar a laghad:

  • Bailíochtú VIES d'uimhreacha CBL díoltóra agus ceannaitheora, go hidéalach le torthaí i dtaisce agus stampáilte ar an idirbheart
  • Loighic ráta CBL in aghaidh na tíre lena n-áirítear rátaí laghdaithe agus díolúintí
  • Ginreáil cláir i.SAF do chomhdúcháin na Liotuáine, agus aschuir struchtúraithe chomhionanna i gcás ina n-éilíonn Ballstáit eile iad
  • Ríomhshonrascadh Peppol BIS 3.0 do dhlínsí atá ag aistriú go ríomhshonrascadh éigeantach
  • Láimhseáil OSS/IOSS do díolacháin B2C trasteorann

Is obair luach foireann innealtóireachta iomlán é seo a dhéanamh i gcód feidhmchláir, in aghaidh na tíre, nach gcríochnaíonn riamh toisc go n-athraíonn na rialacha i gcónaí. Is é an glao pragmatach é é a bhrú isteach sa chiseal ledger.

Is san athréiteach a thaispeánann na coigiltis ama

A luaithe gurb é an ledger foinse na fírinne, stopann réiteach bainc ó bheith ina oráistéar míosúil. Tagann ráitis bhainc isteach, tá a fhios ag an ledger cheana féin cad ba cheart a bheith ann, agus tá an meaitseáil go mór uathoibríoch.

Ní "nialas obair láimhe" leagan réadúil seo. Is é "go dtagann na heisceachtaí chun solais iad féin". Is é an méid a sholáthraíonn API réitigh atá deartha go maith ná sreabhadh réitigh aon-chliceála do nócha faoin gcéad de na hidirbheirt a mheaitseálann go glan, chomh maith le ciú de dheich faoin gcéad a dteastaíonn cinneadh daonna uathu. Láimhseáil meaitseála íocaíochta cliste íocaíochtaí páirteacha, ró-íocaíochtaí, agus íocaíochtaí a chlúdaíonn il-sonrasc gan duine ag scríobh rialacha do gach cás.

Dúnann onnmhairiú SEPA (formáid pain.001) do íocaíochtaí soláthraí agus díoltóra an lúb ar an taobh amach. Ceadaíonn tú íocaíochtaí i do tháirge, ginríonn an ledger comhad SEPA, déanann do bhanc é a phróiseáil, agus déantar an ghluaisne a eascraíonn as a athréiteach ar ais go huathoibríoch.

Tógáil vs ceannach vs leabú

Is minic a bhíonn trí chosán á meas ag foirne margaidh. Seo mar a dhéanann siad comparáid ar na haiseanna a bhfuil tábhacht leo.

Cur Chuige Am chun táirgthe Ullmhacht iniúchta Láimhseáil CBL an AE Oiriúnach taobh istigh de do tháirge
Tóg do ledger féin 12 go 24+ mí Braitheann sé go hiomlán ar d'fhoireann Tógann tú é, in aghaidh na tíre Sea
Sioncronú le Xero/QuickBooks Seachtainí Maith don taobh cuntasaíochta, lag do shreabha sonracha margaidh Páirteach, breiseáin ag teastáil Níl, cónaíonn sé i uirlis ar leith
Leabú API ledger (m.sh., Nordlet) Seachtainí Tógtha isteach trí ledger do-athraithe agus glasáil tréimhse Tógtha isteach don AE, lena n-áirítear VIES agus i.SAF Sea, trí API agus SDKs

Is féidir le do ledger féin a thógáil a bheith inchosanta más í an chuntasaíocht do tháirge. Don chuid eile, is annamh a oibríonn an matamaitic. Oibríonn sioncronú le huirlis chuntasaíochta thraidisiúnta do ghnólachtaí aon-eintitis ach tagann brú air faoi shreabha margaidh: íocaíochtaí scoilte, fochomhaireachtaí díoltóra, CBL in aghaidh na tíre, agus cásanna ardáin-mar-sholáthraí-measúnaithe nach mapálann go glan le huirlisí atá deartha do leabhair aon chuideachta amháin.

Is ar API-first ledger atá formhór na n-ardán nua-aimseartha ag teacht le chéile. Cónaíonn na leabhair taobh istigh de thaithí do tháirge, feiceann díoltóirí a gcuid airgeadais féin i do UI, agus déantar an t-ualach trom comhlíonta a láimhseáil ag an gciseal bonneagair.

Cad atá le lorg nuair a dhéantar measúnú ar API ledger

Seicliosta gearr is fiú a choinneáil ar oscailt le linn glaonna díoltóra:

  • Stóráil dhá-iontrála do-athraithe le ceartúcháin iontrála droim ar ais, seachas sraitheanna in-eagraithe
  • Glasáil tréimhse le gníomhartha athoscachaidh logáilte
  • Eochracha neamh-athraitheachta ar gach críochphointe scríofa
  • Webhooks do na himeachtaí a dteastaíonn ó do tháirge freagairt dóibh, seachas API vótála amháin
  • SDKanna clóscríofa sna teangacha a úsáideann d'fhoireann go hiarbhír
  • Loighic CBL in aghaidh na tíre lena n-áirítear VIES, i.SAF nó a leithéidí, agus OSS/IOSS
  • Tacaíocht iol-chuideachta má oibríonn tú iol-eintitis nó má tá sé beartaithe agat é sin a dhéanamh
  • Rochtain bunaithe ar ról sách gráinneach chun forbróirí, cuntasaí, agus amharcairí a scaradh
  • Onnmhairiú tuarascála in XLSX, PDF, agus JSON, le fógraí webhook nuair a bhíonn tuarascálacha móra réidh
  • Bosca gainimh a léiríonn iompar táirgthe, seachas taispeántas stripteáilte

Mura féidir le díoltóir an chéad trí cinn a thaispeáint i nglao teicniúil, ní miste an chuid eile.

Cad a dhéanfainn ar an gcéad dul síos

Má tá margadh ag tosú an obair seo ón tús, an tsevens a shábhálann an chuid is mó de phian:

  1. Mapáil na gluaiseachtaí airgid iarbhír ar chlár bán sula scríobhann tú aon chód. Cé atá ag dlí cér, ag cad é an nóiméad, i gcá hairgeadra, le cad é an chóireáil CBL.
  2. Dréachtaigh an chairt chuntas ón léarscáil sin. Iníoctha díoltóra, ioncam ardáin, CBL iníoctha in aghaidh na tíre, cúlchistí. Faigh cuntair chun é a athbhreithniú sula dtéann sé i dtáirgeadh.
  3. Roghnaigh an ciseal ledger. Tóg, sioncronaigh, nó leabaigh. Bí honest faoi cé acu ceann is féidir le d'fhoireann a sheachadadh agus a choinneáil i ndáiríre.
  4. Cuir sreabhadh amháin i bhfeidhm ó cheann go ceann: ordú chuig sonrasc chuig íocaíocht chuig athréiteach. Cruthaigh go bhfuil sé cothromaithe. Ansin scála.
  5. Cuir glasáil tréimhse ar siúl a luaithe a dhúntar an chéad mhí go glan. Méadaíonn an smacht.

Déanann na foirne a fhaigheann seo i gceart an ledger a chóireáil mar bhonneagar lárnach, seachas iarmhach tuairiscithe. Sin an t-athrú, agus is é sin a fhágann go bhfuil an comhrá airgeadais le iniúchóir, infheistíocht, nó údarás cánach gearr seachas fada.

FAQ

An ionann API ledger dhá-iontrála agus comhtháthú cuntasaíochta?

Ní hionann. Sioncronaíonn comhtháthú sonraí ó do tháirge isteach in uirlis chuntasaíochta seachtrach, de ghnáth ar mhoill. Is é an API ledger an córas cuntasaíochta, scríofa chuige go díreach, i bhfíor-am. Tá tábhacht leis an idirdhealú toisc go gcaillíonn comhtháthuithe dílseacht ag na himill: íocaíochtaí páirteacha, iol-airgeadraí, scoilteadh margaidh. Taifeadann API ledger iad seo go bundúchasach.

Nach féidir linn tuairisciú Stripe nó Adyen a úsáid?

Insíonn tuarascálacha próiseálaí íocaíochta duit cad a ghluais tríd an bpróiseálaí. Ní leabhair dhá-iontrála iad. Níl eolas acu faoi d'iníoctha díoltóra nach bhfuil íoctha amach fós, do dhliteanais CBL thar thíortha, nó do chostais neamh-phróiseálaí íocaíochta. Is ionchur amháin iad isteach sa ledger, ní ionadach dóibh.

Cé chomh do-athraithe is atá do-athraitheacht i gcleachtas?

Ní féidir iontrálacha a chur in eagar. Is iontrálacha nua iad ceartúcháin a thagraíonn don cheann bunaidh. Is cinneadh dearaidh é seo, ní cinneadh teicneolaíochta. Forchuirfidh aon ledger inniúil é. Is é an fáth a bhfuil tábhacht leis ná gurb é "chuir muid in eagar é chun an banc a mheaitseáil" an patrún go díreach a fhágann nach bhfuil leabhair iontaofa.

Cad faoi mhargaí neamh-AE?

Tá an mheicnic dhá-iontrála uilíoch. Níl an loighic cánach. Láimhseáilfidh API ledger atá tiunithe do CBL an AE oibríochtaí troma AE go maith agus féadfaidh sé tacaíocht a thabhairt d'idirbheirt neamh-AE, ach más é do phríomh-mhargadh cáin díolacháin na S.A. nó réimeanna ríomhshonraíochta Mheiriceá Laidinigh, fíoraigh an clúdach comhlíonta sonrach sula ndéanann tú tiomantas.

Cé chomh fada a thógann an cur i bhfeidhm i ndáiríre?

I gcás margaidh a bhfuil samhail imeachtaí glan aige, is iondúil go gcuirfí API ledger i bhfeidhm go dtí an pointe a bhfuil sreabhadh amháin á rith ó cheann go ceann go dtógann sé cúpla seachtain d'innealtóireacht. Tógann imirce iomlán ó shocrú oidhreachta, lena n-áirítear sonraí stairiúla, níos faide. Is é an t-athróg beagnach i gcónaí staid na sonraí atá ann cheana, seachas an API féin.