会员卡状态修改单
会员卡状态修改单是唯一能改会员卡状态的入口：一次挂失几十张员工卡、批量清掉一批僵尸卡、给退卡的客人把状态落成「退卡」，都靠这一张单。它的形态和收银端的「点一下改一张」完全不同——先填一张单、把要处理的卡逐行加进来、给每一行指定新状态、审核后一次性生效，因此天然留下凭证：谁在什么时候、把哪些卡从什么状态改成了什么状态。
一、功能概述
菜单位置：会员管理 → 单据 → 会员卡状态修改单（页面地址 /admin/VIP/vipstatechgbillhead/）
| 用途 | 说明 |
|---|---|
| 批量改状态 | 一张单最多可以处理几十上百张卡，每行独立指定新状态 |
| 留痕 | 单据号、制单人、审核日期、明细里的「修改人 / 修改时间」全部落库 |
| 卡住误操作 | 必须审核才生效；只保存不审核等于没改 |
为什么不能直接在会员卡上改状态？ 会员卡 编辑资料页里的状态字段受系统特点「允许修改会员卡状态」控制，默认关闭。设计上要求走单据，是为了让每一次状态变更都有单号可查——尤其是「挂失后又被解挂」这类容易扯皮的动作。
四张会员单据共用一套骨架（新增 → 加明细 → 保存 → 审核 → 生效），看懂本篇，会员卡充值单、会员积分调整单、会员积分返金额单 的操作路径是一样的；单据窗口的通用按钮语义见 40单据窗口通用操作。
二、界面布局说明
单据列表
| 区域 | 内容 |
|---|---|
| 工具栏 | 蓝色 新增、导出、刷新 |
| 日期快捷键 | 今天 / 昨天 / 本周 / 上周 / 本月 / 上月 / 自定义 —— 点一个即设好区间，无需开日历 |
| 筛选行 | 会员类型: 全部 ▾、⚙ 高级筛选、蓝色 查询、重置、导出、★ 方案 |
| 已选条件 | 一行芯片，如「单据日期 等于 本月 ×」，点 × 单独去掉该条件 |
| 列表 | 单据号 / 单据日期 / 单据状态 / 会员类型 / 单据摘要 / 制单人 / 审核日期 |
默认查询区间是「本月」，这是最容易踩的一条：找不到上周那张单，不是丢了，是被日期条件挡在外面了。点 上月 或 自定义 放宽区间再查。
单据号有两种前缀：Vsc 开头和 No 开头，都是本功能的单据号，来自不同的建单来源（网页端建单与同步过来的单）。别把前缀当成状态判断依据。
制单人列显示在单据摘要之后，追责时直接看这一列。
单据详情（已生效）
标题是「会员卡状态修改单: Vsc261022000001」，右侧两个状态标签 已生效、已审核。
工具栏：返回 / 反审核 / 更多 ▾（当前只有 复制）/ 打印 / 附件 ( 0 )。
页签三个：基本信息、会员卡明细、备注信息。
| 页签 | 内容 |
|---|---|
| 基本信息 | 单据日期*、会员类型*、手写单号、单据摘要 |
| 会员卡明细 | 表头 导出，列 # / 会员卡号 / 会员姓名 / 原卡状态 / 新卡状态 / 备注 / 修改人 / 修改时间 |
| 备注信息 | 单据级备注 |
表尾固定显示「[只读] 制单日期 2026-10-22 11:28:02 制单人 … 过帐日期 2026-10-22 11:28:32 记帐人 …」。制单日期与过帐日期不是同一个时间，中间那段就是审核动作发生的时间。
已生效的单据没有「编辑」按钮，只有 反审核。要改内容，先反审核退回可编辑态。
新增单据
点 新增 进入 /add/ 页。工具栏变成 返回 / 保存 / 复制 / 删除；明细区上方一组行操作 ＋添加行、选择会员、删除选中，右侧 清零、清空、导出。
明细空态提示「暂无数据，点击上方按钮添加」。
选择会员卡弹窗
点 选择会员 弹出「选择会员卡」窗：
| 区域 | 内容 |
|---|---|
| 筛选行 | 关键字框（「搜索...」）、蓝色 搜索、卡号段（最小 ~ 最大）、会员类型: 全部、持卡人姓名（「请输入」）、更多筛选 ▼、蓝色 查看已选 |
| 列表 | 勾选 / 卡号 / 姓名 / 状态 / 余额 / 积分 / 返利 / 电话 |
| 分页 | 「共 N 条，第 X/Y 页」+ 首页/上一页/页码/下一页/末页 |
| 底部 | 选择所有 复选框、「已选 N 项」、取消、蓝色 确定 |
卡号段 是这扇窗最高效的入口：门店批量挂失的往往是连号卡，填最小 4448801、最大 4448850 一次圈进来，比翻页勾五十次快。
更多筛选 ▼ 展开的是状态、分店等扩展条件；查看已选 把列表切成「只显示已勾的」，勾完核对再用。
三、业务操作步骤
批量挂失一批卡
- 会员管理 → 单据 → 会员卡状态修改单，点蓝色 新增。
- 在 基本信息 填 单据日期（默认今天）和 会员类型（必填，决定这张单能处理哪一类卡）。
- 填 单据摘要，写清原因，如「2026-10 门店盘点遗失卡挂失」。摘要会出现在列表列里，是日后检索的主要线索。
- 切到 会员卡明细，点 选择会员。
- 弹窗里用 卡号段 或 持卡人姓名 圈出目标卡，逐个勾选，看底部「已选 N 项」核对数量，点 确定。
- 明细表出现这些行，原卡状态 自动带出，新卡状态 为空。
- 在 新卡状态 列逐行选 挂失；要一次全填，用列头的批量填充（若有）或 ＋添加行 后逐行设。
- 点 保存。单据生成一个
No或Vsc开头的单据号，状态为未审核。 - 点 审核（未审核时工具栏显示；已保存进详情后可见）。审核通过后标签变成 已生效 / 已审核，过帐日期 和 记帐人 填上。
- 收银端等一次同步，这些卡在前台不能再消费。
只改其中几张，改错了怎么办
- 明细里删行：勾选该行 → 点 删除选中。这只删单据行，不影响卡本身。
- 已经审核了：反审核 → 单据退回可编辑 → 改明细 → 重新审核。
- 反审核前确认收银端有没有已经按新状态跑过的业务，反审核会把状态回退，可能造成前台数据不一致。
查找某张卡的状态是被谁改的
- 列表页 ⚙ 高级筛选，在抽屉里用 单据号 / 单据状态 / 制单日期 / 记账日期 / 制单人 / 记账人 / 原单据号 / 备注 组合筛。
- 高级筛选不支持「按会员卡号查单据」，所以另一条路是：进 会员卡 详情 → 卡务安全 → 修改记录，那里按卡看得到每一次字段变更。
- 两条路交叉验证最稳。
复制一张单做月度例行处理
- 打开上个月的单据，点 更多 ▾ → 复制。
- 新单继承明细行，单据日期 变成今天。
- 核对明细（上月挂的卡这月可能不需要重复挂），删掉多余行。
- 保存 → 审核。
四、字段详细说明
单据字段
| 字段 | 必填 | 含义 |
|---|---|---|
| 单据日期 | 是 | 业务发生日期，进入列表的日期筛选口径；受「启用会员业务单据日期管控」限制必须在当前会计期，见 会员设置特点 |
| 会员类型 | 是 | 这张单处理的卡类别。类型选错，选择会员弹窗里就圈不到目标卡 |
| 手写单号 | 否 | 手工单号，用于和纸质单据对齐；留空则系统生成 |
| 单据摘要 | 否 | 变更原因，列表直接显示这一列，建议必填习惯化 |
明细字段
| 字段 | 含义 |
|---|---|
| 会员卡号 | 被改的卡 |
| 会员姓名 | 带出，不可改 |
| 原卡状态 | 加行时的快照，用于事后核对「当时到底是什么状态」 |
| 新卡状态 | 本行要改成的目标状态，逐行独立，同一张单可以一半挂失一半解挂 |
| 备注 | 行级说明，如「客人来电挂失，工单号 XXX」 |
| 修改人 / 修改时间 | 系统回填，不是人填 |
新卡状态可选值
与 会员卡 的状态枚举一致：正常 / 停用 / 挂失 / 作废 / 退卡 / 未激活 / 停用（并取消微信会员）/ 已过期。
已过期 不能手工选，它由系统按有效期判定。未激活 一般也不是手工目标——那是发卡流程自动落的。
单据状态
列表 单据状态 列显示单据流转状态（如 已生效），与卡的状态是两回事：单据已生效 = 这批卡的变更已经落到库；卡状态 = 每张卡自己的可用性。
五、典型使用场景
场景一：门店员工卡集中挂失
门店交接，一批 30 张员工卡要找不回实物了。
- 新增单，会员类型 选员工卡类别。
- 选择会员 → 卡号段 填这批连号卡的起止 → 全选 → 确定。
- 新卡状态 统一设 挂失，备注 写「交接遗失」。
- 保存 → 审核。
- 到 会员消费报表 反查这批卡在挂失后有没有再出现消费，验证是否真的止住了。
场景二：季度清僵尸卡
- 先在 会员卡 列表按 所属分店 筛出目标范围，用 概览 的最近消费日期抽样确认口径。
- 新增状态修改单，会员类型 选长期不动的类别。
- 选择会员 用 更多筛选 ▼ 缩小范围，勾出这批卡。
- 新卡状态 设 停用（不要设作废——停用可逆，作废不可逆）。
- 保存 → 审核。三个月内无人申诉再考虑转 退卡。
场景三：客人解挂
客人找回卡，要恢复使用。
- 新增单，会员类型 选该卡类别。
- 选择会员 按手机号或卡号搜出这张卡。
- 新卡状态 设 正常。
- 保存 → 审核。
- 若这张卡同时被解过微信绑定，需要客人在小程序侧重新领取，见 会员卡 的「解除微信绑定」。
六、权限控制与前置条件
菜单权限：需要「会员管理 → 单据 → 会员卡状态修改单」的查看、新增、审核权限。审核权限建议与制单权限分开授，避免同一人自制自审，见 30权限与授权。
前置条件：
- 会员类型 必须先选，且制单人对该类型、对目标卡所属分店都有数据权限，否则 选择会员 弹窗里圈不到卡。
- 目标卡必须存在且未被删除。
- 单据日期必须在当前会计期内（若系统特点开启了会员业务单据日期管控），见 会员设置特点。
- 审核后收银端要等一次同步，前台才拦得住。
跨端一致性：客户端「会员管理 → 会员单据 → 会员卡状态修改单」与本功能读写同一批表；从客户端建的单在网页端可查可审，但只有从网页端新建并保存过的单才能回到网页端再次编辑。
七、常见问题
新增完找不到这张单。 默认日期条件是「本月」，若这张单的 单据日期 落在上个月（例如补录），点 上月 或 自定义 再查。
选择会员弹窗里搜不到那张卡。 三个原因：单据上的 会员类型 和这张卡的类别不一致；这张卡属于你没有数据权限的分店；关键字输的是条码或姓名片段而该字段要求完整值。
明细里「新卡状态」是空的，审核后卡没变。 新卡状态是逐行必填的目标值，留空表示这行不改。审核前扫一遍这一列，别留空。
能不能一张单里一半挂失一半解挂？ 可以，新卡状态逐行独立。但不建议——摘要只能写一个原因，混着改事后说不清。
审核按钮点不了。 两种情况：一是你没有审核权限；二是这张单已经是「已生效」状态，已经生效的单没有编辑，只有 反审核。
反审核有风险吗？ 有。反审核会把状态回退，如果收银端已经按新状态跑过业务（比如挂失后又有人拿这张卡来解挂消费），会造成状态与流水不一致。反审核前先确认这段时间该卡没有新业务。
改完状态前台还能刷。 收银端还没同步。让门店手工触发一次同步；仍不对，回列表确认这张单确实是 已生效 而不是只 保存。