11 Commits

Author SHA1 Message Date
liufumingren
e0c718af8e fix(waybill): 快手取号补齐 key 与加密面单字段
- dgj: 抽取 contents[0].key;快手单 printinfo 取 encryptedData、encryptprintinfo 取逐单密钥(对齐菠萝派口径)
- waybillGet: deliveryorder.getwaybill 响应新增 key 字段并透传给 WMS
- 探测脚本输出 encryptprintinfo/key 长度;补充单测
- 更新 WMS-OMS 取号对接文档的快手字段说明

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 19:05:36 +08:00
liufumingren
9e1c476a55 perf(dgj): 平台请求节流 + 限流退避重试
线上取号/发货遇到服务商级限流:
`isv.request-limited 请求太频繁…配置限流QPS:600, 当前访问QPS:687`。
QPS 额度是整个 ISV 共享的,单靠降我们的并发压不住,所以两手都做:
削自己峰值 + 被限流时退避重试而不是直接判失败。

- dgj.request():所有平台调用的唯一出口,统一排队,相邻请求至少间隔
  DGJ_REQUEST_INTERVAL_MS(默认 100ms,单进程约 10 请求/秒)
- postPlatformForm():命中 isv.request-limited / 请求太频繁 / 访问QPS 时
  指数退避重试(DGJ_RATE_LIMIT_RETRY 默认 3 次、DGJ_RATE_LIMIT_BACKOFF_MS 默认 1000ms),
  仍限流则抛「店管家接口限流:…已自动退避重试 N 次仍被限流,请稍后重试」并保留原始返回
- waybillGet:批量取号并发 4 → 2(WAYBILL_CONCURRENCY 可调),
  每单 3 次平台调用(回读订单 + 模板校验 + ExpressPrint),并发越大突发越猛
- externalSendSync.recordFailure:平台限流不算这单的错,
  保持「待重试」且不累加 external_send_times,避免批量重试时一批单被打成「异常」
- 单测 dgjRateLimit.test.js(4 例):限流识别、退避后成功、重试耗尽报错、全局间隔生效
- 文档:请求量控制一节补 QPS 限流口径与全部节流开关

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 09:46:45 +08:00
liufumingren
ccd007005a feat(waybill): 取号响应回传 print_history_ids,由 WMS 自行落库
deliveryorder.getwaybill 的逐单结果新增:
- print_history_ids: [{ id, pid, waybill_code, batch_index }](每张面单一条,与 waybill_codes 对应)
- print_history_id: 第一张的 id(便捷值)

平台不会把 printHistoryId 放进面单数据(printinfo 里对应字段恒为 null),
只能从 Data.PrintHistoryIds[] 取,所以直接在响应里给到 WMS,便于其对账/查重。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 06:47:32 +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
liufumingren
9252763aba feat(waybill): 取号记录补店铺标识与分区,新增回捞打印数据能力
抖店面单打印数据(params)只有 10 分钟有效期,WMS 真正打印前必须回平台换一次新的,
因此取号时要留下「定位用」的信息。

- waybill_fetch_records 新增 cai_niao_auth_info_id(=店铺唯一标识)与 dbname(取号命中的分区)
- 迁移 20261107040000 加列 + 运单号索引(principal_id + cai_niao_auth_info_id + waybill_code)
- dgj.fetchWaybillNo 回传实际命中的 dbname;waybillGet 落库并把 CaiNiaoAuthInfoId 写入留痕上下文
- dgj.loadPrintData:POST /PrintHistory/LoadPrintData(printHistoryIds[] + dbname),
  解析 Data[].ID/ExpressWaybillCode/TemplateId/PrintDataJson,只读不消耗面单

实测(只读):打印记录 10000078656212 → 运单号 770357408441408,模板 10776786,
print_data 长度 7888。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 06:33:15 +08:00
liufumingren
7f8cff808b feat(waybill): 取号时解析并留痕打印记录ID(PrintHistoryIds)
平台 ExpressPrint 响应里有 Data.PrintHistoryIds,元素 { Id, Pid, WaybillCode,
WaybillCodeChild, BatchIndex },其中 Id 即 printHistoryId:重打/作废/查打印记录
(PrintHistory/LoadPrintData)都按它回捞。之前只用了 WaybillCode/printinfo,
这块被丢掉了。

