采购入库状态回写 - 前端联调方案
涉及页面
- 采购申请列表页
- 采购申请详情页
- 采购订单列表页
- 采购订单详情页
业务流程与数据带入
采购申请审批通过 → 生成采购订单(已审核) → 确认收货 → 生成到货通知单(待入库) → 执行入库
↓ ↓ ↓
order_id/order_no request_item_id 关联 in_status 回写
状态回写流程：
1. 入库单完成 → 回写采购订单明细入库数量（in_count）
2. 入库单完成 → 回写采购订单入库状态（in_status）
3. 入库单完成 → 回写采购申请明细入库数量（in_count）
4. 入库单完成 → 回写采购申请入库状态（in_status）
字段变更
采购申请新增字段
| 字段 |
类型 |
说明 |
| inStatus |
Integer |
入库状态（0:未入库 1:部分入库 2:全部入库） |
采购申请明细新增字段
| 字段 |
类型 |
说明 |
| inCount |
BigDecimal |
入库数量 |
采购订单明细新增字段
| 字段 |
类型 |
说明 |
| requestItemId |
Long |
采购申请明细编号（系统自动关联） |
响应字段变更
采购申请详情响应新增
{
"inStatus": 0
}
采购申请明细响应新增
{
"items": [
{
"inCount": 0
}
]
}
采购订单详情响应新增
无变化（requestItemId 为系统内部关联，前端无需展示）
字段展示规则
| 字段 |
展示位置 |
说明 |
| 入库状态 |
采购申请列表、详情 |
使用标签展示：未入库/部分入库/全部入库 |
| 入库数量 |
采购申请明细表格 |
数值展示，保留6位小数 |
业务规则说明
| 场景 |
规则 |
| 采购申请入库状态 |
根据采购订单入库状态自动更新，无需手动操作 |
| 采购申请明细入库数量 |
根据采购订单明细入库数量累加更新 |
| 多次入库 |
支持部分入库，入库状态自动流转 |
入库状态枚举
| 值 |
名称 |
颜色建议 |
| 0 |
未入库 |
info（灰色） |
| 1 |
部分入库 |
warning（橙色） |
| 2 |
全部入库 |
success（绿色） |
注意事项
- 入库状态由系统自动回写，无需手动维护
- 一个采购申请对应一个采购订单，入库状态同步
- 如果采购申请未指定供应商，审批通过后需要手动选择供应商生成订单
