Cad é API Cuntasaíochta? Treoir i nGnáth-Béarla do Dhéantúsóirí Ardán

Sainmhíniú i nGnáth-Béarla ar an API cuntasaíochta, an méid a scarann óna chéile é ó API cánach nó API íocaíochtaí, agus cad le seiceáil sula ndéanann tú comhtháthú leis.

Is comhéadan é API cuntasaíochta a ligeann do chlár amháin leabhair chuntais cláir eile a choinneáil. Seolann do bhogearraí imeacht airgeadais thar HTTP. Athraíonn an API an t-imeacht sin ina iontrálacha dialainne cothromaithe iontrála dúbailte i gcoinne a chairt chuntas, stórálann sé iad sa chaoi nach féidir iad a athrú go ciúin, cuireann sé an chóireáil chánach i bhfeidhm, agus tugann sé tuairiscí, doiciméid agus easpórtálacha ar ais duit tríd an gcomhéadan céanna.

Déanann an sainmhíniú sin formhór an obair. Is iarmhairt é gach rud eile san alt seo air sin.

An leagan abairt amháin

Glacann API cuntasaíochta le himeachtaí airgeadais ó d'fheidhmchlár, tiontaíonn sé gach ceann acu ina iontráil dialainne cothromaithe, stórálann sé go dobhriste é mar aon lena chóireáil chánach agus fianaise thacaíochta, agus nochtann sé an leabhar mór, na doiciméid agus na tuairiscí mar chríochphointí ríomhchláraithe.

Má thugann táirge API cuntasaíochta air féin ach mura dtáirgeann sé iontrálacha dialainne, is rud éigin eile é le hainm maith. Ní hionann sin is a rá go bhfuil sé sin olc go forcément. Ciallaíonn sé nach ndéanfaidh sé an jab a bhfuil tú ar tí a iarraidh air a dhéanamh.

Rud nach API cuntasaíochta é

Meascann ceithre chatagóir táirgí gaolmhara suas le hAPIanna cuntasaíochta, de ghnáth go déanach i dtionscadal.

Catagóir	Cad a dhéanann sé	Cad nach ndéanann sé
API ríofa cánach	Tugann sé an ráta ceart nó an méid cánach ceart d'idirbheart	Coinníonn sé do leabhair, nó stórálann sé an fhianaise taobh thiar den chinneadh don tréimhse choinneála
API íocaíochtaí	Bogann sé airgead idir páirtithe agus tuairiscíonn sé ar na gluaiseachtaí sin	Taifeadann sé coimisiún a tuilleadh, CBL atá dlite, nó an dliteanas i leith díoltóra idir íocaíocht agus íocaíocht amach
API aontaithe nó comhiomlánaithe	Léann agus scríobhann sé sonraí i mbogearraí cuntasaíochta reatha do chustaiméara	Gníomhaíonn sé mar chóras taifeadta; tá do leabhair sa uirlis sin a úsáideann gach custaiméir cheana féin
API tuairiscithe nó BI	Léann sé figiúirí as leabhar mór reatha agus déanann sé amharclannú orthu	Cruthaíonn sé na hiontrálacha a dhíorthaítear na figiúirí astu

Tá úsáidí fíor ag gach ceann díobh sin. Teastaíonn an API cuntasaíochta faoina mbun ag ardán a chaithfidh a bheith mar chóras taifeadta, seachas in ionad é.

Cúig rud a chaithfidh API cuntasaíochta a dhéanamh

1. Iontrálacha cothromaithe a thaifeadadh. Tiocfaidh fiachais agus creidmheasanna as gach imeacht a shuíonn go dtí an figiúr céanna. Nuair a íocann ceannaitheoir €100 ar mhargadh a thógann coimisiún €15, déanann an iontráil fiach ar chuntas imréitigh de €100, creidmheas ar dhliteanas díoltóra de €85, agus creidmheas ar ioncam coimisiúin de €15. Ní searmanas coimeád leabhar é seo. Is seiceáil struchtúrach é a ghlacann le haicmí iomlána fabhtanna comhtháthaithe sula sroicheann siad tuairisc.

2. Stair a choinneáil. Ní chuirtear eagar ar iontráil phostáilte. Ceartaítear botún trí fhritháireamh móide iontráil cheartaithe, an dá cheann nasctha leis an mbunleagan. Glasáiltear míonna a dúnta ionas nach féidir rud nua a dhátú iontu.

3. Cáin a réiteach. I gcás trádála san Aontas Eorpach, ciallaíonn sin áit an tsoláthair, an mhuirear droim ar ais, uimhreacha aitheantais CBL seiceáilte i gcoinne an chláir oifigiúil, agus an fhianaise a thug an cinneadh údar, iad go léir stóráilte taobh le taobh leis an idirbheart seachas scriosta tar éis an ríofa.

4. Athmhuintearas a dhéanamh i gcoinne airgid sheachtraigh. Is buille faoi thuairim iad leabhair nach gcasann le ráiteas bainc riamh. Caithfidh an API ráitis nó socruithe soláthraí a ionghabháil agus iad a mheaitseáil le a raibh taifeadta.

5. Easpórtáil. Tuairiscí, doiciméid agus comhaid iniúchta, i bhformáidí a ghlacann cuntasóir daonna agus údarás cánach.

Fágfaidh táirge a dhéanann an chéad triúr ach nach ndéanann an dá chuid deireanach duine fós ag déanamh obair scarbhileoige gach mí.

Mar a bhreathnaíonn glao i ndáiríre

Tá na meicnicí níos simplí ná an chuntasaíocht. In API Nordlet is POST de stíl RPC é gach oibríocht le cruth a inbhinne:

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

Cruthaíonn tú sonrasc díolacháin, ansin eagraíonn tú é. Is é an t-eagrú an nóiméad a tharlaíonn an chuntasaíocht: faigheann an doiciméad a uimhir gan spás, postálann an iontráil dialainne cothromaithe, agus taifeadtar na línte CBL léi. Ní chuireann d'ardán fiachais agus creidmheasanna le chéile le lá so-ghabhálach riamh.

Is mó an tábhacht a bhíonn le trí mionsonra sa sliocht sin ná ainm an chríochphointe:

An raon feidhme ar an eochair. Tá ceadanna mar sales:write ag eochair, ionas nach bhfaigheann comhtháthú ach an rochtain atá de dhíth air.
An eochair indíomachtachta. Déan an t-iarratas céanna a athsheoladh leis an bpálasta céanna agus faigheann tú an freagra stóráilte ar ais seachas an dara sonrasc. Seol an eochair chéanna le pálasta eile agus diúltaítear don iarratas le idempotency_key_reuse seachas é a ghlacadh go ciúin.
Airgead mar shreanga. Is sreanga deicheacha iad méideanna, ní huimhreacha pointe snámh, toisc go gcailltear centanna i sreanga a thagann chun solais ag deireadh na bliana.

Cá bhfuil sé ina shuí i d'ardiltreoir

Fanann d'fheidhmchlár mar an front end agus mar fhoinse na n-imeachtaí gnó. Is é an API cuntasaíochta an córas taifeadta airgeadais taobh thiar de. Is gnách gurb é an sreabhadh ná:

Tarlaíonn rud éigin i do tháirge: ordú, aisíocaíocht, íocaíocht amach, athnuachan síntiúis.
Glacann do chúlchomhéadan leis an API cuntasaíochta leis an imeacht agus eochair indíomachtachta.
Postálann an API an iontráil dialainne, cuireann sé CBL i bhfeidhm, agus tugann sé aitheantais ar ais a stórálann tú i gcoinne do chuid taifead féin.
Insíonn ríomhphost nó webhook mar sale_invoice.paid do chóras nuair a athraíonn an stát, ionas go n-imoibríonn tú d'imeachtaí seachas iad a pholláil.
Tagann idirbhearta bainc trí bheatha bhainc nó iompórtáil ráitis agus déantar iad a mheaitseáil i gcoinne na ndoiciméad taifeadta.
Ag deireadh na tréimhse, gintear tuairiscí agus cláir cánach as na sonraí céanna, agus glasáiltear an mhí a dúnta.

Ní éilíonn aon rud sa liosta sin go n-osclódh duine feidhmchlár cuntasaíochta. Sin pointe na catagóire.

Mar a chuirtear i gcomparáid leis na roghanna eile

Cur Chuige	Iarracht chun tús a chur leis	Seasamh iniúchta	Scálaíonn sé le toimse idirbhirt
Scarbhileoga agus taifeadadh láimhe	Íseal	Lag; tá an stair inathraithe	Níl
Aip chuntasaíochta móide easpórtálacha CSV	Íseal	Braitheann sé go hiomlán ar dhisciplín	Go holc; déanann duine éigin comhaid a iompórtáil
API comhiomlánaithe i leabhair gach custaiméara féin	Meánach	Faigheann sé oidhreacht ar cibé rud a dhéanann uirlis an chustaiméara	Sea, ach ní leis tú an taifead riamh
API cuntasaíochta leabaithe	Meánach	Láidir má tá an leabhar mór dobhriste agus má ghlasálann tréimhsí	Sea
Do leabhar mór féin a thógáil	Is airde	Láidir amháin má thógann tú na rialuithe freisin	Sea, agus coinníonn tú é go deo

