📦 仓库操作员手册

·角色概览

仓库是连接工厂与代理商的枢纽。仓库操作员需要完成两类核心任务：

• 入库：接收工厂发来的送货批次，扫码核对实际数量，登记差异。
• 出库：根据代理商订单，扫码拣选产品，调用顺丰 API 下单发货。

送货批次与出库记录状态

1登录与首页

1.1 登录

1. 选择"仓库"Tab在登录页顶部选择"仓库"标签页。
2. 输入账号密码输入管理员分配的仓库操作员账号。
3. 点击"登录"登录成功后跳转到仓库首页。

1.2 仓库首页

登录后进入仓库首页，展示三个核心统计数字和五个功能入口：

• 入库待办数：当前"运输中"状态的送货批次数
• 出库待办数：当前"待发货"状态的代理商订单数
• 总库存数：当前仓库总产品数

底部 5 个功能入口：

2入库流程

当工厂确认发货后，送货批次状态变为"运输中"，仓库会收到入库待办推送。

2.1 查看待入库送货批次

1. 点击"入库"从仓库首页点击"入库"入口。
2. 查看送货批次列表页面显示所有"运输中"和"已收货"的送货批次。
3. 点击批次卡片查看批次详情：包含型号、申报数量、备注等。
4. 点击"开始入库"创建入库记录，进入扫码页面。

2.1入库扫码

开始入库后进入扫码页面，需要逐一扫描送货批次中每个产品的质保编码，系统会自动核对数量和状态。

1. 按 PDA 扫码键对准产品外箱上的质保编码标签（工厂贴的），按下扫码键。
2. 系统校验扫码后系统会执行多重校验：
   • ✅ 产品状态必须为"生产完成"（即工厂已扫码录入）
   • ✅ 编码第 5 位轮位与产品登记轮位一致
   • ✅ 未超出本批次该型号申报数量
   • ✅ 未超出工单该型号需求数量
3. 扫码成功振动反馈，产品状态变为"在库"，统计数字 +1。
4. 继续扫码重复操作，直到所有产品扫码完成。

2.1.1 撤销扫码

如果扫错了产品，可以在扫码记录列表中点击对应记录的"撤销"按钮，将该产品从本次入库中移除（产品状态回到"生产完成"）。撤销后可重新扫码正确的产品。

2.2完成入库

所有产品扫码完成后，需要主动点击"完成入库"按钮结束本次入库流程。

1. 核对扫码统计在扫码页面查看按型号分组的扫码数量，确认与实际收货数量一致。
2. 点击"完成入库"底部按钮，弹出确认对话框。
3. 确认完成系统执行以下操作：
   • 自动计算实际入库数 vs 工厂申报数的差异
   • 送货批次状态变为"已收货"
   • 回写工单明细的 received_quantity
   • 若工单所有型号 received_quantity == quantity，工单自动转为"已完成"
   • 异步推送通知给管理员

2.2.1 入库复核（可选）

完成入库前，可点击"复核"按钮查看详细的扫码清单与差异对比，确保无误后再确认完成。

3出库流程

当代理商下单后，订单状态为"待发货"，仓库会收到出库待办推送。出库流程比入库复杂，包含扫码、地址核对、顺丰下单、确认发货 4 个步骤。

3.0 查看待出库订单

1. 点击"出库"从仓库首页点击"出库"入口。
2. 查看待发货订单列表显示所有"待发货"状态的代理商订单。
3. 点击订单卡片查看订单详情：代理商、收货地址、型号清单与数量。
4. 点击"开始出库"创建出库记录（状态：scanning），进入扫码页面。

3.1出库扫码

出库扫码阶段从仓库库存中拣选产品，扫入对应订单。注意：扫码阶段不会立即改变产品状态，仅记录扫码明细，确认发货时才批量更新为"已发货"。

1. 按 PDA 扫码键对准产品外箱上的质保编码标签扫码。
2. 系统校验：
   • ✅ 产品状态必须为"在库"（warehouse）
   • ✅ 产品型号必须在订单中
   • ✅ 该型号已扫数 < 订单需求量
3. 扫码成功振动反馈，记录到出库明细。
4. 逐个扫码直到扫够当某型号扫够订单需求量时，再扫会报错"已扫够数量"。

3.2地址核对

扫码完成后，进入地址核对页面，确认发件人和收件人地址信息。这些地址将用于顺丰下单。

1. 查看发件人地址系统自动填入默认的仓库发货地址（可在"设置 → 仓库发货地址"管理）。可下拉切换其他已配置的仓库地址。
2. 查看收件人地址系统自动填入代理商下单时的收货地址。可手动修改（如代理商临时要求改地址）。
3. 核对信息仔细核对姓名、电话、详细地址，确保无误。
4. 点击"下一步"进入顺丰下单页面。

