Create price list
create_price_listCreate a price list with a percent discount or markup off catalogue prices plus optional fixed prices per product, then assign it to companies or customers and publish it to sales channels.
Instructions
Create a price list: a percent off the catalogue (percentOff, -1000 to 99.99 with 2 decimals, default 0; negative = a markup) plus fixed prices per product or variant added with set_price_list_entry / set_price_list_entries. A fixed price overrides the percent for its product or variant; every other product gets the catalogue price minus percentOff. Then assign it to a company (set_company_price_list) or to a customer without a company (set_customer_price_list) - each buyer has one list: a company's members pay the company's list. startsAt / endsAt limit when it prices; outside that window its buyers pay catalogue prices. channels publishes it to sales channels by key: storefronts sending that channel are priced from it (a buyer's own or company list still wins for every product it prices), and anyone can read the prices of a list published to a PUBLIC channel.
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": {
"name": "<name>"
},
"name": "create_price_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The list's name, unique in the workspace (e.g. 'Gold') | |
| endsAt | No | ISO date-time the list stops pricing buyers at, later than startsAt. null clears it (no end); leave it out to keep it. Outside its window a list prices nobody: its buyers pay catalogue prices. | |
| channels | No | Keys of the sales channels to publish the list to (from list_sales_channels), at most 20. A channel takes one undated base list plus dated lists whose windows do not overlap; a clash is refused (CHANNEL_BASE_TAKEN or CHANNEL_WINDOW_OVERLAP). Anyone can read the prices of a list published to a PUBLIC channel. | |
| startsAt | No | ISO date-time the list starts pricing buyers from. null clears it (priced from now on); leave it out to keep it. | |
| percentOff | No | Percent taken off the catalogue price (and every volume break) of each product the list holds no fixed price for: -1000 to 99.99, at most two decimals (12.5 = 12.5% off). A negative value is a markup above the catalogue (-10 = 10% more). 0 = the list prices only through its fixed prices. |