Viimeisin päivitys:16.4.2024
Voimassa alkaen: 2024.06.00
Asiakasreskontran vienti Visma.netiin
Opterilla on integraatiot kolmeen eri Visma-järjestelmään, joilla on erilaisia toimintoja. Tarkista, mikä järjestelmä yrityksessänne on käytössä:
-
Visma.net (katso kohta Asiakasreskontran vienti Visma.netiin)
-
Visma e-conomic (katso kohta Laskunvienti Visma e-conomiciin ja Tilitysvienti Visma e-conomiciin )
-
Visma eEkonomi/eAccounting (katso kohta Kirjanpidon vienti Visma eEkonomi-ohjelmaan )
Voit luoda Visma.net-asiakasreskontrakirjauksia Opterissa luotujen laskujen perusteella. Asiakkaat, jotka laskutetaan Opterissa, lisätään Visma.netiin (jos ne eivät vielä ole siellä) tai päivitetään (jos niiden tietoja on muutettu Opterissa myöhemmin kuin Visma.netissä).
Sinun on tiedettävä Visma-yritystunnuksesi, jotta voit määrittää laskunviennin. Saat lisätietoa Vismalta.
Lisätietoja on myös Visma API -dokumentaatiossa.
Integroinnin aloittaminen
Jotta Opter ja Visma.net voidaan yhdistää, laskun vientiin on lisättävä tenant ID. Tee näin:
-
Ota yhteyttä osoitteeseen ja pyydä kutsua Visma.netiin. Opter luo kutsun ja lähettää sen sinulle.
-
Kun saat kutsusähköpostin, kirjaudu Visma App Storeen, käytä kutsukoodia ja hyväksy integroinnin ehdot. Tämän jälkeen Opter saa viestin, että tenant ID voidaan hakea.
-
Kun olet hyväksynyt ehdot, Opter lisää tunnuksen kenttään Salasana laskun viennissä. Sitä ei näytetä tekstinä, vaan ainoastaan pisteinä. Tenant ID:tä käytetään järjestelmien välisen integroinnin todentamiseen, eikä se ole henkilökohtainen salasana.
Luo laskunvienti Opterissa
Valitse Hallinto > Laskut > Laskunvienti ja luo uusi laskunvienti valitsemalla .
Seuraavat kentät on täytettävä välilehdellä Yleinen:
-
Nimi: Esimerkiksi ”Visma.net”.
-
Laji: Visma.net.
-
Merkkikoodaus: UTF-8.
-
Salasana: Lisätty Opterin toimesta (katso kohta Integroinnin aloittaminen edellä). Näytetään vain pisteinä.
-
Toimiston koodi: <Yritystunnus>-<osastotunnus> (jos käytössä), esimerkiksi ”12345” (vain yritystunnus) tai ”12345-1” (yritystunnus ja osastotunnus).
-
Käytä asiakasnumeroa asiakastunnuksen sijasta
: Opterin asiakkaat kohdistetaan Visma.netissä oleviin asiakkaisiin asiakaskoodin sijaan reskontranumeron avulla.
Lisäksi voidaan määrittää seuraavat asetukset:
-
Sisällytä PDF-kopio
: PDF-kopio laskusta liitetään laskunvientiin ja siitä tulee laskun liite Visma.netissä.
-
Pienennä PDF-tiedoston kokoa: Jos haluat pienentää PDF-tiedoston kokoa, voit merkitä tämän valintaruudun. Tiedoston kokoa pienennetään poistamalla kaikki tekstin muotoilut (lihavointi, kursivointi, alleviivaus) ja vaihtamalla fontti sellaiseen, joka käyttää vähemmän tallennustilaa. Se, kuinka paljon tiedostokoko pienenee, riippuu muun muassa siitä, kuinka paljon muotoilua tiedosto sisältää.
-
Aloitusteksti: Tässä kentässä voit määrittää, että laskuntuonnin yhteydessä tulee tehdä erilaisia asetuksia Visma.netissä. Kirjoita jokainen haluttu asetus omalle rivilleen. Tässä tehdyt asetukset ohittavat kaikki Visma.netissä tehdyt asetukset. Jos et muuta näitä asetuksia, käytetään Visma.netissä tehtyjä asetuksia.
Asetus Selitys overrideNumberSeries=true/false true: Visma.netissä käytetään Opterin laskunumeroa.
false: Visma.netissä käytetään Visma.netin laskunumeroa.
Jos käytät ARINVOICE-numerosarjaa Visma.netissä ja haluat käyttää Opter-laskunumeroa, sovelletaan seuraavaa:
-
Merkitse valintaruutu Manuaalinen laskutus Visma.netissä. Tällöin tämän asetuksen arvoksi ei tarvitse määrittää ”true”.
-
Merkitse valintaruutu Salli manuaalinen numerointi tuonnin yhteydessä Visma.netissä ja määritä asetuksen arvoksi ”true”.
disableCustomerExport=true/false true: Asiakastietoja ei lähetetä Opterista Visma.netiin. Tämä voi hyödyllistä esimerkiksi silloin, jos asiakas edellyttää tiettyjä asetuksia, joita ei voi säätää Opterista. Asiakas on tällöin luotava ensin manuaalisesti Visma.netissä. Jos asiakasta ei ole Visma.netissä ja tämän asetuksen arvo on ”true”, näyttöön tulee virheilmoitus, kun lasku viedään Opterista.
false: Asiakastiedot lähetetään Opterista Visma.netiin ja asiakas luodaan Visma.netissä.
disableCustomerUpdate=true/false true: Jos asiakas on jo Visma.netissä, Opter ei päivitä olemassa olevia asiakastietoja. Tämä voi olla hyödyllistä, jos käytössä on myös muita integroituja järjestelmiä, jotka päivittävät Visma.netiin tietoja, joita ei tule muuttaa. Jos asiakasta ei ole Visma.netissä, se luodaan tavalliseen tapaan (ellei disableCustomerExport = true, katso yllä).
false: Opter päivittää asiakastiedot Visma.netiin.
dontEmail=true/false true: Laskua ei lähetetä sähköpostitse Opterista tuonnin jälkeen.
false: Lasku lähetetään sähköpostitse Opterista tuonnin jälkeen.
dontPrint=true/false true: Laskua ei tulosteta Opterista tuonnin jälkeen.
false: Lasku tulostetaan Opterista tuonnin jälkeen.
sendToAutoInvoice=true/false true: Opterista tuodut laskut välitetään Visma Auto Invoiceen.
false: Opterista tuotuja laskuja ei välitetä Visma Auto Invoiceen.
paymentMethodId = maksutavan tunnus Visma.netistä Visma.netissä oleva maksutavan tunnus, jolla haluat Opterista tuodun laskun maksettavan. Voit esimerkiksi käyttää laskujen OCR-numeroita, jotka luodaan Visma.netissä ja laskuja, jotka on tuotu Opterista.
useCustomerClass=true/false true: Opterin asiakasrekisterissä olevaa asiakasryhmää käytetään asiakasluokkana Visma.netissä.
false: Visma.netissä määritettyä asiakasluokkaa käytetään. (Sama tulos kuin jos asetus jätetään pois kohdassa Aloitusteksti.)
periodDateSource=CreateDate/AccountingDate Kirjanpitojakso, johon laskujen tulee sisältyä Visma.netissä.
CreateDate: laskutuskauden luontipäivä Opterissa.
AccountingDate: laskujen tiliöintipäivä Opterissa (kirjauspäivä/tapahtumapäivä).
includeExchangeRate=true/false true: Laskuvaluutan ja järjestelmävaluutan välinen vaihtokurssi lähetetään Opterista Visma.netiin käytettäväksi. Näin eri valuutoissa olevat summat täsmäävät Opterin ja Visma.netin välillä.
false: Vaihtokurssia ei lähetetä Visma.netiin. Jos järjestelmissä on eri vaihtokurssit, eri valuutoissa olevat summat eivät välttämättä täsmää Opterin ja Visma.netin välillä. Tämä voi olla hyödyllistä, jos maksuja ei rekisteröidä Opterissa eikä järjestelmien välisiä eroja tarvitse ottaa huomioon.
vatCustomerClassMapping Käytetään yhdistämään Opterin ALV-koodit/ALV-kannat Visma.netin asiakasluokkien mukaisesti. Voit määrittää, että asiakkaat, joilla on tietty ALV-kanta (asiakasrekisterin välilehti Hinnoittelu), kuuluvat tiettyyn asiakasluokkaan Visma.netissä. Näet asiakasluokat Visma.netissä.
Syntax (JSON):
vatCustomerClassMapping={"ALV-koodi Opterissa": "asiakasluokka Visma.netissä","ALV-koodi Opterissa: "asiakasluokka Visma.netissä"}
Esimerkki:
vatCustomerClassMapping={"25%": "10","12%": "10","6%": "10","BM": "10","EU": "20","0%": "30"}
-
ALV-koodit
Visma.net käyttää kiinteitä ALV-koodeja, joita ei voi muuttaa. Siksi Opterin ALV-koodit on käännettävä ALV-koodeiksi, joita Visma.net käyttää.
Siirry välilehdelle Koodeja ja valitse Verokannat pudotusvalikosta. Täytä sitten Visma.netin ALV-koodit sarakkeeseen Koodi jokaiselle Opterista löytyvälle ALV-kannalle. ALV-koodi on syötettävä täsmälleen sellaisena kuin se näkyy Visma.net-ohjelmassa. Jos ALV-koodi on ”01” Visma.netissä, sen tulee olla ”01” myös sarakkeessa Koodi. Kohtaan ei voi kirjoittaa ”1”.
Asiakasreskontran vienti Visma.netiin
Valitse Hallinto > Laskut > Laskunvientiasetukset ja merkitse ”Visma.net” (tai laskunviennille antamasi nimi) niitä asetuksia varten, jotka luovat viennin Visma.netiin. Koska kaikki laskut on kirjattava, vienti on valittava kaikille vientiasetuksille.
Voit viedä laskutiedot Opterista laskutuskauden sulkemisen yhteydessä tai sen jälkeen, kun olet valinnut, haluatko viedä kokonaisia laskutuskausia vai yksittäisiä laskuja.
-
Jos vietävään laskuun merkittyä asiakasta ei ole Visma.netissä, Opter yrittää luoda asiakkaan Visma.netiin.
Asiakasvienti voidaan poistaa käytöstä kirjoittamalla kohtaan Aloitusteksti ”disableCustomerExport=true”. Tästä on hyötyä silloin, kun haluat estää Opteria muuttamasta asiakastietoja Visma.netissä. Näyttöön tulee virheviesti, jos asiakasta ei ole Visma.netissä ja asiakasvienti on poistettu käytöstä.
-
Opterissa näkyvät tilinumerot, maksuehdot, tulosyksiköt, valuutat ja asiakasluokat on oltava Visma.netissä. Jos jotakin puuttuu, näyttöön tulee lisätietoja sisältävä virheviesti.
-
Virheviesti: Visma.net ei hyväksynyt käyttäjätietoja (tenant id: {0})
Ota yhteyttä osoitteeseen ja pyydä tukea syöttämään laskun viennin salasana uudelleen.
Muita mukautuksia
Visma.netin laskurivien ulkoasua on mahdollista mukauttaa XSLT-muunnoksen avulla. Ota yhteyttä osoitteeseen saadaksesi lisätietoja.
Viitemateriaalit