Netvisor

🔗 Mitä integraatio tekee

Netvisor on suomalainen kirjanpito- ja taloushallinnon alusta. Thril–Netvisor-integraation avulla voit lähettää laskuja Thrilistä Netvisoriin, jossa ne kirjataan ja hallinnoidaan.

Tärkeää tietää:

• Laskut lähetetään manuaalisesti: yksitellen laskunäkymästä tai useita kerralla Laskut-listalta
• Integraatio määritetään yritystasolla ja koskee kaikkia kohteitasi
• Laskujen tilat synkronoidaan automaattisesti Netvisorista kahdesti päivässä
• Asiakastiedot synkronoidaan Netvisoriin laskun lähetyksen yhteydessä
• Voit kirjata maksuja ja poistaa niitä suoraan Thrilistä
• Voit luoda hyvityslaskuja lähetetyille laskuille
• Yritysasiakkaat synkronoidaan automaattisesti Netvisoriin, kun heidän ensimmäinen laskunsa lähetetään
• Jokaisella laskulla on kirjauspäivä, joka määrittää, mille kirjanpitokaudelle lasku kirjataan. Oletuksena se on laskun viimeisimmän varauskuukauden viimeinen päivä, mutta voit asettaa sen halutessasi itse laskua luodessasi tai muokatessasi

---

⚙️ Netvisorin konfigurointi

Ennen Thrilin yhdistämistä Netvisorissa on tehtävä useita esivalmisteluja. Käytä tätä osiota tarkistuslistana.

API-tunnukset

Netvisor-navigointi: Yritysvalikko → Ohjelmistorajapintatunnukset

Hanki Customer ID ja Customer Key. Nämä ovat organisaatiokohtaisia tunnuksia, jotka antavat Thrilille pääsyn Netvisor-tiliisi rajapinnan kautta.

Vaadittavat API-käyttöoikeudet

Netvisor-navigointi: Yritysvalikko → Rajapintaresurssien käyttöoikeudet

Rajapintaresurssien käyttöoikeudet -näkymästä voit lisätä integraation tai hyväksyä valmiin kumppanin. Valitse listasta Thril / Sportribe Oy ja salli integraatio. Tämä aktivoi Thrilille tarpeelliset rajapinnat tai näyttää ne vahvistettavaksi.

Seuraavat rajapinnat sisältyvät integraatioon:

Thril lukee tilikarttasi accountlist.nv-rajapinnan kautta, jotta Kirjanpitotilit-näkymässä ja yksittäisillä kohteilla voi valita yrityksesi todelliset tilit. Ilman tätä oikeutta kentät muuttuvat tekstikentiksi, joihin kirjoitat tilinumeron itse.

Netvisor myöntää salespaymentlist.nv-oikeuden erikseen muista myyntimaksujen rajapinnoista. Thril tarvitsee sitä lukeakseen Netvisoriin kirjatut maksut takaisin oikealle laskulle. Ilman sitä Netvisorissa maksetuksi merkitty lasku kirjataan yhtenä kertasummana, eikä yksittäisiä maksuja näytetä.

Laskentakohteiden otsikot

Tee tämä ennen integraation luomista Thrilissä. Thril ei pysty luomaan näitä otsikoita itse.

Netvisor-navigointi: Taloushallinto → Asetukset → Laskentakohteiden hallinta

Klikkaa Lisää uusi otsikko ja luo kaksi otsikkoa täsmälleen näillä nimillä:

• Laji
• Toimipaikka

Valmiina sivu näyttää tältä:

Jos otsikot puuttuvat, kun klikkaat Luo integraatio, Thril näyttää virheen "Vaaditut laskentakohteet-otsikot puuttuvat Netvisorista". Luo otsikot ja yritä uudelleen.

Maksutavat

Netvisor-navigointi: Myynti → Perustiedot ja asetukset → Maksutavat → Uusi maksutapa

Thril käyttää vaihtoehtoisia (ei-pankki) maksutapoja myyntimaksujen kirjaamiseen Netvisorissa. Seuraavat maksutavat on luotava ennen kuin maksuja voidaan kirjata Thrilistä:

