Products

Create or Update Products

ProductCreateProductsResponse Products.CreateProducts(, )

POST/api/v2/public/products

List Products

ProductListProductsResponse Products.ListProducts(, )

GET/api/v2/public/products

Delete Products

ProductDeleteProductsResponse Products.DeleteProducts(, )

DELETE/api/v2/public/products

Update Product Attributes

ProductUpdateProductAttributesResponse Products.UpdateProductAttributes(, )

PUT/api/v2/public/products/attributes

Create Prices

ProductCreatePricesResponse Products.CreatePrices(, )

POST/api/v2/public/products/prices

Create Discount Prices

ProductCreateDiscountPricesResponse Products.CreateDiscountPrices(, )

POST/api/v2/public/products/discountprices

Create Product Free Fields

ProductCreateProductFreeFieldsResponse Products.CreateProductFreeFields(, )

POST/api/v2/public/products/freefields

ModelsExpand Collapse

class ProductItem:

Full product details returned from the products GET endpoint, including units, barcodes, pricing, and store/country assignments.

required string Barcode

Primary barcode for the product.

required Double CarrierItemQuantity

formatdouble

required Int EditMinMaxPercentage

How far store staff may move the minimum and maximum levels, as a percentage. Comes from the product’s category, not the product itself.

formatint32

required Double PriceCompareMultiplier

Multiplier applied with price_compare_unit to work out the comparison price.

formatdouble

required string ProductName

Display name of the product.

required string ProductNumber

Unique product number.

required Int ShelfLabelQuantity

Number of shelf labels to print.

formatint32

Boolean? AllowDecimal

true when the product can be counted in fractions, such as weighed goods.

string? AttentionCode

Attention code that flags the product for special handling.

Double? AverageWeight

Average weight of one unit, for products sold by weight.

formatdouble

string? BarcodesArray

All barcodes for the product, beyond the primary one.

string? BaseUnitName

Name of the unit the product is counted in.

string? BrandCode

Brand code in the source system.

string? BrandDescription

Brand name.

string? CategoryCode

Category the product belongs to. Matches category_code on the categories endpoint.

string? Color

Colour name, for products with variants.

string? ColorCode

Colour code, for products with variants.

IReadOnlyList<string>? CountriesAllowed

Countries where the product may be sold. Empty means all countries.

IReadOnlyList<string>? CountriesNotAllowed

Countries where the product may not be sold.

string? CountryCode

Country the product belongs to.

DateTimeOffset? DeprecationDate

Date the product stops being sold. Formatted yyyyMMdd.

formatdate-time

Int? ExpirationMinRange

Number of days before expiry at which the product should be acted on.

formatint32

IReadOnlyList<FreeField>? FreeFields

Free key/value fields carried against the product.

required Int SortOrder

Order the field is shown in.

formatint32

string? Key

Name of the free field.

string? Value

Value of the free field.

string? GeneralLedger

General ledger account the product books to.

string? ImageUrl

Link to the product image.

Boolean? IsActive

false when the product is no longer sold.

Boolean? IsCounted

true when the product is included in stock counts.

Boolean? IsEditMinMax

true when store staff may change the minimum and maximum levels.

Boolean? IsEditReplenishment

true when store staff may change the replenishment settings.

Boolean? IsExpiration

true when the product has an expiry date that has to be tracked.

Boolean? IsOrderManually

true when the product is ordered by hand instead of by replenishment.

Boolean? IsPromotion

true when the product is currently on promotion.

Boolean? IsSet

true when the product is a set made up of other products.

Boolean? IsStock

true when stock is tracked for this product.

Boolean? IsStoreProduct

true when the product is ranged in the store the request was scoped to.

Boolean? IsTemplate

true when the product is a template rather than a sellable item.

string? MarginCategory

Margin category used for reporting.

Double? Moq

Minimum order quantity. Orders below this are not placed.

formatdouble

Double? OldPrice

Previous sales price, kept so a price change can be shown.

formatdouble

Double? Price

Current sales price.

formatdouble

string? PriceCompareUnit

Unit the comparison price is expressed in, such as a litre or a kilo.

string? PriceLines

string? ProductDetails

Free text description of the product.

string? ProductType

Type of product, used to drive handling in the app.

string? ProductUrl

Link to the product page.

IReadOnlyList<string>? PromoStoresAllowed

Store numbers where the promotion applies. Empty means all stores.

IReadOnlyList<string>? PromoStoresNotAllowed

Store numbers where the promotion does not apply.

string? Promotion

Promotion the product is part of.

Double? PromotionPrice

Price while the product is on promotion.

formatdouble

string? PromotionWeek

Week the promotion runs in.

Double? PurchasePrice

Price paid to the supplier.

formatdouble

string? PurchaseUnitBarcode

Barcode of the unit the product is ordered in.

string? PurchaseUnitName

Name of the unit the product is ordered in.

string? PurchaseUnitProductNumber

Product number of the purchase unit, when it differs from this product.

Double? PurchaseUnitQuantity

How many base units are in one purchase unit.

formatdouble

string? ReferralProductID

Boolean? ResetStoreStock

IReadOnlyList<SetProduct>? SetProduct

The products that make up the set, with their quantities.

string? SetItemQuantity

How many of that component the set contains.

string? SetProductNumber

Product number of a component in the set.

Boolean? ShelfLabel

true when a shelf label should be printed for this product.

Boolean? ShelfLabelBarcode

true when the shelf label shows the barcode.

Int? ShelfLabelLayout

Layout used when printing a shelf label.

formatint32

Boolean? ShelfLabelPrice

true when the shelf label shows the price.

string? Size

Size name, for products with variants.

string? SizeCode

Size code, for products with variants.

string? SmallestProductNumber

Product number of the smallest sellable unit, when this product is a larger pack.

Double? SmallestQuantity

How many of the smallest unit this product contains.

formatdouble

Double? SpecialPrice

Temporary price that overrides the normal one while it applies.

formatdouble

IReadOnlyList<string>? StoresAllowed

Store numbers where the product may be sold. Empty means all stores.

IReadOnlyList<string>? StoresNotAllowed

Store numbers where the product may not be sold.

string? SupplierID

Supplier code. Matches supplier_code on the suppliers endpoint.

string? SupplierName

Supplier name.

string? SupplierProductNumber

The supplier’s own number for this product.

IReadOnlyList<Unit>? Units

The units the product can be handled in, each with its own barcode and quantity.

required Double UnitQuantity

How many base units this unit contains.

formatdouble

string? UnitBarcode

Barcode for this unit.

string? UnitName

Name of the unit.

string? VariantCode

Code that identifies this specific variant.

Double? VariantFactor

formatdouble

string? VariantFamily

Code shared by all variants of the same product.

string? Volume

Volume or content of the product, as text.