Conas API Cuntasaíochta Scekoime (Cloud Accounting API) a Comhtháthú i nArdán SaaS

Treoir do chleachtóirí maidir le comhtháthú cuntasaíochta iltionóntach (multi-tenant) a thógáil a sheasann le OAuth, webhookanna, rialacha cánach, agus athmhuintearas gan an mórleabhar a thruailliú.

An chuid is mó de na foirne a chuireann rompu "cuntasaíocht a chur leis" dá dtáirge SaaS, tús a chur leis trí chliant HTTP a nascadh le críochphointe soláthraí agus sonrasc a chur suas. Oibríonn sé sin i dtaispeántas. Briseann sé an chéad uair a nascann custaiméir dhá eagraíocht cuntasaíochta, an chéad uair a thagann webhook faoi dhó, agus an chéad uair a rothlaíonn comhartha athnuachana (refresh token) agus go gcailltear é i lár an iarratais. Ní cliant é an leagan buan den obair seo. Is sraith chomhtháthaithe í.

Caithfidh an tsraith sin bainistíocht a dhéanamh ar nascanna tionóntacha (tenant connections), stóráil agus rothlú comharthaí, rialacha cuntasaíochta a bhaineann go sonrach le soláthraithe, mapáil taifead, sioncronú túsáideach agus incriminteach, ionghabháil webhook le hathsheolta (retries) agus dídhúbláil, teorainneacha ráta (rate limits), leaganachán, agus conair iniúchta (audit trail) gur féidir le do fhoireann tacaíochta a léamh ag 2 ar an maidin. Siúlann an t-alt seo tríd an ailtireacht sin agus na cinntí is mó tábhacht.

Múnla meabhrach úsáideach:

Táirge SaaS → seirbhís chomhtháthaithe cuntasaíochta → oiriúntóir soláthraí (nó API aontaithe) → sioncronú neamh-synchrónach (asynchronous) agus athmhuintearas

Fanann an córas cuntasaíochta mar chóras taifid do oibiachtaí mórleabhair: cuntais, cóid chánach, idirbhearta postáilte, iontrálacha irise. Coinníonn d'ardán SaaS aitheantóirí cobhsaí trasteorann córais, stát sioncronaithe, meiteashonraí mapála, agus loga iniúchta oibriúcháin.

Céard a chumhdaíonn "API cuntasaíochta scekoime" anseo i ndáiríre

De ghnáth ciallaíonn an frása API d'ardán coinneála leabhar ar an sccoth (hosted bookkeeping platform) amhail QuickBooks Online, Xero, Sage, Zoho Books, nó córas réigiúnach. Féadfaidh sé API cuntasaíochta aontaithe a chialliú freisin a normalúchán soláthraithe éagsúla taobh thiar d'aghaidh aonaid.

Is fiú bheith beacht, toisc go n-athraíonn an cur i bhfeidhm de réir aidhme. Ní hionann sonrasc a léamh le haghaidh tuairiscithe agus sonrasc a chruthú ó ghníomhaíocht SaaS, billí a phostáil, custaiméirí agus táirgí a shioncronú, iontrálacha irise a scríobh, nó fior-sioncronú dhá bhealach a rith. Cinntigh cé acu díobh seo atá á thógáil agat sula dtéann tú i dteagmháil le críochphointe.

Is fiú idirdhealú amháin eile a dhéanamh don chuid seo. Bogann API íocaíochta airgead. Tarraingíonn API bainc sonraí cuntais. Féadfaidh API sonrascaithe doiciméid a chruthú gan an mórleabhar ginearálta a nochtadh. Tá mórleabhar cuntasaíochta leabaithe difriúil arís: tá an t-inneall cuntasaíochta féin ag an gcuideachta SaaS. Is anseo atá Nordlet suite. Seachas do tháirge a nascadh le leabhair sheachtracha custaiméara, tugann Nordlet leabhair fhíora dhá-iontrála d'ardáin agus do mhargaí, mórleabhar dosháraithe atá réidh d'iniúchadh, láimhseáil CBL AE, agus íocaíochtaí laistigh dá dtáirge féin, trí dearadh API-ar-dtús le SDKanna clóscríofa agus webhookanna. Más margadh thú atá ag cinneadh cé acu córas cuntasaíochta custaiméara a chomhtháthú nó na leabhair a rith duit féin, is crosbhóthar fíor é sin, agus tiocfaimid ar ais chuige sin.

