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 | [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 | 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 feedback