Siirry pääsisältöön
Integraation aukaisuohje: Lemonsoft

Yleiskuvaus, integraatio, API -rajapinta, rajapinta, data, datat, tosite, tositteet

Marianne Koivusalo avatar
Tekijä: Marianne Koivusalo
Päivitetty yli 6 kuukautta sitten

Eri vaihtoehdot

Lemonsoft -integraatio on ehkä yksi moniulotteisimmista integraatioista, mitä Finazillassa on olemassa. Lemonsoftista voidaan siirtää dataa Finazillaan useammalla tavalla. Yrityksen siirtotapa on sovittu aina Finazillan käyttöönoton yhteydessä. Kuvaamme eri vaihtoehtoja alla.

Lemon

Kyseessä on tiedostopohjainen drop in -vaihtoehto. Tässä toteutuksessa asiakas muodostaa tositeaineiston itse ja ajaa sen manuaalisesti Finazillaan sisään. Kyseessä ei ole siis varsinainen integraatio.

Lemonsoft

Kyseessä on Api -rajapinta, joka noudattelee alkuperäistä ensimmäistä tehtyä toteutusta. Toteutuksessa asiakkaalle siirtyy tositteet, dimensiot, myyntilaskut, ostolaskut sekä operatiivinen sales -tietovirta, jossa siirtyy laajemmin asiakas- ja tuoteryhmätietoja ja kirjanpidon dimensiokohdistuksia. Integraatio ajaa joka yö kuluvasta päivästä 100 päivää taaksepäin ja noutaa kaikki datat tuolta ajanjaksolta.

Integraatio on käytettävissä myös asiakkailla, joilla Lemonsoft on omalla palvelimella.

LemonsoftFunctionApp

Vuonna 2024 tehty toteutus, jossa siirtotapa ja sisältö on alkuperäistä toteutusta parempi. Integraatiossa siirretään laajemmin dataa ja siirrossa siirretään lähtökohtaisesti aina uudet, muuttuneet ja poistetut tositteet.

Kaikki uudet asiakkaat aukaistaan uuteen LemonsoftFunctionApp -integraatioon, mutta alla kuvattu aukaisuohje toimii kumpaankin API -rajapintatoteutukseen.

Vaatimukset integraation käytölle

Jotta asiakas voi käyttää Lemonsoftin rajapintaa, ja siirtää dataa sieltä Finazillaan, tulee asiakkaalla on käytössä uusi käyttäjähallinta. Lemonsoftin minimiversio 2022.10 b.1834 on julkaistu lokakuun lopussa ja päivitetty kaikille Lemonsoft SaaS-asiakkaille 27.10.2022.

Lemonsoftin kirjanpito tapahtuu ns. osakirjanpitona, josta tiedot siirtyvät automaattisesti varsinaiseen kirjanpitoon. Koska Finazilla käyttää integraatiossa juurikin varsinaista kirjanpitoa, tulee asiakkaalla olla käytössä automatisointi, missä kirjanpidon aineistot laitetaan päivittymään päivittäin. Ilman tätä datat päivittyvät Finazillaan kerran kuukaudessa.

Joillain asiakkailla voi olla käytössään bruttotyylin alv- kirjaus. Mikäli tämä kirjaustyyli on käytössä, on Finazillan raportit oikeelliset vasta kuukauden alussa koskien edeltävää kuukautta. Kirjaustavan voi vaihtaa Lemonsoftissa - neuvomme tässä tarpeen vaatiessa. Suositeltavaa on siis, että asiakkaalla on käytössä nettotyylin alv- kirjaus.

Rajapinnan aukaisu

Finazillan käyttöönotosta vastaava henkilö huolehtii rajapinnan tilaamisesta Lemonsoftilta. Lemonsoft toimittaa Finazillalle tarvittavat tiedot rajapinnan kytkemistä varten (tietokannan osoite, API -avain ja url -osoite).

Tietojen saamisen jälkeen Finazillan käyttöönotosta vastaava henkilö kytkee rajapinnan päälle.

Rajapinnan aukaisu, mikäli Lemonsoft on asiakkaan omalla palvelimella

Jos Lemonsoft on asiakkaan omalla palvelimella, vastaa asiakas seuraavien kohtien toteuttamisesta itse.

  1. Asiakkaan tulee avata omaan palomuuriinsa seuraavat IP -osoitteet:

  • 52.169.164.178 (Microsoft) (REST portti 443)

  • 91.190.197.161

2. Asiakkaan tulee luoda heidän Lemonsoftiinsa käyttäjätunnus asiakaspalvelu@finazilla.fi

Käyttäjätunnukselle tulee antaa IWS_LOG ja IWS_FZ lisenssit. Seuraavaksi henkilörekisteriin tulee perustaa käyttäjä, joka on merkitty käyttäjäksi ja tälle käyttäjälle laitetaan työsähköpostiksi yllä mainittu asiakaspalvelu@finazilla.fi sähköposti. Käyttäjän perustamisen jälkeen tulee navigoida yhteenveto -sivulle ja mennä sieltä vakio-rajapinnat kohtaan.

Huomaa, että IWS_FZ löytyy vakiorajapintojen alta

3. Finazillan käyttöönottaja katsoo asiakkaan asiakaskohtaisen Lemonsoftin Url -osoitteen

4. Asiakkaan tulee toimittaa Finazillalle tietokannan osoite (database) sekä Api -avain (Apikey)

5. Finazillan käyttöönottoja kytkee rajapinnan päälle tarvittavien tietojen saamisen jälkeen

Rajapinnan kytkeminen päälle Finazillassa

Kts. erillinen ohjeemme täältä.

Vastasiko tämä kysymykseesi?