Il-tionóntacht (Multi-tenancy): déan gach nasc a scópáil faoi dhó

In ardán SaaS, nascann feidhmchlár amháin le go leor eagraíochtaí custaiméara. Caithfear gach nasc a scópáil de réir thionónta an SaaS agus aitheantóir eagraíochta an tsoláthraí araon, amhail ID tionónta Xero nó ID réimsí (realm ID) QuickBooks.

Ná déan eochair de na nascanna ar ID úsáideora OAuth amháin. Is féidir le húsáideoir amháin eagraíochtaí cuntasaíochta iolracha a údarú, agus is féidir le húsáideoirí éagsúla eagraíocht a athnascadh le himeacht ama. Má dhéanann tú botún anseo, cuirfidh tú sonrasc custaiméara amháin i leabhair chustaiméara eile sa deireadh, agus ní hé sin fabht ar féidir leat teacht chuige féin go ciúin.

An chéad chinneadh ailtireachta: cónascaire díreach, API aontaithe, nó mórleabhar leabaithe

Comhtháthaithe soláthraí díreacha

Tugann comhtháthú díreach an smacht is mó duit: gnéithe a bhaineann go sonrach le soláthraithe, réimsí saincheaptha, láimhseáil earráidí, minicíocht sioncronaithe, coinneáil sonraí, agus struchtúr costais. Is fiú an praghas é. Tugann gach soláthraí a shreabhadh OAuth féin, a scéiméir, a aistí, a theorainneacha ráta, a iompar webhook, a dhearbhú, agus a chothabháil leanúnach.

APIanna cuntasaíochta aontaithe

Tugann API aontaithe aon chomhéadan amháin thar chórais cuntasaíochta éagsúla, ag normalú eintitis amhail custaiméirí, sonrasc, soláthraithe, cuntais, íocaíochtaí, agus táirgí. Is féidir leis an am tógála tosaigh a laghdú. Ní bhaineann sé castacht chomhtháthaithe, agus is botún coitianta é a mheas go ndéanann.

Sula dtiomnaíonn tú, faigh freagra ar na ceisteanna seo: Cé na soláthraithe agus na hoibríochtaí a dtacaítear leo? An n-oibríonn scríbhinní, nó léamha amháin? An sioncronach nó scuabiarratais iad na scríbhinní? An bhfuil réimsí a bhaineann go sonrach le soláthraithe ar fáil trí phas-trí (passthrough)? An bhfuil sonraí i dtaisce (cached), agus cé chomh úr agus atá siad? Cé a láimhseálann briseadh seirbhíse soláthraithe agus athruithe API? An bhfuil an praghsáil in aghaidh an ghlao, in aghaidh an chuntais nasctha, in aghaidh an taifid, nó mar tháille ardáin? An féidir leat do mhapálacha a easpórtáil agus dícheangal go glan? Is annamh a chiallaíonn "aontaithe" "comhionann i ngnéithe thar sholáthraithe".

Mórleabhar leabaithe

Más é príomhfhadhb d'ardáin ná cuntasaíocht a rith do d'úsáideoirí, seachas í a léiriú ina leabhair atá ann cheana, athraíonn mórleabhar leabaithe an ríomh. Margadh le na mílte díoltóir, nó táirge SaaS a dteastaíonn CBL AE atá réidh d'iniúchadh agus comhlíonadh in aghaidh na tíre tógtha isteach ann, is fearr a fhreastalaítear air trí úinéireacht a bheith aige ar an inneall cuntasaíochta seachas trí N cónascaire seachtrach a shreangú. Sin suíomh Nordlet: fíor-leabhair mar API, dé-iontráil dhosháraithe, CBL in aghaidh na tíre le bailíochtú VIES agus giniúint cláir i.SAF, easpórtáil SEPA, agus easpórtálacha tuairiscithe in XLSX, PDF, nó JSON, gach rud taobh istigh de do tháirge seachas seic amach tríú páirtí.

Riail chinntithe a úsáidim:

