Ostolaskun tuonnista rajapinnan yli peritään aina 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ä.

Ostolaskujen ja ostotilausten käsittelyyn liittyvät seuraavat resurssit:

IntegraatioSuuntaResurssiDTDSkeemaEsimerkki
Ostolaskulistan noutoGETpurchaseinvoicelist.nv  Lataa
Ostolaskun noutoGETgetpurchaseinvoice.nv   
Ostolaskun liitteiden noutoGETgetattachments.nv   
Ostolaskun tuontiPOSTpurchaseinvoice.nvpurchaseinvoice.dtd 
Ostolaskun hyväksynnän
tilan päivittäminen ja tiliöinti
POSTpurchaseinvoicepostingdata.nvpurchaseinvoice
postingdata.dtd
 Lataa
Ostolaskun asiatarkastus- ja hyväksyntäkierron tuontiPOSTpurchaseinvoicecirculation.nv
purchaseinvoicecirculation.xsdLataa
Ostotilauksen tuontiPOSTpurchaseorder.nvpurchaseorder.dtdpurchaseorder.xsdLataa
Ostotilauslistan noutoGETpurchaseorderlist.nv  Lataa
Ostotilauksen noutoGETgetpurchaseorder.nv  Lataa
Toimittajan tuontiPOSTvendor.nv   
Toimittajan noutoGETgetvendor.nv   
Laatuluokkien tuontiPOSTproductquality.nv productquality.xsd Lataa
Laatuluokkien noutoGETgetproductqualitylist.nv

Lataa

 

KuvausSkeema
Netvisor skeema tyypityksetnetvisorgeneraltypes.xsd

Ostolaskulistan nouto

Resurssi: purchaseinvoicelist.nv

Kutsussa käytettävät parametrit:

ParametriIlmentymiäKuvausEsimerkki
begininvoicedate0...1Ostolaskut alkaen päivämäärästä2019-05-20
endinvoicedate0...1Ostolaskut päivämäärään asti2019-05-30
invoicenumber0...1Ostolaskun numerorajaus1001
invoicestatus0...1Ostolaskun statusrajaus
- Open, Approved = hyväksynnässä
- Accepted = hyväksytty
Open
lastmodifiedstart0...1Hakee ostolaskut, joita on muutettu annetun päivämäärän jälkeen. Tulee antaa muodossa yyyy-MM-ddTHH:mm:ss2019-05-15T12:00:00
lastmodifiedend0...1Hakee ostolaskut, joita on muutettu ennen annettua päivämäärää. Tulee antaa muodossa yyyy-MM-ddTHH:mm:ss2019-05-15T18:30:00
purchaseinvoicebatchid 0...1Rajaa ostolaskuerässä tuodut ostolaskut annetun erä ID:n mukaisesti. Katso ostolaskuerän käsittelyn kuvaus.123

Vastaus

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
rootRootAggregaatti1  
1PurchaseInvoiceListAggregaatti1  
2PurchaseInvoiceAggregaatti0...n  
3NetvisorKeyNumeerinen1Laskun tunniste Netvisorissa 123
3InvoiceNumberMerkkijonoLaskun numero345
3InvoiceDatePäivämääräLaskun päivämäärä2013-10-23
AttribuuttiformatMerkkijonoPäivämäärän muoto, aina ansi ansi
3VendorMerkkijonoToimittajan nimiVendor Oy Ab
3VendorOrganizationIdentifierNumeerinen1Toimittajan y-tunnus1234567-8
3SumNumeerinenLaskun kokonaissumma 100,00
3PaymentsNumeerinenLaskun maksettu summa 30,50
3OpenSumNumeerinenLaskun avoin summa 69,50
3UriMerkkijonoURI josta voi hakea laskun täydelliset tiedot  /getpurchaseinvoice.nv?netvisorkey=123

Ostolaskun nouto

Resurssi: getpurchaseinvoice.nv

Noutaa halutun ostolaskun yksityiskohtaiset tiedot.
Kyselyssä käytettävät parametrit:

ParametriIlmentymiäKuvausEsimerkki
netvisorkey1

Laskun tunniste Netvisorissa

123

netvisorkeylist0...1

Palauttaa yhdessä pyynnössä täydet tiedot ostolaskuista, max. 500 ID:tä.
Pyynnön URI:n maksimi pituus 2115 merkkiä.

1,2,3

version0...1

 Palauttaa yksittäisen laskurivin (PurchaseInvoiceLine) laskentakohteet laskurivin elementin sisään
1 = Laskentakohteet laskurivien ulkopuolella, käytetään vakiona tai jos parametria ei anneta
2 = Laskentakohteet laskurivien sisällä

2

include0...1

 - actions = Palautetaan mitä ostolaskulle voi tehdä (asiatarkastaa, hyväksyä, hylätä, maksuvalmis)
- handlinghistory = Palautetaan ostolaskun käsittelyhistoria
- previewimage = Palautetaan ostolaskun esikatselukuva

actions

omitattachments0...1

True = Ei palauteta ostolaskun liitteitä
False = Palautetaan ostolaskun liitteet
Jos parametria ei anneta = True

true

Vastaus:

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
rootRootAggregaatti1  
1PurchaseInvoiceAggregaatti1  
2PurchaseInvoiceNumberMerkkijono1Laskun numero345
2PurchaseInvoiceDatePäivämäärä1Laskun päiväys2014-10-02
AttribuuttiformatMerkkijono1Päivämäärän muoto, aina ansiansi
2PurchaseInvoiceDeliveryDatePäivämäärä1Laskun toimituspäivä2014-10-04
AttribuuttiformatMerkkijono1Toimituspäivän muoto, aina ansiansi
2PurchaseInvoiceDueDatePäivämäärä1Laskun eräpäivä2014-10-31
AttribuuttiformatMerkkijono1Eräpäivän muoto, aina ansiansi
2PurchaseInvoiceValueDatePäivämäärä1Laskun arvopäivä2014-10-15
AttribuuttiformatMerkkijono1Arvopäivän muoto, aina ansiansi
2PurchaseInvoiceReferencenumberMerkkijono1Laskun viitenumero12594
2PurchaseInvoiceAmountNumeerinen1Laskun summa kahdella desimaalilla123,45
2PurchaseInvoicePaidAmountNumeerinen1Laskusta maksettu summa kahdella desimaalilla100,00
2ForeignCurrencyAmountNumeerinen1Laskun valuuttasumma123,45
2ForeignCurrencyNameIDMerkkijono1ValuuttakoodiEUR
2InvoiceStatusMerkkijono1Laskun tila
Huom: palauttaa tällä hetkellä aina avoin/open, keskeneräinen toiminnallisuus
avoin/open
2ApprovalStatusMerkkijono1

Laskun hyväksynnän tila:
uusi lasku = open
asiatarkastuksessa = infactualverification
hyväksynnässä = approved
hyväksytty = accepted
hylätty = acceptorrejected

open

2PurchaseInvoiceOurReferenceMerkkijono1Viitteemme012594
2PurchaseInvoiceYourReferenceMerkkijono1Viitteenne112594
2PurchaseInvoiceDescriptionMerkkijono1Laskun lisätieto 
2VendorNameMerkkijono1Toimittajan nimiVendor Oy Ab
2VendorAddressLineMerkkijono1Toimittajan osoite 
2VendorPostNumberMerkkijono1Toimittajan postiosoite 
2VendorTownMerkkijono1Toimittajan postitoimipaikka 
2VendorCountryMerkkijono1Toimittajan maakoodi 
2VoucherIDNumeerinen0...1Ostolaskun tositteen NetvisorKey1123
2IsAccountedMerkkijono1Onko ostolasku tiliöityTrue
2PreviewImageMerkkijono0...nKun käytössä parametri action - previewimage
 
2AttachmentsAggregaatti0...1  
3AttachmentAggregaatti1...n  
4AttachmentBase64DataMerkkijono1Liitteen Base64 enkoodattu data 
4FileNameMerkkijono1Liitteen tiedostonimiLasku12594.pdf
4ContentTypeMerkkijono1Liitteen MIME-tyyppiApplication/pdf
4CommentMerkkijono1Kommentti liitteelle 
2InvoiceLinesAggregaatti0...1  
3PurchaseInvoiceLineAggregaatti1...n  
4NetvisorKeyNumeerinen1Tuotteen Netvisor avain 
4LineSumNumeerinen1Rivisumma verollinen
 
4LineNetSumNumeerinen1Rivisumma veroton 
4UnitPriceNumeerinen1Yksikköhinta (verollinen) 
4VatPercentNumeerinen1Alv-prosentti  
4VatCodeMerkkijono1Alv-koodi  
4DescriptionMerkkijono0...1Riviselite 
4UnitMerkkijono0...1Mittayksikkö  
4OrderedAmountNumeerinen1Tilattujen tuotteiden määrä  
4PurchasePriceNumeerinen0...1Ostohinta  
4DeliveredAmountNumeerinen1Toimitettujen tuotteiden määrä  
4ProductCodeMerkkijono1Tuotekoodi  
4DiscountPercentageNumeerinen1Alennusprosentti  
4ProductNameMerkkijono1Nimike 
4

AccountingSuggestionBookkeeping
AccountNetvisorKey

Merkkijono0...1Tiliöntiehdotuksen tilin Netvisorkey 
4AccountingSuggestionBookkeepingAccountMerkkijono0...1Tiliöntiehdotuksen tili 
4PurchaseInvoiceDimensionsAggregaatti0...1Tasot 4 -5 -6 kun version parametri on 2
Muussa tapauksessa tasot 3-4-5
 
5DimensionAggregaatti1...n  
6DimensionNameMerkkijono1Laskentakohdeotsikko 
6DimensionDetailNameMerkkijono1Laskentakohde 
2LinkedPurchaseOrdersAggregaatti0...1Jos ostolaskulle on liitetty ostotilauksia, niiden numerot ja ID:t palautetaan 
3PurchaseOrderAggregaatti1...n  
4OrderNumberMerkkijono1Ostotilauksen numero123
4NetvisorKeyMerkkijono0...1

Ostotilauksen NetvisorID

Huom. Jos ostotilauksen numero on syötetty ostolaskulle ennakkoon, ei ostotilausta vielä löydy järjestelmästä

10

Kun käytössä parametri actions lisätään sanoman loppuun seuraava rakenne:

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
2PostingLinesAccessAggregaatti1Ostolaskun tiliöinti 
3CanEditPostingLinesMerkkijono1 True
3CanUserPostInvoiceMerkkijono1 False
3SuggestPostingByDefaultMerkkijono1 True
3CanEditAccountingSuggestionMerkkijono1 False
2ActionsAggregaatti1Mitä laskulle käyttäjän oikeuksilla voi tehdä
 
3ActionAggregaatti1...n  
4IdMerkkijono1Mahdolliset arvot:
approved
accepted
reject
pay
accepted
4TypeMerkkijono1Annetaa käytettävä resurssi jolla action voidaan suorittaa
purchaseinvoicepostingdata
4DescriptionMerkkijono1Toiminteen seliteHyväksy lasku
2AlertsAggregaatti1Jos hälytyksiä ei ole näytetään pelkkä ylätason tag 
3AlertAggregaatti1  
4HeadingMerkkijono1OtsikkoLasku on lukitulla kaudella
4DescriptionMerkkijono1SeliteLaskun hyväksyminen ei päivitä laskun tietoja, koska lasku kuuluu lukitulle kaudelle
2NotificationsAggregaatti1Jos ilmoituksia ei ole näytetään pelkkä ylätason tag 
3NotificationAggregaatti1  
4HeadingMerkkijono1Otsikko 
4DescriptionMerkkijono1SeliteToimittajan pankkitili on poistettu, päivitä pankkitili 

Kun käytössä parametri handlinghistory lisätään sanoman loppuun seuraava rakenne:

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
2HandlingHistoryAggregaatti1Laskun käsittelyhistoria 
3HandlingHistoryLineAggregaatti1...n  
4TypeMerkkijono1TapahtumaInvoiceCreated
4HeadingMerkkijono1OtsikkoLuotu
4DescriptionMerkkijono1SeliteLasku luotu järjestelmään
4TimestampPäivämäärä1Aikaleima2018-01-01 09:45:49.200
AttribuuttiformatMerkkijonoPäivämäärän muoto, aina ansi ansi
4UserNameMerkkijono1Kenen toimesta toiminne suoritettuJärjestelmä
4UpdatedInformationFieldsAggregaatti1...nPäivitetyt tiedot 
5FieldNameMerkkijono1TietoTiliöity
5OldValueMerkkijono1Vanha arvoEi
5NewValueMerkkijono1Uusi arvoKyllä

Ostolaskun liitteiden nouto

Resurssi: getattachments.nv

Palauttaa ostolaskun liitteet.
Palauttaa myös ostolaskun finvoice-tyyppisen liitteen kuvatiedostona, jolloin laskun "kuvan" saa näytettyä myös verkkolaskuista.

Kutsussa käytettävät parametrit:

ParametriIlmentymiäKuvausEsimerkki
attachmentsource1Aina purchaseinvoice
purchaseinvoice
netvisorkey1Haettavan ostolaskun Netvisor ID123
convertpdfstoimages0...1Arvolla true konvertoidaan ostolaskun pdf-liitteet png kuviksi.
Jokainen pdf sivu omana kuvanaan
true

Vastaus:

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
rootRootAggregaatti1  
1AttachmentsAggregaatti1  
2AttachmentAggregaatti1...n  
3AttachmentNetvisorKeyNumeerinen1Liitteen Netvisorissa oleva ID 123
3AttachmentPageNumberNumeerinenSivunumero1
3FileNameMerkkijonoLaskun päivämääräTestikuva.jpg
3FileTypeMerkkijono1 image/png
3ContentMerkkijonoBase64 enkoodattu tiedosto
iVBORw0KGgoAAAANSUhEUgAAB

Ostolaskun tuonti

Resurssi: purchaseinvoice.nv

Ostolaskun tuonnista rajapinnan yli peritään verkkolaskun transaktiomaksu.

