NoCFO:n rajapinta (API) – yleiskatsaus

NoCFO tarjoaa avoimen ohjelmointirajapinnan (API), jonka kautta voit hakea ja käsitellä oman yrityksesi taloustietoja NoCFO:n ulkopuolella: kirjanpitoa, laskuja, tositteita, raportteja ja muuta dataa. Rajapinnan avulla voit esimerkiksi rakentaa oman integraation, automatisoida toistuvia tehtäviä tai yhdistää NoCFO:n muihin järjestelmiin.

Mihin rajapintaa voi käyttää

• Oman datan hakeminen NoCFO:sta toiseen järjestelmään (esim. raportointi- tai BI-työkaluun)

• Tietojen vieminen NoCFO:hon toisesta järjestelmästä (esim. laskut, tapahtumat, kontaktit)

• Omien automaatioiden ja skriptien rakentaminen rutiinitehtäviin

• Tekoälytyökalujen (Claude, ChatGPT, Cursor ym.) yhdistäminen NoCFO-dataan MCP-palvelimen kautta

Autentikointi – API-tokenin luominen

Rajapinnan käyttö edellyttää henkilökohtaista API-tokenia:

1. Mene osoitteeseen login.nocfo.io/auth/tokens

2. Klikkaa Create new key

3. Nimeä token käyttötarkoituksen mukaan (esim. "Oma integraatio")

4. Kopioi token ja tallenna se turvalliseen paikkaan – sitä ei näytetä uudelleen

Tokenit ovat käyttäjäkohtaisia ja ne voi perua milloin tahansa samasta osoitteesta.

Mitä rajapinnan kautta voi tehdä – osa-alueet

Rajapinta on jaettu loogisiin osa-alueisiin sen mukaan, mitä dataa käsitellään:

• Kirjanpito – tilikartta ja tilit, tositteet ja niiden tiedostot, kirjaukset (tapahtumat), tositekansiot, otsikot ja tunnisteet (kustannuspaikat)

• Laskutus – myynti- ja ostolaskut, kontaktit (asiakkaat/toimittajat), tuotteet, laskun lähetys ja toimitustavat

• Raportointi – tuloslaskelma, tase, pääkirja ja päiväkirja, tilikaudet, ALV-kaudet ja -ilmoitukset, oman pääoman muutokset

• Yleiset tiedot – käyttäjän ja käytettävissä olevien yritysten tiedot, käyttöoikeudet

Tarkat endpointit, parametrit ja esimerkkikutsut löytyvät alta linkatusta API-dokumentaatiosta.

Rajapinta vs. MCP-palvelin – kumpaa kannattaa käyttää?

NoCFO tarjoaa kaksi tapaa käyttää taloustietoa ohjelmallisesti:

• Suora REST-rajapinta (API) – tarkoitettu kehittäjille, jotka rakentavat omia integraatioita tai automaatioita. Antaa täyden hallinnan siihen, mitä dataa haetaan ja miten sitä käsitellään.

• MCP-palvelin (mcp.nocfo.io) – tarkoitettu tekoälytyökalujen (Claude, ChatGPT, Cursor) yhdistämiseen luonnollisella kielellä. Katso ohjeet artikkelista Näin yhdistät tekoälytyökalusi NoCFO:hon MCP:n kautta.

Molemmat käyttävät samaa API-tokenia autentikointiin.

Dokumentaatio ja työkalut

• API-dokumentaatio: api-prd.nocfo.io/docs – kaikki saatavilla olevat endpointit, parametrit ja esimerkit

• Avoimen lähdekoodin toolkit: github.com/nocfo/nocfo-ai-toolkit – valmis CLI/kirjasto rajapinnan käyttöön

Tietoturva

• Älä koskaan jaa API-tokeniasi julkisesti äläkä lisää sitä versionhallintaan

• Käytä erillistä tokenia jokaiselle integraatiolle tai työkalulle, jotta yksittäisen tokenin voi perua vaikuttamatta muihin

• Voit perua tokenit milloin tahansa osoitteessa login.nocfo.io/auth/tokens

Kysyttävää?

Ota yhteyttä: info@nocfo.io