Staid	An feiriú is fearr
Déanann soláthraí cuntasaíochta amháin ceannas ar do bhonn custaiméirí; tá iompar sonrach soláthraí lárnach	Cónascaire díreach
Is mó an tábhacht a bhaineann le clúdach leathan soláthraithe agus luas chun an mhargaidh ná smacht	API aontaithe
Is ardán nó margadh thú a dteastaíonn na leabhair a rith agus a bheith i d'úinéir orthu, le CBL AE agus conairí iniúchta	Mórleabhar leabaithe (Nordlet)
Réaltacht mheasctha	Hibrid: aontaithe do shreabha coitianta, cónascairí díreacha do sholáthraithe straitéiseacha

Ailtireacht chomhtháthaithe molta

Scortáil an comhtháthú ó loighic ghnó lárnach

Ná scaip glaonna soláthraí thar bhilleáil, orduithe, síntiúis, agus tuairisciú. Tóg seirbhís chomhtháthaithe tiomnaithe a choinníonn oiriúntóirí soláthraí, bainistíocht nasc OAuth, múnlaí caonónacha (canonical models), mapálacha ID, postanna sioncronaithe agus scuabeanna, críochphuntaí webhook, láimhseáil athsheolta agus scuaib-bháis (dead-letter handling), logaí iniúchta, agus uirlisí athmhuinteerais. Coinníonn sé seo ainm réimse Xero nó QuickBooks ó thitim isteach i do mhúnla fearainn.

Sainmhínigh múnla caonónach caol

Múnlaigh ach na sruthanna oibre a dtacaíonn tú leo. Oibiachtaí tipiciúla: custaiméir, táirge nó mír seirbhíse, sonrasc, líne sonrasc, íocaíocht, nóta creidmheasa, soláthraí, cuntas, ráta cánach, airgeadra, iontráil irise.

Caomhnaigh idirdhealuithe a théann i bhfeidhm ar an gcuntasaíocht. Ná déan dréacht versus ceadaithe versus postáilte a chothromú, méideanna lánchánach versus eisiach cánach, nótaí creidmheasa versus sonrasc diúltacha, leithdháileadh íocaíochta versus láithreacht íocaíochta, nó uimhir sonrasc atá ag tabhairt aghaidh ar an gcustaiméir versus ID oibiachta soláthraí. Ba chóir go mbeadh ID SaaS, ID soláthraí, ainm soláthraí agus leagan API, táscaire foinse-fhírinne, stát, stampaí ama, am sioncronaithe deiridh, tagairt seachtrach, agus stát earráide/athmhuinteerais i ngach taifead.

Coinnigh táblaí mapála sainráite

Mapáil tionónta SaaS go eagraíocht cuntasaíochta, custaiméir SaaS go teagmháil soláthraí, táirge SaaS go mír nó cuntas soláthraí, sonrasc SaaS go sonrasc soláthraí, íocaíocht SaaS go híocaíocht soláthraí, catagóir cánach go cód cánach, agus catagóir ioncaim go cuntas mórleabhair.

Ná húsáid ainmneacha nó ríomhphoist mar aitheantóirí buana riamh. Athraíonn ainmneacha, tá dúblaigh ann, agus is féidir le beirt chustaiméirí ríomhphost a roinnt. Stóráil ID dosháraithe an tsoláthraí agus coinnigh an bun-ID SaaS.

Cuir meaisíní stáit leis

Tabhair stáit sainráite do nasc: gan nascadh, údarú ar feitheamh, nasctha, sioncronú túsáideach ar feitheamh, ag sioncronú, sláintiúil, teoranta i ráta, athúdarú de dhíth, soláthraí neamhreacha, dícheangailte, teipthe go buan. Tabhair a gcuid stáit féin do thaifid: ar feitheamh, seolta, deimhnithe, teipthe-inathsheolta, teipthe-gá-le-gníomh-úsáideora, athmhuintearaithe, coinbhleacht aimsithe. Ní insíonn bratach dhá-luach "nasctha/gan nascadh" aon rud úsáideach do do fhoireann tacaíochta.

OAuth agus bordáil nasc

Úsáid an sruth cóid údaraithe. Cliceálann an custaiméir Connect, cruthaíonn do fhreastalaí idirbheart údaraithe gearr-ré, fíordheimníonn an custaiméir ag an soláthraí agus tugann sé scóip, malartaíonn tú an cód ar chomharthaí, faigheann tú amach an eagraíocht údaraithe, stóráil an nasc i gcoinne an tionónta ceart, agus scuabann tú sioncronú túsáideach.

