Norce Commerce Product v1.1 service (1.1)

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.

Download OpenAPI description
Languages
Servers
Playground

https://{slug}.api-se.playground.norce.tech/commerce/

Stage

https://{slug}.api-se.stage.norce.tech/commerce/

Production

https://{slug}.api-se.norce.tech/commerce/

Assortments

Contains endpoints for viewing metadata about assortment types, not commonly used anymore, still in use by legacy systems.

Operations

Categories

Contains endpoints for looking up category metadata.

Operations

Configurations

Contains endpoints for working with configuration products, not currently in use.

Operations

Families

Contains endpoints for viewing product family metadata, not commonly used anymore, but still needed in legacy systems.

Operations

Files

Contains endpoints for viewing file and image metadata.

Operations

Filters

Contains endpoints for working with ProductFilter navigations. Read more about it here.

Operations

Flags

Contains endpoints for viewing product flag metadata.

Operations

InfoTypes

Contains endpoints for viewing product related extended fields, info types.

Operations

Manufacturers

Contains endpoints for viewing manufacturer information.

Operations

OnHand

Contains endpoints for looking up detailed availability information.

Operations

Parametric

Contains endpoints for viewing parametric meta data and parametric data used in comparison views.

Operations

PriceLists

Contains endpoints for viewing price list data and metadata.

Operations

Products

Contains endpoints for listing, finding and viewing products, variants and its content. Read more about this here and here

Operations

Promotions

Contains endpoints for listing products based on promotion associations.

Operations

Relations

Contains endpoints for listing products based on their relations and relation metadata.

Operations

Reviews

Contains endpoints for managing product reviews, not commonly used anymore, still in use by legacy systems.

Operations

SkuTypes

Contains endpoints for looking up product type metadata.

Operations

Status

Contains endpoints for looking up product status metadata.

Operations

Variants

Contains endpoints for listing variants.

Operations

Warehouses

Contains endpoints for viewing warehouse and location information.

Operations

Schemas

ProductRelations

Idinteger or null(int32)

This is the type internal id for the relation type

Codestring or null

This is the type external code for the relation type

Namestring or null

This is the name of the relation type

Descriptionstring or null

This is the description of the relation type

RelationsMetadataArray of objects or null(RelationMetadataItem)

Indicates if the related items are product or variant specific

Relationsobject or null
VariantRelationsArray of objects or null(VariantRelations)

This is a list of variant relations.

{ "Id": 0, "Code": "string", "Name": "string", "Description": "string", "RelationsMetadata": [ { … } ], "Relations": { "ItemCount": 0, "Items": [ … ] }, "VariantRelations": [ { … } ] }

Promotion

The Promotion entity represents a promotion in Norce. It contains some meta data from the Promotion as well as applied total amount when applicable.

Idinteger or null(int32)

The internal id of the Promotion.

Namestring or null[ 0 .. 255 ] characters

The Name of the Promotion. MaxLength: 255

Headerstring or null[ 0 .. 255 ] characters

SubHeader from Norce. MaxLength: 255

ShortDescriptionstring or null[ 0 .. 255 ] characters

DescriptionHeader from Norce. MaxLength: 255

Description1string or null

Description from Norce.

Description2string or null

SubDescription from Norce.

StartDatestring or null(date-time)

The StartDate of the Promotion, if any. Only valid promotions will be returned.

EndDatestring or null(date-time)

The EndDate of the Promotion, if any. Only valid promotions will be returned.

ImageKeystring or null(uuid)

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.

RequirementSeedstring or null

A comma separated list of fulfilled requirements for this promotion.

DiscountCodestring or null

Will contain the discountCode if the promotion has a discountCode requirement.

IsExcludedFromPriceCalculationboolean or null

A value of true means the promotion was applied last an not included in any price calculations.

AllowProductListingboolean or null

This flag can be checked to see whether the promotion allows listing of products from requirements. Use Products.ListProductsByPromotionRequirement to list products. Note that if this property is true and no product requirements exists, no products will be listed.

ImagesArray of objects or null(File)

A list of additional images files uploaded for the promotion. Images can be differentiated by using different types. See ListPromotionImageTypes for available types.

ProductFiltersArray of objects or null(PromotionProductFilter)

A list of productFilters for the promotion. Can be used to filter or fetch promotions matched by Products. match the products properties against the filter values Each ProductFilter must match all existing values and if any ProductFilter matches the promotion will be valid for that product.

AppliedAmountnumber or null(decimal)

Applied discount amount, excluding VAT, if fetched on AppliedPromotions property on the basket. In that case it will be the sum of all applied amounts on all Basket.Items. This value is rounded to two decimals.

EffectSeedstring or null

A comma separated list of applicable effects for this promotion.

FreightDiscountPctnumber or null(decimal)

FreightDiscountPct can be used to calculate external freight prices. The value is given as percentage as 100.00 for 100% discount. Only used for FreightDiscounts.

IsStackableboolean or null

Promotion effect quantity or basket discount is multiplied with how many times requirement is fulfilled.

AppliedAmountIncVatnumber or null(decimal)

Applied discount amount, including VAT, for this Promotion on this BasketItem.

ExclusivityTypeinteger or null(int32)

ExclusivityType allows setting promotions as NotExclusive = 0, Exclusive = 1, or IgnoreExclusivity = 2.

ExternalCodestring or null[ 0 .. 255 ] characters

The external code of the Promotion. This is NOT the discount code. MaxLength: 255

{ "Id": 0, "Name": "string", "Header": "string", "ShortDescription": "string", "Description1": "string", "Description2": "string", "StartDate": "2019-08-24T14:15:22Z", "EndDate": "2019-08-24T14:15:22Z", "ImageKey": "9afa8b7e-ca15-438f-a9d6-f679c437e59c", "RequirementSeed": "string", "DiscountCode": "string", "IsExcludedFromPriceCalculation": true, "AllowProductListing": true, "Images": [ { … } ], "ProductFilters": [ { … } ], "AppliedAmount": 0, "EffectSeed": "string", "FreightDiscountPct": 0, "IsStackable": true, "AppliedAmountIncVat": 0, "ExclusivityType": 0, "ExternalCode": "string" }

PromotionProductFilter

PromotionProductFilter shows what any product in the requirement or effect is filtered by. Values should be AND:ed if used to filter products.

ManufacturerIdinteger or null(int32)

An optional Manufacturer internal id for filtered products.

CategorySeedstring or null

An optional CategorySeed for filtered products.

TypeIdinteger or null(int32)

An optional SKU Type internal id for filtered products.

ProductIdinteger or null(int32)

An optional Product internal id for filtered products.

VariantProductIdinteger or null(int32)

An optional VariantProduct internal id for filtered products. Equal to use PartNo.

PartNostring or null

An optional PartNo for filtered products. Equal to use VariantProductId.

PricelistIdinteger or null(int32)

An optional pricelist internal id for filtered products.

FlagIdinteger or null(int32)

An optional Flag internal id for filtered products. Only set if flagId is inclusive.

{ "ManufacturerId": 0, "CategorySeed": "string", "TypeId": 0, "ProductId": 0, "VariantProductId": 0, "PartNo": "string", "PricelistId": 0, "FlagId": 0 }