Jos maksutapa puuttuu Netvisorista, maksun kirjaaminen kyseisellä tavalla epäonnistuu.

Laskujen automaattilähetys

Netvisor-navigointi: Myynti → Laskutuksen asetukset ja automaattilähetys

Thrilistä lähetetyt laskut päätyvät Netvisoriin myyntilaskuiksi, mutta Netvisor päättää, miten ja milloin ne toimitetaan asiakkaalle. Ota automaattilähetys käyttöön tässä näkymässä, jos haluat Netvisorin välittävän laskut asiakkaille (verkkolaskuna, sähköpostilla tai tulostuspalvelun kautta) ilman että hyväksyt jokaisen laskun Netvisorissa erikseen.

Jos automaattilähetys on pois päältä, laskut jäävät Netvisoriin odottamaan lähetystä ja sinun on lähetettävä ne Netvisorista manuaalisesti. Thrilissä lasku näkyy kummassakin tapauksessa Netvisoriin lähetettynä — Thrilin tila kertoo laskun tilan Netvisorissa, ei sitä, onko Netvisor toimittanut laskun asiakkaalle.

Automaattilähetys on Netvisorin puolen asetus ja koskee kaikkia Netvisor-organisaatiosi laskuja, ei vain Thrilistä tulevia. Jos et ole varma, miten se vaikuttaa muuhun laskutukseesi, varmista asia ensin kirjanpitäjältäsi tai Netvisor-asiakasvastaavaltasi.

Y-tunnus

Yrityksesi Y-tunnus Thrilissä on vastattava Netvisoriin rekisteröityä organisaatiota. Sitä käytetään organisaation tunnistamiseen jokaisessa API-kutsussa.

Vinkki: Jos tarvitset apua API-rajapintojen käyttöönotossa, laskentakohteiden otsikoiden luomisessa tai maksutapojen konfiguroinnissa, ota yhteyttä Netvisor-asiakasvastaavaasi tai Netvisorin tukeen.

---

🚀 Käyttöönotto Thrilissä

Varmista ennen aloittamista, että otsikot Laji ja Toimipaikka ovat olemassa Netvisorissa. Katso Laskentakohteiden otsikot.

1. Siirry kohtaan Asetukset → Järjestelmä → Integraatiot → Netvisor
2. Syötä Customer ID ja Customer Key
3. Aseta integraation tila tilaan Aktiivinen
4. Klikkaa Luo integraatio

Thril alustaa automaattisesti Netvisoriin tuotteet ja laskentakohteet. Kun alustus on valmis, voit aloittaa laskujen lähettämisen.

Yrityksellesi on oltava määritettynä kelvollinen Y-tunnus Thrilissä. Sitä käytetään Netvisor-organisaation tunnisteena.

---

🧾 Laskujen lähettäminen Netvisoriin

Yksittäisen laskun lähettäminen

1. Avaa lasku Laskut-sivulta
2. Valitse toiminto Lähetä Netvisor-järjestelmään
3. Lähetyksen jälkeen lasku saa Netvisor-viitenumeron

Laskutusosoite vaaditaan: Yksityisasiakkailla (Thril-sovelluksen käyttäjillä) on oltava täydellinen laskutusosoite profiilissaan ennen kuin heidän laskunsa voidaan lähettää Netvisoriin. Jos osoite puuttuu, lähetys epäonnistuu virheilmoituksella. Voit lisätä tai päivittää osoitteen asiakkaan profiilissa ennen uutta yritystä.

Kun lähetys epäonnistuu: lähetys tapahtuu taustalla, joten sen lopputulos selviää vasta sen jälkeen, kun laskunäkymä on jo hyväksynyt lähetyksen. Kunnes lasku on Netvisorissa, laskun tiedoissa näkyy Netvisorin omin sanoin, miksi viimeisin lähetys epäonnistui, ja sama syy löytyy Auditointiloki-välilehdeltä. Lasku vapautetaan heti, joten korjaa syy ja lähetä lasku uudelleen. Kun Netvisor hylkää kirjanpitotilin ALV-kannan, Thril luettelee syyn perässä hakasulkeissa tilit, jotka laskun riveille lähetettiin: yksi niistä on korjattava tili. Mitään ei kirjautunut, sillä Netvisor hylkäsi koko laskun.

Olemassa olevien Netvisor-asiakkaiden tunnistus: Kun lähetät Thril-sovelluksen käyttäjän laskun Netvisoriin ensimmäistä kertaa, Thril tarkistaa, onko Netvisorissa jo asiakas, jolla on sama sähköpostiosoite. Jos täsmälleen yksi vastaavuus löytyy, lasku liitetään tähän olemassa olevaan asiakkaaseen uuden luomisen sijaan, ja asiakkaan Thril-profiilista puuttuvat laskutustiedot (osoite, postinumero, kaupunki, maa, puhelinnumero) täydennetään Netvisorista. Thrilissä jo asetetut tiedot säilytetään. Jos vastaavuutta ei löydy tai useammalla Netvisor-asiakkaalla on sama sähköpostiosoite, Thril luo uuden asiakkaan kuten ennenkin. Tunnistus tehdään parhaan kyvyn mukaan eikä se koskaan estä laskun lähetystä.

Kun lasku on lähetetty Netvisoriin, Toiminnot-valikon Netvisor-osion lisätoiminnot:

• Päivitä tila Netvisor-järjestelmästä: päivitä laskun tila manuaalisesti Netvisorista
• Kirjaa maksu Netvisor-järjestelmään: kirjaa maksu laskulle (valitse ePassi, käteinen tai kortti pudotusvalikosta)
• Muokkaa Netvisor-järjestelmässä: muokkaa laskun tietoja ja vie muutokset Netvisoriin (muokkauslomakkeen otsikko: Muokkaa laskua Netvisor-järjestelmässä)
• Luo hyvityslasku: luo laskulle täysi hyvityslasku (Thrilin toiminto)
• Yhdistä hyvityslasku alkuperäislaskuun Netvisor-järjestelmässä: yhdistä hyvityslasku alkuperäislaskuun Netvisorissa (vain hyvityslaskuille, kun molemmat ovat avoimia)
• Poista Netvisor-järjestelmästä: poistaa laskun pysyvästi Netvisorista ja Thrilistä. Käytettävissä vain, kun lasku on Netvisorissa lähettämättömässä tilassa. Ennen poistamista pyydetään vahvistus. Jos laskun tila on muuttunut viimeisimmän synkronoinnin jälkeen, tila päivitetään automaattisesti ja virhe näytetään poistamisen sijaan.

Laskujen tilat synkronoidaan Netvisorista automaattisesti heti jokaisen toiminnon jälkeen (lähetys, maksun luonti, maksun poisto) sekä kahdesti päivässä taustalla, joten manuaalista synkronointia tarvitaan harvoin.

Useiden laskujen lähettäminen kerralla

Voit lähettää useita laskuja Netvisoriin yhdellä kertaa:

1. Siirry Laskut-sivulle
2. Valitse lähetettävät laskut valintaruuduilla
3. Avaa taulukon yläreunassa oleva valintavalikko ja valitse Lähetä Netvisor-järjestelmään

Laskut, jotka on jo lähetetty Netvisoriin, ohitetaan automaattisesti. Tulostekooste näyttää onnistuneiden määrän ja listaa epäonnistumiset syineen.

Laskujen vieminen Finvoice XML -tiedostona

Netvisor-integraation käyttöönoton yhteydessä saatat haluta siirtää Netvisoriin myös vanhat laskut, jotka on luotu Thrilissä ennen integraation aktivointia. Tämä onnistuu viemällä laskut Finvoice XML -tiedostona ja tuomalla tiedosto Netvisoriin manuaalisesti.

1. Siirry Laskut-sivulle
2. Klikkaa Vie dataa → Lataa Finvoice XML:nä
3. Valitse alkupäivämäärä ja päättymispäivä. Mukana on vain laskut, joiden laskutuspäivä osuu valitulle välille
4. Klikkaa Lataa
5. Tuo tiedosto Netvisorissa polun Yritysvalikko → Tietojen tuonti → Lasku-/maksuaineisto XML kautta

Kattavuus ja erän koko: Vienti sisältää vain sisäiset (Thril) laskut. Netvisor-laskutusjärjestelmään luodut laskut jätetään pois, eikä niitä esiinny tässä tiedostossa koskaan. Jos valitulle välille osuu 10 000 tai enemmän laskua, vienti hylätään kokonaan eikä tiedostoa luoda. Supista päivämääräväliä tai aja useita pienempiä vientejä eri päivämääräväleillä.

Ennen tuontia: Varmista, että asianomaiset alv-kaudet on avattu Netvisorissa. Laskujen tuonti avaamattomalle alv-kaudelle epäonnistuu.

Tärkeää: XML-tuonnilla tuodut laskut eivät linkity vastaaviin laskuihin Thrilissä. Netvisorissa tehdyt tilamuutokset (kuten laskun merkitseminen maksetuksi) eivät näy Thrilissä. Jos tilasynkronointi on tärkeää, käytä sen sijaan Lähetä Netvisor-järjestelmään -toimintoa.

Tämä vaihtoehto näkyy Vie dataa -valikossa vain, kun Netvisor-integraatiosi on aktiivinen.

---

Laskun luominen varaukselta

Kun luot laskun suoraan varaukselta (esimerkiksi Varaukset-sivulta), voit valita mihin järjestelmään lasku kuuluu: Thril (sisäinen lasku) tai Netvisor (lähetetään suoraan Netvisoriin). Laskutusjärjestelmä-valitsin näkyy laskun luontilomakkeessa, kun Netvisor on yhdistettynä.

Laskun siirtäminen toiseen laskutusjärjestelmään

Väärään järjestelmään luotua laskua ei tarvitse poistaa ja kirjoittaa uudelleen. Avaa lasku, valitse Toiminnot → Vaihda laskutusjärjestelmää ja valitse sitten uusi järjestelmä.

Toiminto on tarjolla vain niin kauan kuin kukaan Thrilin ulkopuolella ei ole nähnyt laskua: laskun on oltava lähettämätön, sitä ei ole vielä lähetetty ulkoiseen järjestelmään, eikä se voi olla hyvityslasku. Hyvityslasku yhdistetään alkuperäislaskuunsa ulkoisessa järjestelmässä, joten se pysyy siinä järjestelmässä, jossa alkuperäislasku on.

Numeroinnille tapahtuu eri asioita sen mukaan, minne lasku siirtyy, ja ikkuna kertoo tämän ennen vahvistamista:

• Netvisoriin: Thrilin laskunumerosta ja viitenumerosta luovutaan. Netvisor määrittää molemmat, kun lasku lähetetään sinne, eikä Thril anna vapautunutta numeroa uudelleen käyttöön. Kerro asiakkaalle, jos hän on jo saanut laskun vanhalla numerolla.
• Amiliin: lasku säilyttää numeronsa, ja Amili ottaa viitenumeron Thrilin lähettämästä laskusta.
• Thriliin: lasku säilyttää numeronsa, tai saa yrityksesi seuraavan vapaan numeron, jos se tuli Netvisorista, ja saa Thril-viitenumeron.

Netvisor vaatii joka riville tuotteen ja kotimaisen ALV-kannan, joita Thrilin lasku ei tarvitse. Siksi Netvisoriin siirrettäessä molemmat kysytään joka riville sen sijaan, että lähetys epäonnistuisi vasta myöhemmin. Varaukselta luotu rivi saa tuotteen varauksen lajista, ja muut rivit lähtevät Pro Shop -tuotteesta.

Muutos kirjataan laskun Auditointiloki-välilehdelle: järjestelmä ja laskunumero sekä ennen että jälkeen.

---

🏢 Yritysasiakkaat Netvisorissa

Kun lähetät yritysasiakkaan laskun Netvisoriin, asiakas luodaan automaattisesti Netvisoriin ja merkitään Thrilissä Netvisor-asiakkaaksi. Asiakasta ei voi merkitä Netvisor-asiakkaaksi manuaalisesti. Järjestelmä asettaa tunnisteen ensimmäisen lähetyksen yhteydessä.

