Nordlet

← All features

Nordlet za razvijalce aplikacij

Dodajte izdajanje računov, knjigovodstvo in oddajo davčnih obračunov v EU svoji programski opremi prek enega JSON vmesnika API, tipiziranih SDK-jev, spletnih kljuk (webhooks), strežnika MCP in testnih družb (sandbox).

Številne aplikacije ustvarjajo finančne dogodke: plačilo naročila, obnovo naročnine, vračilo kupnine. Vsak od teh dogodkov mora končati v poslovnih knjigah podjetja.

Nordlet je računovodska programska oprema, zasnovana z mislijo na vmesnik API. Vse, kar zmore spletna aplikacija, je na voljo tudi prek enega JSON vmesnika API. Vaša aplikacija pošilja dogodke, Nordlet pa vodi knjige in pripravlja davčne obračune.

Kaj počne Nordlet

  • Vsako dejanje izpostavi kot POST /v1/{module}/{resource}/{action} s telesom v formatu JSON, na primer /v1/sales/invoices/create.
  • Vsak zahtevek overi s ključem API, ki pripada določeni družbi. Vsak ključ vsebuje pooblastila (scopes), kot sta sales:read ali sales:write, ki omejujejo njegova dejanja.
  • Zneske sprejema kot desetiške nize, nikoli kot števila s plavajočo vejico, zato se pri zaokroževanju ne izgubi noben cent.
  • Na vsako spremembo sprejme glavo Idempotency-Key. Ponovni poskus z istim ključem vrne prvi odgovor, ne da bi delo opravil dvakrat. Idempotenca (idempotency) pomeni, da ima ponovljeni zahtevek enak učinek kot en sam zahtevek.
  • Vsako napako vrne v enem skupnem formatu.
  • Omogoča 300 zahtevkov na minuto na posamezen ključ API.
  • Vsako spremembo zabeleži v revizijski sledi.

Vodič po konvencijah vmesnika API podrobno obravnava vsako od teh pravil.

Knjige, ki ostanejo točne

Kompleti SDK, strežnik MCP in spletne kljuke

  • Tipizirani kompleti SDK za TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift in Rust so generirani iz istega opisa OpenAPI. Dokler komplet SDK ni objavljen, ga namestite iz njegovega izvornega skladišča. Oglejte si vodič po kompletih SDK.
  • Na voljo je zbirka za Postman, ki vključuje vse končne točke.
  • Strežnik MCP omogoča, da pomočnik z umetno inteligenco, kot je Claude Code, preišče vmesnik API in ga kliče z vašim ključem API. Vsak klic je običajen zahtevek API z enakimi pooblastili in omejitvami.
  • Spletne kljuke (webhooks) vašo aplikacijo obvestijo, ko se nekaj zgodi, na primer sale_invoice.issued ali sale_invoice.paid. Vsak prenos je podpisan s podpisom HMAC, kar vam omogoča preverjanje, da prihaja iz Nordleta. Neuspešni prenosi se ponavljajo približno 24 ur.

Testiranje s testnimi družbami

  • Ustvarite družbo z vrednostjo isSandbox: true ali pa ob nastavitvi družbe v aplikaciji označite testno polje.
  • Testna družba deluje kot prava: enaki moduli, enak vmesnik API.
  • Jasno je označena kot testni podatek, prave družbe pa ni mogoče spremeniti v testno ali obratno.
  • Obračuni in e-računi (e-invoice) testne družbe se pošiljajo v testne storitve uprav.
  • Uporaba v testni družbi se meri in zaračunava tako kot uporaba v pravi družbi.

Vodič za začetek uporabe vas popelje skozi pridobitev prvega ključa API, izdajo prvega računa in celoten cikel.

FAQ

Ali lahko ena aplikacija podpira več družb?

Da. Vsak ključ API pripada eni družbi, zato ustvarite en ključ na družbo. Vsak prenos prek spletnih kljuk vsebuje identifikator companyId družbe, ki ji pripada, tako da lahko en sprejemnik obslužuje več družb.

Ali moram davčne obračune pripraviti sam?

Ne. Nordlet sestavi obračune na podlagi poslovnih knjig. Glede na posamezno državo obračun bodisi samodejno pošlje, pripravi datoteko za nalaganje ali prikaže podatke, ki jih vnesete ročno. Tabela podpore za obračune navaja vse primere.

Povezane vsebine