Manage sale prices (specific prices)
ps_manage_specific_prices
Sets up, lists or removes sale prices for chosen dates.
Ask Claude
„Put 15% off all sofas from Friday to Sunday.”
Example preview
31 products, -15%, 2026-10-09 00:00 to 2026-10-11 23:59, all customer groups, from 1 unit. Product 112: 2,499.00 -> 2,124.15 PLN gross.
Technical details
Lists, adds or deletes specific prices of products, the same as Catalog > Product > Pricing > Specific prices: percent or amount off, start and end date, customer group, from a minimum quantity. action=list only reads. A reduction above 50% gets a warning, above 90% it needs allow_big_change. A promotion without an end date gets a warning.
Parameters
Parameter names are not confirmed in module 0.3.0 yet and may change.
| Name | Type | Required | Description |
|---|---|---|---|
| action | enum: list | add | delete | yes | list reads existing specific prices; add creates; delete removes. |
| products | array | no | Products to act on (add, list). |
| reduction_type | enum: percentage | amount | no | Percent or amount off (add). |
| reduction | number | no | Size of the reduction (add). |
| from | string (YYYY-MM-DD HH:MM) | no | Start date (add). |
| to | string (YYYY-MM-DD HH:MM) | no | End date (add). Missing end date gives a warning. |
| group_id | integer | no | Customer group (add). |
| from_quantity | integer | no | Minimum quantity (add). |
| specific_price_id | integer | no | ID to delete (delete). |
| allow_big_change | boolean | no | Must be true to accept a change above the tool's safety threshold. Claude sets it only after you approved that size of change. |
| shop_id | integer | no | Shop ID in a multistore installation. Defaults to the shop in the connector address. IDs are listed by ps_get_shop_info. |
| confirm | boolean | no | false (default) returns a preview and saves nothing. true executes, only after the user approved the preview, together with change_token. |
| change_token | string | when: confirm=true | Token from the preview. Required with confirm=true. Valid 30 minutes, single use, bound to the previewed arguments and data state. |
Limits
Reduction above 50%: warning. Above 90%: needs allow_big_change. No end date: warning.
What you see before anything is saved
Claude first calls the tool without confirming it. The module returns a preview (current and new values) and a single-use token valid for 30 minutes. Claude shows you the preview and saves the change only after your yes.
Related tools
- Update prices ps_update_prices
- Manage cart rules and voucher codes ps_manage_cart_rules
- Revert change ps_revert_change
Last updated: 2026-10-03