Jotta ensimmäinen lähetys sujuu ongelmitta, täytä asiakkaan tiedot ennen lähetystä:

• ALV-tunnus: on oltava Netvisorin hyväksymässä muodossa (esim. FI12345678)
• Verkkolaskutustiedot (Finvoice): operaattoritunnus ja osoite. Asiakkaille, jotka on jo merkitty Netvisor-asiakkaiksi, operaattorikentässä näkyy Netvisorin hyväksymien koodien pudotusvalikko; muulloin kenttä on vapaan tekstin syöttökenttä.

Nämä tiedot sisällytetään automaattisesti kyseiselle asiakkaalle Netvisoriin lähetetyissä laskuissa.

Kaikki muutokset yritysasiakkaan tietoihin Thrilissä synkronoidaan automaattisesti Netvisoriin asiakkaille, joilla on jo tili Netvisorissa.

---

🔄 Tuotteiden ja laskentakohteiden synkronointi

Jos lisäät uusia kohteita tai lajityyppejä Thriliin alkuperäisen käyttöönoton jälkeen, käytä Synkronoi tuotteet ja laskentakohteet -painiketta Netvisor-integraation asetussivulla. Tämä:

• Luo uudet tuotteet Netvisoriin uusille lajityypeille
• Lisää uudet laskentakohteet uusille kohteille

Olemassa olevia tuotteita ja laskentakohteita Netvisorissa ei muuteta.

---

📊 Kirjanpitotilit

Jokainen Thrilistä Netvisoriin lähetetyn myyntilaskun rivi kirjautuu jollekin kirjanpitotilille. Kun määrität tilit täällä, kirjanpitäjäsi ei enää tiliöi kenttävuokria, valmennuksia, Pro Shopin tuotteita ja kahvilan myyntiä käsin uudelleen.

Netvisor lukee myös ALV-käsittelyn tililtä, joten valitse tilit, joiden ALV-käsittely vastaa myyntiä. Jos tilillä ei ole Netvisorissa ALV-tunnistetta, Netvisor hylkää koko laskun, ei vain sitä riviä, joka tilin nimesi.

Tilin asettaminen Netvisor-tuotteelle

1. Siirry kohtaan Asetukset → Järjestelmä → Integraatiot → Netvisor
2. Valitse Kirjanpitotilit Synkronoi tuotteet ja laskentakohteet -painikkeen vierestä
3. Valitse jokaiselle tuotteelle tili. Listan yläpuolella oleva laskuri kertoo, kuinka monelle tuotteelle tili on asetettu
4. Valitse Tallenna kirjanpitotilit

Listalla on yksi rivi jokaisesta tuotteesta, jonka synkronointi on luonut Netvisorin tuoterekisteriin: yksi jokaista liikuntapaikkojesi lajityyppiä kohti sekä Pro Shop -tuote. Tilit tulevat yrityksesi omasta Netvisorin tilikartasta, joka luetaan suoraan Netvisorista, ja listalla näkyvät käytössä olevat tilit numeroineen ja nimineen. Rivin tilin tyhjentäminen poistaa määrityksen.

Painike on käytettävissä, kun integraatio on aktiivinen. Jos lista on tyhjä, aja ensin Synkronoi tuotteet ja laskentakohteet ja palaa sitten tänne. Jos Thril ei saa luettua tilikarttaasi, esimerkiksi koska accountlist.nv-oikeutta ei ole myönnetty, rivi muuttuu tekstikentäksi ja kirjoitat tilinumeron itse.

Netvisorille kelpaavan tilin valitseminen

Jokainen tilivalitsin, sekä ikkunassa että yksittäisillä kohteilla, jakaa tilikarttasi kahteen ryhmään: Myyntitilit ja Muut tilit. Thril päättelee myyntiin kuuluvan osan Netvisorin oletusmyyntitileistäsi, joten oman tilikartan tehnyttä yritystä arvioidaan sen omalla tilikartalla.

Molemmista ryhmistä voi valita. Kenttävuokran kirjaaminen vuokratuottoihin ei ole väärin, joten myyntiryhmän ulkopuolinen tili on kentän alle tuleva varoitus eikä esto:

