Set price list entry
set_price_list_entrySet a fixed price, optional volume tiers, and quantity bounds for one product or variant in a price list, choosing the currency row and replacing any existing entry.
Instructions
Set a price list's fixed price for one product, or one variant of a product with variants (variantKey required there - a list prices each variant on its own, never the product as a whole; omit it for a product without variants). currency picks the row: omitted is the default-currency row, an additional currency writes that currency's own row, which prices only carts in it. The fixed price (minor units of the row's currency, with optional volume breaks) overrides the list's percentOff for that product or variant; replaces the entry already set for it as a whole, so an existing minQuantity / maxQuantity left out of the call is cleared - read it with get_price_list and re-send it to keep it. For many rows use set_price_list_entries.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"recordId": "<recordId>",
"price": "<price>",
"priceListId": "<priceListId>"
},
"name": "set_price_list_entry"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| price | Yes | Fixed unit price in minor units of the row's currency (the default currency when currency is omitted; 4900 = 49.00), above 0. Replaces the catalogue price and the list's percentOff for this product or variant; it may be above the catalogue price (a contract price). | |
| tiers | No | The entry's own volume breaks, minor units, each cheaper than the one below it and than the entry price. Omitted = none; the catalogue breaks do not carry over to a fixed price. | |
| currency | No | The row's currency: one of the workspace's additional currencies writes that currency's row; omit it (or send the default currency) for the default row. Each currency's row keeps its own price, tiers and quantity bounds, and prices only carts in its currency - nothing is converted | |
| recordId | Yes | Product record id | |
| variantKey | No | The variant's key - required for a product with variants (a list prices each variant separately, never the product as a whole); omit for a product without variants | |
| maxQuantity | No | Largest quantity (1-999) a buyer on this list may order, never above the cart's per-item cap; at least minQuantity. Omitted or null = no maximum beyond that cap. A write replaces the whole entry: re-send the bound it has or it is cleared. | |
| minQuantity | No | Smallest quantity (1-999) a buyer on this list may order of this product or variant. Omitted or null = no minimum. A write replaces the whole entry: re-send the bound it has or it is cleared. | |
| priceListId | Yes | The price list's id (from list_price_lists) |