从 Excel 迁移到闪仓 WMS：一份务实的操作指南
闪仓 WMS 提供完整的 Excel 导入功能，支持模板下载、27 个字段映射、重复数据处理策略。本文详解从电子表格到专业仓库管理系统的迁移路径，包括数据准备、常见错误排查和两周并行过渡方案。
为什么要离开 Excel
Excel 管库存的问题不在于 Excel 本身，而在于规模。当你只有一个仓库、几十种商品时，一张表格完全够用。但当商品超过 500 种、涉及多人协作、需要出入库审核流程时，Excel 的局限就变得明显：没有权限控制、没有操作日志、公式容易被误改、多人同时编辑会产生冲突。
这些不是假设的场景，而是中小企业仓库管理中反复出现的真实问题。
闪仓 WMS 提供了一条从 Excel 平滑过渡的路径。系统内置 Excel 批量导入功能，支持 .xlsx 和 .xls 格式，可以将现有的商品数据直接迁移到系统中，不需要手动逐条录入。
第一步：下载导入模板
闪仓 PC 端在库存管理页面提供了"导入 Excel"按钮。点击后会打开导入对话框，其中包含模板下载链接。也可以通过 API 直接获取：
GET /goods/import/template
模板是一个标准的 .xlsx 文件，包含 27 个列头，每个列头对应一个商品字段。模板中不包含"总价值"和"创建时间"这两列——总价值由系统根据单价和数量自动计算，创建时间在导入时自动填充。
第二步：理解字段映射
以下是 Excel 列头与系统字段的完整对应关系：
| Excel 列头 | 系统字段 | 是否必填 | 说明 |
|---|---|---|---|
| 商品编号 | goodsId | 否 | 留空则系统自动生成 UUID |
| 商品名称 | goodsName | 是 | 唯一的必填字段 |
| 简称 | briefName | 否 | 商品简称 |
| 品牌 | brand | 否 | 品牌名 |
| 型号 | model | 否 | 产品型号 |
| 规格 | specifications | 否 | 规格描述 |
| 数量 | amount | 否 | 库存数量 |
| 单价 | price | 否 | 单位价格 |
| 存放位置 | storageLocation | 否 | 仓位编号 |
| 产地 | placeOfProduction | 否 | 生产地 |
| 一级分类 | firstLevelClassification | 否 | 大类 |
| 二级分类 | secondLevelClassification | 否 | 中类 |
| 三级分类 | thirdLevelClassification | 否 | 小类 |
| 重量/长/宽/高 | weight/length/width/height | 否 | 物理尺寸 |
| 保质期 | qualityGuaranteePeriod | 否 | 适用于食品等 |
| 参考成本 | referenceCost | 否 | 采购参考价 |
| 采购周期 | purchasingCycle | 否 | 补货周期 |
| 拼音码 | pinyinCode | 否 | 快速检索用 |
| 备注 | remarks | 否 | 自由文本 |
关键规则：商品名称是唯一的必填字段。如果某一行的商品名称为空，该行会被标记为错误并跳过，不影响其他行的导入。
第三步：准备你的 Excel 数据
如果你已经有一份 Excel 库存表，最高效的做法是：
- 下载闪仓提供的导入模板
- 将现有表格中的数据按列头对应关系复制到模板中
- 确保文件保存为 .xlsx 格式，编码为 UTF-8
关于商品编号：如果你的商品已经有编号体系（比如条形码、SKU 编码），填入"商品编号"列即可。如果没有，留空让系统自动生成。不要使用含有特殊字符的编号。
常见问题与排查
重复 ID 处理：导入时系统会根据"商品编号 + 仓库"判断是否重复。导入对话框提供两种策略：
- 跳过（默认）：遇到已存在的商品编号直接跳过，不修改现有数据
- 覆盖：用 Excel 中的数据更新已存在的记录
导入完成后，系统会返回详细的统计结果：新增 N 条、更新 N 条、跳过 N 条、失败 N 条。每一条失败记录都会标注行号和失败原因。
编码问题：如果你的 Excel 文件是从其他系统导出的，可能存在编码不一致的情况。最常见的表现是中文变成乱码。解决方法：用 Excel 或 WPS 打开文件，另存为 .xlsx 格式（而非 .csv 或 .xls）。闪仓使用 EasyExcel 解析引擎，对 .xlsx 格式的兼容性最好。
数字格式：单价和数量字段需要是纯数字。如果 Excel 中的数字带有货币符号（如 "￥12.50"）或千分位分隔符（如 "1,000"），需要在导入前清理为纯数字格式。
空行问题：Excel 文件中间的空行会被跳过，但如果商品名称列有空格（看起来不为空但实际只有空格字符），系统会尝试解析并可能产生意外结果。建议导入前用 Excel 的"查找替换"功能清除多余空格。
两周并行过渡方案
完全切换系统是有风险的，我们建议采用两周并行运行的方式：
第 1 周：将现有 Excel 数据导入闪仓 WMS，但继续使用 Excel 作为主要记录。每天结束时对比两边的数据是否一致。这一周的目标是验证数据准确性，熟悉系统操作。
第 2 周：以闪仓 WMS 作为主要记录，Excel 作为备份。所有出入库操作在系统中完成，每天导出一份 Excel 存档。闪仓 PC 端的"导出 Excel"功能会按仓库生成多个 Sheet，格式与导入模板一致。
第 3 周起：完全使用闪仓 WMS，不再维护 Excel。如果需要数据备份，可以定期使用导出功能。
关于切换的顾虑
切换系统确实存在学习成本。坦率地说，任何新工具都需要适应期。但闪仓的设计目标之一就是降低这个门槛：
- Excel 导入/导出功能意味着你的数据不会被锁定在系统中，随时可以导出
- PC 端 + 移动端同步意味着仓库人员可以用手机扫码操作，不需要一直坐在电脑前
- 免费使用意味着你可以充分试用，确认满足需求后再正式切换
数据迁移不是一个全有或全无的决定。从导入第一批商品数据开始，一步一步来。
