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
• Ulkoiset asiakkaat synkronoidaan automaattisesti Netvisoriin, kun heidän ensimmäinen laskunsa lähetetään

---

⚙️ 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än kautta aktivoidaan (tai näytetään vahvistettavaksi) Thrilille tarpeelliset rajapinnat.

Seuraavat rajapinnat sisältyvät integraatioon:

Laskentakohteiden otsikot

Netvisor-navigointi: Taloushallinto → Laskentakohteiden hallinta

Thril käyttää kahta laskentakohdeotsikkoa laskujen luokitteluun. Nämä otsikot on luotava manuaalisesti ennen yhdistämistä — rajapinta voi lisätä kohteita vain olemassa olevien otsikoiden alle, ei luoda itse otsikoita. Lisäksi jokaiseen otsikkoon täytyy luoda ainakin yksi paikkamerkki-kohde: ilman sitä otsikko ei välttämättä palautu rajapinnan vastauksessa.

• Laji — käytetään laji- ja palvelutyyppeihin (esim. Tennis, Padel, Kahvila)
• Toimipaikka — käytetään kohteen nimeen (esim. Tenniskeskus Helsinki, Padelareena Turku)

Kun luot integraation Thrilissä, laskentakohteiden arvot täytetään automaattisesti näiden otsikoiden alle. Sinun tarvitsee vain varmistaa, että molemmat otsikot ovat olemassa etukäteen.

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.

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ä

1. Siirry kohtaan Asetukset → 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ä järjestelmään Netvisor
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 lasku on lähetetty Netvisoriin, käytettävissä on lisätoimintoja:

• Synkronoi tila — päivitä laskun tila manuaalisesti Netvisorista
• Luo maksu — kirjaa maksu laskulle Netvisorissa (valitse ePassi, käteinen tai kortti pudotusvalikosta)
• Muokkaa laskua järjestelmässä Netvisor — muokkaa laskun tietoja ja vie muutokset Netvisoriin
• Luo hyvityslasku — luo laskulle täysi hyvityslasku

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ä Netvisoriin

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

Laskun luominen varaukselta

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

---

🏢 Ulkoiset asiakkaat Netvisorissa

Kun lähetät ulkoisen asiakkaan 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 ulkoisen asiakkaan 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.

---

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

Voit päivittää Netvisor-tunnuksesi milloin tahansa kohdasta Asetukset → 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.