处理退件业务（仓库端）
1. 操作场景
定义：退货单是仓库收到客户退回包裹后，用于记录清点结果、执行上架或销毁任务、并追踪处理进度的业务单据。
作用：仓库人员通过退货单完成从"收到包裹"到"处理完毕"的全部现场操作，包括拍照留底、AI 识别面单、逐 SKU 清点数量、按客户决策执行上架或销毁。
适用角色：仓库操作员、仓库管理员。
不适用场景：
- 客户认领包裹、下达上架/销毁决策，请在电脑端使用客户账号操作，参考
《处理退件业务（客户端）》。 - PDA 端的现场扫码清点和任务执行，参考
《PDA 客户端处理仓库现场作业》退件章节。
2. 操作指引
前提条件
- 账号具备
GWMS-退件-退货单菜单的操作权限。 - 仓库已收到退件包裹，且包裹上有可识别的快递面单（GWMS 的退货面单、符合客户列表获取的退货编码），未识别到则待认领。
- 系统中已存在对应的客户信息。
2.1 进入退货单页面
菜单路径：GWMS-退件-退货单
- 登录 GWMS 系统。
- 点击左侧
退件菜单，进入【退货单】列表页面。
页面包含两个页签：
- 退货单：管理退货单主单和清点明细。
- 仓库任务：查看和执行由客户决策生成的上架/销毁任务。
2.2 新增退货单
- 在【退货单】页签，点击【新增】按钮。
- 在弹出窗口中填写退货单信息：
- 上传面单照片：点击图片上传区域，选择包裹面单照片。系统支持最多 6 张照片。
- AI 识别：上传照片后，系统会自动识别运单号、承运商、客户、尺寸和重量信息。
- 仓库：选择收件仓库（必填）。
- 运单号：快递面单上的追踪号（必填，可由 AI 识别自动填入）。
- 客户：选择退货包裹所属客户（非必填，可由 AI 识别自动填入，可在认领后确定）。
- 包裹库位：包裹当前存放的库位（必填）。
- 承运商：快递公司（非必填，可由 AI 识别自动填入）。
- 尺寸/重量：支持公制（CM/KG）和英制（IN/LB）两种单位，修改一侧会自动换算另一侧。
- 如果运单号能匹配到出库单，系统会自动带出出库单的 SKU 明细，可直接作为清点明细导入。
- 点击【确定】生成退货单。
系统反馈：新增成功后，退货单出现在列表中，主状态为【处理中】，认领状态为【未/待认领】，清点状态为【未清点】。
2.3 清点退货明细
新增退货单后，需要逐 SKU 清点并录入系统。
- 在退货单列表中，点击目标单据的【详情】按钮。
- 在详情弹窗中，点击【新增明细】。
- 填写清点明细：
- SKU：扫码或搜索选择 SKU。
- 清点数量：该 SKU 的实际清点件数。
- 包裹库位：该 SKU 当前所在库位（默认包裹库位）。
- 照片：支持最多 3 张 SKU 照片（用于记录商品实物状态）。
- 尺寸/重量：该 SKU 的实测尺寸和重量。
- 备注：补充说明。
- 点击【保存】。可继续新增更多明细。
- 所有 SKU 清点完毕后，退货单的清点状态自动变为【已清点】。
2.4 认领退件包裹
当包裹面单上的客户信息不明确时，退货单的认领状态为【未认领】。仓库可通过编辑退货单协助客户认领。
2.5 查看与执行仓库任务
客户对清点完成的明细下达决策（指定上架数量和销毁数量）后，系统会自动生成仓库任务。
- 切换到【仓库任务】页签。
- 任务列表默认展示当前仓库下所有状态的任务。
- 筛选条件：
- 运单号：按包裹追踪号快速定位。
- 任务类型：上架 / 销毁。
- 任务状态：待执行 / 已完成 / 已取消。
- 当前库位、SKU、GSKU、客户：辅助筛选。
- 确认任务信息：
- 上架任务：显示推荐上架库位、SKU、待执行数量。
- 销毁任务：显示 SKU、待执行数量。
- 勾选要执行的任务，可修改执行数量和上架库位（上架任务）。
- 点击【确认完成】。
- 系统弹出确认窗口，确认后任务状态变为【已完成】。
支持部分完成：如果执行数量小于任务数量，系统会自动将剩余数量拆分为新的【待执行】任务。
取消任务：勾选待执行状态的任务后可以作废。作废的任务数量会退回给对应明细的待决策数量。
系统反馈：一张退货单下的所有任务都完成后，主单状态自动变为【已完结】。
2.6 批量完成退货单
如果退货单的处理已经全部完成，可手动批量完结：
- 在【退货单】页签，勾选主状态为【处理中】的单据。
- 点击【批量完成】。
- 确认后，所选单据主状态变为【已完结】，并触发计费。
2.7 作废退货单
对于不需要继续处理的退货单：
- 勾选目标单据。
- 点击【作废】按钮。
- 在弹出窗口中输入作废原因（必填）。
- 点击【确定】，主状态变为【已作废】。
2.8 导出退货单
- 在【退货单】页签，设置好筛选条件。
- 点击【导出】按钮，系统将按当前筛选条件导出 Excel 文件。
3. 补充说明
3.1 退货单的五个状态维度
一张退货单同时有五个维度的状态，分别反映不同阶段的处理进度：
| 状态维度 | 可选值 | 说明 |
|---|---|---|
| 主状态 | 处理中 / 已完结 / 已作废 | 单据整体生命周期 |
| 认领状态 | 未认领 / 已认领 | 包裹是否已被客户认领 |
| 清点状态 | 未清点 / 已清点 | 仓库是否已完成 SKU 清点 |
| 决策状态 | 未决策 / 部分决策 / 已决策 | 客户是否已对所有清点数量下达处理指令 |
| 执行状态 | 未执行 / 部分执行 / 已执行 | 仓库是否已执行完所有任务 |
主状态为【处理中】时，其余四个维度独立推进。四个子维度全部完成后，主状态自动变为【已完结】。
3.2 任务类型与执行规则
- 上架任务（RESTOCK）：将退货商品上架到指定库位，执行后系统自动增加该库位的库存数量。执行时必须填写上架库位和数量。
- 销毁任务（DESTROY）：将退货商品销毁处理，执行后不增加库存。执行时不需要填写库位。
任务由客户决策后自动生成，仓库端主要负责执行。仓库也可以代客户进行批量决策（使用【发起上架】或【发起销毁】按钮），将当前所有待决策数量统一转为上架或销毁任务。
3.3 数量流转规则
整个退货流程中的数量关系：
- 清点数量 = 待决策数量（初始）
- 决策上架数量 + 决策销毁数量 ≤ 清点数量
- 待决策数量 = 清点数量 - 已决策上架数量 - 已决策销毁数量
- 执行上架数量 ≤ 决策上架数量
- 执行销毁数量 ≤ 决策销毁数量
当一个明细的所有清点数量都已完成决策和执行，该明细的决策状态变为【已决策】、执行状态变为【已执行】。
3.4 计费时机
退货业务涉及的费用在以下节点触发：
- 退货收件/拍照/上架费/销毁费：任务执行完成后计费。
- 仓储费：退货单创建后开始按周期计费，直至主状态变为【已完结】或【已作废】。
具体费用金额以客户与仓库约定的业务报价为准，可在 GWMS-业务计费-业务流水 中查看明细。
4. 常见问题
Q1：为什么我清点完了，但没有生成任务？
A1：任务需要由客户下达决策后才能生成。客户进入系统对清点明细进行决策（指定上架数量和销毁数量）。仓库也可以代客户操作：勾选退货单，点击【发起上架】或【发起销毁】进行批量决策。
Q2：任务可以部分执行吗？
A2：可以。在【仓库任务】页签中修改执行数量为小于任务数量的值，提交后系统会自动将剩余数量拆分为新的待执行任务，不影响后续继续处理。
Q3：上架任务执行后，库存什么时候增加？
A3：任务确认完成的同时，系统会立即增加对应库位的 SKU 库存数量。可以在 GWMS-库存-库存管理 中按库位或 SKU 查询验证。
Q4：作废任务后，数量去了哪里？
A4：作废的任务数量会退回给对应明细的待决策数量，客户可以重新对这些数量下达决策。
Q5：退货单已完结，还能修改吗？
A5：已完结的退货单不允许再修改明细、执行任务或作废。如果确实需要调整，请联系管理员或实施人员处理。
Q6：照片上传后可以删除或替换吗？
A6：可以。在退货单详情弹窗中，点击已有照片的删除按钮即可移除。删除后可以重新上传新照片。主单照片和明细照片分别管理，互不影响。
Q7：客户认领后，可以切换认领的客户吗？
A6：在单据没有完结，且包裹没有已执行的任务情况下可以。如果过程中产生仓储费，会将仓储费退给原客户，重新对新客户计仓储费（从入库到认领时段）。