Nordlet pre vývojárov aplikácií

Pridajte fakturáciu, účtovníctvo a daňové priznania pre EÚ do svojho softvéru prostredníctvom jedného JSON API, typovaných SDK, webhookov, MCP servera a testovacích firiem.

Mnoho aplikácií vytvára peňažné transakcie: zaplatí sa objednávka, obnoví sa predplatné, odošle sa vrátenie peňazí. Každá z týchto udalostí musí skončiť v účtovníctve firmy.

Nordlet je účtovný softvér vytvorený s dôrazom na API (API-first). Všetko, čo webová aplikácia dokáže, je dostupné aj prostredníctvom jedného JSON API. Vaša aplikácia odošle udalosti a Nordlet vedie účtovníctvo a pripravuje daňové priznania.

Čo Nordlet robí

Sprístupňuje každú akciu ako POST /v1/{module}/{resource}/{action} s JSON telom, napríklad /v1/sales/invoices/create.
Overuje každú požiadavku pomocou API kľúča, ktorý patrí jednej firme. Každý kľúč obsahuje oprávnenia (scopes), ako napríklad sales:read alebo sales:write, ktoré obmedzujú jeho možnosti.
Prijíma sumy ako desatinné reťazce, nikdy nie ako čísla s plávacou rádovou čiarkou (floating-point), takže pri zaokrúhľovaní nedochádza k strate centov.
Na každej zmene vyžaduje hlavičku Idempotency-Key. Opakovaná požiadavka s rovnakým kľúčom vráti prvú odpoveď namiesto opätovného vykonania operácie. Idempotencia znamená, že opakovaná požiadavka má rovnaký účinok ako jedna požiadavka.
Vrací každú chybu v jednom spoločnom formáte.
Umožňuje 300 požiadaviek za minútu na jeden API kľúč.
Zaznamenáva každú zmenu do protokolu auditov (audit log).

Príručka o konvenciách API podrobne opisuje každé z týchto pravidiel.

Účtovníctvo, ktoré zostáva správne

Vystavenie faktúry priradí číslo bez medzier, skontroluje, či je účtovné obdobie otvorené, a zaúčtuje účtovný zápis v rámci tej istej databázovej transakcie.
Každý účtovný zápis musí byť vyrovnaný (má byť v rovnováhe). Samotná databáza to kontroluje pri uložení transakcie.
Vystavené a zaevidované doklady nie je možné vymazať. Nesprávne priradenie platby z banky sa zruší stornovacím zápisom, nie úpravou pôvodného dokladu. To je podstata, ktorú predstavuje nemenná účtovná kniha (immutable ledger).

SDK, MCP a webhooky

Typované SDK sa generujú z toho istého popisu OpenAPI pre TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift a Rust. Kým nebude SDK zverejnené, nainštalujete ho z jeho zdrojového repozitára. Pozri príručku k SDK.
K dispozícii je kolekcia pre Postman so všetkými koncovými bodmi (endpoints).
MCP server umožňuje asistentovi umelej inteligencie, ako je Claude Code, vyhľadávať v API a volať ho pomocou vášho API kľúča. Každé volanie je bežnou požiadavkou na API s rovnakými oprávneniami a obmedzeniami.
Webhooky informujú vašu aplikáciu, keď sa niečo stane, napríklad sale_invoice.issued alebo sale_invoice.paid. Každé doručenie je podpísané podpisom HMAC, takže si môžete overiť, že pochádza z Nordletu. Neúspešné doručenia sa opätovne pokúšajú doručiť približne 24 hodín.

Testovanie pomocou testovacích firiem (sandbox)

Vytvorte firmu s nastavením isSandbox: true alebo začiarknite políčko sandbox pri vytváraní firmy v aplikácii.
Testovacia firma funguje rovnako ako skutočná: rovnaké moduly, rovnaké API.
Je zreteľne označená ako testovacie dáta a skutočnú firmu nemožno premeniť na testovaciu ani naopak.
Priznania a elektronické faktúry testovacej firmy smerujú do testovacích služieb úradov.
Používanie v testovacej firme sa meria a fakturuje rovnako ako používanie v skutočnej firme.

Príručka pre začiatok používania vás provodí vytvorením prvého API kľúča, vystavením prvej faktúry a celým cyklom.

FAQ

Môže jedna aplikácia obsluhovať viacero firiem?

Áno. Každý API kľúč patrí jednej firme, takže pre každú firmu vytvoríte samostatný kľúč. Každá správa z webhooku obsahuje identifikátor companyId firmy, ktorej sa týka, takže jeden prijímač môže obsluhovať viaceré firmy.

Musím si daňové priznania pripravovať sám?

Nie. Nordlet zostavuje priznania z účtovníctva. V závislosti od krajiny buď priznanie odošle, pripraví súbor na nahranie, alebo zobrazí údaje, ktoré sami zadáte. Tabuľka podpory daňových priznaní uvádza prehľad pre jednotlivé prípady.