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

ApplicationModel

Application model, represents a storefront for end customers to visit and purchase from, configured with currencies, countries, cultures, sales areas, payment methods, shipping methods, products, and much more.

Idinteger(int32)read-only

The environment wide unique internal Norce Id of the application

Keystring(guid)read-only

The unique key of the application

Namestring or null<= 50 characters

The friendly name of the application

Descriptionstring or null<= 500 characters

A longer description of the application

HostClientIdinteger(int32)

The Host Client Id that owns this application

Urlstring or null<= 255 characters

The URL of the application, e.g. "https://demo.shop.com"

ProductUrlstring or null<= 255 characters

The base URL of the product catalog for the application, used together with a product unique identifier to get the product page from the shop. The allowed "wildcards" are {uniqueurl}, {productid} and {partno}, e.g. "https://demo.shop.com/products/{productId}", "https://demo.shop.com/products/{partNo}" or "https://demo.shop.com/products/{uniqueUrl}"

IsActiveboolean

If false, the application is deactivated and cannot be used by customers

Changedstring or null

The date and time when the Application entity was last changed

ChangedBystring or null

The name of the user who last changed the Application entity, null if never changed

{ "Id": 0, "Key": "string", "Name": "string", "Description": "string", "HostClientId": 0, "Url": "string", "ProductUrl": "string", "IsActive": true, "Changed": "string", "ChangedBy": "string" }

CategoryModel

Category model, represents a product category used to group products together in a hierarchy, with support for localized names and descriptions, default values for its products, vat codes (per sales area), and various other settings. The Category contains a list of CategoryCulture models for each localized properties.

Idinteger(int32)

Internal identifier for the category. Client-specific.

Namestring or null[ 0 .. 50 ] characters

The category name in a specific language.

DefaultNamestring or null[ 0 .. 50 ] characters

The category name for the default language.

IsNameInheritedboolean

If true, the specific language doesn't have its own name and instead inherits from the default name.

Descriptionstring or null

A longer description for the category.

DefaultDescriptionstring or null

The category description in the default language.

IsDescriptionInheritedboolean

If true, the description is inherited from the default language rather than being its own text.

FullNamestring or null[ 0 .. 500 ] characters

Concatenated category name based on hierarchy. Format: root category - branch category - leaf category (for three levels).

DefaultFullNamestring or null[ 0 .. 500 ] characters

The full name in the default language.

IsFullNameInheritedboolean

If true, the full name is inherited from the default language rather than being its own text.

ParentIdinteger or null(int32)

The parent category's ID. Set this when placing a new category in the hierarchy.

ParentCodestring or null

The parent category code. You don't have to set this when setting ParentId.

ParentNamestring or null

The parent category name. You don't have to set this when setting ParentId.

SortOrderinteger(int32)

Decides where the category is positioned relative to other categories at the same level under the same parent.

IsDisplayOnlyboolean

Deprecated property with no specific function anymore.

ImageKeystring or null(guid)

Image code from Norce image store for a category image. Not commonly used anymore.

ImageUrlstring or null[ 0 .. 255 ] characters

Old property for image URL. Not used anymore.

Codestring or null[ 0 .. 50 ] characters

Category code with string length of 50. Important to set and should be unique in the category tree.

Synonymsstring or null[ 0 .. 500 ] characters

Comma-separated list of phrases or words that can be indexed in the search functionality.

DefaultSynonymsstring or null[ 0 .. 500 ] characters

Synonyms in the default language.

IsSynonymsInheritedboolean

If true, the synonyms are inherited from the default language rather than being its own text.

UnspcCodestring or null[ 0 .. 50 ] characters

Code field for storing global classification system according to UNSPSC standard.

BusinessAreastring or null[ 0 .. 50 ] characters

Code field that can be used for business area classification.

CommodityCodestring or null[ 0 .. 50 ] characters

Code field for commodity classification.

IntegrationPartNostring or null[ 0 .. 50 ] characters

External identifier for all products in the category. Optional field used to identify all products in one category in other systems.

FreightClassIdinteger or null(int32)

Not used anymore.

GrossWeightnumber or null(decimal)

Default gross weight value for all products in the category.

VatCodeIdinteger(int32)

Default VAT code for the current sales area (from the application) for all products in the category.

InheritedVatCodeIdinteger(int32)

default VAT code from the sales area.

IsVatCodeIdInheritedboolean

true if the VAT code is inherited from the sales area settings.

InheritedVatCodeNamestring or null

VAT code name for the inherited VAT code.

VatCodeIdInheritedFromstring or null

Explains where the VAT code is inherited from. Can be from the client setting or from the Norce default settings.

VatCodeNamestring or null

VAT code name for the current sales area.

VatCodeValuenumber(decimal)

VAT code value for the current sales area. 25.00 means 25% VAT.

InheritedVatCodeValuenumber(decimal)

VAT code value for the inherited VAT code. 25.00 means 25% VAT.

VatCodesArray of objects(SalesAreaVatCodeModel)

Different VAT codes for each sales area. If a client sales area is missing, the VAT code is inherited from client settings.

UnitOfMeasurementIdinteger or null(int32)

Default unit of measurement ID for all products in the category. Possible values: 1 (pcs), 2 (h), 3 (kg), 4 (l), 5 (pairs), 6 (sqm), 7 (m), 8 (boxes), 9 (rolls)

RecommendedSalesQtynumber or null(decimal)

Default recommended sales quantity for all products in the category.

IsReturnableboolean or null

Default value indicating whether products in the category are returnable.

IsDropShipOnlyboolean or null

Marks the products for dropshipping from the supplier directly.

PopulationRuleIdinteger(int32)

Not used anymore.

TrackingCodeTypeIdinteger or null(int32)

Not used anymore.

CompetitivePricingMinPercentagenumber or null(decimal)

Default minimum margin on competitor pricing rules for products in the category. Should only be used if competitor pricing is activated.

CompetitivePricingTargetPercentagenumber or null(decimal)

Default target margin on competitor pricing rules for products in the category. Should only be used if competitor pricing is activated.

HideInTopListboolean

Removes the products from popularity and other top list functionality in Norce.

StockDisplayBreakPointinteger or null(int32)

Availability threshold used for specific delivery promises at low stock levels.

IsRecommendedQtyFixedboolean or null

Flag that forces Norce to set order quantities as multiples of the recommended sales quantity.

IsRecurringOrderableboolean or null

Flag marking products or whole categories as recurring products that can be bought in subscriptions.

IsActiveboolean

False if the category is soft deleted, making it hidden and non-functional but easily reactivatable.

Changedstring or null

The date and time when the Category entity was last changed

ChangedBystring or null

The name of the user who last changed the Category entity, null if never changed

CulturesArray of objects(CategoryCultureModel)

List of all culture-specific text fields for the category.

{ "Id": 0, "Name": "string", "DefaultName": "string", "IsNameInherited": true, "Description": "string", "DefaultDescription": "string", "IsDescriptionInherited": true, "FullName": "string", "DefaultFullName": "string", "IsFullNameInherited": true, "ParentId": 0, "ParentCode": "string", "ParentName": "string", "SortOrder": 0, "IsDisplayOnly": true, "ImageKey": "string", "ImageUrl": "string", "Code": "string", "Synonyms": "string", "DefaultSynonyms": "string", "IsSynonymsInherited": true, "UnspcCode": "string", "BusinessArea": "string", "CommodityCode": "string", "IntegrationPartNo": "string", "FreightClassId": 0, "GrossWeight": 0, "VatCodeId": 0, "InheritedVatCodeId": 0, "IsVatCodeIdInherited": true, "InheritedVatCodeName": "string", "VatCodeIdInheritedFrom": "string", "VatCodeName": "string", "VatCodeValue": 0, "InheritedVatCodeValue": 0, "VatCodes": [ {} ], "UnitOfMeasurementId": 0, "RecommendedSalesQty": 0, "IsReturnable": true, "IsDropShipOnly": true, "PopulationRuleId": 0, "TrackingCodeTypeId": 0, "CompetitivePricingMinPercentage": 0, "CompetitivePricingTargetPercentage": 0, "HideInTopList": true, "StockDisplayBreakPoint": 0, "IsRecommendedQtyFixed": true, "IsRecurringOrderable": true, "IsActive": true, "Changed": "string", "ChangedBy": "string", "Cultures": [ {} ] }

SalesAreaVatCodeModel

Sales area VAT code model, used for displaying and managing VAT codes per sales area. Represents the relationship between sales areas and their associated VAT codes, including inheritance from default settings.

SalesAreaIdinteger(int32)

The sales area identifier that this VAT code is associated with

SalesAreaNamestring or null

The display name of the sales area in the current language

VatCodeIdinteger or null(int32)

The VAT code identifier specifically configured for this sales area. If null, the inherited VAT code will be used

InheritedVatCodeIdinteger(int32)

The VAT code identifier that is inherited from the sales area's default configuration

IsVatCodeIdInheritedboolean

Indicates whether the VAT code is inherited from the default configuration rather than being explicitly set for this sales area

VatCodeIdInheritedFromstring or null

Describes the source from which the VAT code is inherited (e.g., "Application", "System")

VatCodeNamestring or null

The display name of the VAT code currently assigned to this sales area

VatCodeValuenumber(decimal)

The tax rate value as a decimal for the VAT code currently assigned to this sales area

InheritedVatCodeNamestring or null

The display name of the inherited VAT code that would be used if no specific VAT code is configured

InheritedVatCodeValuenumber(decimal)

The tax rate value as a decimal for the inherited VAT code that would be used if no specific VAT code is configured

{ "SalesAreaId": 0, "SalesAreaName": "string", "VatCodeId": 0, "InheritedVatCodeId": 0, "IsVatCodeIdInherited": true, "VatCodeIdInheritedFrom": "string", "VatCodeName": "string", "VatCodeValue": 0, "InheritedVatCodeName": "string", "InheritedVatCodeValue": 0 }

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