Bókhaldshugbúnaður með API

Allir hlutar Nordlet eru aðgengilegir í gegnum eitt JSON API, ásamt forritunarsöfnum, vefkrókum, sjálfvirkni í ítrekunum og MCP netþjóni fyrir gervigreindaraðstoðarmenn.

API (forritunarskil) er leið fyrir eitt forrit til að tala við annað. Með bókhalds-API getur eigin hugbúnaður þinn útbúið reikninga, skráð greiðslur og lesið skýrslur án þess að einhver þurfi að smella í gegnum skjái.

Nordlet er bókhaldshugbúnaður þar sem API-ið er aðalleiðin inn. Allt sem vefforritið gerir er aðgengilegt í gegnum sama JSON API. Þessi síða er ætluð þróunaraðilum og þeim sem taka ákvarðanir um hvaða kerfum varan þeirra tengist.

Hvað Nordlet gerir

Eitt snið beiðna. Allar beiðnir eru POST /v1/{module}/{resource}/{action} með JSON-bol, til dæmis sales/invoices/create eða bank/transactions/match.
API-lyklar með aðgangsheimildum. Hver lykill tilheyrir einu fyrirtæki og ber heimildir eins og sales:read eða bank:write. Lykill sem skortir til þörf heimild fær 403-svörun.
Peningar sem texti. Upphæðir eru tugabrotastrengir með allt að 4 aukastöfum, aldrei fleytitölur, þannig að engar aurar tapast við nágildun.
Eitt villusnið. Öll villuskilaboð hafa sama umbúðasnið með kóða, skilaboðum og beiðnikenni.
Sameiginlegar listaleitir. Öll list-köll taka sömu flettisíðu-, röðunar- og síunarreiti og geta skilað samtölum.
Raunverulegar bókhaldsreglur. Færslubækur verða að stemma, skjalarnúmer mega ekki hafa bil á milli sín og lokað bókhaldstímabil hafnar nýjum færslum með 403-svörun. Öll breyting er skráð í endurskoðunarslóð.

Öruggar ítrekanir með sjálfvirkni í ítrekunum (idempotency)

Netkerfi getur bilað eftir að beiðni þín var unnin en áður en þあなたは svörunin barst. Endurtekning á beiðni gæti þá búið til sama reikninginn tvisvar. Sjálfvirkni í ítrekunum (idempotency) þýðir að endurtekin beiðni hefur sömu áhrif og sú fyrsta.

Sendu Idempotency-Key haus (header) með öllum köllum sem breyta gögnum.
Endurtekning með sama lykli og sama bol fær geymdu svörunina til baka, ásamt x-idempotent-replay: true.
Sama lykli með öðrum bol er hafnað.
Lyklar eru geymdir í 24 klukkustundir.

Vefkrókar (webhooks)

Vefkrókur er skilaboð sem Nordlet sendir á netþjóninn þinn þegar eitthvað gerist, svo sem sale_invoice.paid.

Atburðir eru skrifaðir í sömu gagnagrunnsfærslu og breytingin, þannig að breyting sem er rúlluð til baka sendir engan atburð.
Hver sending er undirrituð með HMAC-SHA256 með leyndarmáli áskriftar þinnar, svo þú getir staðfest að hún komi frá Nordlet.
Reynt er aftur við mistök í sendingu í um það bil 24 klukkustundir. Þú getur líka sent hana aftur handvirkt.
Áskriftir eru stjórnaðar undir Account → Webhooks eða í gegnum API.

Verkfæri fyrir þróunaraðila

API-tilvísun. Gagnvirk API-tilvísun sem er byggð út frá OpenAPI-lýsingunni, ásamt Postman-safni.
Forritunarsöfn (SDKs). Slóðuð skil fyrir TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift og Rust, sem eru búin til út frá sömu lýsingu. Sjá leiðbeiningar um forritunarsöfn.
MCP-netþjónn. Gervigreindaraðstoðarmenn eins og Claude geta leitað í og kallað á API með API-lyklinum þínum. Sjá leiðbeiningar um MCP-netþjón.
Prófunarfyrirtæki (sandbox). Prófunarfyrirtæki virkar eins og raunverulegt fyrirtæki, er merkt sem prófunargögn og sendir skilaskýrslur og rafræna reikninga eingöngu á prófunarendapunkta stjórnvalda.
Hraðatakmörkun. 300 beiðnir á mínútu á burturför fyrir hvern API-lykil, með hausum sem sýna hvað er eftir.

FAQ

Hvað get ég gert í gegnum API?

Allt í vörunni: reikningsfærslu, innkaup, fjárhagsbókhald, bankastemmingu, birgðir, eignir, launavinnslu, skýrslur og opinber skil. Byrjunarleiðbeiningarnar fara í gegnum heila hringrás frá reikningi að virðisaukaskattstölum.

Get ég byggt bókhaldið inn í mína eigin vöru?

Já. Hvert fyrirtæki í Nordlet er með sín eigin bókhaldsgögn og hugbúnaðurinn þinn vinnur á þeim í gegnum API-lykil sinn. API-ið er ekki með nein köll sem breyta eða eyða bókfærðri færslubókarfærslu. Leiðrétting er ný færsla sem heldur úti óbreytanlegu bókhaldi (immutable ledger).