Računovodstveni softver s API-jem

Svaki dio sustava Nordlet dostupan je putem jednog JSON API-ja, uz SDK-ove, webhookove, idempotentne ponovne pokušaje i MCP poslužitelj za AI asistente.

API (sučelje za programiranje aplikacija) način je na koji jedan program komunicira s drugim. Računovodstveni API omogućuje vašem vlastitom softveru izradu računa, knjiženje plaćanja i čitanje izvještaja bez ručnog klikanja po ekranima.

Nordlet je računovodstveni softver u kojem je API glavni ulaz. Sve što web-aplikacija radi dostupno je preko istog JSON API-ja. Ova je stranica namijenjena programerima i osobama koje odlučuju o tome s čime će se njihov proizvod povezivati.

Što Nordlet radi

Jedinstven oblik zahtjeva. Svaki je poziv POST /v1/{module}/{resource}/{action} s JSON tijelom, na primjer sales/invoices/create ili bank/transactions/match.
API ključevi s ovlastima (scopes). Svaki ključ pripada jednoj tvrtki i nosi ovlasti poput sales:read ili bank:write. Ključ bez potrebne ovlasti dobiva odgovor 403.
Novac kao tekst. Iznosi su decimalni nizovi s do 4 decimalna mjesta, nikada brojevi s pomičnim zarezom (floating-point), tako da se ni jedan cent ne gubi zbog zaokruživanja.
Jedinstven format pogrešaka. Svaka pogreška ima istu ovojnicu s kodom, porukom i ID-jem zahtjeva.
Zajednički upiti za popise. Svaki poziv za popis (list) prihvaća isto straničenje, sortiranje i polja za filtriranje te može vratiti zbrojeve.
Stvarna računovodstvena pravila. Temeljnice moraju biti u ravnoteži, brojevi dokumenata nemaju praznina, a zaključano računovodstveno razdoblje odbija nova knjiženja s odgovorom 409. Svaka se promjena bilježi u revizijski trag (audit log).

Sigurni ponovni pokušaji s idempotencijom

Mreža može zakazati nakon što je vaš zahtjev obrađen, ali prije nego što ste primili odgovor. Ponovni pokušaj bi tada mogao dvaput izraditi isti račun. Idempotencija znači da ponovljeni zahtjev ima isti učinak kao i prvi.

Pošaljite zaglavlje Idempotency-Key uz svaki poziv koji mijenja podatke.
Ponovni pokušaj s istim ključem i istim tijelom vraća spremljeni odgovor, uz x-idempotent-replay: true.
Isti ključ s drugačijim tijelom biva odbijen.
Ključevi se čuvaju 24 sata.

Webhookovi

Webhook je poruka koju Nordlet šalje vašem poslužitelju kada se nešto dogodi, kao što je sale_invoice.paid.

Događaji se zapisuju u istoj transakciji baze podataka kao i promjena, tako da promjena koja je poništena (rolled back) ne šalje nikakav događaj.
Svaka je isporuka potpisana s HMAC-SHA256 pomoću tajnog ključa vaše pretplate, tako da možete provjeriti je li došla iz Nordleta.
Neuspjela isporuka ponavlja se otprilike 24 sata. Možete je poslati i ručno.
Pretplate se upravljaju pod stavkom Račun → Webhookovi ili putem API-ja.

Alati za programere

API referenca. Interaktivna API referenca izgrađena iz OpenAPI opisa, uz Postman zbirku.
SDK-ovi. Tipizirani klijenti za TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift i Rust, generirani iz istog opisa. Pogledajte vodič za SDK-ove.
MCP poslužitelj. AI asistenti poput Claudea mogu pretraživati i pozivati API pomoću vašeg API ključa. Pogledajte vodič za MCP poslužitelj.
Testne tvrtke (Sandbox). Testna tvrtka radi poput stvarne, označena je kao testni podatak i šalje izvještaje i e-račune samo na testne krajnje točke (endpoints) administracije.
Ograničenje brzine (Rate limit). 300 zahtjeva u minuti po API ključu, sa zaglavljima koja pokazuju preostali kapacitet.

Često postavljana pitanja

Što mogu učiniti putem API-ja?

Sve u proizvodu: izdavanje računa, nabavu, glavnu knjigu, usklađivanje bankovnih izvoda, zalihe, dugotrajnu imovinu, obračun plaća, izvještaje i državne izvještaje. Vodič za početak rada prolazi kroz cijeli ciklus od računa do iznosa PDV-a.

Mogu li ugraditi računovodstvo u vlastiti proizvod?

Da. Svaka tvrtka u Nordletu ima vlastite poslovne knjige, a vaš softver radi na njima putem svog API ključa. API nema poziv koji uređuje ili briše proknjiženu temeljnicu. Ispravak je nova temeljnica, čime se održava nepromjenjiva glavna knjiga (immutable ledger).