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.
Tehden APIsta on julkaistu uusi versio (v2308), jota suosittelemme käyttämään kaikkiin uusiin integraatiototeutuksiin. Uutta ja vanhaa APIa voi käyttää myös rinnakkain, joten vanhalla APIlla toteutettujen integraatioiden siirtymän uuden APIn päälle voi toteuttaa hallitusti. Vanha API on käytössä toistaiseksi, mutta kaikkea tulevaa kehitystä ei automaattisesti toteuteta vanhan APIn puolelle.
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/apidoc/v2308 (uusi API) ja lyhyt esittely täältä. Vanhan rajapinnan dokumentaatio löytyy osoitteesta https://apidoc.tehden.com/ 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)
Tehden tarjoaa erikseen sovittavan mahdollisuuden myös ns. herätepalveluun, jonka avulla Tehdeniin saadaan tieto integroidussa järjestelmässä tapahtuvista muutoksista asetettujen kriteerien perusteella. Ominaisuuden mahdollisuuksiin voi tutustua Tehdenin Yritysasetusten Ulkoiset lisätoiminnot -välilehdellä.