Yleiskatsaus
Netvisor–Erply-integraatio tukee seuraavia toimintoja:
- Valmiiden myyntien synkronointi Erplystä Netvisoriin päivittäisenä tositteena (kirjanpitovienti).
- Avoimien (maksamattomien) myyntien synkronointi Erplystä Netvisoriin yksittäisinä dokumentteina, jotka maksetaan tai peritään Netvisorissa.
- Maksujen synkronointi Netvisorista Erplyyn laskujen sulkemiseksi Erplyn puolella.
Asennusohjeet
Siirry Erplyssä kohtaan Sovellukset > App store (Apps > App store).
Vaihda sivun URL-osoitteessa “automat-eu.erply.com” muotoon “template-engine-eu10.erply.com”.
Hae “Netvisor” ja asenna sovellus.

Käyttöönotto-ohjeet
Asiakastunnus ja asiakasavain luodaan Netvisorissa: Yritysvalikko > Ohjelmistorajapintatunnukset.
- Luo tunniste painikkeella “Luo uusi rajapintatunnus”.
- Uusi tunniste näkyy listassa ensimmäisenä. Kopioi käyttäjätunnus ja avain vastaaviin kenttiin Erplyssä.
- Tarkista asetukset valitsemalla “Tallenna ja testaa”.
Netvisorin tukiartikkeli: https://support.netvisor.fi/fi/articles/766837-ohjelmistorajapintatunnusten-luominen
Varmista, että Erply-integraatiolla on oikeudet käyttää Netvisorin tietoja. Siirry kohtaan Yritysvalikko > Rajapintaresurssien käyttöoikeudet.
- Valitse hakukentän yläpuolelta “Räätälöidyt integraatiot”.
- Hae integraatiota avaimella 08DA944AEE50A4D8AD4C5C0AE18CA0EF. Haku palauttaa integraation “Erply Software OÜ / Erply Software Oy”.
- Napsauta kytkintä “Integraatio estetty”, jotta integraatio voi käyttää kaikkia resursseja.
Netvisorin tukiartikkeli: https://support.netvisor.fi/fi/articles/766836-rajapintaresurssien-kayttooikeuksien-salliminen-ja-poistaminen

Avaa Erplyssä Sovellukset > Kirjanpito > Netvisor integration.
Täytä kolme kenttää:
- Asiakastunnus
- Y-tunnus
- Asiakasavain

Poista vanha integraatio käytöstä.
- Klikkaa Erplyssä valikkorivin vanhaa ”Netvisor”-valikkokohtaa.
- Klikkaa kyseisellä sivulla ”Pysäytä”.

Ota lopuksi uusi integraatio käyttöön.
Vahvista kytkimellä, että olet poistanut vanhan integraation käytöstä, ja valitse ”Yhdistä”:

Vianmääritys
Jos lokissa näkyy virhe 1060 tai 1061, se tarkoittaa, että käyttöoikeuksia puuttuu.
Siirry Erplyssä kohtaan Asetukset > Käyttäjäryhmät. Avaa ryhmä nimeltä ”automation-group” (kaikki ajastetut tehtävät suoritetaan tämän ryhmän alla). Varmista, että ryhmällä on seuraavat oikeudet:
- Tällä käyttäjäryhmällä on pääsy → API, Muut sovellukset
- Laskut: Näytä (kaikki), Muokkaa vahvistamattomia, Muokkaa vahvistettuja
- Maksut: Näytä (kaikki), Lisää
- Asiakkaat: Näytä
- Tuoteluettelo: Näytä
- Sijainnit: Näytä
- Konfiguraatio (Muut päämoduulit): `netvisor_*`-parametrien lukemista ja kirjoittamista varten.
Esimerkki virheilmoituksesta:

