Takaisin

Purchases API ostolaskurajapinta

Mikä on Talenom ostolasku API?

Ostolasku API on avoin rajapinta johon ulkoiset järjestelmät voivat liittyä ja tämän kautta voidaan käsitellä Talenomin laskujen maksupalvelussa olevia laskuja tai tuoda uusia laskuja järjestelmään.

Mitä toiminnallisuuksia ostolaskurajapinnassa voidaan tehdä?

Rajapinta on rakennettu siten, että sen kautta on mahdollista osittain tai kokonaan, tehdä kaikki samat toimenpiteet ostolaskuille kuin Talenom Onlinen laskujen maksupalvelussa.

Esimerkkejä:

Asiakas A tai asiakkaan järjestelmäntoimittaja haluaa tehdä täysin oman mobiilin järjestelmän laskujen kierrätykseen, maksatukseen ja kirjanpidon tiliöintiin, mutta käyttää Talenomin maksatus ja tilitoimistopalveluita. Tämä on mahdollista toteuttaa hyödyntäen kaikkia rajapinnan toiminnallisuuksia.

Asiakas B haluaa käyttää Talenom Onlinen laskujen maksupalvelua, mutta haluaa myös ostolaskujen rivitiedot ja tiliöintitiedot omaan projektinhallintajärjestelmään. Asiakkaan koodari tai järjestelmäntoimittaja rakentaa ainoastaan noutorajapinnat jotka hakevat laskun otsikkotasoiset tiedot, laskun Finvoice tiedostot (joista löytyy laskurivitiedot jos ovat tulleet verkkolaskuna) sekä laskun tiliöintirivit asiakkaan järjestelmään.

Lista kaikista toiminnallisuuksista rajapinnassa:

·         Ostolaskujen otsikkotasoisten tietojen nouto

·         Ostolaskun kuvan, liitteiden ja Finvoice tiedoston nouto

·         Ostolaskujen tuonti

·         Ostolaskujen kierrättäminen, hyväksyminen, hylkääminen ja mitätöinti

·         Ostolaskujen hyväksyminen maksatukseen

·         Maksatuksen muokkaus (jos maksetaan osissa)

·         Kierrätyslistojen nouto, muokkaus ja lisäys

·         Ostolaskujen kommenttien nouto / lisäys ja muokkaus

·         Ostolaskujen tiliöinti (kirjanpidon tiliöinti ja/tai seurantakohteiden asettaminen tai muokkaus)

·         Käytössä olevien seurantakohteiden nouto

·         Toimittajien nouto

Rajapinnan tekniikka:

·         Rajapinta on toteutettu REST API tekniikalla

·         Tunnistautuminen toteutettu Oauth 2.0 + OpenId connect protokollalla (käytännössä asiakkaan järjestelmä ja asiakkaan käyttäjä tunnistetaan ennen kuin rajapinnan mitään toimintoa voidaan käyttää)

Miten rajapinta esiselvitetään / toteutetaan?

·         Rajapinnan tekninen dokumentaatio löytyy API-osion alta. Lisätiedot ja tekninen konsultaatio järjestelmäntoimittajan suuntaan tarjotaan Integraatiopalvelut tiimin toimesta.

·         Käytännössä suurin työ (mikäli rajapintaa ei ole vielä rakennettu) on asiakkaan järjestelmän päässä.

·         Huomiona, että ostolaskurajapinnassa on todella tiukka tietoturvataso. Suurin työ rajapinnan alkuvaiheessa on tunnistautumisen ja authentikoinnin toteuttaminen, jonka jälkeen varsinaisten rajapinnan toimintojen käyttö on taitavalle koodarille suhteellisen helppoa.

Mitä ostolaskurajapinta maksaa?

·         Talenomin virallisten kumppanien kautta rajapinnan käyttäminen on muutoin maksutonta, mutta ostolaskujen lisääminen hinnoitellaan verkkolaskun hinnan mukaisesti.

·         Muiden järjestelmäntoimittajien kautta 390€ startti + 29€/kk + ostolaskujen lisäys rajapinnan kautta hinnoitellaan verkkolaskun hinnan mukaisesti.

·         Huomioithan, että järjestelmäntoimittajan kustannukset rajapinnan rakennuksen osalta oletuksena menevät asiakkaalle jollei erikseen toisin sovita.  

Takaisin