Cad é API Leabhair Mhór Iontrála Dúbailte do Mhargaí?
Taifeadann API leabhair mhór iontrála dúbailte gluaiseacht airgid i margaí mar iontrálacha irise cothromaithe do-athraithe, ionas go mbeidh a fhios agat i gcónaí cé atá dlite de cad agus cén fáth.
Is féidir le margadh breathnú slán i dtábla na norders agus a bheith mícheart go fóill faoina chuid airgid. Deir an t-ordú "íoctha". Léiríonn deais an díoltóra iarmhéid. Ach ní dhearbhaíonn aon rud sa tábla sin cé mhéad airgid atá ag an gardán, cé mhéad atá dlite do gach díoltóir, cén céatadán den íocaíocht atá ina ioncam coimisiúin, nó cé mhéad CBL atá le híoc anois. Tá API leabhair mhór iontrála dúbailte ann chun na hiarmhairtí airgeadais sin a thaifeadadh i gceart, idirbheart cothromaithe amháin ag an am.
Go simplí: is córas cuntasaíochta ríomhchláraithe é API leabhair mhór iontrála dúbailte. Seolann d'fheidhmchlár imeacht airgeadais chuige, amhail íocaíocht urghafa nó íocaíocht amach ceadaithe, agus scríobhann an leabhar mór an t-imeacht sin mar irisleabhar le doicéid agus creidmheasanna comhionanna thar chuntais ainmnithe. Ní bhogann sé airgead. Taifeadann sé an fhírinne faoi airgead a bhog in áit eile.
Ciallaíonn "leabhar mór iontrála dúbailte" anseo
Is é an leabhar mór taifead ar athruithe ar chuntais, ní tábla ina bhfuil an t-iarmhéid is déanaí. Tá trí smaoineamh nasctha ag baint le leabhar mór oibre:
- Cuntas: seasamh airgeadais ainmnithe, amhail infhaighte próiseálaí íocaíochta, iníoctha díoltóra, ioncam coimisiúin, nó CBL iníoctha.
- Idirbheart (irisleabhar): imeacht airgeadais adamhach amháin ina bhfuil línte iolracha cothromaithe.
- Iontráil (postáil): líne dhoicéid nó chreidmheas aonair laistigh den idirbheart sin.
Tá an t-athraitheach a choinníonn gach dearadh le chéile simplí: tá iomlán na ndoicéid cothrom le hiomlán na gcreidmheasanna, do gach idirbheart agus gach airgeadra. Diúltaíonn APIanna leabhair mhór de ghnáth do scríbhinn neamhchothromaithe sula sroicheann sí an stóráil. Sainmhíníonn doiciméadú Modern Treasury idirbheart leabhair mhór mar rud a bhaineann le dhá chuntas nó níos mó le doicéad amháin ar a laghad agus creidmheas amháin de iomláin chomhionanna, agus caitheann sé le hidirbheart postáilte mar rud do-athraithe.
Ní chiallaíonn iontráil dúbailte go díreach dhá shraith. Is minic a bhíonn doicéad amháin agus creidmheasanna ilchasta ag teastáil ó dhíolachán margaidh singil. Sin é an chuid a léann daoine go mícheart is minic.
Cén fáth a dteastaíonn leabhar mór ó mhargaí, seachas tábla íocaíochtaí amháin
Coinníonn margadh roinnt caidreamh airgeadais ag an am céanna. Íocann ceannaitheoir. Socraíonn próiseálaí. Féadfaidh an t-ardán na cistí a rialú go sealadach. Tuilleann an díoltóir cuid díobh. Coinníonn an t-ardán coimisiún. Éiríonn cáin iníoctha. Féadfar cúlchiste a choinneáil siar. Níos déanaí, bogann íocaíocht amach airgead, agus déanann aisíocaíochtaí nó muirir aisíoca a chuid de a aisiompú.
Is féidir le tábla payments stádas tráchtála ordaithe a insint duit. Ní féidir leis a insint duit go hiontaofa:
- cé mhéad infhaighte próiseálaí nó airgead tirim atá ann
- cé mhéad atá dlite do gach díoltóir
- cén méid den ioncam a bhaineann leis an ardán
- cé mhéad CBL atá iníoctha, agus i gcén tír
- cad atá curtha ar leataobh i gcoinne aisíocaíochtaí nó díospóidí
- an laghdaigh íocaíocht amach an dliteanas díoltóra ceart
- an mtireann socruithe próiseálaí leis a raibh súil ag an ardán leo
Tarraingíonn treoir Nordlet chuig APIanna leabhair mhór iontrála dúbailte do chuntasaíocht mhargaidh an líne go soiléir: déanann táblaí feidhmchláir cur síos ar stát an táirge, agus taifeadann an leabhar mór iarmhairtí airgeadais an stáit sin. Déanann sé pointe freisin ar fiú é a athrá, gur ionchuir le haghaidh athmhuintearais iad tuairiscí próiseálaí íocaíochta, ní leabhair iomlána iontrála dúbailte.
Díolachán margaidh oibrithe
Cuir i gcás go n-íocann ceannaitheoir €100, go bhfuil an díoltóir i dteideal €85, agus gur €15 an coimisiún ardáin. Déan dearmad ar CBL agus ar tháillí próiseálaí ar mhaithe le soiléireacht.
| Cuntas | Doicéad | Creidmheas | Cúis |
|---|---|---|---|
| Infhaighte próiseálaí íocaíochta | €100 | Tá an próiseálaí dlite den ardán an íocaíocht urghafa | |
| Iníoctha díoltóra | €85 | Tá an t-ardán dlite den díoltóir | |
| Ioncam coimisiúin | €15 | Thuilleann an t-ardán a choimisiún | |
| Iomlán | €100 | €100 | Cothromaithe |
Is é an t-aicmiú tábhachtach anseo ná gur dliteanas é an €85 atá dlite don díoltóir, ní ioncam ardáin. Faoi chreat aibhsithe IFRS, is oibleagáid reatha é dliteanas acmhainn eacnamaíoch a aistriú. Níor cheart do mhargadh tuairisciú a dhéanamh ar lánfháltais díolacháin an díoltóra mar ioncam féin díreach toisc gur íoc an ceannaitheoir tríd. Athraíonn an chóireáil cibé an seasann tú mar ghníomhaire, príomhoide, nó soláthraí measta, ach fanann an mheicnic leabhair mhór mar a chéile.
Nuair a éiríonn an díoltóir incháilithe le haghaidh íocaíochta amach, ní aithnítear aon ioncam nua. Socraíonn tú an dliteanas:
| Cuntas | Doicéad | Creidmheas |
|---|---|---|
| Iníoctha díoltóra | €85 | |
| Banc nó imréiteach íocaíochta amach | €85 | |
| Iomlán | €85 | €85 |
Má thógann an próiseálaí táille €3 sula socróidh sé, éiríonn an ghluaiseacht airgid ina irisleabhar trí líne: €97 chuig airgead tirim bainc, €3 chuig caiteachas próiseála, €100 as infhaighte próiseálaí. Tá foinse agus ceann scríbe ag gach athrú i suíomh.
Conas a oibríonn an API, céim ar chéim
1. Aimsíonn d'fheidhmchlár imeacht gnó. Gabhtar íocaíocht, comhlíontar ordú, ceadaítear íocaíocht amach, eisítear aisíocaíocht, osclaítear muirear aisíoca, tuirlingíonn socrúchán. Is le do bhunachar sonraí stát oibriucháin fós. Taifeadann an leabhar mór an éifeacht airgeadais.
2. Seolann tú iarratas struchtúraithe. De ghnáth iompraíonn sé cineál imeachta, méid agus airgeadra, ID ordaithe nó íocaíochta, aitheantóirí ceannaitheora agus díoltóra, coimisiún, sonraí cánach, na cuntais atá i gceist, dátaí éifeachtacha agus postála, eochair neamh-idempotency, agus meiteashonraí a nascann ar ais le taifid phróiseálaí agus táirge. Léiríonn sampla API poiblí Nordlet iarratas díolacháin choincheapúil le ID díoltóra, cineál díolacháin, méid, airgeadra, agus tír agus ráta CBL.
3. Déanann an API bailíochtú. Seiceann sé go gcothromaíonn doicéid agus creidmheasanna, go bhfuil na cuntais ann agus gur féidir iad a phostáil, go dtacaítear leis an airgeadra, go n-úsáideann an méid láimhseáil beacht aonaid mhín, nach n-athúsáidtear an eochair neamh-idempotency le haghaidh toradh difriúil, go bhfuil an tréimhse oscailte, agus go bhfuil na meiteashonraí riachtanacha i láthair. Ní fhágann seiceáil a theip aon irisleabhar páirteach ina dhiaidh.
4. Postálann sé go adamhach. Scríobhann an t-idirbheart iomlán mar aonaid amháin. Níor cheart go mbeadh sé de chumas agat an doicéad a thaifeadadh agus an creidmheas comhfhreagrach ag teip. I gcás margaidh, d'fhéadfadh scartáil pháirteach iarmhéid díoltóra dealraitheach a chruthú gan aon airgead tirim comhfhreagrach, nó coimisiún leabhair gan an oibleagáid díoltóra.
5. Díorthaítear iarmhéid agus tuairiscí ón leabhar mór. Tar éis postála, is féidir leat iarmhéid cuntais, iarmhéid feithimh agus ar fáil díoltóra, iarmhéid trialach, gníomhaíocht leabhair mhóir ghinearálta, achomair CBL, agus stair ó dháta san am atá thart a léamh. Ba chóir go mbeadh sé de chumas iarmhéid an díoltóra a athfhorbairt ó phostálacha, gan muinín a bheith agat as réimse do-athraithe.
6. Cuireann webhook in iúl do do tháirge. Sroicheann imeachtaí amhail sale_invoice.paid, irisleabhar postáilte, íocaíocht amach ar fáil, nó eisceacht athmhuintearais chugat. Próiseáil iad go neamh-idempotent. Is fógra é webhook, ní cead chun an t-imeacht airgeadais a chur i bhfeidhm den dara huair. Clúdaíonn na comhcheangail API scóip, eochracha neamh-idempotency, cruthanna earráide, agus síniú webhook go mion.
Ní uimhir shingil iad iarmhéid díoltóra
Tagann trioblóid ar fhormhór na margaí trí chóireáil a dhéanamh ar iarmhéid díoltóra mar fhigiúr amháin. Ba chóir go mbeadh airgead i stáit:
| Stát | Ciall |
|---|---|
| Ar feitheamh | Féadfaidh an díoltóir bheith i dteideal, ach ní chomhlíontar coinníollacha scaoilte |
| Ar fáil | Incháilithe le haghaidh íocaíochta amach |
| Coinnithe siar | Coinnithe i gcoinne aisíocaíochtaí, tuairisceáin, nó díospóidí |
| Íoctha amach | Oibleagáid socraithe le haistriú |
| Diúltach | Sáraíonn aisíocaíochtaí, muirir aisíoca, nó táillí cistí atá ar fáil |
Léiríonn samhlacha próiseálaí seo. Ligeann sreabhadh muirear agus aistrithe ar leith Stripe d'ardán a chuntas féin a mhuirearú, ansin cúnaint a aistriú chuig cuntais nasctha, le táillí, aisíocaíochtaí, agus muirir aisíoca ag tuirlingt ar iarmhéid an ardáin. Déanann samhail mhargaidh Adyen idirdhealú idir cuntais iarmhéid úsáideora, a choinníonn cistí go dtí íocaíocht amach, agus cuntas iarmhéid dliteanach a fhéadann iarmhéid diúltach ó aisíocaíochtaí nó muirir aisíoca a ionsú. Is ionchuir úsáideacha iad seo do do leabhar mór. Ní hé do mhuntair cuntasaíochta iomlán iad.
Tarlaíonn íocaíochtaí amach agus tuilleamh díoltóra ag amanna difriúla
Is féidir le díoltóir tuilleamh a fháil ar an Luan agus íocaíocht a fháil ar an Luan seo chugainn. Idir na pointí sin, comhlíontar ordú, coinnítear cúlchiste, tógtear baisc íocaíochta amach, socraíonn próiseálaí í glan ó tháillí, agus sroicheann éarlais bhainc. Caithfidh leabhar mór gach céim a chosaint seachas an t-ordú a fhorscríobh le "íoctha" deiridh. Sin é a ligeann duit difríochtaí ama idir gníomhaíocht ordaithe, teideal díoltóra, socrúchán, tús íocaíochta amach, agus fáil bainc a mhíniú.
Aisíocaíochtaí agus muirir aisíoca: aisiompaigh, ná athscríobh
Is imeachtaí nua iad aisíocaíochtaí agus muirir aisíoca atá nasctha leis an íocaíocht bhunaidh. I leabhar mór do-athraithe, déanann tú ceartú le hiontráil aisiompaithe arna leanúint ag ceann ceartaithe, ionas go bhfanann an bunleagan le feiceáil le haghaidh iniúchta. Caitheann Modern Treasury le hidirbheirt phostáilte mar nithe do-athraithe agus tacaíonn sé le hochracha neamh-idempotency chun oibiachtaí dúbailte a chosc ar athsheoladh.
Laghdaíonn aisíocaíocht de ghnáth airgead tirim nó infhaighte ceannaitheora, aisiompaíonn sé iníoctha díoltóra, féadfaidh sé cuid den choimisiún a aisiompú ag brath ar bheartas, coigeartaíonn sé cáin, agus is féidir leis cúlchiste aisíocaíochta a ithe. Laghdaíonn muirear aisíoca airgead tirim nó infhaighte próiseálaí, féadfaidh sé méid atá dlite ag an díoltóir nó an t-ardán a athoscailt, taifeadann sé caiteachas díospóide agus táille phróiseálaí, agus bogann sé cistí trí chuntas cúlchiste.
Athmhuintearas: an leabhar mór a nascadh le fíor-airgead
Is féidir le leabhar mór bheith cothromaithe go hinmheánach agus a bheith mícheart go fóill faoin domhan amuigh. Déanann athmhuintearas taifid inmheánacha a chur i gcomparáid le fianaise sheachtrach: tuairiscí socruithe próiseálaí, ráitis bhainc, comhaid íocaíochta amach, taifid aisíocaíochta agus díospóide.
Seo mar a bhíonn lúb oibre:
- Iompórtáil an bhaisc socruithe nó bhainc.
- Déan gach líne a mheaitseáil le hordú, íocaíocht, aisíocaíocht, táille, íocaíocht amach, nó díospóid.
- Cuir comhionannas lánmhéide, asbhaintí, cúlchistí, agus glan i gcomparáid.
- Postáil gluaiseachtaí deimhnithe chuig an leabhar mór.
- Seol earraí nach bhfuil meaitseáil leo chuig cuntas fionraí ainmnithe.
- Déan iniúchadh ar eisceachtaí.
- Glasáil an tréimhse.
Déanann ábhar athmhuintearais Nordlet cur síos díreach air seo, ag iompórtáil baisceanna socruithe, ag meaitseáil línte muirir agus aisíocaíochta, agus ag seoladh fáltais nach bhfuil meaitseáil leo chuig fionraí seachas sonrasc a thabhairt faoi thuairim. Tábhachtach tá dhá sheiceáil agus ní ionadach ceann ar an ceann eile: iarrann bailíochtú iontrála dúbailte an gcothromaíonn gach irisleabhar, agus iarrann athmhuintearas an n-aontaíonn sé leis an phróiseálaí, an banc, agus an t-imeacht gnó.
Sonraí dearaidh a chinneann an bhfaigheann tú seo i gceart
Neamh-idempotency. Ceangail an eochair le himeacht seasta, amhail payment_captured:pi_123. Tugann athsheoladh an toradh bunaidh ar ais, ní dara irisleabhar.
Adamhacht. Postálann gach líne d'imeacht amháin le chéile nó ní phostálann aon cheann.
Do-athraitheacht agus aisiompuithe. Níl an stair phostáilte editiable trí nuashonruithe gnáthaimh. Cruthaíonn ceartúcháin iontrálacha nasctha a chosnaíonn an bunmhéid, dáta, aicmiú, cúis, agus údar.
Airgead beacht. Gan snámhphointe dénártha. Úsáid aonaid mhín iomláin nó deachúlacha cruacha, airgeadra sainráite, agus riail imrothlaithe dhéineach le haghaidh scartálacha. Scartáil €100 thar dhíoltóirí agus táillí gan ceann, agus brisfidh pingin fáin d'iarmhéid.
Dátaí éifeachtacha vs postála. Is dátaí difriúla iad nuair a íocann an ceannaitheoir, nuair a thuilleann an díoltóir, nuair a shocraíonn an banc, agus nuair a phostáil an iontráil. Déanann meascadh iad tuairisciú tréimhse agus tráthúlacht chánach neamhiontaofa.
Il-airgeadra. Ba chóir do dhoicéad agus creidmheas cothromú laistigh d'airgeadra. Teastaíonn imeacht ráta sainráite le cuntais don táille, imrothlú, agus aon ghnóthachan nó caillteanas FX le haghaidh comhšaithe. Ní dhéanann glacadh le réimse currency inneall FX de leabhar mór.
Cad nach ndéanfaidh API leabhair mhór duit
Ní dhéanfaidh sé cinneadh ar do chairt chuntas. Caithfidh tú fós a chinneadh an príomhoide nó gníomhaire tú, cathain a thuilltear coimisiún, cén páirtí a thógann táillí próiseálaí, conas a dhéanann aisíocaíochtaí difear do choimisiún, agus conas a ríomhtar agus a thuairiscítear CBL. Is é treoir Nordlet féin ná na sruthanna airgid a mapáil ar dtús, an chairt chuntas a dhréachtú, cuntasóir a fháil chun athbhreithniú a dhéanamh air, ansin sruth iomlán amháin a chur i feidhm ó ordú trí íocaíocht amach agus athmhuintearas sula scálaíonn tú.
Ní shocróidh sé ceisteanna cánach. Braitheann CBL ar shuíomh an cheannaitheora agus an díoltóra, cineál táirge, stádas clárúcháin, agus rialacha soláthraí measta; leagann treoir CBL AE amach cad a dhíorthaíonn an t-inneall agus cad a chuireann sé i gcomhartha do dhuine. Tá clúdach CBL Nordlet dírithe ar AE agus LEE, mar sin ní shíneann sé go dtí cáin díolacháin na SA nó r-shonrasc Mheiriceá Laidinigh. Agus ní shocróidh sé ambiguity oibriúcháin, cibé ar dúntar fuinneog tuairisceáin, cibé ar cheart íocaíocht amach a bhacadh, cibé an calaoiseach atá íocaíocht. Sin iad do chinntí féin. Taifeadann an leabhar mór a dtoradh airgeadais.
Cá n-oiriúnaíonn Nordlet
Is API cuntasaíochta é Nordlet atá tógtha d'ardáin agus margaí, le leabhar mór iontrála dúbailte do-athraithe, íocaíochtaí amach, láimhseáil CBL AE, críochnú REST, SDKanna typed, agus webhooks inrochtana trí dhromchla amháin. Is é an rogha idirdhealaitheach atá aige ná cuntasaíocht leabaithe laistigh de do tháirge féin seachas seic amach tríú páirtí. Ó scríobh an ailt seo tá an táirge i rochtain luath le sandbox do chomhpháirtithe dearaidh, mar sin caith leis mar shampla láidir den chatagóir agus déan measúnú ar aibíocht táirgthe, tacaíocht, agus clúdach dlíthiúil do do chás féin sula gcommitted tú.
Do dhorbróirí margaidh agus ardáin, is é an tsamhail mheabhrach úsáideach an scartáil idir gluaiseacht íocaíochta agus fírinne airgeadais. Bogann do phróiseálaí an t-airgead. Taifeadann API leabhair mhór iontrála dúbailte cé atá dlite de cad, cad a thuilleann tú, cad a thógann tú de cháin agus chúlchistí, agus an n-athmhuintearaíonn an domhan amuigh le do leabhair.
FAQ
An ionann API leabhair mhór iontrála dúbailte agus próiseálaí íocaíochta?
Ní hionann. Údarú, gabháil, socrúchán, agus uaireanta íocaíochtaí amach a dhéanann próiseálaí. Taifeadann API leabhair mhór iarmhairtí cuntasaíochta na n-imeachtaí sin. Úsáideann formhór na margaí an dá cheann, próiseálaí cosúil le Stripe nó Adyen le haghaidh gluaiseachta agus leabhar mór do na leabhair.
An féidir liom deais mo phróiseálaí a úsáid mar an leabhar mór ginearálta?
Is féidir leat iarracht a dhéanamh, agus tiurfaidh sé teip in iniúchadh i ndeireadh na dála. Taispeánann tuairisciú próiseálaí muirir, táillí, aistrithe, agus socruithe, ach de ghnáth ní léiríonn sé do lán-oibleagáidí díoltóra, dliteanais cánach, caiteachais neamh-phróiseálaí, nó coigeartuithe cuntasaíochta. Caith leis mar ionchur athmhuintearais.
An ciallaíonn leabhar mór cothromaithe go bhfuil mo leabhair ceart?
Nach bhfuil ach go gcomhlíonann d'iontrálacha an riail doicéad-chreidmheas. Is féidir le hidirbheart atá cothromaithe go foirfe a bheith postáilte fós chuig an cuntas mícheart, chuig an díoltóir mícheart, nó leis an gcóireáil chánach mícheart. Tá cothromaíocht riachtanach, ní leor é. Is é an t-athmhuintearas a ghlacann an chuid eile.
Más do-athraithe an leabhar mór, conas a cheartaím botúin?
Postálann tú iontráil aisiompaithe agus ansin ceann ceartaithe. Fanann an bunleagan le feiceáil, rud atá mar bhunús leis an scéal. Cosnaíonn do-athraitheacht an rian iniúchta, ní ghreamúcháin sé d'earráidí.
An ndéanann API cuntasaíochta comhlíontach mé go huathoibríoch?
Ní dhéanann. Cuireann sé struchtúr cuntasaíochta i bhfeidhm agus táirgeann sé taifid inúsáidte. Braitheann comhlíonadh dlíthiúil fós ar do dhlínse, ról conartha, cóireáil chánach, rialacháin íocaíochta, próisis KYC agus AML, agus oibleagáidí tuairiscithe.