Toiminnot
1. Päivittäinen myyti
Jokaiselle päivälle luodaan yksi tosite.
Tosite sisältää yhteenlasketut summat seuraavista:
- Tuotteiden myynnit ja palautukset – sisältää yhteenvedon kaikista myydyistä ja palautetuista tuotteista, joilla on sama kirjanpitotili ja ALV-kanta.
- Maksutapahtumat ja hyvitykset – rivillä tapahtumat on laskettu yhteen maksutavoittain.
- ALV-tapahtumat – yhteenlasketut ALV-tapahtumat.
Synkronointi tapahtuu tunnin kuluttua kalenteripäivän päättymisestä. Kalenteripäivän päättyminen määräytyy Erply-tilille asetetun aikavyöhykkeen mukaan. Kunkin tuotteen kirjanpitotili voidaan määrittää Erplyn tuotekortin kentässä 3. Oletustiliasetukset määritetään Netvisor-integraation asetuksissa. Kirjanpitotilitietojen on vastattava Netvisor-palvelun tilitietoja.
Kunkin ALV-kannan ALV-koodi määritetään Erplyn ALV-asetuksissa kohdassa “Vastaava ALV-koodi kirjanpito-ohjelmistossa”. Oletus-ALV-koodi asetetaan Elisa Kassa -palvelun Netvisor-asetuksissa. ALV-kannoille määritettyjen ALV-koodien on vastattava Netvisor-palvelun ALV-koodeja.
Maksutapojen tilinumerot määritetään Erplyn Netvisor-asetuksissa. Tilinumeroiden on vastattava Netvisor-palvelun tilinumeroita.
ALV-tilin numero määritetään Erplyn Netvisor-asetuksissa. Tilinumeron on vastattava Netvisor-palvelun tilinumeroita.
Rajoitukset:
- Siirrettäviin tietoihin sisällytetään vain myynnit ja palautukset, joiden tila on “maksettu” tai “palautettu”. Osittain maksettuja myyntejä ei siirretä.
- Menneelle päivälle päivättyjä myyntejä ja palautuksia ei siirretä.
- Tulevalle päivälle päivättyjä myyntejä ja palautuksia ei siirretä.
- Tuettu valuutta on euro; muita valuuttoja integraatio ei tue.
- Myyntitapahtumia voi olla enintään 250 päivässä.
2. Laskut
Ominaisuudet:
- Avoimet laskut (lasku–lähetysluettelo, maksun tila avoin) lähetetään Netvisor-palveluun maksamattomina laskuina.
- Asiakastietoja haetaan Netvisor-palvelusta; jos asiakasta ei löydy, asiakassuhde luodaan Netvisoriin. Haku perustuu Erplyn asiakasnumeroon.
- Sekä yksityis- että yritysasiakkaiden tietoja voidaan käyttää.
- Integraatio tukee seuraavia maksajatietoja:
- Maksajan osoite lähetetään Netvisoriin, jos osoitetiedot on määritetty.
- Asiakkaan sähköpostiosoite lähetetään Netvisoriin, jos se on määritetty.
- Verkkolaskutustiedot lähetetään Netvisoriin, jos ne on määritetty. Asiakaskortilla on oltava määritettynä “Verkkolaskuosoite” ja “Verkkolaskuoperaattori”.
Laskun maksutilatiedot välitetään palvelujen välillä. Eri valuutat ovat tuettuja. Kunkin tuotteen kirjanpitotili voidaan määrittää Erplyn tuotekortin kentässä 3. Oletustiliasetukset määritetään Erplyn Netvisor-asetuksissa. Kirjanpitotilitietojen on vastattava Netvisor-palvelun tilitietoja.
Kunkin ALV-kannan ALV-koodi määritetään Erplyn ALV-asetuksissa kohdassa “Vastaava ALV-koodi kirjanpito-ohjelmistossa”. Oletus-ALV-koodi asetetaan Erplyn Netvisor-asetuksissa. ALV-kannoille määritettyjen ALV-koodien on vastattava Netvisor-palvelun ALV-koodeja.
Rajoitukset:
- Netvisoriin lähetetään vain laskut, joiden maksun tila on “avoin”. Osittain maksettuja laskuja ei lähetetä.
- Tuotetietoja ei synkronoida Netvisoriin. Tuotetiedot lähetetään laskun mukana, mutta niitä ei synkronoida Netvisorin tuotetietoihin.
- Toimitustietoja ei synkronoida Netvisoriin.
- Yrityksen yhteyshenkilön tietoja ei lähetetä Netvisoriin.
- Toimipisteen ja kassan tietoja ei lähetetä Netvisoriin.
- Menneelle päivälle päivättyjä laskuja ei lähetetä Netvisoriin.
3. Maksutilan siirto
Ominaisuudet:
- Kun Netvisoriin lähetetty lasku maksetaan, maksutiedot siirretään Netvisor-palvelusta Erplyyn ja liitetään vastaavaan laskuun.
- Yhdistäminen tehdään laskunumeron perusteella.
- Osamaksut ja useat maksutapahtumat samaa laskua kohden ovat tuettuja.
- Laskun maksutiedot liitetään tilalla “isPaidInNetvisor”.
Rajoitukset:
- Menneelle päivälle päivättyjä maksutietoja ei voida hyödyntää.
- Tuettu valuutta on euro; muita valuuttoja ei tueta.
- Avoimia myyntitapahtumia voi olla enintään 25 päivässä.