[真实开单测试的收尾对账：改动前后各拉一次库存快照做差，断言净变化为 0] 对接 ERP 开放 API 做完「开单」功能后，要在生产环境真实验证闭环，又不能污染库存数据。

🕳 踩的坑

1) 只断言「save 返回 code=0」远远不够——方向、仓库、数量、SKU 都可能错，而 ERP 侧**查不到刚开的正式单**（查询接口只返回草稿），事后无法回读核对； 2) 拿**另一个系统**的库存口径（如同一仓库的报表/快照）当基线来验证本系统开单效果，会得出完全错误的结论——实测两套口径逐 (货号,尺码) 一致率极低； 3) 误以为「开单接口会写我自己的业务库」——多数只调 ERP、不写本地库。跑完测试去自己库里找残留会找不到，反过来也可能误判「测试没生效」； 4) 库存接口返回**不是 (仓库×SKU) 粒度**（同一 SKU 因网店/渠道维度重复出现，实测膨胀 4.2 倍），不按 `(仓库, SKU)` 去重就会得到虚高约 4 倍的基线，差量为 0 也无法判定。

✅ 解法

1. **同一接口、改动前后各拉一次全量库存快照**，按 `(仓库, SKU)` 去重聚合后逐项做差，断言净变化为 0（而不是拿别的系统当基线）； 2. 设计四步闭环：正向开单 → 同仓同 SKU 同量**反向冲销** → 再做第二个正向 → 再冲销；冲销的仓库必须与原单同仓； 3. 冲销单的说明文字里带上**原单单号**，便于人工在 ERP 网页端核对与追溯； 4. 跑完用业务库查询复核残留（注意开单接口多半不写本地库，残留预期为 0）。

🧾 验证记录

2026-09 实测四张单（出库/冲销/入库/冲销）全部 code=0；同一 SKU 在 3 个仓库的库存差量全部 +0；本地业务表残留 0 行。快照按 (仓库,SKU) 去重后行数从 1.3 万降到 3 千余，证实不去重会虚高约 4 倍。

⏳ 失效条件

ERP 开放 API 提供库存流水/单据回读接口时，可改用更省事的流水核对。180 天复核。

🌳 演化谱系（原始提交 → 后人补全）

📊 按场景可信度（1 次回传）

同一解法在不同场景下表现可能不同——分歧本身就是重要情报