系统概览
RPWMS(Return Processing Warehouse Management System)是一套专为海外仓退货处理设计的仓库管理系统。覆盖从退货收货、质检、维修、上架到出库销毁的完整链路。
整体业务流程
系统角色
| 角色 | 说明 | 可见菜单 |
|---|---|---|
| admin | 管理员 — 全部权限 | 所有页面 + 系统设置 + 财务 + 员工管理 |
| staff | 仓库员工 — 操作权限 | 仪表盘、入库、质检、维修、上架、库存、盘点 |
| repair | 维修技师 — 维修专用 | 维修管理(含工时计时) |
界面布局
仪表盘
仪表盘是登录后的首页,展示实时统计数据和最近入库记录。
统计卡片
领星WMS推送失败预警
如果有货物推送领星 WMS 失败(已重试5次),仪表盘顶部会出现红色预警横幅,展示失败明细。可逐条或批量重新推送。
同比环比对比
统计卡片下方显示与昨日/上周的入库数据对比趋势。
最近入库列表
展示最新入库记录,包含 ID、快递单号、SKU、仓库、状态等关键信息。可通过右上角按钮快速执行:
入库管理
入库管理是日常最常用的模块,负责记录所有退货的入库信息。
收货入库向导
点击 + 收货入库 打开分步向导:
LTL 批量入库
针对 LTL(零担货运)大批量到货场景,点击 LTL 批量入库 打开专用面板:
筛选与搜索
退货列表支持多维度筛选:
| 筛选项 | 说明 |
|---|---|
| 搜索框 | 按单号、SKU、托盘号模糊搜索 |
| 状态筛选 | 已收货 / 无主货 / 维修中 / 正品上架 / 维修品上架 / 待出库 / 已出库 / 已完成 / 已销毁 |
| 仓库筛选 | 按仓库过滤 |
| 日期范围 | 按入库时间段筛选 |
批量操作
勾选多条记录后,顶部出现批量操作栏:
照片重拍标记(v3.36 新增)
退货列表中,若某件退货有客户发起的照片重拍请求,状态栏旁会显示 📷 重拍 徽章,操作列优先显示重拍按钮。点击即可打开重拍弹窗,查看客户要求并上传新照片。
分页与导出
列表底部提供分页控制(50/100/300/500条/页)和 导出 Excel 按钮,导出当前筛选条件下的所有数据(含嵌入照片)。
状态流转
已收货
质检中
正品上架
维修中
维修品上架
已销毁
不良品上架 🆕
质检
质检模块负责处理由客户(货主)发起的质检工单。仓库操作端不能主动发起质检,质检必须由货主在客户门户(portal.html)中对到货货品点击「开启质检」来发起。
质检队列
列表显示客户已发起质检的退货记录。状态筛选支持:
| 筛选 | 说明 |
|---|---|
| 待质检(客户发起) | 客户已请求质检,等待仓库操作员处理 |
| 质检中 | 质检工作台已打开,正在检查中 |
质检操作流程
质检结论
| 结论 | 后续动作 |
|---|---|
| ✅ 正品上架 | 货品直接进入上架流程,分配库位 |
| 🔧 需要维修 | 自动创建维修工单,转入维修队列 |
| ❌ 无法维修 | 标记为不可修复,等待货主决策(销毁或退回) |
| 🗑 销毁处理 | 不可用,直接进入销毁队列 |
维修管理
维修管理模块管理所有维修工单,支持工时计时、进度追踪、费用记录。
维修工单列表
展示所有维修任务,包含快递单号、SKU、问题/诊断描述、费用、进度、状态、工时。
顶部功能栏提供:
状态筛选:全部 / 待处理 / 维修中 / 已完成
批量更新 — 勾选多条后一次性更新状态
导出 Excel — 导出维修工单数据
维修操作
工时计时器
维修页面顶部有黄色横幅显示当前计时状态。屏幕右下角浮动计时器可随时暂停/恢复/停止,工时数据自动记入财务系统用于计费。
上架任务
上架模块负责将质检通过或维修完成的货品分配库位,正式入库存储。
筛选类型
| 筛选 | 说明 |
|---|---|
| 全部 | 显示所有上架相关记录 |
| 待上架(正品) | 质检通过的正品,等待分配库位 |
| 待上架(维修品) | 维修完成的货品,等待分配库位 |
| 已上架正品 | 已分配库位的正品 |
| 已上架维修品 | 已分配库位的维修品 |
上架操作
换SKU上架(v3.35)
当货品收货时扫描的SKU与实际需要入库的SKU不同时,可在上架环节更换SKU:
| 入口 | 说明 |
|---|---|
| 客户门户(决策时) | 货主在做「正品上架」决策时可输入目标上架SKU,系统自动带入上架弹窗 |
| 运营后台(上架时) | 操作员在上架弹窗中直接修改上架SKU |
更换后系统会保留原始SKU(original_sku)用于审计追溯,同时在列表中显示「原SKU→新SKU」标记。
不良品上架(v3.36 新增)
新增「不良品上架」类型,适用于有缺陷但仍可出售的商品。货主在 Portal 决策为「不良品上架」后,运营端上架流程与正品一致,但:
| 区别 | 正品上架 | 不良品上架 |
|---|---|---|
| 状态 | shelved_good | shelved_defective |
| XLWMS 库区 | 普通库区 | NOT-GOOD 库区 |
| SKU 字段 | 优先 shelve_sku | 优先 shelve_sku |
库存管理
库存管理提供三种视图查看在库货品,并支持库位管理。
三种视图
| 视图 | 说明 |
|---|---|
| 列表视图 | 逐条展示所有在库货品,含库位、运单号、SKU、货主、外观、重量、尺寸、状态、上架时间 |
| SKU汇总 | 按 SKU 分组统计:正品数量 / 维修品数量 / 待出库 / 总计 |
| 库位卡片 | 可视化库位网格,卡片颜色标识占用状态(绿色=正品,紫色=维修品,橙色=待出库) |
筛选条件
可按库位、SKU、状态(正品上架/维修品上架/待出库)、仓库进行组合筛选。
管理库位
点击 管理库位 可添加、编辑、删除库位,设置库位类型和容量。
配件上架
配件上架模块处理维修拆件后的配件入库。当一个母件被拆解后,产生的子配件需要独立上架管理。
配件统计
顶部显示待上架、已上架、总计三组统计数字。
操作流程
每条配件记录关联「来源母件」,可追溯原始退货单。
销毁管理
销毁管理模块跟踪所有标记为销毁的货品。
销毁统计
顶部四格统计卡片显示待销毁、已销毁、本月销毁数、总销毁金额。
销毁列表
展示每条记录的运单号、SKU、货主、仓库、入库时间、托盘号、销毁决策时间、照片、备注。支持搜索和分页。
今日销毁高亮(v3.36 新增)
当日执行销毁的件在列表中以黄色背景高亮显示,附带 今日 徽章,方便快速识别。顶部统计卡片新增「今日销毁」数字,同样以黄色突出。
库存盘点
库存盘点用于核实系统库存与实际库存是否一致。
盘点流程
入库预报管理
入库预报模块管理货主提交的 ASN(Advance Shipment Notice),追踪从发货到收货的全过程。
预报状态
运营端可查看所有货主的入库预报,按状态和关键词筛选,对每条预报进行确认收货、部分收货等操作。
批量收货
批量收货模块适合一次性处理大量快递包裹的场景。
数据报表
报表模块提供可视化数据分析,帮助管理者了解仓库运营状况。
报表维度
| 图表 | 说明 |
|---|---|
| 每日入库趋势 | 柱状图展示日期范围内每天的入库数量 |
| 状态分布 | 各状态的货品数量分布 |
| 外观损坏分布 | 新品/良好/一般/损坏/严重损坏的占比 |
| 快递公司分布 | UPS/FedEx/USPS 等各快递公司的退货量 |
| Top SKU | 退货量最高的 SKU 排名 |
| 各仓库退货量 | 按仓库统计退货数量 |
可按日期范围和仓库筛选,所有图表实时更新。
财务账单
财务模块包含四个子页签:费率配置、工时记录、费用明细、账单管理。
费率配置
费率配置又分三个子标签:
① 标准费率 — 设置全局默认费率和货主专属费率。费用类型包括:退件入库费、散货入库费、质检费(工时)、维修费(工时)、出库操作费、仓储费、拍照费、贴标费、开箱检测费、销毁费、封箱打包费、打托费、快递附加费、整柜卸货费等。
② 阶梯费率 — 按重量区间设置不同费率(按件/按公斤),优先级高于标准费率。支持 Excel 报价单批量导入。
③ 仓储阶梯 — 按客户+仓库+天数设置不同仓储费率(USD/CBM/天),免仓期内不计费。
工时记录
记录所有质检和维修的计时数据。按状态(计时中/已暂停/已完成)和日期筛选,展示操作员、有效工时、暂停次数。
费用明细
自动生成的所有费用条目。按货主、类型、是否已开票、日期筛选。支持手动录入额外费用。底部显示汇总金额。
账单管理
知识库
知识库包含四个子模块,帮助团队积累维修和质检经验。
SKU 知识库
按 SKU 分类存储产品信息,包括常见问题、维修方法、注意事项。支持搜索、新增、编辑、AI 翻译。
故障知识图谱
结构化记录故障模式:按 SKU 筛选,按严重程度(严重/主要/次要)分级,记录症状、原因、解决方案的关联关系。
作业指导书
为特定 SKU 编写标准操作流程(SOP),指导维修技师按步骤作业。
生成日志
记录 AI 自动生成知识条目的历史,追踪生成时间、SKU、类型、状态、数量。
仓库管理
管理系统中的仓库信息。仅 admin 角色可见。
员工管理
管理仓库操作人员。仅 admin 可见。
新增员工
点击「+ 新增员工」,填写用户名、密码、显示名、角色(staff/repair)、邮箱、分配仓库。
Excel 批量导入
点击「Excel导入」展开导入区域,下载模板填写后上传。模板列:用户名*、密码、显示名、角色、邮箱。
功能权限
每位员工可单独配置功能权限,控制可见的菜单模块。
货主管理
管理货主(客户)信息,仅 admin 可见。
| 字段 | 说明 |
|---|---|
| 货主编码 | 唯一标识,用于退货自动匹配 |
| 仓库 | 指定该货主的默认仓库 |
| 销毁天数 | 个性化保留期(0=使用全局默认) |
| OMS | 是否开启领星 OMS 对接 |
同样支持 Excel 批量导入。
系统设置
系统设置页面包含三个配置区域:
① 全局保留期设置
| 配置项 | 说明 |
|---|---|
| 默认保留天数 | 到期未处理的货品自动标记销毁 |
| 销毁前预警小时数 | 到期前 N 小时向货主发送通知 |
| 默认体积(CBM) | 未录入尺寸时的计费体积 |
| 体积重系数 | 体积重 = CBM × 系数(默认250) |
| 仓储免仓天数 | 入库后 N 天内免收仓储费 |
② AI 维修诊断配置
配置 AI 视觉诊断模型。支持供应商:智谱 GLM(推荐)、阿里通义千问、OpenAI GPT-4o、DeepSeek、Google Gemini。输入 API Key 后可测试连接。
③ 领星 OMS 对接配置
两种对接模式:
| 模式 | 说明 |
|---|---|
| OMS 模式(推荐) | 货主提供 oms.xlwms.com API Key,推送到货通知单 |
| WMS 模式 | 仓库直接开 omp.xlwms.com API 权限 |
配置好 App Key / App Secret 和默认仓库代码后,正品上架时自动推送领星系统。
操作日志
记录系统中所有关键操作,包括操作时间、用户、操作类型、目标对象、详情、IP 地址。支持按关键词搜索和日期范围筛选。
SKU 字典
OMS SKU 字典集中管理所有商品的 SKU 主数据,供系统自动匹配使用。
数据导入
支持直接导入领星 OMS 导出的 OMP_PRODUCT_*.xlsx 文件,系统自动识别列名。也可使用模板手动填写。
字段说明
| 字段 | 说明 |
|---|---|
| SKU | 商品唯一标识 |
| 产品名称 | 商品名称 |
| 货主 | 所属货主 |
| 仓库代码 | 默认仓库 |
| 尺寸 (L×W×H) | 用于计算体积重 |
| 重量 | 用于计费 |
| FNSKU | Amazon FBA 标识 |
质检模板
质检模板预定义特定 SKU 的质检流程,确保质检标准化和一致性。
模板结构
| 字段 | 说明 |
|---|---|
| 模板名称 | 如「iPhone 15 Pro 检测模板」 |
| SKU匹配 | 自动匹配的 SKU 列表 |
| 父模板 | 继承通用检测项 |
| 检验项数 | 包含的检验步骤数量 |
| 预估工时 | 预期质检时间 |
质检时若匹配到模板,工作台会自动加载对应的检验项目清单,引导质检员逐项检查。
📷 照片重拍(v3.36 新增)
照片重拍功能允许货主对入库照片不满意时请求仓库重新拍照,无需走质检流程。
工作流程
Ops 端操作
状态字段
| retake_status | 含义 |
|---|---|
| NULL | 无重拍请求 |
| requested | 货主已请求,等待仓库执行 |
| completed | 仓库已完成重拍 |
🔶 不良品上架(v3.36 新增)
不良品上架是新增的决策选项,允许将有缺陷但仍可销售的商品入库到独立的 NOT-GOOD 库区。
操作流程
🏷 换SKU贴标自动计费(v3.36 新增)
上架时如果修改了 SKU(换标),系统会自动检测 SKU 变更并生成 label_small 计费项,费用标准 $0.40/件。
触发条件
| 条件 | 结果 |
|---|---|
| 上架 SKU = 原 SKU | 不产生贴标费 |
| 上架 SKU ≠ 原 SKU | 自动生成 $0.40 贴标费,关联货主 |
🟡 销毁今日高亮(v3.36 新增)
销毁管理列表新增当日识别功能:
| 元素 | 说明 |
|---|---|
| 黄色行背景 | 当天执行销毁的记录自动以淡黄色背景高亮 |
| 今日 徽章 | 附在销毁时间旁边 |
| 「今日销毁」统计卡 | 顶部统计区新增黄色卡片显示当日销毁数量 |
| disposed_at 字段 | 数据库新增字段,记录销毁精确时间 |
⏳ 保留期倒计时(v3.36 新增)
退货列表和 Portal 待决策页面现在显示每件退货距销毁截止日的倒计时:
| 条件 | 显示 | 样式 |
|---|---|---|
| 已超过截止日 | ⚠ 已超期 | 红色 |
| 48 小时内到期 | ⏰ XX小时后销毁 | 黄色 |
| 7 天内到期 | ⏳ X天后到期 | 淡黄 |
| 7 天以上 | X天 | 灰色 |
🔍 SKU 异常检测与纠错(v3.37 新增)
系统现在会自动检测退货列表中的 SKU 字段是否被错误录入为运单号(如 FedEx/USPS/UPS 追踪号),并提供一键纠错功能。
异常自动标记
退货列表的 SKU 列会自动扫描每条记录,如果 SKU 值匹配已知运单号格式,会以醒目的红色标记显示:
| 显示样式 | 含义 | 操作 |
|---|---|---|
| 963200196020... USPS/FedEx? | SKU值疑似运单号,红色标签显示可能的承运商 | 点击即可编辑修正 |
| SKU-12345 ✏️ | 正常SKU,虚线下划线表示可编辑 | 点击可修改 |
支持检测的运单号格式包括:UPS(1Z开头)、Amazon(TBA开头)、UniUni/GoFo/SpeedX/CEVA/SwiftX 等小众承运商、USPS(92/93/94/95/420开头)、FedEx(96条码)、DHL(GM/LX开头)、LaserShip(1LS开头),以及超过18位的纯数字串。
快速纠错操作
📱 PDA 智能扫码优化(v3.37 新增)
PDA 收货页面的 SKU 输入进行了重大优化,解决了扫码枪输入和手动输入的冲突问题。
扫码枪 vs 手动输入智能识别
系统通过检测输入字符的时间间隔来自动区分扫码枪和手动键入:
| 输入方式 | 识别特征 | 系统行为 |
|---|---|---|
| 🔫 扫码枪 | 字符间隔 < 80ms(极快连续输入) | 250ms 后自动提交,无需手动确认 |
| ⌨️ 手动输入 | 字符间隔 > 80ms(正常打字速度) | 不自动提交,必须按回车键或点击「下一步」按钮 |
运单号误扫拦截
如果在 SKU 输入框中扫入或输入了运单号,系统会弹出确认提示:
确定要作为SKU使用吗?
操作员可以选择「取消」重新输入正确的 SKU,或在确实需要时选择「确定」继续。
界面提示
SKU 输入框下方现在显示操作提示:手动输入请按回车确认 | 扫码自动提交
三层防线体系
📦 FBA移除入库 — 模块概述
FBA移除入库模块专门处理亚马逊 FBA 仓库发起的 Removal Order(移除订单)。当亚马逊将库存退回到我们海外仓时,本模块提供从任务创建、货品收货、差异核对到结案计费的完整管理流程。
与普通退货的区别
| 对比项 | 普通退货 | FBA移除 |
|---|---|---|
| 来源 | 终端消费者退回 | 亚马逊FBA仓库批量退回 |
| 数量 | 单件为主 | 大批量,一个订单可含数百件 |
| 识别方式 | 运单号扫描 | LPN码 / FNSKU / 运单号 三重识别 |
| 计费模式 | 按件计费 | 按重量阶梯计费 + 开箱费 |
| 差异管理 | 无 | 预期数量 vs 实际到货,自动差异报告 |
核心概念
| 术语 | 说明 |
|---|---|
| Removal Order ID | 亚马逊移除订单号,格式如 REMO-1234567,同一订单可能分多个包裹到达 |
| LPN码 | License Plate Number,亚马逊贴在每件货品上的唯一条码,扫描即可识别商品 |
| FNSKU | 亚马逊的商品级条码,一个FNSKU对应一个SKU,但不区分单件 |
| Disposition | 亚马逊标记的退货类型:Sellable(可售)/ Unsellable(不可售)/ Damaged / Customer Damaged 等 |
| LPN码池 | 系统从Amazon报告中提取所有LPN码预存,PDA扫码时秒级匹配 |
| 任务池核销模式 | 先建任务(预期)→ 逐件收货核销 → 最终差异结算 |
FBA移除 — 业务流程
FBA移除 — 导入任务
Excel 导入(推荐)
order-id、sku、fnsku、disposition、shipped-quantity、carrier、tracking-number。可选列:asin、product-name、lpn。手动创建
点击 + 新建任务,填写移除订单号和客户,适用于少量或紧急情况。
FBA移除 — 后台任务管理
任务列表
进入侧边栏 📦 FBA移除 页面,默认显示所有FBA移除任务。
| 筛选项 | 说明 |
|---|---|
| 状态 | open(进行中)/ closed(已结案)/ billed(已计费) |
| 客户 | 按货主筛选 |
| 搜索 | 按移除订单号模糊搜索 |
任务详情
点击任务行打开详情弹窗,包含以下信息:
| 区域 | 内容 |
|---|---|
| 基本信息 | 移除订单号、客户名称、状态、创建时间 |
| 进度统计 | 预期数量 vs 已收数量 vs 已上架数量 vs 差异数量 |
| 商品明细(Lines) | 每个SKU的预期/实收/差异,亚马逊处置类型 |
| 包裹列表(Packages) | 所有运单号、承运商、到货状态、收货人 |
| LPN码池 | 所有LPN码及其状态(pending/received) |
| 品相统计 | 按商品状态(New/Good/Damaged/Defective等)分布 |
状态徽章说明
FBA移除 — PDA收货模式
PDA的「FBA移除收货」模式专为大批量FBA退货设计,支持极速盲收——仓库员工无需提前知道是哪个客户的货,扫码即自动匹配。
进入方式
三重扫码识别
扫码框支持三种条码类型,系统按优先级自动识别:
| 优先级 | 条码类型 | 匹配逻辑 | 精度 |
|---|---|---|---|
| 🥇 最优 | LPN码 | 直接命中码池中的唯一记录,秒级返回商品+客户+任务 | 精确到单件 |
| 🥈 次优 | FNSKU | 匹配FNSKU映射表,返回SKU和所有关联的open任务 | 精确到SKU |
| 🥉 兜底 | 运单号 | 匹配包裹表的tracking_number,返回对应任务 | 精确到包裹 |
收货操作步骤
扫码未识别时
如果扫码后系统无法匹配任何LPN/FNSKU/运单号,会提示「未找到匹配」。此时操作员可以:
FBA移除 — 结案与计费
差异报告
在任务详情中点击查看差异,系统自动计算:
| 指标 | 计算方式 |
|---|---|
| 预期总量 | Amazon报告中的 shipped-quantity 合计 |
| 实收总量 | PDA扫码确认收货的实际件数 |
| 差异 | 实收 − 预期(正数=多收,负数=少收) |
| Missing LPN | 码池中状态仍为 pending 的LPN数量 |
结案操作
计费规则
| 费用项 | 计算逻辑 |
|---|---|
| 操作费(按重量) | 每件按单件重量查 billing_rate_tiers 表匹配阶梯费率,累加所有件 |
| 开箱费 | 按包裹数 × 开箱单价 |
closed,计费完成后变为 billed。结案后不可撤销,请确保差异核对无误后再操作。FBA移除 — 常见问题
Q: 导入报告提示「重复的移除订单号」?
说明该 Removal Order ID 已存在且状态为 open。系统自动去重跳过。如果需要重新导入,请先结案或删除旧任务。
Q: PDA扫LPN码没反应?
可能原因:① 该LPN不在码池中(检查是否导入了正确的报告);② LPN已经被收货过(状态为received);③ 条码扫描不完整。
Q: 实际到货比报告多怎么办?
多收的货品仍可正常收货入库。结案时差异数量会显示为正数(多收),账单中会体现实际处理数量。
Q: 一个移除订单分多次到货怎么处理?
完全支持。每次包裹到达时正常收货,系统会持续累计已收数量。等所有包裹到齐后再结案。任务保持 open 状态直到手动结案。
Q: 客户自己能操作什么?
客户在货主门户可以:上传Amazon移除报告、查看任务进度和明细、确认Amazon已完成发货、查看差异报告和计费详情。→ 查看客户教程