woo-pricing-promotions

Woo 定价与促销

在运行中的 WooCommerce 商店中执行促销、重新定价或优惠券操作，并认真对待每一笔钱。每次更改都会先预览，再记录快照，并且之后可以撤销。

此技能的功能

在商店中，定价是唯一一个看似合理的错误会在被发现前造成真实金钱损失的地方。小数点放错不是有人会报告的页面布局问题；它会导致订单价格错误，而等到问题浮现时，订单早已生成。因此，这里的操作顺序是经过深思熟虑的：了解当前价格，以金额而非百分比说明更改，展示更改内容，然后再写入。

支持：

• 按百分比、固定金额或指定值，对整个分类或指定列表重新定价
• 设置带开始和结束日期的定时促销，无需有人记得结束促销
• 优惠券：固定金额、百分比、免运费，并设置使用次数限制以及产品或分类限制
• 在店面显示促销徽章
• 根据写入的快照恢复价格更改

此技能不做什么

• 决定折扣幅度。 折扣深度取决于利润率。此技能会告诉你，按近期销量计算某个折扣的成本，但不会替你选择折扣。
• 绕过防护限制。 调价幅度超过 50%、折扣超过 70%，或价格低于 0.50 时，操作会被拦截。这是插件拒绝执行，而且是有意为之。请明确说明情况并询问，而不是再次发送请求并使用覆盖选项。
• 更改税费、货币或支付配置。
• 只调整可变产品的父产品并寄希望于结果。 各个变体都有自己的价格；请明确指定它们。为在售产品新增变体也会产生新价格：从插件 4.1.7 开始，woocommerce_create_variation 和 woocommerce_generate_variations 会先预览；用户确认后，再使用同一调用并设置 confirm: true 来创建。

要求

• 安装并授权 WooCommerce 和 Respira WooCommerce 插件
• 商店自身的销售历史记录，用于统计销量；woocommerce_top_products 会读取这些记录

触发短语

• “开展促销”

其他触发方式

• “给这个分类打折”
• “设置优惠券”
• “重新给这些产品定价”
• “结束促销”
• “打 8 折会让我损失多少钱”

执行工作流

第 1 阶段：查看当前状态

切勿凭记忆重新设定产品价格。

1. 对目标产品集使用 woocommerce_list_products_advanced，或对指定产品使用 woocommerce_get_product。这在机制上也很重要：插件会将读取操作记录为来源信息；从未读取过的对象若被写入，会标注为未经验证。
2. 使用 woocommerce_top_products 查询一个可比较的近期时间段（date_start、date_end），以便根据销量衡量折扣影响。
3. 记下任何已经在促销中的产品。最常见的折扣意外加深方式，就是在现有促销上叠加新的促销。

第 2 阶段：用金额说明

将用户的要求换算成每件产品的具体金额，并明确告知：

Outdoor 分类中有 14 件产品。原价范围为 24.00 至 189.00。打 8 折后，价格范围为 19.20 至 151.20。按最近 30 天的销量计算，折扣金额约为 340。此分类中有 2 件产品已打 85 折；若不排除它们，折扣就会达到 68%。

写入前先询问。百分比听起来往往比实际金额小。

第 3 阶段：预览

每次都先不带 confirm 运行写入操作：从插件 4.1.6 开始，除非传入 confirm: true，否则价格和库存工具都会先预览（较旧的插件版本需要设置 dry_run: true）。响应会列出每件产品的原价和新价格，并指出哪些内容会被防护限制拦截。展示该列表并等待用户确认。预览成本很低，重新定价可不是。

阶段 4：执行写入

• 对于重新定价（change_type 为 percentage、absolute 或 set_value；apply_to 为 regular_price、sale_price 或 both），使用 woocommerce_bulk_update_prices；如果应自动结束，则使用 woocommerce_schedule_sale；参数与预览时相同，另加 confirm: true
• 使用 woocommerce_create_coupon 创建优惠码，并设置 usage_limit，除非用户另有说明，因为不设上限的优惠码会带来风险
• 如果店面应显示促销徽章，则使用 woocommerce_add_sale_badge（仅适用于区块主题；先使用 dry_run: true 运行）

系统会自动捕获快照。报告快照 ID。

阶段 5：确认并提供撤销方法

说明更改内容及金额，并说明如何撤销：使用 woocommerce_revert_pricing，并提供 product_id 和 snapshot_id。如果促销已安排，请说明其结束日期，无需任何人操作即可结束。

安全模型

• 每次写入前都要预览，无一例外
• 每次价格变更前都要创建快照，并提供明确的恢复路径
• 防护机制会拒绝幅度过大的变更；遇到阻止时，应向用户提问，绝不能设法绕过
• 优惠码默认设置使用次数上限
• 此处的任何操作都不会影响现有订单的价格

诚实免责声明

此技能会更改真实店铺中的实时价格。

它无法：判断折扣对业务是否有利、预测需求、了解你的利润率，或查看竞争对手的定价。它不会替你决定折扣幅度。

它可以：在变更生效前展示其成本、对一组商品一致地应用变更、安排结束时间，并恢复原状。

工具

woocommerce_list_products_advanced、woocommerce_get_product、woocommerce_top_products、woocommerce_revenue_summary、woocommerce_bulk_update_prices、woocommerce_schedule_sale、woocommerce_create_variation、woocommerce_generate_variations、woocommerce_revert_pricing、woocommerce_create_coupon、woocommerce_update_coupon、woocommerce_list_coupons、woocommerce_add_sale_badge

遥测

运行完成后，以即发即弃方式向 POST https://www.respira.press/api/skills/track-usage 发送请求，并提供 skill_slug = woo-pricing-promotions、网站和版本上下文、耗时、重新定价的商品数量、创建的优惠码数量以及触发的阻止项。切勿让用户等待遥测完成。

相关技能

• Woo Catalog Perfection（修复促销所依托的商品目录）
• Woo Marketing Campaigns（告知用户促销活动）
• WooCommerce Health Check（促销前检查店铺状态）

---

由 Respira Team 构建 https://respira.press/skills/woo-pricing-promotions