Management API (v1)

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

Download OpenAPI description
Languages
Servers

https://customer-slug.api-se.playground.norce.tech/commerce/management/1.0/

Schemas

PriceListPricingModel

PriceListPricing model, represents price rules applied to a price list based on various criteria.

Idinteger(int32)

The unique identifier of the price list pricing rule

PriceListIdinteger(int32)

The identifier of the price list this pricing rule belongs to

CategoryIdinteger or null(int32)

The identifier of the category this pricing rule applies to

CategoryNamestring or null

The name of the category this pricing rule applies to

CategoryPathstring or null

The hierarchical path of the category this pricing rule applies to

CategoryParentCountinteger(int32)

The number of parent categories in the category hierarchy

CategoryCodestring or null

The code of the category this pricing rule applies to

ManufacturerIdinteger or null(int32)

The identifier of the manufacturer this pricing rule applies to

ManufacturerNamestring or null

The name of the manufacturer this pricing rule applies to

ManufacturerCodestring or null

The code of the manufacturer this pricing rule applies to

FlagsArray of (IdNameCodeModel (object or null))

The collection of flags associated with this pricing rule

FlagIdSeedstring or null[ 0 .. 1000 ] characters

The seed string containing flag identifiers for this pricing rule

FlagNamesArray of strings or null or null

The collection of flag names associated with this pricing rule

MinValuenumber or null(decimal)

The minimum value threshold for this pricing rule to apply

MaxValuenumber or null(decimal)

The maximum value threshold for this pricing rule to apply

PriceRuleIdinteger or null(int32)

The identifier of the built-in price rule used in this pricing configuration

PriceRuleNamestring or null

The name of the built-in price rule used in this pricing configuration

PriceRuleLabelstring or null

The label of the built-in price rule used in this pricing configuration

PriceRuleValuenumber or null(decimal)

The value associated with the price rule in this pricing configuration, depending on the built-in rule type this value can be rebate, margin, uplift, or fixed price. See documentation for more information.

PriceRuleUnitstring or null

The unit of the price rule value, usually percent or amount.

KickbackPercentagenumber or null(decimal)

The kickback percentage applied in this pricing rule, not normally used.

MinimumProductMarginPercentagenumber or null(decimal)

The minimum product margin percentage required for this pricing rule. Require purchase or unit costs on the products. Does not affect prixed price rules.

MinimumProductMarginPercentageIsInheritedboolean

Indicates whether the minimum product margin percentage is inherited from parent rules

PreferredPositioninteger or null(int32)

The preferred position order compared to competitors for this pricing rule when competive price rules are used.

LimitToPriceRecommendedboolean or null

Indicates whether sales price must not exceed the recommended price. Required by some manufacturers. Pricing rule will adjust price down if needed.

SupplementChargenumber or null(decimal)

The fixed supplement charge amount applied to the cost before price rule calculation by this pricing rule, ignored if SupplementChargePercentage is used. Valid for only cost based pricing rules.

SupplementChargePercentagenumber or null(decimal)

The supplement charge percentage applied to the cost before price rule calculation by this pricing rule. Valid for only cost based pricing rules.

IsActiveboolean

Indicates whether this pricing rule is currently active

Changedstring or null

The date and time when this pricing rule was last changed

ChangedBystring or null

The fullname or systemname of the user who last changed this pricing rule

{ "Id": 0, "PriceListId": 0, "CategoryId": 0, "CategoryName": "string", "CategoryPath": "string", "CategoryParentCount": 0, "CategoryCode": "string", "ManufacturerId": 0, "ManufacturerName": "string", "ManufacturerCode": "string", "Flags": [ {} ], "FlagIdSeed": "string", "FlagNames": [ "string" ], "MinValue": 0, "MaxValue": 0, "PriceRuleId": 0, "PriceRuleName": "string", "PriceRuleLabel": "string", "PriceRuleValue": 0, "PriceRuleUnit": "string", "KickbackPercentage": 0, "MinimumProductMarginPercentage": 0, "MinimumProductMarginPercentageIsInherited": true, "PreferredPosition": 0, "LimitToPriceRecommended": true, "SupplementCharge": 0, "SupplementChargePercentage": 0, "IsActive": true, "Changed": "string", "ChangedBy": "string" }

PriceListModel

PriceList model, represents a price list with its configuration and rules. Price lists define pricing and assortments for clients.

Idinteger(int32)

The unique identifier of the price list

PriceListIdinteger(int32)

The price list identifier

Namestring or null[ 0 .. 50 ] characters

The name of the price list

Descriptionstring or null

The description of the price list

Codestring or null[ 0 .. 50 ] characters

The agreement code for the price list

ImageKeystring or null(guid)

The unique key identifier for the price list image, not normally used.

ImageUrlstring or null[ 0 .. 255 ] characters

The URL path to the price list image, deprecated, not normally used.

TypeIdinteger(int32)

The type identifier of the price list

TypeNamestring or null

The name of the price list type

PriceRuleNamestring or null

The name of the default price rule associated with this price list

StartDatestring or null(date-time)

The start date when the price list becomes active

EndDatestring or null(date-time)

The end date when the price list becomes inactive

CurrencyIdinteger(int32)

The identifier for the currency the price list uses

CurrencyCodestring or null

The currency code for the currency the price list uses

CurrencyNamestring or null

The name of the currency used in the price list

SalesAreaIdinteger or null(int32)

The sales area identifier associated with this price list, if null, no specific sales area is assigned and is usually inherited from the application it is connected to or from the primary sales area of the client. This is primarily used for rounding rules, where rounding is calculated on the including VAT sale price.

SalesAreaNamestring or null

The name of the sales area associated with this price list

SalesAreaIdIsInheritedboolean

Indicates whether the sales area ID is inherited from parent

InheritedSalesAreaNamestring or null

The name of the inherited sales area, shows the current application sales area.

DefaultPriceRuleIdinteger or null(int32)

The default price rule identifier for this price list

DefaultPriceRuleValuenumber or null(decimal)

The value for the default price rule

DefaultSupplementChargePercentagenumber(decimal)

The default supplement charge percentage applied to products

DefaultSupplementChargenumber or null(decimal)

The default supplement charge amount applied to products

DefaultMinimumProductMarginPercentagenumber or null(decimal)

The default minimum product margin percentage

DefaultLimitToPriceRecommendedboolean or null

Indicates whether prices are limited to recommended prices

InheritStructureCalculationRuleinteger(int32)

The rule for inheriting structure calculation settings

ParentPriceListIdinteger or null(int32)

The identifier of the parent price list for inheritance. If null, some price rules are not working.

ParentPriceListNamestring or null

The name of the parent price list

PopulationRuleIdinteger(int32)

The population rule identifier used for product population

PopulationRuleNamestring or null

The name of the population rule

ChosenWarehouseIdinteger or null(int32)

The chosen warehouse identifier for this price list. The primary warehouse that is used for stock checking and availability.

ChosenLocationIdinteger or null(int32)

The chosen location identifier for this price list. The primary location that is used for stock checking and availability. This is usually used as the location receiving stock reservation by Norce shopping logic.

IsPrimaryboolean

Indicates whether this is the primary price list for the current application.

IsPublicboolean

Indicates whether the price list has prices that is publicly accessible from the application.

IsNotStartedboolean

Indicates whether the price list has not started yet

IsEndedboolean

Indicates whether the price list has ended.

IsVirtualboolean

Indicates whether this is a virtual price list. Virtual price lists are calculated in real-time and do not store prices. Requires a parent price list that provide the base information and assortment.

IsLimitedToStockboolean or null

Indicates whether the price list is limited to available stock. Currently not functional.

IsFavoriteboolean

Indicates whether this price list is marked as favorite in the current application in the admin interface.

IsActiveboolean

Indicates whether the price list is currently active, note this may still be a price list that has not started or has ended.

Changedstring or null

The date and time when the price list was last changed

ChangedBystring or null

Fullname or Systemname of the user who last changed the price list

{ "Id": 0, "PriceListId": 0, "Name": "string", "Description": "string", "Code": "string", "ImageKey": "string", "ImageUrl": "string", "TypeId": 0, "TypeName": "string", "PriceRuleName": "string", "StartDate": "2019-08-24T14:15:22Z", "EndDate": "2019-08-24T14:15:22Z", "CurrencyId": 0, "CurrencyCode": "string", "CurrencyName": "string", "SalesAreaId": 0, "SalesAreaName": "string", "SalesAreaIdIsInherited": true, "InheritedSalesAreaName": "string", "DefaultPriceRuleId": 0, "DefaultPriceRuleValue": 0, "DefaultSupplementChargePercentage": 0, "DefaultSupplementCharge": 0, "DefaultMinimumProductMarginPercentage": 0, "DefaultLimitToPriceRecommended": true, "InheritStructureCalculationRule": 0, "ParentPriceListId": 0, "ParentPriceListName": "string", "PopulationRuleId": 0, "PopulationRuleName": "string", "ChosenWarehouseId": 0, "ChosenLocationId": 0, "IsPrimary": true, "IsPublic": true, "IsNotStarted": true, "IsEnded": true, "IsVirtual": true, "IsLimitedToStock": true, "IsFavorite": true, "IsActive": true, "Changed": "string", "ChangedBy": "string" }

PriceListSupplierPriceListModel

PriceListSupplierPriceList model, represents a supplier price list linked to a price list. Providing procurement data and other supplier product data for the product and price list. Allows for Chosen supplier functionality.

Idinteger(int32)

The unique identifier of the supplier price list

PriceListIdinteger(int32)

The unique identifier of the (client) price list

Namestring or null[ 0 .. 50 ] characters

The name of the supplier price list

SupplierNamestring or null

The name of the supplier

SupplierIdinteger(int32)

The unique identifier of the supplier

SupplierCodestring or null

The supplier code

SupplierCountrystring or null

The country of the supplier

SupplierIsChosenSupplierEnabledboolean

Indicates whether the supplier has chosen supplier functionality enabled

SupplierPriceListCurrencyCodestring or null

The currency code of the supplier price list

Codestring or null

The code of the supplier price list

Changedstring or null

The date and time when the record was last changed

ChangedBystring or null

Fullname or Systemname of the user who last changed the record

{ "Id": 0, "PriceListId": 0, "Name": "string", "SupplierName": "string", "SupplierId": 0, "SupplierCode": "string", "SupplierCountry": "string", "SupplierIsChosenSupplierEnabled": true, "SupplierPriceListCurrencyCode": "string", "Code": "string", "Changed": "string", "ChangedBy": "string" }

Settings ApplicationCountry

Operations

Settings ApplicationCulture

Operations

Settings ApplicationCurrency

Operations

Settings ApplicationSalesArea

Operations

Settings Application

Operations

Category

Operations

CategoryParametric

Operations

Settings ClientAssortment

Operations

Settings ClientCurrency

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 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