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:
- Haetaan toimittajat, joissa nimi täsmää saapuneen laskun kanssa ja Y-tunnus on sama kuin laskulla.
- Haetaan toimittajat, joissa Y-tunnus täsmää saapuneen laskun kanssa.
- Haetaan toimittajat vendorcode:n perusteella
- 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):
| Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | purchaseinvoice | Aggregaatti | 1 | ||
| 2 | invoicenumber | Merkkijono | 1 | Laskun numero | 152212 |
| 2 | invoicedate | Päivämäärä | 1 | Laskun päiväys | 2019-01-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| Attr. | findopendate | Merkkijono | 0...1 | Vain true | true |
| 2 | invoicesource | Merkkijono | 0...1 | finvoice 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 |
| 2 | valuedate | Päivämäärä | 0...1 | Arvopäivä, tällä hetkellä tämä tarvitaan laskujen tuontiin, vaikka on merkitty vaihtoehtoiseksi DTD:ssä | 2019-01-15 |
| Attr. | format | Merkkijono | 1 | Arvopäivän muoto, aina ansi | ansi |
| 2 | eventdate | Päivämäärä | 0...1 | Kirjauspäivä, jonka perusteella laskun tosite muodostuu. | 2018-12-31 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 2 | duedate | Päivämäärä | 1 | Laskun eräpäivä | 2019-01-31 |
| Attr. | format | Merkkijono | 1 | Eräpäivän muoto, aina ansi | ansi |
| 2 | purchaseinvoiceonround | Merkkijono | 0...1 | Laskun tila, open, approved, tai accepted | open |
| Attr. | type | Merkkijono | 1 | Tilan tyyppi, aina netvisor | netvisor |
| 2 | vendorcode | Merkkijono | 0...1 | Jos annettu ja luodaan uusi toimittaja tuonnin yhteydessä, tallentuu myös toimittajan taakse. Ei päivity olemassa oleville toimittajille | 12345 |
| 2 | vendorname | Merkkijono, maks. 250 | 0...1 | Toimittajan nimi | Vendor Oy Ab |
| 2 | vendoraddressline | Merkkijono, maks. 80 | 0...1 | Toimittajan osoite | Pajukuja 5 |
| 2 | vendorpostnumber | Merkkijono, maks. 50 | 0...1 | Toimittajan postinumero | 53100 |
| 2 | vendorcity | Merkkijono, maks. 50 | 0...1 | Toimittajan postitoimipaikka | Lappeenranta |
| 2 | vendorcountry | Merkkijono, maks. 50 | 0...1 | Toimittajan maakoodi | FI |
| 2 | vendorphonenumber | Merkkijono, maks. 80 | 0...1 | Toimittajan puhelinnumero | |
| 2 | vendorfaxnumber | Merkkijono, maks. 80 | 0...1 | Toimittajan fax-numero | |
| 2 | vendoremail | Merkkijono, maks. 80 | 0...1 | Toimittajan sähköpostiosoite | support@vendor.fi |
| 2 | vendorhomepage | Merkkijono, maks. 80 | 0...1 | Toimittajan www-osoite | www.vendor.fi |
| 2 | amount | Numeric | 1 | Laskun summa kahdella desimaalilla | 100,00 |
| 2 | accountnumber | Merkkijono | 0...1 | Toimittajan tilinumero. Käytä IBAN-muotoa aina, kun kyseessä on IBAN-maa. | FI000111234567 |
| 2 | organizationidentifier | Merkkijono | 0...1 | Toimittajan Y-tunnus | 123456-7 |
| 2 | sellerorganizationtaxcode | Merkkijono | 0...1 | Toimittajan VAT-tunnus | |
| 2 | deliverydate | Päivämäärä | 0...1 | Toimituspäivämäärä | 2019-01-01 |
| Attr. | format | Merkkijono | 1 | Toimituspäivämäärän muoto, aina ansi | ansi |
| 2 | overduefinepercent | Numeerinen | 0...1 | Myöhästymismaksuprosentti | 5 |
| 2 | bankreferencenumber | Teksti, maks. 70 | 0...1 | Pankin viitenumero tai ostolaskun viesti | 011234 |
| 2 | ourreference | Teksti, maks. 200 | 0...1 | Viitteemme | 111234 |
| 2 | yourreference | Teksti, maks. 200 | 0...1 | Viitteenne | 211234 |
| 2 | currencycode | Teksti | 0...1 | Valuuttakoodi, valuuttakoodin lisäksi sanomalla täytyy tuoda pankkitilitieto, jotta valuuttalaskenta tapahtuu oikein. | GBP |
| 2 | deliveryterms | Teksti, maks. 255 | 0...1 | Toimitusehdot | |
| 2 | deliverymethod | Teksti, maks. 255 | 0...1 | Toimitustapa | |
| 2 | comment | Teksti, maks. 255 | 0...1 | Kommentti, laskun lisätieto kenttä | |
| 2 | checksum | Teksti | 0...1 | Tarkiste | |
| 2 | pdfextrapages | Numeerinen | 0...1 | ||
| 2 | readyforaccounting | Numeerinen | 0...1 | Mikä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 |
| 2 | primaryvendormatchtype | Merkkijono | 0...1 | Voidaan 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ä. | |
| 2 | purchaseinvoicelines | Aggregaatti | 1 | ||
| 3 | purchaseinvoiceline | Aggregaatti | 1...n | ||
| 4 | productcode | Teksti, maks. 50 | 0...1 | Tuotekoodi | 15243 |
| 4 | productname | Teksti, maks. 200 | 1 | Tuotteen nimi Voidaan jättää myös tyhjäksi | Esimerkkituote |
| 4 | orderedamount | Numeerinen | 0...1 | Tilattujen tuotteiden määrä | 15 |
| 4 | deliveredamount | Numeerinen | 1 | Toimitettujen tuottedien määrä | 10 |
| 4 | unitname | Teksti | 0...1 | Mittayksikkö. Ei näy Netvisorissa ostolaskulla mutta palautetaan jos ostolasku haetaan Netvisorista resurssilla getpurchaseinvoice.nv | kpl |
| 4 | unitprice | Numeerinen | 1 | Tuotteen verollinen yksikköhinta | 5,48 |
| 4 | discountpercentage | Numeerinen | 0...1 | Alennusprosentti | 1,5 |
| 4 | vatpercent | Numeerinen | 1 | ALV-prosentti | 24 |
| 4 | linesum | Numeerinen | 1 | Rivisumma. Pyöristys kahteen desimaaliin. | 125,25 |
| Attr. | type | Teksti | 1 | Aina brutto | brutto |
| 4 | description | Teksti, maks. 200 | 0...1 | Kuvaus | |
| 4 | sort | Numeerinen | 0...1 | Tuotavan rivijärjestysnumero | 1 |
| 4 | accountingsuggestion | Numeerinen | 0...1 | Tiliö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 |
| 4 | dimension | 0...n | |||
| 5 | dimensionname | Teksti, maks. 50 | 1 | Laskentakohdeotsikko. Jos otsikkoa ei löydy, järjestelmä perustaa sen | Projektit |
| 5 | dimensionitem | Teksti, maks. 200 | 1 | Laskentakohde. 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 |
| 2 | purchaseinvoiceattachments | Aggregaatti | 0...1 | Netvisor käsittelee liitettä laskun kuvana. Vain PDF-muotoiset tiedostot sallittu. | |
| 3 | purchaseinvoiceattachment | Aggregaatti | 1...n | ||
| 4 | mimetype | Merkkijono | 1 | Liitteen mime-type | Application/pdf |
| 4 | attachmentdescription | Merkkijono | 1 | Liitteen kuvaus | Lasku 11234 |
| 4 | filename | Merkkijono | 1 | Liitteen tiedostonimi | Lasku11234.pdf |
| 4 | documentdata | Merkkijono | 1 | Liitteen data Base64 muodossa | S89O3Ly1Lr59NBAttr. |
| Attr. | documenttype | Merkijono | 0...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 feedbackPahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.