Siirry pääsisältöön

Ostolaskun tuonti purchaseinvoice.nv

Resurssi: purchaseinvoice.nv

HTTP-metodi: POST

Ostolaskun tuonnista rajapinnan yli peritään verkkolaskun transaktiomaksu.

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

  • 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. Mikäli ostolaskulle halutaan muodostaa ostolaskun kuva (muodostuu Netvisorin ostolaskunäkymän kohtaan "Laskun kuva") InvoiceSource -elementin arvo täytyy olla finvoice. Myös jos automaatiosääntöjä halutaan käyttää ostolaskulla, tulee InvoiceSource -elementin arvo olla finvoice. Ostolaskun kuvaksi tarkoitettu liite voi olla Finvoice XML-tiedosto (ei voi olla TEAPPS-tiedosto), tällöin Netvisor generoi laskun kuvan Finvoice-aineiston pohjalta tai PDF-liite, tällöin PDF-tiedosto muodostuu ostolaskun kuvaksi. Finvoice XML-tiedoston saa ladattua käyttöliittymästä Ostolaskun toiminnot -> Lataa Finvoice-aineisto. PDF-muotoinen laskun kuva muodostuu liitteeksi kohtaan "Laskun liitteet".

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. Ostolaskua maksaessa, pankkiin menevälle maksuaineistolle muodostuu maksun saajan tiedot Netvisoriin saapuvan ostolaskuaineiston pohjalta. Jos ostolaskut siis maksetaan Netvisorista, tulee rajapinnan kautta tuotavalta aineistolta löytyä maksun saajan tiedot täydellisenä, jotta maksaminen onnistuu.

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

Parametri

Ilmentymät

Esimerkki

Kuvaus

useonlyexistingdimensions

0...1

1

Estää uusien laskentakohdeotsikkojen ja laskentakohteiden automaattisen luonnin. Palauttaa virheen, jos annettua laskentakohdetta ei ole olemassa.

1=esto käytössä

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 ISO-3166 standardin mukaisesti

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

2

vendorhomepage

Merkkijono, maks. 80

0...1

Toimittajan www-osoite

2

amount

Numeric

1

Laskun mahdolliset verot sisältävä kokonaissumma 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


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

25,50

4

linesum

Numeerinen

1

Mahdolliset verot sisältävä kokonaisrivisumma. Pyöristys kahteen desimaaliin.

125,25

Attr.

type

Teksti

1

Aina brutto

brutto

4

description

Teksti, maks. 200

0...1

Riviselite

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

5

dimensionitemcode

Merkkijono

0...1

Laskentakohteen koodi

(kun tämä on annettu, ohitetaan dimensionitem -elementti)

DIMC-001

5

dimensionitemname

Merkkijono

0...1

Laskentakohteen nimi

(kun tämä on annettu, ohitetaan dimensionitem -elementti)

Item Name 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

Riviselite


4

sort

Numeerinen

0...1

Tuotavan rivijärjestysnumero

1

2

purchaseinvoicecommentlines

Aggr.

0...1



3

purchaseinvoicecommentline

Aggr.

1...n



4

comment

String

1

Kommentti


4

sort

String

0...1



2

purchaseinvoiceattachments

Aggregaatti

0...1

Netvisor käsittelee liitettä laskun kuvana, katso ohje yltä. Sallitaan Finvoice XML ja PDF-muotoiset liitteet.

3

purchaseinvoiceattachment

Aggregaatti

1...n


4

mimetype

Merkkijono

1

Liitteen mime-type

Application/pdf

Application/xml

4

attachmentdescription

Merkkijono

1

Liitteen kuvaus

Lasku 11234 max. 100 merkkiä

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

Vastasiko tämä kysymykseesi?