Tuotteiden käsittelyn toiminnot jakautuvat seuraaviin toimintoihin:
Integraatio | HTTP-metodi | Resurssi | DTD | Esimerkki |
Tuotelistan nouto | GET | productlist.nv | Lataa | |
Tuotetietojen nouto | GET | getproduct.nv | Lataa | |
Tuoteryhmien nouto | GET | getproductgroups.nv | Lataa | |
Tuotetietojen tuonti | POST | product.nv | product.dtd | Lataa |
Rakenteellisen tuotelistan nouto | GET | webshopproductlist.nv | Lataa | |
Rakenteellisten tuotteiden tuotekuvien nouto | GET | webshopproductimages.nv | Lataa | |
Tuotesaldojen nouto varastoittain | GET | inventorybywarehouse.nv | Lataa | |
Varastojen nouto | GET | getinventoryplaces.nv | Lataa | |
Varastotapahtuman tuonti | POST | warehouseevent.nv | warehouseevent.dtd | Lataa |
Varastoraporttien nouto | GET | warehousereport.nv | Lataa | |
Tuotteen liitteiden nouto | GET | getproductattachment.nv | Lataa | |
Tuotteen kuvien nouto | GET | getproductimage.nv | Lataa | |
Laajennettu tuotetietojen nouto | GET | extendedproductlist.nv | Lataa |
Tuotelistan nouto
Resurssi: productlist.nv
Tuotelista sisältää tuotteiden perustietoja. Tarkemmat tuotetiedot voidaan tämän jälkeen noutaa käyttäen toimintoa Tuotetietojen nouto.
Haussa voidaan käyttää yhtä tai useampaa parametriä samanaikaisesti. Kutsussa käytettävät parametrit:
Parametri | Ilmentymiä | Kuvaus | Esimerkki |
changedsince | 0...1 | Suodattaa tuotteet, joissa muutoksia annetun päivämäärän ja/tai kellonajan jälkeen. Annetaan muodossa yyyy-MM-ddTHH:mm:ss | 2020-09-13T 12:00:00 |
keyword | 0...1 | Rajataan tuotteet, joiden nimessä tai tuotekoodissa esiintyy annettu parametri. | 1,2,3,4 |
published | 0...1 | Arvo 1, jolloin näytetään julkaistut tuotteet tai 0, jolloin ei palauteta julkaistuja tuotteita | 1 |
unpublished | 0...1 | Arvo 1, jolloin palautetaan julkaisemattomat tuotteet tai 0, jolla ei palauteta julkaisemattomia tuotteita. | 1 |
deleted | 0...1 | Arvo 1, jolla palautetaan poistetut tuotteet tai 0, jolloin vastaus ei sisälllä poistettuja tuotteita. Jos parametria ei käytetä, palautetaan myös poistetut tuotteet. Jos annetaan, tulee antaa myös joko published tai unpublished. | 1 |
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 | ||
1 | ProductList | Aggregaatti | 1 | ||
2 | Product | Aggregaatti | 0...n | ||
3 | NetvisorKey | Numeerinen | 1 | Tuotteen Netvisor-id | 165 |
3 | ProductCode | Merkkijono | 1 | Tuotekoodi | TT |
3 | Name | Merkkijono | 1 | Tuotenimike | Testituote |
3 | UnitPrice | Numeerinen | 1 | Tuotteen yksikköhinta nettona 12 desimaalin tarkkuudella | 1,960000000000 |
3 | UnitGrossPrice | Numeerinen | 1 | Tuotteen yksikköhinta bruttona 12 desimaalin tarkkuudella | 2,430400000000 |
3 | ProductGroupID | Numeerinen | 1 | Tuotteen tuoteryhmän ID. Voi olla myös tyhjä. | 2 |
3 | ProductGroupDescription | Merkkijono | 1 | Tuotteen tuoteryhmä, koko hierarkia avattuna. Voi myös olla tyhjä. | Kirjat / Tieteiskirjat |
3 | Uri | Merkkijono | 1 | URI, josta voi hakea tuotteen täydelliset tiedot | /getproduct.nv?id=165 |
Tuotetietojen nouto
Resurssi: getproduct.nv
Ennen tuotetietojen noutoa on noudettava tuotelista, josta poimitaan haussa käytettävä tunniste. Tunnisteen avulla tarkemmat tiedot voidaan noutaa joko yhden tuotteen osalta tai parametreillä idlist ja codelist voit noutaa max.400 tuotteen tiedot kerralla.
Kutsussa käytettävät parametrit:
Parametri | Ilmentymiä | Esimerkki | Kuvaus |
id | 0...1 | 123 | Halutun tuotteen Netvisor-avain. |
idlist | 0...1 | 1,2,3 | Palauttaa yhdessä pyynnössä täydet tiedot kaikista halutuista tuotteista, max. 400 ID:tä |
eancode | 0...1 | 123456789012 | Halutun tuotteen EAN-koodi |
code | 0...1 | 123 | Halutun tuotteen tuotekoodi |
codelist | 0...1 | 1,2,tuote... | Palauttaa yhdessä pyynnössä täydet tiedot kaikista halutuista tuotteista tuotteiden tuotekoodien mukaan |
showsubproducts | 0...1 | 1 | Jos 1, haetaan myös tuotteen alituotteet |
replyoption | 0...1 | 1 | Jos 1, haetaan vain aktiiviset (eli ei-poistetut) tuotteet Jos 2, haetaan vain julkaistut tuotteet (sisältäen poistetut julkaistut tuotteet) Jos 3, haetaan vain aktiiviset julkaistut tuotteet |
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 | ||
1 | Product | Aggregaatti | 1 | ||
2 | ProductBaseInformation | Aggregaatti | 0...n | ||
3 | NetvisorKey | Numeerinen | 1 | Tuotteen Netvisor-id | 165 |
3 | ProductCode | Merkkijono | 1 | Tuotekoodi | CC |
3 | ProductGroup | Merkkijono | 1 | Tuoteryhmän nimi | Kirjat |
3 | Name | Merkkijono | 1 | Tuotteen nimi | Code Complete |
3 | Description | Merkkijono | 1 | Kuvaus | Toinen painos |
3 | UnitPrice | Numeerinen | 1 | Tuotteen yksikköhinta | 42,5 |
Attr. | type | Merkkijono | 1 | Aina net (veroton). | net |
3 | UnitGrossPrice | Numeerinen | 1 | Tuotteen verollinen yksikköhinta | 52,7 |
Attr. | type | Merkkijono | 1 | Aina gross (verollinen) | gross |
3 | Unit | Merkkijono | 1 | Tuotteen yksikkö | kpl |
3 | UnitWeight | Numeerinen | 1 | Tuotteen yksikköpaino HUOM elementti on vanhentunut, käytä sen sijaan elementtiä ProductNetWeight | 1 |
3 | PurchasePrice | Numeerinen | 1 | Ostohinta | 25 |
3 | TariffHeading | Merkkijono | 1 | Tullinimike | Code Complete |
3 | ComissionPercentage | Numeerinen | 1 | Provisio | 11 |
3 | IsActive | Numeerinen | 1 | Onko tuote aktiivinen, 0=ei / 1=kyllä | 1 |
3 | IsSalesProduct | Numeerinen | 1 | Onko tuote myyntituote, 0=ei / 1=kyllä | 0 |
3 | CountryOfOrigin | Merkkijono | 1 | Aluperämaa | FI |
Attr. | type | Merkkijono | 1 | Aina ISO-3166 | ISO-3166 |
2 | ProductBookKeepingDetails | Aggregaatti | 1 | ||
3 | DefaultVatPercent | Numeerinen | 1 | Alv-kanta | 24 |
3 | DefaultDomesticAccountNumber | Numeerinen | 1 | Kotimainen oletustilinumero | |
3 | DefaultEuAccountNumber | Numeerinen | 1 | EU:n alueen oletustilinumero | |
3 | DefaultOutsideEUAccountnumber | Numeerinen | 1 | Kansainvälinen oletustilinumero | |
3 | ProductDimensions | Aggregaatti | 1 | ||
4 | Dimension | Aggregaatti | 0...n | ||
5 | DimensionName | Merkkijono | 1 | Laskentakohdeotsikon nimi | Villieläimet |
Attr. | Netvisorkey | Numeerinen | 1 | ||
5 | DimensionItem | Merkkijono | 1 | Laskentakohteen nimi | Kirahvit |
Attr. | Netvisorkey | Numeerinen | 1 | ||
2 | ProductInventoryDetails | Aggregaatti | 1 | ||
3 | InventoryAmount | Numeerinen | 1 | Varastossa olevien tuotteiden määrä | 2,00 |
3 | InventoryMidPrice | Numeerinen | 1 | Tuotteen keskihinta | 5,0 |
3 | InventoryValue | Numeerinen | 1 | Varaston arvo: varastossa x keskihinta | 10,0000 |
3 | InventoryReservedAmount | Numeerinen | 1 | Varattujen tuotteiden määrä | 1,00 |
3 | InvetoryOrderedAmount | Numeerinen | 1 | Tilattujen tuotteiden määrä | 0,00 |
3 | InventoryAccountNumber | Numeerinen | 1 | Varastotili | 1521 |
2 | ProductAdditionalInformation | Aggregaatti | 1 | ||
3 | ProductNetWeight | Numeerinen | 1 | Nettopaino | 11,20 |
Attr. | weightunit | Merkkijono | 1 | Nettopainon yksikkö: g, kg tai t | kg |
3 | ProductGrossWeight | Numeerinen | 1 | Bruttopaino | 12,60 |
Attr. | weightunit | Merkkijono | 1 | Bruttopainon yksikkö: g, kg tai t | kg |
3 | ProductPackageInformation | Aggregaatti | 1 | ||
4 | PackageWidth | Numeerinen | 1 | Pakkauksen leveys senttimetreinä | 7,30 |
Attr. | unit | Merkkijono | 1 | Pakkauksen leveys, mittayksikkö | cm |
4 | PackageHeight | Numeerinen | 1 | Pakkauksen korkeus senttimetreinä | 15,00 |
Attr. | unit | Merkkijono | 1 | Pakkauksen korkeuden mittayksikkö | cm |
4 | PackageLength | Numeerinen | 1 | Pakkauksen pituus senttimetreinä | 36,10 |
Attr. | unit | Merkkijono | 1 | Pakkauksen pituuden mittayksikkö | cm |
3 | PrimaryEanCode | Numeerinen | 1 | Tuotteen ensisijainen EAN-koodi | 123456789012 |
3 | SecondaryEanCode | Numeerinen | 1 | Tuotteen toissijainen EAN-koodi | 555444332221 |
2 | SubProductInformation | Aggregaatti | 1 | ||
3 | Parents | Aggregaatti | 1 | Tuotteen päätuotteet | |
4 | Product | Aggregaatti | 0...n | ||
5 | Netvisorkey | Numeerinen | 1 | Päätuotteen Netvisor tunniste | 784 |
5 | Amount | Numeerinen | 1 | Kpl määrä | 1 |
5 | PurchasePriceChange | Numeerinen | 1 | Ostohinnanmuutos | 5,50 |
5 | UnitPriceChange | Numeerinen | 1 | Yksikköhinnanmuutos | 5,50 |
3 | Children | Aggregaatti | 1 | Tuotteen alituotteet | |
4 | Product | Aggregaatti | 0...n | ||
5 | Netvisorkey | Numeerinen | 1 | Alituotteen Netvisor tunniste | 784 |
5 | Amount | Numeerinen | 1 | Kpl määrä | 1 |
5 | PurchasePriceChange | Numeerinen | 1 | Ostohinnanmuutos | 5,50 |
5 | UnitPriceChange | Numeerinen | 1 | Yksikköhinnanmuutos | 5,50 |
Tuoteryhmien nouto
Resurssi: getproductgroups.nv
Resurssilla voidaan noutaa tuoteryhmien tiedot Netvisorin rajapinnasta.
Kutsun rajauksessa käytettävät parametrit:
Parametri | Ilmentymiä | Kuvaus | Esimerkki |
replyoptions | 0...1 | Lisätäänkö tuotehierarkia sanomalle, 1 tai 0 | 1 |
searchlanguage | 0...1 | Noudon kieli, FI, SE tai EN | FI |
productgroupnamekeyword | 0...1 | Tuoteryhmän hierarkianimen alkuosa | Esimerkki |
productgroupnetvisorkeys | 0...1 | Noudettavan tuoteryhmän/tuoteryhmien NetvisorKey(t) | 4 |
productgroupnamefreetext | 0...1 | Tuoteryhmän hierarkianimen pitää sisältää annettu teksti | Esimerkki |
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 | ||
1 | ProductGroups | Aggregaatti | 1 | ||
2 | ProductGroup | Aggregaatti | 1...n | ||
3 | NetvisorKey | Numeerinen | 1 | Tuoteryhmän Netvisor-id | 16 |
3 | ProductGroupNameTranslations | Aggregaatti | 1 | ||
4 | Translation | Merkkijono | 1...3 | Tuoteryhmän nimi | Esimerkkituoteryhmä |
Attr. | Language | Merkkijono | 1...3 | Tuoteryhmän nimen kieli | FI |
3 | ProductGroupDescriptionTranslations | Aggregaatti | 1 | ||
4 | Translation | Merkkijono | 1...3 | Tuoteryhmän kuvaus | Esimerkkikuvaus |
Attr. | Language | Merkkijono | 1...3 | Tuoteryhmän kuvauksen kieli | FI |
3 | ProductGroupHierarchy | Aggregaatti | 1 | ||
4 | ProductGroupHierarchyNameTranslations | Aggregaatti | 1 | ||
5 | Translation | Merkkijono | 1...3 | Tuoteryhmän koko hierarkia | Esimerkkituoteryhmä / Tuoteryhmä |
Attr. | Language | Merkkijono | 1...3 | Tuoteryhmän hierarkian kieli | FI |
4 | ParentGroupNetvisorKey | Numeerinen | 1 | Sen tuoteryhmän Netvisor-id, jonka alituote t. Voi olla myös tyhjä. | 18 |
4 | ChildGroups | Aggregaatti | 1 | ||
5 | NetvisorKey | Numeerinen | 0...n | Tuoteryhmän alituoteryhmien Netvisor-id:t | 12 |
Tuotetietojen tuonti
Resurssi: product.nv
Laajennetun tuotehallinnan osalta voi rajapinnan yli tuoda uuden tuotteen alla olevan kuvauksen mukaisesti, mutta rajapinnan yli ei ole tuettu tuotteiden päivittäminen laajennetun tuotehallinnan kanssa.
Kutsussa käytettävät parametrit (QueryString):
Parametri | Ilmentymiä | Kuvaus | Esimerkki |
method | 1 | add tai edit | add |
id | 0..1 | Jos method on edit, tarvitaan muokattavan tuotteen id | 123 |
Mikäli metodia ei ole annettu tai päivitettävää tuotetta ei löydy järjestelmästä, palautetaan INVALID_DATA –virhe selitteineen. Päivitettävän tuotteen id:n saa tietoon kysymällä ensin tuotelistaa.
Tuotteen tiedot voidaan esittää tarkasti uusien paino-kenttien avulla (productnetweight, productgrossweigh ja productweightunit), suositellaan ettei vanhaa tuotteen paino-kenttää enää käytettäisi (unitweight). Kenttää on mahdollista käyttää edelleen taaksepäin yhteensopivuuden takaamiseksi, mutta käyttöliittymässä kaikki olemassa olevien tuotteiden painoyksiköt muuttuvat kiloiksi (kg) ja ilmaistaan nettopaino-kentässä.
Tuotavat tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena xml:nä (POST-data):
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 | ||
1 | product | Aggregaatti | 1 | ||
2 | productbaseinformation | Aggregaatti | 1 | ||
3 | productcode | Merkkijono, max 50 merkkiä | 0...1 | Tuotekoodi | CC |
3 | productgroup | Merkkijono | 1 | Tuoteryhmän nimi, tuote lisätään ryhmään mikäli tuoteryhmä löytyy järjestelmästä. Jos ei löydy, se perustetaan | Kirjat |
3 | name | Merkkijono, max 200 merkkiä | 1 | Tuotteen nimi | Code Complete |
3 | description | Merkkijono | 0...1 | Kuvaus | Toinen painos |
3 | unitprice | Numeerinen | 1 | Tuotteen yksikköhinta | 42,5 |
Attr. | type | Merkkijono | 1 | Kertoo onko annettu hinta verollinen (gross) vai veroton (net). | net |
3 | unit | Merkkijono, max 50 merkkiä | 0...1 | Tuotteen yksikkö, jos annettua yksikkö ei löydy järjestelmästä se perustetaan. Jos löytyy, käytetään olemassa olevaa. | kpl |
3 | unitweight | Merkkijono | 0...1 | Tuotteen yksikköpaino kahdella desimaalilla. Suositellaan ettei tätä painokenttää (unitweight) enää käytettäisi, vaan käytettäisiin uusia painokenttiä (productnetweight, productgrossweigh ja productweightunit) | 1,00 |
3 | purchaseprice | Numeerinen | 0...1 | Hankintahinta | 25 |
3 | tariffheading | Merkkijono | 0...1 | Tullinimike | Code complete |
3 | comissionpercentage | Numeerinen | 0...1 | Provisioprosentti | 11 |
3 | isactive | Numeerinen | 1 | Onko tuote aktiivinen, 0 = ei-aktiivinen / 1 = aktiivinen | 1 |
3 | issalesproduct | Numeerinen | 1 | Onko tuote myyntituote, 0 = ei / 1 = kyllä | 0 |
3 | inventoryenabled | Numeerinen | 0...1 | Onko tuote varastoitava, 0 = ei / 1 = kyllä | 1 |
3 | inventorybatchlinkingmode | Numeerinen | 0...1 | Eräkäsittelytyyppi. Sallitut arvot: Ei eräkäsittelyä = 1 Manuaalinen erävalinta = 2 Toimituspäivän mukaan nuorimmat ensin = 3 Toimituspäivän mukaan vanhimmat ensin = 4 (FIFO) Viimeisen käyttöpäivän mukaan uusimmat ensin = 5 Viimeisen käyttöpäivän mukaan vanhimmat ensin = 6 Valmistuspäiväyksen mukaan uusimmat ensin = 7 Valmistuspäiväyksen mukaan vanhimmat ensin = 8 | 4 |
3 | countryoforigin | Merkkijono | 0...1 | Alkuperämaa | FI |
Attr. | type | Merkkijono | 0...1 | Aina ISO-3166 | ISO-3166 |
3 | primaryeancode | Merkkijono | 0...1 | Tuotteen ensisijainen EAN-koodi | 123456789012 |
Attr. | type | Merkkijono | 0...1 | EAN-koodin tyyppi. Rajapinta tarkistaa EAN-koodin muodon tyypin mukaan. any, ean8, ean13, code128. | ean13 |
3 | secondaryeancode | Merkkijono | 0...1 | Tuotteen toissijainen EAN-koodi | 12345689012 |
Attr | type | Merkkijono | EAN-koodin tyyppi. Rajapinta tarkistaa EAN-koodin muodon tyypin mukaan. any, ean8, ean13, code128. | ean13 | |
3 | inventoryalertlimit | Numeerinen | 0...1 | Hälytysraja | 20,50 |
2 | productbookkeepingdetails | Aggregaatti | 0...1 | ||
3 | defaultvatpercentage | Numeerinen | 1 | Alv-kanta, jos annettua verokantaa ei löydy järjestelmästä palautetaan virhe | 24 |
3 | defaultdomesticaccountnumber | Numeerinen | 0...1 | Kotimaan myyntitili | 3000 |
3 | defaulteuaccountnumber | Numeerinen | 0...1 | EU-myyntitili | 3360 |
3 | defaultoutsideeuaccountnumber | Numeerinen | 0...1 | Yhteisön ulkopuolisen myynnnin tili | 3380 |
2 | productadditionalinformation | Aggregaatti | 0...1 | ||
3 | productnetweight | Numeerinen | 0...1 | Nettopaino | 11,2 |
3 | productgrossweight | Numeerinen | 0...1 | Bruttopaino | 12,6 |
3 | productweightunit | Merkkijono | 0...1 | Netto- ja bruttopainon yksikkö: g, kg tai tn | kg |
3 | dimension | Aggregaatti | 0...1 | ||
4 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikon nimi. Luodaan tarvittaessa. | Project |
4 | dimensionitem | Merkkijono | 1 | Laskentakohde. Luodaan tarvittaessa. | Project 1 |
3 | productpackageinformation | Aggregaatti | 0...1 | ||
4 | packagewidth | Numeerinen | 1 | Pakkauksen leveys senttimetreinä | 7,3 |
4 | packageheight | Numeerinen | 1 | Pakkauksen korkeus senttimetreinä | 15,0 |
4 | packagelength | Numeerinen | 1 | Pakkauksen pituus senttimetreinä | 36,1 |
2 | productcustomtags | Aggregaatti | 0..1 | ||
3 | productcustomtag | Aggregaatti | 1...n | ||
4 | tagname | Merkkijono | 1 | Lisätietokentän nimi. | Pvm kenttä |
4 | tagvalue | Merkkijono | 1 | Lisätietokentän arvo. | 2022-01-01 |
Attr. | datatype | Merkkijono | 1 | Lisätietokentän tyyppi. date, text, decimal tai enum | date |
Rakenteellisen tuotelistan nouto
Resurssi: webshopproductlist.nv
Tässä on kuvattu kuinka rakenteellinen tuotelista voidaan noutaa ja tätä voi käyttää ainoastaan ne kenellä on käytössä laajennettu tuotehallinta. Listaus sisältää tietoja tuotteesta kuten nimen ja kuvauksen eri kielillä sekä tietoa tuotteen varianteista. Resurssi palauttaa päätuotteen alle listatut mallit/ominaisuudet (ei alituotteita).
Kutsussa käytettävät parametrit:
Parametri | Ilmentymiä | Kuvaus | Esimerkki |
limitDeleted | 0...1 | Kun määritelty, vain aktiiviset päätuotteet sisältyvät tulokseen | 1 |
limitActive | 0...1 | Kun määritelty, vain aktiiviset variantit sisältyvät tulokseen | 1 |
limitPublished | 0...1 | Kun määritelty, vain julkaistut tuotteet sisältyvät tulokseen | 1 |
limitSellable | 0...1 | Kun määritelty, vain myytävissä olevat tuotteet sisältyvät tulokseen | 1 |
limitChangedSince | 0...1 | Suodattaa tuotteet, joissa muutoksia annetun päivämäärän ja/tai kellonajan jälkeen. Annetaan muodossa yyyy-MM-ddTHH:mm:ss | 2016-01-28T 12:00:00 |
limitSourceProductNetvisorKey | 0...1 | Tuotteen Netvisor ID:llä rajataan tulosten määrää | 154 |
productGroupNetvisorKeys | 0...1 | Tuoteryhmän Netvisor ID:llä rajataan tulosten määrää | 123 |
productGroupName | 0...1 | Noudettavien tuotteiden tuoteryhmän nimi | Tuoteryhmä 1 |
productGroupNameKeyword | 0...1 | Noudettavien tuotteiden tuoteryhmän nimen alkuosa | Esimerkkituoteryhmä |
productGroupNameFreeText | 0...1 | Noudettavien tuotteiden tyoteryhmän nimi sisältää annetun parametrin | Tuoteryhmä |
excludeProductGroupNameFreeText | 0...1 | Poisrajattavan tuoteryhmän nimi sisältää annetun parametrin | Tuoteryhmä |
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | Root | Aggregaatti | 1 | ||
1 | WebShopProductList | Aggregaatti | 1 | ||
2 | WebShopProduct | Aggregaatti | 0...n | ||
3 | NetvisorKey | Numeerinen | 1 | Tuotteen Netvisor-id | 145 |
3 | Name | Merkkijono | 1...3 | Tuotteen nimi | Tuote |
Attr. | language | Merkkijono | Nimen kieli: FI, EN tai SE | FI | |
3 | Description | Merkkijono | 1...3 | Tuotteen kuvaus | Tämä on tuote |
Attr. | language | Merkkijono | Kuvauksen kieli: FI, EN tai SE | FI | |
3 | ProductCode | Merkkijono | 1 | Tuotekoodi | A123 |
3 | ProductGroup | Aggregaatti | 0...n | ||
4 | Name | Merkkijono | 1...3 | Tuoteryhmän nimi | Ryhmä 1 |
Attr. | language | Merkkijono | Tuoteryhmän nimen kieli: FI, EN tai SE | FI | |
3 | UnitNetPrice | Numeerinen | 1 | Tuotteen yksikköhinta | 12,00 |
3 | UnitGrossPrice | Numeerinen | 1 | Tuotteen verollinen hinta. Huomioithan, jos tuote on perustettu Netvisoriin nettohinnalla, palautetaan bruttohinta tällöin 0,00 hinnalla. | 14,6 |
3 | Unit | Merkkijono | 1 | Tuotteen mittayksikkö | kpl |
3 | UnitWeight | Numeerinen | 1 | Tuotteen paino | 1,50 |
3 | ImageURI | Teksti | 1 | URI tuotteen kuvalle | /webshopproductimages.nv? identifier=165 |
3 | URI | Teksti | 1 | URI tuotteen tiedoille | /getproduct.nv?id=165 |
3 | InventoryAmount | Numeerinen | 1 | Tuotteiden määrä varastossa | 30,0 |
3 | InventoryOrderedAmount | Numeerinen | 1 | Tilattujen tuotteiden määrä | 1,0 |
3 | InventoryReservedAmount | Numeerinen | 1 | Varattujen tuotteiden määrä | 3,00 |
3 | IsActive | Numeerinen | 1 | Onko tuote aktiivinen: 0 = ei / 1 = kyllä | 1 |
3 | IsSalesProduct | Numeerinen | 1 | Onko tuote myynnissä: 0 = ei / 1 = kyllä | 1 |
3 | IsStorageProduct | Numeerinen | 1 | Onko tuote varastossa: 0 = ei / 1 = kyllä | 1 |
3 | DefaultVatPercentage | Numeerinen | 1 | ALV-luokka | 22 |
3 | IsPublished | Numeerinen | 1 | Onko tuote julkaistu: 0 = ei / 1 = kyllä | 1 |
3 | VersionNumber | Numeerinen | 1 | Tuotteen versionumero | |
3 | PrimaryEANCode | Numeerinen | 1 | Tuotteen ensisijainen EAN-koodi | 978020137962 |
3 | SecondaryEANCode | Numeerinen | 1 | Tuotteen toissijainen EAN-koodi | 978020137963 |
3 | PriceGroups | Aggregaatti | 0...1 | ||
4 | PriceGroup | Aggregaatti | 1...n | ||
5 | Description | Merkkijono | 1 | Hintaryhmän kuvaus | CA1 |
5 | Value | Numeerinen | 1 | Hintaryhmän arvo | 1,5 |
Attr. | type | Merkkijono | 1 | Arvon tyyppi, joko multiplier tai fixed | multiplier |
3 | Variants | Aggregaatti | 1 | ||
4 | Variant | Aggregaatti | 0...n | ||
5 | Name | Merkkijono | 1...3 | Variantin nimi | Paita, punainen |
Attr. | language | Merkkijono | Variantin nimen kieli FI, EN tai SE | FI | |
5 | Description | Merkkijono | 1...3 | Variantin kuvaus | Punainen paita |
Attr. | language | Merkkijono | Variantin kuvauksen kieli: FI, EN tai SE | FI | |
5 | VariantIdentifier | Merkkijono | 1 | Variantin Netvisor tunniste | ABC002 |
5 | ImageUri | Merkkijono | 1 | Uri variantin kuvalle | /webshopproductimages.nv? identifier=165 |
5 | LastchangeDate | Päivämäärä | 1 | Edellisen muutoksen aikaleima | 30.1.2014 10:12:06 |
5 | UnitNetPrice | Numeerinen | 1 | Variantin veroton hinta | 1,00 |
5 | UnitGrossPrice | Numeerinen | 1 | Variantin verollinen hinta | 1,22 |
5 | InventoryAmount | Numeerinen | 1 | Variantin määrä varastossa | 12,00 |
5 | InventoryOrderedAmount | Numeerinen | 1 | Varastoon tilattu määrä | 12,00 |
5 | InventoryReservedAmount | Numeerinen | 1 | Varastosta varattu määrä | 12,00 |
5 | PrimaryEANCode | Numeerinen | 1 | Tuotteen ensisijainen EAN-koodi | 978020137962 |
5 | SecondaryEANCode | Numeerinen | 1 | Tuotteen toissijainen EAN-koodi | 978020137963 |
5 | PriceGroups | Aggregaatti | 0...1 | ||
6 | PriceGroup | Aggregaatti | 1...n | ||
7 | Description | Teksti | 1 | Variantin hintaryhmän kuvaus | |
7 | Value | Numeerinen | 1 | Hintaryhmän arvo | |
Attr. | type | Teksti | 1 | Arvon tyyppi multiplier | multiplier |
5 | VariantProperties | Aggregaatti | 0...n | ||
6 | VariantProperty | Merkkijono | 1 | Tuotteen ominaisuus | Materiaali |
6 | VariantPropertyValue | Merkkijono | 1 | Tuotteen ominaisuuden arvo | Puuvilla |
3 | CustomTag | Aggregaatti | 0...n | Tuotteen lisätietokenttä | |
4 | CustomTagName | Merkkijono | 1 | Lisätietokentän nimi | Lisätietokenttä |
4 | CustomTagValue | Merkkijono | 1 | Lisätietokentän arvo | Kenttä 1 |
Rakenteellisten tuotteiden tuotekuvien nouto
Resurssi: webshopproductimages.nv
Hakee tuotteen ensimmäisen kuvan. Jos tuotteella on variantteja, resurssi palauttaa variantin kaikki kuvat.
Kutsussa käytettävät parametrit:
Parametri | Ilmentymiä | Kuvaus | Esimerkki |
identifier | 1 | Tuoteen Netvisor-id jonka kuvat halutaan hakea | 123 |
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 | ||
1 | WebShopProductImages | Aggregaatti | 1 | ||
2 | WebShopProductImage | Aggregaatti | 0...n | ||
3 | MimeType | Merkkijono | 1 | Kuvan MIME-tyyppi | image/jpg |
3 | Title | Merkkijono | 1 | Kuvan otsikko | Image |
3 | FileName | Merkkijono | 1 | Kuvan alkuperäinen tiedostonimi | image.jpg |
3 | DocumentData | Merkkijono | 1 | Kuvan data Base64-enkoodattuna |
Tuotesaldojen nouto varastoittain
Resurssi: inventorybywarehouse.nv
InventoryByWarehouse.nv-resurssin avulla voidaan noutaa Netvisorin rajapinnan kautta tuotteiden saldot varastokohtaisesti. Mikäli tarvitaan tarkempia tietoja tuotteista, ne voidaan noutaa käyttäen toimintoa Tuotetietojen nouto.
Netvisorin varastonhallintaan liittyviä ohjeita löydät täältä.
Pyynnössä käytettävät parametrit, joilla voidaan rajata tulosjoukkoa. Parametri välitetään QueryStringissä.
Parametrin nimi | Ilmentymiä | Kuvaus | Esimerkki |
productid | 0...1 | Rajaus tietyllä tuote-id:llä (NetvisorKey) | 123 |
productidlist | 0...1 | Rajaus annetuilla tuote-id:illä (NetvisorKey), erottimena pilkku | 123,456,235 |
inventoryplaceid | 0...1 | Rajaus annetulla varasto-id:llä | 321 |
inventoryplacename | 0...1 | Rajaus annetulla varaston nimellä | varasto5 |
limitvendorid | 0...1 | Rajaus annetulla toimittaja-id:llä | 105 |
changedsince | 0...1 | Rajaus annetun ajankohdan jälkeen tapahtuneiden muutosten mukaan | 1.5.2014 12:00:00 |
limitunderalertlimit | 0...1 | 1 = palautetaan vain hälytysrajan alittaneet tuotteet | 1 |
productgroupname | 0...1 | Rajaus tuoteryhmällä | esimerkkituotteet |
Esimerkki pyynnöstä: http://isvapi.netvisor.fi/InventoryByWarehouse.nv?inventoryplaceid=321&limitunderalertlimit=1 (noudetaan kaikki hälytysrajan alittaneet tuotteet varastosta, jonka id on 321).
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | Root | Aggregaatti | 1 | ||
1 | InventoryByWarehouse | Aggregaatti | 1 | ||
2 | Product | Aggregaatti | 0...n | ||
3 | NetvisorKey | Numeerinen | 1 | Tuotteen Netvisor id. Voidaan käyttää myöhemmin esimerkiksi tuotteen kaikkien tietojen hakuun tai tuotteen linkittämiseen laskulle | 165 |
3 | Name | Merkkijono | 1 | Tuotenimike | Testituote |
3 | Code | Merkkijono | 1 | Tuotekoodi | TT |
3 | GroupName | Merkkijono | 1 | Tuotteen tuoteryhmä tekstinä | Kampanjatuotteet |
3 | ProductUri | Merkkijono | 1 | URI, josta voi hakea rajapinnan läpi tuotteen täydelliset tiedot | /getproduct.nv?id=165 |
3 | Warehouse | Aggregaatti | |||
4 | NetvisorKey | Numeerinen | 1 | Varaston tietokanta-id Netvisorissa | 12 |
4 | Name | Merkkijono | 1 | Varaston nimi | Päävarasto |
4 | ReservedAmount | Numeerinen | 1 | Varattu kyseisestä varastosta (varattu) | 10,00 |
4 | OrderedAmount | Numeerinen | 1 | Tilattu kyseiseen varastoon (tulossa) | 15,00 |
4 | InventoryAmount | Numeerinen | 1 | Tuotteen avoin varastosaldo kyseisessä varastossa (ei sisällä saldoja varattu tai tulossa) | 34,00 |
3 | TotalReservedAmount | Numeerinen | 1 | Tuotteen varattu-saldo mukaan lukien kaikki varastot | 524,00 |
3 | TotalOrderedAmount | Numeerinen | 1 | Tuotteen tulossa-saldo mukaan lukien kaikki varastot | 125,00 |
3 | TotalAmount | Numeerinen | 1 | Tuotteen varastoissa-saldo mukaan lukien kaikki varastot (ei sisällä saldoja varattu tai tulossa) | 647,00 |
Varastojen nouto
Resurssi: getinventoryplaces.nv
InventoryPlaces.nv-resurssin avulla voidaan noutaa Netvisorin rajapinnan kautta varastojen tiedot.
Pyynnössä käytettävät parametrit, joilla voidaan rajata tulosjoukkoa:
Parametrin nimi | Ilmentymiä | Kuvaus | Esimerkki |
inventoryplacelocationfreetext | 0...1 | Varaston paikan nimi sisältää annetun parametrin | Esimerkkipaikka |
inventoryplacedescriptionfreetext | 0...1 | Varaston kuvaus sisältää annetun parametrin | Esimerkkikuvaus |
inventoryplacenetvisorkeys | 0...1 | Rajaus annetuilla varasto-id:illä (NetvisorKey), erottimena pilkku | 321 |
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | Root | Aggregaatti | 1 | ||
1 | InventoryPlaces | Aggregaatti | 1 | ||
2 | InventoryPlace | Aggregaatti | 0...n | ||
3 | NetvisorKey | Numeerinen | 1 | Varaston Netvisor-ID | 165 |
3 | InventoryPlaceName | Merkkijono | 1 | Varaston kuvaus, varaston paikka | Esimerkkikuvaus, Esimerkkipaikka |
3 | InventoryPlaceEmailAddress | Merkkijono | 1 | Varaston sähköpostiosoite | example@example.com |
3 | InventoryPlaceShelves | Aggregaatti | 1 | ||
4 | InventoryPlaceShelve | Aggregaatti | 0...n | ||
5 | NetvisorKey | Numeerinen | 1 | Varaston hyllypaikan tietokanta-id Netvisorissa | 12 |
5 | ShelveName | Merkkijono | 1 | Varaston hyllypaikan nimi | Esimerkkihylly |
5 | ShelveHierarchy | Aggregaatti | 1 | ||
6 | ShelveHierarchyName | Numeerinen | 0...1 | Varaston hyllypaikan koko hierarkia | Esimerkkihylly / Hylly1 |
Varastotapahtuman tuonti
Resurssi: warehouseevent.nv
WarehouseEvent.nv-resurssin avulla voidaan tuoda Netvisoriin yksittäinen varastotapahtuma.
Netvisorin varastonhallintaan liittyviä ohjeita löydät täältä.
Tuotavat tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena XML:nä (POST-data):
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | 1 | |||
1 | warehouseevent | 1 | |||
2 | description | Merkkijono | 0...1 | Varastotapahtuman kuvausteksti | Testitapahtuma |
2 | reference | Merkkijono | 1 | Varastotapahtuman viite | 1070 |
2 | deliverymethod | Merkkijono | 0...1 | Toimitustapa, toimitustapoja hallitaan Netvisorissa, tuotavan rivin täytyy täsmätä Netvisorissa olevan toimitustavan kanssa | Noudetaan |
2 | distributer | Merkkijono | 0...1 | Toimittajan koodi tai nimi | 1234 |
Attr. | type | Merkkijono | 0...1 | Toimittajan tunnisteen tyyppi: - netvisor = NetvisorKey - customer = Toimittajan nimi | netvisor |
2 | warehouseeventlines | 1 | |||
3 | warehouseeventline | 1...n | |||
4 | eventtype | Merkkijono | 1 | Varastotapahtuman tyyppi, tyyppejä hallitaan Netvisorissa, tuotavan rivin täytyy täsmätä Netvisorissa olevan tyypin kanssa.
| Myynti |
Attr. | type | Merkkijono | 0...1 | Tapahtuman tyypitys: toistaiseksi aina customer | customer |
4 | product | Merkkijono | 1 | Tuotteen tunniste, Netvisor avain tai tuotekoodi | 32154 |
Attr. | type | Merkkijono | 0...1 | Tunnisteen tyyppi: - netvisor = NetvisorKey - customer = tuotteen koodi | netvisor |
4 | inventoryplace | Merkkijono | 0...1 | Varaston nimi, varastoja hallitaan Netvisorissa, tuotavan rivin täytyy täsmätä Netvisorissa olevan varaston kuvaus kentän kanssa. Voidaan kohdistaa myös varaston NetvisorKey:n perusteella kun attribuutille type annetaan arvo netvisor. | Päävarasto |
Attr. | type | Merkkijono | 0...1 | Tunnisteen tyyppi: - netvisor = NetvisorKey | netvisor |
4 | description | Merkkijono | 0...1 | Varastotapahtumarivin kuvaus | Testitapahtuman ensimmäinen rivi |
4 | quantity | Numeerinen | 1 | Tuotteiden kappalemäärä | 12 |
4 | unitprice | Numeerinen | 1 | Tuotteen yksikköhinta verottomana | 100,00 |
4 | valuedate | Päivämäärä | 1 | Varastotapahtuman päiväys | 2014-05-13 |
Attr. | format | Merkkijono | 1 | Päiväyksen tyyppi, aina ansi | ansi |
4 | status | Merkkijono | Merkkijono | Varastotapahtuman tila: open - avoin (näkyy tilauksissa) handled - käsitelty (näkyy varstossa) bypassed - ohitettu | open |
Varastoraporttien nouto
Resurssi: warehousereport.nv
Resurssi palauttaa erilaisia varastoraportteja perustuen kutsussa käytettäviin parametreihin.
Kutsussa käytettävät parametrit:
Parametri | Ilmentymiä | Kuvaus | Esimerkki |
report | 1 | Mikä raportti: productinventoryamounts salesinventoryevents purchaseorderinventoryevents | salesinventoryevents |
Salesinventoryevents
Kun parametrin report arvoksi annetaan salesinventoryevents, niin kutsun rajauksessa voidaan käyttää lisäksi seuraavia parametreja:
Parametri | Ilmentymiä | Kuvaus | Esimerkki |
page | 0...1 | Haettava sivu, oletuksena 1 | 1 |
salesentitiesonpage | 0...1 | Myynnin entiteettien määrä per sivu, oletuksena 50000 | 50000 |
salesentitytype | 1 | Pakollinen. Myynnin entiteettien tyyppi: salesorder tai salesinvoice | salesorder |
salesentitystatuses | 0...1 | Jos parametria ei anneta, käytetään oletusarvoja undelivered tai open. Parametreja voi antaa useamman erottaen ne pilkulla. Tilauksen tila: delivered - toimitettu undelivered - toimittamaton (oletus) Laskun tila: open - avoin (oletus) unsent - lähettämätön paid - maksettu requested - muistutettu collected - perinnässä | delivered |
salesentitiesnetvisorkeys | 0...1 | Tilauksen NetvisorKey:t / Laskujen NetvisorKey:t | 158 |
customernetvisorkeys | 0...1 | Asiakkaiden NetvisorKey:t | 47 |
Vastaussanoman rakenne, kun salesentitytype="salesorder":
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | 1 | |||
1 | InventoryReport | Aggregaatti | 1 | ||
Attr. | Report | Merkkijono | 1 | Varastoraportin tyyppi | SalesInvetoryEvents |
Attr. | TimeStamp | Aikaleima | 1 | Päivämäärä ja aika | 2021-10-26 10:49 |
2 | SalesEntities | Aggregaatti | 1 | ||
Attr. | CurrentPage | Numeerinen | 1 | Nykyinen sivu | 1 |
Attr. | PageCount | Numeerinen | 1 | Sivumäärä | 1 |
Attr. | SalesEntitiesOnPage | Numeerinen | 1 | Myynnin entiteettien määrä per sivu | 50000 |
Attr. | SalesEntitiesOnPages | Numeerinen | 1 | Myynnin entiteettejä sivuilla | 1 |
3 | SalesEntity | Aggregaatti | 1...n | ||
Attr. | Type | Merkkijono | 1 | Myynnin entiteetin tyyppi | salesorder |
4 | NetvisorKey | Numeerinen | 1 | Myyntitilauksen Netvisor-id | 41 |
4 | OrderNumber | Numeerinen | 1 | Myyntitilauksen numero | 123456 |
4 | OrderState | Merkkijono | 1 | Myyntitilauksen tila | undelivered |
4 | Customer | Aggregaatti | 1 | ||
5 | NetvisorKey | Numeerinen | 1 | Asiakkaan Netvisor-id | 89 |
5 | CustomerName | Merkkijono | 1 | Asiakkaan nimi | Esimerkkiasiakas |
4 | SalesEntityProductLines | Aggregaatti | 1 | ||
5 | SalesEntityProductLine | Aggregaatti | 1...n | ||
6 | NetvisorKey | Numeerinen | 1 | Tuoterivin Netvisor-id | 5 |
6 | OrderedAmount | Numeerinen | 1 | Tilattujen tuotteiden määrä rivillä | 10 |
6 | InventoryEvents | Aggregaatti | 1 | ||
7 | InventoryEvent | Aggregaatti | 1...n | ||
Attr. | Context | Merkkijono | 1 | Varastotapahtuman konteksti | salesorder |
8 | NetvisorKey | Numeerinen | 1 | Varastotapahtuman Netvisor-id | 876 |
8 | EventType | Aggregaatti | 1 | ||
9 | NetvisorKey | Numeerinen | 1 | Varastotapahtuman tyypin Netvisor-id | 1 |
9 | EventTypeDescription | Merkkijono | 1 | Varastotapahtuman tyypin kuvaus | Myynti |
8 | EventStatus | Merkkijono | 1 | Varastotapahtuman tila | open |
8 | EventDate | Päivämäärä | 1 | Varastotapahtuman päiväys | 2021-03-16 |
8 | DeliveryDate | Päivämäärä | 1 | Toimituspäivä | 2021-03-16 |
8 | Product | Aggregaatti | 1 | ||
9 | NetvisorKey | Numeerinen | 1 | Tuotteen Netvisor-id | 74 |
9 | ProductCodes | Aggregaatti | 1 | ||
10 | ProductCode | Merkkijono | 1 | Tuotekoodi | 1234 |
10 | ProductsPrimaryEanCode | Numeerinen | 1 | Tuotteen ensisijainen EAN-koodi | 123456789012 |
10 | ProductsSecondaryEanCode | Numeerinen | 1 | Tuotteen toissijainen EAN-koodi | 123456789012 |
9 | ProductNameTranslations | Aggregaatti | 1 | ||
10 | Translation | Merkkijono | 1...3 | Tuotteen nimi | Esimerkkituote |
Attr. | Language | Merkkijono | 1 | Tuotteen nimen kieli | FI |
9 | ProductUnit | Aggregaatti | 1 | ||
10 | NetvisorKey | Numeerinen | 1 | Tuoteyksikön Netvisor-id | 3 |
10 | ProductUnitTranslations | Aggregaatti | 1 | ||
11 | Translation | Merkkijono | 1...3 | Tuoteyksikkö | kpl |
Attr. | Language | Merkkijono | 1 | Tuoteyksikön kieli | FI |
8 | InventoryPlace | Aggregaatti | 1 | ||
9 | NetvisorKey | Numeerinen | 1 | Varaston Netvisor-id | 3 |
9 | InventoryPlaceName | Merkkijono | 1 | Varaston kuvaus, varaston paikka | Varasto-kuvaus, Varasto-paikka |
9 | InventoryPlaceShelve | Aggregaatti | 1 | ||
10 | NetvisorKey | Numeerinen | 0...1 | Varaston hyllypaikan Netvisor-id | 5 |
10 | InventoryPlaceShelveName | Merkkijono | 0...1 | Varaston hyllypaikka | Esimerkkihylly |
8 | Amount | Numeerinen | 1 | Tuotteen määrä | -564 |
8 | UnitPrice | Numeerinen | 1 | Tuotteen yksikköhinta | 9,7 |
Attr. | PurchasePrice | Numeerinen | 1 | Tuotteen ostohinta | 9,7 |
Attr. | FreightRate | Numeerinen | 1 | Tuotteen rahtikustannus | 0 |
8 | Description | Merkkijono | 1 | Varastotapahtuman kuvaus | Esimerkkikuvaus |
8 | BatchInformation | Aggregaatti | 1 | ||
9 | BatchNumber | Numeerinen | 1 | Eränumero | 13 |
9 | ManufactureDate | Päivämäärä | 1 | Valmistuspäivä | 2021-09-23 |
9 | PackagingDate | Päivämäärä | 1 | Pakkauspäivä | 2021-09-23 |
9 | BestBeforeDate | Päivämäärä | 1 | Parasta ennen päiväys | 2021-09-23 |
9 | UseByDate | Päivämäärä | 1 | Viimeinen käyttöpäivä | 2021-09-23 |
8 | ShipmentInformation | Aggregaatti | 1 | ||
9 | CountryOfOrigin | Merkkijono | 1 | Alkuperämaa | FI |
Attr. | Type | Merkkijono | 1 | Aina ISO-3166 | ISO-3166 |
9 | NetWeight | Numeerinen | 1 | Nettopaino | 11,5 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | mg |
9 | GrossWeight | Numeerinen | 1 | Bruttopaino | 10 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | mg |
9 | PackageWidth | Numeerinen | 1 | Pakkauksen leveys | 12,5 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | cm |
9 | PackageHeight | Numeerinen | 1 | Pakkauksen korkeus | 4,6 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | cm |
9 | PackageLength | Numeerinen | 1 | Pakkauksen pituus | 7,9 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | cm |
8 | EventLinks | Aggregaatti | 1 | ||
9 | TargetInventoryEvent | Aggregaatti | 0...1 | ||
Attr. | Context | Merkkijono | 0...1 | Linkitetyn varastotapahtuman konteksti | manualpurchaseevents |
Attr. | ContextNetvisorKey | Numeerinen | 0...1 | Kontekstin Netvisor-id | 4 |
10 | NetvisorKey | Numeerinen | 0...1 | Linkitetyn varastotapahtuman Netvisor-id | 2140 |
10 | EventType | Aggregaatti | 0...1 | ||
11 | NetvisorKey | Numeerinen | 0...1 | Linkitetyn varastotapahtumatyypin Netvisor-id | 2 |
11 | EventTypeDescription | Merkkijono | 0...1 | Linkitetyn varastotapahtumatyypin kuvaus | Hankinta |
10 | EventStatus | Merkkijono | 0...1 | Linkitetyn varastotapahtuman tila | handled |
10 | DeliveryDate | Päivämäärä | 0...1 | Toimitus-/saapumispäivä | 2021-11-06 |
10 | Amount | Numeerinen | 0...1 | Määrä | 1968 |
10 | UnitPrice | Numeerinen | 0...1 | Yksikköhinta | 9,7 |
10 | AmountLeft | Numeerinen | 0...1 | Tilanne/Määrä | 1210 |
Vastaussanoman rakenne, kun salesentitytype="salesinvoice":
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | 1 | |||
1 | InventoryReport | Aggregaatti | 1 | ||
Attr. | Report | Merkkijono | 1 | Varastoraportin tyyppi | SalesInvetoryEvents |
Attr. | TimeStamp | Aikaleima | 1 | Päivämäärä ja aika | 2021-10-26 10:49 |
2 | SalesEntities | Aggregaatti | 1 | ||
Attr. | CurrentPage | Numeerinen | 1 | Nykyinen sivu | 1 |
Attr. | PageCount | Numeerinen | 1 | Sivumäärä | 1 |
Attr. | SalesEntitiesOnPage | Numeerinen | 1 | Myynnin entiteettien määrä per sivu | 50000 |
Attr. | SalesEntitiesOnPages | Numeerinen | 1 | Myynnin entiteettejä sivuilla | 1 |
3 | SalesEntity | Aggregaatti | 1...n | ||
Attr. | Type | Merkkijono | 1 | Myynnin entiteetin tyyppi | salesinvoice |
4 | NetvisorKey | Numeerinen | 1 | Myyntilaskun Netvisor-id | 41 |
4 | InvoiceNumber | Numeerinen | 1 | Myyntilaskun numero | 123456 |
4 | InvoiceState | Merkkijono | 1 | Myyntilaskun tila | unsent |
4 | Customer | Aggregaatti | 1 | ||
5 | NetvisorKey | Numeerinen | 1 | Asiakkaan Netvisor-id | 89 |
5 | CustomerName | Merkkijono | 1 | Asiakkaan nimi | Esimerkkiasiakas |
4 | SalesEntityProductLines | Aggregaatti | 1 | ||
5 | SalesEntityProductLine | Aggregaatti | 1...n | ||
6 | NetvisorKey | Numeerinen | 1 | Tuoterivin Netvisor-id | 5 |
6 | InvoiceAmount | Numeerinen | 1 | Tuotteen määrä rivillä | 10 |
6 | InventoryEvents | Aggregaatti | 1 | ||
7 | InventoryEvent | Aggregaatti | 1...n | ||
Attr. | Context | Merkkijono | 1 | Varastotapahtuman konteksti | salesinvoice |
8 | NetvisorKey | Numeerinen | 1 | Varastotapahtuman Netvisor-id | 876 |
8 | EventType | Aggregaatti | 1 | ||
9 | NetvisorKey | Numeerinen | 1 | Varastotapahtuman tyypin Netvisor-id | 1 |
9 | EventTypeDescription | Merkkijono | 1 | Varastotapahtuman tyypin kuvaus | Myynti |
8 | EventStatus | Merkkijono | 1 | Varastotapahtuman tila | handled |
8 | EventDate | Päivämäärä | 1 | Varastotapahtuman päiväys | 2021-03-16 |
8 | DeliveryDate | Päivämäärä | 1 | Toimituspäivä | 2021-03-16 |
8 | Product | Aggregaatti | 1 | ||
9 | NetvisorKey | Numeerinen | 1 | Tuotteen Netvisor-id | 74 |
9 | ProductCodes | Aggregaatti | 1 | ||
10 | ProductCode | Merkkijono | 1 | Tuotekoodi | 1234 |
10 | ProductsPrimaryEanCode | Numeerinen | 1 | Tuotteen ensisijainen EAN-koodi | 12345689012 |
10 | ProductsSecondaryEanCode | Numeerinen | 1 | Tuotteen toissijainen EAN-koodi | 12345789012 |
9 | ProductNameTranslations | Aggregaatti | 1 | ||
10 | Translation | Merkkijono | 1...3 | Tuotteen nimi | Esimerkkituote |
Attr. | Language | Merkkijono | 1 | Tuotteen nimen kieli | FI |
9 | ProductUnit | Aggregaatti | 1 | ||
10 | NetvisorKey | Numeerinen | 1 | Tuoteyksikön Netvisor-id | 3 |
10 | ProductUnitTranslations | Aggregaatti | 1 | ||
11 | Translation | Merkkijono | 1...3 | Tuoteyksikkö | kpl |
Attr. | Language | Merkkijono | 1 | Tuoteyksikön kieli | FI |
8 | InventoryPlace | Aggregaatti | 1 | ||
9 | NetvisorKey | Numeerinen | 1 | Varaston Netvisor-id | 3 |
9 | InventoryPlaceName | Merkkijono | 1 | Varaston kuvaus, varaston paikka | Varasto-kuvaus, Varasto-paikka |
9 | InventoryPlaceShelve | Aggregaatti | 1 | ||
10 | NetvisorKey | Numeerinen | 0...1 | Varaston hyllypaikan Netvisor-id | 1 |
10 | InventoryPlaceShelveName | Merkkijono | 0...1 | Varaston hyllypaikan nimi | Esimerkkihylly |
8 | Amount | Numeerinen | 1 | Tuotteen määrä | -564 |
8 | UnitPrice | Numeerinen | 1 | Tuotteen yksikköhinta | 9,7 |
Attr. | PurchasePrice | Numeerinen | 1 | Tuotteen ostohinta | 9,7 |
Attr. | FreightRate | Numeerinen | 1 | Tuotteen rahtikustannus | 0 |
8 | Description | Merkkijono | 1 | Varastotapahtuman kuvaus | Esimerkkikuvaus |
8 | BatchInformation | Aggregaatti | 1 | ||
9 | BatchNumber | Numeerinen | 1 | Eränumero | 13 |
9 | ManufactureDate | Päivämäärä | 1 | Valmistuspäivä | 2021-09-23 |
9 | PackagingDate | Päivämäärä | 1 | Pakkauspäivä | 2021-09-23 |
9 | BestBeforeDate | Päivämäärä | 1 | Parasta ennen päiväys | 2021-09-23 |
9 | UseByDate | Päivämäärä | 1 | Viimeinen käyttöpäivä | 2021-09-23 |
8 | ShipmentInformation | Aggregaatti | 1 | ||
9 | CountryOfOrigin | Merkkijono | 1 | Alkuperämaa | FI |
Attr. | Type | Merkkijono | 1 | Aina ISO-3166 | ISO-3166 |
9 | NetWeight | Numeerinen | 1 | Nettopaino | 11,5 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | mg |
9 | GrossWeight | Numeerinen | 1 | Bruttopaino | 10 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | mg |
9 | PackageWidth | Numeerinen | 1 | Pakkauksen leveys | 12,5 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | cm |
9 | PackageHeight | Numeerinen | 1 | Pakkauksen korkeus | 4,6 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | cm |
9 | PackageLength | Numeerinen | 1 | Pakkauksen pituus | 7,9 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | cm |
8 | EventLinks | Aggregaatti | 1 | ||
9 | TargetInventoryEvent | Aggregaatti | 0...1 | ||
Attr. | Context | Merkkijono | 0...1 | Linkitetyn varastotapahtuman konteksti | manualpurchaseevents |
Attr. | ContextNetvisorKey | Numeerinen | 0...1 | Kontekstin Netvisor-id | 169 |
10 | NetvisorKey | Numeerinen | 0...1 | Linkitetyn varastotapahtuman Netvisor-id | 2140 |
10 | EventType | Aggregaatti | 0...1 | ||
11 | NetvisorKey | Numeerinen | 0...1 | Linkitetyn varastotapahtumatyypin Netvisor-id | 2 |
11 | EventTypeDescription | Merkkijono | 0...1 | Linkitetyn varastotapahtumatyypin kuvaus | Hankinta |
10 | EventStatus | Merkkijono | 0...1 | Linkitetyn varastotapahtuman tila | handled |
10 | DeliveryDate | Päivämäärä | 0...1 | Toimitus-/saapumispäivä | 2021-11-06 |
10 | Amount | Numeerinen | 0...1 | Määrä | 1968,50 |
10 | UnitPrice | Numeerinen | 0...1 | Yksikköhinta | 9,7 |
10 | AmountLeft | Numeerinen | 0...1 | Tilanne/Määrä | 1210 |
Productinventoryamounts
Kun parametrin report arvoksi annetaan productinventoryamounts, niin kutsua voidaan rajata lisäksi seuraavilla parametreilla:
Parametri | Ilmentymiä | Kuvaus | Esimerkki |
page | 0...1 | Haettava sivu, oletuksena 1 | 1 |
productsonpage | 0...1 | Tuotteiden määrä per sivu, oletuksena 50000 | 50000 |
searchlanguage | 0...1 | Haun kieli, fi, se tai en | fi |
productnetvisorkeys | 0...1 | Haluttujen tuotteiden NetvisorKey:t | 123 |
productnamekeyword | 0...1 | Halutun tuotteen nimi | Esimerkkituote |
productcodekeyword | 0...1 | Halutun tuotteen tuotekoodi | 47 |
producteancode | 0...1 | Halutun tuotteen EAN-koodi (ensisijainen/toissijainen) | 123456789012 |
onlysellableproducts | 0...1 | Palautetaan vain myytävät tuotteet, true tai false | true |
productchangedsince | 0...1 | Suodattaa tuotteet, joissa muutoksia annetun päivämäärän ja/tai kellonajann jälkeen. Annetaan muodossa yyyy-MM-ddTHH:mm:ss | 2021-09-01T12:00:00 |
productgroupnetvisorkeys | 0...1 | Haluttujen tuoteryhmien NetvisorKey:t | 12 |
productgroupname | 0...1 | Halutun tuoteryhmän nimi (hierarkianimi) | Esimerkkituoteryhmä |
productgroupnamekeyword | 0...1 | Halutun tuoteryhmän hierarkianimen alkuosa | Esimerkki |
productgroupingcriterianame | 0...1 | Rajaus ryhmittelyperusteella | Esimerkkiryhmittelyperuste |
inventoryplacenetvisorkeys | 0...1 | Haluttujen varastojen NetvisorKey:t | 54 |
inventoryplacename | 0...1 | Halutun varaston nimi | Esimerkkivarasto |
inventoryplaceshelfnetvisorkeys | 0...1 | Haluttujen varaston hyllypaikkojen NetvisorKey:t | 4 |
inventoryplaceshelfname | 0...1 | Haluttu varaston hyllypaikka (hierarkianimi) | Esimerkkihyllypaikka |
inventoryeventstatuses | 0...1 | Rajataanko haku avoimiin vai käsiteltyihin varastotapahtumiin. Arvo open tai handled | handled |
Vastaus palauttaa tuotteiden varastotiedot. Saldot saa noudettua tuotteen, varaston ja hyllypaikan tarkkuudella.
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | 1 | |||
1 | InventoryReport | Aggregaatti | 1 | ||
Attr. | Report | Merkkijono | 1 | Varastoraportin tyyppi | ProductInventoryAmounts |
Attr. | TimeStamp | Aikaleima | 1 | Päivämäärä ja aika | 2021-10-26 10:49 |
2 | Products | Aggregaatti | 1 | ||
Attr. | CurrentPage | Numeerinen | 1 | Nykyinen sivu | 1 |
Attr. | PageCount | Numeerinen | 1 | Sivumäärä | 1 |
Attr. | ProductsOnPage | Numeerinen | 1 | Tuotteiden määrä per sivu | 50000 |
Attr. | ProductsOnPages | Numeerinen | 1 | Tuotteita sivuilla | 1 |
3 | Product | Aggregaatti | 1...n | ||
4 | NetvisorKey | Numeerinen | 1 | Tuotteen Netvisor-id | 41 |
4 | ProductCodes | Aggregaatti | 1 | ||
5 | ProductCode | Merkkijono | 1 | Tuotekoodi | Testituote4 |
5 | ProductPrimaryEanCode | Merkkijono | 1 | Ensisijainen EAN-koodi | T1-PRIMARY-EAN |
5 | ProductSecondaryEanCode | Merkkijono | 1 | Toissijainen EAN-koodi | T1-SECONDARY-EAN |
4 | ProductNameTranslations | Aggregaatti | 1 | ||
5 | Translation | Merkkijono | 1...3 | Tuotten nimi | Esimerkkituote |
Attr. | Language | Merkkijono | 1 | Tuotteen nimen kieli | FI |
4 | ProductUnit | Aggregaatti | 1 | ||
5 | NetvisorKey | Numeerinen | 1 | Tuoteyksikön Netvisor-id | |
5 | ProductUnitTranslations | Aggregaatti | 1 | ||
6 | Translation | Merkkijono | 1...3 | Tuoteyksikön nimi | kpl |
Attr. | Language | Merkkijono | 1 | Tuoteyksikön nimen kieli | FI |
4 | ProductInventoryStatus | Aggregaati | 1 | ||
5 | InventoryAmount | Numeerinen | 1 | Tuotteen avoin varastosaldo | 209,12 |
5 | OrderedAmount | Numeerinen | 1 | Tuotetta tilattu varastoon | 0 |
5 | ReservedAmount | Numeerinen | 1 | Tuotetta varattu varastosta | 0 |
4 | ProductInventoryPrices | Aggregaatti | 1 | ||
5 | AverageUnitPrice | Numeerinen | 1 | Tuotteen keskimääräinen yksikköhinta, lasketaan sanomalla palautettavien tietojen pohjalta | 12,32402 |
5 | MinimumUnitPrice | Numeerinen | 1 | Tuotteen minimi yksikköhinta | 0 |
5 | MaximumUnitPrice | Numeerinen | 1 | Tuotteen maksimi yksikköhinta | 15 |
4 | ProductInventoryValue | Aggregaatti | 1 | ||
5 | InventoryValue | Numeerinen | 1 | Varaston arvo | |
4 | InventoryPlaces | Aggregaatti | 1 | ||
5 | InventoryPlace | Aggregaatti | 1...n | ||
5 | NetvisorKey | Numeerinen | 1 | Varaston NetvisorKey | |
5 | InventoryPlaceName | Merkkijono | 1 | Varaston kuvaus ja paikka | Varasto-Kuvaus, Varasto-Paikka |
5 | InventoryPlaceStatus | Aggregaatti | 1 | ||
6 | InventoryAmount | Numeerinen | 1 | Tuotteen avoin varastosaldo kyseisessä varastossa | 119,00 |
6 | OrderedAmount | Numeerinen | 1 | Tuotetta tilattu kyseiseen varastoon | 0 |
6 | ReservedAmount | Numeerinen | 1 | Tuotetta varattu kyseisestä varastosta | 0 |
5 | InventoryPlacePrices | Aggregaatti | 1 | ||
6 | AverageUnitPrice | Numeerinen | 1 | Tuotteen keskimääräinen yksikköhinta varastossa, lasketaan sanomalla palautettavien tietojen pohjalta | 14,08403 |
6 | MinimumUnitPrice | Numeerinen | 1 | Tuotteen minimi yksikköhinta varastossa | 0 |
6 | MaximumUnitPrice | Numeerinen | 1 | Tuotteen maksimi yksikköhinta varastossa | 15 |
5 | InventoryPlaceShelves | Aggregaatti | 1 | ||
6 | InventoryPlaceShelve | Aggregaatti | 0...n | ||
7 | NetvisorKey | Numeerinen | 1 | Varaston hyllypaikan Netvisor-id | 4 |
7 | InventoryPlaceShelveName | Merkkijono | 1 | Varaston hyllypaikan nimi | Esimerkkihyllypaikka |
7 | InventoryPlaceShelveStatus | Aggregaatti | 1 | ||
8 | InventoryAmount | Numeerinen | 1 | Hyllypaikan avoin varastosaldo | 119 |
8 | OrderedAmount | Numeerinen | 1 | Tuotetta tilattu kyseiselle hyllypaikalle | 0 |
8 | ReservedAmount | Numeerinen | 1 | Tuotetta varattu kyseiseltä hyllypaikalta | 0 |
Purchaseorderinventoryamounts
Kun parametrin report arvoksi annetaan purchaseorderinventoryevents, niin kutsua voidaan rajata lisäksi seuraavilla parametreilla:
Parametri | Ilmentymiä | Kuvaus | Esimerkki |
page | 0...1 | Haettava sivu, oletuksena 1 | 1 |
purchaseordersonpage | 0...1 | Ostotilausten määrä per sivu, oletuksena 50000 | 50000 |
purchaseorderstatus | 0...1 | Ostotilauksen tilat: accepted - hyväksytty purchaserequest - hankintaehdotus sent - lähetetty archived - arkistoitu | accepted |
purchaseordernetvisorkeys | 0...1 | Haluttujen ostotilauksien NetvisorKey:t | 123 |
distributernetvisorkeys | 0...1 | Haluttujen toimittajien NetvisorKey:t | 158 |
Vastaus palauttaa ostotilausten varastotapahtumat:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | 1 | |||
1 | InventoryReport | Aggregaatti | 1 | ||
Attr. | Report | Merkkijono | 1 | Varastoraportin tyyppi | PurchaseOrderInventoryEvents |
Attr. | TimeStamp | Aikaleima | 1 | Päivämäärä ja aika | 2021-10-26 10:49 |
2 | PurchaseOrders | Aggregaatti | 1 | ||
Attr. | CurrentPage | Numeerinen | 1 | Nykyinen sivu | 1 |
Attr. | PageCount | Numeerinen | 1 | Sivumäärä | 1 |
Attr. | PurchaseOrdersOnPage | Numeerinen | 1 | Ostotilausten määrä per sivu | 50000 |
Attr. | PurchaseOrdersOnPages | Numeerinen | 1 | Ostotilauksia sivuilla | 1 |
3 | PurchaseOrder | Aggregaatti | 1...n | ||
4 | NetvisorKey | Numeerinen | 1 | Ostotilauksen Netvisor-id | 41 |
4 | OrderNumber | Numeerinen | 1 | Ostotilauksen numero | 17 |
4 | OrderStatus | Merkkijono | 1 | Ostotilauksen tila | sent |
4 | Distributer | Aggregaatti | 1 | ||
5 | NetvisorKey | Numeerinen | 1 | Toimittajan Netvisor-id | 89 |
5 | DistributerName | Merkkijono | 1 | Toimittajan nimi | Esimerkkitoimittaja |
4 | PurchaseOrderProductLines | Aggregaatti | 1 | ||
5 | PurchaseOrderProductLine | Aggregaatti | 1...n | ||
6 | NetvisorKey | Numeerinen | 1 | Ostotilausrivin Netvisor-id | 5 |
6 | OrderedAmount | Numeerinen | 1 | Tilattujen tuotteiden määrä | 10 |
6 | InventoryEvents | Aggregaatti | 1 | ||
7 | InventoryEvent | Aggregaatti | 1...n | ||
Attr. | Context | Merkkijono | 1 | Varastotapahtuman konteksti | purchaseorder |
8 | NetvisorKey | Numeerinen | 1 | Varastotaphtuman Netvisor-id | 876 |
8 | EventType | Aggregaatti | 1 | ||
9 | NetvisorKey | Numeerinen | 1 | Varastotapahtuman tyypin Netvisor-id | 1 |
9 | EventTypeDescription | Merkkijono | 1 | Varastotapahtuman tyypin kuvaus | Hankinta |
8 | EventStatus | Merkkijono | 1 | Varastotapahtuman tila | handled |
8 | EventDate | Päivämäärä | 1 | Varastotapahtuman päiväys | 2021-03-16 |
8 | DeliveryDate | Päivämäärä | 1 | Toimituspäivä | 2021-03-16 |
8 | Product | Aggregaatti | 1 | ||
9 | NetvisorKey | Numeerinen | 1 | Tuotteen Netvisor-id | 74 |
9 | ProductCodes | Aggregaatti | 1 | ||
10 | ProductCode | Merkkijono | 1 | Varastoitavan tuotteen tuotekoodi | 1234 |
10 | ProductPrimaryEanCode | Numeerinen | 1 | Tuotteen ensisijainen ean-koodi | 123456789012 |
10 | ProductSecondaryEanCode | Numeerinen | 1 | Tuotteen toissijainen ean-koodi | 123456789012 |
9 | ProductNameTranslations | Aggregaatti | 1 | ||
10 | Translation | Merkkijono | 1...3 | Tuotteen nimi | Esimerkkituote |
Attr. | Language | Merkkijono | 1 | Tuotteen kieli | FI |
9 | ProductUnit | Aggregaatti | 1 | ||
10 | NetvisorKey | Numeerinen | 1 | Tuoteyksikön Netvisor-id | 3 |
10 | ProductUnitTranslations | Aggregaatti | 1...3 | ||
11 | Translation | Merkkijono | 1 | Tuoteyksikkkö | kpl |
Attr. | Language | Merkkijono | 1 | Tuoteyksikön kieli | FI |
8 | InventoryPlace | Aggregaatti | 1 | ||
9 | NetvisorKey | Numeerinen | 0...1 | Varaston Netvisor-id | 3 |
9 | InventoryPlaceName | Merkkijono | 0...1 | Varaston kuvaus, varaston paikka | Varasto-kuvaus, Varasto-paikka |
9 | InventoryPlaceShelve | Aggregaatti | 0...1 | ||
10 | NetvisorKey | Numeerinen | 0...1 | Varaston hyllypaikan Netvisor-id | 5 |
10 | InventoryPlaceShelveName | Merkkijono | 0..1 | Varaston hyllypaikka | Esimerkkihylly |
8 | Amount | Numeerinen | 1 | Tuotteen määrä | -564 |
8 | UnitPrice | Numeerinen | 1 | Tuotteen yksikköhinta | 9,7 |
Attr. | PurchasePrice | Numeerinen | 1 | Tuotteen ostohinta | 9,7 |
Attr. | FreightRate | Numeerinen | 1 | Tuotteen rahtikustannus | 0 |
8 | Description | Merkkijono | 1 | Kuvaus | Esimerkkikuvaus |
8 | BatchInformation | Aggregaatti | 1 | ||
9 | BatchNumber | Numeerinen | 1 | Eränumero | 13 |
9 | ManufactureDate | Päivämäärä | 1 | Valmistuspäivä | 2021-09-23 |
9 | PackagingDate | Päivämäärä | 1 | Pakkauspäivä | 2021-09-23 |
9 | BestBeforeDate | Päivämäärä | 1 | Parasta ennen päiväys | 2021-09-23 |
9 | UseByDate | Päivämäärä | 1 | Viimeinen käyttöpäivä | 2021-09-23 |
8 | ShipmentInformation | Aggregaatti | 1 | ||
9 | CountryOfOrigin | Merkkijono | 1 | Alkuperämaa | FI |
Attr. | Type | Merkkijono | 1 | Aina ISO-3166 | ISO-3166 |
9 | NetWeight | Numeerinen | 1 | Nettopaino | 11,5 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | mg |
9 | GrossWeight | Numeerinen | 1 | Bruttopaino | 10 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | mg |
9 | PackageWidth | Numeerinen | 1 | Pakkauksen leveys | 12,5 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | cm |
9 | PackageHeight | Numeerinen | 1 | Pakkauksen korkeus | 4,6 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | cm |
9 | PackageLength | Numeerinen | 1 | Pakkauksen pituus | 7,9 |
Attr. | Unit | Merkkijono | 1 | Yksikkö | cm |
8 | EventLinks | Aggregaatti | 1 | ||
9 | SourceInventoryEvent | Aggregaatti | 0...1 | ||
Attr. | Context | Merkkijono | 0...1 | Linkitetyn varastotapahtuman konteksti | production |
Attr. | ContextNetvisorKey | Numeerinen | 0...1 | Kontekstin Netvisor-id | 169 |
10 | NetvisorKey | Numeerinen | 0...1 | Linkitetyn varastotapahtuman Netvisor-id | 2140 |
10 | EventType | Aggregaatti | 0...1 | ||
11 | NetvisorKey | Numeerinen | 0...1 | Linkitetyn varastotapahtumatyypin Netvisor-id | 2 |
11 | EventTypeDescription | Merkkijono | 0...1 | Linkitetyn varastotapahtumatyypin kuvaus | Valmistukseen |
10 | EventStatus | Merkkijono | 0...1 | Linkitetyn varastotapahtuman tila | handled |
10 | DeliveryDate | Päivämäärä | 0...1 | Toimitus-/saapumispäivä | 2021-11-06 |
10 | Amount | Numeerinen | 0...1 | Määrä | 1968,50 |
10 | UnitPrice | Numeerinen | 0...1 | Yksikköhinta | 9,7 |
10 | AmountLeft | Numeerinen | 1 | Tilanne/Määrä | 1210 |
Tuotteen liitteiden nouto
Resurssi: getproductattachment.nv
Resurssilla getproductattachment.nv voidaan noutaa tuotteelle tallennetut liitteet. Parametrinä käytetään liitteen NetvisorKeytä, joka saadaan noutamalla laajennettua tuotelistausta (extendedproductlist.nv). Palautuvan sanoman maksimikoko on 50Mb.
Käytettävät parametrit:
Parametrin nimi | Ilmentymiä | Kuvaus | Esimerkki |
productattachmentnetvisorkeys | 1 | Rajaus liitteiden NetvisorKeyllä | 18, 19, 20 |
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | Root | Aggregaatti | 1 | ||
1 | ProductAttachments | Aggregaatti | 1 | ||
2 | Attachment | Aggregaatti | 1...n | ||
3 | NetvisorKey | Numeerinen | 1 | Liitteen NetvisorKey | 18 |
3 | MimeType | Merkkijono | 1 | Liitteen mime-type | application/pdf |
3 | FileName | Merkkijono | 1 | Liitteen nimi | Testattachment.pdf |
3 | AttachmentData | Base64 | 1 | Liitetiedosto Base64-enkoodattuna | |
Attr. | type | Merkkijono | 1 | Aina Base64 | Base64 |
Tuotteen kuvien nouto
Resurssi: getproductimage.nv
Resurssilla getproductimage.nv voidaan noutaa tuotteen tuotekuvat. Parametrinä käytetään kuvan NetvisorKeytä, joka saadaan noutamalla laajennettua tuotelistausta (extendedproductlist.nv). Palautuvan sanoman maksimikoko on 50Mb.
Käytettävät parametrit:
Parametrin nimi | Ilmentymiä | Kuvaus | Esimerkki |
productimagenetvisorkeys | 1 | Rajaus kuvien NetvisorKeyllä | 18, 19, 20 |
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | Root | Aggregaatti | 1 | ||
1 | ProductImages | Aggregaatti | 1 | ||
2 | ProductImage | Aggregaatti | 1...n | ||
3 | MimeType | Merkkijono | 1 | Kuvan mime-tyyppi | image/jpeg |
3 | Title | Merkkijono | 0...1 | Kuvateksti | Product image |
3 | FileName | Merkkijono | 1 | Kuvan nimi | Productimage.jpg |
3 | ImageData | Base64 | 1 | Kuvatiedosto Base64-enkoodattuna | |
Attr. | type | Merkkijono | 1 | Aina Base64 | Base64 |
Laajennettu tuotetietojen nouto
Resurssi: extendedproductlist.nv
Resurssilla extendedproductlist.nv voi noutaa mallituotteita sekä normaaleja tuotteita mutta ei päätuotteita tai TEMP-tuotetta. Resurssia voi halutessaan rajata useilla eri parametreilla, jotka löytyvät alla olevasta taulukosta. Resurssia voi käyttää myös ilman laajennettua tuotehallintaa, tällöin ei välttämättä palauteta kaikkia tietoja, koska näitä ei ole saatavilla.
Nouto palauttaa julkaistut tuotteet, poistettuja tuotteita ei palauteta koskaan. Mikäli halutaan noutaa julkaisemattomia tuotteita, täytyy tuotelistaa noutaa tuotteen NetvisorKey:llä.
Parametrin nimi | Ilmentymiä | Kuvaus | Esimerkki |
replyoptions | 0...1 | Valitaan, mitä tietoja palautetaan perustietojen lisäksi. Annetaan lukuarvona tai lippujen nimillä. Optiot ja lippuarvot: Hintaryhmät - IncludeProductPriceGroups (1) Asiakashinnat - IncludeProductCustomerPrices (2) Toimittajatiedot - IncludeDistributerPurchaseInformation (4) Hyllytiedot - IncludeProductInventoryPlaceShelves (8) Toimitustiedot - IncludeProductShipmentInformation (16) Rymittelyperusteet - IncludeProductGroupingCriterias (32) Kirjanpidon tiedot - IncludeProductAccountingInformation (64) Laskentakohteet - IncludeProductDimensionInformation (128) Lisätietokentät - IncludeProductInformationFields (256) Tuoteviittaukset - IncludeProductReferences (512) Ominaisuudet - IncludeProductProperties (1024) Alituotteet - IncludeProductSubProducts (2048) Kuvat - IncludeProductImages (2096) Liitteet - IncludeProductAttachments (8192) Aseta kaikki hakuehdot - SetAllReplyOptions (4294967295) | 3 Palauttaa tällöin hintaryhmät sekä asiakashinnat. Saadaan laskemalla optioiden lippuarvot yhteen. Jos käytetään lippuarvojen nimiä, annetaan muodossa "IncludeProductPriceGroups, IncludeProductCustomerPrices". Parametrinä: *.nv?replyoptions=includeproductpricegroups, includeproductcustomerprice tai *.nv?replyoptions=3 |
searchlanguage | 0...1 | Valitaan mihin kieliversioon hakusanoja kohdistetaan. Ilman laajennettua tuotehallintaa vain "fi" on käytössä. Sallitut arvot "fi", "se" ja "en". Jos ei anneta mitään, käytetään arvoa "fi". | se |
productnetvisorkeys | 0...1 | Pilkulla eroteltu lista tuotteiden netvisorkey- arvoja. Voi olla myös vain yksi arvo. | 7,12 |
productnamekeyword | 0...1 | Yksi hakusana jota etsitään tuotenimestä. | test |
productcodekeyword | 0...1 | Yksi hakusana jota etsitään tuotekoodista. | ABC |
producteancode | 0...1 | Etsittävän tuotteen ean-koodi. Koodia verrataan ensisijaiseen ja toissijaiseen ean-koodiin. | |
onlysellableproducts | 0...1 | Onko tuote myytävä. Arvot true tai false. | true |
onlystoragedproducts | 0...1 | Onko tuote varastoitava. Merkitystä vain, jos varastonhallinta käytössä. Arvot true tai false. | false |
productchangedsince | 0...1 | Onko tuotetta muutettu annetun pvm:n ja kellonajan jälkeen. Minuutin tarkkuus. Muodossa yyyy-MM-ddTHH:mm | 2020-09-17T10:21 |
productgroupnetvisorkeys | 0...1 | Pilkulla eroteltu lista tuoteryhmien netvisorkey-arvoja. Voi olla myös vain yksi arvo. | 7, 20 |
productgroupname | 0...1 | Noudettavien tuotteiden tuoteryhmän nimi. | Test product |
productgroupnamekeyword | 0...1 | Noudettavien tuotteiden tuoteryhmän nimen alkuosa. | Test |
productgroupnamefreetext | 0...1 | Noudettavien tuotteiden tuoteryhmän nimi sisältää annetun parametrin | Test |
excludeproductgroupnamefreetext | 0...1 | Poisrajattavien tuotteiden tuoteryhmän nimi sisältää annetun parametrin | Test |
productgroupingcriterianame | 0...1 | Noudettavien tuotteiden ryhmittelyperusteiden nimi. | Grouping |
productsonpage | 0...1 | Tuotteiden maksimimäärä per sivu eli sanoma. (1-Netvisorissa asetettu maksimimäärä) | 2500 |
page | 0...1 | Palautettavan sivun numero. (1-hakutuloksen sivujen määrä) |
Osa palautuvasta datasta on saatavilla vain, jos yrityksellä on käytössä laajennettu tuotehallinta, ostotilauskäsittely tai varastohallinta. Muuten rakenne palautuu samanalaisena oli laajennettu tuotehallinta päällä tai ei.
Palautuvan sanoman koolle on asetettu maksimikooksi 25Mb. Jos maksimi on ylittymässä, palauttaa rajapinta virheen ja ohjeen, kuinka pienentää sanoman kokoa. Dataa ei palauteta ennen kuin sanoman kokoa on pienennetty.
Sivutuksessa voi asettaa maksimimäärän tuotteita per sanoma (ProductsOnPage = 1 - Netvisorissa asetettu maksimi) ja sanomalle voidaan hakea tietty sivu (Page = 1 - PageCount). Sivut tulee aina hakea samoilla hakukriteereillä. Huomioithan, että jos tuoterekisteriä muokataan noutojen välissä, voi täysin sama nouto palauttaa eri tuloksen.
Lue laajennetun tuotehallinnan termistöstä lisää täältä.
Vastaus:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
Root | Root | Aggregaatti | 1 | ||
1 | Products | Aggregaatti | 1 | ||
2 | Product | Aggregaatti | 1 | ||
3 | NetvisorKey | Numeerinen | 1 | Tuotteen NetvisorKey | 13848 |
3 | ProductCodes | Aggregaatti | 1 | ||
4 | ProductCode | Numeerinen | 1 | Tuotteen tuotekoodi | 1 |
4 | ProductPrimaryEanCode | Numeerinen | 1 | Tuotteen ensisijainen ean-koodi | |
4 | ProductSecondaryEanCode | Numeerinen | 1 | Tuotteen toissijainen ean-koodi | |
3 | ProductNameTranslations | Aggregaatti | 1 | Tuotteen nimen käännökset | |
4 | Translation | Merkkijono | 1 | Tuotteen nimi | Testituote |
Attr. | Language | Merkkijono | 1 | FI, SE tai EN | FI |
3 | ProductDescriptionTranslations | Aggregaatti | 1 | Tuotteen kuvauksen käännökset | |
4 | Translation | Merkkijono | 1 | Tuotten kuvaus | Kuvaus |
Attr. | Language | Merkkijono | 1 | FI, SE tai EN | FI |
3 | ProductFeatures | Aggregaatti | 1 | Tuotteen ominaisuudet | |
4 | IsPublishedProduct | Merkkijono | 1 | Onko tuote julkaistu, true tai false | true |
4 | IsSellableProduct | Merkkijono | 1 | Onko tuote myyntituote, true tai false | true |
4 | IsStorageProduct | Merkkijono | 1 | Onko tuote varastoitava, true tai false | false |
4 | IsProductStructureProduct | Merkkijono | 1 | Onko tuote laajennetun tuotehallinnan tuote, true tai false | false |
4 | IsModel | Merkkijono | 1 | Onko tuote mallituote, true tai false | false |
4 | IsSummaryOfProducts | Merkkijono | 1 | Onko tuote koostetuote, true tai false | false |
4 | LastChangedDate | Päivämäärä | 1 | Viimeisen muokkausen päivämäärä | 2021-03-23 09:30 |
Attr. | Format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
3 | ProductGroup | Aggregaatti | 1 | Tuoteryhmä | |
4 | NetvisorKey | Numeerinen | 0...1 | Tuoteryhmän NetvisorKey | 5 |
4 | ProductGroupTranslations | Aggregaatti | 0...1 | Tuoteryhmän kielikäännökset | |
5 | Translation | Merkkijono | 0...1 | Tuoteryhmän kielikäännös | Tuoteryhmä |
Attr. | language | Merkkijono | 1 | FI, EN tai SE | FI |
3 | ProductUnit | Aggregaatti | 1 | Tuotteen yksikkötiedot | |
4 | NetvisorKey | Numeerinen | 0...1 | Yksikön NetvisorKey | 10 |
4 | ProductUnitTranslations | Aggregaatti | 0...1 | Yksikön kielikäännökset | |
5 | Translation | Merkkijono | 0...1 | Yksikön kielikäännös | kpl |
Attr. | language | Merkkijono | 1 | FI, EN tai SE | FI |
3 | ProductPriceInformation | Aggregaatti | 1 | Tuotteen hintatiedot | |
4 | DefaultNetPrice | Numeerinen | 1 | Tuotteen nettohinta | 5,00 |
4 | DefaultGrossPrice | Numeerinen | 1 | Tuotteen bruttohinta | 5,00 |
4 | Vat | Aggregaatti | 1 | Tuotteen ALV-kanta | |
5 | NetvisorKey | Numeerinen | 1 | ALV-kannan NetvisorKey | 1 |
5 | Percentage | Numeerinen | 1 | ALV-prosentti | 0 |
4 | PriceMargin | Numeerinen | 1 | Alin myyntihinta | 8,00 |
4 | ProvisionPercentage | Numeerinen | 1 | Provisioprosentti | 2,00 |
4 | PriceGroups | Aggregaatti | 0...n | Hintaryhmät | |
5 | Group | Aggregaatti | 1 | ||
6 | NetvisorKey | Numeerinen | 1 | Hintaryhmän NetvisorKey | 7 |
6 | PriceGroupName | Merkkijono | 1 | Hintaryhmän nimi | Price group |
6 | NetPrice | Numeerinen | 1 | Nettohinta | 7,00 |
6 | GrossPrice | Numeerinen | 1 | Bruttohinta | 9,00 |
4 | CustomerPrices | Aggregaatti | 0...n | Asiakashinnat | |
5 | Customer | Aggregaatti | 1 | Asiakas | |
6 | NetvisorKey | Numeerinen | 1 | Asiakkaan NetvisorKey | 11 |
6 | CustomerCode | Numeerinen | 1 | Asiakkaan asiakaskoodi | 1000 |
6 | CustomerName | Merkkijono | 1 | Asiakkaan nimi | Customer |
6 | NetPrice | Numeerinen | 1 | Asiakaskohtainen nettohinta | 6,50 |
6 | GrossPrice | Numeerinen | 1 | Asiakaskohtainen bruttohinta | 8,05 |
3 | ProductPurchaseInformation | Aggregaatti | 0...1 | Hankintatiedot | |
4 | DefaultPurchasePrice | Numeerinen | 1 | Tuotteen hankintahinta | 2,50 |
4 | DistirbuterPurchaseInformations | Aggregaatti | 0...1 | Toimittajan tiedot | |
5 | Distributer | Aggregaatti | 1 | Toimittaja | |
6 | NetvisorKey | Numeerinen | 1 | Toimittajan NetvisorKey | 33587 |
6 | DistributerCode | Numeerinen | 1 | Toimittajakoodi | 855 |
6 | DistributerName | Merkkijono | 1 | Toimittajan nimi | Distributer |
6 | DistributerProductCode | Merkkijono | 1 | Toimittajan tuotekoodi | abc |
6 | DistributerProductName | Merkkijono | 1 | Toimittajan tuotenimi | Name |
6 | PurchasePrice | Numeerinen | 1 | Toimittajan hankintahinta | 1,50 |
6 | CurrencyAbbreviation | Merkkijono | 1 | Toimittajan valuutta | SEK |
3 | ProductStorageInformation | Aggregaatti | 0...1 | Varastotiedot | |
4 | DefaultInvetoryPlace | Aggregaatti | 1 | Oletusvarasto | |
5 | NetvisorKey | Numeerinen | 0...1 | Varaston NetvisorKey | 17 |
5 | InventoryPlaceName | Merkkijono | 0...1 | Varaston nimi | Warehouse |
4 | InventoryPlaceShelves | Aggregaatti | 0...1 | Hyllypaikat | |
5 | InventoryPlaceShelve | Aggregaatti | 1 | Hyllypaikka | |
6 | InventoryPlaceNetvisorKey | Numeerinen | 1 | Varaston NetvisorKey | 22 |
6 | InventoryPlaceName | Merkkijono | 1 | Varaston nimi | Warehouse 1 |
6 | ShelveNetvisorKey | Numeerinen | 1 | Hyllypaikan NetvisorKey | 31 |
6 | ShelveName | Merkkijono | 1 | Hyllypaikan nimi | Shelve 1 |
4 | AlertLimit | Numeerinen | 1 | Hälytysraja | 10 |
4 | CustomsTariffHeader | Merkkijono | 1 | Tullinimike | Code |
4 | ProductBatchLinkingMode | Aggregaatti | 0...1 | Eräkäsittely | |
5 | NetvisorKey | Numeerinen | 1 | Eräkäsittelytavan NetvisorKey | 4 |
5 | Definition | Merkkijono | 1 | Eräkäsittelytavan tyyppi | OldestFirstByValueDate |
3 | ProductShipmentInformation | Aggregaatti | 0...1 | Tuotteen kuljetustiedot | |
4 | DefaultProductCountryOfOrigin | Merkkijono | 1 | Tuotteen alkuperämaa | SE |
Attr. | type | Merkkijono | 1 | Aina ISO-3166 | ISO-3166 |
4 | ProductNetWeight | Numeerinen | 1 | Tuotteen nettopaino | 0 |
Attr. | unit | Merkkijono | 1 | Painon yksikkö | g |
4 | ProductGrossWeigh | Numeerinen | 1 | Tuotteen bruttopaino | 0 |
Attr. | unit | Merkkijono | 1 | Painon yksikkö | g |
4 | ProductPackageWidth | Numeerinen | 1 | Pakkauksen leveys | 0 |
Attr. | unit | Merkkijono | 1 | Leveyden yksikkö | cm |
4 | ProductPackageHeight | Numeerinen | 1 | Pakkauksen korkeus | 0 |
Attr. | unit | Merkkijono | 1 | Korkeuden yksikkö | cm |
4 | ProductPackageLength | Numeerinen | 1 | Pakkauksen pituus | 0 |
Attr. | unit | Merkkijono | 1 | Pituuden yksikkö | cm |
3 | ProductGroupingCriterias | Aggregaatti | 0..n | Ryhmittelyperusteet | |
4 | Translation | Merkkijono | 1 | Rymittelyperusteen nimi | TestGroup |
Attr. | language | Merkkijono | 1 | FI, EN tai SE | FI |
3 | ProductAccountInformation | Aggregaatti | 0...1 | Tuotteen kirjanpidon tiedot | |
4 | DefaultDomesticAccountNumber | Numeerinen | 1 | Kotimaan myynnin kirjanpidon oletustili | 3000 |
4 | DefaultEuAccountNumber | Numeerinen | 1 | EU-myyntien kirjanpidon oletustili | 3360 |
4 | DefaultOutsideEUAccountNumber | Numeerinen | 1 | EU-ulkopuolisten myyntien kirjanpidon oletustili | 3380 |
4 | DefaultInventoryAccountNumber | Numeerinen | 1 | Kirjanpidon oletusvarastotili | 1521 |
3 | ProductDimensionInformation | Aggregaatti | 0...1 | Tuotteen oletuslaskentakohteet | |
4 | Dimension | Aggregaatti | 1 | ||
5 | NameNetvisorKey | Numeerinen | 1 | Laskentakohdeotsikon NetvisorKey | 2 |
5 | DimensionNameName | Merkkijono | 1 | Laskentakohdeotsikon nimi | Dimension header |
5 | DetailNetvisorKey | Numeerinen | 1 | Laskentakohteen NetvisorKey | 15 |
5 | DimensionDetailName | Merkkijono | 1 | Laskentakohteen nimi | Dimension |
3 | ProductInformationFields | Aggregaatti | 0...n | Tuotteen lisätietokentät | |
4 | InformationField | Aggregaatti | 1 | ||
5 | InformationFieldName | Merkkijono | 1 | Lisätietokentän nimi | Information field |
5 | InformationFieldItemValue | Merkkijono | 1 | Lisätietokentän arvo | 24 |
3 | ProductReferences | Aggregaatti | 0...1 | Tuoteviittaukset | |
4 | RelatedProducts | Aggregaatti | 0...n | Tuotteeseen liittyvät päätuotteet/tuotteet | |
5 | Product | Aggregaatti | 1 | ||
6 | NetvisorKey | Numeerinen | 1 | Tuotteen NetvisorKey | 5 |
6 | ProductCode | Numeerinen | 1 | Tuotekoodi | 1000 |
6 | ProductNameTranslations | Aggregaatti | 1 | Tuotenimen kielikäännökset | |
7 | Translation | Merkkijono | 1 | Tuotenimi | Product 7 |
Attr. | language | Merkkijono | 1 | FI, EN tai SE | EN |
4 | ComplementaryProducts | Aggregaatti | 0...n | Täydentävät päätuotteet/tuotteet | |
5 | Product | Aggregaatti | 1 | ||
6 | NetvisorKey | Numeerinen | 1 | Tuotteen NetvisorKey | 13 |
6 | ProductCode | Numeerinen | 1 | Tuotekoodi | 2005 |
6 | ProductNameTranslations | Aggregaatti | 1 | Tuotenimen kielikäännökset | |
7 | Translation | Merkkijono | 1 | Tuotenimi | Product 10 |
Attr. | language | Merkkijono | 1 | FI, EN tai SE | EN |
3 | ProductProperties | Aggregaatti | 0...1 | Tuotteen ominaisuudet | |
4 | Property | Aggregaatti | 0...n | Ominaisuus | |
5 | NetvisorKey | Numeerinen | 1 | Ominaisuuden NetvisorKey | 88 |
5 | PropertyTranslations | Aggregaatti | 1 | Ominaisuuden kielikäännökset | |
6 | Translation | Merkkijono | 1 | Ominaisuuden nimi | |
Attr. | language | Merkkijono | 1 | FI, EN tai SE | FI |
5 | PropertyValues | Aggregaatti | 0...1 | Ominaisuuden arvot | |
6 | NetvisorKey | Numeerinen | 1 | Arvon NetvisorKey | 70 |
6 | PropertyValueTranslations | Aggregaatti | 1 | Arvon kielikäännökset | |
7 | Translation | Merkkijono | 1 | Arvon nimi | |
Attr. | language | Merkkijono | 1 | FI, EN tai SE | FI |
3 | SubProductInformation | Aggregaatti | 0...1 | Alituotteet | |
4 | Parents | Aggregaatti | 0...n | Vanhemmat | |
5 | Product | Aggregaatti | 1 | ||
6 | NetvisorKey | Numeerinen | 1 | Tuotteen NetvisorKey | 55 |
6 | Amount | Numeerinen | 1 | Määrä | 25 |
6 | PurchasePriceChange | Numeerinen | 1 | Ostohinnan muutos | |
6 | UnitPriceChange | Numeerinen | 1 | Yksikköhinnan muutos | |
4 | Children | Aggregaatti | 1 | Lapset | |
5 | Product | Aggregaatti | 1 | ||
6 | NetvisorKey | Numeerinen | 1 | Tuotteen NetvisorKey | 47 |
6 | Amount | Numeerinen | 1 | Määrä | 20 |
6 | PurchasePriceChange | Numeerinen | 1 | Ostohinnan muutos | |
6 | UnitPriceChange | Numeerinen | 1 | Yksikköhinnan muutos | |
3 | ProductImages | Aggregaatti | 1 | Tuotekuvat | |
4 | Image | Aggregaatti | 0...n | Tuotekuva | |
5 | NetvisorKey | Numeerinen | 1 | Kuvan NetvisorKey | 12 |
5 | IsDefaultImage | Merkkijono | 1 | Onko kuva tuotteen oletuskuva, true tai false | false |
5 | MimeType | Merkkijono | 1 | Kuvan mime-type | image/jpeg |
5 | Title | Merkkijono | 1 | Kuvateksti | Description |
5 | FileName | Merkkijono | 1 | Kuvan tiedostonimi | berlin-attractions-map-large.jpg |
5 | LastEditedDate | Date | 1 | Viimeisin muokkausajankohta | 2021-09-24 23:08 |
3 | ProductAttachments | Aggregaatti | 0...1 | Tuotteen liitetiedostot | |
4 | Attachment | Aggregaatti | 0...n | Liitetiedosto | |
5 | NetvisorKey | Numeerinen | 1 | Liitetiedoston NetvisorKey | 10 |
5 | MimeType | Merkkijono | 1 | Liitetiedoston mime-type | document/pdf |
5 | FileName | Merkkijono | 1 | Liitetiedoston nimi | berlin-attractions-map-large.pdf |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback