Resurssi: extendedproductlist.nv
HTTP-metodi: GET
Huom! Mikäli Netvisorissa käytetään Rackbeat varastonhallintaa, löytyvät rajapintakuvaukset täältä: https://support.netvisor.fi/fi/support/solutions/articles/77000554491-rackbeat-stoplight-rajapinta
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 feedbackPahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.