# Documentation ProductService Version: 1.1 ## Servers ``` https://customer-slug.api-se.norce.tech/commerce/product/1.1 ``` ## Download OpenAPI description [Documentation ProductService](https://docs.norce.io/_spec/api-reference/services/productservice/openapi.yaml) ## Assortments ### List product assortments - [GET /ListAssortments](https://docs.norce.io/api-reference/services/productservice/openapi/assortments/listassortments.md): Reference list of Product Assortments. ## Categories ### List categories (abbreviated) - [GET /ListCategories](https://docs.norce.io/api-reference/services/productservice/openapi/categories/listcategories.md): Lists categories as defined in Storm. Used for lookup. ### List categories - [GET /ListCategoryItems](https://docs.norce.io/api-reference/services/productservice/openapi/categories/listcategoryitems.md): Navigational structure. ### List categories by pricelists - [GET /ListCategoryItemsByPricelists](https://docs.norce.io/api-reference/services/productservice/openapi/categories/listcategoryitemsbypricelists.md): Lists categories as defined by the products on the priceLists in Storm. ### Search categories - [GET /SearchCategories](https://docs.norce.io/api-reference/services/productservice/openapi/categories/searchcategories.md) ## Configurations ### List configuration items - [GET /ListConfigurationItems](https://docs.norce.io/api-reference/services/productservice/openapi/configurations/listconfigurationitems.md): Lists all configuration items for the supplied list of partNos. The list will contain an item for each partNo. ## Families ### List families - [GET /ListFamilies](https://docs.norce.io/api-reference/services/productservice/openapi/families/listfamilies.md): Lists product families. ## Files ### List file types - [GET /ListFileTypeIds](https://docs.norce.io/api-reference/services/productservice/openapi/files/listfiletypeids.md): Reference list of Product file type ids. ## Filters ### List product filters (v2) - [GET /ListProductFilters2](https://docs.norce.io/api-reference/services/productservice/openapi/filters/listproductfilters2.md): Retrieves available filters for ListProduct ### List product filters by customer - [GET /ListProductFiltersByCustomer](https://docs.norce.io/api-reference/services/productservice/openapi/filters/listproductfiltersbycustomer.md): Retrieves available filters for product list based on customer priceLists. ### List product filters by product ids - [GET /ListProductFiltersByIds](https://docs.norce.io/api-reference/services/productservice/openapi/filters/listproductfiltersbyids.md): Retrieves available filters for product list based on product ids. ### List product filters by node (v2) - [GET /ListProductFiltersByNode2](https://docs.norce.io/api-reference/services/productservice/openapi/filters/listproductfiltersbynode2.md): Retrieves available filters for ListProduct by Navigation Node. ### List product filters by pricelist - [GET /ListProductFiltersByPricelist](https://docs.norce.io/api-reference/services/productservice/openapi/filters/listproductfiltersbypricelist.md): Retrieves available filters for product list based on priceLists. ### List filter values - [GET /ListProductItemFilterValues](https://docs.norce.io/api-reference/services/productservice/openapi/filters/listproductitemfiltervalues.md): Returns a list of filter values for products. The list can be used to filter products client side. ### List filter values by customer - [GET /ListProductItemFilterValuesByCustomer](https://docs.norce.io/api-reference/services/productservice/openapi/filters/listproductitemfiltervaluesbycustomer.md): Returns a list of filter values for product list. The list can be used to filter products client side. ### List filter values by specific product - [GET /ListProductItemFilterValuesById](https://docs.norce.io/api-reference/services/productservice/openapi/filters/listproductitemfiltervaluesbyid.md): Returns a list of filter values for the product id. The list can be used to filter products client side. ### List filter values by product ids - [GET /ListProductItemFilterValuesByIds](https://docs.norce.io/api-reference/services/productservice/openapi/filters/listproductitemfiltervaluesbyids.md): Returns a list of filter values for products. The list can be used to filter products client side. ### List filter values by node - [GET /ListProductItemFilterValuesByNode](https://docs.norce.io/api-reference/services/productservice/openapi/filters/listproductitemfiltervaluesbynode.md): Returns a list of filter values for products. The list can be used to filter products client side. ## Flags ### List product flag gropus - [GET /ListFlagGroups](https://docs.norce.io/api-reference/services/productservice/openapi/flags/listflaggroups.md) ### List product flags - [GET /ListFlags](https://docs.norce.io/api-reference/services/productservice/openapi/flags/listflags.md): Reference list of Product Flags. ## InfoTypes ### Get info types for availability - [GET /ListOnHandInfoTypes](https://docs.norce.io/api-reference/services/productservice/openapi/infotypes/listonhandinfotypes.md): Lists the available OnHandInfo types. ## Manufacturers ### Get a manufacturer - [GET /GetManufacturer](https://docs.norce.io/api-reference/services/productservice/openapi/manufacturers/getmanufacturer.md): Get a specific manufacturer by internal id. ### Get a manufacturer by unique name - [GET /GetManufacturerByUniqueName](https://docs.norce.io/api-reference/services/productservice/openapi/manufacturers/getmanufacturerbyuniquename.md): Get a specific manufacturer by unique name. ### List manufacturers - [GET /ListManufacturers](https://docs.norce.io/api-reference/services/productservice/openapi/manufacturers/listmanufacturers.md): Main manufacturer list. This function will not calculate ProductCount. Use ListManufacturersEx for that. ### List manufacturers (extended) - [GET /ListManufacturersEx](https://docs.norce.io/api-reference/services/productservice/openapi/manufacturers/listmanufacturersex.md): Main product list. Same as ListManufacturers but this one will calculate ProductCount. ### Search manufacturers - [GET /SearchManufacturers](https://docs.norce.io/api-reference/services/productservice/openapi/manufacturers/searchmanufacturers.md) ## Navigation ### Get navigation structure - [GET /GetNavigationStructure](https://docs.norce.io/api-reference/services/productservice/openapi/navigation/getnavigationstructure.md): Gets the NavigationStructure for the Application. The NavigationStructure is used to get the list of NavigationNodes. See IProductService.ListNavigationNodes for more information. ### List navigation nodes - [GET /ListNavigationNodes](https://docs.norce.io/api-reference/services/productservice/openapi/navigation/listnavigationnodes.md): Lists the NavigationNodes for the NavigationStructure. See NavigationNode for more information. ### List navigation nodes (extended) - [GET /ListNavigationNodesEx](https://docs.norce.io/api-reference/services/productservice/openapi/navigation/listnavigationnodesex.md): Lists the NavigationNodes. Same as ListNavigationNodes but this one will calculate ProductCount. ### List navigation node types - [GET /ListNavigationNodeTypeIds](https://docs.norce.io/api-reference/services/productservice/openapi/navigation/listnavigationnodetypeids.md): Lists the available NavigationNode.TypeIds. ## OnHand ### Get product external availability by part number - [POST /GetExternalProductOnHandByPartNo](https://docs.norce.io/api-reference/services/productservice/openapi/onhand/getexternalproductonhandbypartno.md): Checks the actual on hand status in the customers back end system. ### Get product external availability by id - [POST /GetExternalProductOnHandByProduct](https://docs.norce.io/api-reference/services/productservice/openapi/onhand/getexternalproductonhandbyproduct.md): Checks the actual on hand status in the customers back end system. ### Get product availability by part number - [POST /GetProductOnHandByPartNo](https://docs.norce.io/api-reference/services/productservice/openapi/onhand/getproductonhandbypartno.md) ### Get product availability by id - [POST /GetProductOnHandByProduct](https://docs.norce.io/api-reference/services/productservice/openapi/onhand/getproductonhandbyproduct.md) ## Parametric ### List category focus parametrics - [GET /ListFocusParametrics](https://docs.norce.io/api-reference/services/productservice/openapi/parametric/listfocusparametrics.md): Available focus parametrics on a category. Focus parametrics is used when filtering a ListProduct result set. ### List product parametric groups - [GET /ListParametricGroups](https://docs.norce.io/api-reference/services/productservice/openapi/parametric/listparametricgroups.md): Lists all parametric groups for the client. ### List parametric metadata - [GET /ListParametricInfo](https://docs.norce.io/api-reference/services/productservice/openapi/parametric/listparametricinfo.md): Lists metadata for parametric, ParametricInfos. ### List parametric list values - [GET /ListParametricValues2](https://docs.norce.io/api-reference/services/productservice/openapi/parametric/listparametricvalues2.md): Reference list of Parametric values. ### List product parametrics - [GET /ListProductParametrics](https://docs.norce.io/api-reference/services/productservice/openapi/parametric/listproductparametrics.md): Lists Product Parametric values for a product. What parametric values are returned is defined in the primary Category of the product, or if no primary exists, the first category by sort order. If the product does not exist or does not have a category an empty list is returned. Sort order of the parametric values is taken from the order defined for the category. ## PriceLists ### List pricelists - [GET /ListPricelists](https://docs.norce.io/api-reference/services/productservice/openapi/pricelists/listpricelists.md): Lists priceLists for the client. ### List pricelist types - [GET /ListPricelistTypes](https://docs.norce.io/api-reference/services/productservice/openapi/pricelists/listpricelisttypes.md): Reference list of PriceList Types. ## Products ### Get a product - [GET /GetProduct](https://docs.norce.io/api-reference/services/productservice/openapi/products/getproduct.md): Gets a Product and its optional variants by internal id. The main product will be based on the product with the supplied id, status permitting. ### Get a product by part no - [GET /GetProductByPartNo](https://docs.norce.io/api-reference/services/productservice/openapi/products/getproductbypartno.md): Gets a Product and its optional variants by partNo. The main product will be based on the product with the supplied partNo, status permitting. ### Get a product by unique name - [GET /GetProductByUniqueName](https://docs.norce.io/api-reference/services/productservice/openapi/products/getproductbyuniquename.md): Gets a Product and its optional variants by the uniqueName. The main product will be based on the product with the supplied name, status permitting. ### List best selling products (v2) - [GET /ListBestsellingProducts2](https://docs.norce.io/api-reference/services/productservice/openapi/products/listbestsellingproducts2.md): Returns the best selling products based on supplied parameters. ### List best selling products by company - [GET /ListBestSellingProductsByCompany](https://docs.norce.io/api-reference/services/productservice/openapi/products/listbestsellingproductsbycompany.md): Main product list based on best selling items for a company ### List best selling products by node (v2) - [GET /ListBestsellingProductsByNode2](https://docs.norce.io/api-reference/services/productservice/openapi/products/listbestsellingproductsbynode2.md): Returns the best selling products based on supplied parameters by Navigation Node. ### List historical best prices - [GET /ListHistoricalBestPrices](https://docs.norce.io/api-reference/services/productservice/openapi/products/listhistoricalbestprices.md): Lists historical best prices for a product going back 30 days. ### List products included in structure - [GET /ListIncludedProducts](https://docs.norce.io/api-reference/services/productservice/openapi/products/listincludedproducts.md): Returns a list of included products for structural products. Note that this is on sku level. ### List popular products (v2) - [GET /ListPopularProducts2](https://docs.norce.io/api-reference/services/productservice/openapi/products/listpopularproducts2.md): Returns the most popular products based on supplied parameters. ### List popular products by node (v2) - [GET /ListPopularProductsByNode2](https://docs.norce.io/api-reference/services/productservice/openapi/products/listpopularproductsbynode2.md): Returns the most popular products based on supplied parameters by Navigation Node. ### List product quantity break prices - [GET /ListProductPriceQtyBreak](https://docs.norce.io/api-reference/services/productservice/openapi/products/listproductpriceqtybreak.md): Gets a ProductPriceQtyBreakList. The list contains ProductPrices representing the price for each given minimum quantity bought. ### List products (v2) - [GET /ListProducts2](https://docs.norce.io/api-reference/services/productservice/openapi/products/listproducts2.md): Main product list. ### List products by customer - [GET /ListProductsByCustomer](https://docs.norce.io/api-reference/services/productservice/openapi/products/listproductsbycustomer.md): Main product list and prices based on customer priceLists. ### List products by families - [GET /ListProductsByFamilies](https://docs.norce.io/api-reference/services/productservice/openapi/products/listproductsbyfamilies.md): Main product list. ### List product variants by product ids - [GET /ListProductsById](https://docs.norce.io/api-reference/services/productservice/openapi/products/listproductsbyid.md): Returns all variants for the product as a ProductItemList. ### List products by ids (v2) - [GET /ListProductsByIds2](https://docs.norce.io/api-reference/services/productservice/openapi/products/listproductsbyids2.md): Main product list. ### List products by ids (v3) - [GET /ListProductsByIds3](https://docs.norce.io/api-reference/services/productservice/openapi/products/listproductsbyids3.md): Main product list. ### List products by node (v2) - [GET /ListProductsByNode2](https://docs.norce.io/api-reference/services/productservice/openapi/products/listproductsbynode2.md): Main product list by Navigation Node. ### List products by part numbers - [GET /ListProductsByPartNos](https://docs.norce.io/api-reference/services/productservice/openapi/products/listproductsbypartnos.md): Main product list. ### List products by pricelists - [GET /ListProductsByPricelist](https://docs.norce.io/api-reference/services/productservice/openapi/products/listproductsbypricelist.md): Main product list and prices based on priceLists. ### List products by pricelists (v2) - [GET /ListProductsByPriceList2](https://docs.norce.io/api-reference/services/productservice/openapi/products/listproductsbypricelist2.md): Main product list (v2) and prices based on priceLists. ### List products by promotion requirement - [GET /ListProductsByPromotionRequirement](https://docs.norce.io/api-reference/services/productservice/openapi/products/listproductsbypromotionrequirement.md): Lists all products by promotion requirements. ### List product in family (v2) - [GET /ListProductsInFamilies2](https://docs.norce.io/api-reference/services/productservice/openapi/products/listproductsinfamilies2.md): Returns other products in the same family for the current product. ### Search products light (v2) - [GET /SearchProductsLite2](https://docs.norce.io/api-reference/services/productservice/openapi/products/searchproductslite2.md): Quick search of products, only returns ProductId and Name. ### Update product view count - [POST /UpdateProductViewCount](https://docs.norce.io/api-reference/services/productservice/openapi/products/updateproductviewcount.md): Updates the view count for the product. Used when calculating most popular products. Should be called on product detail pages. ## Promotions ### List products by promotion effect - [GET /ListPromotionProducts](https://docs.norce.io/api-reference/services/productservice/openapi/promotions/listpromotionproducts.md): Lists all products by promotion effect ChooseProducts(2) or AddProduct(5). This allows the product detail page to display what comes with the main product as promoted products. ### List promotions for a specific product - [GET /ListPromotionsByProductId](https://docs.norce.io/api-reference/services/productservice/openapi/promotions/listpromotionsbyproductid.md): Lists all promotions where the product is either in a requirement or in an effect for the promotion. ### List promotions for a specific product by unique name - [GET /ListPromotionsByProductUniqueName](https://docs.norce.io/api-reference/services/productservice/openapi/promotions/listpromotionsbyproductuniquename.md): Lists all promotions where the product is either in a requirement or in an effect for the promotion. ## Relations ### List product relations - [GET /ListProductRelations](https://docs.norce.io/api-reference/services/productservice/openapi/relations/listproductrelations.md): Relations connected to a product. Relations are defined as products that customer could choose to buy in addition to the current product. Supports relations like product to product, product to variant, variant to product and variant to variant. ### List product relation types - [GET /ListProductRelationTypes](https://docs.norce.io/api-reference/services/productservice/openapi/relations/listproductrelationtypes.md): Reference list of Product Relation types. The ids in the list can be used as accessoryTypeSeed in calls to ListProductAccessories/ListProductRelations. ## Reviews ### Insert product review - [POST /InsertProductReview](https://docs.norce.io/api-reference/services/productservice/openapi/reviews/insertproductreview.md): Inserts a product review and returns the new list. Likes and Dislikes will be set to zero. ### List product reviews - [GET /ListProductReviews](https://docs.norce.io/api-reference/services/productservice/openapi/reviews/listproductreviews.md): Lists reviews for a product. Only published Reviews will be listed. ### List all product reviews - [GET /ListProductReviewsAll](https://docs.norce.io/api-reference/services/productservice/openapi/reviews/listproductreviewsall.md): Lists all reviews for all products. Only published Reviews will be listed. ### Update product review likes - [POST /UpdateProductReviewLikes](https://docs.norce.io/api-reference/services/productservice/openapi/reviews/updateproductreviewlikes.md): Updates likes/dislikes on review. ## SkuTypes ### List SKU types - [GET /ListSkuTypes](https://docs.norce.io/api-reference/services/productservice/openapi/skutypes/listskutypes.md): Lists the available sku types. ## Status ### List product statuses - [GET /ListStatuses](https://docs.norce.io/api-reference/services/productservice/openapi/status/liststatuses.md): Reference list of Product Statuses. ## Variants ### List variant items - [POST /ListVariantItems](https://docs.norce.io/api-reference/services/productservice/openapi/variants/listvariantitems.md): This method can be used together with any ListProduct-method to get related variant data when the ListProduct-method is called with asVariants = false. This will enable filtering on variant data in the product list. Just expand on the data needed in the list. ## Warehouses ### List warehouse info types - [GET /ListWarehouseInfo](https://docs.norce.io/api-reference/services/productservice/openapi/warehouses/listwarehouseinfo.md): List warehouse information types