Računovodski program z vmesnikom API

Vsak del sistema Nordlet je na voljo prek enega vmesnika JSON API, ki vključuje pakete SDK, spletne kljuke (webhooks), ponovne poskuse z zagotovljeno enkratnostjo (idempotency) in strežnik MCP za umetno inteligenco.

Vmesnik API (application programming interface) omogoča komunikacijo med različnimi programi. Računovodski vmesnik API vaši lastni programski opremi omogoča izdajanje računov, knjiženje plačil in branje poročil, ne da bi moral uporabnik klikati po zaslonu.

Nordlet je računovodska programska oprema, pri kateri je vmesnik API glavni vstopni kanal. Vse, kar omogoča spletna aplikacija, je na voljo prek istega vmesnika JSON API. Ta stran je namenjena razvijalcem in odločevalcem, ki izbirajo povezave za svoje izdelke.

Kaj omogoča Nordlet

Enotna oblika zahtev. Vsak klic sledi vzorcu POST /v1/{module}/{resource}/{action} s telesom JSON, na primer sales/invoices/create ali bank/transactions/match.
Ključi API z območji delovanja (scopes). Vsak ključ pripada določenemu podjetju in ima določena območja delovanja, kot sta sales:read ali bank:write. Ključ brez ustreznega območja prejme odgovor 403.
Denar kot besedilo. Zneski so decimalni nizi z do 4 decimalkami, nikoli števila s plavajočo vejico, zato zaradi zaokroževanja ne prihaja do izgub centov.
Enotna oblika napak. Vsaka napaka ima enotno ovojnico s kodo, sporočilom in identifikatorjem zahteve.
Deljene poizvedbe za seznam. Vsak klic list uporablja ista polja za straničenje, razvrščanje in filtriranje ter lahko vrača vsote.
Prava računovodska pravila. Temeljnica mora biti uravnotežena, številke dokumentov ne smejo imeti vrzeli, zaklenjeno računovodsko obdobje pa nova knjiženja zavrne z odgovorom 409. Vsaka sprememba se zapiše v revizijsko sled.

Varni ponovni poskusi z zagotovljeno enkratnostjo (idempotency)

Omrežje lahko odpove potem, preden prejmete odgovor, čeprav je bila vaša zahteva že obdelana. Ponovni poskus bi lahko privedel do dvojne izdaje istega računa. Zagotovljena enkratnost idempotency pomeni, da ima ponovljena zahteva enak učinek kot prva.

Pri vsakem klicu, ki spreminja podatke, pošljite glavo Idempotency-Key.
Ponovni poskus z istim ključem in enakim telesom zahteve vrne shranjen odgovor z glavo x-idempotent-replay: true.
Isti ključ z drugačnim telesom zahteve je zavrnjen.
Ključi se hranijo 24 ur.

Spletne kljuke (webhooks)

Spletna kljuka (webhook) je sporočilo, ki ga Nordlet pošlje na vaš strežnik ob določenem dogodku, na primer sale_invoice.paid.

Dogodki se zapisujejo v isti bazi podatkov kot sprememba, zato preklicana sprememba ne sproži pošiljanja nobenega dogodka.
Vsako sporočilo je podpisano s kriptografskim algoritmom HMAC-SHA256 z uporabo tajnega ključa vaše naročnine, kar vam omogoča preverjanje pristnost izvora iz sistema Nordlet.
Neuspešna dostava se ponavlja približno 24 ur. Dostavo lahko sprožite tudi ročno.
Naročnine lahko upravljate v razdelku Account → Webhooks ali prek vmesnika API.

Orodja za razvijalce

Referenca API. Interaktivna referenca API, ustvarjena iz opisa OpenAPI, skupaj z zbirko za Postman.
Paketi SDK. Tipizirani odjemalci za TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift in Rust, ustvarjeni iz istega opisa. Glejte vodnik po paketih SDK.
Strežnik MCP. Pomočniki z umetno inteligenco, kot je Claude, lahko z vašim ključem API iščejo in kličejo vmesnik API. Glejte vodnik po strežniku MCP.
Testna podjetja (sandbox). Testno podjetje deluje podobno kot pravo, vendar je označeno kot testni podatek ter pošilja obračune in e-račune izključno na testne naslove (endpoints) ustreznih institucij.
Omejitev števila klicev (rate limit). 300 zahtev na minuto za posamezen ključ API, pri čemer glave prikazujejo preostale razpoložljive klicne možnosti.

FAQ

Kaj lahko počnem prek vmesnika API?

Vse funkcije v izdelku: izdajanje računov, nabavo, glavno knjigo, usklajevanje bančnih izpiskov, zaloge, osnovna sredstva, obračun plač, poročila in oddajo poročil davčnim organom. Vodnik za začetek uporabe prikazuje celoten cikel od izdaje računa do podatkov za DDV.

Ali lahko v lasten izdelek vgradim računovodske funkcije?

Da. Vsako podjetje v sistemu Nordlet ima svoje poslovne knjige, vaša programska oprema pa z njimi upravlja prek ustreznega ključa API. Vmesnik API ne vsebuje klicev za urejanje ali brisanje že knjiženih temeljnic. Popravek se izvede kot nova temeljnica, s čimer se ohrani nespremenljiva glavna knjiga (immutable ledger).