Nordlet fyrir forritara

Bættu við innheimtu, bókhaldsskilum og ESB-skattskýrsum í hugbúnaðinn þinn í gegnum einu JSON API, týpðum hugbúnaðarþróunarsettum (SDK), vefkrókum, MCP þjóni og prófunarfyrirtækjum.

Mörg forrit mynda fjárhagslega atburði: pöntun er greidd, áskrift er endurnýjuð eða endurgreiðsla er send út. Hver og einn þessara atburða þarf að skila sér inn í bókhald fyrirtækis.

Nordlet er bókhaldshugbúnaður sem er hannaður með API í fyrirrúmi. Allt sem vefforritið gerir er einnig aðgengilegt í gegnum eitt JSON API. Forritið þitt sendir atburðina og Nordlet sér um bókhaldshaldið og undirbúning skattskýrslna.

Hvað Nordlet gerir

Birtir hverja aðgerð sem POST /v1/{module}/{resource}/{action} með JSON-meginmáli, til dæmis /v1/sales/invoices/create.
Auðkennir hverja beiðni með API-lykli sem tilheyrir einu fyrirtæki. Hver lykill hefur tilteknar heimildir (scopes), svo sem sales:read eða sales:write, sem takmarka það sem hann getur gert.
Tekur við fjárhæðum sem tugastrengjum, aldrei sem fleytitölum, svo að engar aurar tapist vegna nágildunar (rounding).
Tekur við Idempotency-Key haus á hverri breytingu. Endurtekning beiðni með sama lykli skilar fyrsta svarinu í stað þess að vinna verkið tvisvar. Samsvörunarleysi í endurtekningum (idempotency) þýðir að endurtekin beiðni hefur sömu áhrif og ein beiðni.
Skilar öllum villum á einu sameiginlegu sniði.
Leyfir 300 beiðnir á mínútu á bókhaldið fyrir hvern API-lykil.
Skráir allar breytingar í endurskoðunarslóð (audit log).

Leiðarvísirinn um API-venjur fer ýtarlega yfir hverja og eina af þessum reglum.

Bókhald sem heldur sér réttu

Útgáfa reiknings úthlutar samfelldu númeri, staðfestir að bókhaldstímabilið sé opið og bókar færsluna (journal entry) í sömu gagnagrunnsfærslunni.
Hver færsla verður að vera í jafnvægi. Gagnagrunnurinn sjálfur staðfestir þetta þegar færslan er vistuð.
Ekki er hægt að eyða útgefnum og skráðum skjölum. Röngum bankastillingum er kippt í liðinn með endurgreiðslufærslu í stað þess að breyta þeirri gömlu. Þetta er það sem óbreytanlegur höfuðbók (immutable ledger) þýðir.

Hugbúnaðarþróunarsett (SDK), MCP og vefkrókar

Týpt hugbúnaðarþróunarsett (SDK) eru búin til út frá sömu OpenAPI lýsingu fyrir TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift og Rust. Þar til SDK er gefið út seturðu það upp úr upprunasafni þess. Sjá SDK-leiðarvísinn.
Postman-safn með öllum endapunktum er í boði.
MCP þjónninn gerir gervigreindaraðstoðarmanni eins og Claude Code kleift að leita í API-inu og kalla á það með API-lyklinum þínum. Hvert kall er venjuleg API-beiðni með sömu heimildum og takmörkunum.
Vefkrókar láta forritið þitt vita þegar eitthvað gerist, til dæmis sale_invoice.issued eða sale_invoice.paid. Hver sending er undirrituð með HMAC-undirskrift svo þú getir staðfest að hún komi frá Nordlet. Reynt er aftur við mistök í sendingum í um það bil 24 klukkustundir.

Prófanir með prófunarfyrirtækjum (sandbox)

Búðu til fyrirtæki með isSandbox: true, eða hakaðu við prófunarreitinn þegar þú setur upp fyrirtæki í forritinu.
Prófunarfyrirtæki virkar eins og raunverulegt fyrirtæki: sömu einingar, sama API.
Það er greinilega merkt sem prófunargagn og þú getur ekki breytt raunverulegu fyrirtæki í prófunarfyrirtæki eða öfugt.
Skýrsluskil og rafrænir reikningar (e-invoices) frá prófunarfyrirtæki fara á prófunarþjónustu yfirvalda.
Notkun í prófunarfyrirtæki er mæld og gjaldfærð eins og notkun í raunverulegu fyrirtæki.

Byrjunarleiðarvísirinn leiðir þig í gegnum fyrsta API-lykilinn, fyrsta reikninginn og alla lotuna.

FAQ

Getur eitt forrit þjónað mörgum fyrirtækjum?

Já. Hver API-lykill tilheyrir einu fyrirtæki, þannig að þú býrð til lykil fyrir hvert fyrirtæki. Hver sending vefkróks ber með sér companyId þess fyrirtækis sem hann tilheyrir, þannig að einn viðtakandi getur þjónað mörgum fyrirtækjum.

Þarf ég að smíða skattskýrslurnar sjálfur?

Nei. Nordlet útbýr skýrslurnar út frá bókhaldi. Fyrir hverja skýrslu sendir það hana annaðhvort, býr til skrá sem þú hleður upp, eða sýnir tölur sem þú slærð inn, eftir því sem við á í hverju landi. Yfirlitstöfluna um skýrsluskil sýnir öll tilvik.