Bailíochtaigh an t-aisghlaoch go cúramach: state i gcoinne idirbheart taobh-freastalaí, URI athsheolta cruachás, eisiúnaí an tsoláthraí, agus comhthéacs an tionónta. Déanann RFC 9700, OAuth 2.0 Security Best Current Practice, an treoir reatha a fhoirmiú: úsáid PKCE le sruthanna cóid údaraithe, seachain deontais thobchaite (implicit) agus pasfhocail, agus úsáid comhoiriúnacht i dtreo URI athsheolta cruinn.

Iarr scóip íosta-phribhléide (least-privilege scopes). Úsáid léamh-amháin nuair nach gá duit scríobh. Athraíonn múnlaí scóip, mar sin ná cóipeáil seanchinn. Tugann doiciméadú OAuth Xero le fios go bhfuil scóip leathana cuntasaíochta á n-ionadú ag cinn ghráinneacha, le aipeanna nua comhionannaithe le scóip ghráinneacha ó Mhárta 2026 agus scóip leathana sceidealaithe chun fanacht ar fáil go Meán Fómhair 2027.

Stóráil comharthaí ar an taobh-freastalaí amháin. Ná nocht iad do JavaScript brabhsálaí, cliaint mhoghlacha, logaí ceann-deiridh, anailísíocht, nó teachtaireachtaí earráide d'úsáideoirí. Criptigh ag an gcuid eile, scrios ó logaí, agus coinnigh meiteashonraí in aghaidh an naisc: comharthaí rochtana agus athnuachana criptithe, éagobhsaíocht, ID org soláthraí, scóip deonaithe, am eisiúna, an athnuachan rathúil deiridh, stát chúngaithe.

Is é rothlú comharthaí athnuachana áit a briseann an táirgeadh

Féadfaidh freagra athnuachana comhartha athnuachana nua a thabhairt ar ais. Caithfidh tú an luach is nua a bhuanú go hatomach, nó glasálann tú an custaiméir amach. De réir FAQ forbróra Xero, táirgeann gach athnuachan comhartha athnuachana nua, mhaireann comharthaí athnuachana suas le 60 lá, agus tá tréimhse ghrásta 30 nóiméad ann chun triail eile a bhaint as leis an gcomhartha atá ann cheana má cailltear freagra. Inisíonn QuickBooks Online d'fhorbróirí an comhartha athnuachana is déanaí ón bhfreagra is déanaí a stóráil: mhaireann comharthaí athnuachana suas le 100 lá, agus féadann an luach rothlú chomh minic le gach 24 uair an chloig.

Go praiticiúil: úsáid glas athnuachana in aghaidh an naisc, cuir an comhartha athnuachana in ionad go hatomach, láimhseáil teipeanna neamhbhuan críochphointe comhartha le hathsheolta, nocht stát athúdaraithe soiléir, agus ná déan athnuachan ar gach glao API fad a fhanann comhartha rochtana bailí.

Sioncronú túsáideach

Rith sioncronú túsáideach mar phost cúlra. Ná bac le haisghlaoch OAuth ná leis an UI air.

Sezęquence láidir: faigh meiteashonraí eagraíochta, aisghabh cuntais, rátaí cánach, airgeadraí, teagmhálacha, agus míreanna, stóráil IDanna soláthraí agus mapálacha, iompórtáil ach an fhuinneog stairiúil a theastaíonn ón táirge, scuab taifid spleácha in ord spleáchais, taifead seicphointe, agus marcáil an nasc sláintiúil ach amháin tar éis bailíochtaithe.

Tá tábhacht ag baint le hord spleáchais. Is féidir le sonrasc teagmháil, mír, cuntas ioncaim, cód cánach, agus airgeadra a bheith de dhíth chun a bheith ann ar dtús. Ná cruthaigh dúblaigh go dall. Meaitseáil ar ID seachtrach stóráilte, tagairt arna soláthar ag an gcustaiméir, riail mheaitseála shainmhínithe, nó céim roghnúcháin úsáideora shainráite do chásanna débhríoch.

Sioncronú incriminteach

Caith le webhookanna mar chomharthaí, ní mar thaifid údarásacha

