--- title: "Netvisor" canonical: "https://support.vitec-hotellinx.com/space/KB/142376963/Netvisor" format: markdown --- [lisäosa] Hotellinx Cloudin Netvisor-integratioon sisältyy sekä reskontralaskujen siirto Netvisorin myyntireskontraan että myyntien siirto Netvisorin kirjanpitoon. - Reskontralaskut ja kirjanpitoaineiston voi siirtää erikseen tai samalla kertaa. - Laskut voi siirtää lähettämättöminä (**unsent**), jos ne on tarkoitus lähettää Netvisorista eteenpäin sähköisinä laskuina. - Laskut voi siirtää avoimina (**open**), jos ne lähetetään asiakkaille suoraan Hotellinxista. - Siirrettävän kirjanpitoaineiston voi hakea kirjauspäivän tai laskun päätöspäivän perusteella. Netvisor-integraatio on Hotellinx Cloudin lisäominaisuus. Saat lisätietoja [ottamalla meihin yhteyttä](https://support.vitec-hotellinx.com/space/KB/37814278). --- ## Integraation aktivointi Netvisorissa Integraation aktivointiin liittyy tunnusten luominen sekä ominaisuuksien aktivointi Netvisorissa. 1. Aloita tunnusten luominen Netvisorissa painamalla yritystä ja valitse **Ohjelmistorajapinta ja tunnisteet **-ikkuna. ![image-20260105-101400.png](media://a75e07fd-09e3-4590-84a1-c41206b86970) 2. Olemassa olevat tunnukset on listattu **Yrityksen rajapintakäyttäjät **-taulukossa. Paina **Luo uusi rajapintatunnus**, jolloin Netvisor luo käyttäjätunnisteen ja avaimen ja lisää ne listalle. ![image-20260105-101427.png](media://825b5f65-300c-4ab2-985a-b97d777bc2f8) - **Käyttäjätunniste**: tämä merkitään Hotellinxin rajapinta-asetusten kohtaan **Customer Id**. - **Avain**: tämä merkitään Hotellinxin rajapinta-asetusten kohtaan **Private key**. 3. Siirry ominaisuuksien aktivointiin painamalla yritystä ja valitse **Rajapintaresurssien oikeudet**. ![image-20260105-101448.png](media://e30b715f-5430-4f6a-b566-e79222118cf3) 4. Valitse **Räätälöidyt integraatiot** ja hae integraatio syöttämällä hakukenttään Hotellinx-tuesta saamasi integraatio-avain. 5. Varmista, että integraation nimenä näkyy **Hotellinx Systems Oy / Hotellinx** ja salli sen jälkeen tarvittavat resurssit (muuta resurssin tila > **Sallittu**). ![image-20260105-101515.png](media://8c383490-8c89-401a-8900-eaa70df83af2) Hotellinx-integraatio vaatii, että seuraavat resurssit on sallittu: - **customerlist.nv** - **getcustomer.nv** - **customer.nv** - **salesinvoice.nv** - **accounting.nv** 5. Integraation tilan pitää olla **Integraatio sallittu**. Asetus tulee automaattisesti päälle kun resurssit on sallittu. --- ## Asiakkaan NetvisorKey ja muut tiedot Hotellinxissä Netvisorin asiakasnumero (**NetvisorKey**) vastaa Hotellinxin asiakastietueen **External Id **-kenttää. 1. Netvisorissa olevien asiakkaiden asiakasnumerot (**NetvisorKey**) voi syöttää Hotellinxin asiakasrekisteriin jo ennen siirtoa. Asiakasnumero näkyy Netvisorin asiakasnäkymässä selaimen osoiterivillä. ![image-20260105-101544.png](media://fb2808bc-378f-42a1-bf75-cc82bdc65538) 2. Hotellinxin asiakastietueesta tulee lisäksi löytyä seuraavat tiedot: - **Buyer Organisation Unit**: OVT-tunnus. - **Country**: maakoodi (esimerkiksi **FI**). - **Remarks**: jos asiakas on yksityisasiakas, tähän kenttään merkitään **#2**. 3. Jos asiakastietuetta ei vielä ole Netvisorissa, se luodaan automaattisesti reskontrasiirron yhteydessä. Samalla uusi **NetvisorKey** lisätään Hotellinxin asiakastietueen **External Id **-kenttään. ![image-20260105-101608.png](media://0e493418-8a5f-4ef2-ac9f-aeecbf2a496c) --- ## Tiliöintitiedot Tiliöintitiedot (tilit, kustannuspaikat, alikustannuspaikat, projektit, tuotteet) tulee määritellä samalla tavalla Hotellinxissa ja Netvisorissa. Jos tiedot tai kirjoitusasu eivät täsmää keskenään, siirrot eivät onnistu. - Määrittele Netvisorissa kirjanpitotilit, kustannuspaikat, alikustannuspaikat, projektit ja tuotteet. - Varmista, että Hotellinxissa on vastaavat myyntilajit sekä maksutavat ja lisää niille tiedot, mitä Netvisorin tiliä, kustannuspaikkaa, alikustannuspaikkaa, projektia ja tuotetta ne vastaavat. Tiedot erotellaan kauttaviivalla ja väliviivalla, joten otsikot eivät saa sisältää väliviivoja tai kauttaviivoja. Merkit voi tarvittaessa muuttaa esimerkiksi alaviivoiksi. ### Netvisor Kirjanpitotilit ovat Netvisorissa **Taloushallinto**-otsikon alla. ![image-20260105-101628.png](media://412325c8-05fd-428b-b9dd-5c447acedaaf) Kustannuspaikat, alikustannuspaikat, projektit, jne. ovat Netvisorissa laskentakohteiden otsikoita. ![image-20260105-101648.png](media://23ffe448-7e3b-48ff-8788-de703fa00f7f) Otsikoiden tulee täsmätä Hotellinxin myyntilajien ja maksutapojen **Account**-kentän tietojen kanssa. ### Hotellinx Tilit, kustannuspaikat, alikustannuspaikat ja projektit määritellään hotellin asetuksissa. 1. Avaa päävalikosta **Hotel settings** > **Posting codes**. 2. Avaa myyntilajin asetukset painamalla rivin alussa **Edit**. ![image-20260105-101707.png](media://c98c6e72-ba40-4590-b702-aff4826d633d) 3. Lisää tili- ja kustannuspaikkatiedot **Account**-kenttään. ![image-20260105-101722.png](media://9c8caf70-ab79-4fae-8665-b8e0df8b52dc) - Kirjoita tiedot muodossa **tilinumero/otsikko-kustannuspaikka/otsikko-(ali)kustannuspaikka/** jne. - Esimerkki: *3100/Kustannuspaikka-2222 Majoitus/Alikustannuspaikka-3333 Huoneisto.* - **3100**: kirjanpitotili Netvisorissa. - **2222 Majoitus**: kustannuspaikka Netvisorissa. - **3333 Huoneisto**: alikustannuspaikka Netvisorissa. ![image-20260105-101739.png](media://347d3204-583c-48b8-9021-7f7f076f3e41) --- ## Siirtojen asetukset Siirrot tehdään tilitasolla (Hotellinxin **sales code**) ja siirroissa käytetään aina samaa Netvisorin oletustuotetta. 1. Avaa siirtojen asetusten määrittelysivu valitsemalla päävalikossa **More** > **Export** > **Export for back office** > **Netvisor Export** > **Settings**. ![image-20260105-101834.png](media://3645993f-a7df-4fe0-97cf-642a0fa8c404) 2. Hotellinx täyttää tiedot **Service URL**, **Partner Id** ja **Partner Key**-kenttiin. - **Client name/id:** hotellin nimi/tunnus, vastaava kuin Netvisorissa (**Yrityksen perustiedot ja asetukset**). - **Customer Id**: hotellin integraatiotunnus, vastaava kuin Netvisorissa (**Ohjelmistorajapinta ja tunnisteet**), ks. *Integraation aktivointi Netvisorissa* yllä. - **Organisation Id**: hotellin tunniste (yleensä y-tunnus), vastaava kuin Netvisorissa (**Yrityksen perustiedot ja asetukset**). - **Private Key**: hotellin integraatio-avain, jonka Netvisor on luonut automaattisesti (ks. *Integraation aktivointi Netvisorissa* yllä). - **Product Id**: Netvisor-tuote (Integraatio on tili-tasolla, kaikissa siirroissa käytetään samaa Netvisor-tuotetta). - **Voucher balance account**: kirjanpitosiirron avoimen saldon Netvisor-tili. - **Account suggestion**: Netvisorin korjaustili. - **Sales inv. status**: siirrettävien laskujen status (valitse **unsent**, jos laskut lähetetään eteenpäin Netvisorista; valitse **open**, jos ne on jo lähetetty ja haluat vain siirtää ne Netvisorin reskontraan). - **Voucher class**: valitse **Kassa** ellei ole sovittu muuta. > ℹ️ **Netvisorin korjaustili** > ℹ️ > ℹ️ - Netvisorissa myyntireskontran laskut menevät automaattisesti myös kirjanpitoon. > ℹ️ - Jos reskontralaskut ja kirjanpitoaineisto siirretään samanaikaisesti **ja** kirjanpitoaineisto siirretään kirjauspäivän perusteella, reskontralaskujen myynnit siirtyvät käytännössä kahteen kertaan. > ℹ️ - Tässä tapauksessa laskujen myynti kirjataan Netvisorin korjaustilille, joka oikaisee tiedot. --- ## Siirrot Aineistojen siirrot voi tehdä päivä kerrallaan tai pidemmältä ajanjaksolta. Kyseisen päivän/jakson yöajon täytyy olla suoritettu. Netvisoriin voi siirtää yhdellä kertaa joko reskontralaskut, kirjanpito-aineiston tai molemmat. 1. Avaa Netvisor-siirtoikkuna valitsemalla päävalikossa **More** > **Export** > **Export for back office** > **Netvisor export** > **Export data**. ![image-20260105-101908.png](media://983e8c18-531c-41a5-b762-89eea0d1a4f9) 2. Valitse ajanjakso ja siirrettävä aineisto. - **Vouchers (Bookkeeping)**: siirrä kirjanpitoaineisto. - **Invoices (Sales ledger)**: siirrä reskontralaskut. - **Export both**: siirrä kirjanpitoaineisto ja reskontralaskut. - **Bookkeeping (voucher) data is sales based**: tee kirjanpitoaineiston siirto kirjauspäivän perusteella. 3. Hae tiedot painamalla **Get data**. - Siirrettävä data haetaan Hotellinxista ja olemassa olevat asiakastiedot haetaan Netvisorista. - Laskut haetaan valitulta aikaväliltä, laskun päätöspäivän mukaan. 4. Valitun ajanjakson laskut tuodaan **Invoices**-välilehdelle. ![image-20260105-101953.png](media://2269c232-745e-473d-a3fd-54d75b8a3c68) 5. Laskun tila näkyy rivin viimeisessä sarakkeessa. - **[Ready]**: lasku on valmiina lähetettäväksi. - **[OK] exported**: lasku on jo lähetetty Netvisoriin. Voit lähettää laskun uudelleen painamalla laskurivin **Export**-painiketta. Jos lasku löytyy jo Netvisorista, uudelleenlähetys ei onnistu. - ****[ERROR] ... ****: laskussa on virhe, joka tulee korjata ennen kuin laskun voi lähettää Netvisoriin. > 📝 Punainen neliö laskurivin alussa ja rivin lopussa oleva virheilmoitus tarkoittaa, että laskua ei voida siirtää. Virheilmoitus voi olla esimerkiksi **[ERROR] Failed to create new customer** (uuden asiakkaan luonti Netvisorissa ei onnistu). Voit hakea tarkempia tietoja ja apua virheen korjaamiseen lokitiedostoista. Lokit tallentuvat työasemalle määriteltyyn yöajon raporttien tallennuskansioon (**Settings** > **Database settings** > **Archive folder**). > 📝 > 📝 Valmiina olevat laskut sekä kirjanpitoaineiston voi kuitenkin lähettää virheilmoituksesta huolimatta. 6. Voit avata yksittäisen laskun tiedot painamalla laskuriviä. ![image-20260105-102035.png](media://565bce58-315e-457e-bb11-50e2d2a8c3f2) 7. Valitun ajanjakson päiväkohtaiset kirjanpitoaineistot tuodaan **Vouchers**-välilehdelle. ![image-20260105-102053.png](media://3b429abb-0e0e-4ee4-b838-08f550b45ad8) 8. Aineiston tila näkyy rivin viimeisessä sarakkeessa. - Jos sarake on tyhjä, aineisto on valmiina lähetettäväksi. - **[OK] exported**: aineisto on jo lähetetty Netvisoriin. Voit tarvittaessa lähettää aineiston uudelleen painamalla aineistorivin **Export**-painiketta. - ****[ERROR] ... ****: aineistossa on virhe, joka tulee korjata ennen kuin aineiston voi lähettää Netvisoriin. 9. Voit avata yksittäisen päivän myynnit painamalla aineistoriviä. ![image-20260105-102116.png](media://aab70369-5f0b-4354-9dff-c24a7e5bab36) 10. Siirrä valitut aineistot Netvisoriin painamalla ikkunan oikeassa ylälaidassa **Export**. - **Vouchers (Bookkeeping)**: siirrä kirjanpitoaineisto. - **Invoices (Sales ledger)**: siirrä reskontralaskut. - **Export both**: siirrä kirjanpitoaineisto ja reskontralaskut. - **Bookkeeping (voucher) data is sales based**: tee kirjanpitoaineiston siirto kirjauspäivän perusteella. Jos tätä ei valita, siirto tehdään päätettyjen laskujen perusteella. > ℹ️ Kirjanpitoaineisto perustuu myyntiraporttiin (**Sales report**). Siirrot voi tehdä: > ℹ️ > ℹ️ - myynnin/maksun kirjauspäivän perusteella (**Sales report (based on sales)**) > ℹ️ - päätettyjen laskujen perusteella (**Sales report (based on invoices)**).