Ostolaskun tuonnista rajapinnan yli peritään aina verkkolaskun transaktiomaksu.
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 | Lataa | ||
Ostolaskun liitteiden nouto | GET | getattachments.nv | |||
Poistettujen ostolaskujen nouto | GET | deletedpurchaseinvoices.nv | |||
Ostolaskun tuonti | POST | purchaseinvoice.nv | purchaseinvoice.dtd | Lataa | |
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 | |
Kiertolistojen nouto | GET | getcirculationlists.nv | Lataa | ||
Ostolaskun jaksotus | POST | purchaseinvoiceaccrual.nv | purchaseinvoiceaccrual.xsd | Lataa | |
Toimittajan tuonti | POST | vendor.nv | vendor.xsd | Lataa | |
Toimittajan nouto | GET | getvendor.nv |
Kuvaus | Skeema |
Netvisor-skeematyypitykset | netvisorgeneraltypes.xsd |
Ostojen skeematyypitykset | purchasegeneraltypes.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 |
paymentstatus | 0...1 | Rajaa ostolaskut maksutilalla, unpaid tai paid | unpaid |
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ä | 2021-10-23 |
Attr. | 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ä. Pyynnön URI:n maksimi pituus 2115 merkkiä. | 1,2,3 |
version | 0...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 |
include | 0...1 | - actions = Palautetaan mitä ostolaskulle voi tehdä (asiatarkastaa, hyväksyä, hylätä, maksuvalmis) - handlinghistory = Palautetaan ostolaskun käsittelyhistoria - previewimage = Palautetaan ostolaskun esikatselukuva - invoiceimage = Palautetaan ostolaskun alkuperäinen PDF-liite tai sen puuttuessa verkkolaskusanomasta generoitu PDF | actions |
omitattachments | 0...1 | True = Ei palauteta ostolaskun liitteitä False = Palautetaan ostolaskun liitteet Jos parametria ei anneta tai arvo on tyhjä = False | true |
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
root | Root | Aggregaatti | 1 | ||
1 | PurchaseInvoice | Aggregaatti | 1 | ||
2 | PurchaseInvoiceNetvisorKey | Merkkijono | 1 | Laskun Netvisor ID | 1025 |
2 | PurchaseInvoiceNumber | Merkkijono | 1 | Laskun numero | 345 |
2 | PurchaseInvoiceDate | Päivämäärä | 1 | Laskun päiväys | 2021-10-02 |
Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
2 | PurchaseInvoiceEventDate | Päivämäärä | 1 | Laskun kirjauspäivä | 2021-10-02 |
Attr. | format | Merkkijono | 1 | Kirjauspäivän muoto, aina ansi | ansi |
2 | PurchaseInvoiceDeliveryDate | Päivämäärä | 1 | Laskun toimituspäivä | 2021-10-04 |
Attr. | format | Merkkijono | 1 | Toimituspäivän muoto, aina ansi | ansi |
2 | PurchaseInvoiceDueDate | Päivämäärä | 1 | Laskun eräpäivä | 2021-10-31 |
Attr. | format | Merkkijono | 1 | Eräpäivän muoto, aina ansi | ansi |
2 | PurchaseInvoiceValueDate | Päivämäärä | 1 | Laskun arvopäivä | 2021-10-15 |
Attr. | format | Merkkijono | 1 | Arvopäivän muoto, aina ansi | ansi |
2 | PurchaseInvoiceReferencenumber | Merkkijono | 1 | Laskun viitenumero | 12594 |
2 | PurchaseInvoiceAgreementIdentifier | Merkkijono | 1 | Sopimustunnus | 123 |
2 | PurchaseInvoiceVendorBankAccountNumber | Merkkijono | 1 | Toimittajan pankkitilinumero | |
2 | IsPurchaseInvoiceVendorBankAccountDeleted | Merkkijono | 1 | True tai False. Kertoo, onko pankkitili poistettu. | False |
2 | IsPurchaseInvoiceVendorBankAccountFromSEPARegion | Merkkiono | 1 | True tai False. Kertoo, onko pankkitili SEPA-alueelta. | True |
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: uusi lasku = open asiatarkastuksessa = infactualverification hyväksynnässä = approved hyväksytty = accepted hylätty = acceptorrejected | open |
2 | PurchaseInvoiceOurReference | Merkkijono | 1 | Viitteemme | 012594 |
2 | PurchaseInvoiceYourReference | Merkkijono | 1 | Viitteenne | 112594 |
2 | PurchaseInvoiceDescription | Merkkijono | 1 | Laskun lisätieto | |
2 | VendorNetvisorKey | Numeerinen | 1 | Toimittajan NetvisorKey | 123 |
2 | VendorOrganizationIdentifier | Merkkijono | 1 | Toimittajan y-tunnus | 1234567-8 |
2 | VendorCode | Merkkijono | 1 | Toimittajakoodi | 23 |
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 | Fingerprint | Merkkijono | 1 | Laskun tunniste | 606F6527D9CAF4BB7B69E4D616FAA78637552960A810FD3B5CC04BFEB6757D4C |
2 | VoucherID | Numeerinen | 1 | Ostolaskun tositteen NetvisorKey. Palauttaa tyhjän tagin, jos laskua ei ole vielä tiliöity ja tositetta ei ole muodostunut. | 1123 |
2 | IsAccounted | Merkkijono | 1 | Onko ostolasku tiliöity | True |
2 | PreviewImage | Merkkijono | 0...n | Kun käytössä parametri include = previewimage | |
Attr. | AttachmentNetvisorKey | Numeerinen | 1 | Laskun kuvan liitteen tunniste | 123 |
2 | InvoiceImage | Merkkijono | 0..n | Base64-enkoodattu laskun kuva PDF-muodossa, kun käytössä parametri include = invoiceimage | |
Attr. | AttachmentNetvisorKey | Numeerinen | 1 | Laskun kuvan liitteen tunniste | 123 |
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 | Rivin NetvisorKey | |
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 | 1 | Vanhentunut elementti, ei palauta mitään | |
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 AccountNetvisorKey | Merkkijono | 0...1 | Tiliöntiehdotuksen tilin Netvisorkey | |
4 | AccountingSuggestionBookkeepingAccount | Merkkijono | 0...1 | Tiliöntiehdotuksen tili | |
4 | PurchaseInvoiceLineDimensions | 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 | Project |
6 | DimensionNameNetvisorKey | Merkkijono | 1 | Laskentakohdeotsikon Netvisor ID | 2 |
6 | DimensionDetailName | Merkkijono | 1 | Laskentakohde | Project 1 |
6 | DimensionDetailNameNetvisorKey | Merkkijono | 1 | Laskentakohteen Netvisor ID | 95 |
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 | Annetaan 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 | 2022-01-01 09:45:49.200 |
Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
4 | UserName | Merkkijono | 1 | Kenen toimesta toiminne suoritettu | Assi Asiatarkastaja |
4 | UserEmail | Merkkijono | 0...1 | Edellisen käyttäjän sähköpostiosoite yrityksessä, mikäli se on määritelty ja käyttäjänä ei ole "Järjestelmä" | assi.asiatarkastaja@yritys.fi.esimerkki |
4 | UpdatedInformationFields | Aggregaatti | 0...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 | Liitteen tiedostonimi | Testikuva.jpg |
3 | FileType | Merkkijono | 1 | Liitteen MIME-tyyppi | application/pdf |
3 | Content | Merkkijono | 1 | Base64 enkoodattu tiedosto | iVBORw0KGgoAAAANSUhEUgAAB |
Poistettujen ostolaskujen nouto
Resurssi: deletedpurchaseinvoices.nv
Resurssilla voi hakea Netvisorista poistettujen ostolaskujen tunnistetiedot 7 päivää taaksepäin.
Kutsussa käytettävät parametrit:
Parametri | Ilmentymiä | Kuvaus | Esimerkki |
deletedsince | 1 | Pakollinen. Hakee tapahtumat, jotka poistettu annetun päivämäärän jälkeen. Tapahtumia voi hakea enintään 7 päivän takaa historiasta | 2022-06-08 |
Vastaus:
Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
1 | root | Aggregaatti | 1 | ||
2 | DeletedPurchaseInvoices | Aggregaatti | 1 | ||
3 | DeletedPurchaseInvoice | Aggregaatti | 0...n | ||
4 | NetvisorKey | Numeerinen | 1 | Ostolaskun Netvisor-avain | 5 |
4 | DeleteDate | Päivämäärä | 1 | Ostolaskun poistopäivämäärä | 2022-06-08 15:14 |
Attr. | format | Merkkijono | 1 | Päivämäärän tyyppi | ansi |
Ostolaskun tuonti
Resurssi: purchaseinvoice.nv
Ostolaskun tuonnista rajapinnan yli peritään verkkolaskun transaktiomaksu.
Huomaathan seuraavat rajoitukset suunnitellessasi ostolaskujen käsittelyä rajapinnan yli:
- Ostolaskuille voidaan tuoda rajapinnan yli vain yksi liite, jota käsitellään ostolaskun kuvana.
- Toimittajatiedot eivät päivity automaattisesti ostolaskun tietojen perusteella.
Ostolaskuja voi tuoda myös suuremmissa erissä. Ohjeet erätuontiin löydät täältä.
Ostolaskulle voi tuoda myös liitetiedostoja dokumentaation mukaan. Liitteen InvoiceSource -kentän arvo täytyy olla finvoice, jotta liitetiedosto voidaan tuoda.
Ostolaskun tuonnin yhteydessä luodaan toimittajakortti, jos toimittajatietoa ei löydy Netvisorista. Ostolaskun tuonnissa toimittajan kohdistus tapahtuu seuraavasti:
- Haetaan toimittajat, joissa nimi täsmää saapuneen laskun kanssa ja Y-tunnus on sama kuin laskulla.
- Haetaan toimittajat, joissa Y-tunnus täsmää saapuneen laskun kanssa.
- Haetaan toimittajat vendorcode:n perusteella
- Haetaan toimittajat, joissa nimi täsmää saapuneen laskun kanssa.
Mikäli mikään näistä ei täyty, luodaan järjestelmään uusi toimittaja.
Ostolaskun toimittajatiedot eivät päivity automaattisesti tuonnissa toimittajakortilta, vaikka toimittaja löytyisi Netvisorin toimittajaluettelosta. Ostolaskusanomalla on siis annettava kaikki toimittajatiedot erikseen.
Tuotavan ostolaskun tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena XML:nä (POST-data):
Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 | ||
1 | purchaseinvoice | Aggregaatti | 1 | ||
2 | invoicenumber | Merkkijono | 1 | Laskun numero | 152212 |
2 | invoicedate | Päivämäärä | 1 | Laskun päiväys | 2019-01-01 |
Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
Attr. | findopendate | Merkkijono | 0...1 | Vain true | true |
2 | invoicesource | Merkkijono | 0...1 | finvoice tai manual, täytyy olla finvoice jotta liite voidaan tuoda. Jos käytetään finvoice, on tuonnissa noin minuutin viive, koska lasku kierrätetään Finvoice-käsittelijän kautta. | manual |
2 | valuedate | Päivämäärä | 0...1 | Arvopäivä, tällä hetkellä tämä tarvitaan laskujen tuontiin, vaikka on merkitty vaihtoehtoiseksi DTD:ssä | 2019-01-15 |
Attr. | format | Merkkijono | 1 | Arvopäivän muoto, aina ansi | ansi |
2 | eventdate | Päivämäärä | 0...1 | Kirjauspäivä, jonka perusteella laskun tosite muodostuu. | 2018-12-31 |
Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
2 | duedate | Päivämäärä | 1 | Laskun eräpäivä | 2019-01-31 |
Attr. | format | Merkkijono | 1 | Eräpäivän muoto, aina ansi | ansi |
2 | purchaseinvoiceonround | Merkkijono | 0...1 | Laskun tila, open, approved, tai accepted | open |
Attr. | type | Merkkijono | 1 | Tilan tyyppi, aina netvisor | netvisor |
2 | vendorcode | Merkkijono | 0...1 | Jos annettu ja luodaan uusi toimittaja tuonnin yhteydessä, tallentuu myös toimittajan taakse. Ei päivity olemassa oleville toimittajille | 12345 |
2 | vendorname | Merkkijono, maks. 250 | 0...1 | Toimittajan nimi | Vendor Oy Ab |
2 | vendoraddressline | Merkkijono, maks. 80 | 0...1 | Toimittajan osoite | Pajukuja 5 |
2 | vendorpostnumber | Merkkijono, maks. 50 | 0...1 | Toimittajan postinumero | 53100 |
2 | vendorcity | Merkkijono, maks. 50 | 0...1 | Toimittajan postitoimipaikka | Lappeenranta |
2 | vendorcountry | Merkkijono, maks. 50 | 0...1 | Toimittajan maakoodi | FI |
2 | vendorphonenumber | Merkkijono, maks. 80 | 0...1 | Toimittajan puhelinnumero | |
2 | vendorfaxnumber | Merkkijono, maks. 80 | 0...1 | Toimittajan fax-numero | |
2 | vendoremail | Merkkijono, maks. 80 | 0...1 | Toimittajan sähköpostiosoite | support@vendor.fi |
2 | vendorhomepage | Merkkijono, maks. 80 | 0...1 | Toimittajan www-osoite | www.vendor.fi |
2 | amount | Numeric | 1 | Laskun summa kahdella desimaalilla | 100,00 |
2 | accountnumber | Merkkijono | 0...1 | Toimittajan tilinumero. Käytä IBAN-muotoa aina, kun kyseessä on IBAN-maa. Lisätietoja. | FI000111234567 |
2 | organizationidentifier | Merkkijono | 0...1 | Toimittajan Y-tunnus | 123456-7 |
2 | sellerorganizationtaxcode | Merkkijono | 0...1 | Toimittajan VAT-tunnus | |
2 | deliverydate | Päivämäärä | 0...1 | Toimituspäivämäärä | 2019-01-01 |
Attr. | format | Merkkijono | 1 | Toimituspäivämäärän muoto, aina ansi | ansi |
2 | overduefinepercent | Numeerinen | 0...1 | Myöhästymismaksuprosentti | 5 |
2 | bankreferencenumber | Teksti, maks. 70 | 0...1 | Pankin viitenumero tai ostolaskun viesti | 011234 |
2 | ourreference | Teksti, maks. 200 | 0...1 | Viitteemme | 111234 |
2 | yourreference | Teksti, maks. 200 | 0...1 | Viitteenne | 211234 |
2 | currencycode | Teksti | 0...1 | Valuuttakoodi, valuuttakoodin lisäksi sanomalla täytyy tuoda pankkitilitieto, jotta valuuttalaskenta tapahtuu oikein. | GBP |
2 | deliveryterms | Teksti, maks. 255 | 0...1 | Toimitusehdot | |
2 | deliverymethod | Teksti, maks. 255 | 0...1 | Toimitustapa | |
2 | comment | Teksti, maks. 255 | 0...1 | Kommentti, laskun lisätieto kenttä | |
2 | checksum | Teksti | 0...1 | Tarkiste | |
2 | pdfextrapages | Numeerinen | 0...1 | ||
2 | readyforaccounting | Numeerinen | 0...1 | Mikäli annetaan arvo 1, niin Netvisor muodostaa tositteen automaattisesti, kun ostolaskun tila on approved tai accepted. Jos arvoa ei anneta, tehdään tiliöinti manuaalisesti Netvisorissa | 1 |
2 | agreementidentifier | Merkkijono | 0...1 | Sopimustunnus | 123 |
2 | primaryvendormatchtype | Merkkijono | 0...1 | Voidaan asettaa ensisijainen toimittajakohdistus arvon mukaan. Sallitut arvot: - code - name - organizationid Mikäli annetun arvon kentän perusteella ei löydy toimittajaa, noudatetaan normaalia toimittajakohdistuksen järjestystä. | |
2 | purchaseinvoicelines | Aggregaatti | 1 | ||
3 | purchaseinvoiceline | Aggregaatti | 1...n | ||
4 | productcode | Teksti, maks. 50 | 0...1 | Tuotekoodi | 15243 |
4 | productname | Teksti, maks. 200 | 1 | Tuotteen nimi Voidaan jättää myös tyhjäksi | Esimerkkituote |
4 | orderedamount | Numeerinen | 0...1 | Tilattujen tuotteiden määrä | 15 |
4 | deliveredamount | Numeerinen | 1 | Toimitettujen tuottedien määrä | 10 |
4 | unitname | Teksti | 0...1 | Mittayksikkö. Ei näy Netvisorissa ostolaskulla mutta palautetaan jos ostolasku haetaan Netvisorista resurssilla getpurchaseinvoice.nv | kpl |
4 | unitprice | Numeerinen | 1 | Tuotteen verollinen yksikköhinta | 5,48 |
4 | discountpercentage | Numeerinen | 0...1 | Alennusprosentti | 1,5 |
4 | vatpercent | Numeerinen | 1 | ALV-prosentti | 24 |
4 | linesum | Numeerinen | 1 | Rivisumma. Pyöristys kahteen desimaaliin. | 125,25 |
Attr. | type | Teksti | 1 | Aina brutto | brutto |
4 | description | Teksti, maks. 200 | 0...1 | Kuvaus | |
4 | sort | Numeerinen | 0...1 | Tuotavan rivijärjestysnumero | 1 |
4 | accountingsuggestion | Numeerinen | 0...1 | Tiliöintiehdotus. Jos ei annettu, käytetään toimittajan oletustiliöintitiliä. ALV-tunnus määrittyy tiliöintiriveille sen mukaan, mikä on asetettu Netvisorissa kyseisen tilin taakse. | 4000 |
4 | dimension | 0...n | |||
5 | dimensionname | Teksti, maks. 50 | 1 | Laskentakohdeotsikko. Jos otsikkoa ei löydy, järjestelmä perustaa sen | Projektit |
5 | dimensionitem | Teksti, maks. 200 | 1 | Laskentakohde. Jos kohdetta ei löydy, järjestelmä perustaa sen | Projekti 1 |
2 | purchaseinvoicesublines | Aggr. | 0...1 | ||
3 | purchaseinvoicesubline | Aggr. | 1...n | ||
4 | productcode | Merkkijono | 0...1 | Tuotekoodi | |
4 | productname | Merkkijono | 0...1 | Tuotteen nimi | |
4 | orderedamount | Numeerinen | 0...1 | Tilattujen tuotteiden määrä | |
4 | deliveredamount | Numeerinen | 0...1 | Toimitettujen tuotteiden määrä | |
4 | unitname | Merkkijono | 0...1 | Mittayksikkö. Ei näy Netvisorissa ostolaskulla. | |
4 | unitprice | Numeerinen | 0...1 | Tuotteen verollinen yksikköhinta | |
4 | discountpercentage | Numeerinen | 0...1 | Alennusprosentti | |
4 | vatpercent | Numeerinen | 0...1 | ALV-prosentti | |
4 | linesum | Numeerinen | 0...1 | Rivisumma. Pyöristys kahteen desimaaliin. | |
Attr. | type | Merkkijono | 1 | Aina brutto | brutto |
4 | description | Merkkijono | 0...1 | Kuvaus | |
4 | sort | Numeerinen | 0...1 | Tuotavan rivijärjestysnumero | 1 |
2 | purchaseinvoiceattachments | Aggregaatti | 0...1 | Netvisor käsittelee liitettä laskun kuvana. Vain PDF-muotoiset tiedostot sallittu. | |
3 | purchaseinvoiceattachment | Aggregaatti | 1...n | ||
4 | mimetype | Merkkijono | 1 | Liitteen mime-type | Application/pdf |
4 | attachmentdescription | Merkkijono | 1 | Liitteen kuvaus | Lasku 11234 |
4 | filename | Merkkijono | 1 | Liitteen tiedostonimi | Lasku11234.pdf |
4 | documentdata | Merkkijono | 1 | Liitteen data Base64 muodossa | S89O3Ly1Lr59NBAttr. |
Attr. | documenttype | Merkijono | 0...1 | Liitteen tyyppi. invoiceimage (laskun kuva) tai otherattachment (muu liite). Oletuksena invoiceimage. Useista invoiceimage-tyyppisistä liitteistä näytetään vain ensimmäinen. Mikäli laskulle halutaan tuoda useampi liite, on ne oltava tyyppiä otherattachment. | otherattachment |
2 | purchaseinvoicerelatedpurchaseordernumbers | Aggr. | 0...1 | ||
3 | purchaseinvoicerelatedpurchaseordernumber | Aggr. | 1...n | ||
4 | purchaseordernumber | Merkkijono | 1 | Ostolaskuun linkitetyn ostotilauksen numero | |
2 | partialpaymentdetails | Aggr. | 0...n | ||
3 | paidamount | Numeerinen | 1 | Laskuun liittyvän suorituksen summa | |
Attr. | amountcurrencyidentifier | Merkkijono | 1 | Suorituksen valuutta | EUR |
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 IsReadyForAccounting-elementtiin 1 ja jätetään Status-elementti pois. 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ä, tai halutaan muokata ostolaskun tiliöintirivejä, tulee ohjelmistorajapintakäyttäjällä olla tarvittavat oikeudet. Käyttäjällä tulisi olla vähintään Ostoreskontran käyttäjän profiili sekä myynti- ja ostoreskontrien oikeuksissa ostolaskujen asiatarkastus- ja hyväksyntäoikeudet.
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: 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 |
2 | eventdate | Päivämäärä | 0...1 | Kirjauspäivä | 2019-01-15 |
Attr. | format | Merkkijono | 1 | Kirjauspäivän muoto, aina ansi | ansi |
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 |
2 | purchaseinvoicepostingline | Aggregaatti | 0...n | ||
3 | purchaseinvoicelinenetvisorkey | Numeerinen | 0...1 | Ostolaskurivin NetvisorID | 12345 |
3 | productcode | Merkkijono | 0...1 | Tuotekoodi | 123 |
3 | productname | Merkkijono | 1 | Tuotteen nimi. Voidaan jättää pois antamalla elementti tyhjänä, mutta jos ostolaskun rivillä on nimike niin tämä ylikirjoittaa arvon tyhjäksi. | Esimerkkituote |
3 | orderedamount | Numeerinen | 0...1 | Tilattujen tuotteiden määrä | |
3 | deliveredamount | Numeerinen | 1 | Toimitettujen tuotteiden määrä | |
3 | unitname | Merkkijono | 0...1 | Mittayksikkö | kpl |
3 | unitprice | Numeerinen | 1 | Yksikköhinta | |
3 | discountpercentage | Numeerinen | 0...1 | Alennusprosentti | |
3 | vatpercent | Numeerinen | 1 | Alv-prosentti | |
Attr. | vatcode | Merkkijono | 1 | ALV-tunnus | |
3 | linesum | Numeerinen | 1 | Pyöristys kahteen desimaaliin | |
Attr. | type | Merkkijono | 1 | Vain gross = "brutto" | gross |
3 | description | Merkkijono, max 200 merkkiä | 0...1 | Kuvaus | |
3 | sort | Numeerinen | 0...1 | Tuotavan rivijärjestysnumero | 1 |
3 | accountingsuggestion | Numeerinen | 0...1 | Tiliöintiehdotus, jos ei anneta, käytetään yrityksen oletustiliöintitiliä | |
3 | dimension | Aggregaatti | 0...n | ||
4 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko | |
4 | 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. Kierto asetetaan joko kiertolistan perusteella tai henkilöittäin.
Kiertoon asetettavien henkilöiden identifiointi tapahtuu sähköpostiosoitteen perusteella. Jos henkilölle on asetettu sähköpostiosoite Netvisorin omissa perusasetuksissa kohdassa Yrityskohtaiset poikkeukset, käytetään kyseistä sähköpostia. Henkilön sähköpostiosoitteen on oltava uniikki yrityksessä.
Kiertoon asetettavalla henkilöllä on oltava Netvisorissa riittävät reskontraoikeudet kyseisessä roolissa toimimiseksi. Lisäksi mahdollinen toimittaja- tai summaraja ei saa olla asettamisen esteenä. HUOM! 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.
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 | circulationlistidentifier | Aggregaatti | 0.. | Kiertolistan tunniste. Jos tunniste on asetettu, ei voida tuoda henkilöitä ja päinvastoin. | |
4 | netvisorkey | Numeerinen | 1 | Kiertolistan ID | 10 |
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. |
Kiertolistojen nouto
Resurssi: getcirculationlists.nv
Resurssilla noudetaan yrityksen ostolaskujen asiatarkastuksen ja hyväksynnän kiertolistat. Kiertolistan tunniste (NetvisorKey) tarvitaan, kun kiertolista asetetaan Ostolaskun asiatarkastus- ja hyväksyntäkierron tuonti -resurssilla (purchaseinvoicecirculation.nv). Resurssi palauttaa kaikki yrityksen kiertolistat aakkosjärjestyksessä. Rajausparametreille ei ole tukea.
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
root | root | Aggregaatti | 1 | ||
1 | CirculationLists | Aggregaatti | 1 | ||
2 | CirculationList | Aggregaatti | 0..n | ||
3 | NetvisorKey | Numeerinen | 1 | Kiertolistan tunniste | 10 |
3 | Name | Merkkijono | 1 | Kiertolistan nimi | Kesälomien kiertolista |
3 | IsDefault | Boolean | 1 | Onko kiertolista oletus, true tai false | true |
3 | IsForced | Boolean | 1 | Onko asiatarkastuskierto pakotettu, true tai false | false |
3 | LastEditTimeStamp | Date | 0..1 | Kiertolistan viimeisin päivitysaika | 2023-05-02T09:30:59.247 |
3 | Verifiers | Aggregaatti | 0..1 | ||
4 | FactualVerifier | Aggregaatti | 0..n | ||
5 | Name | Merkkijono | 1 | Asiatarkastajan nimi | Anssi Asiatarkastaja |
5 | Order | Numeerinen | 0..1 | Asiatarkastuksen järjestys, mikäli kierto on pakotettu | 1 |
5 | IsMainFactualVerifier | Boolean | 0..1 | Onko pääasiatarkastaja. Elementti palautuu vastauksessa ainoastaan jos arvo on true | true |
4 | Approver | Aggregaatti | 0..1 | ||
5 | Name | Merkkijono | 1 | Hyväksyjän nimi | Henni Hyväksyjä |
Ostolaskun jaksotus
Resurssi: purchaseinvoiceaccrual.nv
Ostolasku voidaan jaksottaa antamalla jaksotukselle alku- ja loppuajankohta tai alkuajankohta ja jakokäyrä. Ajankohdat annetaan kuukausi-vuosipareina. Jaksotuksen loppuajankohta ei voi olla ennen alkuajankohtaa ja alkuajankohta voi olla aikaisintaan laskun kirjauspäivän kuukausi. Ostolaskua ei voi jaksottaa lukitulle kaudelle.
Mikäli käytetään jakokäyrää, jaksotukselle voidaan määrittää kuukausikohtaiset prosenttiarvot. Mikäli käytetään alku- ja loppuajankohtaa, jaksotetaan tasaprosentilla annetulle aikajaksolle. Esimerkiksi 3/2021 - 4/2021 jaksottaa laskun rivit maalis- ja huhtikuulle 50%:lla.
Rajapinta ei luo oletuksena jaksotusta, mikäli laskulla on olemassaoleva tosite tai jaksotus. Mikäli haluaa muokata olemassaolevaa jaksotusta tai jaksottaa jo tiliöidyn laskun, tulee käyttää parametria:
<removeexistingaccrual>true</removeexistingaccrual>
Mikäli ostolaskulla ei ole aiempaa tositetta tai jaksotusta, parametrilla removeexistingaccrual=true ei ole vaikutusta.
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 | purchaseinvoiceaccrual | Aggregaatti | 1 | Ostolaskun jaksotus | |
2 | invoiceidentifier | Aggregaatti | 1 | Ostolaskun tunniste, joko ID tai laskunumero | |
3 | netvisorkey | Numeerinen | 0...1 | Ostolaskun ID | 123 |
3 | invoicenumber | Merkkijono | 0...1 | Laskunumero | 123 |
2 | accrualrule | Aggregaatti | 1 | Jaksotussääntö | |
3 | removeexistingaccrual | Boolean | 0..1 | Yliajetaanko mahdollinen aiempi jaksotus | true |
3 | startmonth | Numeerinen | 1 | Jaksotuksen aloituskuukausi | 12 |
3 | startyear | Numeerinen | 1 | Jaksotuksen aloitusvuosi | 2021 |
3 | endmonth | Numeerinen | 0...1 | Jaksotuksen lopetuskuukausi | 12 |
3 | endyear | Numeerinen | 0...1 | Jaksotuksen lopetusvuosi | 2021 |
3 | divisioncurvename | Merkkijono maks. 250 | 0...1 | Jakokäyrän nimi (oltava yksilöllinen) | Poistot |
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. Toimittajan NetvisorKey:n saa noudettua rajapinnan yli toimittajalistauksen avulla parametrilla changedsince. 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 Edit Muokkaa olemassa olevaa toimittajaa |
netvisorkey | Numeerinen | 0...1 | Toimittajan NetvisorKey Pakollinen jos method = edit |
Tuotavan toimittajan tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena XML:nä (POST-data):
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 | ||
1 | vendor | Aggregaatti | 1 | ||
2 | vendorbaseinformation | Aggregaatti | 1 | ||
3 | code | Merkkijono | 0...1 | Toimittajakoodi | 123 |
3 | name | Merkkijono | 1 | Toimittajan nimi | Testitoimittaja |
3 | address | Merkkijono | 1 | Osoite | Toimittajakatu 1 |
3 | postcode | Merkkijono | 1 | Postikoodi | 00100 |
3 | city | Merkkijono | 1 | Kaupunki | Helsinki |
3 | country | Merkkijono | 1 | Maakoodi | FI |
Attr. | 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 | Aggregaatti | 0...1 | Toimittajan pankkitilit | |
4 | vendordomesticbankaccounts | Aggregaatti | 0...1 | ||
5 | vendordomesticbankaccount | Aggregaatti | 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 | Aggregaatti | 0...1 | ||
5 | vendorforeignbankaccount | Aggregaatti | 0...8 | Ulkomaalaiset pankkitilit | |
6 | netvisorkey | Numeerinen | 0...1 | Pankkitilin NetvisorKey | 2 |
6 | bban | Merkkijono | 1 | Tilinumero BBAN muodossa | GB29NWBK60161331926819 |
6 | bicswift | Merkkijono | 1 | BIC numero | BUKBGB22 |
6 | bankname | Merkkijono | 1 | Pankin nimi | Barclays |
6 | clearingcode | Merkkijono | 0...1 | Clearingkoodi | |
6 | clearingnumber | Merkkijono | 0...1 | Clearingnumero | |
6 | bankaddresss | Merkkijono | 0...1 | Pankin osoite | Bank Street 1 |
6 | country | Merkkijono | 1 | Maakoodi | GB |
Attr. | type | Merkkijono | 1 | Maakoodin tyyppi | ISO-3166 |
6 | currencycode | Merkkijono | 1 | Valuuttakoodi | GBP |
Attr. | 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 | Aggregaatti | 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 | Aggregaatti | 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 |
Attr. | type | Merkkijono | 1 | Valuuttakoodin tyyppi | ISO-4217 |
3 | vendordimensions | Aggregaatti | 0...1 | Oletuslaskentakohteet | |
4 | dimension | Aggregaatti | 1...n | ||
5 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko | Project |
5 | dimensionitem | Merkkijono | 1 | Laskentakohde | Project 1 |
3 | vendoraccountingaccounts | Aggregaatti | 0...1 | Toimittajan kirjanpidon tilit | |
4 | vendoraccountingaccount | Aggregaatti | 1...n | ||
5 | accountnumber | Merkkijono | 1 | Kirjanpidon tili | 4000 |
5 | isdefault | Merkkijono | 1 | Käytetäänkö oletuksena | True |
3 | vendoracceptancedetails | Aggregaatti | 0...1 | Asiatarkastajat | |
4 | vendoracceptancedetail | Aggregaatti | 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. Toimittajan tiedot noudetaan NetvisorKey:n tai muutosaikaleiman perusteella. Toimittajien NetvisorKey:t saa noudettua rajapinnan yli käyttämällä muutosaikaleima (changedsince) parametria.
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 | Ilmentymiä | Kuvaus | Esimerkki |
netvisorkey | 1 | Toimittajan tunniste Netvisorissa. Vastauksen juurielementtinä "vendor". | 1 |
netvisorkeylist | 0...1 | Palauttaa yhdessä pyynnössä tiedot toimittajista. Huomioithan, että kaikilla annetuilla ID:illä on löydyttävä toimittaja, muuten tulee vastauksena pelkkä virhe: "Toimittajaa ei löydy, netvisorkey NNN". Vastauksen juurielementtinä on "vendors", jos annetussa listassa on useita ID:itä, mutta"vendor" jos annettu vain yksi ID. | 1,2,3 |
changedsince | 0...1 | Suodattaa toimittajat, joissa muutoksia annetun päivämäärän jälkeen. Päivämäärällä annetaan muodossa YYYY-MM-DD tai aikaleimalla YYYY-MM-DDTHH:MM:SS. Vastauksen juurielementtinä on "vendors" jos listassa on useita ID:itä. Jos muuttuneita toimittaja ei ole, vendors-elementin sisältö on tyhjä. Mikäli halutaan noutaa koko toimittajalistaus, parametrin päivämääränä voi antaa: getvendor.nv?changedsince=1970-01-01 | |
page | 0...1 | Numeerinen arvo, jolla voi hakea toimittajatietoja 500 toimittajan sivuissa. Jokainen sivu pitää hakea omalla kutsullaan. Sivutuksen tiedot palautetaan rajapinnan vastaussanoman header-tiedoissa. Esim: X-Netvisor-Pagination-Current-Page : 2 X-Netvisor-Pagination-Previous-Page : 1 X-Netvisor-Pagination-Next-Page : 3 X-Netvisor-Pagination-Limit : 100 X-Netvisor-Pagination-Total-Count : 1000 | 2 |
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | Root | Aggregaatti | 1 | ||
1 | Vendor | Aggregaatti | 1 | Juurielementti voi olla "vendor" tai "vendors", katso parametrien kuvauksista tarkemmat ohjeet. | |
2 | NetvisorKey | Numeerinen | 1 | Toimittajan NetvisorKey | 123 |
2 | VendorBaseInformation | Aggregaatti | 1 | ||
3 | Code | Merkkijono | 0...1 | Toimittajakoodi | 123 |
3 | Name | Merkkijono | 1 | Toimittajan nimi | Testitoimittaja |
3 | Address | Merkkijono | 1 | Osoite | Toimittajakatu 1 |
3 | PostCode | Merkkijono | 1 | Postikoodi | 00100 |
3 | City | Merkkijono | 1 | Kaupunki | Helsinki |
3 | Country | Merkkijono | 1 | Maakoodi | FI |
Attr. | type | Merkkijono | 1 | Maakoodin tyyppi | ISO-3166 |
3 | OrganizationId | Merkkijono | 1 | Y-tunnus | 1234567-8 |
3 | GroupName | Merkkijono | 0...1 | Toimittajaryhmä | The toimittajat |
3 | VendorBankAccounts | Aggregaatti | 0...1 | Toimittajan pankkitilit | |
4 | VendorDomesticBankAccounts | Aggregaatti | 0...1 | ||
5 | VendorDomesticBankAccount | Aggregaatti | 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 | Aggregaatti | 0...1 | Ulkomaalaiset pankkitilit | |
5 | VendorForeignBankAccount | Aggregaatti | 0...8 | Ulkomaalainen pankkitili | |
6 | NetvisorKey | Numeerinen | 0...1 | Pankkitilin NetvisorKey | 2 |
6 | BBAN | Merkkijono | 1 | Tilinumero BBAN 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 |
Attr. | type | Merkkijono | 1 | Maakoodin tyyppi | ISO-3166 |
6 | CurrencyCode | Merkkijono | 1 | Valuuttakoodi | GBP |
Attr. | 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 | Aggregaatti | 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 | Aggregaatti | 0...1 | ||
3 | DefaultVatpercent | Numeerinen | 0...1 | Oletus ALV-kanta | 24 |
3 | IsPartialVatReducedPrivileged | Merkkijono | 0...1 | Vain osittainen ALV-vähennysoikeus | False |
3 | PaymentTerm | Numeerinen | 0...1 | Oletusmaksuehto | 3 |
3 | VendorDimensions | Aggregaatti | 0...1 | Oletuslaskentakohteet | |
4 | Dimension | Aggregaatti | 1 | ||
5 | DimensionName | Merkkijono | 1 | Laskentakohdeotsikko | Projekti |
5 | DimensionItem | Merkkijono | 1 | Laskentakohde | Projekti 1 |
3 | VendorAccountingAccounts | Aggregaatti | 0...1 | Toimittajan kirjanpidon tilit | |
4 | VendorAccountingAccount | Aggregaatti | 1 | ||
5 | AccountNumber | Merkkijono | 1 | Kirjanpidon tili | 4000 |
5 | AccountName | ||||
5 | IsDefault | Merkkijono | 1 | Käytetäänkö oletuksena | True |
3 | VendorAcceptanceDetails | Aggregaatti | 0...1 | Asiatarkastajat | |
4 | VendorAcceptanceDetail | Aggregaatti | 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 |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback