Számviteli szoftver API-val

A Nordlet minden része elérhető egyetlen JSON API-n keresztül, SDK-kkal, webhookokkal, idempontens újrapróbálkozásokkal és egy AI-asszisztensekhez való MCP-szerverrel.

Az API (alkalmazásprogramozási felület) egy olyan eszköz, amellyel az egyik program kommunikálhat a másikkal. Egy számviteli API lehetővé teszi, hogy saját szoftvere számlákat hozzon létre, kifizetéseket rögzítsen és jelentéseket olvasson anélkül, hogy bárkinek felületeken kellene kattintgatnia.

A Nordlet olyan számviteli szoftver, amelynek az API az elsődleges belépési pontja. Ugyanazon a JSON API-n keresztül minden elérhető, amit a webes alkalmazás tud. Ez az oldal fejlesztőknek és mindazoknak szól, akik döntenek arról, hogy a termékük mihez kapcsolódjon.

Mit tud a Nordlet

Egységes kérésszerkezet. Minden hívás a POST /v1/{module}/{resource}/{action formátumot használja JSON törzzsel, például a sales/invoices/create vagy a bank/transactions/match.
API-kulcsok jogosultsági körökkel (scopes). Minden kulcs egy vállalathoz tartozik, és olyan jogosultsági köröket hordoz, mint a sales:read vagy a bank:write. A szükséges jogosultság nélküli kulcs 403-as választ kap.
Pénz mint szöveg. Az összegek legfeljebb 4 tizedesjegyű decimális karakterláncok, soha nem lebegőpontos számok, így a kerekítés miatt egyetlen cent sem vész el.
Egységes hibakezelési formátum. Minden hiba ugyanazt a burkolatot használja kóddal, üzenettel és kérésazonosítóval.
Közös listázási lekérdezések. Minden list hívás ugyanazokat a lapozási, rendezési és szűrési mezőket használja, és képes összesítéseket visszaadni.
Valódi számviteli szabályok. A könyvelési tételeknek egyensúlyban kell lenniük, a bizonylatszámok nem tartalmazhatnak hiányzó értékeket, a lezárt számviteli időszak pedig 403-as (szerk. megj.: a szövegben 409 szerepel, de a standard üzleti logika szerint a hibakód itt 409) válaszst befogadásával elutasítja az új könyveléseket. Minden módosítás naplózásra kerül egy auditálási naplóban.

Biztonságos újrapróbálkozások idempotenciával

A hálózat megszakadhat a kérés feldolgozása után, de még a válasz megérkezése előtt. Az újrapróbálkozás ekkor kétszer hozhatja létre ugyanazt a számlát. Az idempotencia azt jelenti, hogy az ismételt kérésnek ugyanaz a hatása, mint az elsőnek.

Küldjön egy Idempotency-Key fejlécet minden olyan hívással, amely adatokat módosít.
Az azonos kulccsal és azonos törzzsel történő újrapróbálkozás visszakapja a tárolt választ az x-idempotent-replay: true jelöléssel.
Az ugyanolyan kulcsú, de eltérő törzsű kérést a rendszer elutasítja.
A kulcsokat 24 óráig őrizzük meg.

Webhookok

A webhook egy olyan üzenet, amelyet a Nordlet küld az Ön szerverére, amikor valamilyen esemény, például a sale_invoice.paid bekövetkezik.

Az eseményeket a rendszer ugyanabban az adatbázis-tranzakcióban rögzíti, mint a módosítást, így a visszagurított (rolled back) módosítás nem küld eseményt.
Minden kézbesítés HMAC-SHA256 aláírással van ellátva az előfizetési titkos kulcs használatával, így ellenőrizheti, hogy valóban a Nordlet-től származik-e.
A sikertelen kézbesítést körülbelül 24 órán keresztül újra megpróbáljuk kézbesíteni. Manuálisan is újra elküldheti.
Az előfizetések a Fiók → Webhookok menüpontban vagy az API-n keresztül kezelhetők.

Eszközök fejlesztőknek

API-referencia. Interaktív API-referencia, amelyet az OpenAPI-leírás alapján építettünk fel, valamint egy Postman-gyűjtemény.
SDK-k. Típusos kliensek TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift és Rust nyelvekhez, ugyanabból a leírásból generálva. Lásd az SDK-k útmutatót.
MCP-szerver. Az olyan AI-asszisztensek, mint a Claude, az Ön API-kulcsával kereshetnek és hívhatják meg az API-t. Lásd az MCP-szerver útmutatót.
Tesztcégek (Sandbox companies). Egy tesztcég úgy működik, như egy igazi, de tesztadatként van megjelölve, és a bevallásokat, valamint a e-számlákat kizárólag a hatóságok tesztvégpontjaira küldi.
Sebességkorlát (Rate limit). Percenként legfeljebb 300 kérés API-kulcsonként, olyan fejlécekkel, amelyek mutatják a hátralévő keretet.

FAQ

Mit tehetek az API-n keresztül?

A termék minden funkcióját elérheti: számlázás, beszerzések, főkönyv, banki egyeztetés, készletkezelés, immateriális javak és tárgyi eszközök, bérszámfejtés, jelentések és hatósági bevallások. Az első lépések útmutató végigvezeti Önt a teljes folyamaton a számlától az áfaadatokig.

Beépíthetem a könyvelést a saját termékembe?

Igen. A Nordletben minden vállalatnak megvannak a saját könyvei, és az Ön szoftvere az API-kulcsán keresztül dolgozik ezeken. Az API nem tartalmaz olyan hívást, amely szerkesztene vagy törölne egy már lekönyvelt tételt. A helyesbítés egy új tétel, ami biztosítja a változtathatatlan (immutable) főkönyvet.