闪仓条码扫描出入库完整教程：从商品建档到零售收银全流程

为什么条码扫描对仓库管理至关重要

在传统仓库管理中，手动录入商品信息是出错率最高的环节之一。一个 13 位的 EAN 条码手动输入一次的平均错误率约为 1/300，而条码扫描的错误率低于百万分之一。闪仓WMS在PC端、移动端和CLI工具三个终端全面支持条码扫描，将扫码能力贯穿到入库、出库、零售收银和盘点的每一个环节。

本文将按照实际操作顺序，逐步介绍从商品条码建档到完成扫码出入库的完整流程。

第一步：为商品设置条码编号

在闪仓中，商品编号（goods_id）就是条码编号。系统没有独立的条码字段，而是直接用商品编号作为条码标识。对于零售商品，建议直接使用商品包装上的 EAN-13 或 EAN-8 条码作为商品编号。

PC端操作路径：

1. 登录PC管理端，进入左侧导航栏 仓库管理 > 库存管理
2. 点击右上角 新增商品 按钮
3. 在 商品编号 字段中输入条码号码（如 6901234567890）
4. 填写商品名称、单价、库存数量等信息
5. 点击 保存 完成建档

移动端操作路径：

1. 打开闪仓移动端，进入 仓库管理 > 库存管理
2. 点击右上角 "+" 按钮
3. 在新增商品表单中，将条码号码填入商品编号字段
4. 保存即可

关键原则： 商品编号 = 条码编号。只要商品编号与实物条码一致，后续所有扫码操作都能自动匹配。

第二步：生成和打印条码标签

商品建档完成后，可以在PC端和移动端生成 CODE128 格式的条码图片。

PC端打印条码：

1. 进入 仓库管理 > 库存管理
2. 在商品列表中，点击目标商品操作列的 条码 按钮
3. 系统弹出条码预览对话框，展示该商品编号对应的条码图形
4. 点击 打印 即可输出到打印机
5. 批量打印：勾选多个商品，点击列表上方的 批量打印条码 按钮，可选择条码或二维码格式

移动端保存条码图片：

1. 进入库存管理页面，点击某个商品查看详情
2. 选择 生成条码 功能，系统跳转到条码页面（pages_warehouse/warehouse/barcode）
3. 页面自动以 CODE128 格式渲染商品编号对应的条码
4. 点击 保存到相册 按钮，条码图片保存到手机相册，可通过蓝牙标签打印机打印

第三步：移动端扫码入库

创建采购入库单或其他入库单时，可以用手机摄像头扫码快速添加商品。

操作路径： 首页 > 采购管理 > 新建采购入库单

1. 填写基本信息：选择仓库、经手人
2. 在商品信息区域，点击 扫码添加 按钮（带扫码图标）
3. 系统调起手机摄像头，支持扫描条码（barCode）和二维码（qrCode）两种格式
4. 扫描成功后，系统自动调用 /goods/query 接口，以扫描结果作为 goods_id 查询商品信息
5. 如果商品存在，自动填充商品名称、单价等字段，并打开商品编辑弹窗
6. 确认数量后，商品添加到入库单的商品列表中
7. 继续扫描下一件商品，或点击 提交单据 完成入库单创建

二维码扫描的额外能力： 如果扫描的是闪仓生成的二维码，二维码内容为 JSON 格式（包含 goodsId、goodsName、amount、price 字段），系统会自动解析并填充全部字段，无需手动补充。

第四步：移动端扫码出库

库存管理页面内置了专用的 扫码出库 功能，适用于快速发货场景。

操作路径： 首页 > 仓库管理 > 库存管理 > 点击 扫码出库 按钮

