Skip to content

会员导入管理 ​

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

一、功能概述 ​

菜单位置:会员管理 → 编码 → 会员导入管理(页面地址 /admin/VIP/vipimportmanagepage/)

会员导入管理列表:表格列为批次号、导入方案、源文件、总行、可导入、阻断、提示、剔除、已入库、状态

用途说明
批量导入会员把 Excel 会员名单一次性导入系统,免去逐张建卡
带期初余额积分导入时一并写入余额、积分,生成期初台账
清洗与修正自动逐行校验,问题行可就地改、整列指定或剔除
批次管理按批次跟踪进度,中断可续处理,入库后锁死留痕

本窗口由两部分组成:

  1. 导入历史列表:列出所有会员导入批次及其行数统计、状态、操作人和时间,是批次管理的主线;
  2. 新增导入向导:点「新增导入」打开的五步向导(整理 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,再点 上传并自动清洗:

  1. 系统自动用/建导入方案,解析文件并灌入暂存,提示「已解析 N 行(空行 N),开始清洗…」;
  2. 自动跳到第 3 步并逐行清洗;
  3. 若该文件之前导入过(MD5 一致),会提示「该文件之前导入过(MD5 一致),已拒绝重复导入」。

一般不用动「高级 · 导入方案与写法对照」;需要复用配置或登记别名时再展开(见场景 4)。

步骤 5:看清洗报告(第 3 步) ​

清洗后按四态统计每一行:

状态含义
可导入没问题,可写入
阻断有问题导入不了,看原因去修改
提示可导入能导入但建议确认
人工剔除已被手工剔除,不参与导入

页面列出「拒绝原因 TOP」;若有行因「Excel 写法没对上系统名称」被拦下,下方就地对照面板会列出被拦的源值,填上系统名称后点 保存对照并重新清洗 即可原地重洗。点 开始清洗 可重跑,点 去修改 进第 4 步。

步骤 6:手工修改(第 4 步) ​

两条修正路径:

  1. 双击格子当场改:改完立即重新校验该行,状态徽标随之刷新;
  2. 导出异常明细:点「导出异常明细」在 Excel 里改好,再回第 2 步重新上传。

还可以:

  • 用状态过滤(全部状态/可导入/阻断/提示可导入/人工剔除)和关键字(搜卡号/姓名)+「查询」定位行;
  • 整列指定:选一列、填指定值,可勾「仅本页显示行」,点「应用并重新清洗」批量覆盖该列并逐行留痕,自动重跑清洗;
  • 行内操作列可「剔除」某行(变为人工剔除),剔除行可「恢复」;人工剔除行不可编辑。

改完点 去导入 进第 5 步。

步骤 7:确认导入(第 5 步) ​

点 确认导入,弹出确认(含提示「可导入+提示可导入的行将写入会员档案并生成期初台账;入库后批次锁死(核查留痕),如需重导走解锁流程。」):

  1. 确认后写入开始,进度条实时显示阶段与可导入/阻断行数;
  2. 写完提示「导入完成,批次已锁死」,并显示结果「已入库锁死:共 N 条,新增 N 条,拒绝 N 条,更新 0 条,无变化 0 条(模式 A 只做新增)」;
  3. 入库后本批次锁死留痕,不可再改。

步骤 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 步「高级 · 导入方案与写法对照」里选对照字段、查看源值分布、登记目标值后保存。同名写法会自动命中,只有别名才需登记。

六、权限控制与前置条件 ​

  1. 导入按钮权限:导入受「会员卡管理」窗口的按钮权限位「导入」控制;未配置该权限位时默认放行,超级管理员直通。无权限时提示「无导入权限(会员卡管理-导入)」。
  2. 前置会员类别:Excel 的「会员类别」必须对上系统里已启用的 会员卡类型,否则被「类别未对照」或「类别已停用」拦下。
  3. 只做新增(模式 A):当前导入只做新增,不更新已有会员;卡号在库内已存在的行会被查重拦下。
  4. 期初台账条件:余额、积分非 0 的行须满足建台账条件,负数一律拒绝。
  5. 入库锁死:批次一旦入库即锁死留痕,不可继续处理、不可作废;如需重导走解锁流程。

七、常见问题 ​

1. 点新增导入提示无导入权限 ​

  • 原因:操作员没有「会员卡管理-导入」按钮权限;
  • 处理:由管理员在会员卡管理窗口授予「导入」按钮权限,或用有权限的账号操作。

2. 上传提示「该文件之前导入过(MD5 一致),已拒绝重复导入」 ​

  • 原因:同一文件已导入过,系统按文件 MD5 防重复;
  • 处理:确需重导,修改文件内容后重新上传,或走解锁流程处理原批次。

3. 很多行被「类别未对照」拦下 ​

  • 原因:Excel 的会员类别写法与系统名称不一致(别名);
  • 处理:在第 3 步就地对照面板填上系统名称,保存对照并重新清洗;同名写法会自动命中,无需登记。

4. 余额/积分行被「须可建台账」拦下 ​

  • 原因:余额或积分非 0,但当前条件不能生成期初台账;
  • 处理:确认会员类别等台账条件满足后再导;不需要带余额积分的,把这两列清空或置 0。

5. 提示卡号重复 ​

  • 原因:卡号在本批次内重复,或系统库里已有该卡号(模式 A 只做新增);
  • 处理:去掉批内重复行;库内已存在的卡号不会被更新,确需变更走会员卡档案维护。

6. 已入库批次点「继续处理」被拒 ​

  • 原因:批次已入库锁死,会员已写入档案;
  • 处理:提示「该批次已入库锁死,不可继续处理(查看明细请用「查看明细」)」,改用「明细」查看,或走解锁流程。

7. 已入库批次能不能作废 ​

  • 原因:已入库批次会员已写入档案,不可删除作废;
  • 处理:提示「该批次已入库锁死(会员已写入档案),不可删除作废」;只有未入库批次(已解析/清洗中/待人工)可作废。

8. 导入后助记码和 Excel 不一样 ​

  • 原因:助记码不由 Excel 提供,入库时按姓名拼音自动重算;
  • 处理:这是正常行为,助记码始终与姓名一致。

9. 农历生日导入后变了 ​

  • 原因:生日列支持农历,清洗时自动转公历;
  • 处理:这是预期行为,系统按公历存储生日并保留农历标记。