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>
112 lines
4.4 KiB
JavaScript
112 lines
4.4 KiB
JavaScript
'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×tamp=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');
|
||
});
|
||
});
|