Nordlet tarkvaraarendajatele

Lisage oma tarkvarale arveldamine, raamatupidamine ja EL-i maksuaruandlus ühe JSON API, tüübistatud SDK-de, veebikonksude (webhooks), MCP serveri ja testettevõtete abil.

Paljud rakendused tekitavad raha liikumisega seotud sündmusi: tellimus makstakse kinni, tellimus uueneb, tehakse tagasimakse. Iga selline sündmus peab jõudma ettevõtte raamatupidamisse.

Nordlet on API-põhiselt üles ehitatud raamatupidamistarkvara. Kõik, mida veebirakendus teeb, on kättesaadav ka ühe JSON API kaudu. Teie rakendus saadab sündmused ning Nordlet peab raamatupidamist ja koostab maksuaruandeid.

Mida Nordlet teeb

Avalikustab iga toimingu kujul POST /v1/{module}/{resource}/{action} koos JSON-sisuga, näiteks /v1/sales/invoices/create.
Authentib iga päringu ühele ettevõttele kuuluva API-võtme abil. Igal võtmel on õiguseelarvamus (scopes), nagu sales:read või sales:write, mis piiravad selle tegevusulatust.
Käsitleb summasid kümnendmurruna esitatud tekstina, mitte kunagi ujukomaarvudena, mistõttu ei lähe ümardamise tõttu kaduma ühtegi senti.
Aktsepteerib iga muudatuse juures päises Idempotency-Key väärtust. Sama võtmega korduspäring tagastab esimese vastuse, selle asemel et tööd teist korda teha. Idempotentsus tähendab, et korduv päring avaldab sama mõju mis üksainus päring.
Tagastab iga vea ühtses jagatud vormingus.
Lubab 300 päringut minutis ühe API-võtme kohta.
Salvestab iga muudatuse auditijälge.

API konventsioonide juhend käsitleb kõiki neid reegleid üksikasjalikult.

Raamatupidamine, mis püsib korras

Arve väljastamine määrab auguta numbri, kontrollib, et raamatupidamisperiood on avatud, ja kirjendab kirje pearaamatusse samas andmebaasitehingus.
Iga kanded peavad olema tasakaalus. Andmebaas ise kontrollib seda tehingu salvestamisel.
Väljastatud ja registreeritud dokumente ei saa kustutada. Vale pangakande vaste parandatakse korrigeeriva kandega, mitte vana dokumendi muutmisega. Just seda tähendab muutumatu pearaamat.

SDK-d, MCP ja veebikonksud

Tüübistatud SDK-d genereeritakse sama OpenAPI kirjelduse põhjal TypeScripti, Pythoni, Go, Java, C#, Ruby, PHP, Swifti ja Rusti jaoks. Enne SDK avaldamist saate selle installida selle lähtekoodi hoidlast. Vaadake SDK-de juhendit.
Saadaval on Postmani kollektsioon, mis sisaldab kõiki lõpppunkte.
MCP server võimaldab AI-assistendil, näiteks Claude Code'il, otsida API-st infot ja kutsuda seda välja teie API-võtmega. Iga väljakutse on tavaline API-päring samade õiguste ja piirangutega.
Veebikonksud annavad teie rakendusele teada, kui midagi juhtub, näiteks sale_invoice.issued või sale_invoice.paid. Iga teade on allkirjastatud HMAC-allkirjaga, et saaksite kontrollida selle pärinemist Nordletist. Ebaõnnestunud edastusi proovitakse uuesti umbes 24 tunni jooksul.

Testimine testettevõtetega

Looge ettevõte parameetriga isSandbox: true või märkige rakenduses ettevõtte seadistamisel testettevõtte ruut.
Testettevõte toimib nagu päris ettevõte: samad moodulid, sama API.
See on selgelt tähistatud testandmetena ning päris ettevõtet ei saa muuta testettevõtteks ega vastupidi.
Testettevõtte aruanded ja e-arved suunatakse maksuhaldurite testkeskkondadesse.
Testettevõtte kasutamist mõõdetakse ja arveldatakse samamoodi nagu päris ettevõtte puhul.

Alustamise juhend tutvustab esimese API-võtme hankimist, esimese arve koostamist ja kogu protsessi tsüklit.

FAQ

Kas üks rakendus saab teenindada mitut ettevõtet?

Jah. Iga API-võti kuulub ühele ettevõttele, seega loote võtme ettevõtte kohta. Iga veebikonksu teade sisaldab selle ettevõtte companyId tunnust, millele see kuulub, nii et üks vastuvõtja saab teenindada mitut ettevõtet.

Kas ma pean maksuaruanded ise looma?

Ei. Nordlet koostab aruanded raamatupidamisandmete põhjal. Olenevalt riigist see kas saadab aruande otse, koostab üleslaaditava faili või kuvab arvandmed, mille te ise sisestate. Aruannete toe tabel loetleb kõik juhtumid.