Ostolaskulle ei voida tuoda varsinaisia liitetiedostoja vaan tuotu tiedosto käsitellään ostolaskun kuvana. Toki tiedoston varsinaista sisältöä ei ole rajattu. Siirtoaineiston mukana tuotu liitetiedosto löytyy ostolaskunäkymästä kuvana. Vaikka DTD:n mukaan laskulla voi olla useampi liitetiedosto, käytännössä käyttöliittymästä saadaan näkyviin vain 1 tiedosto. Liitetiedoston tulee olla PDF-muotoinen.

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 vendorcode perusteella
  2. Haetaan toimittajat, joissa tilinumero ja nimi täsmää saapuneen laskun kanssa ja Y-tunnus on sama kuin laskulla.
  3. Haetaan toimittajat, joissa tilinumero täsmää saapuneen laskun kanssa ja Y-tunnus on sama kuin laskulla.
  4. Haetaan toimittajat, joissa tilinumero ja nimi täsmää saapuneen laskun kanssa.
  5. Haetaan toimittajat, joissa nimi täsmää saapuneen laskun kanssa ja Y-tunnus on sama kuin laskulla.
  6. Haetaan toimittajat, joissa tilinumero täsmää saapuneen laskun kanssa ja Y-tunnus on toimittajalla tyhjä.
  7. Haetaan toimittajat, joissa tilinumero täsmää saapuneen laskun kanssa.
  8. Haetaan toimittajat, joissa Y-tunnus täsmää saapuneen laskun kanssa.
  9. Haetaan toimittajat, joissa nimi täsmää saapuneen laskun kanssa.

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

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
AttribuuttiformatMerkkijono1Päivämäärän muoto, aina ansiansi
AttribuuttifindopendateMerkkijono0...1Vain true True
2invoicesourceMerkkijono0...1finvoice or manual, täytyy olla finvoice jotta liite voidaan tuodamanual
2valuedatePäivämäärä0...1Arvopäivä, tällä hetkellä tämä tarvitaan laskujen tuontiin, vaikka on merkitty vaihtoehtoiseksi DTD:ssä2019-01-15
AttribuuttiformatMerkkijono1Arvopäivän muoto, aina ansiansi
2eventdatePäivämäärä0...1Kirjauspäivä, jonka perusteella laskun tosite muodostuu.2018-12-31
AttribuuttiformatMerkkijono1Päivämäärän muoto, aina ansiansi
2duedatePäivämäärä 1Laskun eräpäivä2019-01-31
AttribuuttiformatMerkkijono1Eräpäivän muoto, aina ansiansi
2purchaseinvoiceonroundMerkkijono0...1Laskun tila, open, approved,  tai acceptedopen
AttribuuttitypeMerkkijono1Tilan tyyppi, täytyy olla 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. Lisätietoja.FI000111234567
2organizationidentifierMerkkijono 0...1 Toimittajan Y-tunnus 123456-7 
2deliverydatePäivämäärä0...1 Toimituspäivämäärä2019-01-01
AttribuuttiformatMerkkijonoToimituspäivämäärän muoto, aina ansi ansi
2overduefinepercentNumeerinen 0...1 Myöhästymismaksu prosentti 
2bankreferencenumberTeksti, maks. 70 0...1 Pankin viitenumero 011234
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  
2checksumTeksti 0...1 Tarkiste  
2pdfextrapagesNumeerinen 0...1  
2readyforaccountingNumeerinen0...1Mikäli annetaan arvo 1, niin Netvisor muodostaa tositteen automaattisesti. Jos arvoa ei anneta, tehdään tiliöinti manuaalisesti Netvisorissa 1
2primaryvendormatchtypeMerkkijono0...1Voidaan pakottaa toimittajakohdistus   annetun arvon mukaan
Sallitut arvot:
- code
- name
- bankaccountnumber
- organizationid
Mikäli annetun arvon kentän perusteella ei löydy toimittajaa, noudatetaan normaalia toimittajakohdistuksen järjestystä
v
2purchaseinvoicelinesAggregaatti1  
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 verollien yksikköhinta 5,48
4discountpercentage Numeerinen 0...1 Alennusprosentti 1,5
4vatpercent Numeerinen ALV-prosentti 22,00
4linesum Numeerinen 1Pyöristys kahteen desimaaliin125,25
AttribuuttitypeTeksti 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 
2purchaseinvoicecommentlines 0...1  
3purchaseinvoicecommentline 1...n  
4comment 1Komenttirivin sisältöTekstiä
4sort 0...1  
2purchaseinvoiceattachmentsAggregaatti0...1Netvisor käsittelee liitettä laskun kuvana. Vain PDF-muotoiset tiedostot sallittu. 
3purchaseinvoiceattachmentAggregaatti1...nKäytännössä vain ensimmäinen liite näytetään  
4mimetypeMerkkijono1Liitteen mime-type Application/pdf
4attachmentdescriptionMerkkijonoLiitteen kuvaus Lasku 11234
4filenameMerkkijonoLiitteen tiedostonimi Lasku11234.pdf 
4documentdataMerkkijonoLiitteen data Base64 muodossaS89O3Ly1Lr59NB

 

Ostolaskun hyväksynnän tilan päivittäminen ja tiliöinti

Resurssi: purchaseinvoicepostingdata.nv

Resurssia voi käyttää ostolaskun hylkäämiseen, asiatarkastamiseen tai hyväksyntään sekä tiliöinnin tekemiseen. Tuonnin yhteydessä voi antaa myös tiliöintirivit uudelleen, eli rivejä voi tätä kautta muokata ja ostolaskurivi voidaan tiliöidä tällä useammaksi tiliöintiriviksi.

Resurssia kutsuttaessa tarkistetaan sanomalla määriteltyjen ohjelmistorajapintatunnusten omistajan tiliöintioikeudet.

Ostolasku jota halutaan asiatarkastaa, hyväksyä tai hylätä pitää olla tilassa avoin. Rivitiedot ovat samat kuin ostolaskusanomassakin, tuotavat rivitiedot korvaavat ostolaskulla olevat rivitiedot. Rivitiedoissa olevat summat pitää vastata ostolaskun summaa, muutoin tuonti jää virheeseen.

Ostolaskun voi tiliöidä ilman tilan muuttamista, kun annetaan -elementtiin 1, mutta jätetään -elementti tyhjäksi. Riippuen ostolaskun tilasta, niin tämä joko esitiliöi tai tiliöi laskun, kuten käyttöliittymän kautta.

Ostolaskun tiliöintirivejä voi muokata, lisätä ja poistaa, jos lasku on tilassa: Uusi lasku, Asiatarkastettu, Hyväksytty tai Tiliöity. Tiliötintirivien summa tulee olla sama kuin laskun alkuperäinen summa. Lasku ei saa olla lukitulla kaudella.

Jos ostolasku halutaan asiatarkastaa, hyväksyä tai tiliöidä, tulee ohjelmistorajapintakäyttäjällä olla tarvittavat oikeudet. Käyttäjällä tulisi olla vähintään Ostoreskontran käyttäjän profiili.

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

TasoElementtiMuoto ja pituusIlmentymiäKuvausEsimerkki
rootRootAggregaatti1  
1PurchaseInvoicePostingDataAggregaatti1  
2PurchaseInvoiceNetvisorKeyNumeerinen1Ostolaskun ID
31646
2StatusMerkkijono1

Ostolaskun tilat (status) missä järjestyksessä ne voidaan antaa:
contentsupervisorrejected = hylätty asiatarkastuksessa
approved = asiatarkastettu
acceptorrejected = hylätty hyväksynnässä

accepted = hyväksytty

Ostolaskun tilaa ei voi enää päivittää aiempaan tilaan tai antaa ostolaskulla jo olevaa tilaa.

approved

2IsReadyForAccountingNumeerinen1Mikäli annetaan arvo 1, niin Netvisor muodostaa tositteen automaattisesti.
Jos arvoa ei anneta, tehdään tiliöinti manuaalisesti Netvisorissa
1
2CommentMerkkijono, max 3000 merkkiä0...1Ostolaskun kommenttiKommentti
3PurchaseInvoicePostingLineAggregaatti0...n  
4purchaseinvoicelinenetvisorkeyNumeerinen0...1Ostolaskurivin iNetvisorID12345
4ProductCodeMerkkijono0...1Tuotekoodi123
4ProductNameMerkkijonoTuotteen nimi
Voidaan jättää pois antamalla mutta jos ostolaskun rivillä on nimike niin tämä ylikirjoittaa arvon tyhjäksi.
Esimerkkituote
4OrderedAmountNumeerinen0...1 Tilattujen tuotteiden määrä  
4DeliveredAmountNumeerinenToimitettujen tuotteiden määrä  
4UnitNameMerkkijono0...1 Mittayksikkö kpl
4UnitPriceNumeerinenYksikköhinta  
4DiscountPercentageNumeerinen0...1 Alennusprosentti  
4VatPercentNumeerinenAlv-prosentti  
attribuuttivatcodeMerkkijono1ALV-tunnus 
4LineSumNumeerinen1Pyöristys kahteen desimaaliin 
attribuuttitypeMerkkijono1Vain gross = "brutto"gross
4DescriptionMerkkijono, max 200 merkkiä0...1Kuvaus  
4Sort 0...1Tuotavan rivijärjestysnumero1
4AccountingSuggestionNumeerinen0...1Tiliöintiehdotus, jos ei annettu, käytetään yrityksen oletus tiliöintitiliä 
4Dimension 0...n  
5DimensionNameMerkkijono1Laskentakohdeotsikko 
5DimensionItemMerkkijono1Laskentakohde 


Ostolaskun asiatarkastus- ja hyväksyntäkierron tuonti

Resurssi: purchaseinvoicecirculation.nv

Resurssilla voidaan asettaa, muokata tai poistaa ostolaskun asiatarkastus- ja hyväksyntäkierto.

Kiertoon asetettavien henkilöiden identifiointi tapahtuu sähköpostiosoitteen perusteella. Jos henkilölle on asetettu sähköpostiosoite omissa perusasetuksissa kohdassa Yrityskohtaiset poikkeukset, käytetään kyseistä sähköpostia. Henkilöiden sähköpostiosoitteiden on oltava uniikkeja yrityksessä.

Kiertoon asetettavalla henkilöllä on oltava riittävät reskontraoikeudet kyseisessä roolissa toimimiseksi. Lisäksi mahdollinen toimittaja- tai summaraja ei saa olla asettamisen esteenä. Rajapintakäyttäjältä vaaditaan kierron asettajan reskontraoikeus.

Rajapintaresurssilla voidaan asettaa useamman ostolaskun kierto samanaikaisesti. Mikäli resurssi palauttaa OK-vastauksen, kaikkien kiertojen asetus on onnistunut. Jos palautetaan virhe, yhtäkään kiertoa ei aseteta. Vastauksessa palautetaan ValidDataIdentifier-elementti jokaiselle laskulle, jolle olisi voitu asettaa kierto ilman virhetilannetta.

Kierron poistaminen tapahtuu jättämällä asiatarkastajat ja hyväksyjä laskulle tuomatta.

Viimeisestä asiatarkastajasta tulee laskun pääasiatarkastaja.

Kiertolistojen asettaminen tai pakotettu asiatarkastuskierto ei ole tuettu. Jos ostolaskulla on jo kierto ja joku kierron henkilöistä on hyväksynyt tai asiatarkastanut laskun, kiertoa ei voi enää muokata rajapinnan kautta.

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

TasoElementtiMuoto ja pituusIlmentymiäKuvausEsimerkki
rootRootAggregaatti1  
1purchaseinvoicecirculationsAggregaatti1

2purchaseinvoicecirculationAggregaatti1...nYhden ostolaskun kierto
3invoiceidentifierAggregaatti1Ostolaskun tunniste, joko ID tai laskunumero
4netvisorkeyNumeerinen0...1Ostolaskun ID123
4
invoicenumber
Merkkijono0...1Laskunumero123
3factualverificatorAggregaatti0...nOstolaskun asiatarkastajat
4emailMerkkijono1Sähköpostiosoiteassi.asiatarkastaja@yritys.com
3approverAggregaatti0...1Ostolaskun hyväksyjä
4emailMerkkijono1Sähköpostiosoitehannu.hyväksyjä@yritys.com
3commentMerkkijono, maks. 2500...1Käsittelyhistorian kommenttiAsiatarkastajat ja hyväksyjä asetettu ulkoisen integraation X toimesta.

 

Ostotilauksen tuonti

Resurssi: purchaseorder.nv

Ostotilauksia voidaan tuoda Netvisoriin purchaseorder.nv rajapintaresurssin kautta. Tilauksen tuontiin vaaditaan tilausnumero, tilauksen päivämäärä ja toimittajan tiedot. Jos tuodaan tuoterivejä, niille vaaditaan tuotekoodi ja määrä, ja kommenttirivi vaatii kommentin.

Huomioitavaa:

  • Muokattaessa tilausta, sanomalla annetaan vain ne tiedot mitä halutaan muokata. Sanomalla ei tarvitse antaa tällöin kaikkia pakollisia tietoja
  • Tilauksen valuutan asettamista ei ole vielä tuettu, currency-attribuutteihin syötetyt arvot jätetään toistaiseksi käsittelemättä
  • Maksuehtoa, toimitusehtoa ja tomitustapaa haetaan annetuilla tiedoilla, jos vastaavaa ei löydetä, luodaan uusi

Kutsussa käytettävät parametrit:

ParametriMuotoIlmentymiäKuvaus
methodMerkkijono1Add Lisää uutena tilauksena
Edit Muokkaa olemassa olevaa tilausta
idKokonaisluku0...1Muokattavan ostotilauksen Netvisor tunnus. Pakollinen jos method edit


Purchaseorderproductline
metodeihin liittyviä huomioita:

MetodiKuvaus
editJos käytetään, ei saa sisältää ostotilausrivin osatoimistustietoja (purchaseorderproductlinepartialdelivery) ja voi sisältää vain sellaiset elementit joita halutaan muokata
deleteJos käytetään, ostotilausrivin (purchaseorderproductline) on oltava tyhjä
partialdeliverKäytetään osatoimitusrivien tuontiin. Jos käytetään, pitää sisältää vähintään kaksi osatoimitusriviä (purchaseorderproductlinepartialdeliverycontent). Osatoimituksen tiedoissa (purchaseorderproductlinepartialdeliverycontent) tilattujen tuotteiden määrän (orderedamount) arvojen pitää vastata kohteena olevan tuoterivin tilattujen tuotteiden määrää (orderedamount:ia)
addtopartialdeliverygroupKäytetään osatoimitusrivin lisäämiseen. Jos käytetään, pitää sisältää vähintään yksi osatoimitusrivi (purchaseorderproductlinepartialdeliverycontent).
Jos muokataan osatoimitettujen tuotteiden virheellistä määrää (orderedamount:ia), pitää lisätä jäljelle jäävä osatoimitusrivi sekä päivittää myös jotain osatoimistusriviä toimitettujen tuotteiden määrän (orderedamount) osalta. Osatoimitettujen tuotteiden määrän (orderedamount:ien) summan tulee vastata alkuperäistä ostotilausrivin tilattujen tuotteiden määrää.
ParametriKuvaus
netvisorkeyPakollinen jos käytetään muita metodeja kuin add

Tuotavan ostotilauksen tiedot lähetetään (POST) kutsun mukana oheisen kuvauksen mukaisena XML:nä:
Huomioitavaa kuvausta luettaessa:
* - Kun luodaan uusi ostotilaus, tieto on pakollinen
** - Kun luodaan uusi tuoterivi, tieto on pakollinen

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
RootrootAggregaatti1  
1purchaseorderAggregaatti1Tilauksen päätiedot 
2ordernumberKokonaisluku0...1*Tilauksen numero141128
2orderstatusMerkkijono0...1*Tilauksen tila
proposal - Hankintaehdotus
approved - Hyväksytty
senttovendor - Lähetetty toimittajalle
archived - Arkistoitu
approved
2orderdatePäivämäärä0...1*Tilauksen päivämäärä2019-01-28
AttribuuttiformatMerkkijono1Päivämäärän muoto, aina ansiansi
2vendoridentifierMerkkijono0...1*Toimittajan tunnistetieto123
AttribuuttitypeMerkkijono1Tunnistetiedon tyyppi
netvisor 
- Toimittajan Netvisor-avain
code
- Toimittajan koodi
organisationidentifier 
- Toimittajan Y-tunnus
netvisor
2purchaseordervendordetailsAggregaatti0...1Toimittajan päätiedot
 
3addresslineMerkkijono1Toimittajan osoite, jos ei annettuPajukuja 5
3postnumberMerkkijono1Toimittajan postinumero53921
3cityMerkkijono1Toimittajan postitoimipaikkaLappeenranta
3countryMerkkijono1Toimittajan maakoodiFI
AttribuuttitypeMerkkijono1Maakoodin tyyppi, aina ISO-3166ISO-3166
2deliverytermMerkkijono0...1ToimitusehtoVapaasti toimittajalla
2deliverymethodMerkkijono0...1ToimitustapaNoudetaan
2purchaseorderdeliverydetailsAggregaatti0...1Toimituksen vastaanottajan päätiedot
 
3deliverynameMerkkijono0...1Toimituksen vastaanottajan nimiYritys Oy
3deliveryaddressMerkkijono0...1Toimituksen vastaanottajan osoiteKoulukatu 51
3deliverypostnumberMerkkijono0...1Toimituksen vastaanottajan postinumero53945
3deliverycityMerkkijono0...1Toimituksen vastaanottajan postitoimipaikkaLappeenranta
3deliverycountryMerkkijono0...1Toimituksen vastaanottajan maakoodiFI
AttribuuttitypeMerkkijono1Maakoodin tyyppi, aina ISO-3166ISO-3166
2privatecommentMerkkijono0...1Sisäinen vapaa kommenttiteksti, ei näy tulosteella 
2commentMerkkijono0...1Vapaa komenttiteksti, näkyy tulosteella 
2ourreferenceMerkkijono0...1Meidän viitteemme1411281
2currencycodeMerkkijono0...1Tilauksessa käytettävän valuutan lyhenne
USD
AttribuuttitypeMerkkijono1Valuutan lyhenteen tyyppi aina ISO-4217 muodossa
ISO-4217
2purchaseorderpaymenttermAggregaatti0...1Maksuehdon päätiedot 
3netdaysKokonaisluku1Maksuehdon nettopäivät14
3discountdaysKokonaisluku1Maksuehdon kassa-alennuspäivät10
3discountpercentDesimaaliluku1Maksuehdon alennusprosentti7,5
2purchaseorderlinesAggregaatti0...1*Tilauksen tuoterivit 
3purchaseorderproductlineAggregaatti0...nTilauksen tuoterivi 
AttribuuttimethodMerkkijono0...1Tuoterivin metodi
add - Lisää uusi tuoterivi (oletus arvo)
edit - Editoi tuoteriviä
delete - Poista tuoterivi
partialdeliver - Osatoimitus tuoteriville
addtopartialdeliverygroup - Lisää uusi rivi osatoimitusryhmään
add
(lue metodin lisätiedot alusta)
AttribuuttinetvisorkeyKokonaisluku0...1*Tuoterivin ID
 
4purchaseorderproductlinepartialdeliveryAggregaatti0...1Osatoimituksen tiedot
 
5purchaseorderproductlinepartialdeliverycontentAggregaatti1...nOsatoimituksen tieto
 
6orderedamountDesimaaliluku1Tilattujen tuotteiden määrä10,00
6deliveredamountDesimaaliluku1Toimitettujen tuotteiden määrä
5,00
6deliveryreceiveddateDate1Tuotteiden toimitus päivämäärä
2019-01-28
AttribuuttiformatMerkkijono1Päivämäärän muoto, aina ansiansi
6deliverymanuallyconfirmedMerkkijono0...1Toimitus käsin vahvistettu, vaikka toimitettu poikkeava määrätrue
tai
false
6deliveredproductqualityKokonaisluku0...1Toimitetun tuotteen laatu 
AttribuuttitypeMerkkijono1Laadun määritelmänetvisor
4productcodeMerkkijono0...1**Tuotteen tunnistetieto, jos type-attribuuttia ei anneta, riviä ei linkitetä tuotteeseen1017
AttribuuttitypeMerkkijono0...1Tunnisteen tyyppi
netvisor - Netvisor tunnus, täytyy löytyä Netvisorista
customer - Tuotekoodi, täytyy löytyä Netvisorista
customer
4vendorproductcodeMerkkijono0...1Toimittajan koodi tuotteelleA100Ah
4orderedamountDesimaaliluku0...1**Tilattujen tuotteiden määrä10,00
4unitpriceDesimaaliluku0...1Tuotteen veroton yksikköhinta valuutassa52,50
4vatpercentDesimaaliluku0...1**Tuotteen ALV-prosentti24
4freightrateDesimaaliluku0...1Toimituskustannukset22,50
4linecommentMerkkijono0...1Kommentti (max. 255 merkkiä) 
4deliverydatePäivämäärä0...1**Rivin tuotteiden toimituspäivämäärä2019-01-28
AttribuuttiformatMerkkijono1Päivämäärän muoto, aina ansiansi
4purchaseorderproductlinedeliverydetailsAggregaatti0...1Tuotteen toimitus tiedot 
5deliveredamountDesimaaliluku1Vastaanotetun/toimitetun tuotteen määrä5,0
5deliveryreceiveddateDate1Vastaanotto/toimitus päivämäärä 
AttribuuttiformatMerkkijono1Päivämäärän muoto, aina ansiansi
5deliverymanuallyconfirmedMerkkijono0...1Toimitus käsin vahvistettu, vaikka toimitettu poikkeava määrä"true"
tai
"false"
5deliveredproductqualityKokonaisluku0...1Toimitetun tuotteen laatu 
4inventoryplaceMerkkijono0...1Käytettävän varaston tunnus12
AttribuuttitypeMerkkijono1Varaston tunnuksen tyyppi
netvisor - Varaston Netvisor-tunnus,täytyy löytyä Netvisorista
customer - Varastopaikan nimi, täytyy löytyä Netvisorista
netvisor
4accountingaccountsuggestionKokonaisluku0...1Tiliöintiehdotustilin numero, täytyy löytyä Netvisorista4000
4purchaseorderproductlinedimensionsAggregaatti0...1Tuoterivien laskentakohteet 
5dimensionAggregaatti0...nTuoterivin laskentakohde 
6dimensionnameMerkkijono1LaskentakohdeotsikkoHankinta
6dimensionitemMerkkijono1LaskentakohdeTarvikkeet
3purchaseordercommentline 0...Tilauksen kommenttirivit 
AttribuuttimethodMerkkijono0...1Kommenttirivin metodi
add - Lisää uusi rivi (oletusarvo)
edit - Muokkaa olemassa olevaa
delete - Poista rivi
 
AttribuuttinetvisorkeyKokonaisluku0...1Kommenttirivin ID
Pakollinen,
jos metodi
edit
tai
delete
4commentMerkkijono0...1Komenttirivin tekstiAkkutilaus

Huomaathan:

ElementtiMetodiKuvaus
purchaseordercommentlinedeleteJos käytetään tätä metodia, elementin "purchaseordercommentline" sisältö(kommentti) on oltava tyhjä

 

Ostotilauslistan nouto

Resurssi: purchaseorderlist.nv

Kutsussa käytettävät paremetrit:

ParametriIlmentymiäKuvausEsimerkki
limitstartordernumber0...1Tilaukset alkaen numerosta1000
limitendordernumber0...1Tilaukset numeroon asti1100
limitbegindate0...1Tilaukset alkaen päivämäärästä2018-01-01
limitenddate0...1Tilaukset päivämäärään asti2018-06-30
limitorderstatus0...1Tilauksen tila
proposal = Hankintaehdotus
approvedHyväksytty
senttovendor = Lähetetty toimittajalle
archived = Arkistoitu
approved
searchcomment0...1Rajaus kommentilla tai sisäisellä kommentillavarastosta
limitvendor0...1Tunnistetiedon tyyppi
kokonaisluku = Käsitellään Netvisor tunnisteena
y-tunnus = Käsitellään y-tunnuksena
muu merkkijono = Käsitellään toimittajakoodina
123456
lastmodifiedstart0...1Hakee ostotilaukset, joita on muutettu annetun päivämäärän jälkeen. Tulee antaa muodossa yyyy-MM-ddTHH:mm:ss2019-05-15T12:00:00
lastmodifiedend0...1Hakee ostotilaukset, joita on muutettu ennen annettua päivämäärää. Tulee antaa muodossa yyyy-MM-ddTHH:mm:ss2019-05-15T12:00:00

Vastaus:

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
rootRootAggregaatti1  
1PurchaseOrderListAggregaatti1  
2PurchaseOrderAggregaatti1  
3NetvisorKeyNumeerinen1Ostotilauksen Netivosr key123
3OrderNumberNumeerinen1Ostotilauksen tilausnumero11228
3OrderDatePäivämäärä1Ostotilauksen päivämäärä2018-06-01
AttribuuttiformatMerkkijonoPäivämäärän muoto, aina ansiansi
3OrderStatusMerkkijono1Ostotilauksen tilaapproved
3VendorNameMerkkijono1ToimittajaNetvisor Oy
3AmountNumeerinen1Loppusumma1000
3UriMerkkijono1Netvisor URI tilaukseen/getpurchaseorder.nv?netvisorkey=123

 

Ostotilauksen nouto

Resurssi: getpurchaseorder.nv

Noutaa halutun ostotilauksen yksityiskohtaiset tiedot.

Kyselyssä käytettävät parametrit:

ParametriIlmentymiäKuvausEsimerkki
netvisorkey1Noudettavan tilauksen Netvisor tunnus123
NetvisorKeyList0...1Palauttaa yhdessä pyynnössä täydet tiedot kaikista halutuista ostotilauksista, max. 500 ID:tä1,2,3

Vastaus:

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
RootrootAgregaatti1  
1purchaseorderAgregaatti1  
2netvisorkeyNumeerinen1Ostotilauksen Netvisor key
1
2ordernumberNumeerinen1Ostotilauksen numero
1
2orderstatusMerkkijono1Ostotilauksen tilaproposal
approved
senttovendor
archived
2orderdateMerkkijono1Ostotilauksen päivämäärä
2017-1-1
2vendornameMerkkijono1Ostotilauksen toimittajaOy Firma Ab
2vendoraddresslineMerkkijono0...1Osotilauksen toimittajan osoite
Firmatie 1
2
vendorpostnumberNumeerinen0...1Osotilauksen toimittajan postinumero
00100
2vendorcityMerkkijono0...1Ostotilauksen toimittajan toimipaikka
Helsinki
2vendorcountryMerkkijono1Ostotilauksen toimittajan maa
Finland
AttribuuttitypeMerkkijono1Maakoodin tyyppi, aina ISO-3166ISO-3166
2deliverytermMerkkijono0...1ToimitusehtoSopimuksen mukaan
2deliverymethodMerkkijono0...1ToimitustapaNoudetaan
2deliverynameMerkkijono0...1ToimitusnimiYritys Oy
2deliveryaddresslineMerkkijono0...1ToimitusosoiteYritystie 1
2deliverypostnumberNumeerinen0...1Toimitus postinumero00500
2deliverycityMerkkijono0...1Toimitus toimipaikkaHelsinki
2deliverycountryMerkkijono1Toimitusmaa
Finland
AttribuuttitypeMerkkijono1Maakoodin tyyppi, aina ISO-3166ISO-3166
2privatecomment
Merkkijono0...1Sisäinen kommentti, ei näy tulosteella, maks. 1000 merkkiä
Sisäinen kommentti
2commentMerkkijono0...1Kommentti, maks. 1000 merkkiä
Kommentti
2ourreferenceMerkkijono0...1Viitteemme, maks. 50 merkkiä
Viitteemme viesti
2paymenttermMerkkijono0...1Maksuehto14 päivää netto
2amountNumeerinen1Loppusumma10000
AttribuutticurrencycodeMerkkijono1Loppusumman valuuttaEUR
Attribuutti typeMerkkijono1Valuuttakoodin tyyppi, aina ISO-4217
ISO-4217
2purchaseorderlinesAgregaatti1  
3purchaseorderproductlineAgregaatti1  
4netvisorkeyNumeerinen1Ostotilausrivin Netvisor key
1
4productcodeMerkkijono0...1TuotekoodiTuotekoodi-123
4productname
Merkkijono0...1Tuotenimike, jos tuote lisätty Netvisor tuoterekisteristä, muussa tapauksessa Toimittajanimike
Tuote
4vendorproductcodeMerkkijono0...1ToimittajakoodiToimittajakoodi-123
4orderedamountNumeerinen1Tilattu määrä10
4deliveredamountNumeerinen1Toimitettu määrä
0
4unitpriceNumeerinen1Yksikköhinta100
4vatpercentNumeerinen1ALV %
24
4linesumNumeerinen1Yhteensä100
4freightrateNumeerinen0...1Rahti0
4deliverydatePäivämäärä1Oletettu toimituspäivä2017-01-01
AttribuuttiformatMerkkijono1Päivämäärän muotoansi
4inventoryplaceMerkkijono0...1VarastoTestivarasto
3linkedpurchaseinvoicesAgregaatti0...1Ostotilaukseen linkitettyjen laskujen tiedot 
4purchaseinvoiceAgregaatti1..n  
5invoicenumberNumeerinen1Laskunnumero1001
5netvisorkeyNumeerinen1Laskun Netvisor key
10
5uriMerkkijono1Netvisor URI laskuun
/getpurchaseinvoice.nv?netvisorkey=1001

 

