Management API (v1)

The Norce Management API lets you manage configurations and metadata on a client.

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/

Settings ApplicationCountry

Manage application countries

Operations

Settings ApplicationCulture

Manage application cultures

Operations

Settings ApplicationCurrency

Operations

Settings ApplicationSalesArea

Operations

Settings Application

Operations

Category

Manage categories

Operations

CategoryParametric

Manage parametric categories

Operations

Settings ClientAssortment

Operations

Settings ClientCurrency

Operations

PriceList ClientPriceListType

Operations

Settings ClientSalesArea

Operations

Customer FlagGroup

Operations

Customer Flag

Operations

Customer InfoType

Operations

Product Family

Operations

Product File

Operations

Product Manufacturer

Operations

Parametric Group

Operations

Parametric List

Operations

Parametric Multiple

Operations

Parametric

Operations

PriceList Population

Operations

PriceList Pricing

Operations

PriceList

Operations

PriceList SupplierPriceList

Operations

PriceList PriceListType

Operations

PriceList Warehouse

Operations

Product FlagGroup

Operations

Product Flag

Operations

Product InfoType

Operations

Product Type

Operations

Promotion

Operations

Product RelationType

Operations

PriceList RoundingRule

Operations

Shopping InfoType

Operations

Store Application

Operations

Store PriceList

Operations

Store

Operations

Store Warehouse

Operations

Supplier PriceList

Operations

Supplier PriceListWarehouse

Operations

Supplier

Operations

Supplier Warehouse

Operations

Supplier WarehouseLocation

Operations

Product VariantGroup

Operations

Product WarehouseLocation

Operations

Product Warehouse

Operations

Schemas

PromotionEffectSettingModel

PromotionEffectSetting model, represents the settings for a specific promotion effect. Defines the type of effect, its parameters, and associated product lists, if any.

Idinteger(int32)
EffectTypestring

Effect type can have one of the following values: DiscountBasket, ProductFilter, ProductManufacturer, ProductCategory, ProductFlag, ProductPriceList, ProductType, DiscountFreight, AddProduct, SelectProduct

IsDiscountboolean or null

Indicates whether the effect is calculated as a percentage discount

IsFixedPriceboolean or null

Indicates whether the effect is a fixed price adjustment

Valuenumber or null(double)

The value associated with the effect, such as discount amount or fixed price

IsIncVatboolean

Indicates whether the value is inclusive of VAT, relevant for fixed price effects

IgnoreNonDiscountableboolean

Indicates whether non-discountable items should be ignored in the effect calculation (when products or variants has IsDiscountable = false on the price record)

DiscountMostExpensiveItemsboolean or null

Indicates whether the discount should apply to the most expensive items first, relevant for product filter effects that discount a subset of valid products

SortOrderinteger(int32)

The sort order for displaying the effect in lists

UseRequirementProductsboolean

Indicates whether to use requirement products as the product list for this effect, this is applicable when the effect discounts specific products and the requirement also defines products

GenericQtynumber or null(double)

The quantity effect for the product filter, applicable when effects discounts specific products and the criteria is a specific quantity. Can be null for other effect types and when "all" products are discounted.

ProductListArray of objects(PromotionEffectProductListModel)

The list of product rules associated with this effect, applicable when the effect type involves product filtering

Changedstring or null

The date and time when this promotion effect setting was last changed.

ChangedBystring or null

The identifier of the user who last changed this promotion effect setting.

{ "Id": 0, "EffectType": "string", "IsDiscount": true, "IsFixedPrice": true, "Value": 0.1, "IsIncVat": true, "IgnoreNonDiscountable": true, "DiscountMostExpensiveItems": true, "SortOrder": 0, "UseRequirementProducts": true, "GenericQty": 0.1, "ProductList": [ {} ], "Changed": "string", "ChangedBy": "string" }

PromotionListModel

Represents a list model for promotions, including various localized fields and settings, except for requirements and effects. Promotions are used to define discounts and special offers that are automatically applied on baskets during the purchase process.

Idinteger(int32)

The promotion identifier

