Documentation
优惠券：创建、领取、分配与使用
优惠券：创建、领取、分配与使用
适用版本：产品管理插件 3.1.0；内容依据当前源码核对，更新日期：2026-10-10。
功能与入口
管理员在控制台优惠数据维护优惠券，用户在用户中心优惠数据查看和领取。优惠券可用于授权订单或商品订单，具体受产品、用户、周期、有效期和次数规则约束。
| 类型 | 代码 | 规则 |
|---|---|---|
| 折扣券 | DISCOUNT | 按配置折扣计算 |
| 满减券 | FULL_REDUCTION | 满足门槛后抵扣 |
| 代金券 | CASH | 按金额抵扣 |
| 免费券 | FREE | 符合条件时应付为 0 |
创建与领取
- 在优惠数据中新增，填写名称、类型和优惠参数。
- 设置适用产品、价格策略、用户、开始时间、到期时间与总使用次数。
- 普通券可分配指定用户；批量创建时按页面条件开启自助领取，每个用户可领取该批次一次。
- 自定义券码用于共享券，需核对券码唯一性；共享券有独立的用户使用历史。
- 保存后在用户侧检查领取和购买时的可用性，再核对应付金额。
状态与追踪
UNUSED 表示未使用或仍可使用，USED 表示已使用，EXPIRED 表示已过期或被停用。多次使用能力仍需结合总次数、已用次数和用户记录判断，不能只看单一状态。
优惠券会记录使用订单与用户。商品订单优惠按整笔订单计算，不能在每个订单项上重复扣减同一优惠。
MCP 管理约束
create_coupon 默认创建普通券；显式 customCode=true 创建共享券，创建后不能切换类型。共享券不能用 assign_coupon 分配给单个用户。编辑仅允许尚无使用记录、未绑定订单的券；停用保留历史，恢复还要满足有效期和剩余次数。
常见问题
购买提示不可用时检查全局及产品优惠开关、产品和周期范围、用户归属、时间和剩余次数。普通券不能转移已有归属。零元订单仍进入成功业务流程，不能理解为没有订单。
评论