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. Tuotteen yksikköhinta (Productunitprice) tulee antaa arvoltaan positiivisena. 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ä 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. Mikäli laskuaineistolla tuodaan osoitetietoja, käytetään näitä myyntilaskulla.
Laskun kielenä käytetään Netvisorin asiakkaan taakse määriteltyä laskun kieltä (suomi, ruotsi tai englanti). Laskun kieltä ei ole mahdollista tuoda myyntilaskun tietojen mukana.
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.
Netvisor ehdottaa laskun lähetyksessä asiakkaalle aina oletuksena "sähköisintä" kanavaa riippuen siitä 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 laskun tuonnin jälkeen niin pitkään, kun laskulla ei ole kirjanpidon tositetta. Jos myyntilasku tuodaan open-tilassa, on muokkaaminen estetty sillä tällöin laskun kirjanpidon tosite muodostuu laskun tuonnin yhteydessä.
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. | edit |
Id | 0...1 | Päivitettävän laskun id, vaaditaan jos method on edit tai append | 165 |
useonlyexistingdimensions | 0...1 | 1 | Estää uusien laskentakohdeotsikkojen ja laskentakohteiden automaattisen luonnin. Palauttaa virheen, jos annettua laskentakohdetta ei ole olemassa. |
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ä. | 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 | 2020-W12 |
Attr. | format | Merkkijono | 1 | Toimitusaika asiakkaalla, muoto | ansi |
Attr. | type | Merkkijono | 1 | Toimitusaika asiakkaalla | weeknumber |
2 | salesinvoicewaybillidentifier | Merkkijono, max. 35 merkkiä | 0...1 | Rahtikirjan numero | 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. | 1070 |
2 | salesinvoiceamount | Numeerinen | 1 | Laskun loppusumma, joka sisältää mahdolliset verot. | 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 |
2 | selleridentifier | Merkkijono | 0...1 | Myyjälinkitys laskulle. | 1 |
Attr. | type | Merkkijono | 1 | Myyjälinkityksen tyyppi, | 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. | 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 asiakaskortille. Asiakkaan tulee löytyä Netvisorista. Mikäli annetaan pelkästään invoicingcustomeridentifier, laskulle haetaan asiakkaan nimi, laskutusosoite ja toimitusosoite Netvisorin asiakaskortin takaa. | 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 tietoa ei tuoda sanomalla. | Matti |
2 | invoicingcustomernameextension | Merkkijono, maks. 250 | 0...1 | Laskutusasiakkaan nimen jatkotieto. Haetaan asiakaskortilta, jos tietoa ei tuoda sanomalla. | Meikäläinen |
2 | invoicingcustomeraddressline | Merkkijono, maks. 100 | 0...1 | Laskutusasiakkaan osoite. Haetaan asiakaskortilta, jos tietoa ei tuoda sanomalla. | Pajukuja 1 |
2 | invoicingcustomeradditionaladdressline | Merkkijono, maks. 100 | 0...1 | Laskutusasiakkaan osoite. Haetaan asiakaskortilta, jos tietoa ei tuoda sanomalla. |
|
2 | invoicingcustomerpostnumber | Merkkijono, maks. 50 | 0...1 | Laskutusasiakkaan postinumero. Haetaan asiakaskortilta, jos tietoa ei tuoda sanomalla. | 53100 |
2 | invoicingcustomertown | Merkkijono, maks. 50 | 0...1 | Laskutusasiakkaan postitoimipaikka. Haetaan asiakaskortilta, jos tietoa ei tuoda sanomalla. | Lappeenranta |
2 | invoicingcustomercountrycode | Merkkijono | 0...1 | Laskutusasiakkaan maatieto. Haetaan asiakaskortilta, jos tietoa ei tuoda sanomalla. | 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) |
|
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 toimipaikkaan. Osoitetiedot eivät pakolliset, jos toimipaikan osoitetietoje ei anneta, noudetaan osoitetiedot toimipaikan tiedoista. |
|
Attr. | type | Merkkijono | 1 | Linkitystiedon tyyppi: |
|
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 | Pajukuja 2 |
2 | deliveryaddresspostnumber | Merkkijono, maks. 50 | 0...1 | Toimitusosoitteen postinumero | 55100 |
2 | deliveryaddresstown | Merkkijono, maks. 50 | 0...1 | Toimitusosoitteen postitoimipaikka | 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 | Verotuskäsittely. countrygroup, forcedomestic, domesticconstructionservice tai notaxhandling *2 | countrygroup |
2 | paymenttermnetdays | Numeerinen | 1 | Maksuehdon nettopäivät, pakollinen, jos ei ole annettu eräpäivää. | 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 |
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, | 0...1 | Sopimustunnus, ei haeta asiakaskortin takaa |
|
2 | printchannelformat | Merkkijono | 0...1 | Laskun tulostusmuoto | 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 | 0...1 | Ulkoinen tilausnumero | 258741 |
2 | proposedaccount | Numeerinen | 0...1 | Asiakkaan kirjanpitotili. Netvisorissa kohta Tiliöintiehdotus (Myyntilaskun toiminnot>Lisätiedot>Tiliöintiehdotus) | 1011 |
Attr. | type | Merkkijono | 1 | customer | customer |
2 | accountdimensiontext | Merkkijono, max 35 | 0...1 | Asiakkaan kustannuspaikka, laskukohtainen. Netvisorissa myyntilaskun lisätiedoissa, kohta Kustannuspaikkatieto. 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 | salesinvoicetaxhandlingclause | Numeerinen | 0...1 | Veroteksti laskulla *5 Ohjeen alaosassa tarkempi ohje tämän elementin käyttöön |
|
2 | denyinvoicecollection | Numeerinen | 0...1 | Laskukohtainen perintäkielto, 0 tai 1. 1 asettaa laskukohtaisen perintäkiellon. Vain myyntilaskulle. |
|
2 | invoicelines | Aggregaatti | 1 |
|
|
Laskulla voi olla tuote-, kommentti- ja välisummarivejä. Kommenttirivit eivät vaikuta myyntilaskun loppusummaan. Tuoterivin tuotteen on oltava perustettuna Netvisoriin siinä vaiheessa, kun myyntilasku tuodaan Netvisoriin. Myyntilaskun tuonti ei siis perusta uusia tuotteita. Myyntilaskurivillä oleva tuote linkitetään tuoterekisterin tuotteeseen joko tuotekoodilla, netvisorkeyllä eli tuotteen tietokanta ID:llä tai tuotteen ensisijainen tai toissijainen EAN-koodi. Laskulla olevan tuotteen nimen, hinnan ja muut tiedot voi kuitenkin vaihtaa vielä Netvisorissa, jos myyntilaskulle ei ole muodostunut kirjanpidon tositetta.
Netvisorista löytyy oletuksena yksi tilapäistuote tuotekoodilla TEMP, mutta tätä ei pysty käyttämään rajapinnan kautta. Pystyt kuitenkin luomaan uusia tilapäistuotteita Netvisorin käyttöliittymässä samaan tapaan kuin muitakin tuotteita eli oikeasta yläkulmasta 'Luo uusi' -> 'Tuote'.
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 tuotteen takana olevan kirjanpidon tilin mukainen ALV-tunnus. Jos verotuskäsittelyä (SalesInvoiceTaxHandlingType) ei anneta myyntilaskusanomalla, haetaan se asiakkaan tiedoista.
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ä.
Laskukohtaiset laskentakohteet eivät ole tuettuna silloin, kun myyntilaskuja tuodaan integraation kautta eli jos rajapinnan kautta tuotavaa laskentakohdetietoa halutaan käyttää, tulee olla käytössä laskurivikohtaiset laskentakohteet (asetus löytyy Myynti > Asetukset > Perustiedot ja asetukset > Myynnin perustiedot > Myyntilaskujen oletuslaskentakohteet > Laskukohtainen/Laskurivikohtainen). Mikäli halutaan käyttää laskukohtaisia laskentakohteita, tulee nämä asettaa myyntilaskuille käsin (Myyntilaskun toiminnot > Laskukohtaiset laskentakohteet). Mikäli asiakkaan ja tuotteiden taakse on asetettu oletuslaskentakohteita nousevat ne rajapinnasta tuotavalle laskulle, mikäli on käytössä laskurivikohtaiset laskentakohteet ja laskusanomalla ei ole tuotu laskentakohdetietoa.
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. |
|
Attr. | type | Merkkijono | 1 | Linkitystyyppi: | 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) | net |
5 | productunitpurchaseprice | Numeerinen | 0...1 | Tuotteen ostohinta, pyöristettynä kahteen desimaaliin. Myyntilaskulla kenttä Hankintahinta. | 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. | Huom! sekä salesinvoiceproductlinesum että salesinvoiceproductlinevatsum elementit vaaditaan, jotta annettuja summia käytetään. | Huom! sekä salesinvoiceproductlinesum että salesinvoiceproductlinevatsum elementit vaaditaan, jotta annettuja summia käytetään. | Huom! sekä salesinvoiceproductlinesum että salesinvoiceproductlinevatsum elementit vaaditaan, jotta annettuja summia käytetään. | 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 |
6 | dimensionitemcode | Merkkijono | 0...1 | Laskentakohteen koodi | DIMC-001 |
6 | dimensionitemname | Merkkijono | 0...1 | Laskentakohteen nimi | Item Name 1 |
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) | 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 | Netvisorissa Ulkoinen tilausnumero. Finvoice-sanomalla RowIdentifier Rivikohtaisen tilausnumeron maksimimerkkimäärä on 35 merkkiä | 35 |
5 | deliveryidentifier | Merkkijono | 0...1 | Netvisorissa Toimitusnumero. Finvoice-sanomalla RowDeliveryIdentifier | 1000 |
5 | proposedaccount | Numeerinen | 0...1 | Asiakkaan kirjanpitotili. Netvisorissa laskurivillä Asiakkaan tiliöintiehdotus. | 1011 |
Attr. | type | Merkkijono | 1 | customer | customer |
5 | accountdimensiontext | Merkkijono, max 35 | 0...1 | Asiakkaan kustannuspaikka. 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ä ja maks. 35 rivinvaihtoa | 1 | Kommentti laskulle |
|
Jos halutaan tuoda välisummarivi, 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). | 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 | 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 |
6 | dimensionitemcode | Merkkijono | 0...1 | Laskentakohteen koodi | DIMC-001 |
6 | dimensionitemname | Merkkijono | 0...1 | Laskentakohteen nimi | Item Name 1 |
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) | neljännesvuosi |
2 | salesinvoiceattachments | Aggregaatti | 0...1 | Lisätietoa verkko- ja sähköpostilaskujen liitteiden maksimikokorajoista löytyy tästä ohjeesta. |
|
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 | Liitteen tyypillä ei ole väliä, vaan kaikki liitteet toimivat sekä verkko-, sähköposti- että paperilaskujen kanssa. Elementti voidaan jättää antamatta. | |
4 | printbydefault | Kokonaisluku | 0...1 | Määrittää lähteekö liite automaattisesti laskun lähetyksessä asiakkaalle. Kun elementille antaa arvon 1, tällöin liite lähtee oletuksena laskun mukana. Jos elementtiä ei anneta sanomalla tai sen arvo on 0, tällöin liite ei lähde oletuksena laskun mukana. | 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 (desimaaliluku), date (päivämäärä), text (teksti) tai enum (valintalista). | 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 RAMY. 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.
*5) Veroteksti laskulla. Veroteksti laskulla on mahdollista tuoda salesinvoice.nv rajapintaresurssilla myyntilaskulle elementissä salesinvoicetaxhandlingclause. Tämän elementin toiminnallisuus on sellainen, että tietojen tuonnin yhteydessä tulisi tuoda verotekstin kantaID ja tällöin verotekstinä käytetään näitä Netvisorissa jo olemassa olevia verotekstejä. Omaa tekstiä kenttään ei pääse lisäämään eikä Netvisorin oletustekstejä muokkaamaan. ID-numeroita ei saa kyseltyä erikseen rajapinnan kautta.
Alla luettelo veroteksteistä ja kunkin verotekstin ID-numero:
NoTaxSales = 1
ReverseCharge = 2
NoTaxExportOfGoods = 3
NoTaxIntraCommunitySupply = 4
NoTaxTransportOfGoodsOutsideEU = 5
Triangulation = 6
SelfBilling = 7
ReverseChargeDirectiveArticle44 = 8
AVL19Delivery = 9
AVL34Sales = 10
AVL37Sales = 11
AVL61Sales = 12
AVL71Transport = 13
AVL8ReverseCharge = 14
AVL8dReverseCharge = 15
AVL130a = 16
ConstructionPoolOrLaunch = 17
AVL58 = 18
AVL45Sales = 19
ProfitMarginSystemSecondHandGoods = 20
Nämä vastaavat verotekstejä:
Veroton myynti = 1
Käännetty verovelvollisuus = 2
ALV 0 %, veroton myynti EU:n ulkopuolelle = 3
ALV 0 %, yhteisömyynti = 4
ALV 0 %, tavaran kuljetus EU:n ulkopuolelle = 5
Kolmikantakauppa = 6
Itselaskutus = 7
Käännetty verovelvollisuus, arvonlisäverodirektiivi 44 art. = 8
AVL 19 a §:ssä tarkoitettu luovutus = 9
AVL 34 §:ssä tarkoitettu myynti = 10
AVL 37 §:ssä tarkoitettu myynti = 11
AVL 61 §:ssä tarkoitettu osittain vähennyskelvottomassa käytössä olleen tavaran/palvelun myynti = 12
AVL 71 § 2 k., maahantuotavan tavaran kuljetus = 13
AVL 8 c §, käännetty verovelvollisuus = 14
AVL 8 d §, käännetty verovelvollisuus = 15
AVL 130 a §:ssä tarkoitettu myynti = 16
Rakennusaltaassa tai vesillelaskun jälkeen (lasku ilman ALV:a) = 17
AVL 58§ = 18
AVL 45 §:ssä tarkoitettu myynti = 19
AVL 79 a §, voittomarginaalijärjestelmä - käytetyt tavarat = 20
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ä. |