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 |
|