Resurssi: salesinvoice.nv
HTTP-metodi: POST
Rajapinta mahdollistaa myyntilaskun, sen tuote-, kommentti- ja välisummarivien, liitteiden, laskun tositerivien sekä laskun asiakaskohtaisten kenttien tuonnin tai päivityksen Netvisoriin.
Tässä resurssissa pakolliset kentät ovat:
- Laskun/tilauksen päiväys
- Laskun/tilauksen loppusumma
- Laskun/tilauksen tila
- Laskuasiakkaan linkitystieto
- Maksuehdon nettopäivät tai eräpäivä
- Ainakin yksi laskurivi, jolla on seuraavat tiedot:
- Tuotteen linkitystieto
- Tuotteen nimi
- Tuotteen yksikköhinta
- Tuotteen alv-prosentti ja -koodi
- Kappalemäärä
Lasku on mahdollista tuoda myös tilassa "Luonnos" (invoicedraft). Luonnokselle ei anneta laskunumeroa eikä luonnokselle voi tuoda tositetietoja. Luonnos voidaan päivittää laskuksi metodilla edit.
Hyvityslasku tuodaan rajapinnan yli myyntilaskun sanomarakennetta noudattaen. Sanoma poikkeaa vain siltä osin, että kappalemäärä (SalesInvoiceProductlineQuantity) ja loppusumma (SalesInvoiceAmount) asetetaan sanomalle negatiivisin luvuin. Mikäli myyntilaskun sanomalla annetaan ALV:n määrä (salesInvoiceProductLineVatSum) ja rivisumma (salesInvoiceProductLineSum), pitää myös nämä antaa negatiivisin luvuin.
Rajapinnan yli tuotu hyvityslasku ei kohdistu automaattisesti olemassa olevaan myyntilaskuun. Kohdistus tulee tehdän joko rajapinnan yli resurssilla matchcreditnote.nv tai käsin, ohje toimintoon: Hyvityslaskun kohdistaminen veloituslaskuun
Netvisor pyöristää nettorivisumman ja laskun summan rajapinnan läpi tuotaessa kahden desimaalin tarkkuuteen. Tämä voi joissain tapauksissa aiheuttaa pyöristyseroja, jotka tulee täsmäyttää tositteella. Jos pyöristyseroja ei haluta, voi yksikkö-, rivi- ja ALV-summan tuoda valmiina pyöristettynä kahdella desimaalilla.
Laskutus– ja toimitusasiakkaat kohdistetaan myyntilaskuun joko Netvisor- tai asiakaskohtaisen avaimen perusteella. Netvisor-avain on tietokannan ID Netvisorissa ja asiakaskohtainen avain on käyttäjän asiakkaalle antama asiakaskoodi. Avaimet saa tietoon hakemalla asiakkaan tiedot rajapinnan tarjoamalla asiakaslista –pyynnöllä.
Jos sanomalla tuodaan ainoastaan invoicingcustomeridentifier tieto, laskulle haetaan asiakkaan laskutusosoite ja toimitusosoite Netvisorin asiakaskortin takaa. Jos aineistolla on annettu mikä tahansa muu laskutusasiakkaan tieto (esim. postiosoite), niin tietoja ei enää haeta asiakaskortilta laskulle.
Laskun kielenä käytetään Netvisorin asiakkaan taakse määriteltyä laskun kieltä (suomi, ruotsi tai englanti).
Netvisorin hintakertoimet ja asiakashinnat huomioidaan laskuriveille, kun myyntilaskusanomalla salesinvoiceamount -elementille annetaan "pricetype" -attribuutti ja pricetypen arvoksi annetaan "netvisor". Lisäksi SalesInvoiceAmount- elementin arvo pitää olla 0, että laskun loppusumma lasketaan oikein rivisummista. Tämän lisäksi laskurivin productunitprice -elementille tulee antaa "type" -attribuutti sekä tämän arvoksi annetaan "netvisor" ja productunitprice -elementin arvo voi olla 0.
Jos lasku tuodaan tilassa lähettämätön (unsent), Netvisor ehdottaa laskun lähetyksessä asiakkaalle aina oletuksena "sähköisintä" kanavaa riippuen mitä laskutustietoja Netvisorin asiakaskortille on annettu. Myyntilaskua yritetään lähettää ensisijaisesti verkkolaskuna, toisena sähköpostilaskuna ja viimeisenä paperilaskuna. Myyntilaskun lähetyskanavaa on mahdollista vaihtaa laskun lähetysnäkymässä, eikä tätä tietoa voi tuoda sanomalla. Verkkolasku- ja sähköpostilaskuosoitteet haetaan myyntilaskun lähetystä varten aina Netvisorin asiakaskortin tiedoista. Unsent- tilassa tuotua myyntilaskua on mahdollista muokata jälkikäteen. Jos myyntilasku tuodaan open-tilassa on muokkaaminen estetty.
Jos kohdeasiakkaalle on määritetty Netvisorin asiakaskortilla vaihtoehtoinen laskutusasiakas, rajapinta hakee tuotavalle laskulle laskutusosoitetiedot automaattisesti vaihtoehtoisen laskutusasiakkaan takaa. Tässä tapauksessa aineistossa olleita laskutusosoitetietoja ei käytetä.
Myyntilaskun jaksotuksen voi tehdä joko lasku- tai laskurivitasolla sekä tasajaolla tai jakokäyrällä. Myyntilaskulle voi tuoda jaksotustiedot lähettämättömälle tai avoimelle laskulle. Jaksotustositteet muodostetaan sanomalla tuotujen tietojen pohjalta laskun lähetyksen jälkeen tai avoimen laskun tositteet muodostetaan tuonnin yhteydessä automaattisesti järjestelmän toimesta. Huomioithan, että yhden kuukauden jaksottaminen onnistuu ainoastaan, kun laskun jaksotusta ei tehdä samalle kuukaudelle kuin laskun päiväyskuukausi on. Esim. jos laskun päiväyskuukausi on huhtikuu, niin jaksotuksen voi tehdä tulevaisuuteen eli toukokuulle tai siitä eteenpäin. Menneisyyteen jaksotusta ei voi enää tehdä.
Seuraavassa on kuvattuna sanomarakenne myyntilaskun tuontiin Netvisoriin:
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| Method | 1 | add tai edit, sekä myyntitilauksella (order) append. Kun käytetään metodia edit, kaikki tilauksen/laskun alkuperäiset tiedot tulee antaa sanomalla. Tositteellista laskua ei ole mahdollista muokata. Kun käytetään metodia append, tilauksen tulee olla tilassa toimittamaton tai laskuttamaton. Otsikossa annetaan täydet tiedot, ilman rivejä voidaan päivittää pelkät otsikkotiedot. Uudet rivit lisätään tilauksen loppuun ja lisätään tilauksen loppusummaan, mikäli summaa (salesinvoiceamount) ei annettu sanomalla. | edit |
| Id | 0...1 | Päivitettävän laskun id, vaaditaan jos method on edit tai append | 165 |
Tuotavat tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena xml:nä (POST-data). Huomioi, että kuvaus on jaettu useampaan taulukkoon:
| Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | salesinvoice | Aggregaatti | 1 | ||
| 2 | salesinvoicenumber | Kokonaisluku, max. 18 merkkiä | 0...1 | Laskunumero, jos ei anneta, Netvisor hakee uuden automaattisesti. Ei anneta luonnokselle. | 123456 |
| 2 | salesinvoicedate | Päivämäärä | 1 | Laskun päiväys (myös arvopäivä) | 2020-12-31 |
| Attr. | format | Merkkijono | 1 | Laskun päivämäärän muoto, aina ansi | ansi |
| 2 | salesinvoiceeventdate | Päivämäärä | 0...1 | Laskun kirjauspäivä. Tälle päivälle muodostetaan kirjanpidon tosite. | 2021-01-01 |
| Attr. | format | Merkkijono | 1 | Laskun kirjauspäivän muoto, aina ansi | ansi |
| 2 | salesinvoiceduedate | Päivämäärä | 0...1 | Laskun eräpäivä, pakollinen tieto, jos ei ole annettu maksuehtoa. Kun annetaan eräpäivä, päivittyy Netvisorissa laskun maksuehdoksi 'Eräpäivä'.Sanomalla ei saa olla sekä eräpäivää että maksuehtoa, vain toinen elementti annetaan. | 2020-12-31 |
| Attr. | format | Merkkijono | 1 | Laskun eräpäivän muoto | ansi |
| 2 | salesinvoicevaluedate | Päivämäärä | 0...1 | Laskun arvopäivä. Jos annettu, arvopäivään sovelletaan maksuehdon nettopäivät | 2020-12-31 |
| Attr. | format | Merkkijono | 1 | Laskun arvopäivän muoto | ansi |
| 2 | salesinvoicedeliverydate | Päivämäärä | 0...1 | Laskun toimitus- /saapumispäivä | 2020-12-31 |
| Attr. | format | Merkkijono | 1 | Toimituspäivän muoto | ansi |
| 2 | salesinvoicedeliverytocustomerdate | Päivämäärä tai viikkonumero | 0...1 | Toimitusaika asiakkaalla Päivämäärä tai viikkonumero Vain myyntitilaukselle | 2020-W12 |
| Attr. | format | Merkkijono | 1 | Toimitusaika asiakkaalla, muoto | ansi |
| Attr. | type | Merkkijono | 1 | Toimitusaika asiakkaalla date tai weeknumber | weeknumber |
| 2 | salesinvoicewaybillidentifier | Merkkijono, max. 35 merkkiä | 0...1 | Rahtikirjan numero Vain myyntitilaukselle | 033000050143 |
| 2 | salesinvoiceproductpackagepallet | Kokonaisluku | 0...1 | Vain myyntitilaukselle! Myyntitilauksen pakkaus | 11 |
| Attr. | type | Merkkijono | 1 | Pakkauslavakoodiston tyyppi, GS1 | GS1 |
| Attr. | amount | Merkkijono | 0...1 | Pakkauslavojen määrä | 2 |
| 2 | salesinvoicereferencenumber | Viitenumero | 0...1 | Laskun viitenumero, oikeassa muodossa tarkisteineen. Jos ei anneta, Netvisor muodostaa viitenumeron laskulle. | 1070 |
| 2 | salesinvoiceamount | Numeerinen | 1 | Laskun loppusumma, joka sisältää mahdolliset verot. Jos annetaan Netvisor ei laske loppusummaa laskurivien perusteella. Voidaan antaa tyhjänä <salesinvoiceamount />, jolloin loppusumma lasketaan laskuriveistä. Huom. jos tuot lähetettyjä laskuja suositellaan loppusumman tuontia. | 100,99 |
| Attr. | iso4217currencycode | Merkkijono | 0...1 | Laskun valuutta ISO 4217 muodossa. Oletuksena yrityksen kotivaluutta. | USD |
| Attr. | currencyrate | Merkkijono | 0...1 | Valuuttakurssi. Mikäli ei annettu, käytetään Euroopan Keskuspankin päivän kurssia. Jos kurssia ei löydy, järjestelmä käyttää automaattisesti arvoa 1. | 1,33 |
| Attr. | pricetype | Merkkijono | 0...1 | Hintatyyppi. netvisor tai customer. Customer ei tee mitään. Jos arvo on netvisor, laskuriveille huomioidaan Netvisorin hintakertoimet ja asiakashinnat. SalesInvoiceAmount-arvo pitää olla 0, että laskun loppusumma lasketaan oikein rivisummista. | netvisor |
| 2 | selleridentifier | Merkkijono | 0...1 | Myyjälinkitys laskulle. Jos myyjätieto halutaan linkittää Netvisorista löytyvään myyjään, tulee sanomalla antaa sekä myyjän linkitystieto, että myyjän nimi (sellername -elementti). Netvisorin myyjätiedot voi noutaa resurssilla: Myyjälistan nouto, lista palauttaa myyjän linkityksessä käytettävän netvisorkeyn. | 1 |
| Attr. | type | Merkkijono | 1 | Myyjälinkityksen tyyppi, netvisor (netvisorkey) tai customer (nimi) Linkityksen voi tehdä myyjän netvisorkeyllä (ensisijainen) tai myyjän nimellä. Kun sanomalla tuodaan linkitystieto sekä myyjän nimi, tulee laskulle myyjäksi Netvisorissa ID:tä vastaavan myyjän nimi. Jos linkitys tehdään nimellä, niin annettua merkkijonoa verrataan etu- ja takaperin Netvisorin myyjälistaan. Jos myyjää ei löydy netvisorkeyllä Netvisorista, ilmoittaa rajapinta puutteellisista tiedoista. | netvisor |
| 2 | sellername | Merkkijono, maks. 50 | 0...1 | Myyjän nimi. Jos myyjälinkitystä ei tuoda sanomalla ja myyntilaskua muokataan tuonnin jälkeen Netvisorissa, myyjätieto häviää myyntilaskulta. | Matti Mallikas |
| 2 | invoicetype | Merkkijono | 0...1 | Tuotavan tiedon tyyppi, invoice (myyntilasku) tai order (tilaus) tai invoicedraft (luonnos). Oletuksena invoice | invoice |
| 2 | salesinvoicestatus | Merkkijono | 1 | Laskun tai tilauksen tila. Luonnokselle ei anneta tilaa. Laskulle open tai unsent. Tilaukselle delivered tai undelivered. | open |
| Attr. | type | Merkkijono | 1 | Tilan muoto | netvisor |
| 2 | salesinvoicefreetextbeforelines | Merkkijono, maks. 500 | 0...1 | Vapaa teksti ennen laskurivejä | |
| 2 | salesinvoicefreetextafterlines | Merkkijono, maks. 500 | 0...1 | Vapaateksti laskurivien jälkeen | |
| 2 | salesinvoiceourreference | Merkkijono, maks. 200 | 0...1 | Viitteemme -kentän tieto | |
| 2 | salesinvoiceyourreference | Merkkijono, maks. 200 | 0...1 | Viitteenne -kentän tieto | |
| 2 | salesinvoiceprivatecomment | Merkkijono, maks. 500 | 0...1 | Yksityinen kommentti, ei tulostu laskulle | |
| 2 | invoicingcustomeridentifier | Merkkijono | 1 | Laskutusasiakkaan linkitys, asiakkaan täytyy löytyä Netvisorista. Laskulle haetaan asiakkaan nimi, laskutusosoite ja toimitusosoite Netvisorin asiakaskortin takaa, jos aineistolla ei anneta mitään muita laskutusasiakkaan tietoja (esim. postiosoitetta). | MM |
| Attr. | type | Merkkijono | 1 | Linkitystiedon tyyppi: customer (=asiakaskoodi), netvisor (=Netvisorin kanta-id), tai organizationunitnumber (=OVT-tunnus) | customer |
| Attr. | contactpersonid | Merkkijono | 0...1 | Asiakkaan yhteyshenkilön NetvisorID. Saadaan hakemalla asiakkaan tiedot. | 4012 |
| 2 | invoicingcustomername | Merkkijono, maks 250 | 0...1 | Laskutusasiakkaan nimi. Haetaan asiakaskortilta, jos annetaan vain invoicingcustomeridentifier eikä muita asiakkaan tietoja. | Matti |
| 2 | invoicingcustomernameextension | Merkkijono, maks. 250 | 0...1 | Laskutusasiakkaan nimen jatkotieto. Haetaan asiakaskortilta, jos annetaan vain invoicingcustomeridentifier eikä muita asiakkaan tietoja. | Meikäläinen |
| 2 | invoicingcustomeraddressline | Merkkijono, maks. 100 | 0...1 | Laskutusasiakkaan osoite. Haetaan asiakaskortilta, jos annetaan vain invoicingcustomeridentifier eikä muita asiakkaan tietoja. | Pajukuja 1 |
| 2 | invoicingcustomeradditionaladdressline | Merkkijono, maks. 100 | 0...1 | Laskutusasiakkaan osoite. Haetaan asiakaskortilta, jos annetaan vain invoicingcustomeridentifier eikä muita asiakkaan tietoja. | |
| 2 | invoicingcustomerpostnumber | Merkkijono, maks. 50 | 0...1 | Laskutusasiakkaan postinumero. Haetaan asiakaskortilta, jos annetaan vain invoicingcustomeridentifier eikä muita asiakkaan tietoja. | 53100 |
| 2 | invoicingcustomertown | Merkkijono, maks. 50 | 0...1 | Laskutusasiakkaan postitoimipaikka. Haetaan asiakaskortilta, jos annetaan vain invoicingcustomeridentifier eikä muita asiakkaan tietoja. | Lappeenranta |
| 2 | invoicingcustomercountrycode | Merkkijono | 0...1 | Laskutusasiakkaan maatieto. Haetaan asiakaskortilta, jos annetaan vain invoicingcustomeridentifier eikä muita asiakkaan tietoja. | FI |
| Attr. | type | Merkkijono | 1 | Maatiedon muoto | ISO-3166 |
| 2 | officeidentifier | Merkkijono | 0...1 | Toimipaikkatunnus, Netvisorissa Toimipaikka tiedoissa oleva tunnus, HUOM! tämä ei ole toimipaikan Netvisorkey. Toimipaikkatunnus voidaan antaa sanomalla, jolloin etsitään asiakkaan kyseinen toimipaikka (tai ensimmäinen osuva) tai luodaan tarvittaessa uusi (type=automatic) HUOM! Sanomalla tulee tällöin antaa toimipaikan nimi sekä kaikki osoitetiedot | |
| Attr. | type | Merkkijono | 0...1 | automatic, kun halutaan, että toimipaikka perustetaan myyntilaskusanomalla annettujen tietojen mukaan. HUOM! Sanomalla tulee tällöin antaa toimipaikan nimi sekä kaikki osoitetiedot | |
| 2 | deliveryoffice | Merkkijono | 0...1 | Toimipaikan kohdistus, kohdistetaan Netvisorin asiakaskortin toimipaikka. HUOM! Sanomalla tulee antaa toimipaikan nimi sekä kaikki osoitetiedot | |
| Attr. | type | Merkkijono | 1 | Linkitystiedon tyyppi: Customer = Toimipaikan nimi Netvisor = Toimipaikan Netvisorin kanta-ID | |
| 2 | deliveryaddressname | Merkkijono, maks. 250 | 0...1 | Toimitusasiakkaan nimi, ei haeta Netvisorista. Annettava, jos halutaan toimitusosoite näkyviin laskulle. | Maija |
| 2 | deliveryaddressline | Merkkijono, maks. 100 | 0...1 | Toimitusosoite, ei haeta Netvisorista | Pajukuja 2 |
| 2 | deliveryaddresspostnumber | Merkkijono, maks. 50 | 0...1 | Toimitusosoitteen postinumero | 55100 |
| 2 | deliveryaddresstown | Merkkijono, maks. 50 | 0...1 | Toimitusosoitteen postitoimipaikka, ei haeta Netvisorista | Imatra |
| 2 | deliveryaddresscountrycode | Merkkijono | 0...1 | Toimitusosoitteen maakoodi, ei haeta Netvisorista | FI |
| Attr. | type | Merkkijono | 1 | Maatiedon muoto | ISO-3166 |
| 2 | deliverymethod | Merkkijono, maks. 50 | 0...1 | Toimitustapa. Mikäli toimitustapaa ei löydy, se lisätään. | Asennettuna |
| 2 | deliveryterm | Merkkijono, maks 50 | 0...1 | Toimitusehto. Mikäli toimitusehtoa ei löydy, ne lisätään. | Sopimuksen mukaan |
| 2 | salesinvoicetaxhandlingtype | Merkkijono | 0...1 | Verokäsittelytapa. countrygroup, forcedomestic, domesticconstructionservice tai notaxhandling *2 Jos ei anneta, haetaan asiakkaan tiedoista | countrygroup |
| 2 | paymenttermnetdays | Numeerinen | 1 | Maksuehdon nettopäivät, pakollinen, jos ei ole annettu eräpäivää. Laskun päivämäärää + maksuehdon nettopäivät = laskun eräpäivä. Maksuehto muodostuu asiakkaan laskutuskielen mukaan: "14 päivää netto / 14 dagar netto / 14 days net". Sanomalla ei saa olla sekä eräpäivää että maksuehtoa. Maksuehdon ei tarvitse löytyä Netvisorista, tarvittaessa se perustetaan automaattisesti tuonnin yhteydessä. | 14 |
| 2 | paymenttermcashdiscountdays | Numeerinen | 0...1 | Maksuehtoon tulevat kassa-alennuspäivät. Maksuehto muodostuu asiakkaan laskutuskielen mukaan, asiakkaan laskutuskielen mukaan, esim: "14 päivää netto, 5 päivää". Vain laskukohtainen. | 5 |
| 2 | paymenttermcashdiscount | Numeerinen | 0...1 | Maksuehtoon tuleva kassa-alennus. Maksuehto muodostuu asiakkaan laskutuskielen mukaan, esim: "14 päivää netto, 5 päivää -10%". Vain laskukohtainen. | 10 |
| Attr. | type | Merkkijono | 1 | Maksuehdon tyyppi, aina percentage | percentage |
| 2 | paymentterm | Numeerinen | 0...1 | Maksuehdon NetvisorKey, pakollinen, jos ei ole annettu eräpäivää. Jos annetaan, niin ei voida antaa maksuehdon nettopäiviä, kassa-alennuspäiviä ja kassa-alennusta erikseen. | 1 |
| Attr. | type | Merkkijono | 1 | Maksuehdon tyyppi: netvisor = kohdistetaan maksuehtoon NetvisorKey:n perusteella customerdefault = asiakkaan oletusmaksuehto companydefault = yrityksen oletusmaksuehto default = käytetään ensisijaisesti asiakkaan oletusmaksuehtoa. Jos asiakkaan oletusta ei ole asetettu, käytetään yrityksen oletusmaksuehtoa | netvisor |
| 2 | expectpartialpayments | Numeerinen | 0...1 | Osasuoritukset. 1 = kyllä, 0 = ei, oletuksena 0. Mikäli lasku ottaa vastaan osasuorituksia, laskuun kohdistetaan myös suoritukset, jotka ovat kassa-alennustoleranssien ulkopuolella. | 1 |
| 2 | overridevouchersalesreceivablesaccountnumber | Numeerinen | 0...1 | Kirjanpidon tili, jolla voidaan halutessa yliajaa Netvisorin oletusmyyntisaamistili. Toimii vain avoin-tilaisille laskuille. | 1703 |
| 2 | salesinvoiceagreementidentifier | Merkkijono, max 35 | 0...1 | Sopimustunnus, ei haeta asiakaskortin takaa | |
| 2 | printchannelformat | Merkkijono | 0...1 | Laskun tulostusmuoto netvisor: 1 tai 2 customer: Lasku + tilisiirto tai Lasku Jos ei anneta, käytetään asiakkaan tiedoissa olevaa tulostusmuotoa. | 1 |
| Attr. | type | Merkkijono | 1 | netvisor tai customer | netvisor |
| 2 | secondname | Merkkijono | 0...1 | Aputoiminimi | Testiaputoiminimi |
| Attr. | type | Merkkijono | 1 | netvisor (aputoiminimen NetvisorKey eli Netvisorin tietokantaID) tai customer (aputoiminimen nimi) | customer |
| 2 | overriderateofoverdue | Numeerinen | 0...1 | Viivästyskorkoprosentti, yliajaa Netvisorin oletuksen | 5,5 |
| 2 | ordernumber | Merkkijono max 70 | 0...1 | Ulkoinen tilausnumero | 258741 |
| 2 | proposedaccount | Numeerinen | 0...1 | asiakkaan kirjanpitotili | 1011 |
| Attr. | type | Merkkijono | 1 | customer | customer |
| 2 | accountdimensiontext | Merkkijono, max 35 | 0...1 | Kustannuspaikkatieto, laskukohtainen. Netvisorissa myyntilaskun lisätiedoissa, asiakkaan lisätiedot -kohta. Voidaan tuoda myös laskurivikohtaisena, katso alempaa dokumentaatiosta. | kustannuspaikka |
| 2 | collectioncost | Numeerinen | 0...1 | Perintäkulu. Vain positiviiset arvot (ja 0) sallittu. Vain myyntilaskulle. | 15 |
| 2 | isthirdpartysales | Numeerinen | 0...1 | Kolmikantakauppa, 0 tai 1. 1 muodostaa myyntilaskulle valinnan "Kolmikantakauppa" laskun lisätietoihin. Vain myyntilaskulle. | 1 |
| 2 | invoicelines | Aggregaatti | 1 |
Laskurivit voivat olla joko tuote-, kommentti- tai välisummarivejä. Tuoterivin tuotteen on oltava perustettuna Netvisoriin ja se linkitetään rivitietoon joko Netvisor-avaimella tai asiakaskohtaisella avaimella. Tuotteen nimen, hinnan ja muut tiedot voi kuitenkin vaihtaa.
ALV-koodin valinta laskun tuoteriville on pakollinen. Katso lista sallituista ALV-koodeista ohjeesta Arvonlisäveron käsittely ja järjestelmän ALV-tunnisteet ohjeesta tai tästä listauksesta. ALV-tunnistetta käytetään tositetta muodostettaessa laskurivillä annetun mukaisesti kun lasku tuodaan tilassa Avoin Netvisoriin. Jos lasku tuodaan Lähettämätön-tilassa, tallennetaan tositteelle Netvisorin kirjanpidon tilin mukainen ALV-tunnus.
Mikäli laskuriveissä on tuote-, välisumma- ja kommenttirivejä, tulee laskurivien järjestykseksi järjestelmään se, mikä tuodussa aineistossakin.
Jaksotukset voidaan antaa laskurivikohtaisesti joko tasajaolla tai jakokäyrällä. Tasajaolla jaksotettaessa annetaan endmonth ja endyear -elementit, mutta jakokäyrällä jaksotettaessa näitä ei anneta. Jaksotettaessa jakokäyrällä annetaan divisioncurvename -elementti. Huomioithan, että Yhden kuukauden jaksottaminen onnistuu ainoastaan, kun laskun jaksotusta ei tehdä samalle kuukaudelle kuin laskun päiväyskuukausi on. Esim. Jos laskun päiväyskuukausi on huhtikuu, niin jaksotuksen voi tehdä tulevaisuuteen eli toukokuulle tai siitä eteenpäin. Menneisyyteen jaksotusta ei voi enää tehdä.
InvoiceLine -aggregaatin rakenne on seuraava, jos halutaan tuoda tuoterivi:
| Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
| 3 | invoiceline | Aggregaatti | 1...n | ||
| 4 | salesinvoiceproductline | Aggregaatti | 1 | ||
| 5 | productidentifier | Merkkijono | 1 | Tuotteen linkitystieto. Tuotteen tulee olla perustettuna Netvisoriin. Voi olla joko tuotekoodi tai netvisorkey eli tuotteen tietokanta ID. | |
| Attr. | type | Merkkijono | 1 | Linkitystyyppi: - customer (tuotekoodi) - netvisor (netvisorkey) - primaryeancode (tuotteen ensisijainen EAN-koodi) - secondaryeancode (tuotteen toissijainen EAN-koodi) | netvisor |
| 5 | productname | Merkkijono, max 200 | 1 | Tuotteen nimi. Jos elementti jätetään tyhjäksi, nimi haetaan Netvisorin tuotteen takaa. | Testituote |
| 5 | productunitprice | Numeerinen, maks. 12 desimaalia | 1 | Tuotteen yksikköhinta, ei haeta tuotteen takaa. | 10,05 |
| Attr. | type | Merkkijono | 1 | Yksikköhinnan tyyppi, net (veroton) tai gross (verollinen) Jos halutaan, että laskuriveille huomioidaan Netvisorin hintakertoimet ja asiakashinnat, arvo tulee olla netvisor. Tällöin productunitprice -elementin arvo voi olla 0. | net |
| 5 | productunitpurchaseprice | Numeerinen | 0...1 | Tuotteen ostohinta, pyöristettynä kahteen desimaaliin | 1,05 |
| Attr. | type | Merkkijono | 1 | Ostohinnan tyyppi, aina net | net |
| 5 | productvatpercentage | Numeerinen | 1 | Tuotteen ALV-prosentti, ei saa olla ristiriidassa ALV-koodin kanssa. Netvisorissa ALV -prosentteja hallitaan: Taloushallinto > Asetukset> Kirjanpidon asetukset > Kirjanpidon ja velvotteiden asetukset > Verokantojen hallinta *1 | 24 |
| Attr. | vatcode | Merkkijono | 1 | ALV-koodi, listaus alv-koodeista löytyy täältä. | KOMY |
| 5 | salesinvoiceproductlinequantity | Numeerinen | 1 | Kappalemäärä. Voi olla kokonais- tai desimaaliluku. Max. kahdeksan desimaalia (esim. 3,55555555). | 5 |
| 5 | salesinvoiceproductlinediscountpercentage | Numeerinen | 0...1 | Alennusprosentti. Mikäli annetaan attribuutti netvisor, haetaan alennusprosentti Netvisorin asiakaskortilta | 10 |
| Attr. | type | Merkkijono | netvisor, mikäli attribuutti annetaa, jätetään elementin arvo tyhjäksi | netvisor | |
| 5 | salesinvoiceproductlinefreetext | Merkkijono, maks. 512 | 0...1 | Vapaateksti tuoteriville (riviselite) | Vapaata tekstiä |
| 5 | salesinvoiceproductlinevatsum | Numeerinen | 0...1 | Rivin veronmäärä. Annetaan jos halutaan korvata Netvisorin laskema veron määrä. | 11,00 |
| 5 | salesinvoiceproductlinesum | Numeerinen | 0...1 | Rivin verollinen loppusumma. Annetaan jos halutaan korvata Netvisorin laskema rivisumma. | 50,00 |
| Huom! sekä salesinvoiceproductlinesum että salesinvoiceproductlinevatsum elementit vaaditaan, jotta annettuja summia käytetään. | |||||
| 5 | salesinvoiceproductlineinventoryid | Numeerinen | 0...1 | Rivin tuotteen varaston tietokanta-ID. | 1 |
| 5 | accountingaccountsuggestion | Numeerinen | 0...1 | Tiliöintiehdotus. Tili täytyy löytyä järjestelmästä. | 3000 |
| 5 | dimension | Aggregaatti | 0...n | ||
| 6 | dimensionname | Merkkijono, max 50 | 1 | Laskentakohdeotsikko, jos otsikkoa ei löydy, järjestelmä perustaa sen | Projekti |
| 6 | dimensionitem | Merkkijono max 200 | 1 | Laskentakohde | Palkanlaskenta |
| 5 | provisionpercentage | Numeerinen | 0...1 | Laskurivin provisioprosentti | 12 |
| 5 | accrualrule | Aggregaatti | 0...1 | Rivikohtainen jaksotussääntö, voidaan käyttää vaihtoehtoisesti tasajakoa TAI jakokäyrää. | |
| 6 | startmonth | Numeerinen | 1 | Aloituskuukausi | 9 |
| 6 | startyear | Numeerinen | 1 | Aloitusvuosi | 2020 |
| 6 | endmonth | Numeerinen | 0...1 | Lopetuskuukausi (käytä vain tasajako jaksotuksessa) | 12 |
| 6 | endyear | Numeerinen | 0...1 | Lopetusvuosi (käytä vain tasajako jaksotuksessa) | 2020 |
| 6 | divisioncurvename | Merkkijono | 0...1 | Jakokäyrä (käytä vain jakokäyrä jaksotuksessa) Jakokäyrän tulee löytyä Netvisorista. Hallitaan näkymässä 'Taloushallinto > Budjetoinnin asetukset > Jakokäyrät' | neljännesvuosi |
| 5 | productunitname | Merkkijono, max 14 | 0...1 | Tuotteen yksikkötieto. Jos ei anneta, käytetään Netvisorin tuotekortilla olevaa yksikköä. Ei koske Laajennettua tuotehallintaa käyttäviä yrityksiä. | kpl |
| 5 | deliverydate | Numeerinen | 0...1 | Tilausrivin toimituspäivä. Vain myyntitilaukselle. | 2021-06-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän tyyppi, aina ansi. | ansi |
| 5 | ordernumber | Merkkijono | 0...1 | Tuoterivin tilausnumero. | 1232 |
| 5 | proposedaccount | Numeerinen | 0...1 | Asiakkaan kirjanpitotili | 1011 |
| Attr. | type | Merkkijono | 1 | customer | customer |
| 5 | accountdimensiontext | Merkkijono, max 35 | 0...1 | Asiakkaan kustannuspaikkatieto, laskurivikohtainen. | kustannuspaikka |
Jos tuodaan kommenttirivi, niin InvoiceLine -aggregaatin rakenne on seuraava:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| 3 | invoiceline | Aggregaatti | 1...n | ||
| 4 | salesinvoicecommentline | Aggregaatti | 1 | ||
| 5 | comment | Merkkijono, maks. 6000 merkkiä | 1 | Kommentti laskulle |
Jos halutaan tuoda välisummarivirivi, niin InvoiceLine -aggregaatin rakenne on seuraava:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| 3 | invoiceline | Aggregaatti | 1...n | ||
| 4 | salesinvoicesubline | Aggregaatti | 1 | ||
| 5 | sublinearticleidentifier | Merkkijono, maks. 35 merkkiä | 0...1 | Tuotekoodi | 1 |
| 5 | sublinearticlename | Merkkijono, maks. 100 merkkiä | 1 | Tuotenimike | Tuote |
| 5 | sublinedescription | Merkkijono, maks. 512 merkkiä | 0...1 | Riviselite | Riviselite |
| 5 | sublineunitcode | Merkkijono, maks. 14 merkkiä | 0...1 | Tuoteyksikkö | kpl |
| 5 | sublineunitprice | Numeerinen | 0...1 | Yksikköhinta | 10 |
| 5 | sublinedeliveredquantity | Numeerinen | 0...1 | Tuotteen toimitettu määrä | 1 |
| 5 | sublinediscountpercent | Numeerinen | 0...1 | Alennusprosentti | 0 |
| 5 | sublinevatpercent | Numeerinen | 0...1 | ALV-prosentti | 24 |
| 5 | sublinesum | Numeerinen | 0...1 | Rivisumma | 12,4 |
| 5 | sublinevatsum | Numeerinen | 0...1 | Rivin alv-summa | 2,4 |
Valitun rakenteen jälkeen jatketaan seuraavasti:
| Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
| 2 | invoicevoucherlines | Aggregaatti | 0...1 | Annetaan vain mikäli myyntilaskun tosite halutaan muodostaa rajapinnasta. Muussa tapauksessa Netvisor muodostaa myyntilaskun tositteen. | |
| 3 | calculationmode | Merkkijono | 0...1 | Tositteen laskentatapa. Käsitelläänkö tosite brutto (gross) vai netto (net) käsittelyllä. Jos elementtiä ei anneta, on se oletuksena aina brutto (gross). HUOM! Nettokäsittelyssä järjestelmä ei laske automaattisesti alv- ja pyöristyserorivejä | net |
| 3 | voucherline | Aggregaatti | 1...n | ||
| 4 | linesum | Numeerinen | 1 | Summa. Positiivinen luku kirjataan debit puolelle, ja negatiivinen credit puolelle | 100 |
| Attr. | type | Merkkijono | Summan tyyppi, net (veroton) gross (verollinen) | net | |
| 4 | description | Merkkijono, maks. 255 | 0...1 | Selite | Selite |
| 4 | accountnumber | Merkkijono | 1 | Tilinumero. Tulee löytyä järjestelmästä | 3000 |
| 4 | vatpercent | Numeerinen | 1 | Veroprosentti, ei saa olla ristiriidassa ALV-koodin kanssa. | 24 |
| Attr. | vatcode | Numeerinen | 1 | ALV-koodi | KOMY |
| 4 | accountdimension | Merkkijono | 0...1 | Tositteen seurantakohde | Seurantakohde 1 |
| Attr. | type | Merkkijono | 1 | Seurantakohteen tunnistetiedon tyyppi, netvisorkey tai name. | name |
| 5 | dimension | Aggregaatti | 0...n | ||
| 6 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko, jos ei löydy, järjestelmä luo sen | Projekti |
| 6 | dimensionitem | Merkkijono | 1 | Laskentakohteen nimi | Palkanlaskenta |
| 2 | accrualrule | Aggregaatti | 0...1 | Laskukohtainen jaksotussääntö, voidaan käyttää vaihtoehtoisesti tasajakoa TAI jakokäyrää. | |
| 3 | startmonth | Numeerinen | 1 | Aloituskuukausi | 9 |
| 3 | startyear | Numeerinen | 1 | Aloitusvuosi | 2020 |
| 3 | endmonth | Numeerinen | 0...1 | Lopetuskuukausi (käytä vain tasajako-jaksotuksessa) | 12 |
| 3 | endyear | Numeerinen | 0...1 | Lopetusvuosi (käytä vain tasajako-jaksotuksessa) | 2020 |
| 3 | divisioncurvename | Merkkijono | 0...1 | Jakokäyrä (käytä vain jakokäyrä-jaksotuksessa) Jakokäyrän tulee löytyä Netvisorista. Hallitaan näkymässä 'Taloushallinto > Budjetoinnin asetukset > Jakokäyrät' | neljännesvuosi |
| 2 | salesinvoiceattachments | Aggregaatti | 0...1 | ||
| 3 | salesinvoiceattachment | Aggregaatti | 1...n | ||
| 4 | mimetype | Merkkijono | 1 | Liitteen MIME-tyyppi | Application/pdf |
| 4 | attachmentdescription | Merkkijono, maks.100 | 1 | Liitteen kuvaus | kuvaus |
| 4 | filename | Merkkijono, maks.255 | 1 | Liitteen tiedostonimi | attachment.pdf |
| 4 | documentdata | Merkkijono | 1 | Liitetiedosto base64-enkoodattuna | |
| Attr. | type | Merkkijono | 0...1 | Arvot: finvoice Verkkolaskun mukana välitettävät liitetiedostot Tulostuspalvelun, paikallisen tulostuksen tai sähköpostilaskutuksen kautta välitettävät liitteet Huom! Tämän elementin käyttö on muuttunut myyntilasku-uudistuksen myötä. Liitteen tyypillä ei ole väliä, vaan kaikki liitteet toimivat sekä verkko-, sähköposti- että paperilaskujen kanssa. Elementti voidaan jättää antamatta. Vanha ohjeistus alla suluissa. (Lähetetäänkö liite verkkolaskun mukana vai esim. tulostuspalvelun kautta. Oletuksena käytetään pdf, jos attribuuttia ei anneta.) | |
| 4 | printbydefault | Kokonaisluku | 0...1 | Merkitäänkö liitteet automaattisesti tulostukseen; 1= true, 0=false Koskee vain paperisena lähetettäviä laskuja. HUOM: Ei saa antaa, jos annettu liitteen datan tyyppi on finvoice. Tällöin hylkää pyynnön. | 1 |
| 2 | customtags | Aggregaatti | 0...1 | ||
| 3 | tag | Aggregaatti | 1...n | ||
| 4 | tagname | Merkkjono | 1 | Asiakkaan lisätietokentän nimi Netvisorissa | Lisätietokenttä 1 |
| 4 | tagvalue | Merkkijono | 1 | Lisätietokentän arvo | Lisätieto |
| Attr. | type | Merkkijono | 1 | Lisätietokentän tyyppi: float (valintalista), date (päivämäärä), text (teksti) tai enum (desimaaliluku). | text |
*1) Ei saa olla ristiriidassa alv-prosentin kanssa. Sallitut alv-koodit ja -tunnisteet löytyvät täältä.
Katsothan myös Arvonlisäveron käsittely ja ALV-tunnisteet
*2) Jos SalesInvoiceTaxHandlingType on eri kuin DomesticConstructionService asetetaan se kuitenkin arvoon domesticconstructionservice jos laskulla on yksikin rivi jonka verokoodi on Construction_Service_Sales. Laskun kaikki rivit pitää olla samalla verokoodilla.
*3) Myyntilaskun tuonnin yhteydessä aineistoon voidaan kirjoittaa lisäksi erilliset tositerivit mikäli laskusta halutaan muodostettavan tosite integraation kautta manuaalisesti. Järjestelmä kunnioittaa aineistossa käyttäjän antamia tositerivejä ja ei muodosta tositetta automaattisesti mikäli nämä rivit on annettu. Laskun tositerivit vastaavat kirjanpitoaineistotuonnin tositerivejä. HUOM! Tilauksille ei voi tuoda tositetta.
*4) Jaksotustositteelle tulee automaattisesti sama laskentakohdetieto, joka on annettu myyntilaskuriveille.
Muutoshistoria
| Päivämäärä | Muutos | Kuvaus |
| 2.4.2024 | Uuden elementin lisäys | Myyntilaskun tuonnin yhteydessä on nyt mahdollista tuoda tositteen seurantakohde accountdimension-elementissä. |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback