# 预订货(需求 6.5)- 前端联调方案 ## 涉及页面 - 营销管理 → 预订货(`erp/presale/index`,菜单 `预订货`,组件名 `ErpPresale`) - 预订货页内页签:**预定任务**(默认)、**历史下单任务** - 预订货流程中打开的 ERP 采购订单详情(只读跳转,用于核对生成的采购订单) ## 业务流程与数据带入 1. 客户预定 → 预定任务:客户(CRM 客户)、商品(MDM 物料)、数量、交货日期、备注。任务编号 `YD+yyyyMMdd+3位流水` 由后端生成,前端不填。 2. 预定任务 → 向供货商下单弹窗:任务编号、客户名称、商品名称、剩余可下单数量全部从当前行带入且只读;采购员只填供货商、本次下单数量、单价、备注。 3. 向供货商下单 → ERP 采购订单:后端自动创建一张采购订单(来源类型=预定任务、来源单号=任务编号、来源 ID=任务 ID),并把采购订单号回写到预定供货订单(`XDCG+yyyyMMdd+3位流水`)。 4. 采购订单 → 采购入库 → 交付客户:走既有采购/仓储链路,预订货页不参与库存。 ## API | 方法 | 路径 | 说明 | |------|------|------| | GET | /erp/presale-task/page | 预定任务分页(权限 `erp:presale-task:query`) | | POST | /erp/presale-task/create | 新增预定任务(`erp:presale-task:create`) | | PUT | /erp/presale-task/update | 修改预定任务(`erp:presale-task:update`) | | DELETE | /erp/presale-task/delete?id= | 删除预定任务(`erp:presale-task:delete`) | | GET | /erp/presale-task/get?id= | 预定任务详情(`erp:presale-task:query`) | | PUT | /erp/presale-task/finish?id= | 备货完成(`erp:presale-task:update`) | | PUT | /erp/presale-task/cancel?id= | 取消预定任务(`erp:presale-task:update`) | | POST | /erp/presale-task/create-supplier-order | 向供货商下单(`erp:presale-task:update`) | | GET | /erp/presale-order/page | 预定供货订单分页(`erp:presale-order:query`) | **预定任务分页请求参数:** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | pageNo / pageSize | Integer | 是 | 分页 | | code | String | 否 | 任务编号,模糊 | | customerId | Long | 否 | 客户编号 | | itemId | Long | 否 | 商品(物料)编号 | | status | Integer | 否 | 1 待备货 / 2 备货中 / 3 已完成 / 4 已取消 | | deliveryDate | LocalDate[] | 否 | 交货日期区间(`xxxx-xx-xx,xxxx-xx-xx`) | | createTime | LocalDateTime[] | 否 | 创建时间区间 | **预定任务保存参数(create/update):** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | id | Long | 修改时必填 | 编号 | | customerId | Long | 是 | 客户编号(CRM 客户下拉) | | itemId | Long | 是 | 商品编号(MDM 物料下拉) | | quantity | BigDecimal | 是 | 预定数量,必须 > 0,最多 3 位小数 | | deliveryDate | LocalDate | 否 | 交货日期 | | remark | String | 否 | 备注 | **预定任务响应字段:** | 字段 | 类型 | 说明 | |------|------|------| | id / code | Long / String | 编号 / 任务编号 | | customerId / customerName | Long / String | 客户编号 / 名称(后端解析) | | itemId / itemCode / itemName | Long / String | 商品编号 / 编码 / 名称(后端解析) | | quantity | BigDecimal | 预定数量 | | purchaseQuantity | BigDecimal | 累计已向供货商下单数量 | | remainQuantity | BigDecimal | 剩余可下单数量 = 预定数量 − 已下单数量 | | deliveryDate | LocalDate | 交货日期 | | status | Integer | 1 待备货 / 2 备货中 / 3 已完成 / 4 已取消 | | finishPercent | BigDecimal | 备货完成度百分比(已下单/预定,保留 2 位) | | remark / createTime | String / LocalDateTime | 备注 / 创建时间 | **向供货商下单参数(POST /erp/presale-task/create-supplier-order):** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | taskId | Long | 是 | 预定任务编号 | | supplierId | Long | 是 | 供货商编号(SRM 供应商下拉) | | quantity | BigDecimal | 是 | 本次下单数量,> 0 且 ≤ 剩余可下单数量 | | productPrice | BigDecimal | 否 | 单价 | | remark | String | 否 | 备注 | 响应为新建的采购订单 ID。 **预定供货订单分页请求参数:** `pageNo/pageSize/code/taskCode/taskId/supplierId/status(1 已下单/2 已取消)/orderDate(区间)`;响应字段:`id/code/taskId/taskCode/supplierId/supplierName/itemId/itemCode/itemName/quantity/productPrice/purchaseOrderId/purchaseOrderNo/orderDate/status/remark/createTime`。 ## 字段展示规则 | 字段 | 展示位置 | 说明 | |------|----------|------| | 任务编号 code | 列表、详情 | 后端生成,不可编辑 | | 客户名称 | 列表、详情、下单弹窗(只读带入) | 后端按客户 ID 解析,前端不展示裸 ID | | 商品编码/名称 | 列表、详情、下单弹窗(只读带入) | 后端按物料 ID 解析 | | 预定数量 / 已下单数量 / 剩余可下单数量 | 列表、下单弹窗 | 剩余数量 = 预定 − 已下单 | | 状态 | 列表 | 字典 `erp_presale_task_status` | | 备货完成度 | 列表 | 百分比,可按进度条展示 | ## 业务规则说明 | 场景 | 规则 | |------|------| | 可下单状态 | 只有 1 待备货、2 备货中也允许下单;3 已完成/4 已取消下单会被拒并提示当前状态 | | 下单数量 | 必须 > 0 且不超剩余可下单数量;超量时提示剩余可下单数量 | | 商品单位 | 生成的采购订单行使用 MDM 物料的计量单位;物料无单位时直接拒绝下单并提示先维护单位 | | 状态流转 | 首次下单后任务自动置为 2 备货中;备货完成只能从 1/2 手工置 3;取消只能从 1/2 置 4 | | 唯一性 | 任务编号、预定供货单号由后端按天独立流水生成,前端无需处理 | ## 注意事项 - 下单弹窗里的任务编号、客户、商品、剩余数量必须从列表行带入并禁用编辑,避免前端再次手填造成与任务不一致。 - 采购订单创建失败(如单位缺失、供应商不存在)时整个下单动作回滚,前端只需展示后端返回的精确提示(含具体供应商/商品名称与数值),不要替换成笼统文案。 - 「历史下单任务」页签查询的是预定供货订单分页接口,筛选条件与任务页签不同,切换页签时要重置查询表单。 - 供应商下拉使用 SRM 供应商精简列表接口;客户下拉使用 CRM 客户选择组件。