拉新下单送券查询
拉新下单送券查询用来核对老会员推荐新会员、新会员下单以后系统送出的券：每一笔该送的券有没有真的发到手、发给的是拉新人还是新会员、哪一张出了问题。它是拉新下单送券活动的执行流水。
一、功能概述
菜单位置：O2O业务 → 微信商城 → 拉新下单送券查询（页面地址 /admin/o2o/wx_invitegiveticketbill_qry/）
| 用途 | 说明 |
|---|---|
| 查送券单 | 按下单时间、会员编号、状态筛出拉新送券单据 |
| 看发给谁 | 子表按「送券目标」拆行，区分邀请人与新会员各自拿到的券 |
| 定位失败 | 异常信息列直接写明这张券为什么没发出 |
| 导出 | 导出 Excel 交门店或运营核对 |
本页只查不改：工具栏没有作废、没有补发。要收回券请到线上卖券单查询 或会员礼包里处理，要补发由门店按线下流程做。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 工具栏 | 刷新、条件、导出Excel |
| 主表 | 行号、状态、支付时间、单据id、预订单号、会员卡编号、会员名、拉新人编号、拉新人名、描述 |
| 子表 | 标题「送券目标明细（双击行查看实际送出的券）」，列为 行号、送券目标类型、会员编号、会员名、券名、券类型编号、数量、送券业务GUID、异常信息；未选中主表行时提示「请选择单据行查看送券明细」 |
| 条件回显 | 「查询条件: 最近30天 | 状态:生效」+「记录数: N」 |
三、业务操作步骤
步骤 1：确认系统选项已开启
本页受一个系统选项控制：拉新下单送券（InviteCaseEnable）。选项没打开时，页面顶部出现提示条，标题为「未开启【拉新下单送券】系统选项（InviteCaseEnable），无法查询」，点刷新或查询也会得到同样的文案「未开启【拉新下单送券】系统选项（InviteCaseEnable）」。
要出数据，先到拉新下单送券 把方案做好并生效，再回本页刷新。
步骤 2：筛单
点「条件」，可筛：
| 项 | 取值 |
|---|---|
| 下单时间 | 今天 / 昨天 / 本月 / 上月 / 最近 N 天（7、15、30、60、90、180、365）/ 指定时段 |
| 会员编号 | 占位「会员卡编号（精准）」，只支持精准 |
| 状态 | 生效（默认）/ 无效 / 所有 |
默认口径「最近 30 天 + 状态:生效」，条件按人记忆。
步骤 3：看送给了谁
双击主表一行，子表按目标拆行：送券目标类型 为「邀请人」的是拉新人拿到的奖励，为「新会员」的是被邀请人注册后拿到的奖励。每种券一行，含券名、券类型编号与数量。
步骤 4：定位没发出的券
子表「异常信息」列写明失败原因；主表「状态」为无效的单一律要在子表里看是哪张券出了问题。核对完成后可点「导出Excel」把结果交给门店。
四、字段详细说明
| 界面字段 | 含义与取值 |
|---|---|
| 状态 | 主表只有两种：生效（送券成功，绿色显示）/ 无效（含草稿、失败、关闭等一切非成功态） |
| 支付时间 | 新会员那笔订单的实际支付时间，活动的日期区间就是按它判定的 |
| 预订单号 | 新会员下单生成的预订单号，可用于回查线上订单 |
| 单据id | 拉新送券单的内部主键，异常排查时提供给技术支持 |
| 会员卡编号 / 会员名 | 触发本次送券的新会员 |
| 拉新人编号 / 拉新人名称 | 推荐这位新会员的老会员 |
| 描述 | 方案备注与活动说明文本 |
| 送券目标类型 | 邀请人 / 新会员 |
| 券名 / 券类型编号 / 数量 | 实际送出的券种与张数 |
| 送券业务GUID | 本次送券动作的编号，同一行券共享一个 GUID |
| 异常信息 | 发券失败的原因文本；成功行为空 |
子表券状态口径与卖券单不同：这里的券状态沿用券库的 在库 / 领出 / 已售出 / 售出退回 / 已使用 / 代理商领取 / 作废。
五、典型使用场景
场景一：会员投诉没收到推荐奖励。 用新会员编号精准查单（或按支付时间区间查），确认「状态」是否生效；生效但子表里邀请人那行为空，说明方案里没配「拉新人送券」那组券，回到方案补配。
场景二：核对活动效果。 时间选活动区间，状态选「所有」，导出 Excel，按「拉新人编号」汇总成功单数，即可算出每位老会员带来多少有效新客。
场景三：区分卖券送券与拉新送券。 买券包送券看线上卖券单查询，推荐注册下单送券看本页，两者是不同单据、不能互查。
六、权限控制与前置条件
- 页面无独立 ERP 菜单权限映射项（Django 新增页面），可见性跟随 O2O业务 分组。
- 前置条件：系统选项「拉新下单送券」必须开启，否则整页拒绝查询；拉新下单送券 里至少有一个生效方案。
- 数据只反映服务端已落库的送券结果，小程序侧刚下完单可能有短暂延迟，先点「刷新」。
七、常见问题
问：顶部出现「未开启【拉新下单送券】系统选项（InviteCaseEnable），无法查询」怎么办？ 答：这是系统选项没打开，不是数据问题。请管理员在系统设置里开启拉新下单送券选项，并确认已有一个生效中的方案。
问：状态为什么只有生效/无效两种？ 答：本页只关心「券送成功没有」。想看更细的过程状态，用子表的异常信息与线上订单 的退款/送券记录配合判断。
问：能不能在本页把送错的券收回来？ 答：不能，本页没有作废按钮。收回券要到券管理或线上卖券单查询（仅限卖券单）执行。