Myyntilaskun tai tilauksen nouto getsalesinvoice.nv getorder.nv

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ä
​pdf
palauttaa laskun kuvan pdf-muodossa LastSentInvoicePDFBase64Data-kentässä
​nopdf
ei palauta mitään
​preview
palauttaa myyntilaskun esikatselunäkymän

pdf

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). *Kts. alta miten vastaus eroaa tällä parametrilla muista

1,2,3

includedocuments

0...1

Palauttaa myyntilaskua noudettaessa laskulle liittyvät tilaukset. Palauttaa myyntitilausta noudettaessa tilaukselle liittyvät laskut

1

replyoption

0...1

Palauttaa lisäkenttiä myyntilaskun noudossa seuraavasti:
​
arvolla 1: Events (ks. dokumentaatio alta)
arvolla 2: Accrual
arvolla 3: Events + Accrual
arvolla 4: Factoring
arvolla 5: Events + Factoring
arvolla 8: PaymentPlan
arvolla 16: CreditedInvoice NetvisorKey ja InvoiceNumber eli hyvityslaskulla tieto mikä lasku on hyvitetty.Tieto palautuu, kun hyvitys on tehty Netvisorin käyttöliittymässä myyntilaskulta.
arvolla 31: Sisältää kaikki lisäkentät
arvolla 32: Palauttaa tiedon hyvitetystä tai hyvitettävästä laskusta, johon kohdistettu
arvolla 62: Palauttaa kaikki replyoption liput

1

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ä

Laskun arvopäivä (palautuu tilaukselle tyhjänä)

2021-01-27

Attr.

format

Merkkijono

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

ForeignCurrencyAmount

Numeerinen

0...1

Valuuttasumma

113,29

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

Attr.

ISO-3166

Merkkijono

1

Laskutettavan asiakkaan maakoodi ISO-3166 formaatissa

FI

2

InvoicingCustomerInCollectionProhibitation

Numeerinen

1

Laskutusasiakas perintäkiellossa, 1=kyllä, 0=ei

1

2

MatchPartialPaymentsByDefault

Merkkijono

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

PaymentInterest

Merkkijono

1

Laskun viivästyskorko

5

2

Waybillidentifier

Merkkijono

1

Rahtikirjan numero

033000050143

2

OrderNumber

Merkkijono

1

Myyntilaskun toiminnot > Lisätiedot: Ulkoinen tilausnumero

10012

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

[email protected]

2

LastSentInvoicePDFBase64Data

Base64

0...1

Edellisen lähetetyn laskun PDF tieto

S89O3Ly1Lr59NB

2

CreditedInvoiceNetvisorKey

Numeerinen

0...1

Hyvitetyn laskun Netvisorkey

27

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

SalesInvoiceProductLinesum

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
​
Jos laskentakohteella on käytössä tunniste, palautuu vastauksessa yhdistelmänimi tunniste + nimi, esim. "P001 Verkkosivuston uudistus"

Helsinki

6

dimensionitemname

Merkkijono

0...1

Laskentakohteen nimi

Verkkosivuston uudistus

6

dimensionitemcode

Merkkijono

0...1

Laskentakohteen tunniste

P001

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

3

Events

Aggregaatti

1

Laskuun liittyvät lähetys- ja tilatiedot (käsittelyhistoriamerkinnät)

Aggregaatti tulee sanomalle vain kun parametrille replyoption on annettu arvo 1

4

Event

Aggregaatti

1...n

​

​

5

Timestamp

Päivämäärä + kellonaika

1

Merkinnän päivämäärä+ aikaleima

2023-11-07 18:25:25.717

Attr.

format

Merkkijono

1

Päivämäärän tyyppi

ansi

5

UserName

Merkkijono

1

Toimenpiteen tehneen käyttäjän nimi

Testi Henkilö

5

Description

Merkkijono

1

Merkinnän kuvaus

Lasku on luotu myyntitilauksesta.

Attr.

Type

Merkkijono

1

Merkinnän tyyppi

StatusAndDeliveryInformation

3

Accrual

Aggregaatti

1

Laskun jaksotustiedot

Aggregaatti tulee sanomalle vain kun parametrille replyoption on annettu arvo 2

4

DivisonCurve

Merkkijono

1

Jakokäyrän nimi

yksi kuukausi

Attr.

NetvisorKey

Numeerinen

1

Jakokäyrän Netvisorkey

1

4

StartMonth

Numeerinen

1

Jaksotuksen alkukuukausi

6

4

StartYear

Numeerinen

1

Jaksotuksen alkuvuosi

2024

4

EndMonth

Numeerinen

1

Jaksotuksen päättymiskuukausi

6

4

EndYear

Numeerinen

1

Jaksotuksen päättymisvuosi

2024

3

FactoringAccount

Merkkijono

1

Factoring-tilin nimi

Factoring

Attr.

NetvisorKey

Numeerinen

1

Factoring-tilin Netvisorkey

1

3

PaymentPlan

Aggregaatti

1

Laskun maksusuunnitelma

Aggregaatti tulee sanomalle vain kun parametrille replyoption on annettu arvo 8

4

Payment

Aggregaatti

1...n

​

​

5

DueDate

Päivämäärä

1

Maksusuunnitelman erän eräpäivä

2024-06-25

Attr.

format

Merkkijono

1

Päivämäärän tyyppi

ansi

5

Sum

Numeerinen

1

Maksusuunnitelman erän summa

46,75

Taso

Elementti

Muoto

Ilmentymiä

Kuvaus

Esimerkki

Root

Root

Aggregaatti

1

​

​

1

SalesInvoices

Aggregaatti

1

​

​

2

SalesInvoice

Aggregaatti

1..n

​

​

3

SalesInvoiceNetvisorKey

Merkkijono

1

Laskun Netvisor ID

1234

Päivämäärä

Muutos

Kuvaus

​

Uudet elementit dimensionitemname ja dimensionitemcode
​
Muutos dimensionitem -elementin logiikkaan

Netvisorin uuden laskentakohdekäsittelyn mukaiset elementit lisätty. Jos laskentakohteelle on asetettu Netvisorissa tunniste, palautuu tunniste uudessa elementissä dimensionitemcode.Tällöin dimensionitem -elementti palauttaa yhdistelmänimen, joka sisältää sekä laskentakohteen tunnisteen että nimen.

12.12.2024

Uuden elementin lisäys

Lisätty elementti InvoicingCustomerInCollectionProhibitation
Laskutusasiakas perintäkiellossa, 1=kyllä, 0=ei

30.9.2024

lisätty getsalesinvoice.nv replyoption lipulla 16

16 Palauttaa hyvityslaskun numeron

25.6.2024

Uuden elementin lisäys

replyoption -parametrilla voidaan nyt palauttaa uusia aggregaatteja:
​
Laskun käsittelyhistoriamerkinnät
Jaksotustiedot
Tieto Factoring-tilistä
Laskulle asetettu maksusuunnitelma

20.6.2024

Uuden elementin lisäys

Lisätty elementti PaymentInterest - laskun viivästyskorko

15.7.2025

lisätty getsalesinvoice.nv replyotion lipulla 32 ja 64

32 palauttaa kohdistetun laskun ja 64 kaikki replyoption liput