Nordlet alkalmazásfejlesztőknek

Számlázási, könyvelési és EU-s adóbevallási funkciók integrálása a szoftverébe egyetlen JSON API-n, típusos SDK-kon, webhookokon, MCP-szerveren és tesztcégeken keresztül.

Számos alkalmazás hoz létre pénzügyi eseményeket: kifizetnek egy rendelést, megújul egy előfizetés, vagy visszatérítést indítanak. Ezeknek az eseményeknek egytől egyig be kell kerülniük a cég könyveibe.

A Nordlet egy olyan könyvelőprogram, amelyet kifejezetten az API-központúság jegyében terveztek. A webes alkalmazás minden egyes funkciója elérhető egyetlen JSON API-n keresztül is. Az Ön alkalmazása elküldi az eseményeket, a Nordlet pedig vezeti a könyveket, és elkészíti az adóbevallásokat.

Mit tud a Nordlet?

Minden műveletet a POST /v1/{module}/{resource}/{action} formátumban tesz közzé JSON törzzsel, például a /v1/sales/invoices/create végponton keresztül.
Minden kérést egy adott céghez tartozó API-kulccsal hitelesít. Minden kulcshoz olyan hatáskörök (scopes) tartoznak, mint a sales:read vagy a sales:write, amelyek korlátozzák a végrehajtható műveleteket.
Az összegeket tizedesjegyeket tartalmazó karakterláncként (string) kezeli, soha nem lebegőpontos számként, így a kerekítés miatt egyetlen cent sem vész el.
Minden módosító kérésnél elfogad egy Idempotency-Key fejlécet. Az ugyanezzel a kulccsal megismételt kérés a munkálatok megismétlése helyett az első választ adja vissza. Az idempotencia azt jelenti, hogy egy megismételt kérésnek ugyanaz a hatása, mint egyetlen kérésnek.
Minden hibát egy egységes, közös formátumban ad vissza.
API-kulcsonként percenként legfeljebb 300 kérést engedélyez.
Minden módosítást rögzít egy naplófájlban (audit log).

Ezeket a szabályokat részletesen az API-konvenciók útmutatója ismerteti.

Könyvelés, amely mindig pontos

A számla kiállítása résmentes sorszámot rendel a számlához, ellenőrzi, hogy a könyvelési időszak nyitva van-e, és ugyanezen adatbázis-tranzakción belül könyveli a könyvelési tételt.
Minden könyvelési tételnek egyensúlyban kell lennie. Ezt maga az adatbázis ellenőrzi a tranzakció mentésekor.
A kiállított és rögzített dokumentumok nem törölhetők. A hibás banki párosítást egy sztornó tétellel kell jóvátenni, nem a régi tétel szerkesztésével. Ez a lényege a változthatatlan főkönyvnek.

SDK-k, MCP és webhookok

TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift és Rust nyelvekhez ugyanebből az OpenAPI-leírásból generálnak típusos SDK-kat. Amíg egy SDK megjelenik a csomagkezelőben, a forráskód-tárhelyéről kell telepíteni. Lásd az SDK-k útmutatóját.
Rendelkezésre áll egy Postman-gyűjtemény, amely az összes végpontot tartalmazza.
Az MCP-szerver lehetővé teszi, hogy egy olyan AI-asszisztens, mint a Claude Code, átkutassa az API-t, és az Ön API-kulcsával meghívja azt. Minden hívás egy szokásos API-kérésnek felel meg, ugyanazokkal a hatáskörökkel és korlátozásokkal.
A webhookok értesítik az alkalmazását, ha valamilyen esemény történik, például a sale_invoice.issued vagy a sale_invoice.paid esetén. Minden egyes kézbesítést HMAC-aláírással látnak el, így ellenőrizheti, hogy azok valóban a Nordlettől származnak-e. A sikertelen kézbesítéseket körülbelül 24 órán keresztül újra megpróbálják elküldeni.

Tesztelés tesztcégekkel

Hozzon létre egy céget az isSandbox: true paraméterrel, vagy jelölje be a tesztcégre vonatkozó jelölőnégyzetet, amikor céget hoz létre az alkalmazásban.
Egy tesztcég ugyanúgy működik, mint egy igazi: ugyanazok a modulok, ugyanaz az API.
Világosan jelölve van tesztadatként, és egyvalódi céget nem lehet tesztcéggé alakítani, vagy fordítva.
Egy tesztcég bevallásai és elektronikus számlái a hatóságok tesztszolgáltatásaiba futnak be.
A tesztcégek használatának mérése és számlázása megegyezik a valós cégekével.

A kezdeti lépések útmutatója végigvezeti az első API-kulcs igénylésén, az első számla kiállításán és a teljes folyamaton.

FAQ

Kiszolgálhat egyetlen alkalmazás több céget is?

Igen. Minden API-kulcs egyetlen céghez tartozik, így cégenként kell létrehoznia egy kulcsot. Minden webhook-kézbesítés tartalmazza annak a cégnek a companyId azonosítóját, amelyhez tartozik, így egyetlen fogadóalkalmazás több céget is kiszolgálhat.

Nekem kell elkészítenem az adóbevallásokat?

Nem. A Nordlet a könyvelési adatok alapján állítja össze a bevallásokat. Országtól függően az adott bevallást vagy elküldi, vagy elkészíti a feltöltendő fájlt, vagy megjeleníti azokat az adatokat, amelyeket Önnek kell beírnia. Az egyes eseteket a bevallási támogatási táblázat sorolja fel.