Tuotteiden käsittelyn toiminnot jakautuvat seuraaviin toimintoihin:
Integraatio | HTTP-metodi | Resurssi | DTD | Esimerkki |
Tuotelistan nouto | GET | productlist.nv | ||
Tuotetietojen nouto | GET | getproduct.nv | ||
Tuotetietojen tuonti | POST | product.nv | product.dtd | |
Rakenteellisen tuotelistan nouto | GET | webshopproductlist.nv | Lataa | |
Rakenteellisten tuotteiden tuotekuvien nouto | GET | webshopproductimages.nv | Lataa | |
Tuotesaldojen nouto varastoittain | GET | inventorybywarehouse.nv | Lataa | |
Varastotapahtuman tuonti | POST | warehouseevent.nv | warehouseevent.dtd |
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.
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-dd HH:mm:ss | 2020-09-13 12:00:00 |
keyword | 0...1 | Rajataan tuotteet, joiden nimessä tai tuotekoodissa esiintyy annettu parametri. | 1,2,3,4 |
Haussa voidaan käyttää yhtä tai useampaa parametriä samanaikaisesti. | |||
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. | 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 ryhmä, 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 |
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 Keskihinta | 5,0 |
3 | InventoryValue | Numeerinen | 1 | Varastonarvo: 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 |
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 |
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.
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 | 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 | Tuotten yksikköpaino kahdella desimaalilla. | 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 varastossa, 0 = ei / 1 = kyllä | 1 |
3 | countryoforigin | Merkkijono | 0...1 | Alkuperämaa | FI |
Attr. | type | Merkkijono | 0...1 | Aina ISO-3166 | ISO-3166 |
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 | 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 |
3 | dimension | Aggregaatti | 0...1 | ||
4 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikon nimi. Luodaan tarvittaessa. | Project |
4 | dimensionitem | Merkkijono | 1 | Laskentakohde. Luodaan tarvittaessa. | Project 1 |
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-dd HH:mm:ss | 2016-01-28 12:00:00 |
limitSourceProductNetvisorKey | 0...1 | Tuotteen Netvisor ID:llä rajataan tulosten määrää | 154 |
limitshownonwebshopproducts | 0...1 | Käytetään määriteltäessä noutamaan vain verkkokauppatuotteet |
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 | 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 |
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ä | Esimerkki | Kuvaus |
identifier | 1 | 123 | Tuoteen Netvisor-id jonka kuvat halutaan hakea |
NetvisorKeyList | 0...1 | 1,2,3 | Palauttaa yhdessä pyynnössä täydet tiedot kaikista halutuista tuotteista, max. 400 ID:tä |
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 |
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 | Päävarasto |
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 |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback