The Product namespace has Entities and Operations used for Products and other related Entities such as Prices, Filters, Categories etc. The main use of the Product service is to retrieve product data, variants, prices, and its availability to be used in a webshop or other sales channels. The Product service is read only and does not support creating or updating data in Norce. For this, use the Connect API.
https://{slug}.api-se.playground.norce.tech/commerce/
https://{slug}.api-se.stage.norce.tech/commerce/
https://{slug}.api-se.norce.tech/commerce/
Contains endpoints for working with ProductFilter navigations. Read more about it here.
(Optional) Accepts a comma separated string of Status internal ids. Lookup references in ListStatuses.
(Optional) Accepts a comma separated string of store internal ids. The StoreOnHand property of the product will show the onHand values for supplied Stores if supplied.
(Optional) A comma separated list of PriceList internal ids to use, if any. PriceLists supplied must be valid, either from the application's public priceList or any customer or company priceLists or any valid client priceLists. For clients configured to use priceListSeed exclusively in the API only the supplied priceLists will be used. If this is not configured, the supplied priceLists will be appended to the valid priceLists. If none is supplied, the default value for the application will be used in combination with any customer or company priceLists. This applies to both configurations.
(Optional) Customer internal id. Checks for specific customer bound prices if provided.
(Optional) Company internal id. Checks for specific company bound prices if provided. Note! customerId is mandatory in combination with companyId.
(Optional) Specifies in which language to display culture specific information. If none is supplied, value is resolved from Application.
(Optional) Specifies in which currency to display prices. Uses Norce internal ids. If none is supplied, value is resolved from Application.
https://customer-slug.api-se.playground.norce.tech/commerce/product/1.1/GetProductByUniqueName
https://customer-slug.api-se.stage.norce.tech/commerce/product/1.1/GetProductByUniqueName
https://customer-slug.api-se.norce.tech/commerce/product/1.1/GetProductByUniqueName
curl -i -X GET \
https://customer-slug.api-se.playground.norce.tech/commerce/product/1.1/GetProductByUniqueName \
-H 'ApplicationId: YOUR_API_KEY_HERE' \
-H 'Authorization: YOUR_API_KEY_HERE'OK
The name of the product. When Product is a VariantType, this will be the value of the variant parameter(s). MaxLength: 255
Contains the partNo if the product is not a variant or if the product is fetched by PartNo or VariantUniqueName. If the product has a value here then the selected variant can be found by either PartNo or by Id. MaxLength: 50
If viewed on Product level this will be the product specific files. If viewed on a Variant it will be the variant specific files.
A comma separated list of flag internal ids. If viewed on Product level this will be the product specific flags. If viewed on a Variant it will be the variant specific flags.
If viewed on Product level this can be a from-price. It will be the price of the cheapest variant. If viewed on a Variant it will be the variant specific price.
The original price, if specified. Same rules apply as for Price if it is a Product or a Variant.
The rule based price from a priceList, if specified. Same rules apply as for Price if it is a Product or a Variant.
A rate to multiply with price to get price inc VAT. 25% VAT equals a VatRate of 1.25.
Indicates the default value used as quantity when buying the product. If IsRecommendedQuantityFixed is true, only multiples of this quantity should be allowed.
Information about OnHand for a given SKU. There are generally three different types of OnHand in Norce. One for the Web, one for the chosen supplier and one for any specified Store.
Information about OnHand for a given SKU. There are generally three different types of OnHand in Norce. One for the Web, one for the chosen supplier and one for any specified Store.
Information about OnHand for a given SKU. There are generally three different types of OnHand in Norce. One for the Web, one for the chosen supplier and one for any specified Store.
A list of variants for this Product, if any. If the Product is itself a variant this will be empty.
A unique id for the image at our image server. Url for images are formed like http://[client specific CDN]/{ImageKey}. Preset, height and width can be sent as parameters.
A list of this product's parametric values. Only used on variants.
The complete variant name of the product. MaxLength: 255
DescriptionHeader for the product as specified in Norce Admin. MaxLength: 255
A unique name that can be used in Urls and to get a Product. GetProduct and GetProductByUniqueName gets the same Product. MaxLength: 500
A value that can be used for display logic regarding OnHand.
A list of this product's parametric values. Only Parametric values common to all variants for this product will be here. On Variant level this will contain Parametric values with distinguishing values that are not variant parametric values.
Indicates if the item is buyable or not. Will always be false if the status is closed. An exception will be thrown if IsBuyable is false and an attempt to buy the item is made. The property can be used to hide or show the buy-button. Note that the value can differ for underlying variants.
This will be the EAN code of the selected variant of the product if any. Variants will have this set. MaxLength: 50
Sku type internal id for this product. Might not be valid if there are variants with different types. Then variants must be examined. Also see ListSkutypes.
A list of categories ordered so the primary category is first.
If this is set to true only multiples of RecommendedQuantity should be allowed.
A value used to sort items based on popularity. Lower values are more popular.
Title for the product. As specified in Norce Admin. MaxLength: 255
Actual weight or gross weight for the product. As specified in Norce Admin.
Synonyms from the Product in Norce. Can be used when indexing the product in any search engine. MaxLength: 500
United Nations Standard Products and Services Code for the product. MaxLength: 50
The standard price, if specified. Same rules apply as for Price if it is a Product or a Variant.
True if this product is considered as dangerous goods. False otherwise.
A key that can be used to group items on product. It is equal to the ProductId for non-variants and equals 'v'+variantId for variants. Should only be used when fetching product lists as variants. MaxLength: int
The price including VAT calculated on the server side. Should be used to display prices including VAT.
{ "Id": 0, "Name": "string", "Description": "string", "PartNo": "string", "SubHeader": "string", "Manufacturer": { "Id": 0, "Name": "string", "PartNo": "string", "LogoPath": "string", "LogoKey": "3d7d7146-aca8-4108-aa6b-ef13bcb3846c", "UniqueName": "string" }, "Image": "string", "CampaignImage": "string", "LargeImage": "string", "ThumbnailImage": "string", "Files": [ { … } ], "FlagIdSeed": "string", "Price": 0, "PriceCatalog": 0, "PriceRecommended": 0, "PriceFreight": 0, "PriceFreightVatRate": 0, "VatRate": 0, "RecommendedQuantity": 0, "OnHand": { "Value": 0, "IncomingValue": 0, "NextDeliveryDate": "2019-08-24T14:15:22Z", "LeadtimeDayCount": 0, "LastChecked": "2019-08-24T14:15:22Z", "IsActive": true, "IsReturnable": true, "Info": [ … ] }, "OnHandStore": { "Value": 0, "IncomingValue": 0, "NextDeliveryDate": "2019-08-24T14:15:22Z", "LeadtimeDayCount": 0, "LastChecked": "2019-08-24T14:15:22Z", "IsActive": true, "IsReturnable": true, "Info": [ … ] }, "OnHandSupplier": { "Value": 0, "IncomingValue": 0, "NextDeliveryDate": "2019-08-24T14:15:22Z", "LeadtimeDayCount": 0, "LastChecked": "2019-08-24T14:15:22Z", "IsActive": true, "IsReturnable": true, "Info": [ … ] }, "Variants": [ {} ], "PriceListId": 0, "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd", "Updated": "2019-08-24T14:15:22Z", "NavigationNodeKey": "3262290d-6a4d-498f-832e-e20e1341c243", "CategoryId": 0, "CategoryName": "string", "ImageKey": "9afa8b7e-ca15-438f-a9d6-f679c437e59c", "VariantParametrics": [ { … } ], "StatusId": 0, "MetaTags": "string", "MetaDescription": "string", "VariantName": "string", "DescriptionHeader": "string", "UniqueName": "string", "StockDisplayBreakPoint": 0, "Parametrics": [ { … } ], "Families": [ { … } ], "IsBuyable": true, "SubDescription": "string", "Uom": "string", "UomCount": 0, "EanCode": "string", "Type": 0, "Categories": [ { … } ], "IsRecommendedQuantityFixed": true, "PopularityRank": 0, "CostPurchase": 0, "CostUnit": 0, "Title": "string", "ActualWeight": 0, "CommodityCode": "string", "IsDropShipOnly": true, "Synonyms": "string", "IsSubscribable": true, "UnspscCode": "string", "PriceStandard": 0, "Width": 0, "Height": 0, "Depth": 0, "IsDangerousGoods": true, "HasQuantityBreaks": true, "GroupByKey": "string", "PriceIncVat": 0, "ImageAltText": "string" }
(Optional) Accepts a comma separated string of Status internal ids. Lookup references in ListStatuses.
(Optional) Accepts a comma separated string of store internal ids. The StoreOnHand property of the product will show the onHand values for supplied Stores if supplied.
(Optional) A comma separated list of PriceList internal ids to use, if any. PriceLists supplied must be valid, either from the application's public priceList or any customer or company priceLists or any valid client priceLists. For clients configured to use priceListSeed exclusively in the API only the supplied priceLists will be used. If this is not configured, the supplied priceLists will be appended to the valid priceLists. If none is supplied, the default value for the application will be used in combination with any customer or company priceLists. This applies to both configurations.
(Optional) Customer internal id. Checks for specific customer bound prices if provided.
(Optional) Company internal id. Checks for specific company bound prices if provided. Note! customerId is mandatory in combination with companyId.
(Optional) Specifies in which language to display culture specific information. If none is supplied, value is resolved from Application.
(Optional) Specifies in which currency to display prices. Uses Norce internal ids. If none is supplied, value is resolved from Application.
https://customer-slug.api-se.playground.norce.tech/commerce/product/1.1/GetProductByPartNo
https://customer-slug.api-se.stage.norce.tech/commerce/product/1.1/GetProductByPartNo
https://customer-slug.api-se.norce.tech/commerce/product/1.1/GetProductByPartNo
curl -i -X GET \
https://customer-slug.api-se.playground.norce.tech/commerce/product/1.1/GetProductByPartNo \
-H 'ApplicationId: YOUR_API_KEY_HERE' \
-H 'Authorization: YOUR_API_KEY_HERE'OK
The name of the product. When Product is a VariantType, this will be the value of the variant parameter(s). MaxLength: 255
Contains the partNo if the product is not a variant or if the product is fetched by PartNo or VariantUniqueName. If the product has a value here then the selected variant can be found by either PartNo or by Id. MaxLength: 50
If viewed on Product level this will be the product specific files. If viewed on a Variant it will be the variant specific files.
A comma separated list of flag internal ids. If viewed on Product level this will be the product specific flags. If viewed on a Variant it will be the variant specific flags.
If viewed on Product level this can be a from-price. It will be the price of the cheapest variant. If viewed on a Variant it will be the variant specific price.
The original price, if specified. Same rules apply as for Price if it is a Product or a Variant.
The rule based price from a priceList, if specified. Same rules apply as for Price if it is a Product or a Variant.
A rate to multiply with price to get price inc VAT. 25% VAT equals a VatRate of 1.25.
Indicates the default value used as quantity when buying the product. If IsRecommendedQuantityFixed is true, only multiples of this quantity should be allowed.
Information about OnHand for a given SKU. There are generally three different types of OnHand in Norce. One for the Web, one for the chosen supplier and one for any specified Store.
Information about OnHand for a given SKU. There are generally three different types of OnHand in Norce. One for the Web, one for the chosen supplier and one for any specified Store.
Information about OnHand for a given SKU. There are generally three different types of OnHand in Norce. One for the Web, one for the chosen supplier and one for any specified Store.
A list of variants for this Product, if any. If the Product is itself a variant this will be empty.
A unique id for the image at our image server. Url for images are formed like http://[client specific CDN]/{ImageKey}. Preset, height and width can be sent as parameters.
A list of this product's parametric values. Only used on variants.
The complete variant name of the product. MaxLength: 255
DescriptionHeader for the product as specified in Norce Admin. MaxLength: 255
A unique name that can be used in Urls and to get a Product. GetProduct and GetProductByUniqueName gets the same Product. MaxLength: 500
A value that can be used for display logic regarding OnHand.
A list of this product's parametric values. Only Parametric values common to all variants for this product will be here. On Variant level this will contain Parametric values with distinguishing values that are not variant parametric values.
Indicates if the item is buyable or not. Will always be false if the status is closed. An exception will be thrown if IsBuyable is false and an attempt to buy the item is made. The property can be used to hide or show the buy-button. Note that the value can differ for underlying variants.
This will be the EAN code of the selected variant of the product if any. Variants will have this set. MaxLength: 50
Sku type internal id for this product. Might not be valid if there are variants with different types. Then variants must be examined. Also see ListSkutypes.
A list of categories ordered so the primary category is first.
If this is set to true only multiples of RecommendedQuantity should be allowed.
A value used to sort items based on popularity. Lower values are more popular.
Title for the product. As specified in Norce Admin. MaxLength: 255
Actual weight or gross weight for the product. As specified in Norce Admin.
Synonyms from the Product in Norce. Can be used when indexing the product in any search engine. MaxLength: 500
United Nations Standard Products and Services Code for the product. MaxLength: 50
The standard price, if specified. Same rules apply as for Price if it is a Product or a Variant.
True if this product is considered as dangerous goods. False otherwise.
A key that can be used to group items on product. It is equal to the ProductId for non-variants and equals 'v'+variantId for variants. Should only be used when fetching product lists as variants. MaxLength: int
The price including VAT calculated on the server side. Should be used to display prices including VAT.
{ "Id": 0, "Name": "string", "Description": "string", "PartNo": "string", "SubHeader": "string", "Manufacturer": { "Id": 0, "Name": "string", "PartNo": "string", "LogoPath": "string", "LogoKey": "3d7d7146-aca8-4108-aa6b-ef13bcb3846c", "UniqueName": "string" }, "Image": "string", "CampaignImage": "string", "LargeImage": "string", "ThumbnailImage": "string", "Files": [ { … } ], "FlagIdSeed": "string", "Price": 0, "PriceCatalog": 0, "PriceRecommended": 0, "PriceFreight": 0, "PriceFreightVatRate": 0, "VatRate": 0, "RecommendedQuantity": 0, "OnHand": { "Value": 0, "IncomingValue": 0, "NextDeliveryDate": "2019-08-24T14:15:22Z", "LeadtimeDayCount": 0, "LastChecked": "2019-08-24T14:15:22Z", "IsActive": true, "IsReturnable": true, "Info": [ … ] }, "OnHandStore": { "Value": 0, "IncomingValue": 0, "NextDeliveryDate": "2019-08-24T14:15:22Z", "LeadtimeDayCount": 0, "LastChecked": "2019-08-24T14:15:22Z", "IsActive": true, "IsReturnable": true, "Info": [ … ] }, "OnHandSupplier": { "Value": 0, "IncomingValue": 0, "NextDeliveryDate": "2019-08-24T14:15:22Z", "LeadtimeDayCount": 0, "LastChecked": "2019-08-24T14:15:22Z", "IsActive": true, "IsReturnable": true, "Info": [ … ] }, "Variants": [ {} ], "PriceListId": 0, "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd", "Updated": "2019-08-24T14:15:22Z", "NavigationNodeKey": "3262290d-6a4d-498f-832e-e20e1341c243", "CategoryId": 0, "CategoryName": "string", "ImageKey": "9afa8b7e-ca15-438f-a9d6-f679c437e59c", "VariantParametrics": [ { … } ], "StatusId": 0, "MetaTags": "string", "MetaDescription": "string", "VariantName": "string", "DescriptionHeader": "string", "UniqueName": "string", "StockDisplayBreakPoint": 0, "Parametrics": [ { … } ], "Families": [ { … } ], "IsBuyable": true, "SubDescription": "string", "Uom": "string", "UomCount": 0, "EanCode": "string", "Type": 0, "Categories": [ { … } ], "IsRecommendedQuantityFixed": true, "PopularityRank": 0, "CostPurchase": 0, "CostUnit": 0, "Title": "string", "ActualWeight": 0, "CommodityCode": "string", "IsDropShipOnly": true, "Synonyms": "string", "IsSubscribable": true, "UnspscCode": "string", "PriceStandard": 0, "Width": 0, "Height": 0, "Depth": 0, "IsDangerousGoods": true, "HasQuantityBreaks": true, "GroupByKey": "string", "PriceIncVat": 0, "ImageAltText": "string" }
https://customer-slug.api-se.playground.norce.tech/commerce/product/1.1/UpdateProductViewCount
https://customer-slug.api-se.stage.norce.tech/commerce/product/1.1/UpdateProductViewCount
https://customer-slug.api-se.norce.tech/commerce/product/1.1/UpdateProductViewCount
curl -i -X POST \
https://customer-slug.api-se.playground.norce.tech/commerce/product/1.1/UpdateProductViewCount \
-H 'ApplicationId: YOUR_API_KEY_HERE' \
-H 'Authorization: YOUR_API_KEY_HERE'