Price List

The Price List object includes key pricing details such as sales and purchase prices, enabling vendors and operations to effectively manage and apply different price points for product items. This is essential for aligning pricing strategies with market and internal financial objectives.

This object contains the following attributes:

Field	Type	Description
id	string, core	(Read-only) The business identifier of the price list.
currency	string, core	The ISO code for the currency.
precision	integer	Precision of the pricelist as decimal places.
notes	string	The notes about the price list.
externalIds	object	Represents the externalIds object.
statistics	object	(Read-only) Represents the priceListStatistics object, which contains the system-calculated metrics about the price list.
product	object	(Read-only) Represents the product that the pricelist belongs to.
vendor	object	(Read-only) Represents the vendor account of the price list. The field is visible only to SoftwareOne Operations.
audit	object	(Read-only) Represents the audit object.

Pricelist Statistics object

This object contains the following attributes:

Field	Type	Description
sellers	integer	(Read-only) Number of sellers that are using this price list.
listings	integer	(Read-only) Number of listings that are using this price list.
priceListitems	integer	(Read-only) Total number of price list Items on the price list.
purchasePriceItems	integer	(Read-only) Number of Items with a populated purchase price.
purchasePriceCompleteness	integer	(Read-only) Percentage of Items with a populated purchase price.

Example

PRICE LIST OBJECT

{
  "id": "PRC-1234-5678-9012", 
  "currency": "EUR",
  "precision": 3,
  "defaultMarkup": 0.0869,
  "notes": "This is the primary Price List for the EU region",
  "statistics": {
    "sellers": 10,
    "listings": 12,
    "items": 23,
    "purchasePriceItems": 10,
    "purchasePriceCompleteness": 0.4347826,
    "salesPriceItems": 16,
    "salesPriceCompleteness": 0.6956521,
    "averageMarkup": 0.5405,
    "averageMargin": 0.4465
  },
  "product": {
    "id": "PRD-1234-5678"
  },
  "vendor": {
    "id": "ACC-1671-0642"
  }
}