主题
外协订单
页面定位
外协订单页是正式外协单据的管理页，负责承接已经生成的外协单，并在执行过程中维护价格、交期、凭证、进度等信息。
如果说“外协申请”解决的是哪些内容需要外协、准备交给谁做，那么“外协订单”解决的就是：
- 当前已经生成了哪些外协单
- 每张外协单对应哪张订单、哪家厂家
- 当前还在计划中、已经在途，还是已经完成
- 是否已经补齐交易凭证、交付日期、总价、备注等执行信息
- 是否允许继续修改、删除或导出单据
菜单路径
外协管理 → 外协订单
页面边界
外协订单页不是外协申请页，也不是基础资料配置页。它不负责创建外协申请，不负责维护外协类别或外协厂家，也不负责结算单创建；已结算外协单也不能继续修改或删除。
谁会用到这个页面
- 外协跟单人员：维护外协订单，推进下单与收货
- 管理人员：按订单、厂家、进度查看当前外协执行情况
- 财务或经营复盘人员：查看总价、交易凭证、完成时间，为后续结算做准备
建议你先看哪里
这张图是帮你先确定阅读路径：先认清订单来源，再理解列表字段，最后看编辑抽屉里的推进动作和限制。
订单来源与整体流程
外协订单有两种来源：
- 在外协申请页提交采购计划后自动生成
- 在当前页面手工新增
这张图想帮你看懂：外协订单通常承接前面的申请与采购计划，但页面本身也支持手工新增外协订单，所以它是正式单据管理页，而不是单纯浏览页。
查询区与列表
当前页面支持按以下条件查询：
| 查询条件 | 说明 |
|---|---|
| 订单编号 | 按来源订单号精确查找外协单 |
| 订单名称 | 按订单名称查找，后端会先匹配订单，再反查外协单 |
| 外协厂家 | 查看某家外协厂家当前有哪些外协单 |
| 外协进度 | 过滤计划、在途、完成中的某一类单据 |
列表里能看到什么
| 列名 | 说明 |
|---|---|
| 外协订单编号 | 系统里的外协单号 |
| 来自订单 | 这张外协单来自哪张订单；有订单详情权限时可点击跳转 |
| 订单名称 | 对应订单名称 |
| 外协厂家 | 当前安排给哪家外协厂家；自定义外协单显示为“自定义产品” |
| 交易凭证 | 已上传的图片凭证缩略图 |
| 交付日期 | 约定交期 |
| 总价 | 当前这张外协单金额 |
| 外协进度 | 当前主状态：计划、在途、完成 |
| 下单时间 | 何时进入执行阶段 |
| 完成时间 | 何时完成 |
| 备注 | 额外补充说明 |
| 操作 | 导出单据、编辑、删除 |
来自订单这一列要怎么理解
普通外协单和自定义外协单在“来自订单”这一列的表现不同：
- 普通外协单：如果有来源订单，除了能跳订单详情，还会在悬浮层中展示这张单据对应的外协清单明细
- 自定义外协单：如果有来源订单，只保留订单跳转，不展示标准板件清单悬浮层
也就是说，普通外协单更容易追溯到原始板件明细；自定义外协单则不依赖这套标准板件列表。
列表操作区能做什么
- 导出单据：导出当前这张外协单的 Excel 单据
- 编辑：打开抽屉继续维护订单信息
- 删除：删除当前外协订单
- 新增：手工新增一张外协订单
- 批量删除：勾选多条订单后一起删除
导出边界
当前页面没有“整页列表导出”按钮，只有每一行的“导出单据”。不要把它理解成按筛选条件批量导出清单。
如果只是跟进进度，优先看“外协进度、下单时间、完成时间”这三列；如果要核对业务内容，再进入编辑抽屉看详情。
外协进度怎么流转
从真实实现看，页面里主要使用 3 个进度状态：
这张图想帮你抓住当前页面最重要的状态主线：
- 计划：单据已经生成，但还没正式进入待收货 / 在途阶段
- 在途：前端文案叫“在途”，后端含义更接近"待收货"，含义更接近“待收货”
- 完成：已经收货，当前单据执行结束
进度字段该怎么理解
| 页面显示 | 后端状态 | 你可以怎么理解 |
|---|---|---|
| 计划 | 单据刚生成，或还在补录执行信息 | |
| 在途 | 已经下给外协厂家，等待结果返回 | |
| 完成 | 已完成收货，执行闭环结束 |
后端只允许状态向后流转，不允许倒退。因此不要把它理解成一个可以来回切换的普通下拉状态。
编辑抽屉：真正推进订单的地方
点击“编辑”后会打开外协订单抽屉。这个抽屉不是只改备注，而是当前页面最关键的操作区。
这张图是在解释：外协订单的推进动作，不是在列表上直接点状态，而是在编辑抽屉里完成保存、下单、收货。
抽屉里通用要填的内容
不论哪种外协单，抽屉里都会有这些通用字段：
| 字段 | 说明 |
|---|---|
| 外协订单类型 | 普通外协单 / 自定义外协单 |
| 交易凭证 | 上传图片凭证，最多 3 张，单张最大 20MB |
| 总价 | 当前外协单总金额 |
| 交付日期 | 约定的交期 |
| 备注 | 额外补充说明 |
保存、下单、收货分别代表什么
- 保存：保存当前填写的信息，不强制推进状态
- 下单：把当前单据推进为"在途"状态，前端显示为“在途”
- 收货：把当前单据推进为"完成"状态
按钮显示规则也很明确：
- 当前没有进度，或还在"计划"：显示“下单”
- 当前在"在途"：显示“收货”
- 当前已完成：不再显示下单 / 收货，只能保存已有信息
时间字段什么时候写入
后端会根据状态流转自动维护时间：
| 字段 | 触发时机 |
|---|---|
| 下单时间 | 从"计划"进入"在途"时自动写入 |
| 完成时间 | 第一次进入"完成"时自动写入 |
外协单完成后，如果有关联订单，系统还会触发该订单的齐套检测。
两种订单类型怎么区分
当前页面支持两类外协单：
1）普通外协单
普通外协单一般来自外协申请与采购计划，也就是有明确来源订单、明确板件明细的那类单据。
在抽屉里你通常会看到：
- 外协厂家
- 关联订单（编辑时只读显示）
- 采购列表（编辑时只读展示）
其中“采购列表”会展示这张单据对应的板件明细，比如房间名称、柜体名称、板件名称、编号、类型、基材、颜色、尺寸、厚度、封边信息、门开方向、门铰孔位置、备注等。
2）自定义外协单
自定义外协单更适合处理那些不是从标准板件列表直接带出的外协内容。
这类单据不会像普通外协单那样展示采购列表，而是通过“自定义外协列表”维护内容。
这张图帮助你区分两种建单思路：一种承接订单拆出来的标准外协内容，另一种承接非标准的自定义外协内容。
新增与编辑要注意什么
新增
点击页面右上角“新增”后，可以手工创建一张外协订单。新建时：
- 默认类型是普通外协单
- 可以切换为自定义外协单
- 外协单号由后端自动生成
- 普通外协单新增时需要选择外协厂家
- 自定义外协单新增时需要填写自定义外协列表
需要特别注意的是：当前新增抽屉里没有“选择来源订单”或“选择采购明细”的入口，所以手工新增更适合创建不依赖现成订单板件明细的外协单，尤其是自定义外协单。
编辑
编辑已有外协订单时，有几个关键限制：
- 订单类型不能再切换
- 普通外协单的外协厂家不能再修改
- 已结算外协单前端会进入只读模式
- 即使前端某些字段看起来还能输入，后端对已结算外协单也会整体拒绝修改
交易凭证与导出规则
交易凭证
交易凭证不是文字备注，而是图片凭证字段。当前实现支持：
- 上传图片
- 最多 3 张
- 单张最大 20MB
- 列表中显示缩略图
因此不要把它写成“只能上传一张凭证”或“支持任意文件类型附件”。
导出单据
点击行内“导出单据”后，会导出这张外协单的 Excel 文件。导出规则按订单类型区分：
- 普通外协单：导出标准外协清单模板，内容来自该单关联的采购明细
- 自定义外协单：导出自定义表格内容，列头由自定义数据动态生成
也就是说，自定义外协单不是没有单据可导，而是按自定义表格结构导出。
结算限制与删除规则
这张图帮助你看懂一个关键边界：已结算外协单不是“尽量少改”，而是后端明确禁止修改和删除。
已结算为什么不能改
如果某张外协订单已经关联结算单，当前系统会把它视为结算后的正式业务结果。此时：
- 前端会把关键字段置为只读
- 后端也会直接拦截修改请求
- 删除时也会校验是否已结算，已结算外协单不能删
批量删除时，只要待删记录里包含一张已结算外协单，整批删除都会失败。
常见场景
场景一：从外协申请推进到执行
- 在外协申请页完成采购计划提交
- 进入外协订单页查到新生成的单据
- 打开编辑抽屉补充交易凭证、交期、总价
- 点击“下单”，把进度推进到在途
- 加工完成后再点击“收货”，结束本张单据
场景二：手工补一张自定义外协单
- 点击“新增”
- 切换为“自定义外协单”
- 填写自定义外协列表
- 补充总价、交付日期、备注等信息
- 先保存，确认无误后再下单
场景三：按厂家查看当前还有多少单在做
- 进入外协订单页
- 用“外协厂家 + 外协进度”组合筛选
- 重点看状态为“在途”的记录
- 必要时打开编辑抽屉核对交期、凭证和备注
常见问题
1. 外协订单和外协申请是什么关系？
外协申请更偏前置整理与计划拆分，外协订单更偏执行跟进。通常是先有申请，再在申请页继续提交采购计划，之后生成外协订单。
2. 外协订单只能从外协申请生成吗？
不是。当前页面本身也支持手工新增外协订单，只是手工新增时没有选择来源订单和采购明细的入口，所以更适合补自定义类外协单。
3. 为什么有的记录在“来自订单”上能展开看明细，有的不能？
普通外协单来自标准订单与板件明细，所以可在悬浮层查看对应采购列表；自定义外协单不依赖这套标准板件来源，因此展示方式不同。
4. 为什么有时只能保存，不能看到“收货”按钮？
因为“收货”只有在单据已经处于"在途"时才会出现。还在"计划"阶段时，你只能先保存或下单。
5. 为什么编辑时有些字段改不了了？
可能有两类原因：
- 这张单本来就处于编辑限制内，比如普通外协单编辑时不能改订单类型和外协厂家
- 这张单已经关联结算单，系统会进入只读限制，后端也会拒绝修改
使用建议与最佳实践
- 先补齐执行信息，再点下单：尤其是交易凭证、交期、总价，别把“在途”单据留成半成品。
- 区分普通外协单和自定义外协单：能走标准来源的尽量走标准来源，后续追踪更清晰。
- 把“下单”和“收货”当成状态推进按钮：不要把它理解成普通保存，它会直接改变单据阶段。
- 进入结算前做一次集中核对：避免结算后再发现价格、凭证、备注不完整。
- 批量删除前先排除已结算单据：否则整批删除可能直接失败。