Účtovný softvér s rozhraním API

Každá časť systému Nordlet je dostupná prostredníctvom jedného rozhrania JSON API, ktoré obsahuje súpravy SDK, webhooky, idempotentné opakovania a server MCP pre AI asistentov.

Rozhranie API (application programming interface) slúži na vzájomnú komunikáciu medzi programami. Účtovné rozhranie API umožňuje vášmu softvéru vytvárať faktúry, zaznamenávať platby a čítať výkazy bez toho, aby musel človek klikadť v používateľskom rozhraní.

Nordlet je účtovný softvér, v ktorom je rozhranie API hlavným spôsobom prístupu. Všetko, čo webová aplikácia dokáže, je dostupné cez to isté rozhranie JSON API. Táto stránka je určená pre vývojárov a pre ľudí, ktorí rozhodujú o tom, s čím sa ich produkt prepojí.

Čo Nordlet dokáže

Jednotný tvar požiadaviek. Každé volanie má podobu POST /v1/{module}/{resource}/{action} s telom vo formáte JSON, napríklad sales/invoices/create alebo bank/transactions/match.
Kľúče API so zónami pôsobnosti (scopes). Každý kľúč patrí jednej spoločnosti a nesie zóny pôsobnosti, ako napríklad sales:read alebo bank:write. Kľúč bez potrebnej zóny pôsobnosti dostane odpoveď 403.
Peniaze ako text. Sumy sú desatinné reťazce s najviac 4 desatinnými miestami, nikdy nie čísla s plávacou rádovou čiarkou, takže zaokrúhľovaním sa nestratia žiadne centy.
Jednotný formát chýb. Každá chyba má rovnakú štruktúru obsahujúcu kód, správu a identifikátor požiadavky.
Zdieľané dopyty na zoznamy. Každé volanie typu list prijíma rovnaké polia pre stránkovanie, zoraďovanie a filtre a dokáže vrátiť súčty.
Reálne účtovné pravidlá. Účtovné zápisy musia byť v rovnováhe, čísla dokladov nesmú mať medzery a uzatvorené účtovné obdobie odmietne nové zaúčtovanie s odpoveďou 409. Každá zmena sa zapisuje do denníka auditu (audit log).

Bezpečné opakovanie vďaka idempotencii

Sieť môže zlyhať po tom, čo bola vaša požiadavka spracovaná, ale predtým, ako ste dostali odpoveď. Opakované odoslanie by potom mohlo vytvoriť tú istú faktúru dvakrát. Idempotencia znamená, že opakovaná požiadavka má rovnaký účinok ako tá prvá.

Do každej požiadavky, ktorá mení dáta, pošlite hlavičku Idempotency-Key.
Opakovaná požiadavka s rovnakým kľúčom a rovnakým telom vráti uloženú odpoveď spolu s hlavičkou x-idempotent-replay: true.
Rovnaký kľúč s iným telom bude zamietnutý.
Kľúče sa uchovávajú 24 hodín.

Webhooky

Webhook je správa, ktorú Nordlet odošle na váš server, keď nastane určitá udalosť, napríklad sale_invoice.paid.

Udalosti sa zapisujú v rámci tej istej databázovej transakcie ako zmena, takže zmena, ktorá sa vráti späť (rollback), neodošle žiadnu udalosť.
Každé doručenie je podpísané pomocou HMAC-SHA256 s použitím tajného kľúča vášho odberu, takže si môžete overiť, že pochádza zo systému Nordlet.
Neúspešné doručenie sa opakovane pokúša odoslať počas približne 24 hodín. Môžete ho odoslať aj manuálne.
Odbery sa spravujú v časti Účet → Webhooky alebo prostredníctvom rozhrania API.

Nástroje pre vývojárov

Referenčná príručka API. Interaktívna referenčná príručka API vytvorená na základe popisu OpenAPI a kolekcia pre Postman.
Súpravy SDK. Typovov bezpečné klienty pre jazyky TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift a Rust, vygenerované z rovnakého popisu. Pozrite si príručku pre SDK.
Server MCP. AI asistenti ako Claude môžu vyhľadávať v rozhraní API a volať ho pomocou vášho kľúča API. Pozrite si príručku pre server MCP.
Testovacie spoločnosti (sandbox). Testovacia spoločnosť funguje rovnako ako reálna, je označená ako testovacie dáta a výkazy či elektronické faktúry odosiela iba na testovacie koncové body úradov.
Obmedzenie počtu požiadaviek (rate limit). 300 požiadaviek za minútu na jeden kľúč API s hlavičkami, ktoré ukazujú zostávajúci limit.

Často kladené otázky

Čo môžem robiť prostredníctvom rozhrania API?

Všetko v produkte: fakturáciu, nákupy, hlavnú knihu, párovanie platieb v banke, zásoby, majetok, mzdy, výkazy a výkazy pre štátne orgány. Príručka pre začiatok práce vás provádza celým cyklom od faktúry až po údaje k DPH.

Môžem zabudovať účtovníctvo do svojho vlastného produktu?

Áno. Každá spoločnosť v systéme Nordlet má svoje vlastné účtovníctvo a váš softvér s ním pracuje prostredníctvom svojho kľúča API. Rozhranie API neobsahuje žiadne volanie, ktoré by upravovalo alebo mazalo zaúčtovaný účtovný zápis. Oprava sa vykonáva vytvorením nového zápisu, čím sa zachováva nemenná účtovná kniha.