9 Commits

Author SHA1 Message Date
liufumingren
956793ba66 fix(print-data): 换打印参数前必须做模板校验,补上 RequestBatchNumber 批次号
WMS「韵达」面单换打印数据时平台抛空引用(未将对象引用设置到对象的实例)。实测对照
(同一账号、同一 fxdd 域名、真实面单)定位到根因:RequestBatchNumber 由
DateNow + DayPrintBatchNumber 拼成,取号流程会先调 CheckTemplateAvaliable 拿这两个值,
而换打印参数时传的是 checkData: {},批次号退化成 1/1/,平台解析时抛空引用
(偶尔表现成「成功」但 documents 为空、WaybillCode 为 null)。

- dgj.fetchPrintParams:先 checkTemplateAvailable 再把 check.Data 作为 checkData 提交;
  平台「成功」但没有任何 params 时按失败抛出,交给上层回退
- 去掉上一版尝试的 Orders[0][CaiNiaoAuthInfoId] 注入(实测加不加结果一样,不是根因)
- 保留 LoadPrintData 兜底(PrintHistory/LoadPrintData,按 printHistoryId 只读、不消耗面单):
  订单已离开待发货、或平台仍未返回打印数据时用它拿到当时打印的 params(可能过期,标 params_expired)
- 单测 dgjFetchPrintParams.test.js 3 例(必须带批次号 / 空数据按失败 / 带平台原因)
- 文档更正:不是域名或菜鸟授权网点问题,是批次号,并附实测对照表

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 22:35:37 +08:00
liufumingren
37de11c309 fix(print-data): 菜鸟系面单换打印参数空引用时回退按打印记录取
WMS「韵达」面单换打印数据时平台回「拉取打印参数失败:未将对象引用设置到对象的实例。」,
这是 ExpressPrint 复用路径上的平台内部空引用,多发生在菜鸟系面单(韵达/申通/中通…)。

- dgj.expressPrint:Orders[0] 补 CaiNiaoAuthInfoId(菜鸟面单按模板授权网点取打印数据,缺了平台会空引用)
- dgj.fetchPrintParams:支持传入 caiNiaoAuthInfoId 注入订单行;平台空引用时在错误里补一句排查提示
- waybillPrintData.fetchGroup:复用取号拉参数失败后回退
  POST /PrintHistory/LoadPrintData(按 printHistoryId 只读、不消耗面单),
  用 Data[].PrintDataJson 里的 contents[].params + templateURL 兜住,返回标 source=print_history;
  两条都失败才报错(带原原因)。成功路径仍优先 ExpressPrint(抖店签名要重新签发)
- 单测 waybillPrintDataFetch.test.js 4 例(成功不走回退 / 空引用回退 / 都失败 / PrintDataJson 解析)
- 文档补充双路径与踩坑记录

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 22:29:11 +08:00
liufumingren
498543b9d7 perf(external-send): 控制回传平台的请求量,避免被判刷单
全部回读订单行在批量场景会被平台当成高频访问,补齐三处节流:

- syncPending:同批相邻两单之间留 EXTERNAL_SEND_INTERVAL_MS(默认 300ms)
- resolveTraceId:按账号缓存,批量内只调一次 getUserInfo(原来每单一次)
- dgj.resolveTraceId():实例级缓存 5 分钟的 traceId,
  取号(fetchWaybillNo)与重打(waybillPrintData)改用它,批量取号不再逐单 getUserInfo

配合上一版的「快照拼报文」,发货每单只有 1 次 POST,不再回读订单行。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:14:12 +08:00
liufumingren
d5b4298c86 refactor(waybill): 更正语义——这不是「重打」,只是给需要 params 的平台拉打印数据
- dgj.reprintPrintData → fetchPrintParams;expressPrint 选项 reprint → reuseWaybill
  (PrintMethod=Normal + IsIgnoreWaybillRepeat=true = 复用原运单号、只重新下发打印数据)
- 提示语与安全闸措辞改为「拉取打印参数 / 平台分配了面单」,不再叫重打
- 模板不返回 params 时明确提示:只有抖店面单需要 params,
  淘宝/拼多多/京东/视频号等直接用取号返回的 printinfo 打单
- 文档同步:LoadPrintData 只回放历史签名;拉 params 走「复用原号重新下发」;
  仅抖店需要 params;验收记录改为「拉取 params 未产生新面单(余额 5253→5253)」

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 07:52:23 +08:00
liufumingren
3b98a1c3dc feat(waybill): getprintdata 改走「原单号打印」重签,拿到新鲜的 params
上一版用 PrintHistory/LoadPrintData,实测它只回放那次打印的签名(timestamp = 打印记录
CreateDate,换 FxPageType / IsRePrint / IsRefresh 都不重签),10 分钟后必过期。