De ghnáth deir webhook gur athraigh rud éigin. Fíoraigh an síniú, taifead an t-imeacht amh, tabhair ar ais an fhreagras ratha riachtanach go tapa, déan dídhúbláil, scuab aisghabháil leantach, aisghabh an t-oibiacht reatha ón soláthraí, cuir an t-update i bhfeidhm go hidirbheartach, déan nuashonrú ar an seicphointe, agus ródaigh teipeanna chuig athsheoladh nó athmhuintearas. Láimhseálann sé seo pálastaí neamhiomlána agus imeachtaí as ord.

Tá rialacha soláthraí éagsúla, mar sin ná geall iompar uilíoch amháin. Tá síniú HMAC-SHA256 i gceann webhookanna Xero sa cheanntásc x-xero-signature, éilíonn siad HTTPS, déanann siad athsheoladh le minicíocht lúide ar feadh suas le 24 uair an chloig, is féidir iad a dhíchumasú tar éis teip athchleachtach, agus is féidir leo imeachtaí a shábháil ar feadh suas le 31 lá le haghaidh athsheinm tar éis teacht chucu féin. Fíoraíonn QuickBooks Online le HMAC-SHA256 agus comhartha fíoraitheora, ag súil le HTTP 200 laistigh de thrí shoicind, agus déanann sé athsheoladh ar sceideal socraithe a shocraíonn sa deireadh i eatraimh sé huaire an chloig, le Intuit ag moladh próiseáil neamh-synchrónach.

Dídhúbláil agus neamhthionchar (idempotency)

Is gnách seachadadh ar a laghad uair amháin (at-least-once delivery). Bí súil le webhookanna dúbailte, athsheolta tar éis tréimhse fhaireacháin ina n-éiríonn leis an scríbhinn i ndáiríre, imeachtaí athordaithe, agus cliceanna úsáideora dúbailte. Úsáid ID imeachta soláthraí nuair a bhíonn sé ar fáil, eochair imeachta uathúil i stóráil bhuan, eochair oibríochta a ghintear sula scríobhtar gach uair, srianta uathúlachta bunachair sonraí, séimeantaic upsert, agus fiosrúchán athmhuinteerais tar éis tréimhsí fhaireacháin débhríocha.

Ná glac leis go dtugann gach API cuntasaíochta eochair neamhthionchair dhúchasach (native idempotency keys). Mura dtugann an soláthraí, stóráil eochair oibríochta inmheánaigh agus seiceáil an bhfuil an t-oibiacht iargúlta ionchais ann cheana sula n-athsheolann tú. Aistríonn patrúin ó iarratais neamhthionchair Stripe agus treoir ghinearálta neamhthionchair webhook go maith anseo.

Vótaíocht (Polling) agus braite athruithe

Péireáil webhookanna le vótáil thréimhsiúil. Éiríonn webhookanna díchumasaithe, moillithe, caillte mar gheall ar mhífhírú, nó teoranta d'oibiachtaí áirithe. Tacóidh Xero leis an gceanntásc If-Modified-Since le haghaidh athruithe tar éis stampa ama UTC, ach tugann a dhoiciméadú le fios nach ndéanann gach athrú nuashonrú ar UpdatedDateUTC, mar sin ní thaispeánfar roinnt idirbheart páirteach íoctha agus réimsí teagmhála tríd an scagaire sin. Rianaíonn Change Data Capture QuickBooks Online athruithe ó na 30 lá roimhe sin, cuireann sé caipín ar fhreagraí ag 1,000 oibiacht, tugann sé ar ais eintitis scriosta le stát Deleted, agus oibríonn sé is fearr le fuinneoga vótála níos giorra.

Stóráil seicphointe in aghaidh an tsoláthraí, in aghaidh an tionónta agus úsáid fuinneoga forluí. Iarr athruithe ó am beagán roimh an seicphointe deiridh, ansin dídhúbláil de réir ID soláthraí agus leagan modhnúcháin. Cosnaíonn sé seo in aghaidh claonadh cloig (clock skew) agus teipeanna páirteacha.

Sláine shonraí a bhaineann go sonrach le cuntasaíocht

Seo an chuid a scarann comhtháthú oibre ó cheann iontaofa.

