项目

内容

需求目标

当备库需求减少时，系统按 SKU + 备货仓库匹配采购单，优先扣减未下单采购单，再扣减部分下单采购单的剩余未下单数量，并记录拦截日志。

目标用户

采购人员、备库单维护人员、客户订单同步接口调用方、采购管理审核与排查人员。

使用场景

客户订单产品数量减少、本地-FBA/海外仓-FBA 备库单最终发货数量减少、SKU 明细删除、备库单取消或作废后，需要同步减少采购单有效需求。

本期范围

备货拦截触发、采购单匹配、未下单数量扣减、采购单数量与状态更新、采购单日志、采购单/下单管理展示字段与搜索条件。

非本期范围

不自动取消 1688 订单；不回滚已生成的下单管理数据；不处理备库数量增加后的补采逻辑；不新增备库单与采购单明细来源快照展示。

成功标准

符合条件的减少事件能生成拦截结果；采购单总需求数、拦截数、未下单数量和状态按规则更新；采购单与下单管理页面可查看拦截数量；异常场景有日志和可追溯结果。

编号

验收项

前置条件

操作步骤

预期结果

异常校验

AC1

备库数量减少触发拦截

某 SKU + 仓库存在未下单采购单，备库数量从 100 改为 70

保存备库数量变更

系统生成减少数量 30 的拦截任务并扣减采购单未下单数量

减少数量为 0 时不触发

AC2

SKU 删除触发拦截

备库单有 SKU 数量 20

删除该 SKU 明细

系统按减少数量 20 触发拦截

删除失败不触发拦截

AC3

备库单取消或作废触发拦截

备库单内有多个 SKU

将备库单状态改为取消或作废

每个 SKU 按原数量减少到 0 生成拦截任务

单个 SKU 参数异常时记录失败，不影响其他 SKU 待确认

AC4

按 SKU + 仓库匹配

存在同 SKU 不同仓库采购单

触发某仓库 SKU 拦截

仅同 SKU + 同仓库采购单被扣减

不同仓库采购单不变

AC5

优先扣减未下单采购单

同 SKU + 仓库存在未下单和部分下单采购单

触发减少数量

先扣减未下单采购单，未下单不足后再扣部分下单剩余未下单数量

已完成采购单不扣减

AC6

生单时间倒序

同状态存在多张采购单

触发减少数量

最新生单时间采购单先扣减；时间相同时采购单号倒序

排序字段为空时记录待处理或使用确认规则

AC7

减少量小于等于可拦截量

可拦截数量 50，减少数量 30

触发拦截

成功拦截 30，剩余可拦截量减少 30

不产生无法拦截数量

AC8

减少量大于可拦截量

可拦截数量 20，减少数量 50

触发拦截

成功拦截 20，记录剩余 30 无法拦截

不扣减已下单数量

AC9

状态更新为已完成

扣减后总需求数=0 或总需求数=下单数

触发拦截并完成扣减

采购单状态变为已完成/正常完结

状态更新失败回滚扣减

AC10

采购单列表展示已拦截

采购单已有拦截累计数

打开采购单列表

列表显示【已拦截】字段，值等于累计拦截数

无拦截记录显示 0

AC11

拦截数量范围搜索

存在拦截数 0、5、10 的采购单

输入最小值 5、最大值 10 后查询

返回拦截数在 5 到 10 范围内的采购单

最大值小于最小值时提示错误且不查询

AC12

采购日志记录

采购单需求数从 100 变为 70

查看采购日志

操作类型为“需求变更”，备注包含“采购单需求数 由：100，变更为：70”

日志写入失败时扣减不生效

AC13

下单管理展示拦截数

下单记录关联有拦截数的采购单

打开下单列表和详情

列表展示【已拦截】，详情展示【拦截数】，数值与采购单一致

关联采购单异常时展示规则待确认

AC14

重复触发幂等

同一事件重复发送 2 次

连续调用拦截接口

只扣减一次，第二次返回已有处理结果

幂等键缺失时记录异常，不重复扣减