主题
生产退料
提示
当前移动端代码里的真实工作空间名称已经是 生产退料。它不是仓库审核确认台，而是一个围绕 新建退料单、退料历史、退料详情 展开的移动端退料申请与记录查看模块。
页面定位
移动端 生产退料 主要给车间、现场人员或仓库协同人员在手机上完成两件事：
- 为某张订单发起一笔退料申请；
- 查看已经提交过的退料记录和审核结果。
它更适合这些场景：
- 订单生产结束后，还有剩余物料需要退回；
- 领错料、领多料，需要现场先登记退料；
- 外出或在现场时，快速确认某张退料单是否已通过或被驳回。
它不适合替代：
- PC 端集中审核退料申请；
- 仓库端正式确认回收、做库存后续处理；
- 带复杂统计、查询、追溯的退料管理后台。
功能入口
打开掌上 ERP → 进入 生产退料 工作空间
当前工作空间的真实菜单结构如下：
- 模块权限：对应权限
| 菜单 | 当前状态 | 作用 |
|---|---|---|
| 新建退料单 | 可见菜单 | 选择订单、填写各物料退料数量并提交申请 |
| 退料历史 | 可见菜单 | 查看自己提交过的退料记录 |
| 退料详情 | 隐藏页 | 查看单张退料单的状态和物料明细 |
这张图要帮你先看懂：当前移动端退料模块主线是“发起申请 → 查看历史 → 查看详情”，不是在手机上直接完成审核或仓库确认。
建议你先看哪里
如果你是第一次使用这个模块，建议按这个顺序理解：
- 先看 新建退料单，理解移动端到底能提交什么；
- 再看 退料历史，理解提交后在手机上能跟踪到什么；
- 最后看 退料详情，理解审核状态和明细能展示到什么粒度。
页面整体结构
1）新建退料单
这是当前移动端退料工作空间里最核心的页面。它的重点不是“审核退料”，而是发起退料申请。
页面主要分成五块：
关联订单区
页面最上方先选 关联订单。
- 点击后会打开订单选择弹窗；
- 当前显示的是订单标签，没有选时显示
请选择； - 只有先选中订单，系统才会继续加载这张订单的可退物料。
顶部提示区
当前页面不是在列表上方固定放两条提示，而是在已经加载出可退物料后，于列表下方显示一条蓝色提示：
只显示该订单已出库且未退回的物料，退回数量不能超过可退数量
这说明当前页面不是任意选料页，而是只允许在这张订单已有可退余额的物料里填写退料数量。
物料搜索区
在物料列表前，页面带有一个搜索框：
- 占位文案：
搜索物料名称 / 规格； - 作用是从当前订单的可退物料中快速筛出目标物料；
- 它不是跨订单搜索，也不是历史记录搜索。
可退物料列表区
中间主体是 可退料物料 列表。
每条物料至少会显示：
| 内容 | 说明 |
|---|---|
| 物料名称 | 物料名称 |
| 规格 | 规格 |
| 可退数量 | 可退数量 |
| 单价 | 单价，无值时显示为空 |
| 数量步进器 | 填写本次要退多少 |
这里最关键的是：
- 页面只会显示 可退数量大于 0 的物料；
- 退料数量不能超过这条物料当前的可退数量；
- 数量可以填
0，表示本次不退这条物料。
空状态区
这个页面有两类真实空状态：
还没选订单
页面会提示：
请先选择关联订单
选了订单，但没有可退物料
页面会提示：
该订单没有可退回的物料
底部提交区
页面底部有固定主按钮：
提交退料申请- 如果已经填了数量，会显示
提交退料申请（共X件）
这张图要帮你理解：移动端退料的核心任务，是把“哪张订单、哪些物料、各退多少”表达清楚。
2）退料历史
这个页面用于看已经提交过的退料记录。它当前是一个简单分页历史列表，不是复杂筛选页。
页面结构比较直接：
列表区
每张卡片会展示：
| 信息 | 说明 |
|---|---|
| 退料单号 | 退料单号 |
| 状态标签 | 当前退料状态 |
| 关联订单 | 订单编号 |
| 提交时间 | 提交时间 |
列表交互
- 支持下拉刷新；
- 支持滚动加载更多；
- 底部结束文案：
没有更多了； - 点击整张卡片进入退料详情。
空状态
当没有任何记录时，页面显示：
暂无退料记录
当前没有哪些功能
本轮核对到的真实前端里，退料历史页没有看到：
- 关键词搜索；
- 状态筛选；
- 订单筛选；
- 批量操作；
- 审核按钮。
因此教程里不应该把它写成“移动端退料审核页”或“可筛选的退料查询后台”。
3）退料详情（隐藏页）
这是一个隐藏的嵌套页，不会直接出现在底部菜单里，一般从 退料历史 点击进入。
页面当前是只读详情页，主要看两块：
基本信息区
显示字段包括：
| 信息 | 说明 |
|---|---|
| 退料单号 | 当前单据编号 |
| 状态 | 当前退料状态 |
| 关联订单 | 订单编号 |
| 提交时间 | 提交时间 |
| 驳回原因 | 驳回原因，有值时才显示 |
退料明细区
显示字段包括：
| 信息 | 说明 |
|---|---|
| 类别 + 物料名 | 分类 #物料名 |
| 规格 | 规格 |
| 退料数量 | 申请数量与单位 |
| 单价 | 单价，有值时才显示 |
如果没有明细，页面会显示：暂无物料明细
单据不存在时
如果没有找到这张退料单，页面显示：
未找到退料单信息
详情页当前不做什么
当前移动端退料详情页没有这些操作按钮：
- 审核通过；
- 驳回；
- 删除；
- 编辑；
- 仓库确认回收。
所以它更像“记录查看页”，不是“退料处理页”或“审核页”。
页面里的真实流程
场景一：现场发起一张退料申请
- 进入
生产退料→新建退料单； - 先选择关联订单；
- 系统自动加载这张订单的可退物料；
- 搜索并找到要退的物料；
- 给每条物料填写本次退料数量；
- 点击
提交退料申请； - 提交成功后提示退料单号，并跳回
退料历史。
场景二：查看自己提交过的退料记录
- 进入
生产退料→退料历史； - 下拉刷新历史记录；
- 找到目标退料单；
- 点击卡片进入
退料详情。
场景三：查看某张退料单审核结果
- 从
退料历史进入退料详情； - 查看当前状态标签；
- 如果被驳回，查看是否出现驳回原因；
- 查看退料明细；
- 如需实际审核或仓库处理动作，转到 PC 端对应退料管理页面继续处理。
这张图要帮你理解：当前移动端退料模块闭环到“申请与查看”为止，审核与仓库确认动作不在这个页面里完成。
关键规则
1）真实菜单名称是“生产退料”
当前移动端工作空间名称已经是：生产退料。
2）什么时候可以提交退料申请
提交按钮可用的真实条件是：
- 已选择订单；
- 且至少有一条物料的退料数量大于 0。
也就是说，只选订单不行；列表里所有物料都保持 0 也不行。
3）只能退这张订单当前还有可退余额的物料
当前前端会把接口返回的物料先过滤成 可退数量大于 0，再展示到页面上。
这表示：
- 不是所有领过的物料都一定还能退；
- 页面只让你对“当前还有可退数量”的物料发起退料。
4）退料数量不能超过可退数量
每条物料右侧的步进器已经限制：
- 最小值：
0 - 最大值：当前物料的可退数量
前端在数量变更时还会再次做一次上限截断。
5）当前移动端没有填写退料原因 / 备注的输入框
旧理解里很容易把退料申请写成“填写数量与原因后提交”，但当前移动端页面并没有退料原因或备注输入框。
所以正式教程不应把“填写退料原因”写成当前页面标准步骤。
6）退料历史里的真实状态
当前前端已枚举的状态只有这 3 种：
| 状态码 | 文案 |
|---|---|
| 待审核 | |
| 已通过 | |
| 已驳回 |
7）提交成功后会提示单号并自动回到历史页
提交成功后，页面会提示：
退料申请已提交，单号：xxx
然后自动跳转到 退料历史。
常见问题
为什么我一进页面看不到物料列表？
先排查两件事：
- 你是否已经选择了关联订单；
- 这张订单当前是否存在可退数量大于 0 的物料。
如果没选订单，页面会提示“请先选择关联订单”；如果选了订单但没有可退物料，会提示“该订单没有可退回的物料”。
为什么提交按钮点不了？
通常是因为下面两个条件没有同时满足：
- 已经选择了关联订单；
- 至少有一条物料的退料数量大于 0。
为什么我不能把数量调得比“可退”更多？
因为当前移动端前端已经限制每条物料的最大退料数量就是当前的 可退数量，超出的数量不会允许提交。
为什么详情里只能看，不能直接审核？
因为当前移动端退料详情页定位就是只读查看页，审核通过、驳回、仓库确认回收等动作没有接到这个页面上。
为什么手机上看到的是“生产退料”？
因为当前真实移动端工作空间名称就是 生产退料。
使用建议与最佳实践
- 先确认关联订单再填数量，避免把退料记到错误订单上。
- 看到“该订单没有可退回的物料”时，优先理解为当前没有可退余额，而不是页面故障。
- 提交前先把每条物料数量核对清楚，尤其注意不要超过页面显示的可退数量。
- 提交成功后立即到
退料历史看一眼，确认单号和状态是否已经生成。 - 如果需要审批、驳回处理或仓库正式确认，应转到 PC 端退料管理页面，不要预期在移动端详情页完成这些动作。
相关页面
- 移动端 - 先理解移动端工作空间和隐藏页结构
- 订单管理 - 查看退料申请关联的订单入口与上游场景
- 仓库管理 / 退料申请 - 查看 PC 端退料管理与处理规则