优惠券

优惠券用于在商城交易中按模板发放、领取和核销优惠。RuoYi Office 当前管理端包含「优惠券模板」与「优惠券列表」两类页面：模板负责定义券规则，券实例负责跟踪具体用户领取、使用和过期情况。

模块边界

层	路径 / 接口
后端模块	yudao-module-mall/yudao-module-promotion-server
管理端页面	apps/web-antd/src/views/mall/promotion/coupon
模板 API	/promotion/coupon-template/*
券实例 API	/promotion/coupon/*

核心链路

管理端能力

对象	能力
优惠券模板	创建、编辑、启停、删除、分页查询
优惠券实例	分页查询、删除、后台发放
选择组件	在营销活动中选择可用优惠券模板

模板通常包含领取方式、使用门槛、优惠类型、有效期、发放数量、每人限领等规则。券实例会记录用户、状态、领取时间、使用订单等信息。

二次开发建议

• 金额字段保持“后端分、前端元”的约定。
• 下单结算必须重新校验优惠券状态、有效期、门槛和适用商品，不能只信前端选择。
• 退款、取消订单时要明确优惠券是否退回，以及退回后有效期如何处理。
• 后台发券属于运营敏感能力，建议限制权限并保留操作日志。

排查清单

现象	优先检查
用户不能领取	模板状态、领取时间、库存、限领数量
结算不能使用	使用门槛、适用商品、有效期、券状态
优惠金额异常	分/元转换、满减/折扣规则、是否叠加其它营销
后台发券失败	用户 ID、模板状态、发放数量限制