oms/backend/test/app/lib/dgjWaybillError.test.js
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

44 lines
1.9 KiB
JavaScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
const { assert } = require('egg-mock/bootstrap');
const DgjService = require('../../../app/lib/printPlatform/dgj');
/**
* 取号失败的逐单错误解析。
*
* 实测(生产 18:49):1688 抖音分销单用抖音模板取号,平台返回
* `{"IsError":true,"ErrCode":"15002","ErrMsg":"非抖店订单,无法使用抖音电子面单取号打印…"}`,
* 旧代码只读 `ErrorMsg` / `Message`,用户侧只看到「平台返回取号失败」,查不到真实原因。
*/
describe('dgj.describeWaybillError 取号失败原因', () => {
it('优先取 ErrMsg 并带上 ErrCode(真实响应结构)', () => {
const message = DgjService.describeWaybillError({
IsError: true,
ErrCode: '15002',
ErrMsg: '非抖店订单,无法使用抖音电子面单取号打印,请用抖店平台订单号重新创建线下单再重试。',
});
assert.strictEqual(
message,
'非抖店订单,无法使用抖音电子面单取号打印,请用抖店平台订单号重新创建线下单再重试。(ErrCode=15002)'
);
});
it('兼容 ErrorMsg / Message 等历史字段', () => {
assert.strictEqual(DgjService.describeWaybillError({ ErrorMsg: '模板未配置' }), '模板未配置');
assert.strictEqual(DgjService.describeWaybillError({ Message: '余额不足' }), '余额不足');
assert.strictEqual(
DgjService.describeWaybillError({ ErrMsg: '地址超区', ErrorMsg: '' }),
'地址超区'
);
});
it('只有 ErrCode 没有文案时也把它透出来', () => {
assert.strictEqual(DgjService.describeWaybillError({ ErrCode: '15002' }), '平台返回取号失败(ErrCode=15002)');
});
it('什么都没有时回落到默认文案', () => {
assert.strictEqual(DgjService.describeWaybillError({}), '平台返回取号失败');
assert.strictEqual(DgjService.describeWaybillError(null), '平台返回取号失败');
});
});