MyProduct: Update Price or Stock
update_managed_store_product[Store Products]
[What it does] Changes selling price, cost, compare-at price, currency, or stock for exact variants of one DSers-managed store product, and handles the matching auto-sync switches.
[When to use] Use it when the user asks to change an existing product's price, cost, or stock, and when the agent has already resolved the exact variants and target values. Trigger words: change the store price, reprice a live product, update stock, update cost.
[When not to use] To inspect current prices, stock, or variants, use get_managed_store_product. For a product not yet pushed to a store — an item still on the DSers Import List — use update_pre_publish_product_price. To change or apply a store Pricing Rule in bulk, use the pricing-rule or bulk-price Tool. It edits one product only and cannot bulk-reprice by filter.
[How to use]
Resolve IDs in order:
dsers_store_idfromlist_stores,dsers_product_idfromlist_managed_store_productsitems[].dsers_product_id, andsales_product_variant_idfromget_managed_store_productsales_product_variant_list[].sales_product_variant_id. SKUs, option text, and supplier variant IDs are rejected.Every
price_updatesitem requiressales_product_variant_price_amount, so resend the current selling price even when onlysales_product_variant_cost_amount,sales_product_variant_compare_at_price_amount, orcurrencychanges.Amounts are major-unit decimal strings ("19.99", never "1999"), and
currencysets the allowed precision; omit it only when the variant or product already has one.sales_product_variant_inventory_quantityreplaces the current quantity and is never a delta.price_auto_sync_actionis mandatory with price updates andstock_auto_sync_actionwith stock updates;disablepermanently turns that sync off.This write is not idempotent. Send it once, for at most 100 variants of a single product.
Compare
price_variants_updatedandstock_variants_updatedwith what you requested; if they differ or the outcome is unknown, re-read withget_managed_store_productinstead of retrying. Subscription errors block the write and are returned as structured errors.This tool covers only products already pushed to a store, including Draft status; for items not published yet, use
update_pre_publish_product_price. If the publish state is unclear, or the product exists on both sides, ask before changing the live price. [Side effects] Changes buyer-visible prices and stock;disablealso switches off auto-sync. [Confirmation] Required: show store, product, variants, and final values first.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| price_updates | No | Paste a JSON array into this field. Example: [{"sales_product_variant_id":"45382179012608","sales_product_variant_price_amount":"19.99","currency":"USD"}]. Copy sales_product_variant_id from get_managed_store_product. Price, cost, and compare-at values use human-readable major currency units. Optional fields: sales_product_variant_cost_amount, sales_product_variant_compare_at_price_amount, currency — omit cost or compare-at price to preserve its current minor-unit value; omit currency only when the resolved variant or product already has one. Use one object per variant and include price_auto_sync_action whenever price_updates is present. Paste JSON example: [{"currency":"USD","sales_product_variant_id":"45382179012608","sales_product_variant_price_amount":"19.99"}]. | |
| stock_updates | No | Paste a JSON array into this field. Example: [{"sales_product_variant_id":"45382179012608","sales_product_variant_inventory_quantity":100}]. Copy sales_product_variant_id from get_managed_store_product response sales_product_variant_list[].sales_product_variant_id. Inventory quantity must be non-negative and replaces the current value. Use one object per variant and include stock_auto_sync_action whenever stock_updates is present. Paste JSON example: [{"sales_product_variant_id":"45382179012608","sales_product_variant_inventory_quantity":100}]. | |
| dsers_store_id | Yes | Copy from list_stores response dsers_store_id field. Decimal string like "123456". Do not use store names, domains, or guessed numbers. Required. | |
| dsers_product_id | Yes | Copy from list_managed_store_products response items[].dsers_product_id field. This is the DSers-managed product ID, not a sales-platform product ID or supplier product ID. Required. | |
| price_auto_sync_action | No | Required whenever price_updates is present. Use disable for requests such as turn off/close/stop price synchronization or 价格自动同步关掉. Use keep for requests such as keep/preserve/leave price synchronization unchanged or 价格同步保持. If the user already stated a preference, map it directly and do not ask again. | |
| stock_auto_sync_action | No | Required whenever stock_updates is present. Use disable for requests such as turn off/close/stop inventory synchronization or 库存自动同步关掉. Use keep for requests such as keep/preserve/leave inventory synchronization unchanged or 库存同步保持. If the user already stated a preference, map it directly and do not ask again. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| auto_sync_results | Yes | Requested automatic-sync actions, prior states, actions taken, and resulting states | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. | |
| price_variants_updated | Yes | Number of price variant writes acknowledged | |
| stock_variants_updated | Yes | Number of stock variant writes acknowledged |