买商品送券查询
买商品送券查询用来核对**「买商品送券」活动实际送出去的券**:哪张预定单触发了送券、送给哪个会员、送了哪种券多少张、单据和券现在是什么状态、退单时回收了多少、有没有异常。它是买商品送券 方案的执行流水。
一、功能概述
菜单位置:O2O业务 → 微信商城 → 买商品送券查询(页面地址 /admin/o2o/wxcoupondeliveryqryreport/)

| 用途 | 说明 |
|---|---|
| 查送券流水 | 按预订单生效日期、会员卡号、预定单号筛出送券单据 |
| 看单据状态 | 草稿 / 已赠送 / 退单回收券 / 退单异常 / 送券异常 / 没有满足条件的赠送方案 |
| 看券状态 | 每张券的草稿 / 赠送 / 退回 / 退回异常 / 送券异常 |
| 核对退券 | 「数量」「退券数量」对比赠送与回收 |
| 定位异常 | 「异常信息」列写明失败原因 |
| 导出 | 导出 CSV 交运营核对活动效果 |
与「买商品送券」方案页的区别
| 页面 | 管什么 |
|---|---|
| 买商品送券(商城活动) | 配方案:送什么券、哪些商品/分类参与、每人限领、生效 |
| 买商品送券查询(本页) | 查结果:预定单实际触发送券与退券回收的逐条记录,只读 |
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 条件区 | 预订单生效日期(今天 / 昨天 / 本周 / 上周 / 本月 / 上月 / 自定义,默认本月)、会员卡号(模糊)、预定单号(模糊)、单据状态(全部 / 草稿 / 已赠送 / 退单回收券 / 退单异常 / 送券异常 / 没有满足条件的赠送方案) |
| 按钮 | 查询、重置、导出;右侧「★ 方案」 |
| 列表 | 单据编号(冻结)、会员姓名、会员卡号、创建时间、单据状态、状态更新时间、预定业务日期、预定单号、异常信息、券状态、券状态更新时间、赠送方案、数量、退券数量、券类型编号、券类型名称 |
| 计数 | 右上「共 N 条」,默认每页 100 条 |
三、业务操作步骤
步骤 1:筛送券单据
预订单生效日期点「本月」或「自定义」选活动区间;查某个会员填会员卡号,查某张预定单填预定单号。点「查询」,表格列出符合条件的送券单据及其券明细。
步骤 2:看单据整体状态
「单据状态」列写明这张送券单据走到哪一步:已赠送表示券已发出;退单回收券表示退单后券已回收;退单异常 / 送券异常表示环节出错;没有满足条件的赠送方案表示这张预定单没匹配到任何生效方案。
步骤 3:看每张券的状态与退券
一张单据含多张券时按券逐行展开:「券状态」「券类型编号」「券类型名称」「数量」逐行给出。「退券数量」是该券种被回收的数量,与「数量」对比即可知净赠送。
步骤 4:定位异常
单据状态或券状态为异常时,读「异常信息」列看具体原因,据此排查方案配置或券库存。
四、字段详细说明
| 界面字段 | 含义与取值 |
|---|---|
| 单据编号 | 送券单据ID |
| 会员姓名 / 会员卡号 | 受赠会员 |
| 创建时间 | 送券单据创建时间 |
| 单据状态 | 草稿(0)/ 已赠送(1)/ 退单回收券(2)/ 退单异常(3)/ 送券异常(4)/ 没有满足条件的赠送方案(5) |
| 状态更新时间 | 单据状态最近变更时间 |
| 预定业务日期 / 预定单号 | 触发本次送券的预订单业务日期与单号 |
| 异常信息 | 送券或退券失败的原因文本,正常行为空 |
| 券状态 | 草稿(0)/ 赠送(1)/ 退回(2)/ 退回异常(3)/ 送券异常(4) |
| 券状态更新时间 | 券状态最近变更时间 |
| 赠送方案 | 命中的买商品送券方案名 |
| 数量 / 退券数量 | 该券种赠送张数与回收张数 |
| 券类型编号 / 券类型名称 | 赠送的电子券券种 |
数据来自送券单据 WX_couponDelivery_bill 与券明细 WX_couponDelivery_bill_ticket,关联送券方案 WX_couponDelivery、会员卡 VipCard、券类型 MCM_CakeTicketType。
单据状态与券状态是两套枚举:单据状态多一个「没有满足条件的赠送方案」(5),券状态没有这一项;两者都可能出现「送券异常」,但含义层级不同(整单 vs 单张券)。
五、典型使用场景
场景一:会员说没收到券。 用会员卡号或预定单号查,看单据状态是否「已赠送」、券状态是否「赠送」;异常就读「异常信息」。
场景二:核对退单回收。 单据状态选「退单回收券」,对比「数量」与「退券数量」确认券是否足额回收;「退单异常」的逐条排查。
场景三:评估方案命中。 时间选整个活动期,按「赠送方案」汇总,看哪些方案真正送出了券;「没有满足条件的赠送方案」的记录说明预定单未匹配到方案。
六、权限控制与前置条件
- 本页是报表页,无独立 ERP 菜单权限映射项,可见性跟随 O2O业务 分组;菜单按账套已开通的模块范围显示,看不到菜单时请联系深圳市安仕达管理软件有限公司确认开通范围。
- 前置条件:买商品送券 里至少有一个生效方案,且有预定单触发送券;否则记录为空。
- 本页只读,不提供补发、作废或修改送券结果的操作。
七、常见问题
问:「没有满足条件的赠送方案」是什么意思? 答:这张预定单没有匹配到任何生效的买商品送券方案(商品/分类不在参与范围、方案未生效或已过限领等),所以没送券。
问:单据状态和券状态为什么不一样? 答:单据状态描述整张送券单据,券状态描述其中单张券,两套枚举不完全相同;一张单据可能整体已赠送,但个别券退回。
问:日期页签筛的是哪个日期? 答:条件区「预订单生效日期」页签按送券单据的创建时间过滤,与「预定业务日期」可能不是同一天。
问:能在这里补发券吗? 答:不能,本页只查。补发由运营按线下流程或会员侧处理。