实测出真正的重签方式(复用原运单号、不消耗面单):
  ExpressPrint + PrintMethod=Normal + IsIgnoreWaybillRepeat=true
→ 返回的运单号与原来一致,params.timestamp = 当前时间。

- dgj.reprintPrintData:原单号打印并解析 documents[].contents[].params
- dgj.expressPrint 支持 reprint 选项(Normal + IsIgnoreWaybillRepeat=true)
- getprintdata 改为:回读平台订单行 → 原单号打印 → 返回新 params / template_url;
  安全闸:若平台返回了新运单号(说明已消耗面单)直接判失败并 error 日志
- 仍逐张串行 + 300ms 间隔限流;参数归一化/定位逻辑不变

实测:请求 07:39:44 → params timestamp 2026-11-07 07:39:45,运单号 770357415909002 未变。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 07:40:30 +08:00
liufumingren
82ebe7e022 fix(waybill): 实测 LoadPrintData 只回放历史签名,返回 params_timestamp/params_expired
核实结论(2026-11-07,真实账号只读探测):
- Data[0].PrintDataJson、PrintHistoryData.PrintDataJson、PrinterJsonData 里的 params 完全一致,
  timestamp 都等于该打印记录的 CreateDate(实测 05:52:50 / 06:43:36)
- 换 FxPageType=1/2、加 IsRePrint / IsRefresh 都返回同一个 timestamp/sign → 接口不会重签
- 所以「打印前换新 params」不成立;只有取号那一刻返回的 params 是新鲜的,10 分钟后必过期

- getprintdata 结果新增 params_timestamp / params_expired,message 里点明是历史签名与后续做法
- 文档更正:LoadPrintData 是回放、不是重签;重打需走 ExpressPrint「原单号打印」重签(待接入)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 07:31:55 +08:00
liufumingren
82879cdef5 feat(waybill): getprintdata 只回 params 串,并按 printHistoryId 逐个限流回源
- 返回精简:每单只给定位字段 + params(contents[].params,形如
  access_token=…&app_key=…&method=logistics.getShopKey&…&sign=…)与 template_url;
  不再回整包 print_data / printer_config / document
- 限流:平台该接口有限流,改为一次只带一个 printHistoryId,逐张串行并间隔 300ms;
  单张失败不影响其它张,失败原因逐单返回
- params 为空时直接判失败(平台的打印数据里没有 params)

实测:{ printHistoryId: "10000078656212" } → params 为 access_token=uo7…
&method=logistics.getShopKey&…&sign=8849…,template_url 为申通 76x130 模板。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 06:56:20 +08:00
liufumingren
07a27a5bbd perf(waybill): getprintdata 支持只传一个 printHistoryId,并按 id 定位避免全表扫描
- 只传 printHistoryId(单值/数组)时,用取号落库的 platform_host + dbname + account_id
  直接回源 PrintHistory/LoadPrintData,WMS 不用知道域名与分区
- 记录定位改为 (waybill_code IN …) OR (print_history_ids LIKE '%"id":"…"%'),
  避免直传 id 时按主体全表扫描
- 文档补最简用法

实测:{ printHistoryId: "10000078656212" } → 运单号 770357408441408、dbname y/2wUDWCZOk=、
print_data 7888 字符、documentID 770357408441408。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 06:53:07 +08:00
liufumingren
09587bc3e7 feat(waybill): 新增 deliveryorder.getprintdata,打印前按运单号换新 params
店管家面单打印数据(params)只有 10 分钟有效期,取号返回的 printinfo 存着不能用,
WMS 真正打印前必须换新的。新增对外方法:

  method = deliveryorder.getprintdata
  入参:{ caiNiaoAuthInfoIds: [6838859], waybillCodes: ["770357408441408"] }
       也支持直传 { printHistoryIds: ["10000078656212"] }(命中即跳过查库)
  出参:{ total, success, failed, expires_in: 600, results: [...] }
       每单含 print_data / printer_config / document(documentID = 运单号)

实现:
- app/lib/waybillPrintData.js:按「店铺标识 + 运单号」查 waybill_fetch_records 定位打印记录,
  同账号同分区合并成一次 PrintHistory/LoadPrintData(只读,不消耗面单)
- 取号记录补 platform_host(实际命中的订单域名):1688 分销单在 fxali、真实抖音单在 fxdd,
  用被换算过的 source_platform_code 推域名会打错
- waybillGet 落 platform_host;迁移 20261107050000 加列

实测(只读):运单号 770357408441408 → 新 params 7888 字符,documentID 770357408441408,
printer 默认打印机;不存在的运单号返回「未找到该运单号的取号记录」。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 06:38:34 +08:00