Visma L7 & LTR REST API -rajapinnat ja integraatiot

[#1]

Täydennä Visma L7 toiminnanohjausjärjestelmää lisäarvoa tuottavilla integraatioilla ja vältä mahdollinen tuplatyö. L7 & LTR REST API -ohjelmistorajapinnat mahdollistavat reaaliaikaisen järjestelmien välisen keskustelun ja kaksisuuntaisen integroinnin modernilla tavalla.

API (Application Programming Interface) rajapintaa voidaan hyödyntää integraatioiden rakentamiseen lisäarvoa tuottavien ohjelmistojen ja Visma L7:n sekä LTR:n välillä. 

Löydät useista ohjelmistoista  jo valmiita integraatiototeutuksia Visma L7:aan. 

Tietoa ohjelmistokumppaneistamme ja valmiista toteutuksista löydät kumppanilistauksestamme. 

REST API:n käyttäminen ja käyttöönotto

Ohjelmistorajapinta on toteutettu Visma Liikkuvan työn ratkaisut (LTR) alustalle. 

L7 REST API vaatii näin ollen toimiakseen Visma L7:n rinnalle käyttöön otetun LTR-asennuksen.

Ohjelmistorajapinta kehittyy jatkuvasti. Oman ympäristön kautta avautuva dokumentaatio sekä rajapinta ovat aina samalla tasolla kuin käytössä oleva LTR-asennus. Suosittelemme, että käytössä on aina tuorein L7 ja LTR versio. Mikäli rajapinta vaatii tietyn L7 version, kerrotaan se ko. rajapinnan dokumentaation yhteydessä.

L7 REST API versiosuositukset:

• Visma L7 vähintään versio 9.2
• Visma LTR vähintään versio 2101
• Actian Zen (PSQL) tietokanta versio 14

Visma Sovelluspalvelun ympäristössä ohjelmistorajapinta on L7 ja LTR ohjelmistojen tavoin aina ajan tasalla ja julkaistu ulkoverkkoon.

L7 & LTR REST API pähkinänkuoressa: 

• Ohjelmistorajapinta on REST-pohjainen ja tukee JSON- sekä XML-formaatteja
• Käyttöoikeuksien hallinta ja rajapintojen parametrointi tapahtuu LTR-sovelluksessa
• Linkki ohjelmistorajapinnan OpenApi Specification -dokumentaatioon ja testiympäristöön löytyy LTR käyttäjädokumentaation kautta (kuva) 
• Rajapintojen käyttöoikeudet edellyttävät ohjelmistolisenssejä, jotka toimitetaan myynnin kautta
• Päivittyy normaali LTR versiojulkaisujen yhteydessä

L7 REST API -tekninen kuvaus

LTR REST API -tekninen kuvaus

Huomioithan, että rajapintaan ja integraatioihin liittyvä konsultointi ei kuulu ylläpitoon sisältyvään tukipalveluumme.

Visman vinkkejä integraatioprojekteihin

Integraatio-osapuolet: Visma-tilaaja-integroitavan järjestelmän toimittaja-integraattori

Integraatioprojektit lähtevät liikkeelle määrittelystä, jossa integraation tilaaja ja toteuttaja yhdessä määrittelevät toteutettavan integraation sisällön toiminnallisuuksineen ja varmistuvat siitä, että tarjolla olevat rajapinnat integraation toteutukseen mahdollistavat halutunlaisen toteutuksen. Määrittely kannattaa aina tehdä kirjallisesti.

Mikäli Visma ei ole integraation toteuttaja, olisi jo määrittelyvaiheeseen suositeltavaa ottaa projektiin mukaan myös Visman edustaja. Näin vältytään ikäviltä yllätyksiltä itse toteutusvaiheessa. Tämä tapahtuu tilaajan, eli Visma L7-asiakkaan toimesta tehtynä palvelutilauksena. Tarvittaessa ole yhteydessä nimettyyn Visman yhteyshenkilöön tai täytä konsultoinnin yhteydenotto-/tilauslomake.

Palvelutilaus-/yhteydenottolomake