Toimittajan tuonti

Resurssi: vendor.nv

Voidaan tuoda uusi toimittaja ja muokata olemassa olevaa toimittajaa.

Toimittajan tuonnin yhteydessä rajapinta palauttaa vastaussanomalla toimittajan NetvisorKey:n. Suosittelemme ottamaan tämän talteen, mikäli toimittajatietoja on tarpeen muokata tai noutaa myöhemmin. NetvisorKey:tä ei toistaiseksi saa noudettua rajapinnan yli toimittajalistauksen avulla. Netvisorin käyttöliittymässä toimittajan NetvisorKey:n saa tietoon avaamalla toimittajakortin ja katsomalla sen osoiteriviltä kohdasta 'id' (esim. id=123).

Sanomalla voidaan tuoda tieto toimittajan pankkitileistä. Pankkitilit on jaettu kotimaisiin ja ulkomaisiin pankkitilieihin. Pankkitileillä on erilaiset sisällöt:

  • Jos pankkitilin kehyksessä ei ole omaa NetvisorKey arvoa, lisätään toimittajalle uusi pankkitili. Mikäli NetvisorKey löytyy muokataan kyseistä pankkitiliä.
  • Pankkitilin IsDefault kentällä voidaan asettaa tili oletustiliksi. Jos annettu useampi True arvo, asetetaan järjestyksessä viimeinen tili oletustiliksi.

Kutsussa käytettävät parametrit:

ParametriMuotoIlmentymiäKuvaus
methodMerkkijono1

Add Lisää uusi toimittaja
Edit Muokkaa olemassa olevaa toimittajaa

netvisorkeyNumeerinen0...1

Toimittajan NetvisorKey
Pakollinen jos method = edit

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

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
RootrootAgregaatti1  
1vendorAgregaatti1  
2vendorbaseinformationAgregaatti1  
3codeMerkkijono0...1Toimittajakoodi123
3nameMerkkijono1Toimittajan nimiTestitoimittaja
3addressMerkkijono0...1OsoiteToimittajakatu 1
3postcodeMerkkijono0...1Postikoodi00100
3cityMerkkijono0...1KaupunkiHelsinki
3countryMerkkijono0...1MaakoodiFI
AttribuuttitypeMerkkijono1Maakoodin tyyppi
ISO-3166
3organizationidMerkkijono0...1Y-tunnus123456-7
3groupnameMerkkijono0...1ToimittajaryhmäThe toimittajat
3vendorbankaccountsAgregaatti0...1Toimittajan pankkitilit
 
4vendordomesticbankaccounts Agregaatti0...1  
5vendordomesticbankaccountAgregaatti0...8Suomalaiset pankkitilit
 
6netvisorkeyNumeerinen0...1Pankkitilin NetvisorKey
1
6ibanMerkkijono1Tilinumero IBAN muodossa
FI7536359370000661
6banknameMerkkijono1Pankin nimi
Testipankki
6isdefaultMerkkijono0...1Käytetäänkö oletuksenaTrue
4vendorforeignbankaccounts Agregaatti0...1  
5vendorforeignbankaccountAgregaatti0...8Ulkomaalaiset pankkitilit
 
6netvisorkeyNumeerinen0...1Pankkitilin NetvisorKey2
 ibanMerkkijono1Tilinumero IBAN muodossaGB29NWBK60161331926819
6bicswiftMerkkijono1BIC numero
BUKBGB22
6banknameMerkkijono1Pankin nimiBarclays
6clearingcodeMerkkijono0...1Clearing koodi
 
6clearingnumberMerkkijono0...1Clearing numero
 
6bankaddresssMerkkijono0...1Pankin osoite
Bank Street 1
6countryMerkkijono1MaakoodiGB
AttribuuttitypeMerkkijono

1

Maakoodin tyyppi ISO-3166
6currencycodeMerkkijono1ValuuttakoodiGBP
AttribuuttitypeMerkkijono1Valuuttakoodin tyyppiISO-4217
6isdefaultMerkkijono0...1Käytetäänkö oletuksenaFalse
6includeaddresssinforeignpaymentsMerkkijono0...1Vie pankin osoitetiedot maksusanomalle BIC-koodin lisäksiTrue
2vendorcontactdetailsAgregaatti0...1Toimittajan yhteystiedot 
3phonenumberMerkkijono0...1Puhelinnumero+35850123456
3emailMerkkijono0...1Sähköpostitoimittaja@toimittajat.fi
3faxnumberMerkkijono0...1Faksi 
3contactpersonnameMerkkijono0...1Yhteyshenkilön nimi
Timo Testaaja
3contactpersonphonenumberMerkkijono0...1Yhteyshenkilön puhelinnumero
+35840987654
3contactpersonemailMerkkijono0...1Yhteyshenkilön timo.testaaja@toimittajat.fi
3homepageMerkkijono0...1Kotisivut 
3commentMerkkijono0...1KommenttiNo comments
2vendoradditionalinformationAgregaatti0...1  
3defaultvatpercentNumeerinen0...1Oletus ALV-kanta24
3ispartialvatreduceprivilegedMerkkijono0...1Vain osittainen ALV-vähennysoikeuFalse
3paymenttermdiscountpercentNumeerinen0...1Alennus prosentti
 
3paymenttermcashdiscountdaysNumeerinen0...1Alennus päivät
 
3paymenttermnetdaysNumeerinen0...1Oletusmaksuehto 
3currencycodeValuuttakoodi0...1OletusvaluuttaEUR
Attribuutti  typeMerkkijono 1Valuuttakoodin tyyppi ISO-4217
3vendordimensionsAgregaatti0...1Oletuslaskentakohteet 
4dimensionMerkkijono 1Laskentakohteen nimiKohde
3vendoraccountingaccountsAgregaatti0...1Toimittajan kirjanpidon tilit 
4vendoraccountingaccountAgregaatti1...n  
5accountnumberMerkkijono 1Kirjanpidon tili4000
5isdefaultMerkkijono 1Käytetäänkö oletuksenaTrue
3vendoracceptancedetailsAgregaatti0...1Asiatarkastajat 
4vendoracceptancedetailAgregaatti1...n  
5acceptancenameMerkkijono 0...1Asiatarkastajan nimiTaaki Tarkastaja
5isdefaultMerkkijono 0...1Käytetäänkö oletuksenaFalse
5isforcedMerkkijono 0...1  

 

Toimittajan tietojen nouto

Resurssi: getvendor.nv

Palauttaa toimittajan tiedot. Noudetaan toimittajan NetvisorKey:n perusteella. Toimittajien NetvisorKey:itä ei toistaiseksi saa noudettua rajapinnan yli toimittajalistauksen avulla, vaan toimittajan NetvisorKey tulisi ottaa talteen toimittajan tuonnin yhteydessä. 

