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

90 lines
3.7 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');
/**
* 取号请求报文(`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');
});
});