3.3顺丰下单

系统通过顺丰 API 自动创建运单，生成运单号和面单图片。

1. 确认订单信息页面显示订单摘要：寄方、收方、物品、重量等。
2. 点击"确认下单"系统调用顺丰 API 创建运单。
3. 下单成功页面显示：
   • 顺丰运单号（如 SF1234567890）
   • 面单图片预览（可下载/打印）
   • 出库记录状态变为"已下单"
4. 打印面单点击"打印面单"按钮，调用外置蓝牙面单打印机打印。面单规格为 100mm 宽，PDA 内置 48mm 打印机不够宽，必须用外置打印机。

3.4确认发货

顺丰下单成功并打印面单后，需要点击"确认发货"完成整个出库流程。

1. 贴面单将打印好的顺丰面单贴在包裹外侧统一位置。
2. 点击"确认发货"系统执行最终操作：
   • 所有扫码产品状态变为"已发货"（shipped）
   • 创建 agent_products 绑定关系（产品归属转移给代理商）
   • 代理商订单状态变为"已发货"，写入物流公司（顺丰）和运单号
   • 出库记录状态变为"已完成"
   • 更新库存统计：在库数 -1、已售数 +1、前后轮库存 -1
   • 异步推送通知给管理员和代理商
3. 等待顺丰揽收顺丰快递员上门揽收包裹。

3.4.1 取消发货（可选）

如果在确认发货前需要取消，可以点击"取消发货"按钮：

• 系统先查询顺丰是否已揽收；
• 若已揽收，不允许取消（包裹已经在途）；
• 若未揽收，调用顺丰取消接口作废运单，清空扫码明细，订单回到"待发货"状态。

4库存查询

点击仓库首页"库存"入口，可查看实时库存。

4.1 库存列表

• 按型号分组显示，每个型号显示：总库存、前轮库存、后轮库存
• 库存按产品状态细分：
  • 在库 已入库未售（warehouse）
  • 生产完成 工厂已扫码未到仓（production_completed）
  • 已发货 已发货给代理商（shipped）

4.2 型号库存明细

点击型号卡片可查看该型号的详细库存，包含每个具体产品的质保编码、轮位、入库时间等。

5入出库记录

点击仓库首页"记录"入口，可查看历史入库和出库记录。

• 入库记录 Tab：显示所有历史入库批次，含送货批次号、工单号、入库时间、入库数量、差异。
• 出库记录 Tab：显示所有历史出库记录，含出库记录号、订单号、代理商、发货时间、运单号。
• 点击任一记录可查看详细明细。

6仓库发货地址管理

仓库发货地址用于顺丰下单的发件人信息，可在"设置 → 仓库发货地址"中管理。

6.1 新增地址

1. 进入地址管理设置 → 仓库发货地址。
2. 点击"新增地址"填写发件人信息：姓名、电话、省市区、详细地址。
3. 设置默认勾选"设为默认"将该地址作为顺丰下单时的默认发件人。
4. 保存地址保存后可在出库地址核对时选择。

6.2 编辑与删除

• 点击地址卡片可编辑信息。
• 地址列表中可删除不再使用的地址（已关联订单的地址不能删除）。

7设置与打印机

7.1 PDA 内置标签打印机

用于打印外箱标签（53mm × 40mm）。功能与工厂端一致：

• 测试打印验证打印机连接。
• 黑标校准更换标签纸后必须执行一次。

7.2 外置蓝牙面单打印机

用于打印顺丰面单（100mm 宽）。仓库出库发货必须配对外置蓝牙面单打印机：

1. 开启蓝牙确保 PDA 蓝牙已开启。
2. 扫描设备点击"扫描蓝牙设备"，等待发现面单打印机。
3. 配对点击打印机名称配对，按提示完成。
4. 设置 UUID部分打印机需要手动配置 Service UUID 和 Characteristic UUID（参考打印机说明书）。
5. 设置宽度面单打印机宽度建议设置为 576 像素（100mm 纸宽）。
6. 测试打印点击"测试打印"验证面单打印正常。

7.3 退出登录

点击底部"退出登录"按钮，系统会通知服务器吊销 Refresh Token，返回登录页面。

·完整业务流程图

入库流程

出库流程

·关键业务规则

入库规则

出库规则

库存维度

库存按型号 + 轮位双维度管理：

• total_in_stock：该型号总在库数
• total_in_stock_front：该型号前轮在库数
• total_in_stock_rear：该型号后轮在库数

入库时按轮位 +1，出库时按轮位 -1。

·常见错误处理

·常见问题 FAQ