feat: 安全回写档口入库码并支持核验恢复 (#234)

2026-08-15 09:10:10 +08:00
parent 15ebda23e3
commit 2778eed29f
11 changed files with 782 additions and 4 deletions
@@ -410,6 +410,23 @@ SKU（平均每商品 1.17 个），**查无此 SKU 是常态**，不是异常
 `[建议]` 登录后**只调 `/am/user/get` 验证会话**，其余几个是网页自己的初始化请求，
 Go 侧不用跟着调。

+### 7.1 档口入库码写入（工单 #234）
+
+档口入库码最终写入货运明细的 `innerExpCode`（页面名称“快递单号”）。两个写接口来自
+现有 Python 流程和线上响应样本：
+
+```text
+GET /am/stock/detail/deleteInnerCode?detailId={detailID}
+GET /am/stock/detail/updateDetailCode?t=0&id={stockID}&detailId={detailID}&code={innerCode}
+```
+
+- 旧值为空时不调用删除；旧值非空时，只有删除明确成功才发送写入。
+- 删除和写入请求都只允许发送一次，不使用自动重试。超时、5xx、响应读取失败或成功响应
+  无法解析时，结果可能已经在远端生效，必须标为“需核对”。
+- 每条写入前重新调用 `listByStock`，核对 stock/detail、规格、采购平台、采购单号和规划时
+  的旧值；写入后再次读取，只有 `innerExpCode` 与目标一致才标为已回写。
+- “重新核对”只调用 `listByStock`，绝不能再次调用上述两个写接口。
+
 ---

 ## 8. 实现时的固定约束