Nordlet

← All features

Nordlet lietotņu izstrādātājiem

Pievienojiet rēķinu izrakstīšanu, grāmatvedību un ES nodokļu atskaites savai programmatūrai, izmantojot vienu JSON API, tipizētas SDK bibliotēkas, tīmekļa āķus (webhooks), MCP serveri un testa uzņēmumus (sandbox).

Daudzas lietotnes rada finansiāla rakstura notikumus: tiek apmaksāts pasūtījums, atjaunots abonements vai izsniegta atmaksa. Katram no šiem notikumiem ir jānonāk uzņēmuma grāmatvedības reģistros.

Nordlet ir grāmatvedības programmatūra, kas veidota, primāri domājot par API (API-first). Visas tīmekļa lietotnes iespējas ir pieejamas arī, izmantojot vienu JSON API. Jūsu lietotne nosūta notikumus, savukārt Nordlet kārto grāmatvedību un sagatavo nodokļu atskaites.

Ko Nordlet paveic

  • Piedāvā katru darbību formātā POST /v1/{module}/{resource}/{action} ar JSON pamattekstu, piemēram, /v1/sales/invoices/create.
  • Autentificē katru pieprasījumu, izmantojot API atslēgu, kas pieder vienam uzņēmumam. Katrai atslēgtai ir piekļuves tiesības (scopes), piemēram, sales:read vai sales:write, kas ierobežo tās iespējas.
  • Pieņem summas kā decimāldaļu virknes, nekad neizmantojot peldošā komata skaitļus, lai noapaļošanas dēļ netiktu zaudēti centi.
  • Katrā izmaiņu pieprasījumā pieņem Idempotency-Key galveni. Atkārtots pieprasījums ar to pašu atslēgu atgriež pirmo atbildi, neveicot darbu otrreiz. Idempotence nozīmē, ka atkārtotam pieprasījumam ir tāds pats efekts kā vienam pieprasījumam.
  • Atgriež katru kļūdu vienotā kopīgā formātā.
  • Ļauj veikt 300 pieprasījumus minūtē uz vienu API atslēgu.
  • Reģistrē katru izmaiņu auditā (audit log).

API konvenciju ceļvedis sīki apskata katru no šiem noteikumiem.

Grāmatvedība, kas vienmēr ir precīza

  • Izrakstot rēķinu, tam tiek piešķirts numurs bez pārtraukumiem, tiek pārbaudīts, vai grāmatvedības periods ir atvērts, un tajā pašā datubāzes tansakcijā tiek grāmatots grāmatojums.
  • Katram grāmatojumam ir jāsabalansējas. Datubāze pati to pārbauda transakcijas saglabāšanas brīdī.
  • Izrakstītus un reģistrētus dokumentus nevar dzēst. Nepareizu bankas darījuma piesaisti atceļ ar stornējošu grāmatojumu, nevis labojot veco ierakstu. Tas ir tas, ko nozīmē nemainīga virsgrāmata (immutable ledger).

SDK bibliotēkas, MCP un tīmekļa āķi (webhooks)

  • Tipizētas SDK bibliotēkas tiek ģenerētas no viena un tā paša OpenAPI apraksta TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift un Rust valodām. Līdz brīdim, kad SDK tiek publicēts, to var instalēt no tā pirmkoda repozitorija. Skatīt SDK ceļvedi.
  • Ir pieejama Postman kolekcija ar visiem galapunktiem (endpoints).
  • MCP serveris ļauj mākslīgā intelekta asistantam, piemēram, Claude Code, meklēt informāciju API un izsaukt to, izmantojot jūsu API atslēgu. Katrs izsaukums ir parasts API pieprasījums ar tām pašām piekļuves tiesībām un ierobežojumiem.
  • Tīmekļa āķi (webhooks) paziņo jūsu lietotnei, kad kaut kas notiek, piemēram, sale_invoice.issued vai sale_invoice.paid. Katra piegāde ir parakstīta ar HMAC parakstu, lai jūs varētu pārbaudīt, ka tā nāk no Nordlet. Neizdevušās piegādes tiek mēģinātas atkārtot aptuveni 24 stundu laikā.

Testēšana ar testa uzņēmumiem (sandbox)

  • Izveidojiet uzņēmumu ar iestatījumu isSandbox: true vai atzīmējiet testa uzņēmuma izvēles rūtiņu, kad iestatāt uzņēmumu lietotnē.
  • Testa uzņēmums (sandbox company) darbojas tāpat kā īsts uzņēmums: tie paši moduļi, tas pats API.
  • Tas ir skaidri marķēts kā testa dati, un jūs nevarat pārvērst īstu uzņēmumu par testa uzņēmumu vai otrādi.
  • Testa uzņēmuma atskaites un e-rēķini tiek nosūtīti uz valsts iestāžu testa vidi.
  • Resursu izmantošana testa uzņēmumā tiek uzskaitīta un rēķināta tāpat kā reālā uzņēmumā.

Darba uzsākšanas ceļvedis palīdzēs soli pa solim izveidot pirmo API atslēgu, pirmo rēķinu un iziet visu ciklu.

FAQ

Vai viena lietotne var apkalpot vairākus uzņēmumus?

Jā. Katra API atslēga pieder vienam uzņēmumam, tāpēc jūs izveidojat atslēgu katram uzņēmumam. Katra tīmekļa āķa (webhook) piegāde satur tās uzņēmuma companyId, kuram tā pieder, tāpēc viena saņemšanas vieta var apkalpot vairākus uzņēmumus.

Vai nodokļu atskaites man ir jāizstrādā pašam?

Nē. Nordlet sagatavo atskaites, pamatojoties uz grāmatvedības datiem. Atkarībā no valsts attiecīgā atskaites forma tiek nosūtīta automātiski, tiek ģenerēts augšupielādējams fails vai tiek parādīti dati, kurus ievadāt manuāli. Atskaišu atbalsta tabula uzskaita visus gadījumus.

Saistītās tēmas