1 Commits

Author SHA1 Message Date
liufumingren
e1f49451c0 fix(dgj): 取号失败透出平台 ErrCode/ErrMsg,取号报文构造可对照
取号失败时用户只看到「店管家取号失败:平台返回取号失败」——平台把逐单错误放在
`Data.WaybillCode[n].ErrCode / ErrMsg`(实测 15002「非抖店订单,无法使用抖音电子面单
取号打印…」),我们只读了 `ErrorMsg` / `Message`,真实原因被吞掉。

- 新增 describeWaybillError:按 ErrMsg → ErrorMsg → Message → OrderInfo/Order 兜底,
  并附上 ErrCode;「未返回运单号」分支也带上平台原因
- 把 ExpressPrint 的 Orders[i] 报文构造抽成纯函数 buildExpressPrintOrder /
  buildExpressPrintOrders(expressPrint 内部改为调用),并挂到 DgjService 静态方法上:
  取号记录只有平台回显、没有请求体,出问题时要能把「我们实际发的报文」打出来对照
  (对比过成功/失败两单:结构完全一致,只有业务值不同)
- 单测:dgjWaybillError(4 例)+ dgjExpressPrintPayload(5 例:字段映射、明细口径、
  收件人、多包裹 Index、当前运单号)
- 文档补 §4.4.1:1688 分销单用抖音面单的前置条件(extField7 里要有 outPlatformOrderNo,
  明文渠道单没有就报 15002,只能在店管家侧重新授权/建线下单)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-08 19:05:30 +08:00