1. 在弹出的扫码出库面板中，先 选择出库仓库
2. 点击扫码按钮调起摄像头，或直接在输入框中手动输入商品编码
3. 扫描商品条码后，系统调用 /goods/find/goodsInfo/{userId}/{goodsId} 接口查询商品信息
4. 查询成功后，商品自动添加到出库清单，默认数量为 1
5. 重复扫描同一商品，数量自动 +1（不会重复添加），但不超过库存上限
6. 清单中可以手动调整数量（+/- 按钮），也可以删除商品
7. 确认后点击 确认出库，系统自动生成一张"其他出库单"（other_output 类型），单据编号格式为 SM + 年月日时分秒

后端处理： 确认出库时，前端向 /bill_of_document/create/other_output 发送 POST 请求，包含完整的商品列表和仓库信息。单据创建后，库存自动扣减。

第五步：PC端零售POS收银

PC端提供专用的零售收银页面，支持扫码枪和手动输入两种方式。

操作路径： 左侧导航栏 > 零售出单（ShopPage）

页面布局： 左侧为购物车（已扫描商品列表），右侧为商品库浏览区。顶部显示当天营业额和订单数。

扫码收银流程：

1. 首先在顶部下拉框中 选择经办员工
2. 将光标聚焦到扫码输入框（带扫码图标的输入框）
3. 使用 USB 扫码枪扫描商品条码，或手动输入商品编号后按回车
4. 系统自动调用 GetGoodsInfoByGoodsIdAndBindingUserId 接口查询商品
5. 查询成功后，商品添加到左侧购物车，数量默认为 1
6. 再次扫描同一商品，数量自动累加（无需重复添加）
7. 可以点击编辑按钮修改数量，或删除商品
8. 确认无误后，点击 结算 按钮

结算逻辑： 系统按仓库分组商品，为每个仓库分别生成一张其他出库单。单据编号格式为 XD + 年月日时分秒 + 序号，备注自动标注"由零售扫码生成"。

第六步：通过MCP工具实现AI驱动的条码操作

闪仓CLI工具 fwh 提供了 MCP（Model Context Protocol）服务器，可以被 Claude Code、Cursor 等AI编辑器调用。与条码相关的核心MCP工具有：

goods_search_barcode -- 条码查询工具

功能：根据条码搜索商品
参数：barcode（完整的零售条码）
返回：商品完整信息，或 not_found

该工具内部调用 /goods/query 接口，以 goods_id 精确匹配条码。与 goods_get 的区别在于：goods_search_barcode 是"是否存在"的探测性查询，未找到时返回 not_found；goods_get 是"已知存在，获取详情"的确定性查询。

pos_sell -- 零售出单工具

功能：一键完成零售出库（扫码 → 查商品 → 生成出库单）
参数：
  warehouse_id: 仓库ID
  transactor: 收银员姓名
  items: [{barcode: "6901234567890", quantity: 2}, ...]

该工具内部执行以下流程：

1. 遍历购物车中的每一项，调用 GoodsGet 查询商品名称和单价
2. 组装出库单商品列表
3. 自动生成单据编号（格式 POS-20260604-143025）
4. 调用 /bill_of_document/create/other_output 创建其他出库单

实际使用示例： 在 Claude Code 中，你可以直接对AI说"扫描条码 6901234567890，从主仓库出库 3 件"，AI会自动调用 goods_search_barcode 确认商品存在，然后调用 pos_sell 完成出库。

数据流总结

无论通过哪个终端操作，条码扫描出入库的核心数据流一致：

条码扫描/输入
    |
    v
goods_id 查询（/goods/query 或 /goods/find/goodsInfo）
    |
    v
获取商品信息（名称、单价、库存）
    |
    v
组装单据商品列表
    |
    v
创建出入库单据（/bill_of_document/create/...）
    |
    v
库存自动增减

这套流程确保了从扫码到库存变动的完整可追溯性。每一次扫码操作都会生成对应的单据记录，可在单据管理中查询审核。

闪仓WMS的条码扫描功能覆盖了仓库管理的全场景。从移动端的摄像头扫码到PC端的扫码枪收银，再到AI工具的自动化批量操作，三端协同让出入库操作的效率和准确率显著提升。