Resurssi: purchaseinvoice.nv

HTTP-metodi: POST

Ostolaskun tuonnista rajapinnan yli peritään verkkolaskun transaktiomaksu.

Huomaathan seuraavat rajoitukset suunnitellessasi ostolaskujen käsittelyä rajapinnan yli:

  • Ostolaskuille voidaan tuoda rajapinnan yli vain yksi liite, jota käsitellään ostolaskun kuvana.
  • Toimittajatiedot eivät päivity automaattisesti ostolaskun tietojen perusteella.

Ostolaskuja voi tuoda myös suuremmissa erissä. Ohjeet erätuontiin löydät täältä.

Ostolaskulle voi tuoda myös liitetiedostoja dokumentaation mukaan. Liitteen InvoiceSource -kentän arvo täytyy olla finvoice, jotta liitetiedosto voidaan tuoda.

Ostolaskun tuonnin yhteydessä luodaan toimittajakortti, jos toimittajatietoa ei löydy Netvisorista. Ostolaskun tuonnissa toimittajan kohdistus tapahtuu seuraavasti:

  1. Haetaan toimittajat, joissa nimi täsmää saapuneen laskun kanssa ja Y-tunnus on sama kuin laskulla.
  2. Haetaan toimittajat, joissa Y-tunnus täsmää saapuneen laskun kanssa.
  3. Haetaan toimittajat vendorcode:n perusteella
  4. Haetaan toimittajat, joissa nimi täsmää saapuneen laskun kanssa.

Mikäli mikään näistä ei täyty, luodaan järjestelmään uusi toimittaja.

Ostolaskun toimittajatiedot eivät päivity automaattisesti tuonnissa toimittajakortilta, vaikka toimittaja löytyisi Netvisorin toimittajaluettelosta. Ostolaskusanomalla on siis annettava kaikki toimittajatiedot erikseen.

Tuotavan ostolaskun tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena XML:nä (POST-data):

TasoElementtiMuoto ja pituusIlmentymiäKuvausEsimerkki
RootrootAggregaatti1  
1purchaseinvoiceAggregaatti1  
2invoicenumberMerkkijono 1Laskun numero 152212
2invoicedatePäivämäärä1Laskun päiväys2019-01-01
Attr.formatMerkkijono1Päivämäärän muoto, aina ansiansi
Attr.findopendateMerkkijono0...1Vain true true
2invoicesourceMerkkijono0...1finvoice tai manual, täytyy olla finvoice jotta liite voidaan tuoda. Jos käytetään finvoice, on tuonnissa noin minuutin viive, koska lasku kierrätetään Finvoice-käsittelijän kautta.manual
2valuedatePäivämäärä0...1Arvopäivä, tällä hetkellä tämä tarvitaan laskujen tuontiin, vaikka on merkitty vaihtoehtoiseksi DTD:ssä2019-01-15
Attr.formatMerkkijono1Arvopäivän muoto, aina ansiansi
2eventdatePäivämäärä0...1Kirjauspäivä, jonka perusteella laskun tosite muodostuu.2018-12-31
Attr.formatMerkkijono1Päivämäärän muoto, aina ansiansi
2duedatePäivämäärä 1Laskun eräpäivä2019-01-31
Attr.formatMerkkijono1Eräpäivän muoto, aina ansiansi
2purchaseinvoiceonroundMerkkijono0...1Laskun tila, open, approved,  tai acceptedopen
Attr.typeMerkkijono1Tilan tyyppi, aina netvisornetvisor
2vendorcodeMerkkijono0...1Jos annettu ja luodaan uusi toimittaja tuonnin yhteydessä, tallentuu myös toimittajan taakse. Ei päivity olemassa oleville toimittajille12345
2vendornameMerkkijono, maks. 2500...1Toimittajan nimiVendor Oy Ab 
2vendoraddresslineMerkkijono, maks. 800...1Toimittajan osoite Pajukuja 5 
2vendorpostnumberMerkkijono, maks. 500...1Toimittajan postinumero 53100
2vendorcityMerkkijono, maks. 500...1 Toimittajan postitoimipaikka Lappeenranta
2vendorcountryMerkkijono, maks. 500...1Toimittajan maakoodi FI
2vendorphonenumberMerkkijono, maks. 800...1Toimittajan puhelinnumero 
2vendorfaxnumberMerkkijono, maks. 800...1 Toimittajan fax-numero  
2vendoremailMerkkijono, maks. 800...1 Toimittajan sähköpostiosoitesupport@vendor.fi 
2vendorhomepageMerkkijono, maks. 800...1 Toimittajan www-osoite www.vendor.fi 
2amountNumericLaskun summa kahdella desimaalilla100,00
2accountnumberMerkkijono0...1Toimittajan tilinumero. Käytä IBAN-muotoa aina, kun kyseessä on IBAN-maa.FI000111234567
2organizationidentifierMerkkijono 0...1 Toimittajan Y-tunnus 123456-7 
2
sellerorganizationtaxcode
Merkkijono
0...1
Toimittajan VAT-tunnus