Namestring or null[ 0 .. 255 ] characters

The name of the promotion in the current culture

DefaultNamestring or null[ 0 .. 255 ] characters

The default name of the promotion used as fallback when no culture-specific name is available

IsNameInheritedboolean

Indicates whether the name is inherited from the default culture

SubHeaderstring or null[ 0 .. 255 ] characters

The sub header of the promotion in the current culture

DefaultSubHeaderstring or null[ 0 .. 255 ] characters

The default sub header of the promotion used as fallback when no culture-specific sub header is available

IsSubHeaderInheritedboolean

Indicates whether the sub header is inherited from the default culture

SubDescriptionstring or null

The sub description of the promotion in the current culture

DefaultSubDescriptionstring or null

The default sub description of the promotion used as fallback when no culture-specific sub description is available

IsSubDescriptionInheritedboolean

Indicates whether the sub description is inherited from the default culture

DescriptionHeaderstring or null[ 0 .. 255 ] characters

The description header of the promotion in the current culture

DefaultDescriptionHeaderstring or null[ 0 .. 255 ] characters

The default description header of the promotion used as fallback when no culture-specific description header is available

IsDescriptionHeaderInheritedboolean

Indicates whether the description header is inherited from the default culture

Descriptionstring or null

The description of the promotion in the current culture

DefaultDescriptionstring or null

The default description of the promotion used as fallback when no culture-specific description is available

IsDescriptionInheritedboolean

Indicates whether the description is inherited from the default culture

ImageKeystring or null(uuid)

The unique identifier for the promotion image

ImageUrlstring or null

The URL of the promotion image, deprecated, use ImageKey instead.

Codestring or null[ 0 .. 50 ] characters

The unique code identifying the promotion

ExclusivityTypestring or null

Exclusive promotion type: NotExclusive, Exclusive, IgnoreExclusivity. Default is NotExclusive

StartDatestring or null(date-time)

The start date when the promotion becomes active, null means active immediately, if status is Active and start date is in the future the promotion is considered "Coming"

EndDatestring or null(date-time)

The end date when the promotion expires, null means no end date, if status is Active and end date is in the past the promotion is considered "Ended"

CountLeftinteger or null(int32)

The number of usages left for this promotion, if AllowedUsageCount is set

AllowedUsageCountinteger or null(int32)

The maximum number of times this promotion can be used

UsageCountinteger or null(int32)

The total number of times this promotion has been used

UniqueUserUsageCountinteger or null(int32)

The number of unique users who have used this promotion

UniqueDiscountCodeCountinteger or null(int32)

The number of unique discount codes associated with this promotion

UniqueDiscountCodeUsedCountinteger or null(int32)

The number of unique discount codes that have been used for this promotion

TotalOrdernumber or null(double)

The total order amount for this promotion

TotalDiscountnumber or null(double)

The total discount amount given by this promotion

DiscountPercentagenumber or null(double)

The discount percentage applied by this promotion

MarginPercentagenumber or null(double)

The margin percentage for this promotion

IsStackableboolean or null

Indicates whether this promotion can be stacked with itself. If true, multiples of the same promotion can be applied, like 3 for 2 deals (6 for 4, etc.). If false, the promotion can only be applied once per order.

IsProductReqboolean

Indicates whether this promotions products can be listed from API calls. If true, products can be listed in a front-end application when building a promotion bundle configuration UI. like choose products to buy with this promotion.

ExcludeFromPriceCalculationboolean

Indicates whether this promotion should be excluded from basket total price, so that other promotions are not validated based on the discounted price from this promotion.

Statusstring or null

Promotion status: Inactive, Active, Draft. Default is Inactive

CurrencyCodestring or null

The currency code for this promotion

StoppedDatestring or null(date-time)

The date and time when the promotion was stopped

StoppedByinteger or null(int32)

The identifier of the user who stopped this promotion

StoppedByNamestring or null

The name of the user who stopped this promotion

Createdstring(date-time)

The date and time when the promotion was created

CreatedByNamestring or null

The name of the user who created this promotion

Changedstring or null

The date and time when the promotion was last changed

ChangedBystring or null

Fullname or Systemname of the user who last changed the promotion

CulturesArray of objects(PromotionCultureModel)

The list of culture-specific translations for this promotion

{ "Id": 0, "Name": "string", "DefaultName": "string", "IsNameInherited": true, "SubHeader": "string", "DefaultSubHeader": "string", "IsSubHeaderInherited": true, "SubDescription": "string", "DefaultSubDescription": "string", "IsSubDescriptionInherited": true, "DescriptionHeader": "string", "DefaultDescriptionHeader": "string", "IsDescriptionHeaderInherited": true, "Description": "string", "DefaultDescription": "string", "IsDescriptionInherited": true, "ImageKey": "9afa8b7e-ca15-438f-a9d6-f679c437e59c", "ImageUrl": "string", "Code": "string", "ExclusivityType": "string", "StartDate": "2019-08-24T14:15:22Z", "EndDate": "2019-08-24T14:15:22Z", "CountLeft": 0, "AllowedUsageCount": 0, "UsageCount": 0, "UniqueUserUsageCount": 0, "UniqueDiscountCodeCount": 0, "UniqueDiscountCodeUsedCount": 0, "TotalOrder": 0.1, "TotalDiscount": 0.1, "DiscountPercentage": 0.1, "MarginPercentage": 0.1, "IsStackable": true, "IsProductReq": true, "ExcludeFromPriceCalculation": true, "Status": "string", "CurrencyCode": "string", "StoppedDate": "2019-08-24T14:15:22Z", "StoppedBy": 0, "StoppedByName": "string", "Created": "2019-08-24T14:15:22Z", "CreatedByName": "string", "Changed": "string", "ChangedBy": "string", "Cultures": [ {} ] }

PromotionModel

Represents a detailed model for promotions, including requirements and effects, in addition to the fields provided in PromotionListModel. Promotions are used to define discounts and special offers that are automatically applied on baskets during the purchase process.

RequirementsArray of objects(PromotionRequirementSettingModel)

The list of requirements that must be met for this promotion to be applied

EffectsArray of objects(PromotionEffectSettingModel)

The list of effects that will be applied when this promotion is triggered

Idinteger(int32)

The promotion identifier

Namestring or null[ 0 .. 255 ] characters

The name of the promotion in the current culture

DefaultNamestring or null[ 0 .. 255 ] characters

The default name of the promotion used as fallback when no culture-specific name is available

IsNameInheritedboolean

Indicates whether the name is inherited from the default culture

SubHeaderstring or null[ 0 .. 255 ] characters

The sub header of the promotion in the current culture

DefaultSubHeaderstring or null[ 0 .. 255 ] characters

The default sub header of the promotion used as fallback when no culture-specific sub header is available

IsSubHeaderInheritedboolean

Indicates whether the sub header is inherited from the default culture

SubDescriptionstring or null

The sub description of the promotion in the current culture

DefaultSubDescriptionstring or null

The default sub description of the promotion used as fallback when no culture-specific sub description is available

IsSubDescriptionInheritedboolean

Indicates whether the sub description is inherited from the default culture

DescriptionHeaderstring or null[ 0 .. 255 ] characters

The description header of the promotion in the current culture

DefaultDescriptionHeaderstring or null[ 0 .. 255 ] characters

The default description header of the promotion used as fallback when no culture-specific description header is available

IsDescriptionHeaderInheritedboolean

Indicates whether the description header is inherited from the default culture

Descriptionstring or null

The description of the promotion in the current culture

DefaultDescriptionstring or null

The default description of the promotion used as fallback when no culture-specific description is available

IsDescriptionInheritedboolean

Indicates whether the description is inherited from the default culture

ImageKeystring or null(uuid)

The unique identifier for the promotion image

ImageUrlstring or null

The URL of the promotion image, deprecated, use ImageKey instead.

Codestring or null[ 0 .. 50 ] characters

The unique code identifying the promotion

ExclusivityTypestring or null

Exclusive promotion type: NotExclusive, Exclusive, IgnoreExclusivity. Default is NotExclusive

StartDatestring or null(date-time)

The start date when the promotion becomes active, null means active immediately, if status is Active and start date is in the future the promotion is considered "Coming"

EndDatestring or null(date-time)

The end date when the promotion expires, null means no end date, if status is Active and end date is in the past the promotion is considered "Ended"

CountLeftinteger or null(int32)

The number of usages left for this promotion, if AllowedUsageCount is set

AllowedUsageCountinteger or null(int32)

The maximum number of times this promotion can be used

UsageCountinteger or null(int32)

The total number of times this promotion has been used

UniqueUserUsageCountinteger or null(int32)

The number of unique users who have used this promotion

UniqueDiscountCodeCountinteger or null(int32)

The number of unique discount codes associated with this promotion

UniqueDiscountCodeUsedCountinteger or null(int32)

The number of unique discount codes that have been used for this promotion

TotalOrdernumber or null(double)

The total order amount for this promotion

TotalDiscountnumber or null(double)

The total discount amount given by this promotion

DiscountPercentagenumber or null(double)

The discount percentage applied by this promotion

MarginPercentagenumber or null(double)

The margin percentage for this promotion

IsStackableboolean or null

Indicates whether this promotion can be stacked with itself. If true, multiples of the same promotion can be applied, like 3 for 2 deals (6 for 4, etc.). If false, the promotion can only be applied once per order.

IsProductReqboolean

Indicates whether this promotions products can be listed from API calls. If true, products can be listed in a front-end application when building a promotion bundle configuration UI. like choose products to buy with this promotion.

ExcludeFromPriceCalculationboolean

Indicates whether this promotion should be excluded from basket total price, so that other promotions are not validated based on the discounted price from this promotion.

Statusstring or null

Promotion status: Inactive, Active, Draft. Default is Inactive

CurrencyCodestring or null

The currency code for this promotion

StoppedDatestring or null(date-time)

The date and time when the promotion was stopped

StoppedByinteger or null(int32)

The identifier of the user who stopped this promotion

StoppedByNamestring or null

The name of the user who stopped this promotion

Createdstring(date-time)

The date and time when the promotion was created

CreatedByNamestring or null

The name of the user who created this promotion

Changedstring or null

The date and time when the promotion was last changed

ChangedBystring or null

Fullname or Systemname of the user who last changed the promotion

CulturesArray of objects(PromotionCultureModel)

The list of culture-specific translations for this promotion

{ "Requirements": [ {} ], "Effects": [ {} ], "Id": 0, "Name": "string", "DefaultName": "string", "IsNameInherited": true, "SubHeader": "string", "DefaultSubHeader": "string", "IsSubHeaderInherited": true, "SubDescription": "string", "DefaultSubDescription": "string", "IsSubDescriptionInherited": true, "DescriptionHeader": "string", "DefaultDescriptionHeader": "string", "IsDescriptionHeaderInherited": true, "Description": "string", "DefaultDescription": "string", "IsDescriptionInherited": true, "ImageKey": "9afa8b7e-ca15-438f-a9d6-f679c437e59c", "ImageUrl": "string", "Code": "string", "ExclusivityType": "string", "StartDate": "2019-08-24T14:15:22Z", "EndDate": "2019-08-24T14:15:22Z", "CountLeft": 0, "AllowedUsageCount": 0, "UsageCount": 0, "UniqueUserUsageCount": 0, "UniqueDiscountCodeCount": 0, "UniqueDiscountCodeUsedCount": 0, "TotalOrder": 0.1, "TotalDiscount": 0.1, "DiscountPercentage": 0.1, "MarginPercentage": 0.1, "IsStackable": true, "IsProductReq": true, "ExcludeFromPriceCalculation": true, "Status": "string", "CurrencyCode": "string", "StoppedDate": "2019-08-24T14:15:22Z", "StoppedBy": 0, "StoppedByName": "string", "Created": "2019-08-24T14:15:22Z", "CreatedByName": "string", "Changed": "string", "ChangedBy": "string", "Cultures": [ {} ] }