Retrieve a product's net sales price in a certain location, or net sales price for a specific customer — according to any price lists that apply.
You can query prices for a single product (by supplying parameter productID) or multiple products at a time (by supplying parameter productIDs).
If you do not want a price for a specific customer or location, but just need to know which price lists contain a specific item, see getProductPricesInPriceLists.
Parameter name | Description | Possible value | Required |
---|---|---|---|
productID | integer | ||
productIDs | Multiple product IDs, separated by commas, such as: 1,2,3,4,5. Returns error 1162 if the list is longer than 10 000 elements. | string | |
clientID | Customer ID | integer | |
warehouseID | Sales location ID | integer | |
getPriceCalculationSteps | Set to 1 to retrieve a set of records detailing how price list price was received. This feature requires Classic back office, version 4.5.0 or newer. | 0 or 1 |
Field name | Type | Description | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
productID | string | ||||||||||||||||||||||
defaultPrice | string | Decimal string, 2...4 places. Price on product card. | |||||||||||||||||||||
defaultPriceWithVAT | number | Decimal, 2 places | |||||||||||||||||||||
specialPrice | string | Decimal string, 2...4 decimal places. Price that applies to this sales location or this customer. | |||||||||||||||||||||
specialPriceWithVAT | number | Decimal, 2 places | |||||||||||||||||||||
priceCalculationSteps | array | List of records. Each record looks like this:
API returns this attribute if parameter "getPriceCalculationSteps" is specified. |