Níl iompar cánach idirmhalartaithe. Tugann doiciméadú Xero le fios go mbíonn sonrasc, nótaí creidmheasa, agus orduithe ceannaigh eisiach cánach de réir réamhshocraithe nuair a bhíonn LineAmountTypes gan shocrú, is lánchánach receipt agus idirbhearta bainc de réir réamhshocraithe, agus gan cháin is ea iriseáin láimhe de réir réamhshocraithe. Úsáid an réimse TaxType, ní ainm an ráta cánach. Ná glac leis riamh go sainaithníonn "CBL 20%" cód cánach go huathúil; féadfaidh sé athrú de réir tíre, cineál idirbhirt, dáta éifeachtach, agus cumraíocht eagraíochta. Is anseo a éiríonn CBL iltíre AE costasach le fáil i gceart de láimh, agus is anseo a thuilleann mórleabhar leabaithe le comhlíonadh in aghaidh na tíre tógtha a áit.

Úsáid uimhearthacht dheachúlach nó bheachtais shocraithe d'airgead, ná húsáid leibhéal snámhphointe dénártha (binary floating point) riamh. Buanús cód airgeadra agus beachtas, méid aonaid, cainníocht, lascaine, méid cánach, glan, comhlán, agus ráta malairte. Cinntigh go soiléir cé acu an seolann tú méideanna ag leibhéal na líne agus lig don soláthraí iomláin a ríomh, nó an seolann tú iomlán réamh-mheasta. Cruthaíonn meascadh an dá rud neamhréiteach babhtaála a gheobhaidh d'chuntasóir.

Déan tagairt do chuntais mórleabhair de réir ID soláthraí nó cód, ní ainm taispeána. Sula scríobhtar, bailíochtaigh go bhfuil cuntais, cóid cánach, custaiméirí, míreanna, agus airgeadra gníomhach agus tacaithe. Is fadhb mapála nó cumraíochta de ghnáth scríbhinn sonrasc teipthe, ní earráid API neamhbhuan, mar sin ba chóir don UI an leasú a mhíniú seachas "sync failed" a thaispeáint.

Ná glac leis comhionannas oibiachta. Is féidir le "híocaíocht" admháil, leithdháileadh, taisce, idirbheart bainc, nó iontráil irise a chialliú. Seans nach mapálann "sintiúis" SaaS go neat le "sonrasc" cuntasaíochta. Sainmhínigh an t-imeacht cuntasaíochta is mian leat a léiriú sula roghnaíonn tú oibiacht API. Féach ar doiciméadú íocaíochtaí Xero chun fáil amach conas a mhúnlaíonn soláthraí amháin é seo.

Teorainneacha ráta (Rate limits) agus leaganachán

De ghnáth déantar teorainneacha a scópáil de réir tionónta, eagraíochta, feidhmchláir, nó meascáin díobh. De réir FAQ teorainneacha Xero: cúig iarratas comhthráthach in aghaidh an tionónta, 60 in aghaidh an nóiméid in aghaidh an tionónta, 5,000 in aghaidh an láigh in aghaidh an tionónta, agus 10,000 in aghaidh an nóiméid thar an aip, le ceanntásca teorann-fágtha agus Retry-After ar 429anna. Déanann QuickBooks Online 500 iarratas in aghaidh an nóiméid agus 10 in aghaidh an tsoicind in aghaidh an ID réimse a dhoiciméadú, le críochphointe baisce a thacaíonn le hat suas le 30 oibríocht in aghaidh an iarratais.

Tóg teorannú ráta in aghaidh an tionónta, lúbadh domhanda, cúlú easpónlach le crith (jitter), urraim do Retry-After, comhthráthacht theoranta, uimhriú leathanach, agus méadrachtaí ar 429anna agus cuóta atá fágtha. Ná húsáid comhthreomharacht gan teorainn le haghaidh allmhairí; is féidir le custaiméir mór amháin gach post eile ar an tionónta sin astarraingt.

Pinn nó bainistigh leaganacha API go sainiúil. Téann QuickBooks Online go réamhshocraithe chuig mionleagan 75 nuair nach sònraítear aon cheann. Lárnaigh leaganacha i gcumraíocht, rith tástálacha conartha in aghaidh boscaí qumhdach (sandboxes), monatóir nótaí scaoilte, agus caith le réimsí freagrana anaithnida mar chomhoiriúnach ar aghaidh. Ní dhéanfaidh boscaí qumhdach gach coinníoll táirgthe a athchruthú, mar sin tástáil dícheangal, athnasc, toiliú cúngaithe, comharthaí in éaga, teorainneacha ráta, agus modhnuithe taobh-soláthraí sula seoltar.

