Heads up, our devs are blazing ahead—docs are catching up, so some features might not be fully documented yet.

Product

Product

List brands

get
/tenants/{tenantUid}/brands

List all brands.

Required permission: TENANT.ACCESS

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
brandNamestringOptional

Reference to the name of a brand.

brandExternalIdstringOptional

External reference to a brand.

pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
Responses
200

Example response

application/json
get
/tenants/{tenantUid}/brands
200

Example response

Create a new brand

post
/tenants/{tenantUid}/brands

Create a new brand.

Required permission: TENANT.BACKOFFICE

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Body
and
Responses
200

Brand

application/json
post
/tenants/{tenantUid}/brands
200

Brand

Search brands

post
/tenants/{tenantUid}/brands/search

Searches for brands based on criteria set in the request body. Required permission: TENANT.ACCESS

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
Body
exactMatchbooleanOptional
querystringOptional
Responses
200

Example response

application/json
post
/tenants/{tenantUid}/brands/search
200

Example response

Get brand details

get
/tenants/{tenantUid}/brands/{brandUid}

Get details for a brand.

Required permission: TENANT.ACCESS

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
brandUidstringRequired

Reference to a Brand.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Responses
200

Brand

application/json
get
/tenants/{tenantUid}/brands/{brandUid}
200

Brand

Update brand details

put
/tenants/{tenantUid}/brands/{brandUid}

Update details for a brand. Partial updates are allowed.

Required permission: TENANT.BACKOFFICE

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
brandUidstringRequired

Reference to a Brand.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Body
externalIdstringOptional
namestringRequired
Responses
200

Brand

application/json
put
/tenants/{tenantUid}/brands/{brandUid}
200

Brand

Delete a brand

delete
/tenants/{tenantUid}/brands/{brandUid}

Deletes the a brand.

Required permission: TENANT.BACKOFFICE

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
brandUidstringRequired

Reference to a Brand.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Responses
delete
/tenants/{tenantUid}/brands/{brandUid}

No content

List products

get
/tenants/{tenantUid}/products

Lists all products.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
productNamestringOptional

Reference to the name of a product.

productBrandUidstringOptional

Reference to a Brand uid.

Pattern: ^[A-Za-z0-9-_]+
productGroupUidstringOptional

Reference to a ProductGroup uid.

Pattern: ^[A-Za-z0-9-_]+
productExternalIdstringOptional

External reference to a product.

productPropertyUidsstring[]Optional

Reference to a list of propertyUids.

productPropertyOptionUidsstring[]Optional

Reference to a list of property options.

pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
excludeVariantsbooleanOptional

Exclude product variants.

includeDiscontinuedbooleanOptional

Include discontinued products

hideNotAllowPurchasebooleanOptional

when true, only show products with allowPurchase = true

Responses
200

Example response

application/json
get
/tenants/{tenantUid}/products
200

Example response

Create a new product

post
/tenants/{tenantUid}/products

CONFIGURABLEproducts must have at least one required variant property UID.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Body
allowCreditbooleanOptional
allowPurchasebooleanOptional
allowQuantitybooleanOptional
allowSalestring · enumOptional
ENUM Description
YES Allow the product to be sold
NO Do not allow the product to be sold
NOT_BEFORE_DATE Do not allow the product to be sold before a specified date
Possible values:
allowSaleDatestring · date-timeOptional
allowDeliverystring · enumOptional
ENUM Description
YES Allow the product to be delivered
NO Do not allow the product to be delivered
NOT_BEFORE_DATE Do not allow the product to be delivered before a specified date
Possible values:
allowDeliveryDatestring · date-timeOptional
availableForWebbooleanOptional

The product is available for web sale

brandUidstringRequiredPattern: ^[A-Za-z0-9-_]+
calculationFactorintegerOptional
customerAgeRestrictionintegerOptional

Age restriction for the customer. 0 = no restriction

categoryUidsstring[]Optional
descriptionstringOptional
discontinuedFromstring · date-timeOptional
externalIdstringOptional
externalInfostringOptional
externalUrlstringOptional
heightintegerOptional
internalInfostringOptional
ledgerNumberstringOptional

Ledger number must be a valid number with possible leading zeros

lengthintegerOptional
namestringRequired
priceOverridebooleanOptional
productUidstringOptionalPattern: ^[A-Za-z0-9-_]+
productGroupUidstringRequiredPattern: ^[A-Za-z0-9-_]+
productTypestring · enum · min: 1Required
ENUM Description
STOCK Price*quantity
NO_STOCK No quantity
CONFIGURABLE Master configurable product
FLOWGIFTCARD Flow Giftcard product
NON_PHYSICAL Non physical product
PACKAGE_FIXED Packaged product with fixed content
PACKAGE_DYNAMIC Packaged product with dynamic content
Possible values:
recommendedRetailPriceintegerOptional
requiredVariantPropertyUidsstring[]Optional

A list of propertyUids that are required for each variant of this product.

serialNoRequiredstring · enumOptional
ENUM Description
NO No Serial number required
ON_SALE Can register serial number when selling a product (Serial number is optional)
ON_RECEIVE Must register serial number when receiving and selling product (Serial number is required)
Possible values:
shortDescriptionstringOptional
skustringRequired
manufacturerSkustringOptional
unitLabelstringOptional
vatCodeUidstringRequiredPattern: ^[A-Za-z0-9-_]+
weightintegerOptional
widthintegerOptional
commissionintegerOptional

A commission to be paid to the supplier after delivery.

visibilitystring · enumOptionalPossible values:
productWarrantyUidstringOptionalPattern: ^[A-Za-z0-9-_]*
excludeFromStatisticsbooleanOptionalDefault: false
purchasePriceintegerOptional
numberOfPiecesintegerOptional

Indicates how many packages/parts the product consists of.

limitToStoreUidsstring[]Optional

Limit the product to be used for a list of storeUids.

Responses
200

Example response

application/json
post
/tenants/{tenantUid}/products
200

Example response

Search products

post
/tenants/{tenantUid}/products/search

Searches for products based on criteria set in the request body.

If productGroupUid is set, productGroupScopes is omitted.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
Body
brandUidstringOptionalPattern: ^[A-Za-z0-9-_]+
exactMatchbooleanOptional
productGroupUidsstring[]Optional

Filter on product group UIDs

querystringOptional
supplierUidstringOptionalPattern: ^[A-Za-z0-9-_]+
propertyUidsstring[]Optional

Filter on property UIDs a product must be linked to

propertyOptionUidsstring[]Optional

Filter on property option UIDs a product must be linked to

productUidsstring[]Optional

A list of productUids to search for

hideVariantsbooleanOptional

Do not search in variant products.

includeDiscontinuedbooleanOptional
hideNotAllowPurchasebooleanOptional

when true, only show products with allowPurchase = true

Responses
200

Example response

application/json
post
/tenants/{tenantUid}/products/search
200

Example response

Print operations for products

post
/tenants/{tenantUid}/products/{productUid}/print

Do product-specific prints

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+
Body

The printerUid will be required when the peripheralUid is removed.

storeUidstringOptionalPattern: ^[A-Za-z0-9-_]+
typestring · enum · min: 1Required
ENUM Description
BARCODE Print barcode labels
Possible values:
templatestringRequired

Must be a valid template name from /v2/metadata/labels

peripheralUidstringOptionalDeprecatedPattern: ^[A-Za-z0-9-_]+
printerUidstringOptionalPattern: ^[A-Za-z0-9-_]+
copiesintegerOptional
serialnumbersstring[]Optional

Prints a label for each serial number, appending the serial number as barcode and plain text.

Responses
post
/tenants/{tenantUid}/products/{productUid}/print
204

No Content

No content

Get product details

get
/tenants/{tenantUid}/products/{productUid}

Get details for a product.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Responses
200

Example response

application/json
get
/tenants/{tenantUid}/products/{productUid}
200

Example response

Update product details

put
/tenants/{tenantUid}/products/{productUid}

Partial updates are allowed. On CONFIGURABLEproducts, the required variant property UID's can only be changed while no variant products have been added.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Body
allowCreditbooleanOptional
allowPurchasebooleanOptional
allowQuantitybooleanOptional
allowSalestring · enumOptional
ENUM Description
YES Allow the product to be sold
NO Do not allow the product to be sold
NOT_BEFORE_DATE Do not allow the product to be sold before a specified date
Possible values:
allowSaleDatestring · date-timeOptional
allowDeliverystring · enumOptional
ENUM Description
YES Allow the product to be delivered
NO Do not allow the product to be delivered
NOT_BEFORE_DATE Do not allow the product to be delivered before a specified date
Possible values:
allowDeliveryDatestring · date-timeOptional
availableForWebbooleanOptional

The product is available for web sale

brandUidstringOptionalPattern: ^[A-Za-z0-9-_]+
calculationFactorintegerOptional
categoryUidsstring[]Optional
customerAgeRestrictionintegerOptional

