取号失败时用户只看到「店管家取号失败:平台返回取号失败」——平台把逐单错误放在 `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>
90 lines
3.7 KiB
JavaScript
90 lines
3.7 KiB
JavaScript
'use strict';
|
||
|
||
const { assert } = require('egg-mock/bootstrap');
|
||
const DgjService = require('../../../app/lib/printPlatform/dgj');
|
||
|
||
/**
|
||
* 取号请求报文(`ExpressPrint` 的 `Orders[i]`)构造。
|
||
*
|
||
* 抽成纯函数是为了排错时能把「实际发给平台的报文」打出来 —— `waybill_fetch_records`
|
||
* 只存平台回显,没有请求体。这里锁住字段映射,避免以后调字段时又说不清「差异在哪」。
|
||
*/
|
||
describe('dgj.buildExpressPrintOrder 取号请求报文', () => {
|
||
const row = {
|
||
Id: '10000289308857',
|
||
LogicOrderId: '10000289308857',
|
||
PlatformOrderId: '3316563626158027487',
|
||
PathFlowCode: '10000001412039',
|
||
ShopId: 7398588,
|
||
FxUserId: 1227061,
|
||
IsCold: 0,
|
||
ToName: '张*',
|
||
ToPhone: '157****6483-2116',
|
||
ToProvince: '河南省',
|
||
ToCity: '漯河市',
|
||
ToCounty: '舞阳县',
|
||
ToTown: '舞泉镇',
|
||
ToAddress: '北京路哆哆潮品服装店',
|
||
ToFullAddress: '河南省漯河市舞阳县舞泉镇 北京路哆哆潮品服装店',
|
||
SubOrders: [
|
||
{ OrderItemId: '10000314681299', OrderItemCode: '10000314681299', SkuCode: '006-1', ProductCode: '10000053027651' },
|
||
],
|
||
};
|
||
|
||
it('订单级字段按平台前端口径映射', () => {
|
||
const order = DgjService.buildExpressPrintOrder(row, { templateId: '12360764', expressCode: 'YUNDA' });
|
||
assert.strictEqual(order.Index, 1);
|
||
assert.strictEqual(order.Id, '10000289308857');
|
||
// 平台单号(抖店单号)放 CustomerOrderId,店管家系统编号放 LogicOrderId/PlatformOrderId
|
||
assert.strictEqual(order.CustomerOrderId, '3316563626158027487');
|
||
assert.strictEqual(order.LogicOrderId, '10000289308857');
|
||
assert.strictEqual(order.PlatformOrderId, '10000289308857');
|
||
assert.strictEqual(order.ShopId, 7398588);
|
||
assert.strictEqual(order.FxUserId, 1227061);
|
||
assert.strictEqual(order.PrintInfo, '[1];\n');
|
||
assert.strictEqual(order.IsSelectAllNotPrintedItem, '1');
|
||
});
|
||
|
||
it('明细按 SubOrders 逐条下发,OrderItems 与 Items 同源', () => {
|
||
const order = DgjService.buildExpressPrintOrder(row, { templateId: '12360764' });
|
||
assert.deepStrictEqual(order.OrderItems, [ '10000314681299' ]);
|
||
assert.deepStrictEqual(order.OrderItemStrList, [ '10000314681299' ]);
|
||
assert.deepStrictEqual(order.Items, [{
|
||
OrderItemId: '10000314681299',
|
||
OrderItemCode: '10000314681299',
|
||
Quantity: '1',
|
||
ShortTitle: undefined,
|
||
SkuCode: '006-1',
|
||
ProductCode: '10000053027651',
|
||
}]);
|
||
});
|
||
|
||
it('收件人按平台字段映射,脱敏值原样透传', () => {
|
||
const order = DgjService.buildExpressPrintOrder(row, { templateId: '12360764' });
|
||
assert.deepStrictEqual(order.Receiver, {
|
||
toFullName: '张*',
|
||
toMobile: '157****6483-2116',
|
||
toArea: '河南省漯河市舞阳县舞泉镇 北京路哆哆潮品服装店',
|
||
toProvince: '河南省',
|
||
toCity: '漯河市',
|
||
toCounty: '舞阳县',
|
||
toMaskAddress: '舞泉镇北京路哆哆潮品服装店',
|
||
});
|
||
});
|
||
|
||
it('多包裹时同一订单行重复下发,Index 递增', () => {
|
||
const orders = DgjService.buildExpressPrintOrders([ row ], { templateId: '12360764', repeat: 2 });
|
||
assert.strictEqual(orders.length, 2);
|
||
assert.deepStrictEqual(orders.map(item => item.Index), [ 1, 2 ]);
|
||
assert.deepStrictEqual(orders.map(item => item.LogicOrderId), [ '10000289308857', '10000289308857' ]);
|
||
});
|
||
|
||
it('平台已有运单号时作为当前号下发(新单号打印据此换号)', () => {
|
||
const order = DgjService.buildExpressPrintOrder(
|
||
{ ...row, LastWaybillCode: '435434980095250', WaybillCodes: [{ WaybillCode: '435434980095251' }] },
|
||
{ templateId: '12360764' }
|
||
);
|
||
assert.strictEqual(order.WaybillCode, '435434980095250');
|
||
});
|
||
});
|