Netvisorin käyttöliittymässä toimittajan NetvisorKey:n saa tietoon avaamalla toimittajakortin ja katsomalla sen osoiteriviltä kohdasta 'id' (esim. id=123).

Kutsussa käytettävät parametrit:

ParametriMuotoIlmentymiäKuvaus
netvisorkeyNumeerinen1

Toimittajan NetvisorKey

Vastaus:

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
RootrootAgregaatti1  
1vendorAgregaatti1  
2vendorbaseinformationAgregaatti1  
3codeMerkkijono0...1Toimittajakoodi123
3nameMerkkijono1Toimittajan nimiTestitoimittaja
3addressMerkkijono0...1OsoiteToimittajakatu 1
3postcodeMerkkijono0...1Postikoodi00100
3cityMerkkijono0...1KaupunkiHelsinki
3countryMerkkijono0...1MaakoodiFI
AttribuuttitypeMerkkijono1Maakoodin tyyppi
ISO-3166
3organizationidMerkkijono0...1Y-tunnus123456-7
3groupnameMerkkijono0...1ToimittajaryhmäThe toimittajat
3vendorbankaccountsAgregaatti0...1Toimittajan pankkitilit
 
4vendordomesticbankaccounts Agregaatti0...1  
5vendordomesticbankaccountAgregaatti0...8Suomalaiset pankkitilit
 
6netvisorkeyNumeerinen0...1Pankkitilin NetvisorKey
1
6ibanMerkkijono1Tilinumero IBAN muodossa
FI7536359370000661
6banknameMerkkijono1Pankin nimi
Testipankki
6isdefaultMerkkijono0...1Käytetäänkö oletuksenaTrue
4vendorforeignbankaccounts Agregaatti0...1  
5vendorforeignbankaccountAgregaatti0...8Ulkomaalaiset pankkitilit
 
6netvisorkeyNumeerinen0...1Pankkitilin NetvisorKey2
 ibanMerkkijono1Tilinumero IBAN muodossaGB29NWBK60161331926819
6bicswiftMerkkijono1BIC numero
BUKBGB22
6banknameMerkkijono1Pankin nimiBarclays
6clearingcodeMerkkijono0...1Clearing koodi
 
6clearingnumberMerkkijono0...1Clearing numero
 
6bankaddresssMerkkijono0...1Pankin osoite
Bank Street 1
6countryMerkkijono1MaakoodiGB
AttribuuttitypeMerkkijono

1

Maakoodin tyyppi ISO-3166
6currencycodeMerkkijono1ValuuttakoodiGBP
AttribuuttitypeMerkkijono1Valuuttakoodin tyyppiISO-4217
6isdefaultMerkkijono0...1Käytetäänkö oletuksenaFalse
6includeaddresssinforeignpaymentsMerkkijono0...1Vie pankin osoitetiedot maksusanomalle BIC-koodin lisäksiTrue
2vendorcontactdetailsAgregaatti0...1Toimittajan yhteystiedot 
3phonenumberMerkkijono0...1Puhelinnumero+35850123456
3emailMerkkijono0...1Sähköpostitoimittaja@toimittajat.fi
3faxnumberMerkkijono0...1Faksi 
3contactpersonnameMerkkijono0...1Yhteyshenkilön nimi
Timo Testaaja
3contactpersonphonenumberMerkkijono0...1Yhteyshenkilön puhelinnumero
+35840987654
3contactpersonemailMerkkijono0...1Yhteyshenkilön timo.testaaja@toimittajat.fi
3homepageMerkkijono0...1Kotisivut 
3commentMerkkijono0...1KommenttiNo comments
2vendoradditionalinformationAgregaatti0...1  
3defaultvatpercentNumeerinen0...1Oletus ALV-kanta24
3ispartialvatreducedprivilegedMerkkijono0...1Vain osittainen ALV-vähennysoikeuFalse
3paymenttermdiscountpercentNumeerinen0...1Alennus prosentti
 
3paymenttermcashdiscountsdaysNumeerinen0...1Alennus päivät
 
3paymentermnetdaysNumeerinen0...1Oletusmaksuehto 
3currencycodeValuuttakoodi0...1OletusvaluuttaEUR
Attribuutti  typeMerkkijono 1Valuuttakoodin tyyppi ISO-4217
3vendordimensionsAgregaatti0...1Oletuslaskentakohteet 
4dimensionMerkkijono 1Laskentakohteen nimiKohde
3vendoraccountingaccountsAgregaatti0...1Toimittajan kirjanpidon tilit 
4vendoraccountingaccountAgregaatti1...n  
5accountnumberMerkkijono 1Kirjanpidon tili4000
5accountnameMerkkijono1Tilin nimiOstot
5isdefaultMerkkijono 1Käytetäänkö oletuksenaTrue
3vendoracceptancedetailsAgregaatti0...1Asiatarkastajat 
4vendoracceptancedetailAgregaatti1...n  
5acceptancenameMerkkijono 0...1Asiatarkastajan nimiTaaki Tarkastaja
5isdefaultMerkkijono 0...1Käytetäänkö oletuksenaFalse
5isforcedMerkkijono 0...1  

Laatuluokkien tuonti

Resurssi: productquality.nv

Laatuluokkien lisääminen Netvisoriin

Laatujen resurssit toimivat VAIN kun laatukäsittely on kytketty päälle Netvisorissa. Pätee myös ostotilauksen tuonti resurssin kanssa, jossa voidaan kahdessa paikassa määritellä laatu.

Kutsussa käytettävät parametrit:

ParametriIlmentymiäKuvausEsimerkki
method1Add - laatuluokan lisäys
add

Tuotavien laatuluokkien tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena xml:nä (POST-data):

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
RootrootAgregaatti1  
1productqualityAgregaatti1  
2isqualitydeviationMerkkijono1Käsitellään laatuluokka laatupoikkeamana
True
tai
False
2nameMerkkijono1Nimi Suomi/Oletus
Hyvä laatu
2name_enMerkkijono0...1Nimi Englanti
Good quality
2name_seMerkkijono0...1Nimi Ruotsi
God kvalitet

 

Laatuluokkien nouto

Resurssi: getproductqualitylist.nv

Noutaa Netvisoriin määritetyt laatuluokat

Listaa kaikki luokat, ei mahdollisuutta kohdistaa netvisorkey tai netvisorkeylist:n avulla.

Laatujen resurssit toimivat VAIN kun laatukäsittely on kytketty päälle Netvisorissa. Tämä pätee myös ostotilauksen tuonti resurssin kanssa, siinä voidaan kahdessa paikassa määritellä laatu.

Vastaus:

TasoElementtiMuotoIlmentymiäKuvausEsimerkki
RootrootAgregaatti1  
1ProductQualitiesAgregaatti1  
2ProductQualityAgregaatti1  
3NameMerkkijono1Laatuluokan nimi
Hyvää tuotetta
3NetvisorKeyNumeerinen1Laatuluokan netvisorkey
1
3IsQualityDeviationMerkkijono1Käsitelläänkö laatupoikkeamanaFalse

 

 


xml
xml
xml
xml
xml
(232 Bytes)
xml
xml
xml
xml
xsd
(987 Bytes)
xsd
xml
(506 Bytes)
xsd
xsd

Oliko tästä vastauksesta apua? Kyllä Ei

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.