Grāmatvedības programmatūra ar API

Visas Nordlet daļas ir pieejamas, izmantojot vienu JSON API, komplektā ar SDK, tīmekļa āķiem (webhooks), idempotentas atkārtotas izpildes iespēju un MCP serveri mākslīgā intelekta palīgiem.

API (lietojumprogrammu saskarne) ir veids, kā viena programma sazinās ar citu. Grāmatvedības API ļauj jūsu programmatūrai izrakstīt rēķinus, reģistrēt maksājumus un nolasīt pārskatus, pašam lietotājam nepārlūkojot ekrānus.

Nordlet ir grāmatvedības programmatūra, kurā API ir galvenais piekļuves veids. Viss, ko dara tīmekļa lietotne, ir pieejams, izmantojot to pašu JSON API. Šī lapa ir paredzēta izstrādātājiem un lēmumu pieņēmējiem, kuri lemj, ar ko savienot savu produktu.

Ko dara Nordlet

Viena pieprasījuma struktūra. Katrs izsaukums ir POST /v1/{module}/{resource}/{action} ar JSON pamattekstu, piemēram, sales/invoices/create vai bank/transactions/match.
API atslēgas ar piekļuves tiesībām (scopes). Katra atslēga pieder vienam uzņēmumam un ietver tādas tiesības kā sales:read vai bank:write. Atslēga bez nepieciešamajām tiesībām saņem 403 atbildi.
Naudas summas kā teksts. Summas ir decimāldaļskaitļu virknes ar ne vairāk kā 4 decimāldaļām, nekad peldošā komata skaitļi, tāpēc noapaļošanas dēļ neviens cents nepazūd.
Viens kļūdu formāts. Katrai kļūdai ir vienāds ietvars ar kodu, ziņojumu un pieprasījuma ID.
Kopīgi sarakstu vaicājumi. Katrs list izsaukums izmanto tos pašus lapošanas, kārtošanas un filtru laukus, un tas var atgriezt kopsavsummas.
Reāli grāmatvedības noteikumi. Grāmatojumiem ir jāsabalansē, dokumentu numuros nedrīkst būt pārtraukumu, un slēgts grāmatvedības periods jaunu ierakstu grāmatošanu noraida ar 409 atbildi. Visas izmaiņas tiek ierakstītas auditēšanas žurnālā (audit log).

Droša darbību atkārtošana ar idempotenci

Tīklā var rasties kļūme pēc tam, kad jūsu pieprasījums ir apstrādāts, bet pirms esat saņēmis atbildi. Šādā gadījumā pieprasījuma atkārtošana varētu izveidot to pašu rēķinu divreiz. Idempotence nozīmē, ka atkārtotam pieprasījumam ir tāds pats efekts kā pirmajam.

Nosūtiet galveni Idempotency-Key ar jebkuru pieprasījumu, kas maina datus.
Atkārtots pieprasījums ar to pašu atslēgu un to pašu pamattekstu saņem atpakaļ saglabāto atbildi kopā ar galveni x-idempotent-replay: true.
Tā pati atslēga ar citu pamattekstu tiek noraidīta.
Atslēgas tiek saglabātas 24 stundas.

Tīmekļa āķi (Webhooks)

Tīmekļa āķis (webhook) ir ziņojums, ko Nordlet nosūta uz jūsu serveri, kad kaut kas notiek, piemēram, sale_invoice.paid.

Notikumi tiek ierakstīti tajā pašā datubāzes tansakcijā kopā ar izmaiņām, tāpēc atceltas izmaiņas neizsūta nekādu notikumu.
Katra piegāde ir parakstīta ar HMAC-SHA256, izmantojot jūsu abonementa noslēpumu, lai jūs varētu pārbaudīt, ka tā tiešām ir nākusi no Nordlet.
Neizdevusies piegāde tiek atkārtota aptuveni 24 stundas. Varat to nosūtīt arī manuāli.
Abonementi tiek pārvaldīti sadaļā Konts → Tīmekļa āķi (Account → Webhooks) vai, izmantojot API.

Rīki izstrādātājiem

API atsauce (API reference). Interaktīva API atsauce, kas izveidota, pamatojoties uz OpenAPI aprakstu, kā arī Postman kolekcija.
SDK. Tipizēti klienti valodām TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift un Rust, kas ģenerēti no tā paša apraksta. Skatiet SDK ceļvedi.
MCP serveris. Mākslīgā intelekta palīgi, piemēram, Claude, var meklēt un izsaukt API, izmantojot jūsu API atslēgu. Skatiet MCP servera ceļvedi.
Smilšu kastes (sandbox) uzņēmumi. Testa uzņēmums darbojas tāpat kā īsts, ir atzīmēts kā testa dati un nosūta atskaites un e-rēķinus tikai iestāžu testa galapunktiem.
Pieprasījumu limits (Rate limit). 300 pieprasījumi minūtē vienai API atslēgai, ar galvenēm, kas norāda atlikušo limitu.

FAQ

Ko es varu paveikt, izmantojot API?

Visu, kas atrodas produktā: rēķinu izrakstīšanu, pirkumus, virsgrāmatu, bankas datu saskaņošanu, krājumus, pamatlīdzekļus, darba samaksu, pārskatus un valsts iestāžu atskaites. Darba sākšanas ceļvedis palīdz iziet cauri pilnam ciklam no rēķina līdz PVN rādītājiem.

Vai es varu iebūvēt grāmatvedību savā produktā?

Jā. Katram Nordlet uzņēmumam ir savi reģistri, un jūsu programmatūra darbojas ar tiem, izmantojot savu API atslēgu. API nepiedāvā nevienu izsaukumu, kas labotu vai dzēstu iegrāmatotu žurnāla ierakstu. Korekcija ir jauns ieraksts, kas saglabā nemaināmu virsgrāmatu (immutable ledger).