- dgj.fetchWaybillNo 解析为 [{ id, pid, waybill_code, batch_index }]
- waybillGet 写入 waybill_fetch_records.print_history_ids(JSON 数组,多包裹对齐)
- 仅本地留痕,不改回 WMS 的响应契约
- 迁移 20261107030000 加列;单测覆盖真实响应样例与多包裹/缺失字段

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 06:26:46 +08:00
liufumingren
6ffe7cc889 fix(waybill): 1688 分销单换算后按原始平台回读订单(域名回退)
平台换算只用于「选对模板」,订单行仍留在店管家原始平台分区,域名必须按
extend_props.original_platform_code 推导,否则会用错域名被判「平台已查不到」。

- fetchWaybillNo:新增 originalPlatformCode,用原始平台算订单域名;waybillGet 从 extend_props 透传
- fetchRowsForVerify:拉单核对/自动作废按原始平台选域名,并给候选行补 extend_props
- checkPlatformFinished:审核前已发货校验按原始平台选域名
- externalSendSync.resolveTarget:发货回传 PlatformType 优先按原始平台

实测同一条 1688 分销单:fxali 命中(ErpState=waitsellersend),fxdd 查不到。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 05:44:57 +08:00
liufumingren
1e454d399c fix(waybill): 快递接口缺失/未绑定的提示改为「原因在前」
WMS 会把失败原因写进订单操作日志并截断长文案,原来「未绑定到快递接口」在最前面、
真正原因(该平台暂无面单模板 / 没有该快递公司的模板)在末尾括号里,很容易被截掉,
运维看不出到底缺什么。改成:

- 平台无任何模板:`平台1688(阿里巴巴)暂无面单模板(账号xxx):请到 OMS 店铺管理→
  外部打单平台→快递接口 点「从平台同步数据」,再为快递STO(申通快递)绑定`
- 有模板但缺该快递公司:`平台TB(淘宝)没有快递JD(京东物流)的面单模板(账号xxx):…`
- 有模板但该快递未绑定 / 重复绑定:同样把具体问题放在前面

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 05:40:29 +08:00
liufumingren
5f605b5412 fix(waybill): 取号失败时把平台错误信息返回给 WMS
- 新增 describePlatformFailure:把平台原始返回里可读的字段(ErrorCode / Message /
  Data.ErrorMsg / 网点 BranchName)拼进逐单 message,不再只回一个「模板校验失败:2」;
  不包含收件人信息,最长 500 字,与已有文案重复的字段自动跳过
- 同一个文案写入 waybill_fetch_records.error_message,raw_response 仍整包落库便于排查
- 实测:淘宝模板 + 1688 订单取号返回「店管家模板校验失败:2(网点:荔湾和平)」,
  取号记录与返回 WMS 的信息一致(逐单 success/message 结构未变)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 01:18:29 +08:00
liufumingren
e1e3bb638f feat(order): 拉单任务、外部发货同步与取号记录
- 拉单任务:新增 order_sync_tasks 异步任务池,按店铺逐店拉取外部打单平台订单,前端轮询进度
- 外部发货同步:配送后把发货结果同步回店管家,提供数量统计与批量重试(externalSendSync)
- 取号:新增 waybill_fetch_records 记录取号过程,外部快递接口补充菜鸟授权信息
- 补齐相关迁移、订单页同步入口/状态展示,并新增对接说明文档

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 20:53:35 +08:00
liufumingren
eaf957ed14 feat(express): 外部打单快递接口、自定义快递编码与回 OMS 取号
- 外部打单平台快递接口:按账号同步平台模板、绑定快递编码、查看模板明细;打开列表只读库,仅「从平台同步数据」时拉取
- 系统管理新增自定义快递编码字典,订单改快递 / 物流下拉合并系统与自定义编码,推送奇门沿用订单上的编码
- 新增 OpenAPI deliveryorder.getwaybill:WMS 批量回取号(单次≤100、并发4、逐单结果),快递编码只取 WMS 报文,取消/作废/归档返回失败,已取号直接复用
- 新增 openapi_request_idempotency 请求级幂等:request_id 回放、报文摘要校验、30 分钟 stale 接管、7 天定时清理
- 外部打单平台订单按平台 fetch_waybill_no 下发 need_oms_waybill,推送时实时判定并回写单据
- 店铺、打单账号平台配置与「平台+编码→模板」绑定走 Redis 缓存,绑定/账号变更主动失效,避免批量推送与取号逐单查库

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 04:10:37 +08:00