Appearance
优惠券（移动端）
本文档说明 Lilishop 优惠券的完整使用流程：平台/商家在后台创建与发布优惠券后，买家在 UniApp 移动端（H5、微信小程序、APP）领取、使用并核销。
适用端：H5 微商城、微信小程序、移动 APP（同一套 UniApp 页面）。
优惠券使用流程总览
完整主线：后台发券 → 买家领券 → 买家查券 → 选购凑单 → 选券下单 → 订单查看。
【平台/商家】创建优惠券 → 设置基本信息和使用限制 → 提交发布
↓
【买家·移动端】领券中心 / 商品详情 / 店铺页领取，或由系统自动发到「我的优惠券」
↓
【买家·移动端】我的优惠券 → 立即使用 → 选购适用商品
↓
【买家·移动端】确认订单 → 选择优惠券 → 提交订单核销
↓
【买家·移动端】订单详情查看抵扣；平台/商家后台查看领取记录平台/商家后台创建优惠券
优惠券是买家领取与下单使用的「模板」。须先在后台创建并处于「已开始」状态，移动端才会出现可领取或可使用的券。
平台创建优惠券
入口： 运营后台 > 促销 > 促销管理 > 优惠券
第一步：进入列表并新增
- 打开 优惠券列表，可查看已创建的券：优惠券名称、面额/折扣、已领取数量/总数量、已被使用的数量/已领取数量、获取方式、优惠券类型、品类描述、活动时间、状态。
- 支持按优惠券名称、获取方式、活动状态、活动时间筛选；可 批量关闭 已勾选优惠券，关闭券模板后，该券下所有用户券一律作废。
- 点击 添加优惠券 进入新建页。
券模版状态
| 模版状态 | 可操作 |
|---|---|
| 未开始 | 编辑、关闭、查看领取记录 |
| 已开始 | 查看、关闭、查看领取记录 |
| 已结束 | 查看、查看领取记录 |
| 已关闭 | 编辑、查看领取记录 |
点击 查看领取记录 可查看会员领取与使用明细（会员名称、券状态、有效时间等），用于核对移动端领用情况。
第二步：填写基本信息
| 字段 | 填写说明 |
|---|---|
| 活动名称 | 后台管理用名称 |
| 优惠券名称 | 买家端展示名称 |
| 优惠券类型 | 减免现金：固定减免金额；打折：折扣（如 8.5 折） |
| 面额 / 折扣 | 满减填金额；满折填折扣值 |
| 活动类型（获取方式） | 免费领取 或 活动赠送 |
| 店铺承担比例 | 平台券必填，0～100 |
| 发放数量 | 仅「免费领取」填写；0 表示不限制 |
| 领取数量限制 | 每人限领张数；0 表示不限制 |
| 范围描述 | 优惠券使用范围文字说明 |
优惠券的两种活动类型（获取方式）
| 活动类型 | 含义 | 移动端买家如何获得 |
|---|---|---|
| 免费领取 | 买家主动领取 | 领券中心、商品详情、店铺页点击领取 |
| 活动赠送 | 系统按规则自动发放 | 须配合 券活动（新人发券/精确发券/自动赠券）、满额活动送券、会员权益发放；到账后在「我的优惠券」查看，不会出现在领券中心 |
第三步：填写使用限制
| 字段 | 填写说明 |
|---|---|
| 消费门槛 | 订单满多少元可用 |
| 有效期 | 活动起止时间；活动赠送券可设「领取后 N 天有效」 |
| 使用范围 | 全品类 / 指定商品 / 部分商品分类 |
选择「指定商品」或「部分商品分类」时，须在页面中勾选具体 SKU 或分类。
第四步：提交发布
- 核对基本信息与使用限制。
- 点击 提交 保存。
- 活动到达开始时间且状态为 已开始 ，买家端可在领券中心 / 商品详情 / 店铺页领取（免费领取）或由活动自动发到「我的优惠券」（活动赠送）。
商家创建店铺优惠券
入口： 店铺后台 > 营销 > 商家活动 > 优惠券
填写基本信息
基本信息：
| 字段 | 说明 |
|---|---|
| 活动名称 | 后台管理用 |
| 优惠券名称 | 买家端展示 |
| 优惠券类型 | 满减 / 满折 |
| 面额 / 折扣 | 对应类型的优惠力度 |
| 活动类型 | 免费领取 / 活动赠送 |
| 发送数量 | 仅免费领取；0=不限制 |
使用限制：
| 字段 | 说明 |
|---|---|
| 消费门槛 | 满 X 元可用 |
| 领取限制 | 0=不限制每人领取张数 |
| 有效期 | 固定起止 |
| 使用范围 | 全品类 / 指定商品 / 指定商品分类 |
| 范围描述 | 使用范围的补充说明 |
与平台券的差异
| 项目 | 店铺券 |
|---|---|
| 店铺承担比例 | 无此字段，优惠由本店承担 |
| 适用商品 | 仅本店商品 |
| 领券中心 | 「免费领取」且已开始的券出现在移动端领券中心；从购物车进入时携带 storeId，仅展示对应店铺优惠券 |
| 满额送券 | 须在 满额活动 中勾选「送优惠券」，并选择本店「活动赠送」类券 |
其他操作： 编辑/查看、关闭、批量关闭、查看领取记录。
买家领取优惠券
买家可在领券中心、商品详情、店铺页点击领取优惠券，领取前需登录；未登录时部分入口会引导跳转登录页。
领券中心
入口：
- 个人中心 > 领券中心
- 首页装修组件「领券中心」
- 购物车店铺可领券标识（从购物车进入时携带
storeId，仅展示对应店铺优惠券。）
页面路径： /pages/cart/coupon/couponCenter（导航标题：领券中心）
操作步骤：
- 浏览可领取的满减券、折扣券列表（支持分页加载、下拉刷新）。
- 查看面额/折扣、满减门槛、使用范围、有效期。
- 点击 领取；成功后提示「领取成功」，券进入「我的优惠券 → 未使用」。
- 领取操作有短时防重复点击保护，请勿连续快速点击。
商品详情页领取
入口： 商品详情页 促销 区域
- 若商品关联可领取的优惠券，详情页展示券信息（满 X 减 Y / X 折）。
- 在弹窗内点击领取。
- 领取成功后，券进入「我的优惠券」。
店铺页领取
入口： 店铺首页 店铺优惠券 卡片
- 浏览该店铺可领券列表。
- 点击领取；未登录时引导登录后再领。
首页自动发券弹窗
触发条件： 用户已登录，且平台配置了自动发券活动。
- 每日首次进入首页时（当日 6 点后、按本地日期缓存控制频率），系统请求自动发券活动。
- 若有可领活动券，弹出居中 活动优惠券 弹窗展示列表。
- 在弹窗内领取后，券进入「我的优惠券」。
同一自然日内重复进入首页通常不会再次弹窗；跨日且当前时间 ≥ 6 点会重新请求。
系统发放（无需主动领取）
以下场景券自动写入账户，买家在 我的优惠券 中查看即可：
| 场景 | 说明 |
|---|---|
| 新人注册发券 | 新用户注册后自动到账 |
| 精确发券 | 平台向指定或全部会员发放 |
| 平台自动赠券 | 按活动频率向会员发放 |
| 满额活动送券 | 订单满足满额条件后赠送 |
| 会员权益赠券 | 领取会员权益时赠送 |
买家查看我的优惠券
入口：
- 个人中心 > 优惠券（展示未使用数量）
页面路径： /pages/cart/coupon/myCoupon（导航标题：我的优惠券）
按状态查看
| 标签页 | 状态 | 说明 |
|---|---|---|
| 未使用 | NEW | 可在下单时使用；支持 立即使用 |
| 已使用 | USED | 已随订单核销，仅可查看 |
| 已过期 | EXPIRE | 已超过有效期 |
列表支持分页加载、下拉刷新与触底加载更多。
查看优惠券详情
- 在列表中点击 详细说明。
- 进入优惠券详情页（
/pages/cart/coupon/couponDetail）。 - 查看面额 / 折扣、使用门槛、使用范围、有效期。
券面信息说明
| 展示内容 | 含义 |
|---|---|
| ￥X / X 折 | 满减券 PRICE 或折扣券 DISCOUNT |
| 满 X 元可用 | 消费门槛 consumeThreshold |
| 全平台 / 部分商品 / 部分分类 / XX 店铺 | 使用范围 |
| 有效期 | 起止时间 |
选购适用商品
持有未使用优惠券后，需购买符合使用范围且满足消费门槛的商品。
从「立即使用」跳转
- 在「我的优惠券 → 未使用」中点击 立即使用。
- 跳转商品搜索/列表页，系统按该券活动筛选适用商品：
/pages/navigation/search/searchPage?promotionsId={couponId}&promotionType=COUPON- 浏览适用商品，加入购物车或立即购买。
注意： 消费门槛以确认订单页后端计算为准；列表页仅帮助快速找到可用商品。
确认订单选择优惠券
进入确认订单
从以下场景进入 确认订单 页（fillorder）：
| 购买方式 | 场景 |
|---|---|
| 购物车结算 | 购物车勾选商品后结算 |
| 立即购买 | 商品详情直接购买 |
| 拼团购买 | 拼团活动下单 |
进入确认订单页后，系统加载订单信息，并计算当前订单可用与不可用优惠券列表。
打开选券页
- 在确认订单页点击 优惠券 一行。
- 进入选券页（
/pages/cart/coupon/index，导航标题：优惠券）。
选券页分为两个标签：
| 标签 | 内容 |
|---|---|
| 可用优惠券 | 当前订单满足门槛与范围的券 |
| 不可用优惠券 | 暂不可用的券，并展示不可用原因 |
选择或取消优惠券
- 在 可用优惠券 中点击 立即使用，将该券应用于当前订单。
- 已选中的券可点击 取消使用 放弃抵扣。
- 选券成功后自动返回确认订单页。
- 订单金额区显示优惠券抵扣（
-￥XX）及应付金额。
平台券与店铺券的叠加：
- 平台券 和 店铺券可以叠加，TradeDTO 里平台券单独存一张，店铺券按 storeId 存，所以一笔交易最多是：1 张平台券 + 每个店铺 1 张店铺券。同一平台券位置再选会覆盖旧平台券；同一店铺再选店铺券会覆盖该店铺旧券。
提交订单
- 核对收货地址（实物商品）、商品、发票、配送及 应付金额。
- 点击 提交订单 并支付。
- 已选优惠券随订单核销，对应优惠券状态变为 已使用。
订单中查看优惠券
入口： 个人中心 > 我的订单 > 订单详情
订单价格明细中展示优惠券抵扣金额，与商品总额、运费、其他促销优惠一并列出。
订单取消或售后完成后，按订单号返还该订单所有已用券(平台券、店铺券)；若优惠券过期或后台关闭券模版，则此优惠券不可使用。
使用建议
- 领券后先在 我的优惠券 查看有效期与使用范围，避免临近过期才发现无法使用。
- 凑单时优先使用 立即使用 跳转适用商品，减少在结算页才发现「无可用优惠券」的情况。
- 多张券可选时，可对比可用券标签中的门槛与面额，选择抵扣更多的券（最终以系统计算为准）。
常见问题
为什么领券中心看不到某张券？
领券中心仅展示可 免费领取 且活动进行中的券。「活动赠送」类券配合券活动（新人发券/精确发券/自动赠券）、满额活动送券、会员权益发放，不会出现在领券中心列表。
领取失败常见原因？
- 未登录
- 超过每人限领数量
- 发放总量已领完
- 活动未开始、已结束或已关闭
平台券和店铺券能一起用吗？
平台券 和 店铺券可以叠加，TradeDTO 里平台券单独存一张，店铺券按 storeId 存，所以一笔交易最多是：1 张平台券 + 每个店铺 1 张店铺券。同一平台券位置再选会覆盖旧平台券；同一店铺再选店铺券会覆盖该店铺旧券。
折扣券金额显示不一致？
不同页面使用 discount 或 couponDiscount 字段展示折扣，以当前页面实际显示为准，不影响下单计算。
积分订单能用优惠券吗？
积分商品不能使用优惠券。
自动发券弹窗为什么一天只弹一次？
移动端对自动发券做了按自然日的本地缓存：同一日内重复进入首页不重复弹窗；跨日且当前时间 ≥ 6 点会再次请求活动券。