会员卡充值批量导入

会员卡充值单除了逐张读卡充值，还支持按卡类别建立一张单据，再用表格一次导入多张会员卡的充值金额和赠送金额，核对无误后整单生效。企业团购卡、门店集中补充值、活动批量赠送这类"同一批卡、金额各不相同"的业务，用批量导入可以省掉几十上百次重复录入。

一、功能概述

1. 功能简介

批量导入的本质是：先按卡类别开一张空的充值单，再把表格里"卡号 + 充值金额 + 赠送金额"三列数据映射到单据明细行，由客户端逐行校验卡号或手机号是否查得到卡，最后整单生效入账。

校验口径分两条：

1. 表格中填了卡号：按卡号取卡，不校验这张卡是否属于单据所选的卡类别，非本类别的卡不会被自动剔除；
2. 卡号列为空、只填了手机号：按手机号取卡，这时才限定本单据的卡类别，该类别下没有对应手机号即报错；
3. 卡号列有值时手机号列不再参与取卡，取到卡后只校验卡状态与是否允许充值。

功能路径：系统菜单 → 会员管理 → 会员业务 → 会员卡充值

2. 核心用途

1. 团购充值：一次为几十张卡写入不同金额，避免逐张录入；
2. 活动补赠：把赠送金额随充值一起导入，不需要再开赠送单；
3. 集中发卡：门店批量发卡后统一充值，当天完成当天生效；
4. 数据交接：接手外部系统或线下台账时，按表格批量落账。

3. 与逐张充值的区别

方式	适用情况	特点
逐张读卡充值	前台单笔收款	现场读卡、现场收款、当场写卡
批量导入充值	后台一次性处理一批卡	表格录入、整单生效，不依赖读卡器

二、界面布局说明

充值单窗口分为单据头、明细表、金额汇总三个区域。

单据头

字段	说明
原始单号	关联的外部单据编号，可留空
单据日期	本张充值单的业务日期，决定计入哪个会计期
卡类别	本单要充值的会员卡所属类别；表格中填了手机号时才按该类别取卡，填了卡号时按卡号直接取卡
部门	归属部门，用于业绩与提成统计

明细表

字段	说明
会员卡编号	要充值的卡号，导入的主键
持卡人名称	由卡号自动带出，不需要在表格里填写
手机号	由卡号自动带出，可用于核对是否选错卡
本次充值	本次写入卡内本金的金额
本次赠送	本次写入卡内赠送金额
充值前余额 / 充值后余额	系统按卡内当前余额自动计算
读写状态	实体卡写卡是否完成的状态标记

工具栏

工作、常用、帮助三个菜单，加上退出、打印、状态、编辑、收款、读卡、导入EXCEL文件、导入中转站数据、新增单据、查找、模板、上一张单据、下一张单据等按钮。批量导入用到的是【导入EXCEL文件】和【状态】。

三、业务操作步骤

步骤 1：准备导入表格

新建一个表格文件，第一行写表头，从第二行开始填数据，至少三列：会员卡编号、本次充值、本次赠送。工作表名保持默认（如 Sheet1），不要有多余的空行和合并单元格。

要求：

1. 卡号列填后台已发放的会员卡号；卡号列留空、只填手机号时，该手机号必须落在本单所选卡类别下才取得到卡；
2. 金额填数字，不要带货币符号和千分位逗号；
3. 只充值不赠送时，赠送列填 0 或整列留空；
4. 同一张卡在同一份表格里只出现一次。

步骤 2：打开充值单并新增

系统菜单 → 会员管理 → 会员业务 → 会员卡充值，点【新增单据】，在单据头选择卡类别。

新建的单据处于「草稿」状态，【导入EXCEL文件】只有在草稿状态下可用；单据一旦【生效】或【关闭】，这个按钮立即变灰。

步骤 3：导入表格文件

点【导入EXCEL文件】，在"外部数据导入"窗口点【打开文件...】，选中步骤 1 准备好的表格，来源表列表中会出现该文件的工作表，双击选中。

明细表里已有充值行时不能直接导入，系统会中止并提示「已存在充值明细,请清空后导入!」，先把明细清空再导入。

步骤 4：映射表格列

在"外部数据导入"窗口中，左列是需要导入的目标列，右列下拉选择表格中对应的表头。把会员卡编号、本次充值、本次赠送三列一一对好，其余列留空。

• 当前字段：单据明细里需要被写入的列；
• 导入字段：从表格中取数的列；
• 次选字段：备用取数列。只有"导入字段"这一列在本行取到空值时，才回落到"次选字段"；导入字段有值时次选字段一律不参与；两列都取不到值，这个目标字段就不写，保留明细行原样。

映射关系的保存与复用：

1. 每次导入成功后，系统会自动记住本次的列对应关系，下次导入同一份表格结构、同一张目标表时自动套用，不必重新映射；换了表格列结构或换到别的单据就要重新对应；
2. 需要固定一套对应关系时点【保存映射关系】，按提示在"请命名映射关系"里输入名称；同名时系统问「已经存在该映射关系,是否覆盖?」，确认后覆盖，保存成功提示「映射关系保存成功,名称为:Map_＋名称」；当前映射区没有内容时报「不形成映射关系，无法保存！」；
3. 下次在导入窗口点【载入映射关系】，列表里是这套账曾经存过的全部映射，选中名称后套用；没选中任何一条时提示「请选择映射关系!」，覆盖当前已有的对应关系前会问「导入将覆盖现有的映射关系,确定导入?」；
4. 命名保存的映射关系随账套存放在服务器上，同一账套换一台电脑登录也能载入，不是只记在本机。

