Účetní software s rozhraním API

Celá platforma Nordlet je dostupná prostřednictvím jednoho rozhraní JSON API, které nabízí SDK, webhooky, idempotentní opakování požadavků a server MCP pro asistenty s umělou inteligencí.

Rozhraní API (application programming interface) slouží ke komunikaci mezi programy. Účetní API umožňuje vašemu vlastnímu softwaru vystavovat faktury, evidovat platby a číst sestavy, aniž by musel kdokoli proklikávat obrazovky.

Nordlet je účetní software, jehož hlavním vstupním bodem je právě API. Vše, co dokáže webová aplikace, je dostupné přes stejné rozhraní JSON API. Tato stránka je určena vývojářům a lidem, kteří rozhodují o tom, s čím se jejich produkt propojí.

Co Nordlet dokáže

Jednotná podoba požadavků. Každé volání má podobu POST /v1/{module}/{resource}/{action} s tělem ve formátu JSON, například sales/invoices/create nebo bank/transactions/match.
Klíče API s oprávněními (scopes). Každý klíč patří jedné firmě a nese oprávnění jako sales:read nebo bank:write. Klíč bez potřebného oprávnění obdrží odpověď 403.
Peníze jako text. Částky jsou desetinné řetězce s až 4 desetinnými místy, nikdy ne plovoucí řádková čísla (floating-point numbers), takže kvůli zaokrouhlování nedochází ke ztrátě centů.
Jednotný formát chyb. Každá chyba má stejný obal (envelope) obsahující kód, zprávu a identifikátor požadavku.
Sdílené dotazy pro seznamy. Každé volání akce list přijímá stejná pole pro stránkování, řazení a filtry a dokáže vracet součty.
Skutečná účetní pravidla. Účetní zápisy musejí být vyrovnané, číslování dokladů nesmí obsahovat mezery a uzamčené účetní období odmítne nové zaúčtování odpovědí 409. Každá změna se zapisuje do protokolu změn (audit log).

Bezpečné opakování požadavků díky idempotenci

Síť může selhat poté, co byl váš požadavek zpracován, ale ještě předtím, než obdržíte odpověď. Opakování požadavku by pak mohlo vytvořit stejnou fakturu dvakrát. Idempotence znamená, že opakovaný požadavek má stejný účinek jako ten první.

K libovolnému volání, které mění data, přidejte hlavičku Idempotency-Key.
Při opakování požadavku se stejným klíčem a stejným tělem získáte zpět uloženou odpověď doplněnou o hlavičku x-idempotent-replay: true.
Použití stejného klíče s odlišným tělem bude odmítnuto.
Klíče se uchovávají po dobu 24 hodin.

Webhooky

Webhook je zpráva, kterou Nordlet odešle na váš server, jakmile v systému dojde k události, například sale_invoice.paid.

Události se zapisují v rámci stejné databázové transakce jako samotná změna, takže zrušená (rolled back) změna žádnou událost neodešle.
Každé doručení je podepsáno pomocí HMAC-SHA256 s použitím vašeho tajného klíče předplatného, což vám umožňuje ověřit, že zpráva pochází z Nordletu.
Neúspěšné doručení se opakuje zhruba po dobu 24 hodin. Zprávu můžete odeslat znovu také ručně.
Odběry (subscriptions) se spravují v sekci Account → Webhooks nebo prostřednictvím API.

Nástroje pro vývojáře

Dokumentace API (API reference). Interaktivní dokumentace API vytvořená na základě popisu OpenAPI, doplněná o kolekci pro Postman.
Sady SDK. Typově bezpeční klienti pro TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift a Rust, vygenerovaní ze stejného popisu. Projděte si příručku k SDK.
Server MCP. Asistenti s umělou inteligencím jako Claude mohou vyhledávat v API a volat ho pomocí vašeho klíče API. Podívejte se do příručky k serveru MCP.
Testovací firmy (Sandbox companies). Testovací firma funguje stejně jako reálná, je označena jako testovací data a hlášení i elektronické faktury odesílá výhradně na testovací koncové body úřadů.
Omezení četnosti požadavků (Rate limit). 300 požadavků za minutu na jeden klíč API, přičemž hlavičky ukazují aktuální zbývající limit.

FAQ

Co všechno mohu provádět prostřednictvím API?

Úplně všechno, co produkt nabízí: fakturaci, nákupy, hlavní knihu, párování plateb, skladové hospodářství, majetek, mzdy, výkazy a hlášení pro úřady. Průvodce pro začátek práce vás provede celým cyklem od faktury až po údaje pro DPH.

Mohu integrovat účetnictví přímo do svého vlastního produktu?

Ano. Každá firma v Nordletu má vlastní účetní knihy a váš software s nimi pracuje prostřednictvím příslušného klíče API. API neobsahuje žádné volání, které by upravovalo nebo mazalo již zaúčtovaný účetní zápis. Oprava se provádí formou nového zápisu, což zachovává neměnnou účetní knihu.