Is rogha dlisteanach do roinnt foirne é do chuid féin a thógáil. Tá sé clúdaithe níos mionsonraithe in ár dtreoir tógála i gcoinne ceannaigh do mhargaí.

Cad le seiceáil sula ndéanann tú comhtháthú leis

An ndíorthaítear an t-imreoir nó an stóráiltear é? Fiafraigh an cothromaíocht díoltóra é ceist ar línte dialainne nó colún a nuashonraíonn duine éigin. Ní mhaireann ach ceann amháin díobh sin iniúchadh.
Cad a tharlaíonn ar athsheoladh? Seol an t-iarratas céanna faoi dhó agus comhair na hiontrálacha.
An féidir leat eagar a chur ar iontráil phostáilte? Ba chóir gurb é an freagra ná níl, le cosán ceartaithe doiciméadaithe.
An diúltaíonn tréimhse ghlasáilte do phostáil i ndáiríre? Déan iarracht é i sandbox. Tugann Nordlet 409 ar ais le haghaidh postáil a dháitítear laistigh de thréimhse ghlasáilte.
Conas a léirítear airgead? Sreanga deicheacha nó aonad mion slánuimhreacha. Ná bíodh snámh ann riamh.
Cad atá sa taifead iniúchta? Aisteoir, gníomh, eintiteas, agus an t-athrú féin, inchoiscthe seachas curtha i bhfolach i gcomhaid logála.
Cad iad na teorainneacha ráta? Ligeann Nordlet 300 iarratas in aghaidh an nóiméid in aghaidh an eochair API agus tuairiscíonn sé do bhuiséad fágach i gceanntásca freagartha. Cibé uimhir é, bíodh a fhios agat é sula ndéanann tú do shioncronú a dhearadh.
Conas a gheobhaidh tú do chuid sonraí amach? Tuairiscí, doiciméid agus dialanna, i bhformáidí a bhféadfá a thabhairt do chuntasóir.

Tá gach ceann díobh sin tástálach i tráthnóna i gcoinne cuideachta sandbox. Ní fhianaise iad liostaí gnéithe díoltóra; is fianaise í tástáil in-athdhéanta.

FAQ

An ionann API cuntasaíochta agus bogearraí cuntasaíochta?

Is bogearraí cuntasaíochta iad leis an gcomhéadan a bhogadh. Cuireann bogearraí cuntasaíochta traidisiúnta duine os comhair an leabhair mhóir; cuireann API cuntasaíochta do chód ann. Tá na hoibleagáidí faoi iamh, an struchtúr iontrála dúbailte, agus na tuairiscí mar an céanna.

An dteastaíonn cuntasóir uaim fós má úsáidim ceann?

Sea. Déanann API uathoibriú ar thaifeadadh, ríomh agus tuairisciú. Ní dhéanann sé glaonna breithiúnais faoi aicmiú, forálacha, vagy conas ba chóir conradh sonrach a chóireáil, agus i bhformáidí tíortha ní shíníonn sé ná ní chomhdhaíonn sé do chuntais reachtúla.

An féidir liom API cuntasaíochta a úsáid gan iontráil dúbailte a thuiscint?

I bpáirt. Tógann API maith na hiontrálacha dialainne duit ó dhoiciméad gnó mar shonrasc. Caithfidh tú a thuiscint fós cad a chiallaíonn na cuntais nuair a léann tú tuairisc nó a mhíníonn tú cothromaíocht d'iniúchóir.

Cad é an difríocht idir API cuntasaíochta agus API leabhair mhóir?

Taifeadann API leabhair mhóir gluaiseachtaí cothromaithe idir cuntais. Déanann API cuntasaíochta sin agus cuireann sé an ciseal reachtúil ar a bharr: doiciméid le huimhriú dlíthiúil, cóireáil CBL, cláir cánach, sócmhainní seasta, a dúnta tréimhse, agus na tuairiscí a bhfuil súil ag dlínse leo. Tá leabhar mór i gcach API cuntasaíochta; ní gach leabhar mór is córas cuntasaíochta é.

Cé chomh fada a thógann comhtháthú leis?

Le haghaidh céad sreabhadh oibre - custaiméir a chruthú, sonrasc a eagrú, íocaíocht a fháil, an iontráil dialainne a fheiceáil - pleanáil laethanta seachas seachtainí le SDK clóscríofa agus sandbox. Is píosa oibre níos mó é comhtháthú táirgthe a chlúdaíonn aisíocaíochtaí, ceartúcháin, il-airgeadraí, athmhuintearas, agus a dúnta tréimhse, agus braitheann an meastachán macánta ar an méid de na cásanna sin a ghineann do tháirge i ndáiríre.