步骤 5：确认导入

点【确定】，系统提示"数据导入完成"。回到单据后，明细表按行显示卡号、充值金额、赠送金额和自动带出的持卡人与手机号。

写入过程中任何一行取不到卡，整批导入当场中止：按卡号取不到报「不存在卡号为[xxx]的会员卡!」，按手机号取不到报「不存在手机号[xxx]对应的会员卡!」，该卡不允许充值报「[xxx]会员卡不允许充值！」。

步骤 6：核对并整单生效

逐行核对卡号与金额，确认单据底部的单据金额与表格合计一致后，点【状态】→【生效】。生效后卡内余额立即增加，可在会员卡管理的账本中查到这笔充值。

核对重点：

1. 明细行数是否等于表格数据行数；
2. 单据金额是否等于表格中充值金额之和；
3. 有没有卡号带出空白持卡人，说明该卡在后台不存在或已被删除。

四、典型使用场景

场景 1：企业团购卡一次充完

企业客户采购一批会员卡作为福利，卡号、充值金额、赠送金额已在客户确认的表格里。经办人按卡类别开一张充值单，导入表格，核对合计后整单生效，再统一把实体卡写卡发放。

场景 2：门店集中补充值

门店当天收了一叠充值申请单，收银员来不及逐张处理。后台按该门店常用的卡类别开单，导入当天汇总表，一次生效，避免前台长时间排队占用收银机。

场景 3：活动赠送随充值一起写入

活动规则是"充 1000 送 200"，赠送金额直接写在表格的本次赠送列，导入后一次生效，不需要再开一张赠送单。若账套启用了充值赠送金额控制，赠送比例超出限制的行会被拦截，此时应先核对活动规则再重新导入。

五、权限控制与前置条件

1. 会员卡充值单的新增、导入、生效分别受窗口权限控制，只给收银主管、门店店长或总部会员管理岗位开放生效权限；
2. 卡类别、会员卡档案必须先建好，导入只做充值不做发卡；表格里的卡号取不到卡、或该卡不允许充值时，整批导入当场中止，不是跳过这一行继续导；
3. 实体卡（IC 卡）批量充值后仍需写卡，未写卡的卡在前台消费时以账内余额为准；
4. 分店充值若启用了收款方式管控，本单选择的收款方式必须在门店可用范围内，详见分店充值收款方式配置；
5. 涉及会员档案的批量导入导出，客户端会弹出会员数据保护提示并要求操作员验证，导入前后不要把原始表格留在公共电脑上。

六、常见问题

导入后明细是空的

• 原因：来源表没有双击选中，或三列映射没有全部选上表头；
• 处理：重新打开导入窗口，在来源表列表中双击目标工作表，再检查卡号、本次充值、本次赠送三列的对应关系。

提示「已存在充值明细,请清空后导入!」

• 原因：当前单据明细里已经有充值行，批量导入不允许在已有明细上追加；
• 处理：先清空本单明细再点【导入EXCEL文件】；要补几张卡就重新开一张草稿单导入。

单据已经生效，【导入EXCEL文件】点不动

• 原因：批量导入只在单据处于「草稿」状态时开放，单据【生效】或【关闭】后按钮变灰；
• 处理：另开一张新的充值单，在草稿状态下导入。

提示卡号不存在

• 原因：卡号未发放、已被删除，或表格里卡号被识别成数字丢了前导零；
• 处理：把卡号列设置为文本格式重新保存表格；确认卡已在会员卡管理中建档。按卡号取卡时系统不看卡类别，非本单据卡类别的卡也能取到并充值；卡号列留空、只填手机号时才会按本单据的卡类别找卡，报「不存在手机号[xxx]对应的会员卡!」。

金额列导入后是 0

• 原因：表格里金额带货币符号或千分位，或这一列只映射到了次选字段、导入字段留空；
• 处理：金额列改为纯数字；把实际有数的列映射到"导入字段"，"次选字段"只在导入字段取到空值时才顶上来。

生效按钮点不动

• 原因：单据仍处于编辑状态，或本单没有明细行；
• 处理：先点【编辑】退出编辑态，确认明细有数据，再点【状态】→【生效】。

一批卡里有几张金额要改

• 原因：整表重导会产生重复行；
• 处理：只修改明细行上的金额后生效，不要重复导入同一张卡；已经误导入的，撤销本张单据（【状态】→【关闭单据】前的撤销操作）后重新开单。

表格列名和系统列名对不上

• 原因：表头写的是自定义名称；
• 处理：用【导入字段】下拉直接选择表格实际表头即可，不要求表头文字与系统完全一致，只要对应关系正确。

七、与其他功能的关系

环节	对应功能
会员卡建档与批量导入档案	会员卡管理导入数据
卡类别与赠送规则	会员卡级别
充值赠送金额控制、前台充值开关	会员卡设置用户特点
分店充值可用收款方式与资金归集	分店充值收款方式配置
卡挂失、停用、退卡	卡状态修改
前台单笔充值与会员操作入口	新零售门店应用
网页端对应单据	会员卡充值单