Age restriction for the customer. 0 = no restriction

descriptionstringOptional
discontinuedFromstring · date-time | nullableOptional
externalIdstringOptional
externalInfostringOptional
externalUrlstringOptional
heightintegerOptional
internalInfostringOptional
ledgerNumberstringOptional

Ledger number must be a valid number with possible leading zeros

lengthintegerOptional
namestringOptional
priceOverridebooleanOptional

Allow to override the price on an order

productGroupUidstringOptionalPattern: ^[A-Za-z0-9-_]+
recommendedRetailPriceintegerOptional
serialNoRequiredstring · enumOptional
ENUM Description
NO No Serial number required
ON_SALE Can register serial number when selling a product (Serial number is optional)
ON_RECEIVE Must register serial number when receiving and selling product (Serial number is required)
Possible values:
requiredVariantPropertyUidsstring[]Optional
shortDescriptionstringOptional
skustringOptional
manufacturerSkustringOptional
unitLabelstringOptional
vatCodeUidstringOptionalPattern: ^[A-Za-z0-9-_]+
weightintegerOptional
widthintegerOptional
commissionintegerOptional

A commission to be paid to the supplier after delivery.

visibilitystring · enumOptionalPossible values:
productWarrantyUidstringOptionalPattern: ^[A-Za-z0-9-_]*
excludeFromStatisticsbooleanOptional
purchasePriceintegerOptional
numberOfPiecesintegerOptional

Indicates how many packages/parts the product consists of.

limitToStoreUidsstring[]Optional

Limit the product to be used for a list of storeUids.

Responses
200

Example response

application/json
put
/tenants/{tenantUid}/products/{productUid}
200

Example response

Delete a product

delete
/tenants/{tenantUid}/products/{productUid}

Deletes a product.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Responses
delete
/tenants/{tenantUid}/products/{productUid}
204

No Content

No content

List all addons for a product and productLinkType

get
/tenants/{tenantUid}/products/{productUid}/addons

List all addons for a product and productLinkType

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
productLinkTypestring · enumOptional

Reference to a productLinkType.

Possible values:
Responses
200

Example response

application/json
get
/tenants/{tenantUid}/products/{productUid}/addons
200

Example response

get
/tenants/{tenantUid}/products/{productUid}/links

List all links for a product.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
productLinkTypestring · enumOptional

Reference to a productLinkType.

Possible values:
pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
Responses
200

Example response

application/json
get
/tenants/{tenantUid}/products/{productUid}/links
200

Example response

Create new product link

post
/tenants/{tenantUid}/products/{productUid}/links

Create new product link

Require role tenant admin

Authorizations
AuthorizationstringRequired

Token received from the auth service

Path parameters
productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Body
linkTypestring · enumRequiredPossible values:
productUidstringRequiredPattern: ^[A-Za-z0-9-_]+
productLinkUidstringOptionalPattern: ^[A-Za-z0-9-_]+
Responses
200

Example response

application/json
Responseall of
post
/tenants/{tenantUid}/products/{productUid}/links
200

Example response

get
/tenants/{tenantUid}/products/{productUid}/links/parents

List all parent links for a product.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
productLinkTypestring · enumOptional

Reference to a productLinkType.

Possible values:
pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
Responses
200

Example response

application/json
get
/tenants/{tenantUid}/products/{productUid}/links/parents
200

Example response

get
/tenants/{tenantUid}/products/{productUid}/links/{productLinkUid}

Get Product link details

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
productLinkUidstringRequired

Reference to a Product link.

Pattern: ^[A-Za-z0-9-_]+
Responses
200

Example response

application/json
Responseall of
get
/tenants/{tenantUid}/products/{productUid}/links/{productLinkUid}
200

Example response

delete
/tenants/{tenantUid}/products/{productUid}/links/{productLinkUid}

Delete a product link

Require role tenant admin

Authorizations
AuthorizationstringRequired

Token received from the auth service

Path parameters
productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
productLinkUidstringRequired

Reference to a Product link.

Pattern: ^[A-Za-z0-9-_]+
Responses
delete
/tenants/{tenantUid}/products/{productUid}/links/{productLinkUid}
204

No Content

No content

Get new generated SKU

post
/tenants/{tenantUid}/products/sku

Get new generated SKU.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Body
typestring · enumRequiredPossible values:
Responses
post
/tenants/{tenantUid}/products/sku
201

Example response

Last updated

Was this helpful?