Tehden API -rajapinta

Tervetuloa tutustumaan Tehden API:iin!

Tehden API (Application Programming Interface) on ohjelmointirajapinta, jonka avulla voi tehdä ohjelmallisia kutsuja toisesta ohjelmistosta Tehdeniin ja hyödyntää tietoja reaaliaikaisesti. Tehden APIa voidaan käyttää lisäarvoa tuottavien integraatioiden rakentamiseen Tehdenin ja muiden kaupallisten tai yrityskohtaisten järjestelmien välille. Tehdenin ylläpitämien integraatioiden tiedot ja käyttöohjeet löydät Integraatiot-ohjekokonaisuudesta.

Löydät alta esimerkkejä rajapinnan tarjoamista mahdollisuuksista, Tehdenin rajapintatiimin tuesta, rajapinnan käyttöönotosta sekä vastuiden jakautumisesta Tehdenin ja integraation toteuttajan välillä. 

Rajapinnan ominaisuudet

Rajapinnan kautta voidaan tuoda tietoja Tehdeniin ja viedä tietoja Tehdenistä. Tehden-rajapinta tarjoaa integraation käyttöön vähintään seuraavat API-resurssit:

• Tuotteet
• Toimittajat
• Toimittajan tuotteet
• Asiakkaat
• Varastot
• Kassamyynti
• Myyntitilaus
• Laskut
• Raportointi

Tarkempi rajapintakuvaus ja dokumentaatio löytyy osoitteesta https://apidoc.tehden.com/ ja lyhyt esittely täältä. Rajapinta ei sisällä kaikkia Tehden-ohjelmiston toiminnallisuuksia, ja integraation toteutuksesta sekä yrityksen Tehdeniin sisältyvistä toiminnoista riippuu, mitkä rajapinnasta saatavilla olevat tiedot siirtyvät ohjelmistojen välillä. Näistä kannattaa keskustella valitsemasi kolmannen osapuolen integraationtoteuttajan kanssa. Tarvittaessa integraation toteuttaja voi olla yhteydessä myös API-tiimiimme (api.support@tehden.com), joka vastaa rajapintakuvaukseen liittyviin kysymyksiin ja jonka kanssa voi sopia myös palveluhinnastomme mukaan veloitettavasta laajemmasta rajapintakonsultaatiosta.

Rajapinnan käyttöoikeus

Tehden API Rajapinnan käyttöoikeuden voi tilata erillisenä lisäosana kaikkiin Tehden-ohjelmistopaketteihin. Jotta yritys voi ottaa käyttöön kolmannen osapuolen tarjoaman integraation, Tehden-ohjelmiston tilauksessa tulee olla rajapinnan käyttöoikeus. Rajapinnan käyttöoikeus sallii tietojen siirtämisen integraation avulla Tehden-ohjelmistoon/-ohjelmistosta, tietyin rajoituksin.

Voit tilata meiltä konsultaatiota rajanpinnan toimintaan jo integraation suunnitteluvaiheessa, ja integraation kehittäjälle voi tilata myös Tehdenin testiympäristön.

Rajapinnan käyttöönotto ja vastuiden jakautuminen

Kun rajapinnan käyttöoikeus on lisätty tilaukseesi, Tehden lähettää rajapinnan tunnukset integraation toteuttavalle osapuolelle, jolloin he voivat kytkeä integraation toimintaan. Yrityksesi Tehden-pääkäyttäjän tulee suorittaa rajapinnan autentikointi (eli hyväksyä integraattorin pääsy yrityksen Tehden-ohjelmistoon) integraation toteuttajan ohjeiden mukaisesti.

Tehden vastaa rajapinnan toiminnasta, ja kolmas osapuoli (yleensä integraation toteuttaja tai integroitava järjestelmä) vastaa Tehdeniä käyttävän yrityksen ja integraattorin välisen sopimuksen mukaisesti integraation toiminnasta, käyttöönotosta ja tuesta.

Tietoturva

Yhteydet onnistuvat vain salatun HTTPS-yhteyden yli. Tunnistautuminen tapahtuu OAuth 2.0 -standardin mukaisesti.

Esimerkki Tehden API:n tarjoamista mahdollisuuksista

Tehden API mahdollistaa esimerkiksi seuraavanlaisen verkkokauppaintegraation toteutuksen:
(Kuvassa esitetty sekä vanhan että uuden Tehden API:n käytettävissä olevat päätepisteet)