5.3 KiB
海外采购简化流程
2026-10-27 按客户确认的需求收敛采购主流程，适用于海外采购回国内、国内采购发往海外两个方向。
| 主状态 | 编码 | 操作 |
|---|---|---|
| 待审核 | PENDING_REVIEW |
客户创建采购单，平台审核并确定采购仓 |
| 收货中 | RECEIVING |
平台分批登记数量和照片 |
| 待客户确认 | WAIT_CUSTOMER_CONFIRM |
平台结束本次采购收货，提交客户确认 |
| 已确认 | CONFIRMED |
客户确认实际收货结果，可创建出库批次 |
| 运输中 | IN_TRANSIT |
平台从采购单创建出库批次，填写数量和物流跟踪号 |
| 派送中 | DELIVERING |
平台更新批次派送状态 |
| 签收完成 | COMPLETED |
全部采购库存已出完，且所有出库批次已签收 |
拒绝、取消等异常结果独立展示，不增加正常流程节点。采购方向只影响起运仓候选与方向展示，不再增加国内、海外两套作业步骤。
收货批次保存实际数量和绑定本采购单的附件。采购完成后冻结收货结果，客户确认前不得出库。平台不得代客户调用确认接口；客户身份从统一认证上下文取得，不接受请求指定其他客户。
出库按批次保存数量、物流跟踪号、派送和签收资料。创建批次时预留可用数量，避免多个批次超出采购库存；签收完成时才扣减该批采购库存。签收请求原键重放不得再次扣减。存在剩余库存时仍可继续创建批次，不能因前一批签收而提前结束整单。采购库存属于采购台账，不写普通尾程 WMS 库存。
主单版本、客户隔离、附件归属与幂等键由服务端复核。失败不能留下部分批次或库存变动；同幂等键不同载荷必须拒绝，过期版本须刷新后重新操作。
费用明细使用其他海外业务共用的费用窗口和费用来源，采购默认选择余额支付。每次创建出库批次前，本采购主单必须至少有一项未作废应收费用，且全部未作废应收费用均须有效并审核通过；缺少费用、待审核或驳回时提示并阻止出库，前后端共同校验。应付与已作废费用不能替代应收费用明细；原出库成功请求的幂等重放不重新创建批次。余额冻结、审核实扣、失败重试和扣款回执沿用海外人工费用链；审核通过与扣款成功分别展示，创建费用或发出资金指令不能显示为已扣款。采购履约不以旧的预算核验、装箱、面单或两段运费冻结作为门禁。
客户端保留独立下单、列表和详情路由。详情集中展示商品及收件信息、收货批次、出库批次和费用，待客户确认状态提供确认动作。平台列表突出主状态及数量，详情承载审核、收货、提交确认、出库和费用操作；不重复展示旧节点表单。
验收范围
2026-10-27 旧采购模型已与新流程彻底分离：只保留主单、审核流水、采购附件和三张批次表。旧购买、装箱、面单、两段运输及采购专属资金接口退役，详情不再查询旧表；费用统一沿用共用海外费用审核链。21 张旧采购表清理范围与脚本。代码验证与数据库执行分开记录，必须先部署分离版本再执行精确删表脚本。
- 创建采购单后为待审核，审核后直接收货中。
- 两次收货分别保留数量与附件；提交确认后不能追加收货，客户确认前不能创建出库。
- 客户只能确认自己的采购单；内部备注与内部资料不进入客户投影。
- 分两批出库；超量、并发、过期版本和异载荷重放被拒绝。
- 批次派送后上传文件或图片签收，库存仅扣一次；未完成批次与剩余库存阻止整单提前完成。
- 费用默认余额支付，费用归属本单客户，余额结果以资金回执为准。
- 无费用、仅作废费用、仅应付费用或任一应收尚未审核通过时，不能创建出库；全部有效应收审核通过后允许出库。
自动测试、本地类型检查、真实 HTTP 与页面验收分别记录。现有 procurement-sample-fulfillment.mjs 验证旧两段样品链，不能作为本流程验收通过的依据。
2026-10-27 本地验证记录
- 平台端定向检查104项通过，客户端定向检查28项通过；两端 TypeScript 检查通过。
- 后端七状态、审核、权限、OpenAPI、结构中文备注40项去重定向检查通过；共用费用服务44项、采购费用来源4项、客户详情投影7项、费用真实Mapper持久化11项通过。
- 流程测试使用隔离内存数据库和真实MyBatis Mapper，覆盖两次收货、客户确认、两批出库、派送及签收扣减，以及超量、并发、重试、版本与文件归属。
- Gateway路由合同5项通过，Mapper扫描通过。本轮影响文件差异格式检查通过。
- 指引索引检查已尝试，因工作区缺少
D:/project/docs/业务快速索引.md无法执行完成；不代表业务测试失败，也不计为检查通过。 - 未执行环境SQL、部署、真实HTTP或页面截图验收。结构脚本为
deploy/sql/overseas-procurement-workflow.sql（后端仓库路径），发布需同时包含Lastleg、Admin和Client。余额冻结及实扣仍须在发布后核对Finance实际回执。