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:
| Integraatio | Suunta | Resurssi | DTD | Skeema | Esimerkki |
| Ostolaskulistan nouto | GET | purchaseinvoicelist.nv | Lataa | ||
| Ostolaskun nouto | GET | getpurchaseinvoice.nv | |||
| Ostolaskun liitteiden nouto | GET | getattachments.nv | |||
| Ostolaskun tuonti | POST | purchaseinvoice.nv | purchaseinvoice.dtd | ||
| Ostolaskun hyväksynnän tilan päivittäminen ja tiliöinti | POST | purchaseinvoicepostingdata.nv | purchaseinvoice postingdata.dtd | Lataa | |
| Ostolaskun asiatarkastus- ja hyväksyntäkierron tuonti | POST | purchaseinvoicecirculation.nv | purchaseinvoicecirculation.xsd | Lataa | |
| Ostotilauksen tuonti | POST | purchaseorder.nv | purchaseorder.dtd | purchaseorder.xsd | Lataa |
| Ostotilauslistan nouto | GET | purchaseorderlist.nv | Lataa | ||
| Ostotilauksen nouto | GET | getpurchaseorder.nv | Lataa | ||
| Toimittajan tuonti | POST | vendor.nv | |||
| Toimittajan nouto | GET | getvendor.nv | |||
| Laatuluokkien tuonti | POST | productquality.nv | productquality.xsd | Lataa | |
| Laatuluokkien nouto | GET | getproductqualitylist.nv | Lataa |
| Kuvaus | Skeema |
| Netvisor skeema tyypitykset | netvisorgeneraltypes.xsd |
Ostolaskulistan nouto
Resurssi: purchaseinvoicelist.nv
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| begininvoicedate | 0...1 | Ostolaskut alkaen päivämäärästä | 2019-05-20 |
| endinvoicedate | 0...1 | Ostolaskut päivämäärään asti | 2019-05-30 |
| invoicenumber | 0...1 | Ostolaskun numerorajaus | 1001 |
| invoicestatus | 0...1 | Ostolaskun statusrajaus - Open, Approved = hyväksynnässä - Accepted = hyväksytty | Open |
| lastmodifiedstart | 0...1 | Hakee ostolaskut, joita on muutettu annetun päivämäärän jälkeen. Tulee antaa muodossa yyyy-MM-ddTHH:mm:ss | 2019-05-15T12:00:00 |
| lastmodifiedend | 0...1 | Hakee ostolaskut, joita on muutettu ennen annettua päivämäärää. Tulee antaa muodossa yyyy-MM-ddTHH:mm:ss | 2019-05-15T18:30:00 |
| purchaseinvoicebatchid | 0...1 | Rajaa ostolaskuerässä tuodut ostolaskut annetun erä ID:n mukaisesti. Katso ostolaskuerän käsittelyn kuvaus. | 123 |
Vastaus
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| root | Root | Aggregaatti | 1 | ||
| 1 | PurchaseInvoiceList | Aggregaatti | 1 | ||
| 2 | PurchaseInvoice | Aggregaatti | 0...n | ||
| 3 | NetvisorKey | Numeerinen | 1 | Laskun tunniste Netvisorissa | 123 |
| 3 | InvoiceNumber | Merkkijono | 1 | Laskun numero | 345 |
| 3 | InvoiceDate | Päivämäärä | 1 | Laskun päivämäärä | 2013-10-23 |
| Attribuutti | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 3 | Vendor | Merkkijono | 1 | Toimittajan nimi | Vendor Oy Ab |
| 3 | VendorOrganizationIdentifier | Numeerinen | 1 | Toimittajan y-tunnus | 1234567-8 |
| 3 | Sum | Numeerinen | 1 | Laskun kokonaissumma | 100,00 |
| 3 | Payments | Numeerinen | 1 | Laskun maksettu summa | 30,50 |
| 3 | OpenSum | Numeerinen | 1 | Laskun avoin summa | 69,50 |
| 3 | Uri | Merkkijono | 1 | URI 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:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| netvisorkey | 1 | Laskun tunniste Netvisorissa | 123 |
| netvisorkeylist | 0...1 | Palauttaa yhdessä pyynnössä täydet tiedot ostolaskuista, max. 500 ID:tä. | 1,2,3 |
| version | 0...1 | Palauttaa yksittäisen laskurivin (PurchaseInvoiceLine) laskentakohteet laskurivin elementin sisään | 2 |
| include | 0...1 | - actions = Palautetaan mitä ostolaskulle voi tehdä (asiatarkastaa, hyväksyä, hylätä, maksuvalmis) | actions |
| omitattachments | 0...1 | True = Ei palauteta ostolaskun liitteitä | true |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| root | Root | Aggregaatti | 1 | ||
| 1 | PurchaseInvoice | Aggregaatti | 1 | ||
| 2 | PurchaseInvoiceNumber | Merkkijono | 1 | Laskun numero | 345 |
| 2 | PurchaseInvoiceDate | Päivämäärä | 1 | Laskun päiväys | 2014-10-02 |
| Attribuutti | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 2 | PurchaseInvoiceDeliveryDate | Päivämäärä | 1 | Laskun toimituspäivä | 2014-10-04 |
| Attribuutti | format | Merkkijono | 1 | Toimituspäivän muoto, aina ansi | ansi |
| 2 | PurchaseInvoiceDueDate | Päivämäärä | 1 | Laskun eräpäivä | 2014-10-31 |
| Attribuutti | format | Merkkijono | 1 | Eräpäivän muoto, aina ansi | ansi |
| 2 | PurchaseInvoiceValueDate | Päivämäärä | 1 | Laskun arvopäivä | 2014-10-15 |
| Attribuutti | format | Merkkijono | 1 | Arvopäivän muoto, aina ansi | ansi |
| 2 | PurchaseInvoiceReferencenumber | Merkkijono | 1 | Laskun viitenumero | 12594 |
| 2 | PurchaseInvoiceAmount | Numeerinen | 1 | Laskun summa kahdella desimaalilla | 123,45 |
| 2 | PurchaseInvoicePaidAmount | Numeerinen | 1 | Laskusta maksettu summa kahdella desimaalilla | 100,00 |
| 2 | ForeignCurrencyAmount | Numeerinen | 1 | Laskun valuuttasumma | 123,45 |
| 2 | ForeignCurrencyNameID | Merkkijono | 1 | Valuuttakoodi | EUR |
| 2 | InvoiceStatus | Merkkijono | 1 | Laskun tila Huom: palauttaa tällä hetkellä aina avoin/open, keskeneräinen toiminnallisuus | avoin/open |
| 2 | ApprovalStatus | Merkkijono | 1 | Laskun hyväksynnän tila: | open |
| 2 | PurchaseInvoiceOurReference | Merkkijono | 1 | Viitteemme | 012594 |
| 2 | PurchaseInvoiceYourReference | Merkkijono | 1 | Viitteenne | 112594 |
| 2 | PurchaseInvoiceDescription | Merkkijono | 1 | Laskun lisätieto | |
| 2 | VendorName | Merkkijono | 1 | Toimittajan nimi | Vendor Oy Ab |
| 2 | VendorAddressLine | Merkkijono | 1 | Toimittajan osoite | |
| 2 | VendorPostNumber | Merkkijono | 1 | Toimittajan postiosoite | |
| 2 | VendorTown | Merkkijono | 1 | Toimittajan postitoimipaikka | |
| 2 | VendorCountry | Merkkijono | 1 | Toimittajan maakoodi | |
| 2 | VoucherID | Numeerinen | 0...1 | Ostolaskun tositteen NetvisorKey | 1123 |
| 2 | IsAccounted | Merkkijono | 1 | Onko ostolasku tiliöity | True |
| 2 | PreviewImage | Merkkijono | 0...n | Kun käytössä parametri action - previewimage | |
| 2 | Attachments | Aggregaatti | 0...1 | ||
| 3 | Attachment | Aggregaatti | 1...n | ||
| 4 | AttachmentBase64Data | Merkkijono | 1 | Liitteen Base64 enkoodattu data | |
| 4 | FileName | Merkkijono | 1 | Liitteen tiedostonimi | Lasku12594.pdf |
| 4 | ContentType | Merkkijono | 1 | Liitteen MIME-tyyppi | Application/pdf |
| 4 | Comment | Merkkijono | 1 | Kommentti liitteelle | |
| 2 | InvoiceLines | Aggregaatti | 0...1 | ||
| 3 | PurchaseInvoiceLine | Aggregaatti | 1...n | ||
| 4 | NetvisorKey | Numeerinen | 1 | Tuotteen Netvisor avain | |
| 4 | LineSum | Numeerinen | 1 | Rivisumma verollinen | |
| 4 | LineNetSum | Numeerinen | 1 | Rivisumma veroton | |
| 4 | UnitPrice | Numeerinen | 1 | Yksikköhinta (verollinen) | |
| 4 | VatPercent | Numeerinen | 1 | Alv-prosentti | |
| 4 | VatCode | Merkkijono | 1 | Alv-koodi | |
| 4 | Description | Merkkijono | 0...1 | Riviselite | |
| 4 | Unit | Merkkijono | 0...1 | Mittayksikkö | |
| 4 | OrderedAmount | Numeerinen | 1 | Tilattujen tuotteiden määrä | |
| 4 | PurchasePrice | Numeerinen | 0...1 | Ostohinta | |
| 4 | DeliveredAmount | Numeerinen | 1 | Toimitettujen tuotteiden määrä | |
| 4 | ProductCode | Merkkijono | 1 | Tuotekoodi | |
| 4 | DiscountPercentage | Numeerinen | 1 | Alennusprosentti | |
| 4 | ProductName | Merkkijono | 1 | Nimike | |
| 4 | AccountingSuggestionBookkeeping | Merkkijono | 0...1 | Tiliöntiehdotuksen tilin Netvisorkey | |
| 4 | AccountingSuggestionBookkeepingAccount | Merkkijono | 0...1 | Tiliöntiehdotuksen tili | |
| 4 | PurchaseInvoiceDimensions | Aggregaatti | 0...1 | Tasot 4 -5 -6 kun version parametri on 2 Muussa tapauksessa tasot 3-4-5 | |
| 5 | Dimension | Aggregaatti | 1...n | ||
| 6 | DimensionName | Merkkijono | 1 | Laskentakohdeotsikko | |
| 6 | DimensionDetailName | Merkkijono | 1 | Laskentakohde | |
| 2 | LinkedPurchaseOrders | Aggregaatti | 0...1 | Jos ostolaskulle on liitetty ostotilauksia, niiden numerot ja ID:t palautetaan | |
| 3 | PurchaseOrder | Aggregaatti | 1...n | ||
| 4 | OrderNumber | Merkkijono | 1 | Ostotilauksen numero | 123 |
| 4 | NetvisorKey | Merkkijono | 0...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:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| 2 | PostingLinesAccess | Aggregaatti | 1 | Ostolaskun tiliöinti | |
| 3 | CanEditPostingLines | Merkkijono | 1 | True | |
| 3 | CanUserPostInvoice | Merkkijono | 1 | False | |
| 3 | SuggestPostingByDefault | Merkkijono | 1 | True | |
| 3 | CanEditAccountingSuggestion | Merkkijono | 1 | False | |
| 2 | Actions | Aggregaatti | 1 | Mitä laskulle käyttäjän oikeuksilla voi tehdä | |
| 3 | Action | Aggregaatti | 1...n | ||
| 4 | Id | Merkkijono | 1 | Mahdolliset arvot: approved accepted reject pay | accepted |
| 4 | Type | Merkkijono | 1 | Annetaa käytettävä resurssi jolla action voidaan suorittaa | purchaseinvoicepostingdata |
| 4 | Description | Merkkijono | 1 | Toiminteen selite | Hyväksy lasku |
| 2 | Alerts | Aggregaatti | 1 | Jos hälytyksiä ei ole näytetään pelkkä ylätason tag | |
| 3 | Alert | Aggregaatti | 1 | ||
| 4 | Heading | Merkkijono | 1 | Otsikko | Lasku on lukitulla kaudella |
| 4 | Description | Merkkijono | 1 | Selite | Laskun hyväksyminen ei päivitä laskun tietoja, koska lasku kuuluu lukitulle kaudelle |
| 2 | Notifications | Aggregaatti | 1 | Jos ilmoituksia ei ole näytetään pelkkä ylätason tag | |
| 3 | Notification | Aggregaatti | 1 | ||
| 4 | Heading | Merkkijono | 1 | Otsikko | |
| 4 | Description | Merkkijono | 1 | Selite | Toimittajan pankkitili on poistettu, päivitä pankkitili |
Kun käytössä parametri handlinghistory lisätään sanoman loppuun seuraava rakenne:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| 2 | HandlingHistory | Aggregaatti | 1 | Laskun käsittelyhistoria | |
| 3 | HandlingHistoryLine | Aggregaatti | 1...n | ||
| 4 | Type | Merkkijono | 1 | Tapahtuma | InvoiceCreated |
| 4 | Heading | Merkkijono | 1 | Otsikko | Luotu |
| 4 | Description | Merkkijono | 1 | Selite | Lasku luotu järjestelmään |
| 4 | Timestamp | Päivämäärä | 1 | Aikaleima | 2018-01-01 09:45:49.200 |
| Attribuutti | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 4 | UserName | Merkkijono | 1 | Kenen toimesta toiminne suoritettu | Järjestelmä |
| 4 | UpdatedInformationFields | Aggregaatti | 1...n | Päivitetyt tiedot | |
| 5 | FieldName | Merkkijono | 1 | Tieto | Tiliöity |
| 5 | OldValue | Merkkijono | 1 | Vanha arvo | Ei |
| 5 | NewValue | Merkkijono | 1 | Uusi arvo | Kyllä |
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:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| attachmentsource | 1 | Aina purchaseinvoice | purchaseinvoice |
| netvisorkey | 1 | Haettavan ostolaskun Netvisor ID | 123 |
| convertpdfstoimages | 0...1 | Arvolla true konvertoidaan ostolaskun pdf-liitteet png kuviksi. Jokainen pdf sivu omana kuvanaan | true |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| root | Root | Aggregaatti | 1 | ||
| 1 | Attachments | Aggregaatti | 1 | ||
| 2 | Attachment | Aggregaatti | 1...n | ||
| 3 | AttachmentNetvisorKey | Numeerinen | 1 | Liitteen Netvisorissa oleva ID | 123 |
| 3 | AttachmentPageNumber | Numeerinen | 1 | Sivunumero | 1 |
| 3 | FileName | Merkkijono | 1 | Laskun päivämäärä | Testikuva.jpg |
| 3 | FileType | Merkkijono | 1 | image/png | |
| 3 | Content | Merkkijono | 1 | Base64 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:
- Haetaan toimittajat vendorcode perusteella
- Haetaan toimittajat, joissa tilinumero ja nimi täsmää saapuneen laskun kanssa ja Y-tunnus on sama kuin laskulla.
- Haetaan toimittajat, joissa tilinumero täsmää saapuneen laskun kanssa ja Y-tunnus on sama kuin laskulla.
- Haetaan toimittajat, joissa tilinumero ja nimi täsmää saapuneen laskun kanssa.
- Haetaan toimittajat, joissa nimi täsmää saapuneen laskun kanssa ja Y-tunnus on sama kuin laskulla.
- Haetaan toimittajat, joissa tilinumero täsmää saapuneen laskun kanssa ja Y-tunnus on toimittajalla tyhjä.
- Haetaan toimittajat, joissa tilinumero täsmää saapuneen laskun kanssa.
- Haetaan toimittajat, joissa Y-tunnus täsmää saapuneen laskun kanssa.
- 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):
| 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 |
| Attribuutti | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| Attribuutti | findopendate | Merkkijono | 0...1 | Vain true | True |
| 2 | invoicesource | Merkkijono | 0...1 | finvoice or manual, täytyy olla finvoice jotta liite voidaan tuoda | 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 |
| Attribuutti | 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 |
| Attribuutti | 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 |
| Attribuutti | format | Merkkijono | 1 | Eräpäivän muoto, aina ansi | ansi |
| 2 | purchaseinvoiceonround | Merkkijono | 0...1 | Laskun tila, open, approved, tai accepted | open |
| Attribuutti | type | Merkkijono | 1 | Tilan tyyppi, täytyy olla 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. Lisätietoja. | FI000111234567 |
| 2 | organizationidentifier | Merkkijono | 0...1 | Toimittajan Y-tunnus | 123456-7 |
| 2 | deliverydate | Päivämäärä | 0...1 | Toimituspäivämäärä | 2019-01-01 |
| Attribuutti | format | Merkkijono | 1 | Toimituspäivämäärän muoto, aina ansi | ansi |
| 2 | overduefinepercent | Numeerinen | 0...1 | Myöhästymismaksu prosentti | 5 |
| 2 | bankreferencenumber | Teksti, maks. 70 | 0...1 | Pankin viitenumero | 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 | |
| 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. Jos arvoa ei anneta, tehdään tiliöinti manuaalisesti Netvisorissa | 1 |
| 2 | primaryvendormatchtype | Merkkijono | 0...1 | Voidaan 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 |
| 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 verollien yksikköhinta | 5,48 |
| 4 | discountpercentage | Numeerinen | 0...1 | Alennusprosentti | 1,5 |
| 4 | vatpercent | Numeerinen | 1 | ALV-prosentti | 22,00 |
| 4 | linesum | Numeerinen | 1 | Pyöristys kahteen desimaaliin | 125,25 |
| Attribuutti | 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 | purchaseinvoicecommentlines | 0...1 | |||
| 3 | purchaseinvoicecommentline | 1...n | |||
| 4 | comment | 1 | Komenttirivin sisältö | Tekstiä | |
| 4 | sort | 0...1 | |||
| 2 | purchaseinvoiceattachments | Aggregaatti | 0...1 | Netvisor käsittelee liitettä laskun kuvana. Vain PDF-muotoiset tiedostot sallittu. | |
| 3 | purchaseinvoiceattachment | Aggregaatti | 1...n | Käytännössä vain ensimmäinen liite näytetää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 | S89O3Ly1Lr59NB |
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):
| Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
| root | Root | Aggregaatti | 1 | ||
| 1 | PurchaseInvoicePostingData | Aggregaatti | 1 | ||
| 2 | PurchaseInvoiceNetvisorKey | Numeerinen | 1 | Ostolaskun ID | 31646 |
| 2 | Status | Merkkijono | 1 | Ostolaskun tilat (status) missä järjestyksessä ne voidaan antaa: | approved |
| 2 | IsReadyForAccounting | Numeerinen | 1 | Mikäli annetaan arvo 1, niin Netvisor muodostaa tositteen automaattisesti. Jos arvoa ei anneta, tehdään tiliöinti manuaalisesti Netvisorissa | 1 |
| 2 | Comment | Merkkijono, max 3000 merkkiä | 0...1 | Ostolaskun kommentti | Kommentti |
| 3 | PurchaseInvoicePostingLine | Aggregaatti | 0...n | ||
| 4 | purchaseinvoicelinenetvisorkey | Numeerinen | 0...1 | Ostolaskurivin iNetvisorID | 12345 |
| 4 | ProductCode | Merkkijono | 0...1 | Tuotekoodi | 123 |
| 4 | ProductName | Merkkijono | 1 | Tuotteen nimi Voidaan jättää pois antamalla mutta jos ostolaskun rivillä on nimike niin tämä ylikirjoittaa arvon tyhjäksi. | Esimerkkituote |
| 4 | OrderedAmount | Numeerinen | 0...1 | Tilattujen tuotteiden määrä | |
| 4 | DeliveredAmount | Numeerinen | 1 | Toimitettujen tuotteiden määrä | |
| 4 | UnitName | Merkkijono | 0...1 | Mittayksikkö | kpl |
| 4 | UnitPrice | Numeerinen | 1 | Yksikköhinta | |
| 4 | DiscountPercentage | Numeerinen | 0...1 | Alennusprosentti | |
| 4 | VatPercent | Numeerinen | 1 | Alv-prosentti | |
| attribuutti | vatcode | Merkkijono | 1 | ALV-tunnus | |
| 4 | LineSum | Numeerinen | 1 | Pyöristys kahteen desimaaliin | |
| attribuutti | type | Merkkijono | 1 | Vain gross = "brutto" | gross |
| 4 | Description | Merkkijono, max 200 merkkiä | 0...1 | Kuvaus | |
| 4 | Sort | 0...1 | Tuotavan rivijärjestysnumero | 1 | |
| 4 | AccountingSuggestion | Numeerinen | 0...1 | Tiliöintiehdotus, jos ei annettu, käytetään yrityksen oletus tiliöintitiliä | |
| 4 | Dimension | 0...n | |||
| 5 | DimensionName | Merkkijono | 1 | Laskentakohdeotsikko | |
| 5 | DimensionItem | Merkkijono | 1 | Laskentakohde |
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):
| Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
| root | Root | Aggregaatti | 1 | ||
| 1 | purchaseinvoicecirculations | Aggregaatti | 1 | ||
| 2 | purchaseinvoicecirculation | Aggregaatti | 1...n | Yhden ostolaskun kierto | |
| 3 | invoiceidentifier | Aggregaatti | 1 | Ostolaskun tunniste, joko ID tai laskunumero | |
| 4 | netvisorkey | Numeerinen | 0...1 | Ostolaskun ID | 123 |
| 4 | invoicenumber | Merkkijono | 0...1 | Laskunumero | 123 |
| 3 | factualverificator | Aggregaatti | 0...n | Ostolaskun asiatarkastajat | |
| 4 | Merkkijono | 1 | Sähköpostiosoite | assi.asiatarkastaja@yritys.com | |
| 3 | approver | Aggregaatti | 0...1 | Ostolaskun hyväksyjä | |
| 4 | Merkkijono | 1 | Sähköpostiosoite | hannu.hyväksyjä@yritys.com | |
| 3 | comment | Merkkijono, maks. 250 | 0...1 | Käsittelyhistorian kommentti | Asiatarkastajat 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:
| Parametri | Muoto | Ilmentymiä | Kuvaus |
| method | Merkkijono | 1 | Add Lisää uutena tilauksena Edit Muokkaa olemassa olevaa tilausta |
| id | Kokonaisluku | 0...1 | Muokattavan ostotilauksen Netvisor tunnus. Pakollinen jos method edit |
Purchaseorderproductline metodeihin liittyviä huomioita:
| Metodi | Kuvaus |
| edit | Jos käytetään, ei saa sisältää ostotilausrivin osatoimistustietoja (purchaseorderproductlinepartialdelivery) ja voi sisältää vain sellaiset elementit joita halutaan muokata |
| delete | Jos käytetään, ostotilausrivin (purchaseorderproductline) on oltava tyhjä |
| partialdeliver | Kä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) |
| addtopartialdeliverygroup | Kä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ää. |
| Parametri | Kuvaus |
| netvisorkey | Pakollinen 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
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | purchaseorder | Aggregaatti | 1 | Tilauksen päätiedot | |
| 2 | ordernumber | Kokonaisluku | 0...1* | Tilauksen numero | 141128 |
| 2 | orderstatus | Merkkijono | 0...1* | Tilauksen tila proposal - Hankintaehdotus approved - Hyväksytty senttovendor - Lähetetty toimittajalle archived - Arkistoitu | approved |
| 2 | orderdate | Päivämäärä | 0...1* | Tilauksen päivämäärä | 2019-01-28 |
| Attribuutti | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 2 | vendoridentifier | Merkkijono | 0...1* | Toimittajan tunnistetieto | 123 |
| Attribuutti | type | Merkkijono | 1 | Tunnistetiedon tyyppi netvisor - Toimittajan Netvisor-avain code - Toimittajan koodi organisationidentifier - Toimittajan Y-tunnus | netvisor |
| 2 | purchaseordervendordetails | Aggregaatti | 0...1 | Toimittajan päätiedot | |
| 3 | addressline | Merkkijono | 1 | Toimittajan osoite, jos ei annettu | Pajukuja 5 |
| 3 | postnumber | Merkkijono | 1 | Toimittajan postinumero | 53921 |
| 3 | city | Merkkijono | 1 | Toimittajan postitoimipaikka | Lappeenranta |
| 3 | country | Merkkijono | 1 | Toimittajan maakoodi | FI |
| Attribuutti | type | Merkkijono | 1 | Maakoodin tyyppi, aina ISO-3166 | ISO-3166 |
| 2 | deliveryterm | Merkkijono | 0...1 | Toimitusehto | Vapaasti toimittajalla |
| 2 | deliverymethod | Merkkijono | 0...1 | Toimitustapa | Noudetaan |
| 2 | purchaseorderdeliverydetails | Aggregaatti | 0...1 | Toimituksen vastaanottajan päätiedot | |
| 3 | deliveryname | Merkkijono | 0...1 | Toimituksen vastaanottajan nimi | Yritys Oy |
| 3 | deliveryaddress | Merkkijono | 0...1 | Toimituksen vastaanottajan osoite | Koulukatu 51 |
| 3 | deliverypostnumber | Merkkijono | 0...1 | Toimituksen vastaanottajan postinumero | 53945 |
| 3 | deliverycity | Merkkijono | 0...1 | Toimituksen vastaanottajan postitoimipaikka | Lappeenranta |
| 3 | deliverycountry | Merkkijono | 0...1 | Toimituksen vastaanottajan maakoodi | FI |
| Attribuutti | type | Merkkijono | 1 | Maakoodin tyyppi, aina ISO-3166 | ISO-3166 |
| 2 | privatecomment | Merkkijono | 0...1 | Sisäinen vapaa kommenttiteksti, ei näy tulosteella | |
| 2 | comment | Merkkijono | 0...1 | Vapaa komenttiteksti, näkyy tulosteella | |
| 2 | ourreference | Merkkijono | 0...1 | Meidän viitteemme | 1411281 |
| 2 | currencycode | Merkkijono | 0...1 | Tilauksessa käytettävän valuutan lyhenne | USD |
| Attribuutti | type | Merkkijono | 1 | Valuutan lyhenteen tyyppi aina ISO-4217 muodossa | ISO-4217 |
| 2 | purchaseorderpaymentterm | Aggregaatti | 0...1 | Maksuehdon päätiedot | |
| 3 | netdays | Kokonaisluku | 1 | Maksuehdon nettopäivät | 14 |
| 3 | discountdays | Kokonaisluku | 1 | Maksuehdon kassa-alennuspäivät | 10 |
| 3 | discountpercent | Desimaaliluku | 1 | Maksuehdon alennusprosentti | 7,5 |
| 2 | purchaseorderlines | Aggregaatti | 0...1* | Tilauksen tuoterivit | |
| 3 | purchaseorderproductline | Aggregaatti | 0...n | Tilauksen tuoterivi | |
| Attribuutti | method | Merkkijono | 0...1 | Tuoterivin 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) |
| Attribuutti | netvisorkey | Kokonaisluku | 0...1* | Tuoterivin ID | |
| 4 | purchaseorderproductlinepartialdelivery | Aggregaatti | 0...1 | Osatoimituksen tiedot | |
| 5 | purchaseorderproductlinepartialdeliverycontent | Aggregaatti | 1...n | Osatoimituksen tieto | |
| 6 | orderedamount | Desimaaliluku | 1 | Tilattujen tuotteiden määrä | 10,00 |
| 6 | deliveredamount | Desimaaliluku | 1 | Toimitettujen tuotteiden määrä | 5,00 |
| 6 | deliveryreceiveddate | Date | 1 | Tuotteiden toimitus päivämäärä | 2019-01-28 |
| Attribuutti | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 6 | deliverymanuallyconfirmed | Merkkijono | 0...1 | Toimitus käsin vahvistettu, vaikka toimitettu poikkeava määrä | true tai false |
| 6 | deliveredproductquality | Kokonaisluku | 0...1 | Toimitetun tuotteen laatu | |
| Attribuutti | type | Merkkijono | 1 | Laadun määritelmä | netvisor |
| 4 | productcode | Merkkijono | 0...1** | Tuotteen tunnistetieto, jos type-attribuuttia ei anneta, riviä ei linkitetä tuotteeseen | 1017 |
| Attribuutti | type | Merkkijono | 0...1 | Tunnisteen tyyppi netvisor - Netvisor tunnus, täytyy löytyä Netvisorista customer - Tuotekoodi, täytyy löytyä Netvisorista | customer |
| 4 | vendorproductcode | Merkkijono | 0...1 | Toimittajan koodi tuotteelle | A100Ah |
| 4 | orderedamount | Desimaaliluku | 0...1** | Tilattujen tuotteiden määrä | 10,00 |
| 4 | unitprice | Desimaaliluku | 0...1 | Tuotteen veroton yksikköhinta valuutassa | 52,50 |
| 4 | vatpercent | Desimaaliluku | 0...1** | Tuotteen ALV-prosentti | 24 |
| 4 | freightrate | Desimaaliluku | 0...1 | Toimituskustannukset | 22,50 |
| 4 | linecomment | Merkkijono | 0...1 | Kommentti (max. 255 merkkiä) | |
| 4 | deliverydate | Päivämäärä | 0...1** | Rivin tuotteiden toimituspäivämäärä | 2019-01-28 |
| Attribuutti | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 4 | purchaseorderproductlinedeliverydetails | Aggregaatti | 0...1 | Tuotteen toimitus tiedot | |
| 5 | deliveredamount | Desimaaliluku | 1 | Vastaanotetun/toimitetun tuotteen määrä | 5,0 |
| 5 | deliveryreceiveddate | Date | 1 | Vastaanotto/toimitus päivämäärä | |
| Attribuutti | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 5 | deliverymanuallyconfirmed | Merkkijono | 0...1 | Toimitus käsin vahvistettu, vaikka toimitettu poikkeava määrä | "true" tai "false" |
| 5 | deliveredproductquality | Kokonaisluku | 0...1 | Toimitetun tuotteen laatu | |
| 4 | inventoryplace | Merkkijono | 0...1 | Käytettävän varaston tunnus | 12 |
| Attribuutti | type | Merkkijono | 1 | Varaston tunnuksen tyyppi netvisor - Varaston Netvisor-tunnus,täytyy löytyä Netvisorista customer - Varastopaikan nimi, täytyy löytyä Netvisorista | netvisor |
| 4 | accountingaccountsuggestion | Kokonaisluku | 0...1 | Tiliöintiehdotustilin numero, täytyy löytyä Netvisorista | 4000 |
| 4 | purchaseorderproductlinedimensions | Aggregaatti | 0...1 | Tuoterivien laskentakohteet | |
| 5 | dimension | Aggregaatti | 0...n | Tuoterivin laskentakohde | |
| 6 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko | Hankinta |
| 6 | dimensionitem | Merkkijono | 1 | Laskentakohde | Tarvikkeet |
| 3 | purchaseordercommentline | 0... | Tilauksen kommenttirivit | ||
| Attribuutti | method | Merkkijono | 0...1 | Kommenttirivin metodi add - Lisää uusi rivi (oletusarvo) edit - Muokkaa olemassa olevaa delete - Poista rivi | |
| Attribuutti | netvisorkey | Kokonaisluku | 0...1 | Kommenttirivin ID | Pakollinen, jos metodi edit tai delete |
| 4 | comment | Merkkijono | 0...1 | Komenttirivin teksti | Akkutilaus |
Huomaathan:
| Elementti | Metodi | Kuvaus |
| purchaseordercommentline | delete | Jos 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:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| limitstartordernumber | 0...1 | Tilaukset alkaen numerosta | 1000 |
| limitendordernumber | 0...1 | Tilaukset numeroon asti | 1100 |
| limitbegindate | 0...1 | Tilaukset alkaen päivämäärästä | 2018-01-01 |
| limitenddate | 0...1 | Tilaukset päivämäärään asti | 2018-06-30 |
| limitorderstatus | 0...1 | Tilauksen tila proposal = Hankintaehdotus approved = Hyväksytty senttovendor = Lähetetty toimittajalle archived = Arkistoitu | approved |
| searchcomment | 0...1 | Rajaus kommentilla tai sisäisellä kommentilla | varastosta |
| limitvendor | 0...1 | Tunnistetiedon tyyppi kokonaisluku = Käsitellään Netvisor tunnisteena y-tunnus = Käsitellään y-tunnuksena muu merkkijono = Käsitellään toimittajakoodina | 123456 |
| lastmodifiedstart | 0...1 | Hakee ostotilaukset, joita on muutettu annetun päivämäärän jälkeen. Tulee antaa muodossa yyyy-MM-ddTHH:mm:ss | 2019-05-15T12:00:00 |
| lastmodifiedend | 0...1 | Hakee ostotilaukset, joita on muutettu ennen annettua päivämäärää. Tulee antaa muodossa yyyy-MM-ddTHH:mm:ss | 2019-05-15T12:00:00 |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| root | Root | Aggregaatti | 1 | ||
| 1 | PurchaseOrderList | Aggregaatti | 1 | ||
| 2 | PurchaseOrder | Aggregaatti | 1 | ||
| 3 | NetvisorKey | Numeerinen | 1 | Ostotilauksen Netivosr key | 123 |
| 3 | OrderNumber | Numeerinen | 1 | Ostotilauksen tilausnumero | 11228 |
| 3 | OrderDate | Päivämäärä | 1 | Ostotilauksen päivämäärä | 2018-06-01 |
| Attribuutti | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 3 | OrderStatus | Merkkijono | 1 | Ostotilauksen tila | approved |
| 3 | VendorName | Merkkijono | 1 | Toimittaja | Netvisor Oy |
| 3 | Amount | Numeerinen | 1 | Loppusumma | 1000 |
| 3 | Uri | Merkkijono | 1 | Netvisor URI tilaukseen | /getpurchaseorder.nv?netvisorkey=123 |
Ostotilauksen nouto
Resurssi: getpurchaseorder.nv
Noutaa halutun ostotilauksen yksityiskohtaiset tiedot.
Kyselyssä käytettävät parametrit:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| netvisorkey | 1 | Noudettavan tilauksen Netvisor tunnus | 123 |
| NetvisorKeyList | 0...1 | Palauttaa yhdessä pyynnössä täydet tiedot kaikista halutuista ostotilauksista, max. 500 ID:tä | 1,2,3 |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Agregaatti | 1 | ||
| 1 | purchaseorder | Agregaatti | 1 | ||
| 2 | netvisorkey | Numeerinen | 1 | Ostotilauksen Netvisor key | 1 |
| 2 | ordernumber | Numeerinen | 1 | Ostotilauksen numero | 1 |
| 2 | orderstatus | Merkkijono | 1 | Ostotilauksen tila | proposal approved senttovendor archived |
| 2 | orderdate | Merkkijono | 1 | Ostotilauksen päivämäärä | 2017-1-1 |
| 2 | vendorname | Merkkijono | 1 | Ostotilauksen toimittaja | Oy Firma Ab |
| 2 | vendoraddressline | Merkkijono | 0...1 | Osotilauksen toimittajan osoite | Firmatie 1 |
| 2 | vendorpostnumber | Numeerinen | 0...1 | Osotilauksen toimittajan postinumero | 00100 |
| 2 | vendorcity | Merkkijono | 0...1 | Ostotilauksen toimittajan toimipaikka | Helsinki |
| 2 | vendorcountry | Merkkijono | 1 | Ostotilauksen toimittajan maa | Finland |
| Attribuutti | type | Merkkijono | 1 | Maakoodin tyyppi, aina ISO-3166 | ISO-3166 |
| 2 | deliveryterm | Merkkijono | 0...1 | Toimitusehto | Sopimuksen mukaan |
| 2 | deliverymethod | Merkkijono | 0...1 | Toimitustapa | Noudetaan |
| 2 | deliveryname | Merkkijono | 0...1 | Toimitusnimi | Yritys Oy |
| 2 | deliveryaddressline | Merkkijono | 0...1 | Toimitusosoite | Yritystie 1 |
| 2 | deliverypostnumber | Numeerinen | 0...1 | Toimitus postinumero | 00500 |
| 2 | deliverycity | Merkkijono | 0...1 | Toimitus toimipaikka | Helsinki |
| 2 | deliverycountry | Merkkijono | 1 | Toimitusmaa | Finland |
| Attribuutti | type | Merkkijono | 1 | Maakoodin tyyppi, aina ISO-3166 | ISO-3166 |
| 2 | privatecomment | Merkkijono | 0...1 | Sisäinen kommentti, ei näy tulosteella, maks. 1000 merkkiä | Sisäinen kommentti |
| 2 | comment | Merkkijono | 0...1 | Kommentti, maks. 1000 merkkiä | Kommentti |
| 2 | ourreference | Merkkijono | 0...1 | Viitteemme, maks. 50 merkkiä | Viitteemme viesti |
| 2 | paymentterm | Merkkijono | 0...1 | Maksuehto | 14 päivää netto |
| 2 | amount | Numeerinen | 1 | Loppusumma | 10000 |
| Attribuutti | currencycode | Merkkijono | 1 | Loppusumman valuutta | EUR |
| Attribuutti | type | Merkkijono | 1 | Valuuttakoodin tyyppi, aina ISO-4217 | ISO-4217 |
| 2 | purchaseorderlines | Agregaatti | 1 | ||
| 3 | purchaseorderproductline | Agregaatti | 1 | ||
| 4 | netvisorkey | Numeerinen | 1 | Ostotilausrivin Netvisor key | 1 |
| 4 | productcode | Merkkijono | 0...1 | Tuotekoodi | Tuotekoodi-123 |
| 4 | productname | Merkkijono | 0...1 | Tuotenimike, jos tuote lisätty Netvisor tuoterekisteristä, muussa tapauksessa Toimittajanimike | Tuote |
| 4 | vendorproductcode | Merkkijono | 0...1 | Toimittajakoodi | Toimittajakoodi-123 |
| 4 | orderedamount | Numeerinen | 1 | Tilattu määrä | 10 |
| 4 | deliveredamount | Numeerinen | 1 | Toimitettu määrä | 0 |
| 4 | unitprice | Numeerinen | 1 | Yksikköhinta | 100 |
| 4 | vatpercent | Numeerinen | 1 | ALV % | 24 |
| 4 | linesum | Numeerinen | 1 | Yhteensä | 100 |
| 4 | freightrate | Numeerinen | 0...1 | Rahti | 0 |
| 4 | deliverydate | Päivämäärä | 1 | Oletettu toimituspäivä | 2017-01-01 |
| Attribuutti | format | Merkkijono | 1 | Päivämäärän muoto | ansi |
| 4 | inventoryplace | Merkkijono | 0...1 | Varasto | Testivarasto |
| 3 | linkedpurchaseinvoices | Agregaatti | 0...1 | Ostotilaukseen linkitettyjen laskujen tiedot | |
| 4 | purchaseinvoice | Agregaatti | 1..n | ||
| 5 | invoicenumber | Numeerinen | 1 | Laskunnumero | 1001 |
| 5 | netvisorkey | Numeerinen | 1 | Laskun Netvisor key | 10 |
| 5 | uri | Merkkijono | 1 | Netvisor 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:
| Parametri | Muoto | Ilmentymiä | Kuvaus |
| method | Merkkijono | 1 | Add Lisää uusi toimittaja |
| netvisorkey | Numeerinen | 0...1 | Toimittajan NetvisorKey |
Tuotavan toimittajan tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena XML:nä (POST-data):
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Agregaatti | 1 | ||
| 1 | vendor | Agregaatti | 1 | ||
| 2 | vendorbaseinformation | Agregaatti | 1 | ||
| 3 | code | Merkkijono | 0...1 | Toimittajakoodi | 123 |
| 3 | name | Merkkijono | 1 | Toimittajan nimi | Testitoimittaja |
| 3 | address | Merkkijono | 0...1 | Osoite | Toimittajakatu 1 |
| 3 | postcode | Merkkijono | 0...1 | Postikoodi | 00100 |
| 3 | city | Merkkijono | 0...1 | Kaupunki | Helsinki |
| 3 | country | Merkkijono | 0...1 | Maakoodi | FI |
| Attribuutti | type | Merkkijono | 1 | Maakoodin tyyppi | ISO-3166 |
| 3 | organizationid | Merkkijono | 0...1 | Y-tunnus | 123456-7 |
| 3 | groupname | Merkkijono | 0...1 | Toimittajaryhmä | The toimittajat |
| 3 | vendorbankaccounts | Agregaatti | 0...1 | Toimittajan pankkitilit | |
| 4 | vendordomesticbankaccounts | Agregaatti | 0...1 | ||
| 5 | vendordomesticbankaccount | Agregaatti | 0...8 | Suomalaiset pankkitilit | |
| 6 | netvisorkey | Numeerinen | 0...1 | Pankkitilin NetvisorKey | 1 |
| 6 | iban | Merkkijono | 1 | Tilinumero IBAN muodossa | FI7536359370000661 |
| 6 | bankname | Merkkijono | 1 | Pankin nimi | Testipankki |
| 6 | isdefault | Merkkijono | 0...1 | Käytetäänkö oletuksena | True |
| 4 | vendorforeignbankaccounts | Agregaatti | 0...1 | ||
| 5 | vendorforeignbankaccount | Agregaatti | 0...8 | Ulkomaalaiset pankkitilit | |
| 6 | netvisorkey | Numeerinen | 0...1 | Pankkitilin NetvisorKey | 2 |
| iban | Merkkijono | 1 | Tilinumero IBAN muodossa | GB29NWBK60161331926819 | |
| 6 | bicswift | Merkkijono | 1 | BIC numero | BUKBGB22 |
| 6 | bankname | Merkkijono | 1 | Pankin nimi | Barclays |
| 6 | clearingcode | Merkkijono | 0...1 | Clearing koodi | |
| 6 | clearingnumber | Merkkijono | 0...1 | Clearing numero | |
| 6 | bankaddresss | Merkkijono | 0...1 | Pankin osoite | Bank Street 1 |
| 6 | country | Merkkijono | 1 | Maakoodi | GB |
| Attribuutti | type | Merkkijono | 1 | Maakoodin tyyppi | ISO-3166 |
| 6 | currencycode | Merkkijono | 1 | Valuuttakoodi | GBP |
| Attribuutti | type | Merkkijono | 1 | Valuuttakoodin tyyppi | ISO-4217 |
| 6 | isdefault | Merkkijono | 0...1 | Käytetäänkö oletuksena | False |
| 6 | includeaddresssinforeignpayments | Merkkijono | 0...1 | Vie pankin osoitetiedot maksusanomalle BIC-koodin lisäksi | True |
| 2 | vendorcontactdetails | Agregaatti | 0...1 | Toimittajan yhteystiedot | |
| 3 | phonenumber | Merkkijono | 0...1 | Puhelinnumero | +35850123456 |
| 3 | Merkkijono | 0...1 | Sähköposti | toimittaja@toimittajat.fi | |
| 3 | faxnumber | Merkkijono | 0...1 | Faksi | |
| 3 | contactpersonname | Merkkijono | 0...1 | Yhteyshenkilön nimi | Timo Testaaja |
| 3 | contactpersonphonenumber | Merkkijono | 0...1 | Yhteyshenkilön puhelinnumero | +35840987654 |
| 3 | contactpersonemail | Merkkijono | 0...1 | Yhteyshenkilön | timo.testaaja@toimittajat.fi |
| 3 | homepage | Merkkijono | 0...1 | Kotisivut | |
| 3 | comment | Merkkijono | 0...1 | Kommentti | No comments |
| 2 | vendoradditionalinformation | Agregaatti | 0...1 | ||
| 3 | defaultvatpercent | Numeerinen | 0...1 | Oletus ALV-kanta | 24 |
| 3 | ispartialvatreduceprivileged | Merkkijono | 0...1 | Vain osittainen ALV-vähennysoikeu | False |
| 3 | paymenttermdiscountpercent | Numeerinen | 0...1 | Alennus prosentti | |
| 3 | paymenttermcashdiscountdays | Numeerinen | 0...1 | Alennus päivät | |
| 3 | paymenttermnetdays | Numeerinen | 0...1 | Oletusmaksuehto | |
| 3 | currencycode | Valuuttakoodi | 0...1 | Oletusvaluutta | EUR |
| Attribuutti | type | Merkkijono | 1 | Valuuttakoodin tyyppi | ISO-4217 |
| 3 | vendordimensions | Agregaatti | 0...1 | Oletuslaskentakohteet | |
| 4 | dimension | Merkkijono | 1 | Laskentakohteen nimi | Kohde |
| 3 | vendoraccountingaccounts | Agregaatti | 0...1 | Toimittajan kirjanpidon tilit | |
| 4 | vendoraccountingaccount | Agregaatti | 1...n | ||
| 5 | accountnumber | Merkkijono | 1 | Kirjanpidon tili | 4000 |
| 5 | isdefault | Merkkijono | 1 | Käytetäänkö oletuksena | True |
| 3 | vendoracceptancedetails | Agregaatti | 0...1 | Asiatarkastajat | |
| 4 | vendoracceptancedetail | Agregaatti | 1...n | ||
| 5 | acceptancename | Merkkijono | 0...1 | Asiatarkastajan nimi | Taaki Tarkastaja |
| 5 | isdefault | Merkkijono | 0...1 | Käytetäänkö oletuksena | False |
| 5 | isforced | Merkkijono | 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:
| Parametri | Muoto | Ilmentymiä | Kuvaus |
| netvisorkey | Numeerinen | 1 | Toimittajan NetvisorKey |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Agregaatti | 1 | ||
| 1 | vendor | Agregaatti | 1 | ||
| 2 | vendorbaseinformation | Agregaatti | 1 | ||
| 3 | code | Merkkijono | 0...1 | Toimittajakoodi | 123 |
| 3 | name | Merkkijono | 1 | Toimittajan nimi | Testitoimittaja |
| 3 | address | Merkkijono | 0...1 | Osoite | Toimittajakatu 1 |
| 3 | postcode | Merkkijono | 0...1 | Postikoodi | 00100 |
| 3 | city | Merkkijono | 0...1 | Kaupunki | Helsinki |
| 3 | country | Merkkijono | 0...1 | Maakoodi | FI |
| Attribuutti | type | Merkkijono | 1 | Maakoodin tyyppi | ISO-3166 |
| 3 | organizationid | Merkkijono | 0...1 | Y-tunnus | 123456-7 |
| 3 | groupname | Merkkijono | 0...1 | Toimittajaryhmä | The toimittajat |
| 3 | vendorbankaccounts | Agregaatti | 0...1 | Toimittajan pankkitilit | |
| 4 | vendordomesticbankaccounts | Agregaatti | 0...1 | ||
| 5 | vendordomesticbankaccount | Agregaatti | 0...8 | Suomalaiset pankkitilit | |
| 6 | netvisorkey | Numeerinen | 0...1 | Pankkitilin NetvisorKey | 1 |
| 6 | iban | Merkkijono | 1 | Tilinumero IBAN muodossa | FI7536359370000661 |
| 6 | bankname | Merkkijono | 1 | Pankin nimi | Testipankki |
| 6 | isdefault | Merkkijono | 0...1 | Käytetäänkö oletuksena | True |
| 4 | vendorforeignbankaccounts | Agregaatti | 0...1 | ||
| 5 | vendorforeignbankaccount | Agregaatti | 0...8 | Ulkomaalaiset pankkitilit | |
| 6 | netvisorkey | Numeerinen | 0...1 | Pankkitilin NetvisorKey | 2 |
| iban | Merkkijono | 1 | Tilinumero IBAN muodossa | GB29NWBK60161331926819 | |
| 6 | bicswift | Merkkijono | 1 | BIC numero | BUKBGB22 |
| 6 | bankname | Merkkijono | 1 | Pankin nimi | Barclays |
| 6 | clearingcode | Merkkijono | 0...1 | Clearing koodi | |
| 6 | clearingnumber | Merkkijono | 0...1 | Clearing numero | |
| 6 | bankaddresss | Merkkijono | 0...1 | Pankin osoite | Bank Street 1 |
| 6 | country | Merkkijono | 1 | Maakoodi | GB |
| Attribuutti | type | Merkkijono | 1 | Maakoodin tyyppi | ISO-3166 |
| 6 | currencycode | Merkkijono | 1 | Valuuttakoodi | GBP |
| Attribuutti | type | Merkkijono | 1 | Valuuttakoodin tyyppi | ISO-4217 |
| 6 | isdefault | Merkkijono | 0...1 | Käytetäänkö oletuksena | False |
| 6 | includeaddresssinforeignpayments | Merkkijono | 0...1 | Vie pankin osoitetiedot maksusanomalle BIC-koodin lisäksi | True |
| 2 | vendorcontactdetails | Agregaatti | 0...1 | Toimittajan yhteystiedot | |
| 3 | phonenumber | Merkkijono | 0...1 | Puhelinnumero | +35850123456 |
| 3 | Merkkijono | 0...1 | Sähköposti | toimittaja@toimittajat.fi | |
| 3 | faxnumber | Merkkijono | 0...1 | Faksi | |
| 3 | contactpersonname | Merkkijono | 0...1 | Yhteyshenkilön nimi | Timo Testaaja |
| 3 | contactpersonphonenumber | Merkkijono | 0...1 | Yhteyshenkilön puhelinnumero | +35840987654 |
| 3 | contactpersonemail | Merkkijono | 0...1 | Yhteyshenkilön | timo.testaaja@toimittajat.fi |
| 3 | homepage | Merkkijono | 0...1 | Kotisivut | |
| 3 | comment | Merkkijono | 0...1 | Kommentti | No comments |
| 2 | vendoradditionalinformation | Agregaatti | 0...1 | ||
| 3 | defaultvatpercent | Numeerinen | 0...1 | Oletus ALV-kanta | 24 |
| 3 | ispartialvatreducedprivileged | Merkkijono | 0...1 | Vain osittainen ALV-vähennysoikeu | False |
| 3 | paymenttermdiscountpercent | Numeerinen | 0...1 | Alennus prosentti | |
| 3 | paymenttermcashdiscountsdays | Numeerinen | 0...1 | Alennus päivät | |
| 3 | paymentermnetdays | Numeerinen | 0...1 | Oletusmaksuehto | |
| 3 | currencycode | Valuuttakoodi | 0...1 | Oletusvaluutta | EUR |
| Attribuutti | type | Merkkijono | 1 | Valuuttakoodin tyyppi | ISO-4217 |
| 3 | vendordimensions | Agregaatti | 0...1 | Oletuslaskentakohteet | |
| 4 | dimension | Merkkijono | 1 | Laskentakohteen nimi | Kohde |
| 3 | vendoraccountingaccounts | Agregaatti | 0...1 | Toimittajan kirjanpidon tilit | |
| 4 | vendoraccountingaccount | Agregaatti | 1...n | ||
| 5 | accountnumber | Merkkijono | 1 | Kirjanpidon tili | 4000 |
| 5 | accountname | Merkkijono | 1 | Tilin nimi | Ostot |
| 5 | isdefault | Merkkijono | 1 | Käytetäänkö oletuksena | True |
| 3 | vendoracceptancedetails | Agregaatti | 0...1 | Asiatarkastajat | |
| 4 | vendoracceptancedetail | Agregaatti | 1...n | ||
| 5 | acceptancename | Merkkijono | 0...1 | Asiatarkastajan nimi | Taaki Tarkastaja |
| 5 | isdefault | Merkkijono | 0...1 | Käytetäänkö oletuksena | False |
| 5 | isforced | Merkkijono | 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:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| method | 1 | Add - laatuluokan lisäys | add |
Tuotavien laatuluokkien tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena xml:nä (POST-data):
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Agregaatti | 1 | ||
| 1 | productquality | Agregaatti | 1 | ||
| 2 | isqualitydeviation | Merkkijono | 1 | Käsitellään laatuluokka laatupoikkeamana | True tai False |
| 2 | name | Merkkijono | 1 | Nimi Suomi/Oletus | Hyvä laatu |
| 2 | name_en | Merkkijono | 0...1 | Nimi Englanti | Good quality |
| 2 | name_se | Merkkijono | 0...1 | Nimi Ruotsi | God kvalitet |
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:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Agregaatti | 1 | ||
| 1 | ProductQualities | Agregaatti | 1 | ||
| 2 | ProductQuality | Agregaatti | 1 | ||
| 3 | Name | Merkkijono | 1 | Laatuluokan nimi | Hyvää tuotetta |
| 3 | NetvisorKey | Numeerinen | 1 | Laatuluokan netvisorkey | 1 |
| 3 | IsQualityDeviation | Merkkijono | 1 | Käsitelläänkö laatupoikkeamana | False |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback