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

ParametricListModel

Parametric List model, represents a predefined list of values for a parametric attribute. Used when the parametric type is set to "list".

Idinteger(int32)

Internal identifier for the parametric list item. Client-specific.

Example: 20
ParametricIdinteger(int32)

The identifier of the parametric this list item belongs to.

Example: 8
Valuestring or null[ 0 .. 255 ] characters

The display value for the parametric list item in a specific language.

Example: "Anthracite grey/Green"
DefaultValuestring or null[ 0 .. 255 ] characters

The display value for the parametric list item in the default language.

Example: "Anthracite grey/Green"
IsValueInheritedboolean

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

Descriptionstring or null

A longer description for the parametric list item in a specific language. No size limit.

DefaultDescriptionstring or null

A longer description for the parametric list item in the default language. No size limit.

IsDescriptionInheritedboolean

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

Codestring or null[ 0 .. 50 ] characters

Unique code identifier for the parametric list item.

Example: "antracitgra-green"
ImageKeystring or null(uuid)

Unique blob identifier for an associated image.

ImageUrlstring or null[ 0 .. 255 ] characters

Deprecated, URL path to an associated image for the parametric list item.

IsActiveboolean

False if the parametric list item is soft deleted, removes it from selection lists but easily reactivatable.

Example: true
Changedstring or null

The date and time when the parametric list item was last changed.

Example: "03/05/2024 13:01"
ChangedBystring or null

The name of the user who last changed the parametric list item, null if never changed.

CulturesArray of objects(ParametricListCultureModel)

List of all culture-specific text fields for the parametric list item.

Example: [{"CultureCode":"en-GB","Value":"Anthracite grey/Green","IsValueInherited":false,"Description":"","IsDescriptionInherited":false,"IsTranslated":true},{"CultureCode":"sv-SE","Value":"Antracitgrå/Grön","IsValueInherited":false,"Description":null,"IsDescriptionInherited":true,"IsTranslated":true}]
{ "Id": 20, "ParametricId": 8, "Value": "Anthracite grey/Green", "DefaultValue": "Anthracite grey/Green", "IsValueInherited": false, "Description": "", "DefaultDescription": "", "IsDescriptionInherited": false, "Code": "antracitgra-green", "ImageKey": null, "ImageUrl": "", "IsActive": true, "Changed": "03/05/2024 13:01", "ChangedBy": null, "Cultures": [ {}, {} ] }

ParametricModel

Parametric model, represents an attribute that can be assigned to products to describe and differentiate them. Parametrics can be of various types such as text, number, date, boolean, or selection(s) from a predefined list (code list). They can also be grouped into parametric groups for better organization.

Idinteger(int32)

Internal identifier for the parametric. Client-specific.

Namestring or null[ 0 .. 50 ] characters

The parametric name in a specific language.

DefaultNamestring or null[ 0 .. 50 ] characters

The parametric 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[ 0 .. 500 ] characters

A longer description for the parametric explaining it in more detail.

DefaultDescriptionstring or null[ 0 .. 500 ] characters

The parametric description in the default language.

IsDescriptionInheritedboolean

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

Uomstring or null[ 0 .. 50 ] characters

Unit of measurement for the parametric value. This is a text field allowing any unit to be specified. Used in presentation views in front-end.

DefaultUomstring or null[ 0 .. 50 ] characters

The unit of measurement in the default language.

IsUomInheritedboolean

If true, the unit of measurement is inherited from the default language.

Typestringrequired

The type of parametric. Valid values: text, html, int, decimal, date, boolean, list, multiple.

TypeNamestring or null

Human-readable name for the parametric type. (e.g., Text, HTML, Integer, Decimal, Date, Boolean, List, Multiple list).

GroupIdinteger or null(int32)

The identifier of the parametric group this parametric belongs to.

GroupNamestring or null

The name of the parametric group this parametric belongs to.

IsRequiredboolean

Indicates whether this parametric is required when assigned to a product. If true, this parametrics is marked as mandatory in admin and front-end interfaces.

IsFavoriteboolean

Indicates whether this parametric is marked as a favorite for quick access in the Admin interface.

IsReadOnlyboolean

Indicates whether this parametric is read-only and cannot be modified in the Admin interface. Can still be changed programmatically, using connect API.

IsHiddenboolean

Indicates whether this parametric is hidden from the user interface. If true, it will be marked as hidden in front-end facing api models.

IsPublicboolean

Called "Global" in the Admin interface. Indicates whether this parametric is by default available on all categories (on all products).

DefaultIsVariantUniqueboolean

Indicates that the parametric will default to variants when merging products.

IsActiveboolean

False if the parametric is soft deleted, removes it from the admin interface and non-functional but easily reactivatable. Note that product data on this parametric is not deleted but not accessible through normal means, until reactivated.

Editorstring or null[ 0 .. 16 ] characters

The editor type used for input of this parametric. Type must be "html" and the choices are e.g. "text" and "html". Only used in Admin interface.

Codestring or null[ 0 .. 50 ] characters

Parametric code with string length of 50. Important to set and should be unique across all parametrics.

CodeListKeystring or null[ 0 .. 50 ] characters

Deprecated functionality, used as a collection identifier from external product sources.

Changedstring or null

The date and time when the Parametric entity was last changed.

ChangedBystring or null

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

CulturesArray of objects(ParametricCultureModel)

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

ShowOnTextTabboolean

Indicates whether this parametric should be shown on the text tab in the Admin interface.

ShowInListboolean

Makes this parametric available when listing products through the API. Only valid for List and multiple list types.

{ "Id": 0, "Name": "string", "DefaultName": "string", "IsNameInherited": true, "Description": "string", "DefaultDescription": "string", "IsDescriptionInherited": true, "Uom": "string", "DefaultUom": "string", "IsUomInherited": true, "Type": "string", "TypeName": "string", "GroupId": 0, "GroupName": "string", "IsRequired": true, "IsFavorite": true, "IsReadOnly": true, "IsHidden": true, "IsPublic": true, "DefaultIsVariantUnique": true, "IsActive": true, "Editor": "string", "Code": "string", "CodeListKey": "string", "Changed": "string", "ChangedBy": "string", "Cultures": [ {} ], "ShowOnTextTab": true, "ShowInList": true }

ParametricMultipleCultureModel

CultureCodestring or null[ 0 .. 16 ] characters

The culture code, e.g. "sv-SE" or "en-US".

Valuestring or null[ 0 .. 255 ] characters

The display value for the parametric multiple item in the specific language.

IsValueInheritedboolean

Indicates whether the parametric multiple item value is inherited from the default language.

Descriptionstring or null

The parametric multiple item description in the specific language. No size limit.

IsDescriptionInheritedboolean

Indicates whether the parametric multiple item description is inherited from the default language.

IsTranslatedboolean

Indicates whether any of the fields have been translated for this culture.

{ "CultureCode": "string", "Value": "string", "IsValueInherited": true, "Description": "string", "IsDescriptionInherited": true, "IsTranslated": true }