扫码作业

扫码是操作台的核心入口。一台扫码枪 + 一个输入框，覆盖盘点、查询、出入库、退货、运单出库共六种作业模式。系统自动匹配 SKU、扣减/增加库存，并支持声音反馈和标签打印。

六种作业模式

底部模式栏切换，每种模式对应一种库存操作：

扫码方式

方式一：扫码枪（推荐）

USB 或蓝牙扫码枪模拟键盘输入。无需先点输入框——在页面任意位置扫枪，系统自动检测快速连续输入（字符间隔 < 50ms + 回车结尾），自动填入并提交。

人工打字速度远慢于 50ms 间隔，不会误判。可在模式栏关闭自动识别（详见下方「作业反馈」）。

方式二：手动输入

点击输入框，打字或粘贴条码，按 Enter 提交。

输入格式

系统支持三种输入格式，可组合使用：

基础格式（单组）：

SKU              ← 数量默认为 1
SKU,数量         ← 如 NX-002,5

多组输入（分号分隔，一次扫入多组）：

NX-002,5;E2E-001,2;ABC-100

→ 生成 3 张卡片，顺序与输入一致。

作业反馈

模式栏右侧有三个快捷按钮：

重复扫码提示：同一商品/运单扫第二遍时，已有卡片会闪烁高亮。正常重复闪主题色，已出库/缺货等错误情形闪琥珀色。

苹果手机不支持震动 API，声音是主要反馈通道，建议保持开启。

打印标签

扫到商品后，卡片上会出现 🖨 按钮（电脑端 hover 显示，手机端常显）。点击后打开该商品的二维码标签 PDF，可直接打印贴纸。

标签内容为商品 SKU 的二维码，扫码枪扫描即可回到该商品。

运单出库（两段式）

切换到 📦 运单模式，扫描快递面单上的单号：

1. 扫码查询：系统自动查出该单应发的全部 SKU 清单
2. 人工核对：确认卡片上的 SKU 和数量无误
3. 确认出库：点「✓ 核对无误」→「📤 确认出库」

出库为原子事务：一次性扣减所有 SKU 库存并标记该运单为已出库。重复扫码会提示「已出库，请勿重复操作」。

代发订单（紫色标记）仅展示，不再扣库存——因为代发下单时已扣。

运单/退货编辑（换 SKU、加行）

遇到「SKU 没货要发相似品」或「客户退错货要补发/实退商品与单据不符」时，不用回后台改数据，扫码卡片上直接改：

1. 运单卡片点「✏️ 编辑」（退货核验卡点「✏️ 编辑明细」）
2. 每行可「换SKU」（搜索选择替代品），底部可「+ 新增行」（选 SKU + 数量）
3. 确认页展示改前 → 改后对比（替换黄底、新增绿底），确认后一次性落库

• 已出库的运单、已完成的退货单不可编辑
• 每次编辑都会留存快照变更记录：点卡片上的「📜 历史」看该单的改前改后；模式栏「📜 变更记录」可检索全部编辑历史（含操作人、时间、备注；快照保留 180 天）
• 缺货池中的运单编辑后自动恢复为待出库

扫到没记录的单号？直接新建：运单没提前导入、或客户退货查不到原单时，错误卡上会出现「➕ 新建运单 / ➕ 新建退货单」——点开后只需逐个「+ 新增行」选 SKU 填数量（退货还可选客户、选状况），确认后单号就建好了：运单可直接核对出库，退货单可移入暂存池走审核/完成流程。新建同样留快照（改前为空，全部显示为绿色新增）。

批量出库

运单模式扫入较多订单后（≥30 单时推荐），点击「📊 批量模式」进入批量出库弹窗：

• 按拣货 / 出库 / 缺货三个标签页分组
• 按快递公司分组拣货
• 系统校验库存，充足的订单一次性出库

缺货拦截

出库时如果库存不足，系统会拦截并提示缺口。你可以：

• 将缺货运单移入缺货池，待补货后自动唤醒处理
• 缺货运单标红显示，不可出库

补货（入库或盘盈）后，系统自动尝试唤醒缺货池中的订单按 FIFO 出库。

退货

切换到 ↩️ 退货模式，处理客户退货：

1. 扫原出库运单号 / 退回单号：顶部扫码框扫一个运单号，系统会自动反查原单。
   • 命中 online_shipments 后显示「🏷️ 原单号：xxx」和「📋 一键填入预期商品」。
   • 反查结果带客户时会自动选中客户；不带客户时需手动从下拉框选择。
2. 扫退回的商品 SKU：继续用同一个扫码框扫退回的商品条码，系统自动加入退货列表。
3. 调整数量和状况：每张退货卡片可改数量，并选择「完好 / 破损 / 过期 / 损坏」。
   • 完好 → 退仓（restock），完成后库存增加。
   • 破损 / 过期 / 损坏 → 报废（scrap），不增加库存。
4. 提交：点击「确认提交」生成草稿退货单，再去「业务 → 退货」tab。
   • 线上退件（需等实物）：先点击「审核」标记确认，等实物到货验收后点击「完成退货」正式入库。
   • 现场退货（当场完成）：直接点击「完成退货」一步入库。

如果客户下拉框为空，说明当前租户还没有创建客户，请先到「业务 → 客户」页面创建。

多设备同步

同一账号在多台电脑/扫码枪上同时扫码，记录会实时同步。仓库可以多人同时作业，数据自动合并。

同步基于服务端 scan_sessions 集合 + Realtime 订阅，离线时降级为本地缓存，联网后自动合并。

一键清空

扫错或需要重新开始时，点击「🗑 清空记录」可一键移除所有扫码记录。清空前会二次确认，防止误操作。