Raamatupidamistarkvara koos API-liidesega

Nordleti iga osa on kättesaadav ühe JSON API kaudu, mida toetavad SDK-d, veebikonksud (webhooks), idempotentse kordamise võimalus ja MCP-server tehisintellekti abimeeste jaoks.

API (rakenduse programmeerimisliides) on viis, kuidas üks programm saab teisega suhelda. Raamatupidamise API võimaldab teie tarkvaral luua arveid, kajastada laekumisi ja lugeda aruandeid ilma, et inimene peaks ekraanidel klikkima.

Nordlet on raamatupidamistarkvara, mille peamiseks sissepääsuks on API. Kõik veebirakenduse funktsioonid on kättesaadavad sama JSON API kaudu. See leht on mõeldud arendajatele ja neile, kes otsustavad, millega nende toode integreerub.

Mida Nordlet teeb

Ühtne päringu vorming. Iga päring on kujul POST /v1/{module}/{resource}/{action ja sisaldab JSON-korpust, näiteks sales/invoices/create või bank/transactions/match.
Õigustega (scopes) API-võtmed. Iga võti kuulub ühele ettevõttele ja sellel on kindlad õigused, näiteks sales:read või bank:write. Ilma vajaliku õiguseta päringu korral tagastatakse vastus 403.
Raha tekstina. Summad on kuni 4 kümnendkohaga kümnendarvud tekstina, mitte kunagi ujukomaarvud, mistõttu ei lähe ümmardamise tõttu senti kaduma.
Ühtne veavorming. Igal veal on sama ümbris, mis sisaldab koodi, teadet ja päringu ID-d.
Ühised loendipäringud. Iga list-päring kasutab samu leheküljelise jaotuse, sortimise ja filtreerimise välju ning võib tagastada koondsummasid.
Reaalsed raamatupidamisreeglid. Kanded peavad olema tasakaalus, dokumentide numbrid ei tohi sisaldada lünki ning lukustatud raamatupidamisperiood lükkab uued kanded tagasi vastusega 409. Kõik muudatused salvestatakse auditijälge (audit log).

Turvalised korduskatsed identsustagusega (idempotency)

Võrk võib katkeda pärast seda, kui teie päring on töödeldud, kuid enne, kui olete vastuse kätte saanud. Kordamine võib sel juhul luua sama arve topelt. Idempotentsus tähendab, et korduv päring annab sama tulemuse kui esimene.

Lisage andmeid muutvale päringule päis Idempotency-Key.
Sama võtme ja sama sisuga korduspäring tagastab salvestatud vastuse koos päisega x-idempotent-replay: true.
Sama võti erineva sisuga lükatakse tagasi.
Võtmeid säilitatakse 24 tundi.

Veebikonksud (webhooks)

Veebikonks on teade, mille Nordlet saadab teie serverisse teatud sündmuse (näiteks sale_invoice.paid) toimumisel.

Sündmused kirjutatakse samasse andmebaasitehingusse muudatusega, mistõttu tagasipööratud (rollbacked) muudatus sündmust ei saada.
Iga edastus on allkirjastatud HMAC-SHA256 algoritmiga, kasutades teie liitumissaladust (subscription secret), mis võimaldab kontrollida, et teade pärineb Nordletist.
Ebaõnnestunud edastust korratakse ligikaudu 24 tunni jooksul. Saate selle ka käsitsi uuesti saata.
Tellimusi hallatakse jaotises Konto → Veebikonksud või API kaudu.

Tööriistad arendajale

API viide. Interaktiivne API viide, mis on loodud OpenAPI kirjelduse põhjal, koos Postmani kollektsiooniga.
SDK-d. Tüübistatud kliendid keelte TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift ja Rust jaoks, mis on genereeritud sama kirjelduse alusel. Vaadake SDK-de juhendit.
MCP-server. Tehisintellekti abimehed, nagu Claude, saavad teie API-võtme abil API-st otsinguid teha ja päringuid käivitada. Vaadake MCP-serveri juhendit.
Testkeskkond (sandbox). Testettevõte toimib nagu päris ettevõte, on märgistatud testandmetena ning saadab aruandeid ja e-arveid ainult ametiasutuste testotsapunktidesse.
Päringupiirang (rate limit). 300 päringut minutis API-võtme kohta, päised näitavad allesolevat limiiti.

FAQ

Mida ma saan API kaudu teha?

Kõike tootes leiduvat: arveldust, oste, pearaamatut, pangatehingute sidumist, laoseisu, põhivarasid, palgaarvestust, aruandeid ja riiklikke aruandeid. Alustamise juhend teeb läbi täieliku tsükli arvest käibemaksuandmeteni.

Kas ma saan raamatupidamise oma tootesse sisse ehitada?

Jah. Igal Nordleti ettevõttel on oma raamatupidamine ja teie tarkvara töötab sellega oma API-võtme kaudu. API ei sisalda ühtegi käsku, mis muudaks või kustutaks juba sisestatud kande. Parandus on uus kanne, mis tagab muutumatu pearaamatu säilimise.