fix: 回写档口入库码时 t 固定为 0 (#278)

顺运宝把 t 绑成 Java Integer，毫秒时间戳溢出后 19 号回写全部失败。

Co-authored-by: Cursor <cursoragent@cursor.com>

admin/syb/client.go

@@ -795,8 +795,12 @@ func (c *Client) UpdateDetailCode(ctx context.Context, stockID, detailID int64,
 			return fmt.Errorf("code 不能包含控制字符")
 		}
 	}
+	// t 固定传 "0"。顺运宝把查询参数 t 绑成 Java Integer（上限 2147483647）。
+	// #250 改成当前毫秒时间戳后，19 号全部回写被拒：msg=Can not parse the
+	// parameter "1787108752485" to Integer value。不得改回 UnixMilli，也不得
+	// 改成 Unix 秒——秒目前能进 Integer，2038 年仍会溢出；#234 已用 t=0 通过参数绑定。
 	_, err := c.do(ctx, http.MethodPost, "/am/stock/detail/updateDetailCode", url.Values{
-		"t": {strconv.FormatInt(time.Now().UnixMilli(), 10)}, "id": {strconv.FormatInt(stockID, 10)},
+		"t": {"0"}, "id": {strconv.FormatInt(stockID, 10)},
 		"detailId": {strconv.FormatInt(detailID, 10)}, "code": {code},
 	}, nil)
 	return classifyInnerCodeWriteError(err)

admin/syb/client_test.go

@@ -582,7 +582,13 @@ func TestClient_InnerCodeWrite_单件码参数和路径正确且只发送一次(
 			}
 		case "/am/stock/detail/updateDetailCode":
 			query := r.URL.Query()
-			if r.Method != http.MethodPost || query.Get("t") == "" || query.Get("id") != "11" || query.Get("detailId") != "22" || query.Get("code") != targetCode {
+			if r.Method != http.MethodPost {
+				t.Errorf("update method=%s", r.Method)
+			}
+			if query.Get("t") != "0" {
+				t.Errorf("t 必须固定为 0 以适配顺运宝 Integer，实际 %q", query.Get("t"))
+			}
+			if query.Get("id") != "11" || query.Get("detailId") != "22" || query.Get("code") != targetCode {
 				t.Errorf("update query=%v", query)
 			}
 		default:

docs/admin/08-顺运宝接口.md

@@ -410,7 +410,7 @@ SKU（平均每商品 1.17 个），**查无此 SKU 是常态**，不是异常
 `[建议]` 登录后**只调 `/am/user/get` 验证会话**，其余几个是网页自己的初始化请求，
 Go 侧不用跟着调。
 
-### 7.1 档口入库码逐件写入（工单 #234、#250）
+### 7.1 档口入库码逐件写入（工单 #234、#250、#278）
 
 档口入库码最终写入货运明细的 `innerExpCode`（页面名称“快递单号”）。接口来自
 现有 Python 流程和 HAR 响应样本：
@@ -418,9 +418,15 @@ Go 侧不用跟着调。
 ```text
 GET /am/stock/detail/deleteInnerCode?detailId={detailID}
 POST /am/stock/detail/createDetail
-POST /am/stock/detail/updateDetailCode?t={当前毫秒时间戳}&id={stockID}&detailId={detailID}&code={单件innerCode}
+POST /am/stock/detail/updateDetailCode?t=0&id={stockID}&detailId={detailID}&code={单件innerCode}
 ```
 
+`[必须]` `t` 固定为 `0`。顺运宝把该参数绑成 Java `Integer`（上限 `2147483647`）。
+`#250` 改成当前毫秒时间戳后，2026-08-19 全部回写被拒：
+`Can not parse the parameter "1787108752485" to Integer value`。不得再传毫秒，
+也不得改成 Unix 秒——秒目前能进 Integer，2038 年仍会溢出。`#234` 的 `t=0`
+已通过参数绑定；`#250` 保留的 POST 方法不要改回 GET。
+
 `createDetail` 使用 JSON 请求体：`id=null`、稳定占位标题、`productSpec=null`、
 `productQty=1`、`productPrice=0`、`stockId`；成功响应的 `data` 是新 `detailId`。