• Netvisor ei kirjaa myyntiä tälle tilille. Thril näyttää tämän, kun tili jää edellä päätellyn Myyntitilit-ryhmän ulkopuolelle. Lähetys voi epäonnistua, sillä Netvisor ottaa rivin ALV-käsittelyn tililtä ja hylkää kannan, jota tili ei kanna.
• Netvisorin tilikartassa ei ole tiliä nnnn. Tämän Netvisor hylkää suoraan. Tili joutuu tähän tilaan, jos se on kirjoitettu käsin tilikartan ollessa tavoittamattomissa tai jos tili on poistettu Netvisorista sen jälkeen, kun se tallennettiin tänne. Molemmat varoitukset vaativat tilikartan, jonka Thril saa luettua: kun accountlist.nv ei vastaa, kenttä on tavallinen tekstikenttä eikä varoita mistään.

Netvisorin rajapinta ei kerro tilin ALV-tunnistetta, joten Thril ei voi tarkistaa sitä ennen lähetystä. Käsittele ensimmäinen varoitus kehotuksena varmistaa tili kirjanpitäjältäsi, älä lopullisena tuomiona.

Valittavina ovat vain Netvisorissa käytössä olevat tilit. Sittemmin poistettu tili tunnistetaan edelleen siellä, missä se on jo tallennettu, joten mikään ei menetä tiliään huomaamatta.

Tilin ohittaminen yksittäisellä kohteella

Kirjanpitotili-kenttä on käytettävissä yksittäisillä hinnoitelluilla kohteilla: kentillä ja muilla varattavilla tiloilla, jäsenyyksillä, sarjakorteilla, palveluilla, tapahtumilla, tuntiryhmillä, liigojen luokilla, turnauksilla, saldolatauksilla ja Pro Shopin tuotevarianteilla. Käytä sitä, kun yhden kohteen tuotot kuuluvat eri tilille kuin muu saman tuotteen myynti. Jos jätät kentän tyhjäksi, kohde käyttää tuotteen tiliä.

Kenttä näkyy vain, kun Netvisor-integraatio on yhdistettynä, sillä mikään muu ei lue sitä.

Mille tilille rivi kirjautuu

Thril käyttää ensimmäistä näistä, joka on asetettu:

1. Myydyn kohteen oma Kirjanpitotili
2. Kohteen Netvisor-tuotteen tili. Päälajin tili kattaa myös sen alalajit, ellei alalajille ole asetettu omaa tiliä
3. Netvisorin oletusmyyntitili 3000

Kassamyynnin rivi ja jäsenyysjakson rivi eivät enää kerro, mitä ne myivät, kun lasku on luotu. Niiden tili ratkaistaan laskun luonnin yhteydessä ja tallennetaan riville, joten kohteen tilin muuttaminen jälkikäteen ei siirrä jo luotuja laskuja. Hyvityslasku kirjautuu samalle tilille kuin rivi, jonka se hyvittää, ja Lataa Finvoice XML -tiedostona -vienti ratkaisee tilit samalla tavalla.

---

✏️ Integraation päivittäminen tai poistaminen käytöstä

Voit päivittää Netvisor-tunnuksesi milloin tahansa kohdasta Asetukset → Järjestelmä → Integraatiot → Netvisor. Jätä tunnuskenttä tyhjäksi säilyttääksesi nykyisen arvon.

Poistaaksesi integraation käytöstä vaihda integraation tila tilaan Ei aktiivinen. Näyttöön tulee vahvistusviesti, sillä et voi enää lähettää laskuja Netvisoriin integraation ollessa poissa käytöstä.

Voit ottaa integraation uudelleen käyttöön milloin tahansa vaihtamalla takaisin tilaan Aktiivinen.

---

🛠️ Tarvitsetko apua?

Jos sinulla on kysyttävää Thril-integraation käyttöönotosta, ota yhteyttä tukitiimiimme osoitteessa support@thril.fi.

Jos sinulla on kysyttävää Netvisorin API-tunnuksista, portaalin konfiguroinnista tai Netvisor-tilistäsi, ota yhteyttä Netvisor-asiakasvastaavaasi tai Netvisorin tukeen.