Nordlet

← All features

Nordlet programėlėms kurti

Integruokite sąskaitų faktūras, apskaitą ir ES mokesčių deklaracijas į savo programinę įrangą naudodami vieną JSON API, tipizuotus SDK, internetinius webhook, MCP serverį ir bandomąsias įmones.

Daugelis programėlių sukuria finansinius įvykius: apmokamas užsakymas, pratęsiama prenumerata, išmokamas grąžinimas. Kiekvienas toks įvykis turi patekti į įmonės apskaitą.

Nordlet yra apskaitos programinė įranga, sukurta remiantis API pirmumo (API-first) principu. Viskas, ką galima padęti per žiniatinklio programėlę, taip pat pasiekiama per vieną JSON API. Jūsų programėlė siunčia įvykius, o Nordlet tvarko apskaitą ir ruošia mokesčių deklaracijas.

Ką daro Nordlet

  • Kiekvieną veiksmą pateikia kaip POST /v1/{module}/{resource}/{action} su JSON pagrindiniu turiniu (body), pavyzdžiui, /v1/sales/invoices/create.
  • Kiekvieną užklausą autentifikuoja API raktu, priklausančiu vienai įmonei. Kiekvienas raktas turi teisių sritis (scopes), tokias kaip sales:read arba sales:write, kurios riboja jo galimybes.
  • Sumas priima kaip dešimtaines eilutes, o ne slankiojo kablelio skaičius, todėl dėl apvalinimo nepranyksta nei centas.
  • Kiekvienam keitimui priima antraštę Idempotency-Key. Pakartojus užklausą su to paties rakto reikšme grąžinamas pirmasis atsakymas, o darbas neatliekamas dukart. Idempotentiškumas (idempotency) reiškia, kad pasikartojanti užklausa turi tokį patį poveikį kaip ir viena užklausa.
  • Kiekvieną klaidą grąžina bendru formatu.
  • Leidžia atlikti 300 užklausų per minutę vienam API raktui.
  • Kiekvieną pakeitimą įrašo į audito žurnalą.

API susitarimų vadove išsamiai aptarta kiekviena iš šių taisyklių.

Apskaita, kuri visada teisinga

  • Išrašant sąskaitą faktūrą priskiriamas nuoseklus numeris be tarpų, patikrinama, ar apskaitos laikotarpis yra atidarytas, ir tuo pačiu duomenų bazės transakcijos veiksmu užregistruojamas žurnalo įrašas (journal entry).
  • Kiekvienas įrašas turi susibalansuoti. Pati duomenų bazė tai patikrina išsaugant transakciją.
  • Išrašytų ir užregistruotų dokumentų negalima ištrinti. Neteisingas banko įrašo susiejimas atšaukiamas koreguojamuoju įrašu, o ne redaguojant senąjį. Tai ir yra nekeičiama didžioji knyga (immutable ledger).

SDK, MCP ir webhook

  • Tipizuoti SDK generuojami pagal tą patį OpenAPI aprašą TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift ir Rust kalboms. Kol SDK nepaskelbtas viešai, jį diegiate iš pirminio kodo saugyklos. Žr. SDK vadovą.
  • Pateikiamas Postman rinkinys su visais galiniais punktais (endpoints).
  • MCP serveris leidžia dirbtiniam intelektui, pavyzdžiui, Claude Code, ieškoti API ir jį iškviesti naudojant jūsų API raktą. Kiekvienas iškvietimas yra įprasta API užklausa su tomis pačiomis teisių sritimis ir apribojimais.
  • Webhook praneša jūsų programėlei, kai kažkas įvyksta, pavyzdžiui, sale_invoice.issued arba sale_invoice.paid. Kiekvienas pranešimas pasirašomas HMAC parašu, kad galėtumėte patikrinti, jog jis gautas iš Nordlet. Nepavykę pranešimai siunčiami pakartotinai maždaug 24 valandas.

Testavimas bandomosiose įmonėse

  • Sukurkite įmonę nurodę isSandbox: true arba pažymėkite bandomosios įmonės žymę, kai nustatote įmonę programėlėje.
  • Bandomoji įmonė veikia kaip tikra: tie patys moduliai, toks pat API.
  • Ji aiškiai pažymėta kaip testiniai duomenys, o tikros įmonės negalima paversti bandomąja ar atvirkščiai.
  • Bandomosios įmonės deklaracijos ir e. sąskaitos faktūros (e-invoice) siunčiamos į administratorių testines paslaugas.
  • Bandomosios įmonės naudojimas yra matuojamas ir apmokestinamas kaip ir tikros įmonės naudojimas.

Pradmenų vadove nuosekliai aprašomas pirmojo API rakto gavimas, pirmosios sąskaitos faktūros išrašymas ir visas ciklas.

D.U.K.

Ar viena programėlė gali aptarnauti kelias įmones?

Taip. Kiekvienas API raktas priklauso vienai įmonei, todėl sukuriate po raktą kiekvienai įmonei. Kiekviename webhook pranešime pateikiamas įmonės, kuriai jis priklauso, identifikatorius companyId, todėl vienas gavėjas gali aptarnauti kelias įmones.

Ar mokesčių deklaracijas turiu sukurti pats?

Ne. Nordlet sukuria deklaracijas pagal apskaitos duomenis. Atsižvelgiant į šalį, kiekvieną deklaraciją ji arba išsiunčia pati, arba sukuria failą, kurį įkeliate, arba pateikia duomenis, kuriuos suvedate ranka. Deklaracijų palaikymo lentelėje išvardyti visi atvejai.

Susiję