Nordlet

← All features

Nordlet sovelluskehittäjille

Lisää ohjelmistoosi laskutus, kirjanpito ja EU-alueen veroilmoitukset yhden JSON-rajapinnan, tyypitettyjen SDK-kirjastojen, webhookien, MCP-palvelimen ja testiyritysten kautta.

Monet sovellukset synnyttävät rahoitustapahtumia: tilaus maksetaan, tilausjakso uusiutuu, tai asiakkaalle palautetaan rahaa. Jokainen näistä tapahtumista on kirjattava yrityksen kirjanpitoon.

Nordlet on alusta alkaen ohjelmistorajapintakeskeisesti rakennettu taloushallintosovellus. Kaikki verkkosovelluksen toiminnot ovat käytettävissä myös yhden JSON-rajapinnan kautta. Sovelluksesi lähettää tapahtumat, ja Nordlet pitää huolta kirjanpidosta sekä veroilmoitusten valmistelusta.

Mitä Nordlet tekee

  • Tarjoaa jokaisen toiminnon muodossa POST /v1/{module}/{resource}/{action} JSON-muotoisella rungolla, esimerkiksi /v1/sales/invoices/create.
  • Tunnistaa jokaisen pyynnön yritykseen sidotulla API-avaimella. Jokaisella avaimella on käyttöoikeusalueita (scopes), kuten sales:read tai sales:write, jotka rajaavat sen toimivaltaa.
  • Käsittelee summat desimaalijonoina, ei koskaan liukulukuina, joten senttejä ei katoa pyöristysvirheiden takia.
  • Hyväksyy jokaisessa muutoksessa Idempotency-Key-otsikon. Samalla avaimella tehty uusi yritys palauttaa ensimmäisen vastauksen tekemättä työtä uudelleen. Idempotenssi (idempotency) tarkoittaa, että toistetulla pyynnöllä on sama vaikutus kuin yhdellä pyynnöllä.
  • Palauttaa jokaisen virheen yhdessä yhtenäisessä muodossa.
  • Sallii 300 pyyntöä minuutissa API-avainta kohden.
  • Tallentaa jokaisen muutoksen lokiin (audit log).

Rajapintaopas (API conventions) käy nämä säännöt läpi yksityiskohtaisesti.

Kirjanpito pysyy ajan tasalla

Ohjelmistokirjastot, MCP ja webhookit

  • Tyypitetyt SDK-kirjastot luodaan samasta OpenAPI-kuvauksesta kielille TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift ja Rust. Kunnes SDK on julkaistu, voit asentaa sen suoraan lähdekoodivarastosta. Katso SDK-opas.
  • Tarjolla on Postman-kokoelma, joka sisältää kaikki rajapintapisteet.
  • MCP-palvelimen (MCP server) avulla tekoälyavustaja, kuten Claude Code, voi etsiä tietoa rajapinnasta ja kutsua sitä API-avaimellasi. Jokainen kutsu on tavallinen rajapintapyyntö samoilla käyttöoikeusalueilla ja rajoituksilla.
  • Webhookit ilmoittavat sovelluksellesi, kun jotain tapahtuu, esimerkiksi sale_invoice.issued tai sale_invoice.paid. Jokainen toimitus on varustettu HMAC-allekirjoituksella, joten voit varmistaa sen tulleen Nordletista. Epäonnistuneita toimituksia yritetään uudelleen noin 24 tunnin ajan.

Testaus testiyritysten avulla

  • Luo yritys arvolla isSandbox: true, tai valitse testiyritysasetus luodessasi yritystä sovelluksessa.
  • Testiyritys toimii kuten aito yritys: samat moduulit, sama rajapinta.
  • Se on selvästi merkitty testidataksi, eikä todellista yritystä voi muuttaa testiyritykseksi tai päinvastoin.
  • Testiyrityksen ilmoitukset ja verkkolaskut (e-invoice) ohjataan viranomaisten testipalveluihin.
  • Testiyrityksen käyttöä mitataan ja laskutetaan samalla tavalla kuin aidon yrityksen käyttöä.

Aloitusopas (getting started) opastaa ensimmäisen API-avaimen, ensimmäisen laskun ja koko prosessin läpi.

Usein kysytyt kysymykset

Voiko yksi sovellus palvellut useita yrityksiä?

Kyllä. Jokainen API-avain kuuluu yhdelle yritykselle, joten luot avaimen yritystä kohden. Jokainen webhook-toimitus sisältää sen yrityksen companyId-tunnuksen, jolle se kuuluu, joten yksi vastaanottaja voi palvellut useita yrityksiä.

Täytyykö veroilmoitustoiminnot rakentaa itse?

Ei. Nordlet muodostaa ilmoitukset kirjanpidon pohjalta. Maasta riippuen se joko lähettää ilmoituksen suoraan, muodostaa ladattavan tiedoston tai näyttää luvut, jotka syötät viranomaiselle. Ilmoitustukitaulukko (filing support table) listaa kaikki maakohtaiset tapaukset.

Aiheeseen liittyvää