买商品送券
买商品送券是小程序商城的满件赠券方案:会员买了方案圈定的商品(或所属分类下的商品),系统按方案自动给这位会员送电子券。本页只配方案,实际送出去哪些券、有没有送成功,到买商品送券查询 里核对。
一、功能概述
菜单位置:O2O业务 → 商城活动 → 买商品送券(页面地址 /admin/o2o/wxcoupondelivery/)

| 用途 | 说明 |
|---|---|
| 圈触发商品 | 按「参与商品」逐个指定,或按「参与分类」整类指定 |
| 定赠券 | 在「赠券」页签配要送的券类型与张数 |
| 控领取上限 | 「每人限领次数」限制单个会员能享受几次 |
| 定活动期 | 开始时间 / 结束时间框定方案生效区间 |
| 控状态 | 草稿 / 生效 / 删除三态流转 |
方案与拉新下单送券 不同:拉新是「老带新、新会员下单」双边送券,本页是「任何人买指定商品」就送券,触发条件落在商品上。
二、界面布局说明
列表页
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增、导出、打印 |
| 搜索框 | 按方案名称模糊搜 |
| 列表 | 方案ID、方案名称(超链,点开进编辑窗口)、开始时间、结束时间、每人限领次数、状态 |
| 排序 | 默认按方案ID倒序,新建的排在最上面 |
编辑窗口
点「新增」或点方案名称打开编辑窗口,表单分组标题为「送券方案」:
| 字段 | 说明 |
|---|---|
| 方案名称 | 必填,建议写能被认出来的活动名 |
| 开始时间 / 结束时间 | 日期时间选择器,生效时必填 |
| 每人限领次数 | 数值,单个会员可享受的次数上限 |
| 状态 | 下拉,必填;提示「草稿 / 生效 / 删除(删除=逻辑删除,不物理删行)」 |
明细页签
编辑窗口下方有「明细」区,三个页签:赠券 / 参与商品 / 参与分类。每个页签上方有 添加行 / 保存 两个按钮,表格末列是行内 删除;无数据时显示「暂无明细」。
| 页签 | 列 | 录入内容 |
|---|---|---|
| 赠券 | 电子券、数量 | 电子券填券类型ID(数值),数量填每次赠送张数 |
| 参与商品 | 商品ID、单位ID | 逐个指定触发商品及其单位 |
| 参与分类 | 商品分类ID | 整类指定,类下商品都触发 |
明细页签只在草稿状态可改;方案未保存时点页签会提示「请先保存修改内容,再修改赠券明细。」(参与商品、参与分类同理)。
三、业务操作步骤
步骤 1:建方案
点「新增」,填方案名称,选开始时间与结束时间,按需填每人限领次数,状态先留「草稿」,保存。保存成功后才能编辑下方明细。
步骤 2:配赠券
切到「赠券」页签,点「添加行」,填电子券(券类型ID)与数量,点「保存」,回显「保存成功」。券类型需先在电子券类型 档案里建好。
步骤 3:圈触发范围
「参与商品」与「参与分类」二选一或并用:
- 按商品:在「参与商品」逐行填商品ID与单位ID;
- 按分类:在「参与分类」填商品分类ID,该类下商品都参与。
同一页签内不允许重复行,重复时提示「系统不允许重复输入相同的行信息!」;商品行未填商品提示「请选择商品」,分类行未填分类提示「请选择商品分类」。
步骤 4:生效
把「状态」改为「生效」并保存。生效时后端逐项校验,任一不满足就报对应文案:
| 报错原文 | 原因 |
|---|---|
| 开始日期不能为空 | 没填开始时间 |
| 结束日期不能为空 | 没填结束时间 |
| 开始日期不能大于结束日期 | 时间倒挂 |
| 未选择券 | 赠券页签一行都没有 |
| 方案状态不允许从当前状态变更! | 状态流转不合法(见第四节) |
生效后方案进入只读口径,明细页签再保存会被拒绝,提示「只有草稿状态的方案才能修改赠券明细!」。要改内容,先把状态改回「草稿」(即取消生效)再编辑。
步骤 5:查发放结果
会员下单后,到买商品送券查询 按会员卡号或预定单号查送券单,看「单据状态」与「券状态」确认是否送到。
四、字段详细说明
1)主表字段
| 界面字段 | 落库字段 | 含义 |
|---|---|---|
| 方案ID | fCaseId | 方案主键,列表按它倒序 |
| 方案名称 | fCaseName | 活动名 |
| 开始时间 / 结束时间 | fStartTime / fEndTime | 方案生效区间 |
| 每人限领次数 | fUserLimitCount | 单个会员可享受次数上限 |
| 状态 | fState | 见下方枚举 |
| 创建时间 | fCreateTime | 新建保存时自动写入 |
2)状态枚举与流转
| 取值 | 含义 |
|---|---|
| 草稿(0) | 可编辑主表与明细 |
| 生效(1) | 方案参与送券计算,明细只读 |
| 删除(-1) | 逻辑删除,行仍在表里 |
合法流转:草稿 → 生效 / 删除;生效 → 草稿(取消生效)/ 删除;删除 → 草稿(取消生效)。其余组合一律报「方案状态不允许从当前状态变更!」。
3)明细与发放记录
赠券、参与商品、参与分类三张从表按方案ID关联;会员下单后产生的发放记录落在 WX_couponDelivery_bill(含券明细 WX_couponDelivery_bill_ticket),是运行数据,本页不展示,统一在买商品送券查询 查看。
五、典型使用场景
场景一:买蛋糕送代金券。 参与商品填蛋糕商品ID,赠券配一张代金券、数量 1,每人限领次数 1,时间窗给整月。会员买蛋糕即送一张券,引导复购。
场景二:整类满件赠券。 参与分类填「现烤面包」分类ID,该类下任意商品都触发;赠券配一张折扣券。不用逐个商品维护。
场景三:活动延期。 生效后想延长窗口,先把状态改回草稿,改结束时间,再重新生效。
六、权限控制与前置条件
- 本页为网页端新迁移的编码窗体,无独立 ERP 菜单权限映射项,可见性跟随 O2O业务 分组;菜单按账套已开通的模块范围显示,看不到菜单时请联系深圳市安仕达管理软件有限公司确认开通范围。
- 前置条件:
- 当前版本明细页签按 ID 录入(券类型ID、商品ID、单位ID、商品分类ID),不是按名称挑选;编号拿不准时先在对应档案确认,或联系技术支持协助。
七、常见问题
问:「电子券」列要填什么? 答:填券类型的内部ID(数值),不是券名称。券种先在电子券类型档案里建好,再取对应ID填入。
问:提示「未选择券」怎么办? 答:生效前「赠券」页签至少要有一行。先保存主表,再切到赠券页签添加券行并保存,然后重新生效。
问:生效后为什么改不了明细? 答:明细只在草稿状态可写。把状态改回草稿(取消生效)后即可编辑,改完再重新生效。
问:删除的方案还能找回来吗? 答:删除是逻辑删除,把状态从「删除」改回「草稿」(取消生效)即可恢复编辑。
问:会员买了商品却没收到券? 答:到买商品送券查询 查这笔单:状态为「没有满足条件的赠送方案」说明商品没被圈中或不在时间窗内;状态为「送券异常」看异常信息列定位原因。