2deliverydatePäivämäärä0...1 Toimituspäivämäärä2019-01-01
Attr.formatMerkkijonoToimituspäivämäärän muoto, aina ansi ansi
2overduefinepercentNumeerinen 0...1 Myöhästymismaksuprosentti 
2bankreferencenumberTeksti, maks. 70 0...1 Pankin viitenumero tai ostolaskun viesti011234
2ourreferenceTeksti, maks. 200 0...1 Viitteemme 111234 
2yourreferenceTeksti, maks. 200 0...1Viitteenne 211234
2currencycodeTeksti 0...1 Valuuttakoodi, valuuttakoodin lisäksi sanomalla täytyy tuoda pankkitilitieto, jotta valuuttalaskenta tapahtuu oikein.GBP
2deliverytermsTeksti, maks. 255 0...1 Toimitusehdot  
2deliverymethodTeksti, maks. 2550...1 Toimitustapa  
2commentTeksti, maks. 255 0...1 Kommentti, laskun lisätieto kenttä 
2checksumTeksti 0...1 Tarkiste  
2pdfextrapagesNumeerinen 0...1  
2readyforaccountingNumeerinen0...1Mikäli annetaan arvo 1, niin Netvisor muodostaa tositteen automaattisesti, kun ostolaskun tila on approved tai accepted. Jos arvoa ei anneta, tehdään tiliöinti manuaalisesti Netvisorissa 
1
2
agreementidentifier
Merkkijono
0...1
Sopimustunnus
123
2primaryvendormatchtypeMerkkijono0...1Voidaan asettaa ensisijainen toimittajakohdistus arvon mukaan.
Sallitut arvot:
- code
- name
- organizationid
Mikäli annetun arvon kentän perusteella ei löydy toimittajaa, noudatetaan normaalia toimittajakohdistuksen järjestystä.

2purchaseinvoicelinesAggregaatti
  
3purchaseinvoicelineAggregaatti1...n  
4productcode Teksti, maks. 500...1Tuotekoodi15243
4productname Teksti, maks. 200 Tuotteen nimi
Voidaan jättää myös tyhjäksi
Esimerkkituote
4orderedamount Numeerinen 0...1 Tilattujen tuotteiden määrä 15
4deliveredamount Numeerinen Toimitettujen tuottedien määrä 10
4unitname Teksti0...1 Mittayksikkö. Ei näy Netvisorissa ostolaskulla mutta palautetaan jos ostolasku haetaan Netvisorista resurssilla getpurchaseinvoice.nvkpl
4unitprice Numeerinen Tuotteen verollinen yksikköhinta 5,48
4discountpercentage Numeerinen 0...1 Alennusprosentti 1,5
4vatpercent Numeerinen ALV-prosentti 24
4linesum Numeerinen 1Rivisumma. Pyöristys kahteen desimaaliin.125,25
Attr.typeTeksti 1Aina brutto
brutto
4description Teksti, maks. 200 0...1 Kuvaus  
4sortNumeerinen0...1Tuotavan rivijärjestysnumero1
4accountingsuggestionNumeerinen0...1Tiliöintiehdotus. Jos ei annettu, käytetään  toimittajan oletustiliöintitiliä. ALV-tunnus määrittyy tiliöintiriveille sen mukaan, mikä on asetettu Netvisorissa kyseisen tilin taakse.4000
4dimension 0...n  
5dimensionnameTeksti, maks. 501Laskentakohdeotsikko. Jos otsikkoa ei löydy, järjestelmä perustaa sen
Projektit
5dimensionitemTeksti, maks. 2001Laskentakohde. Jos kohdetta ei löydy, järjestelmä perustaa sen
Projekti 1 
2
purchaseinvoicesublines
Aggr.
0...1


3
purchaseinvoicesubline
Aggr.
1...n


4
productcode
Merkkijono
0...1
Tuotekoodi

4
productname
Merkkijono
0...1
Tuotteen nimi

4
orderedamount
Numeerinen
0...1
Tilattujen tuotteiden määrä

4
deliveredamount
Numeerinen
0...1
Toimitettujen tuotteiden määrä

4
unitname
Merkkijono
0...1
Mittayksikkö. Ei näy Netvisorissa ostolaskulla.

4
unitprice
Numeerinen
0...1
Tuotteen verollinen yksikköhinta

4
discountpercentage
Numeerinen
0...1
Alennusprosentti

4
vatpercent
Numeerinen
0...1
ALV-prosentti

4
linesum
Numeerinen
0...1
Rivisumma. Pyöristys kahteen desimaaliin.

Attr.
type
Merkkijono
1
Aina brutto
brutto
4
description
Merkkijono
0...1
Kuvaus

4
sort
Numeerinen
0...1
Tuotavan rivijärjestysnumero
1
2purchaseinvoiceattachmentsAggregaatti0...1Netvisor käsittelee liitettä laskun kuvana. Vain PDF-muotoiset tiedostot sallittu. 
3purchaseinvoiceattachmentAggregaatti1...n
 
4mimetypeMerkkijono1Liitteen mime-type Application/pdf
4attachmentdescriptionMerkkijonoLiitteen kuvaus Lasku 11234 max. 100 merkkiä
4filenameMerkkijonoLiitteen tiedostonimi Lasku11234.pdf 
4documentdataMerkkijonoLiitteen data Base64 muodossaS89O3Ly1Lr59NBAttr.
Attr.documenttype
Merkijono0...1
Liitteen tyyppi. invoiceimage (laskun kuva) tai otherattachment (muu liite)Oletuksena invoiceimage. Useista invoiceimage-tyyppisistä liitteistä näytetään vain ensimmäinen. Mikäli laskulle halutaan tuoda useampi liite, on ne oltava tyyppiä otherattachment.otherattachment
2
purchaseinvoicerelatedpurchaseordernumbers
Aggr.
0...1


3
purchaseinvoicerelatedpurchaseordernumber
Aggr.
1...n


4
purchaseordernumber
Merkkijono
1
Ostolaskuun linkitetyn ostotilauksen numero

2
partialpaymentdetails
Aggr.
0...n


3
paidamount
Numeerinen
1
Laskuun liittyvän suorituksen summa

Attr.
amountcurrencyidentifier
Merkkijono
1
Suorituksen valuutta
EUR


Oliko tästä vastauksesta apua? Kyllä Ei

Send feedback
Pahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.