An rud a thógfainn ar dtús

Dá mbeinn ag túsú leis seo amárach, san ord seo:

Sainmhínigh an sruth oibre cuntasaíochta cruinn: cén t-imeacht agus oibiacht a léann nó a scríobhann tú.
Roghnaigh an straitéis soláthraí: díreach, aontaithe, leabaithe, nó hibrid.
Tóg múnla nasc tionónta-scópáilte le IDanna org soláthraí, scóip, stát, agus meiteashonraí comhartha.
Cuir OAuth i bhfeidhm le sruth cóid údaraithe, PKCE, bailíochtú stáit, scóip íosta-phribhléide, agus stóráil comhartha taobh-freastalaí.
Tóg oiriúntóir soláthraí amháin taobh thiar d'aghaidh inmheánaigh chobhsaí.
Cruthaigh mapálacha ID ar IDanna soláthraí dosháraithe.
Cuir léamha i bhfeidhm ar dtús; iompórtáil sonraí tagartha sula scríobhtar aon rud.
Cuir post sioncronaithe túsáideach leis le huimhriú leathanach, teorannú ráta, seicphointe, agus ord spleáchais.
Cuir scríbhinn chaol amháin i bhfeidhm (sonrasc a chruthú) ach amháin tar éis do mhapaí custaiméara, míre, cánach, agus cuntais bailíochtú a dhéanamh.
Déan scríbhinní athsheoladh-shábháilte le heochracha oibríochta inmheánaigh, srianta uathúlachta, agus seiceálacha staid iargúlta.
Cuir webhookanna sínithe leis a admhaíonn go tapa agus a phróiseálann go neamh-synchrónach.
Cuir vótáil agus athmhuintearas leis ionas gur luasghéarú iad webhookanna, ní an t-aon fhoinse fírinne.
Tástáil mód teipe go sainiúil.
Cuir uirlisí tacaíochta agus iniúchta leis a fhágann teipeanna an-mhínithe agus in-deisithe.
Leathnaigh clúdach oibiachta de réir a chéile.

FAQ

An cheart dom API aontaithe a úsáid nó cónascairí díreacha a thógáil?

Úsáid cónascaire díreach nuair a dhéanann soláthraí amháin ceannas ar do chustaiméirí nó nuair a bhíonn iompar sonrach soláthraí lárnach. Smaoinigh ar API aontaithe nuair is mó an tábhacht a bhaineann le clúdach leathan agus luas ná smacht. Más é do fhíor-riachtanas na leabhair a rith duit féin seachas a bheith ag sioncronú le córas custaiméara, ní fhreagraíonn ceachtar acu an cheist; féach ar mhórleabhar leabaithe cosúil le Nordlet ina ionad sin.

An leor webhookanna chun fanacht i sioncronú?

Níl. Éiríonn webhookanna díchumasaithe, moillithe, nó caillte, agus is féidir le pálastaí bheith neamhiomlán nó as ord. Caith leo mar chomharthaí athraithe, aisghabh an t-oibiacht reatha ina dhiaidh sin, agus tabhair cúnamh dóibh le vótáil thréimhsiúil agus athmhuintearas.

Conas a stopaim teipeanna comhartha athnuachana ó chustaiméirí a ghlasáil amach?

Buanús an comhartha athnuachana is nua go hatomach ar gach athnuachan, úsáid glas in aghaidh an naisc, athsheol teipeanna neamhbhuan críochphointe comhartha, agus nocht stát athúdaraithe soiléir. Cuidíonn tréimhse ghrásta 30 nóiméad Xero, ach is é an buanú atomach a shábhálann tú.

An féidir liom taifid a mheaitseáil de réir ainm custaiméara nó ríomhphoist?

Ní mar aitheantóir buan é. Athraíonn ainmneacha, tarlíonn dúblaigh, agus is féidir le beirt chustaiméirí ríomhphost a roinnt. Stóráil ID dosháraithe an tsoláthraí agus coinnigh d'ID SaaS féin taobh leis.