Resurssi: getsalesinvoice.nv tai getorder.nv
HTTP-metodi: GET
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). *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 arvolla 31: Sisältää kaikki lisäkentät | 1 |
Esimerkki: getsalesinvoice.nv?netvisorkey=1234&pdfimage=pdf&showprocesshistory=1
Esimerkki: getorder.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ä | 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 |
| 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 | 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 | 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 | 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 |
| 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 |
*Mikäli käytetään parametria netvisorkeylist ja vastaus palauttaa enemmän kuin yhden myyntilaskun, vastaukseen tulee yksi SalesInvoices aggregaatti lisää, muutoin vastaus noudattaa samaa mallia:
| 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 |
Muutoshistoria
| Päivämäärä | Muutos | Kuvaus |
| 30.9.2024 | lisätty getsalesinvoice.nv replyoption lipulla 16 ja 31 | 16 Palauttaa hyvityslaskun numeron ja 31 kaiken |
| 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 |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedbackPahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.