券兑换礼包查询
券兑换礼包查询用来核对会员拿券兑换礼包的结果:哪张券兑了哪个礼包方案、在哪家分店兑的、是小程序还是门店发起、兑换成功还是失败、失败原因是什么。它是券兑换礼包的执行流水。
一、功能概述
菜单位置:O2O业务 → 微信商城 → 券兑换礼包查询(页面地址 /admin/o2o/wxticketgiftpackqryreport/)

| 用途 | 说明 |
|---|---|
| 查兑换记录 | 按兑换日期、会员卡号筛出兑换流水 |
| 看兑换结果 | 「兑换状态」分草稿 / 成功 / 失败 |
| 定位失败 | 「错误信息」列写明失败原因 |
| 区分来源 | 「兑换来源」分小程序 / 门店 |
| 导出 | 导出 CSV 交运营核对 |
礼包方案从哪来
「礼包方案」「方案编号」来自会员礼包方案档案(WX_VipLargessSub),与线上卖券 券包所用的是同一套礼包方案。本页只查兑换结果,不配置礼包内容;礼包里有什么券由礼包方案决定。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 条件区 | 兑换日期(今天 / 昨天 / 本周 / 上周 / 本月 / 上月 / 自定义,默认本月)、会员卡号(模糊) |
| 按钮 | 查询、重置、导出;右侧「★ 方案」 |
| 列表 | id(冻结)、兑换单号(冻结)、兑换时间、兑换状态、券号、会员姓名、会员卡号、礼包方案、方案编号、分店名称、分店编号、兑换来源、礼包编号、记录标志、错误信息 |
| 计数 | 右上「共 N 条」,默认每页 100 条 |
三、业务操作步骤
步骤 1:筛兑换记录
兑换日期点「本月」或「自定义」选区间;查某个会员填会员卡号。点「查询」,表格列出符合条件的兑换记录。
步骤 2:看兑换结果
「兑换状态」三种取值:草稿(未最终完成)、成功(礼包已兑出)、失败(兑换出错)。失败的读「错误信息」列看原因。
步骤 3:区分来源与分店
「兑换来源」分小程序(会员线上自助兑换)与门店(门店侧发起);「分店名称」「分店编号」给出兑换发生的分店,便于按店核对。
步骤 4:导出核对
点「导出」下载当前筛选结果,按「兑换状态=成功」过滤后与礼包发放核对。
四、字段详细说明
| 界面字段 | 含义与取值 |
|---|---|
| id | 兑换日志记录ID |
| 兑换单号 | 兑换单据编号 |
| 兑换时间 | 兑换发生时间 |
| 兑换状态 | 草稿(0)/ 成功(1)/ 失败(-1) |
| 券号 | 用于兑换的电子券号 |
| 会员姓名 / 会员卡号 | 兑换会员 |
| 礼包方案 / 方案编号 | 命中的会员礼包方案名与编号 |
| 分店名称 / 分店编号 | 兑换发生的分店 |
| 兑换来源 | 小程序(0)/ 门店(1) |
| 礼包编号 | 礼包 GUID 标识 |
| 记录标志 | 兑换记录 GUID 标识 |
| 错误信息 | 兑换失败的原因文本,成功行为空 |
数据来自兑换日志 WX_ticketGiftPackLog,关联会员礼包方案 WX_VipLargessSub、会员卡 VipCard、分店 Pos_Filiale。
五、典型使用场景
场景一:会员说兑换没到账。 用会员卡号查,看「兑换状态」是否成功;失败就读「错误信息」,据此排查券状态或礼包方案。
场景二:按店核对兑换量。 时间选活动期,导出后按「分店名称」汇总成功兑换数。
场景三:区分线上线下兑换。 按「兑换来源」分别看小程序与门店的兑换占比。
六、权限控制与前置条件
- 本页是报表页,无独立 ERP 菜单权限映射项,可见性跟随 O2O业务 分组;菜单按账套已开通的模块范围显示,看不到菜单时请联系深圳市安仕达管理软件有限公司确认开通范围。
- 前置条件:已配置会员礼包方案、会员持券发起过兑换;否则记录为空。
- 本页只读,不提供重新兑换、作废或修改兑换结果的操作。
七、常见问题
问:兑换状态「草稿」是什么意思? 答:表示兑换尚未最终完成(状态值 0),既不是成功也不是失败;最终成功为 1、失败为 -1。
问:礼包方案在哪里配? 答:礼包内容由会员礼包方案档案决定,与线上卖券券包共用同一套礼包方案;本页只查兑换结果。
问:能在这里重新兑换吗? 答:不能,本页只查。失败的兑换由会员侧或门店按流程重新发起。
问:查不到记录? 答:先确认兑换日期页签覆盖了兑换区间(默认只查本月),再确认会员确实持券发起过兑换。
