Nordlet

← All features

Nordlet za razvojne inženire aplikacija

Dodajte fakturiranje, knjigovodstvo i porezne prijave za EU u svoj softver putem jednog JSON API-ja, tipiziranih SDK-ova, webhookova, MCP poslužitelja i testnih (sandbox) tvrtki.

Mnoge aplikacije stvaraju financijske događaje: plaća se narudžba, obnavlja se pretplata, isplaćuje se povrat sredstava. Svaki od tih događaja mora završiti u poslovnim knjigama tvrtke.

Nordlet je računovodstveni softver razvijen s naglaskom na API (API-first). Sve što web-aplikacija radi dostupno je i putem jednog JSON API-ja. Vaša aplikacija šalje događaje, a Nordlet vodi poslovne knjige i priprema porezne prijave.

Što Nordlet radi

  • Svaku radnju izlaže kao POST /v1/{module}/{resource}/{action} s JSON tijelom, na primjer /v1/sales/invoices/create.
  • Autentificira svaki zahtjev pomoću API ključa koji pripada jednoj tvrtki. Svaki ključ sadrži ovlasti (scopes), kao što su sales:read ili sales:write, koje ograničavaju ono što može učiniti.
  • Iznose prima kao decimalne nizove znakova (decimal strings), nikada kao brojeve s pomičnim zarezom (floating-point numbers), tako da se ni jedan cent ne gubi zbog zaokruživanja.
  • Prihvaća zaglavlje Idempotency-Key za svaku promjenu. Ponovljeni zahtjev s istim ključem vraća prvi odgovor umjesto da obavlja posao dvaput. Idempotencija (idempotency) znači da ponovljeni zahtjev ima isti učinak kao i jedan zahtjev.
  • Svaku pogrešku vraća u jednom zajedničkom formatu.
  • Omogućuje 300 zahtjeva u minuti po API ključu.
  • Bilježi svaku promjenu u revizorskom tragom (audit log).

Vodič kroz API konvencije detaljno obrađuje svako od ovih pravila.

Knjige koje ostaju točne

SDK-ovi, MCP i webhookovi

  • Tipizirani SDK-ovi generiraju se iz istog OpenAPI opisa za TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift i Rust. Dok se SDK ne objavi, instalirate ga iz izvornog repozitorija. Pogledajte vodič za SDK-ove.
  • Dostupna je Postman kolekcija sa svakom krajnjom točkom (endpoint).
  • MCP poslužitelj omogućuje AI pomoćniku kao što je Claude Code pretraživanje API-ja i pozivanje s vašim API ključem. Svaki poziv je običan API zahtjev s istim ovlastima i ograničenjima.
  • Webhookovi obavještavaju vašu aplikaciju kada se nešto dogodi, na primjer sale_invoice.issued ili sale_invoice.paid. Svaka isporuka potpisana je HMAC potpisom kako biste mogli provjeriti dolazi li iz Nordleta. Neuspješne isporuke ponavljaju se otprilike 24 sata.

Testiranje s testnim (sandbox) tvrtkama

  • Stvorite tvrtku s postavkom isSandbox: true ili označite testni okvir (sandbox) prilikom postavljanja tvrtke u aplikaciji.
  • Testna tvrtka funkcionira poput prave: isti moduli, isti API.
  • Jasno je označena kao testni podatak i ne možete pravu tvrtku pretvoriti u testnu niti obratno.
  • Prijave i e-računi testne tvrtke odlaze na testne servise porezne uprave.
  • Korištenje u testnoj tvrtki mjeri se i naplaćuje isto kao i korištenje u pravoj tvrtki.

Vodič za početak rada vodi vas kroz prvi API ključ, prvi račun i cijeli ciklus.

FAQ

Može li jedna aplikacija opsluživati nekoliko tvrtki?

Da. Svaki API ključ pripada jednoj tvrtki, pa stoga izrađujete jedan ključ po tvrtki. Svaka isporuka webhooka sadrži companyId tvrtke kojoj pripada, tako da jedan primatelj može opsluživati nekoliko tvrtki.

Moram li sam izrađivati porezne prijave?

Ne. Nordlet izrađuje prijave iz poslovnih knjiga. Za svaku prijavu ili je šalje, ili izrađuje datoteku koju učitavate, ili prikazuje brojke koje sami unosite, ovisno o državi. Tablica podrške za prijave navodi svaki slučaj.

Povezano