会员导入管理
会员导入管理是把外部会员名单批量搬进系统的入口:从旧系统或线下表格导出的会员 Excel,经过「上传 → 自动清洗 → 手工修正 → 确认导入」五步向导,校验通过的行写入会员档案并生成期初余额、积分台账。每一次导入都是一个批次,本窗口集中管理所有批次的进度与结果——未处理完的批次可以接着处理,已入库的批次锁死留痕、可查明细可导出,保证导入过程可追溯。
一、功能概述
菜单位置:会员管理 → 编码 → 会员导入管理(页面地址 /admin/VIP/vipimportmanagepage/)

| 用途 | 说明 |
|---|---|
| 批量导入会员 | 把 Excel 会员名单一次性导入系统,免去逐张建卡 |
| 带期初余额积分 | 导入时一并写入余额、积分,生成期初台账 |
| 清洗与修正 | 自动逐行校验,问题行可就地改、整列指定或剔除 |
| 批次管理 | 按批次跟踪进度,中断可续处理,入库后锁死留痕 |
本窗口由两部分组成:
- 导入历史列表:列出所有会员导入批次及其行数统计、状态、操作人和时间,是批次管理的主线;
- 新增导入向导:点「新增导入」打开的五步向导(整理 Excel → 上传 Excel → 清洗 Excel → 手工修改 → 导入),完成一次导入。
二、界面布局说明
导入历史列表
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增导入(打开导入向导)、查询、重置 |
| 列表 | 批次号 / 导入方案 / 源文件 / 总行 / 可导入 / 阻断 / 提示 / 剔除 / 已入库 / 状态 / 操作人 / 开始时间 / 完成时间 / 操作 |
- 列表按批次号倒序,最新的批次排在最前,默认每页 30 条。
- 批次号和操作列冻结,横向滚动时保持可见。
- 行内操作列按批次状态显示不同按钮:未入库批次有「继续处理 / 明细 / 导出 / 作废」;已入库批次「继续处理」位置显示「已锁死」,且不再有「作废」,只保留「明细 / 导出」。
新增导入向导
向导顶部是五步进度条:1 整理Excel → 2 上传Excel → 3 清洗Excel → 4 手工修改 → 5 导入,当前步高亮。每一步是一张卡片:
| 步骤 | 卡片内容 |
|---|---|
| 1 整理Excel | 「下载模板」按钮,按模板列头整理数据 |
| 2 上传Excel | 「选择文件」「上传并自动清洗」;高级折叠里有导入方案与写法对照 |
| 3 清洗Excel | 四态统计(可导入/阻断/提示可导入/人工剔除)、拒绝原因 TOP、就地对照面板;「开始清洗」「去修改」 |
| 4 手工修改 | 暂存明细网格,状态过滤 + 关键字搜索;「导出异常明细」「整列指定」;「去导入」 |
| 5 导入 | 进度条与「确认导入」,入库后显示结果统计 |
三、业务操作步骤
步骤 1:打开导入历史列表
会员管理 → 编码 → 会员导入管理,看到所有历史批次。
步骤 2:发起新增导入
点工具栏 新增导入,在新页签打开「会员 Excel 导入」向导,停在第 1 步。
步骤 3:整理 Excel(第 1 步)
点 下载模板 拿到标准 Excel 模板,按模板列头填数据。第 1 行是列头,不要删。会员类别等名称写法与系统名称相同的会自动命中,只有别名(如 Excel 写「金卡」、系统叫「萌新会员」)才需要登记对照。
步骤 4:上传并自动清洗(第 2 步)
点 选择文件 选整理好的 .xlsx 或 .csv,再点 上传并自动清洗:
- 系统自动用/建导入方案,解析文件并灌入暂存,提示「已解析 N 行(空行 N),开始清洗…」;
- 自动跳到第 3 步并逐行清洗;
- 若该文件之前导入过(MD5 一致),会提示「该文件之前导入过(MD5 一致),已拒绝重复导入」。
一般不用动「高级 · 导入方案与写法对照」;需要复用配置或登记别名时再展开(见场景 4)。
步骤 5:看清洗报告(第 3 步)
清洗后按四态统计每一行:
| 状态 | 含义 |
|---|---|
| 可导入 | 没问题,可写入 |
| 阻断 | 有问题导入不了,看原因去修改 |
| 提示可导入 | 能导入但建议确认 |
| 人工剔除 | 已被手工剔除,不参与导入 |
页面列出「拒绝原因 TOP」;若有行因「Excel 写法没对上系统名称」被拦下,下方就地对照面板会列出被拦的源值,填上系统名称后点 保存对照并重新清洗 即可原地重洗。点 开始清洗 可重跑,点 去修改 进第 4 步。
步骤 6:手工修改(第 4 步)
两条修正路径:
- 双击格子当场改:改完立即重新校验该行,状态徽标随之刷新;
- 导出异常明细:点「导出异常明细」在 Excel 里改好,再回第 2 步重新上传。
还可以:
- 用状态过滤(全部状态/可导入/阻断/提示可导入/人工剔除)和关键字(搜卡号/姓名)+「查询」定位行;
- 整列指定:选一列、填指定值,可勾「仅本页显示行」,点「应用并重新清洗」批量覆盖该列并逐行留痕,自动重跑清洗;
- 行内操作列可「剔除」某行(变为人工剔除),剔除行可「恢复」;人工剔除行不可编辑。
改完点 去导入 进第 5 步。
步骤 7:确认导入(第 5 步)
点 确认导入,弹出确认(含提示「可导入+提示可导入的行将写入会员档案并生成期初台账;入库后批次锁死(核查留痕),如需重导走解锁流程。」):
- 确认后写入开始,进度条实时显示阶段与可导入/阻断行数;
- 写完提示「导入完成,批次已锁死」,并显示结果「已入库锁死:共 N 条,新增 N 条,拒绝 N 条,更新 0 条,无变化 0 条(模式 A 只做新增)」;
- 入库后本批次锁死留痕,不可再改。
步骤 8:回列表管理批次
回到导入历史列表,对该批次:
- 继续处理:未入库批次(已解析/清洗中/待人工)回到向导第 3 步接着处理;
- 明细:打开向导第 4 步网格查看每张卡的导入信息/状态/原因(已入库批次为只读);
- 导出:导出该批次明细;
- 作废:仅未入库批次可删除作废,提示「批次 N 已删除作废」;已入库批次不可作废。
四、字段详细说明
1)导入历史列表字段
| 字段名 | 含义 |
|---|---|
| 批次号 | 一次导入的唯一编号,冻结列 |
| 导入方案 | 本批次使用的导入方案名 |
| 源文件 | 上传的 Excel 文件名 |
| 总行 | 解析出的总行数 |
| 可导入 | 校验通过、可写入的行数 |
| 阻断 | 有问题、导入不了的行数 |
| 提示 | 提示可导入的行数 |
| 剔除 | 人工剔除的行数 |
| 已入库 | 实际写入档案的行数 |
| 状态 | 批次当前状态(见下表) |
| 操作人 | 发起导入的操作员 |
| 开始时间 / 完成时间 | 批次开始与完成时间 |
| 操作 | 行内按钮:继续处理/明细/导出/作废(按状态显示),冻结列 |
2)批次状态枚举
| 取值 | 含义 |
|---|---|
| 已解析 | 文件已解析灌入暂存 |
| 清洗中 | 正在逐行校验 |
| 待人工 | 清洗完成,等待人工修正/确认 |
| 已入库锁死 | 已写入档案,批次锁定留痕,不可再改 |
| 已归档 | 批次归档 |
3)行四态枚举
| 取值 | 含义 |
|---|---|
| 可导入 | 校验通过,将写入档案 |
| 阻断 | 有问题导入不了,需修正 |
| 提示可导入 | 能导入但建议确认 |
| 人工剔除 | 手工剔除,不参与导入,可恢复 |
4)Excel 模板列
| 列名 | 必填 | 说明 |
|---|---|---|
| 卡号 | 是 | 会员唯一键,最长 20;批内与库内查重 |
| 姓名 | 是 | 会员姓名,最长 20 |
| 手机 | 否 | 手机号,自动规范化并校验 |
| 性别 | 否 | 枚举,按对照映射 |
| 生日 | 否 | 日期,支持多种格式,农历自动转公历 |
| 会员类别 | 是 | 选择型,须对上系统会员卡类型;合并单元格自动向下填充 |
| 余额 | 否 | 数字,非 0 须可建期初台账,负数拒绝 |
| 积分 | 否 | 数字,非 0 须可建期初台账,负数拒绝 |
| 身份证 | 否 | 最长 20,自动规范化 |
助记码不在 Excel 里提供,入库时按姓名拼音自动重算。
5)常见清洗拦截原因
| 原因 | 含义 |
|---|---|
| 类别未对照 | Excel 的会员类别写法没对上系统名称,需登记对照 |
| 类别已停用 | 对照到的会员卡类型已停用 |
| 余额/积分须可建台账 | 余额或积分非 0,但当前条件不能生成期初台账 |
| 余额/积分为负 | 余额或积分为负数,拒绝导入 |
| 卡号重复 | 卡号在本批次内或系统库里已存在 |
五、典型使用场景
场景 1:旧系统会员迁移
背景:换系统,要把旧系统的几万张会员档案搬过来。 操作:从旧系统导出会员 Excel → 按模板整理列头 → 新增导入 → 上传并自动清洗 → 处理阻断行 → 确认导入。可导入与提示可导入的行写入档案,批次锁死留痕。
场景 2:批量建卡带期初余额积分
背景:线下已有一批储值会员,要带余额、积分一次性建卡。 操作:Excel 填好卡号、姓名、会员类别、余额、积分 → 导入。余额积分非 0 的行会生成期初台账;若提示「须可建台账」,先确认会员类别与台账条件满足后再导。
场景 3:中断批次接着处理
背景:上次导入清洗到一半下班了,批次停在「待人工」。 操作:导入历史列表找到该批次 → 点「继续处理」→ 回到向导第 3 步清洗报告 → 接着修正、导入。已入库批次则只能点「明细」查看,不能继续处理。
场景 4:别名对照(金卡 → 萌新会员)
背景:旧系统类别叫「金卡」,系统里叫「萌新会员」,清洗时被「类别未对照」拦下。 操作:在第 3 步就地对照面板填「金卡 → 萌新会员」→ 保存对照并重新清洗;或在第 2 步「高级 · 导入方案与写法对照」里选对照字段、查看源值分布、登记目标值后保存。同名写法会自动命中,只有别名才需登记。
六、权限控制与前置条件
- 导入按钮权限:导入受「会员卡管理」窗口的按钮权限位「导入」控制;未配置该权限位时默认放行,超级管理员直通。无权限时提示「无导入权限(会员卡管理-导入)」。
- 前置会员类别:Excel 的「会员类别」必须对上系统里已启用的 会员卡类型,否则被「类别未对照」或「类别已停用」拦下。
- 只做新增(模式 A):当前导入只做新增,不更新已有会员;卡号在库内已存在的行会被查重拦下。
- 期初台账条件:余额、积分非 0 的行须满足建台账条件,负数一律拒绝。
- 入库锁死:批次一旦入库即锁死留痕,不可继续处理、不可作废;如需重导走解锁流程。
七、常见问题
1. 点新增导入提示无导入权限
- 原因:操作员没有「会员卡管理-导入」按钮权限;
- 处理:由管理员在会员卡管理窗口授予「导入」按钮权限,或用有权限的账号操作。
2. 上传提示「该文件之前导入过(MD5 一致),已拒绝重复导入」
- 原因:同一文件已导入过,系统按文件 MD5 防重复;
- 处理:确需重导,修改文件内容后重新上传,或走解锁流程处理原批次。
3. 很多行被「类别未对照」拦下
- 原因:Excel 的会员类别写法与系统名称不一致(别名);
- 处理:在第 3 步就地对照面板填上系统名称,保存对照并重新清洗;同名写法会自动命中,无需登记。
4. 余额/积分行被「须可建台账」拦下
- 原因:余额或积分非 0,但当前条件不能生成期初台账;
- 处理:确认会员类别等台账条件满足后再导;不需要带余额积分的,把这两列清空或置 0。
5. 提示卡号重复
- 原因:卡号在本批次内重复,或系统库里已有该卡号(模式 A 只做新增);
- 处理:去掉批内重复行;库内已存在的卡号不会被更新,确需变更走会员卡档案维护。
6. 已入库批次点「继续处理」被拒
- 原因:批次已入库锁死,会员已写入档案;
- 处理:提示「该批次已入库锁死,不可继续处理(查看明细请用「查看明细」)」,改用「明细」查看,或走解锁流程。
7. 已入库批次能不能作废
- 原因:已入库批次会员已写入档案,不可删除作废;
- 处理:提示「该批次已入库锁死(会员已写入档案),不可删除作废」;只有未入库批次(已解析/清洗中/待人工)可作废。
8. 导入后助记码和 Excel 不一样
- 原因:助记码不由 Excel 提供,入库时按姓名拼音自动重算;
- 处理:这是正常行为,助记码始终与姓名一致。
9. 农历生日导入后变了
- 原因:生日列支持农历,清洗时自动转公历;
- 处理:这是预期行为,系统按公历存储生日并保留农历标记。
