# 采购入库触发付款提醒(需求 5.2①)- 前端联调方案 ## 涉及页面 - 仓储管理 → 采购入库 → 采购入库单(完成后端行为变化,页面无需新增字段) - 系统管理 → 我的站内信 / 消息中心(新增消息类型,展示付款提醒) - 财务 → 付款单(用户收到提醒后在此按来票补录付款单) ## 业务流程与数据带入 1. 采购入库单执行「完成」→ 库存增加、回写 ERP 采购订单已入库数量与入库状态(原有逻辑)。 2. 同一事务完成后(业务事务之外、失败不影响入库),后端向以下人员发送站内信: - 采购入库单创建人(若其 creator 不是合法用户编号则跳过并记日志) - 管理员(用户编号 1) 3. 站内信内容带入:入库单号、对应采购订单号、采购订单金额;收件人点击后到「付款单」页面按来票补录付款单。 4. 为什么系统不自动建付款单:ERP 付款单必须关联来票(发票)且需上传附件,入库时通常尚未取票,自动建单会产生无效单据,因此以提醒方式交由财务处理。 ## API 本次没有新增或修改前端调用的接口,只新增了一条服务端行为与一个消息模板: | 类型 | 标识 | 说明 | |------|------|------| | 站内信模板 | `purchase_receipt_payment_remind` | 名称「采购入库付款提醒」,类型 1(系统通知),参数 `receiptCode,purchaseOrderCode,totalPrice` | | 模板内容 | — | 「采购入库单【{receiptCode}】已完成入库(对应采购订单【{purchaseOrderCode}】,订单金额 {totalPrice} 元),请按来票及时生成付款单。」 | 触发点:`POST /mes/wm/item-receipt/complete`(采购入库完成接口,原有接口)。 ## 字段展示规则 | 字段 | 展示位置 | 说明 | |------|----------|------| | 入库单号 receiptCode | 站内信正文 | 采购入库单编号 | | 采购订单号 purchaseOrderCode | 站内信正文 | 入库单关联的采购订单编号;取不到时显示 `-` | | 订单金额 totalPrice | 站内信正文 | 采购订单总金额,两位小数;取不到时显示 `-` | ## 业务规则说明 | 场景 | 规则 | |------|------| | 触发时机 | 采购入库单完成(status 变为已完成)后触发一次 | | 收件人 | 入库单创建人 + 管理员;同一人有重复时只发一次 | | 失败处理 | 站内信发送异常只记 warn 日志,不影响入库主流程与事务 | | 模板缺失 | 若数据库缺少该模板,发送会失败但同样不影响入库;需执行 `sql/mysql/cf_notify_template_payment_20261030.sql` 补模板 | | 自动建单 | 明确不自动创建付款单,付款单仍需财务按来票手工生成 | ## 注意事项 - 前端消息列表可能需要在过滤条件里补充该消息类型(模板类型为系统通知,按现有站内信页面即可展示)。 - 提醒只发一次(按完成动作触发),不要在前端轮询或重复调用完成接口,否则会重复提醒。 - 提示文案中不出现纯数字 ID,全部使用入库单号/采购订单号等业务编号。