oms/backend/test/app/lib/waybillPrintDataFetch.test.js
liufumingren 37de11c309 fix(print-data): 菜鸟系面单换打印参数空引用时回退按打印记录取
WMS「韵达」面单换打印数据时平台回「拉取打印参数失败:未将对象引用设置到对象的实例。」,
这是 ExpressPrint 复用路径上的平台内部空引用,多发生在菜鸟系面单(韵达/申通/中通…)。

- dgj.expressPrint:Orders[0] 补 CaiNiaoAuthInfoId(菜鸟面单按模板授权网点取打印数据,缺了平台会空引用)
- dgj.fetchPrintParams:支持传入 caiNiaoAuthInfoId 注入订单行;平台空引用时在错误里补一句排查提示
- waybillPrintData.fetchGroup:复用取号拉参数失败后回退
  POST /PrintHistory/LoadPrintData(按 printHistoryId 只读、不消耗面单),
  用 Data[].PrintDataJson 里的 contents[].params + templateURL 兜住,返回标 source=print_history;
  两条都失败才报错(带原原因)。成功路径仍优先 ExpressPrint(抖店签名要重新签发)
- 单测 waybillPrintDataFetch.test.js 4 例(成功不走回退 / 空引用回退 / 都失败 / PrintDataJson 解析)
- 文档补充双路径与踩坑记录

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 22:29:11 +08:00

112 lines
4.4 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 { fetchGroup, parsePrintData } = require('../../../app/lib/waybillPrintData');
/** 静默 logger(lib 里只用来留痕,不影响返回) */
const silentCtx = { logger: { info() {}, warn() {}, error() {} } };
/**
* 造一个分组(一个运单号)
* @param {Object} [overrides] 覆盖取号记录字段
* @return {Object} fetchGroup 的 group 入参
*/
function buildGroup(overrides = {}) {
return {
accountId: 1,
host: 'fxdd.dgjapp.com',
dbname: 'dzh93a8yur84Y3Yln2ha9RbPovVMhBTc',
items: [{
waybillCode: '321450799451452',
history: { id: '21887928954' },
record: {
delivery_order_code: 'dgj-875172836006880609',
template_id: '12360764',
express_code: 'YUNDA',
cai_niao_auth_info_id: 6838859,
dbname: 'dzh93a8yur84Y3Yln2ha9RbPovVMhBTc',
...overrides,
},
}],
};
}
/**
* 菜鸟系面单的 PrintDataJson(平台原样)
* @return {string} JSON 字符串
*/
function buildPrintDataJson() {
return JSON.stringify({
printDataJson: JSON.stringify({
PrinterConfig: { printer: {} },
PrintDataList: {
task: {
documents: [{
documentID: 'doc-1',
contents: [{ params: 'access_token=tok&method=logistics.getShopKey&sign=abc&timestamp=2026-11-07 22:00:00', templateURL: 'https://tpl' }],
}],
},
},
}),
});
}
describe('app/lib/waybillPrintData 换取打印参数', () => {
it('复用取号拉参数成功时直接用平台返回的 params', async () => {
let loadCalled = false;
const service = {
findPlatformOrderRow: async () => ({ Id: 1, LogicOrderId: '875172836006880609', SubOrders: [] }),
fetchPrintParams: async () => ({ waybill_codes: [ '321450799451452' ], documents: [{ params: 'p1', template_url: 'u1' }] }),
loadPrintData: async () => {
loadCalled = true;
return [];
},
};
const memo = new Map([[ '7:1', { account: {}, service }]]);
const results = await fetchGroup(silentCtx, { principalId: 7, memo, group: buildGroup() });
assert.strictEqual(results.length, 1);
assert.strictEqual(results[0].success, true);
assert.strictEqual(results[0].params, 'p1');
assert.strictEqual(loadCalled, false, '成功路径不该多打一次平台接口');
});
it('平台空引用(未将对象引用设置到对象的实例)时回退按打印记录取回', async () => {
const service = {
findPlatformOrderRow: async () => ({ Id: 1, LogicOrderId: '875172836006880609', SubOrders: [] }),
fetchPrintParams: async () => {
throw new Error('店管家拉取打印参数失败:未将对象引用设置到对象的实例。');
},
loadPrintData: async () => ([{ print_history_id: '21887928954', print_data: buildPrintDataJson() }]),
};
const memo = new Map([[ '7:1', { account: {}, service }]]);
const results = await fetchGroup(silentCtx, { principalId: 7, memo, group: buildGroup() });
assert.strictEqual(results.length, 1);
assert.strictEqual(results[0].success, true);
assert.strictEqual(results[0].source, 'print_history');
assert.match(results[0].params, /access_token=tok/);
assert.strictEqual(results[0].template_url, 'https://tpl');
assert.strictEqual(results[0].template_id, '12360764');
assert.strictEqual(results[0].cai_niao_auth_info_id, 6838859);
});
it('两条路径都拿不到时返回原错误原因', async () => {
const service = {
findPlatformOrderRow: async () => ({ Id: 1, LogicOrderId: '875172836006880609', SubOrders: [] }),
fetchPrintParams: async () => {
throw new Error('店管家拉取打印参数失败:未将对象引用设置到对象的实例。');
},
loadPrintData: async () => ([{ print_history_id: '21887928954', print_data: '' }]),
};
const memo = new Map([[ '7:1', { account: {}, service }]]);
const results = await fetchGroup(silentCtx, { principalId: 7, memo, group: buildGroup() });
assert.strictEqual(results[0].success, false);
assert.match(results[0].message, /未将对象引用/);
});
it('parsePrintData 能从 PrintDataJson 里解出 params 与 templateURL', () => {
const parsed = parsePrintData(buildPrintDataJson());
assert.match(parsed.params, /access_token=tok/);
assert.strictEqual(parsed.template_url, 'https://tpl');
});
});