Ennen myyntilaskun noutoa on noudettava myyntilaskulista, josta poimitaan myyntilaskun tunniste. Tunnisteen avulla voidaan noutaa tarkemmat tiedot yhdestä myyntilaskusta kerrallaan. Myyntilaskujen, myyntitilauksien ja hyvityslaskujen tuonnissa on otettava huomioon asiakas- ja tuoterekisterien ajantasaisuus. Lue vinkki tietojen käsittelyyn täältä.
Myyntilaskuja voi tuoda suuremmissa erissä erätuonnilla. Ohjeet erätuontiin löydät täältä.
Myyntilaskujen käsittelyn jakautuu seuraaviin toimintoihin:
| Integraatio | HTTP-metodi | Resurssi | DTD | Skeema | Esimerkki |
| Myyntilasku- tai tilauslistan nouto | GET | salesinvoicelist.nv | Laskulista Lataa Tilauslista Lataa | ||
| Myyntilaskun tai tilauksen nouto | GET | getsalesinvoice.nv / getorder.nv | Lasku Lataa Tilaus Lataa | ||
| Myyntilaskun, -tilauksen tai hyvityslaskun tuonti | POST | salesinvoice.nv | Lataa | Lataa | |
| Myyjälistan nouto | GET | salespersonnellist.nv | Lataa | ||
| Myyntilaskun poisto | GET | deletesalesinvoice.nv | - | ||
| Myyntilaskun tilan päivitys | POST | updatesalesinvoicestatus.nv | - | ||
| Myyntitilauksen laskuttaminen ja toimittaminen | POST | salesorderinvoicing.nv | Lataa | ||
| Kommentin tuominen myyntitilauksen tai -laskun käsittelyhistoriaan | POST | salesinvoicecomment.nv | Lataa | ||
| Hyvityslaskun kohdistaminen laskulle | POST | matchcreditnote.nv | Lataa |
Myyntilasku- tai tilauslistan nouto
Resurssi: salesinvoicelist.nv
Tällä resurssilla voidaan hakea parametrin ListType arvoa vaihtamalla joko myyntilaskulista tai tilauslista.
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| listtype | 0...1 | Ei arvoa kun haetaan myyntilaskulistaa ja preinvoice kun haetaan tilauslistaa | |
| invoicesabovenetvisorkey | 0...1 | Rajaa kaikki laskut/tilaukset jälkeen annetun tietokannan id:n | 165 |
| begininvoicedate | 0...1 | Laskut/tilaukset, joissa päivämäärä suurempi tai yhtäsuuri | 2012-01-01 |
| endinvoicedate | 0...1 | Laskut/tilaukset, joissa päivämäärä pienempi tai yhtäsuuri | 2012-12-31 |
| invoicenumber | 0...1 | Rajaa listan lasku-/tilausnumerolla | |
| invoicestatus | 0...1 | Rajaa listan laskun tilalla (ei käytetä tilauksiin), ks. taulukko. Hakee sekä InvoiceStatus kentästä että SubStatus attribuutista. | open |
| lastmodifiedstart | 0...1 | Hakee myyntilaskut, joita on muutettu annetun päivämäärän jälkeen | 2012-10-23 |
| lastmodifiedend | 0...1 | Hakee myyntilaskut, joita on muutettu ennen annettua päivämäärää | 2012-10-24 |
| salesinvoicebatchid | 0...1 | Rajaa myyntilaskuerässä tuodut myyntilaskut annetun erä ID:n mukaisesti. Katso myyntilaskuerän käsittelyn kuvaukset. | |
| customercode | 0...1 | Rajaa listan asiakaskoodilla | 1234567 |
| customernetvisorkey | 0...1 | Rajaa listan asiakkaan Netvisor ID :llä | 11 |
| secondname | 0...1 | Rajaa listaan myyntilaskut aputoiminimen nimellä | Aputoiminimi Oy |
| secondnamenetvisorkey | 0...1 | Rajaa listaan myyntilaskut aputoiminimen Netvisor ID:llä | 2 |
| invoicingcustomercontrycode | 0...1 | Rajaa listaan myyntilaskut asiakkaan laskutusmaan mukaan | DE |
| replyoption | 0...1 | Palauttaa laskun sisäisen kommentin. Arvo on aina 1. | 1 |
InvoiceStatus -parametrillä voi olla seuraavat arvot:
| InvoiceStatus | Listaa laskut joiden tila on | Vastaavuudet suomeksi Netvisorin käyttöliittymässä |
| open | OPEN, OVERDUE, REMINDED, REQUESTED, COLLECTED | Avoin, Erääntynyt, Muistutettu, Huomautettu, Perinnässä |
| overdue | OVERDUE, REMINDED, REQUESTED, COLLECTED | |
| paid | PAID | Maksettu |
| unsent | UNSENT | Lähettämätön |
| creditloss | CREDITLOSS | Luottotappio |
| rejected | REJECTED | Hylätty |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | Root | Aggregaatti | 1 | ||
| 1 | SalesInvoiceList | Aggregaatti | 1 | ||
| 2 | SalesInvoice | Aggregaatti | 0...n | max. 500 laskua | |
| 3 | NetvisorKey | Numeerinen | 1 | Laskun tunniste Netvisorissa | 165 |
| 3 | InvoiceNumber | Merkkijono | 1 | Laskun numero | 54122 |
| 3 | InvoiceDate | Päivämäärä | 1 | Laskun päiväys | 2013-11-09 |
| Attr. | format | Merkkijono | 1 | Laskun päiväyksen muoto, aina ansi | ansi |
| 3 | InvoiceStatus | Merkkijono | 1 | Laskun tai tilauksen tila, palauttaa myyntilaskun maksutilan. | ks. taulukko |
| Attr. | substatus | Merkkijono | 0...1 | Laskun alistatus, palauttaa myyntilaskun saatavien tilan: open, overdue, reminded, requested tai collected. Ei käytetä tilaukselle | open |
| Attr. | isincollection | Numeerinen | 1 | Kertoo onko lasku ulkopuolisessa perinnässä vai ei (Intrum/Duetto). Ei käytetä tilaukselle | 0 tai 1 |
| 3 | CustomerCode | Merkkijono | 1 | Laskutusasiakkaan asiakaskoodi | |
| 3 | CustomerName | Merkkijono | 1 | Laskutusasiakkaan nimi | |
| 3 | ReferenceNumber | Viitenumero | 1 | Viitenumero | |
| 3 | InvoiceSum | Numeerinen | 1 | Laskun summa kahdella desimaalilla | 123,45 |
| 3 | OpenSum | Numeerinen | 1 | Laskun avoin summa kahdella desimaalilla, verollinen hinta | 45,67 |
| 3 | Uri | Merkkijono | 1 | Laskun tai tilauksen täydelliset tiedot | ks. taulukko |
| 3 | AdditionalInformation | Aggregaatti | 0...1 | Lisätään vastaukseen, jos kutsuun on lisätty parametri replyoption. | |
| 4 | PrivateComment | Merkkijono | 1 | Laskun sisäinen kommentti |
Paluuarvojen erot laskujen ja tilausten listausten välillä:
| InvoiceStatus | URI | |
| Lasku | open, creditloss, paid, unsent, rejected | /getsalesinvoice.nv?netvisorkey=165 |
| Tilaus | archived, undelivered, delivered, billed | /getorder.nv?netvisorkey=165 |
Myyntilaskun tai tilauksen nouto
Resurssi: getsalesinvoice.nv tai getorder.nv
Myyntilaskun tietojen noutoa ennen on noudettava myyntilaskulista, josta poimitaan myyntilaskun tunniste. Tunnisteen avulla voidaan noutaa tarkemmat tiedot yhdestä myyntilaskusta kerrallaan. Jos lasku- tai kommenttirivien järjestystä on muokattu Netvisorin käyttöliittymästä, rajapinta säilyttää käyttäjän asettaman järjestyksen.
Samaa resurssia voidaan käyttää myyntitilauksen noutamiseen. Noudattaa samaa rakennetta ja käytettävissä on samat parametrit.
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| netvisorkey | 1 | Haettavan laskun Netvisor tunnus (Huom. ei pakollinen jos annetaan parametrille netvisorkeylist arvo; vaihtoehtoinen parametri netvisorkeylist:in kanssa) | 165 |
| pdfimage | 0...1 | Jos ei anneta parametria, tekee saman kuin jos antaa pdfimage=lastsentprintservice lastsentprintservice palauttaa mahdollisen tulostuspalveluun lähetetyn pdf:n LastSentInvoicePDFBase64Data-kentässä palauttaa laskun kuvan pdf-muodossa LastSentInvoicePDFBase64Data-kentässä nopdf ei palauta mitään | |
| showprocesshistory | 0...1 | Palauttaa myyntilaskullakin näkyvän tulostus/lähetyshistoriatiedon ProcessHistory-elementissä | 1 |
| includeattachments | 0...1 | Palauttaa kaikki laskun liitteet Base64-enkoodattuna | 1 |
| showcommentlines | 0...1 | Palauttaa InvoiceLine aggregaatin sisään laskun kommenttirivit | 1 |
| netvisorkeylist | 0...1 | Palauttaa yhdessä pyynnössä täydet tiedot kaikista halutuista laskuista, max. 500 ID:tä (Huom. vaihtoehtoinen parametrin netvisorkey kanssa, vain toinen annetaan) | 1,2,3 |
| includedocuments | 0...1 | Palauttaa myyntilaskua noudettaessa laskulle liittyvät tilaukset. Palauttaa myyntitilausta noudettaessa tilaukselle liittyvät laskut | 1 |
Esimerkki: getsalesinvoice.nv?netvisorkey=1234&pdfimage=pdf&showprocesshistory=1
Esimerkki: getsorder.nv?netvisorkey=1234&pdfimage=pdf&showprocesshistory=1
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | Root | Aggregaatti | 1 | ||
| 1 | SalesInvoice | Aggregaatti | 1 | ||
| 2 | SalesInvoiceNetvisorKey | Merkkijono | 1 | Laskun Netvisor ID | 1234 |
| 2 | SalesInvoiceNumber | Merkkijono | 1 | Laskun numero | |
| 2 | SalesInvoiceDate | Päivämäärä | 1 | Laskun päivämäärä | 2021-01-27 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 2 | SalesInvoiceEventDate | Päivämäärä | 1 | Laskun kirjauspäivä | 2021-02-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 2 | SalesInvoiceValueDate | Päivämäärä | 1 | Laskun arvopäivä (palautuu tilaukselle tyhjänä) | 2021-01-27 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 2 | SalesInvoiceDeliveryDate | Päivämäärä | 1 | Laskun toimituspäivämäärä | 2021-01-27 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 2 | SalesInvoiceDueDate | Päivämäärä | 1 | Laskun eräpäivä | 2021-01-27 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 2 | SalesInvoiceReferencenumber | Merkkijono | 1 | Laskun viitenumero | 7659221 |
| 2 | SalesInvoiceAmount | Numeerinen | 1 | Laskun loppusumma euroissa | 124,50 |
| Attr. | iso4217currencycode | Merkkijono | 0...1 | Laskun valuutta | USD |
| Attr. | currencyrate | Numeerinen | 0...1 | Valuutan vaihtokurssi | 0,91 |
| 2 | SalesInvoiceCollectionCost | Numeerinen | Perintäkulut | 10,00 | |
| 2 | SellerIdentifier | Merkkijono | 1 | Myyjän tunniste (nimi) | Matti Meikäläinen |
| Attr. | type | Merkkijono | 1 | Myyjän tunnisteen tyyppi, aina name (myyjän nimi) | name |
| 2 | InvoiceStatus | Merkkijono | 1 | Laskun/tilauksen tila | Maksettu |
| Attr. | status | Merkkijono | 1 | Laskun/tilauksen tilakoodi. Laskulla: open, paid, unsent, overdue, reminded, requested, collected, creditloss tai rejected. Tilauksella: archived, undelivered, delivered tai billed | paid |
| 2 | InvoiceVoucher | Merkkijono | 0...1 | Tositenumero. Jos tositetta ei ole, tietoa ei palaudu lainkaan. | 27 |
| Attr. | NetvisorKey | Merkkijono | 1 | Tositteen Netvisor ID | 2001 |
| 2 | SalesInvoiceFreeTextBeforeLines | Merkkijono | 1 | Vapaa teksti ennen laskurivejä | |
| 2 | SalesInvoiceFreeTextAfterLines | Merkkijono | 1 | Vapaa teksti laskurivien jälkeen | |
| 2 | SalesInvoiceOurReference | Merkkijono | 1 | Viitteemme | |
| 2 | SalesInvoiceYourReference | Merkkijono | 1 | Viitteenne | |
| 2 | SalesInvoicePrivateComment | Merkkijono | 1 | Laskulla näkymätön kommentti | |
| 2 | SalesInvoiceAgreementIdentifier | Merkkijono | 1 | Sopimustunnus | |
| 2 | InvoicingCustomerCode | Merkkijono | 1 | Laskutettavan asiakkaan asiakaskoodi | 12 |
| 2 | InvoicingCustomerName | Merkkijono | 1 | Laskutettavan asiakkaan nimi | Visma Solutions Oy |
| 2 | InvoicingCustomerNameExtension | Merkkijono | 1 | Laskutettavan asiakkaan nimen jatkotieto | Netvisor |
| 2 | InvoicingCustomerNetvisorKey | Merkkijono | 1 | Laskutettavan asiakkaan NetvisorID | 123 |
| 2 | InvoicingCustomerOrganizationIdentifier | Merkkijono | 1 | Laskutettavan asiakkaan Y-tunnus | Mikäli asiakas on henkilöasiakas, ei kentän tietoa palauteta. |
| 2 | InvoicingCustomerAddressline | Merkkijono | 1 | Laskutettavan asiakkaan osoite | PL 316 |
| 2 | InvoicingCustomerAdditionalAddressLine | Merkkijono | 1 | Laskutettavan asiakkaan osoitteen jatkotieto | |
| 2 | InvoicingCustomerPostnumber | Merkkijono | 1 | Laskutettavan asiakkaan postinumero | 50123 |
| 2 | InvoicingCustomerTown | Merkkijono | 1 | Laskutettavan asiakkaan kaupunki | Lappeenranta |
| 2 | InvoicingCustomerCountryCode | Merkkijono | 1 | Laskutettavan asiakkaan maakoodi | FINLAND |
| 2 | MatchPartialPaymentsByDefault | Merkkijono | 1 | Kyllä tai Ei | Kyllä |
| 2 | DeliveryAddressName | Merkkijono | 1 | Toimitusosoitteen nimi | |
| 2 | DeliveryAddressLine | Merkkijono | 1 | Toimitusosoitteen osoite | |
| 2 | DeliveryAddressPostnumber | Merkkijono | 1 | Toimitusosoitteen postinumero | |
| 2 | DeliveryAddressTown | Merkkijono | 1 | Toimitusosoitteen kaupunki | |
| 2 | DeliveryAddressCountryCode | Merkkijono | 1 | Toimitusosoitteen maakoodi | |
| 2 | DeliveryMethod | Merkkijono | 1 | Toimitustapa | Viedään |
| 2 | DeliveryTerm | Merkkijono | 1 | Toimitusehto | Vapaasti toimittajalla |
| 2 | PaymentTermNetDays | Merkkijono | 1 | Maksuehto päivät. Jos laskun maksuehto on eräpäivä, palautetaan tyhjänä elementtinä | 11 |
| 2 | PaymentTermCashDiscountDays | Merkkijono | 1 | Käteisale päivät. Jos laskun maksuehto on eräpäivä, palautetaan tyhjänä elementtinä | 5 |
| 2 | PaymentTermCashDiscount | Merkkijono | 1 | Käteisale määrä. Jos laskun maksuehto on eräpäivä, palautetaan tyhjänä elementtinä | 10 |
| Attr. | type | Merkkijono | 1 | Käteisale määrän tyyppi, aina percentage | percentage |
| 2 | Waybillidentifier | Merkkijono | 1 | Rahtikirjan numero | 033000050143 |
| 2 | DeliveryToCustomerDate | Merkkijono | 0...1 | Tilauksen toimitus asiakkaalla, päivämäärä | 2021-1-27 |
| Attr. | format | Merkkijono | 1 | Päivämäärän tyyppi, aina ansi | ansi |
| 2 | DeliveryToCustomerWeek | Merkkijono | 0...1 | Tilauksen toimitus asiakkaalla, viikko | 42/2020 |
| 2 | TaxHandlingClause | Merkkijono | 1 | Myyntilaskun veroteksti | AVL 8 c §, käännetty verovelvollisuus |
| Attr. | NetvisorKey | Merkkijono | 1 | Verotekstin NetvisorID | 14 |
| 2 | DeliveryOfficeIdentifier | 1 | |||
| 2 | ContactPersonNetvisorKey | Numeerinen | 0...1 | Yhteyshenkilön NetvisorID | 123 |
| 2 | ContactPersonFirstName | Merkkijono | 0...1 | Yhteyshenkilön etunimi | Matti |
| 2 | ContactPersonLastName | Merkkijono | 0...1 | Yhteyshenkilön sukunimi | Meikäläinen |
| 2 | ContactPersonPhoneNumber | Numeerinen | 0...1 | Yhteyshenkilön puhelinnumero | 050-1234567 |
| 2 | ContactPersonEmail | Merkkijono | 0...1 | Yhteyshenkilön sähköpostiosoite | matti.meikalainen@firma.fi |
| 2 | LastSentInvoicePDFBase64Data | Base64 | 0...1 | Edellisen lähetetyn laskun PDF tieto | S89O3Ly1Lr59NB |
| 2 | InvoiceLines | Aggregaatti | 1 | ||
| 3 | InvoiceLine | Aggregaatti | 1 | ||
| 4 | SalesInvoiceProductLine | Aggregaatti | 0...n | ||
| 5 | NetvisorKey | Merkkijono | 1 | Laskurivin ID | 17536 |
| 5 | ProductIdentifier | Merkkijono | 1 | Tuotekoodi | TEMP1 |
| Attr. | type | Merkkijono | 1 | Tuotteen tunnisteen tyyppi, aina customer | customer |
| 5 | ProductName | Merkkijono | 1 | Tuotteen nimi | Esimerkkituote |
| 5 | ProductNetvisorKey | Merkkijono | 1 | Tuotteen Netvisor ID | |
| 5 | ProductUnitPrice | Numeerinen | 1 | Tuotteen yksikköhinta | 7,00 |
| 5 | ProductPurchasePrice | Numeerinen | 1 | Tuotteen hankitahinta | |
| 5 | ProductVatPercentage | Merkkijono | 1 | Tuotteen veroprosentti | 24 |
| Attr. | VatCode | Merkkijono | 1 | Verokoodi | KOMY |
| 5 | ProductPrimaryEanCode | Merkkijono | 1 | Ensisijainen EAN-koodi | |
| 5 | ProductSecondaryEanCode | Merkkijono | 1 | Toissijainen EAN-koodi | |
| 5 | SalesInvoiceProductLineQuantity | Numeerinen | 1 | Tuotteen määrä | 1 |
| 5 | SalesInvoiceProductLineUnit | Merkkijono | 1 | Tuotteen yksikkö | kpl |
| 5 | SalesInvoiceProductLineDeliveryDate | Päivämäärä | 0...1 | Myyntitilausrivin toimituspäivä | 2021-04-16 |
| 5 | SalesInvoiceProductLineDiscountPercentage | Numeerinen | 1 | Alennusprosentti | 0 |
| 5 | SalesInvoiceProductLineFreeText | Merkkijono | 1 | Vapaateksti tuoterivillä (riviselite) | |
| 5 | SalesInvoiceProductLineVatSum | Numeerinen | 1 | Rivin verosumma kahdella desimaalilla | 1,68 |
| 5 | SalesInvoiceProductLineLinesum | Numeerinen | 1 | Rivin summa kahdella desimaalilla | 8,68 |
| 5 | SalesInvoiceProductLineInventoryID | Numeerinen | 0...1 | Tuotteen varaston ID | 1 |
| 5 | SalesInvoiceProductLineInventoryName | Merkkijono | 0...1 | Tuotteen varaston nimi | Esimerkkivarasto |
| 5 | AccountingAccountSuggestion | Numeerinen | 1 | Tiliöintiehdotus, tilin NetvisorID | 551 |
| 5 | AccountingAccountSuggestionAccountNumber | Numeerinen | 1 | Tiliöintiehdotuksen tilinumero | |
| 5 | dimension | Merkkijono | 0..n | ||
| 6 | dimensionname | Merkkijono | 1 | Laskentakohde otsikko | Kustannuspaikka |
| 6 | dimensionitem | Merkkijono | 1 | Laskentakohde | Helsinki |
| 5 | ProvisionPercentage | Numeerinen | 1 | Laskurivin provisioprosentti | 12 |
| 4 | SalesInvoiceCommentLine | Aggregaatti | 0...n | ||
| 5 | Comment | Merkkijono | 1 | Kommenttiteksti | Laskun kommentti |
| 3 | SalesInvoiceAttachments | Aggregaatti | 0...1 | ||
| 4 | SalesinvoiceAttachment | Aggregaatti | 1...n | ||
| 5 | mimetype | Merkkijono | 1 | Sisällön tiedostomuoto | image/jpeg |
| 5 | attachmentdescription | Merkkijono | 1 | Liitteen kuvaus | |
| 5 | filename | Merkkijono | 1 | Tiedoston nimi | Esimerkki_kuva.jpg |
| 5 | documentdata | Base64 | 1 | Liite Base64-enkoodattuna | S89O3Ly1Lr59NBS89 |
| 3 | documents | Aggregaatti | 1 | Laskuun/tilaukseen liittyvät tilaukset/laskut | |
| 4 | salesorder | Aggregaatti | 1...n | Huom. jos noudetaan tilausta, on elementin nimi salesinvoice | |
| 5 | netvisorkey | Numeerinen | 1 | Laskuun liittyvän tilauksen Netvisor ID / Tilaukseen liittyvän laskun Netvisor ID | 12345 |
| 4 | ordernumber | Numeerinen | 1 | Laskuun liittyvän tilauksen tilausnumero / Tilaukseen liittyvän laskun laskunumero Huom. jos noudetaan tilausta, on elementin nimi invoicenumber | 1001 |
Myyntilaskun, -tilauksen tai hyvityslaskun tuonti
Resurssi: salesinvoice.nv
Rajapinta mahdollistaa myyntilaskun, sen tuote- ja kommenttirivien, 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ä.
Sanomalla voidaan tuoda ainoastaan invoicingcustomeridentifier tieto, jolloin Netvisorin 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).
Netvisorissa myyntilasku lähetetään asiakkaalle aina oletuksena "sähköisintä" kanavaa pitkin, 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.
Jos kohdeasiakkaalle on määritetty 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. Kun tuot myyntilaskulle jaksotuksen käyttäen accrualrule -rakennetta, ei myyntilaskulle ole mahdollista tuoda rajapinnassa tositerivejä (invoicevoucherlines). 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. Kun käytetään metodia edit, kaikki tilauksen/laskun alkuperäiset tiedot tulee antaa sanomalla. | edit |
| Id | 0...1 | Päivitettävän laskun id, vaaditaan jos method on edit | 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. 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 | 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 | Numeerinen | 0...1 | 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- tai kommenttirivejä. 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 tai alla olevasta ALV-tunniste -taulukosta. 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 sekä tuote että 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. Kun tuot myyntilaskulle jaksotuksen käyttäen accrualrule -rakennetta, ei myyntilaskulle ole mahdollista tuoda rajapinnassa tositerivejä (invoicevoucherlines). 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 | 0...1 | Tuotteen nimi. Jos ei anneta, haetaan 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 | 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 | 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. 255 | 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! salesinvoiceproductlinesum ja 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ä. | 2021-06-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän tyyppi, aina ansi. | ansi |
| 5 | ordernumber | Numeerinen | 0...1 | Tuoterivin tilausnumero. | 1232 |
| 5 | proposedaccount | Numeerinen | 0...1 | Asiakkaan kirjanpitotili | 1011 |
| Attr. | type | Merkkijono | 1 | customer | customer |
| 2 | accountdimensiontext | Merkkijono, max 35 | 0...1 | Asiakkaan kustannuspaikkatieto, laskurivikohtainen. | kustannuspaikka |
Valinnaisesti voidaan tuoda kommenttirivi, jolloin 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 |
Valitun rakenteen jälkeen jatketaan seuraavasti:
| Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
| 2 | invoicevoucherlines | Aggregaatti | 0...1 | *3 | |
| 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 |
| 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 | Huom! Tämän elementin käyttö on muuttunut myyntilasku-uudistuksen myötä, käytännössä jatkossa ei ole väliä liitteen tyypillä, vaan kaikki liitteet toimivat sekä verkko-, sähköposti- että paperilaskujen kanssa. 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. Arvot: finvoice Verkkolaskun mukana välitettävät liitetiedostot Tulostuspalvelun, paikallisen tulostuksen tai sähköpostilaskutuksen kautta välitettävät liitteet) | |
| 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. Jos type=pdf ja printbydefault=1, tulee Netvisorissa laskun lähetyskanavaksi automaattisesti paperilasku, vaikka asiakaskortilla olisi verkkolaskutiedot | 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: NONE|KOOS|EUOS|EUUO|EUPO|100|KOMY|EUMY|EUUM|EUPM312|EUPM309|MUUL|EVTO|EVPO|RAMY|RAOS|EVRO
Katsothan myös Arvonlisäveron käsittely ja ALV-tunnisteet
| ALV-tunniste | ALV-koodi | ALV-prosentti |
| Ei alv-käsittelyä | NONE | 0 |
| Kotimaan myynti | KOMY | 0, 10, 14, 24 |
| EU-myynti | EUMY | 0 |
| EU:n ulkopuolinen myynti | EUUM | 0 |
| Kotimaan osto | KOOS | 0, 10, 14, 24 |
| EU-osto | EUOS | 0, 10, 14, 24 |
| EU-palveluosto | EUPO | 0, 10, 14, 24 |
| EU:n ulkopuolinen osto | EUUO | 0, 10, 14, 24 |
| 100% | 100 | 0 |
| 312 EU-palvelumyynti | EUPM312 | 0 |
| 309 EU-palvelumyynti | EUPM309 | 0, 10, 14, 24 |
| Muu arvonlisäveroton liikevaihto (310) | MUUL | 0, 10, 14, 24 |
| Tavaraostot muista EU-maista, vähennyskelvoton | EVTO | 0, 10, 14, 24 |
| Palveluostot muista EU-maista, vähennyskelvoton | EVPO | 0, 10, 14, 24 |
| Ei vähennyskelpoinen käännetty verovelvollisuus | EVKV | 0, 10, 14, 24 |
| Käänteinen verovelvollisuus | KAVE | 0, 10, 14, 24 |
| Rakentamispalvelun myynti | RAMY | 0 |
| Rakentamispalvelun osto | RAOS | 0, 10, 14, 24 |
| Ei vähennyskelpoinen rakentamispalvelun osto | EVRO | 0, 10, 14, 24 |
| EU:n ulkopuolinen maahantuonti ALV | MAAL | 0, 10, 14, 24 |
| EU:n ulkopuolinen maahantuonti ALV ei väh.kelp | EVMA | 0, 10, 14, 24 |
| KOMY 0% | KOMY0 | 0 |
*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.
Myyntilaskun poisto
Resurssi: deletesalesinvoice.nv
Resurssilla voidaan poistaa olemassa oleva myyntilasku tai myyntitilaus. Resurssi huolehtii itse laskun tai tilauksen poistosta ja sen liitteiden, dimensiolinkityksien, tositteiden ja yms. poistoista. fwgwgq
Kutsussa käytettävä parametri:
| Parametri | Ilmentymiä | Kuvaus |
| invoiceid | 1 | Poistettavan laskun NetvisorKey |
| orderid | 0...1 | Poistettavan tilauksen NetvisorKey |
Myyntilaskun tilan päivitys
Resurssi: updatesalesinvoicestatus.nv
Resurssi poikkeaa muista tämän sivun resursseista siten, että päivitettävä arvo annetaan suoraa URI:ssa.
Resurssilla voi päivittää yhden tai useamman myyntilaskun haluttuun tilaan. Jos lasku päivitetään "unsent" ("lähettämätön") -tilasta johonkin muuhun tilaan, myyntilaskulle muodostetaan automaattisesti myyntilasku tosite.
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Esimerkki | Kuvaus |
| netvisorkey | 1 | 1 | Laskun NetvisorKey |
| netvisorkeylist | 0...1 | 1,2,3 | Laskujen NetvisorKey lista pilkulla eroteltuna |
| status | 1 | open | Tila mihin lasku/laskut halutaan asettaa - open - overdue - reminded - requested - collected - paid - creditloss - unsent |
Myyntitilauksen laskuttaminen ja toimittaminen
salesorderinvoicing.nv
Resurssilla voidaan laskuttaa ja/tai toimittaa olemassa oleva tilaus.
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Kuvaus |
| method | 1 | deliveryonly (vain toimitetaan) tai billanddelivery (toimitetaan ja laskutetaan) |
| copysublines | 0...1 | Kopioi välisummarivit laskulle; true tai false |
| updatemidprice | 0...1 | Päivitä laskuriveille tuotteiden nykyinen keskihinta; true tai false |
Tuotavat tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena xml:nä (POST-data).
| Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
| 1 | root | Aggregaatti | 1 | ||
| 2 | salesorderinvoicing | Aggregaatti | 1 | ||
| 3 | invoicingcustomer | Aggregaatti | 1 | ||
| 4 | netvisorkey | Merkkijono | 1 | Laskutusasiakkaan NetvisorID | 1031 |
| 4 | invoicedate | Päivämäärä | 1 | Tilauksen päiväys | 2021-04-16 |
| Attr. | format | Merkkijono | 1 | Päivämäärän tyyppi, aina ansi | ansi |
| 5 | invoicingproductlines | Aggregaatti | 1 | Laskutettavat/toimitettavat rivit | |
| 6 | invoicingproductline | Aggregaatti | 1 | ||
| 7 | netvisorkey | Numeerinen | 1 | Tilausrivin NetvisorID | 123 |
| 7 | deliverydate | Päivämäärä | 1 | Tilausrivin toimituspäivä | 2021-04-16 |
| Attr. | format | Merkkijono | 1 | Toimituspäivän tyyppi, aina ansi | ansi |
| 7 | deliveryamount | Merkkijono | 1 | Toimitettu määrä | 1 |
| Attr. | ispostdelivery | Merkkijono | 1 | Onko kyseessä jälkitoimitus; true tai false | false |
| 7 | inventoryplace | Merkkijono | 0...1 | Varastopaikan ID | 321 |
| Attr. | type | Merkkijono | 1 | Aina netvisor | netvisor |
Kommentin tuominen myyntitilauksen tai -laskun käsittelyhistoriaan
salesinvoicecomment.nv
Resurssilla voidaan tuoda kommentti myyntitilauksen tai -laskun käsittelyhistoriamerkintöihin.
| Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
| 1 | root | Aggregaatti | 1 | ||
| 2 | salesinvoicecomments | Aggregaatti | 1 | ||
| 3 | salesinvoicecomment | Aggregaatti | 1 | ||
| 4 | invoicetype | Merkkijono | 1 | Laskutyyppi: - order (tilaus) - invoice (lasku) - invoicedraft (laskuluonnos) | invoice |
| 4 | invoicenetvisorkey | Numeerinen | 1 | Laskun, tilauksen tai luonnoksen NetvisorID | 123 |
| 4 | comment | Merkkijono, max 500 | 1 | Kommentti käsittelyhistoriamerkintöihin | kommentti |
Hyvityslaskun kohdistaminen laskulle
Resurssi: matchcreditnote.nv
Resurssilla on mahdollista kohdistaa hyvityslasku alkuperäiselle laskulle.
Molempien laskujen tulee olla tilassa "Lähetetty" ja niille tulee olla muodostettuna tositteet. Laskut eivät saa olla eri valuutassa.
| Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
| 1 | root | Aggregaatti | 1 | ||
| 2 | matchcreditnote | Aggregaatti | 1 | ||
| 3 | creditnotenetvisorkey | Merkkijono | 1 | Hyvityslaskun NetvisorKey | 2594 |
| 3 | invoicenetvisorkey | Numeerinen | 1 | Alkuperäisen laskun NetvisorKey | 2587 |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback