Kirjanpito-ohjelmisto rajapinnalla

Nordletin kaikki osat ovat käytettävissä yhden JSON-rajapinnan kautta. Mukana ovat SDK-kirjastot, verkkosignaalit (webhooks), idempotentit uudelleenyritykset sekä MCP-palvelin tekoälyavustajille.

Ohjelmistorajapinta (API, application programming interface) mahdollistaa kahden ohjelmiston välisen viestinnän. Kirjanpito-ohjelmiston rajapinnan avulla oma ohjelmistosi voi luoda laskuja, kirjata maksuja ja lukea raportteja ilman, että kenenkään tarvitsee klikkailla käyttöliittymässä.

Nordlet on kirjanpito-ohjelmisto, jonka ensisijainen sisäänkäynti on rajapinta. Kaikki verkkosovelluksen toiminnot ovat käytettävissä saman JSON-rajapinnan kautta. Tämä sivu on tarkoitettu kehittäjille sekä niille, jotka päättävät tuotteensa integraatioista.

Mitä Nordlet tekee

Yhtenäinen pyynnön muoto. Jokainen kutsu on muotoa POST /v1/{module}/{resource}/{action} ja sisältää JSON-rungon, esimerkiksi sales/invoices/create tai bank/transactions/match.
Käyttöoikeusrajoitetut avaimet. Jokainen avain kuuluu yhdelle yritykselle ja sillä on tiettyjä käyttöoikeuksia (scopes), kuten sales:read tai bank:write. Avain, jolta puuttuu vaadittu käyttöoikeus, saa vastauksen 403.
Raha tekstinä. Summat ovat desimaalimerkkijonoja, joissa on enintään 4 desimaalia. Niissä ei koskaan käytetä liukulukuja, joten senttejä ei huku pyöristyksiin.
Yksi virhemuoto. Jokaisessa virheessä on sama runkorakenne, joka sisältää virhekoodin, viestin ja pyyntötunnisteen (request id).
Yhtenäiset listakyselyt. Jokainen list-kutsu hyväksyy samat sivutus-, lajittelu- ja suodatinkentät ja voi palauttaa summat.
Aidot kirjanpitosäännöt. Vientien on oltava tasapainossa, tositenumeroissa ei saa olla aukkoja, ja lukittu tilikausi hylkää uudet kirjaukset vastauksella 409. Jokainen muutos kirjoitetaan lokiin.

Turvalliset uudelleenyritykset idempotenssin avulla

Verkkoyhteys saattaa katketa sen jälkeen, kun pyyntösi on käsitelty, mutta ennen kuin ehdit vastaanottaa vastausta. Uudelleenyritys saattaisi tällöin luoda saman laskun kahdesti. Idempotenssi tarkoittaa, että toistetulla pyynnöllä on sama vaikutus kuin ensimmäiselläkin.

Lähetä Idempotency-Key-otsikko (header) kaikkien tietoja muuttavien kutsujen mukana.
Uudelleenyritys samalla avaimella ja samalla rungolla palauttaa tallennetun vastauksen otsikolla x-idempotent-replay: true.
Sama avain eri rungolla hylätään.
Avaimia säilytetään 24 tunnin ajan.

Verkkosignaalit (Webhooks)

Verkkosignaali on viesti, jonka Nordlet lähettää palvelimellesi, kun jotain tapahtuu, kuten sale_invoice.paid.

Tapahtumat kirjoitetaan samaan tietokantatransaktioon muutoksen kanssa, joten peruutettu muutos ei lähetä tapahtumaa.
Jokainen toimitus allekirjoitetaan HMAC-SHA256-algoritmilla tilauksesi salaisuutta käyttäen, joten voit varmistaa sen tulleen Nordletista.
Epäonnistunutta toimitusta yritetään uudelleen noin 24 tunnin ajan. Voit myös lähettää sen uudelleen manuaalisesti.
Tilauksia hallinnoidaan kohdassa Tili → Verkkosignaalit tai rajapinnan kautta.

Työkalut kehittäjille

Rajapintakuvaus. Interaktiivinen API-referenssi, joka on luotu OpenAPI-kuvauksen pohjalta, sekä Postman-kokoelma.
SDK-kirjastot. Tyypitetyt asiakaskirjastot TypeScriptille, Pythonille, Go'lle, Javalle, C#:lle, Rubylle, PHP:lle, Swiftille ja Rustille, jotka on generoitu samasta kuvauksesta. Katso SDK-opas.
MCP-palvelin. Tekoälyavustajat, kuten Claude, voivat etsiä ja kutsua rajapintaa API-avaimesi avulla. Katso MCP-palvelimen opas.
Testiyritykset (Sandbox). Testiyritys toimii kuten aito yritys, se on merkitty testidatapohjaksi ja lähettää ilmoituksia ja verkkolaskuja vain viranomaisten testipäätepisteisiin.
Kuttoraja (Rate limit). 300 pyyntöä minuutissa API-avainta kohden, otsikoilla, jotka näyttävät jäljellä olevan määrän.

Usein kysytyt kysymykset

Mitä voin tehdä rajapinnan kautta?

Kaikkea tuotteen toiminnallisuutta: laskutusta, ostoja, pääkirjanpitoa, tiliöintien täsmäytystä, varastoa, käyttöomaisuutta, palkanlaskentaa, raportteja ja viranomaisilmoituksia. Aloitusopas käy läpi koko syklin laskusta arvonlisäverolukuihin.

Voinko rakentaa kirjanpidon omaan tuotteeseeni?

Kyllä. Jokaisella Nordletin yrityksellä on omat kirjanpitoaineistonsa, ja ohjelmistosi käsittelee niitä API-avaimensa kautta. Rajapinnassa ei ole kutsua, jolla kirjatun vientitapahtuman voisi muokata tai poistaa. Oikaisu on uusi vienti, mikä varmistaa muuttumattoman kirjanpidon säilymisen.