Apskaitos programa su API

Kiekviena Nordlet dalis pasiekiama per vieną JSON API su programinės įrangos kūrimo rinkiniais (SDK), saito užklausomis (webhooks), idempotiniais pakartojimais ir MCP serveriu dirbtinio intelekto padėjėjams.

API (programinė sąsaja) yra būdas, leidžiantis vienai programai susisiekti su kita. Apskaitos API suteikia galimybę jūsų programinei įrangai kurti sąskaitas faktūras, registruoti mokėjimus ir skaityti ataskaitas be būtinybės naudotojui spragsėti per ekranus.

Nordlet yra apskaitos programa, kurios pagrindinis įėjimo taškas yra API. Viskas, ką daro žiniatinklio programa, yra pasiekiama per tą patį JSON API. Šis puslapis skirtas kūrėjams ir tiems, kurie sprendžia, prie ko turėtų jungtis jų produktas.

Ką daro Nordlet

Vienoda užklausos struktūra. Kviečiama naudojant formatą POST /v1/{module}/{resource}/{action} su JSON pagrindine dalimi (body), pavyzdžiui, sales/invoices/create arba bank/transactions/match.
API raktai su teisėms (scopes). Kiekvienas raktas priklauso vienai įmonei ir turi tam tikras teises, tokias kaip sales:read arba bank:write. Raktas be reikalingos teisės gauna 403 atsakymą.
Pinigų sumos kaip tekstas. Sumos yra dešimtainės eilutės (decimal strings) su iki 4 skaitmenų po kablelio, niekada nenaudojant slankiojo kablelio skaičių, todėl apvalinant nepranyksta jokie centai.
Vienodas klaidų formatas. Kiekviena klaida pateikiama tame pačiame apvalkale su kodu, pranešimu ir užklausos ID.
Bendra sąrašų užklausų sistema. Bet kuri list užklausa priima tuos pačius puslapiavimo, rūšiavimo ir filtravimo laukus bei gali grąžinti bendras sumas.
Tikros apskaitos taisyklės. Ūkinės operacijos įrašai (žurnalo įrašai) privalo sutapti, dokumentų numeriai neturi turėti tarpų, o užrakintas apskaitos laikotarpis atmeta naujus įrašus grąžindamas 409 atsakymą. Kiekvienas pakeitimas įrašomas į auditavimo žurnalą.

Saugūs pakartojimai užtikrinant idempotenciją

Tinklas gali sutrikti po to, kai jūsų užklausa buvo apdorota, bet dar prieš gaunant atsakymą. Pakartojus užklausą, ta pati sąskaita faktūra galėtų būti sukurta du kartus. Idempotencija reiškia, kad pakartota užklausa turi tokį patį poveikį kaip ir pirmoji.

Siųskite Idempotency-Key antraštę su bet kuria užklausą, kuri keičia duomenis.
Pakartotina užklausa su tuo pačiu raktu ir tuo pačiu turiniu gauna išsaugotą atsakymą atgal kartu su x-idempotent-replay: true antrašte.
Toks pat raktas su kitu turiniu yra atmetamas.
Raktai saugomi 24 valandas.

Saitų užklausos (webhooks)

Saito užklausa (webhook) yra pranešimas, kurį Nordlet išsiunčia į jūsų serverį, kai kažkas įvyksta, pavyzdžiui, kai sumokama sąskaita faktūra (sale_invoice.paid).

Įvykiai įrašomi į tą pačią duomenų bazės operaciją (transakciją) kaip ir pakeitimas, todėl atšauktas pakeitimas neišsiunčia jokio įvykio.
Kiekvienas pristatymas pasirašomas naudojant HMAC-SHA256 ir jūsų prenumeratos paslaptį, todėl galite patikrinti, kad pranešimas tikrai gautas iš Nordlet.
Nepavykęs pristatymas pakartotinai bandomas apie 24 valandas. Taip pat galite jį išsiųsti iš naujo rankiniu būdu.
Prenumeratos valdomos per Account → Webhooks arba per API.

Įrankiai kūrėjams

API žinynas (reference). Interaktyvus API žinynas, sukurtas remiantis OpenAPI aprašu, kartu su Postman rinkiniu.
SDK. Tipizuoti kliento komponentai, skirti TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift ir Rust kalboms, sugeneruoti iš to paties aprašo. Žr. SDK vadovą.
MCP serveris. Dirbtinio intelekto padėjėjai, tokie kaip Claude, gali ieškoti ir kviesti API naudodami jūsų API raktą. Žr. MCP serverio vadovą.
Smėlio dėžės (sandbox) įmonės. Testinė įmonė veikia kaip tikra, yra pažymėta kaip testiniai duomenys ir siunčia ataskaitas bei e. sąskaitas faktūras tik administratorių testiniams galiniams punktams.
Užklausų dažnio ribojimas (rate limit). 300 užklausų per minutę vienam API raktui, pateikiant antraštes, kurios rodo likutį.

D.U.K.

Ką galiu padaryti per API?

Viską, kas yra programoje: sąskaitų faktūrų išrašymą, pirkimus, didžiąją knygą, banko išrašų sudengimą, atsargas, turtą, darbo užmokestį, ataskaitas ir teikimą valstybinėms institucijoms. Pradmenų vadovas nuosekliai supažindina su visu ciklu nuo sąskaitos faktūros iki PVM rodiklių.

Ar galiu integruoti apskaitą į savo produktą?

Taip. Kiekviena įmonė Nordlet sistemoje turi savo apskaitos knygas, o jūsų programinė įranga su jomis dirba per savo API raktą. API neturi jokio kvietimo, kuris redaguotų arba ištrintų užregistruotą ūkinės operacijos įrašą. Pataisymas yra naujas įrašas, kuris užtikrina nekintamą žurnalą.