取号失败时用户只看到「店管家取号失败:平台返回取号失败」——平台把逐单错误放在 `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>
44 lines
1.9 KiB
JavaScript
44 lines
1.9 KiB
JavaScript
'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), '平台返回取号失败');
|
||
});
|
||
});
|