oms/backend/test/app/lib/externalSendTemplate.test.js
liufumingren 8a38b7a1f3 fix(send): 发货模板按运单实际快递定位,修抖音风控拦截
线上报 `10000280844951: 风控拦截#CONSIGN_RISK_CONTROL_BLOCK#NOT_MATCH_SEGMENT_CHANNEL#
此运单号非抖音的运单号`。

根因:发货模板取的是「账号 + 平台」下 id 最小的那条快递接口(抖音小店第一条是中通),
而运单是申通。店管家把 TemplateId / ExpressCompanyId / ExpressCompanyCode 透传给平台,
抖音按模板的电子面单渠道校验运单号,运单不在该渠道号池里就判风控。

- externalSendSync.resolveTarget:运单快递取最近一次成功取号记录的 express_code
  (兜底配送表 logistics_code;注意 express_code 列存的是运单号),
  再用与取号同口径的 resolveByCode 定位模板;未绑定时按模板自带快递编码匹配,
  仍无命中才退回第一条并打 warn
- externalSendSync.resolveSendRow:取号记录只查一次,供模板与报文复用;
  WaybillCodes 为空时打 warn(平台校验渠道依赖该字段)
- dgjSendRow.buildSendRow:面单 ExpressCpCode 优先取号记录的快递编码,模板编码只做兜底
- dgj.sendOrders:风控/渠道类失败追加处理提示(需用对应平台+该快递的电子面单模板重新取号)
- 单测:新增 externalSendTemplate.test.js(4 例);dgjSendRow.test.js 补「快递编码不被模板覆盖」

本地库真实数据验证:快手单 dgj-10000267890142_1 运单 772085332374413 属申通,
旧逻辑命中模板 #17/YUNDA,修正后命中 #29/STO;抖音四张模板按快递分别命中
(STO→10776786、ZTO→13987231、YUNDA→12360764、POSTB→12712711)。

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

117 lines
4.2 KiB
JavaScript
Raw 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 { app, assert } = require('egg-mock/bootstrap');
const mm = require('egg-mock');
/**
* 快递接口记录(纯对象形态,与 resolveByCode 返回一致)
* @param {Object} [overrides] 覆盖字段
* @return {Object} 快递接口记录
*/
function buildInterface(overrides = {}) {
return {
id: 25,
platform_type: 'TouTiao',
platform_code: 'DYXD',
template_id: '10776786',
express_company_id: 8,
express_company_code: 'STO',
express_company_name: '申通',
custom_code: null,
dbname: 'y/2wUDWCZOk=',
...overrides,
};
}
/**
* 包一层 Sequelize 实例的最小替身(服务里用了 .get({ plain: true }))
* @param {Object} row 纯对象记录
* @return {Object|null} 带 get() 的替身
*/
function asModel(row) {
return row ? { get: () => row, ...row } : null;
}
describe('service/externalSendSync 发货模板按运单快递定位', () => {
let ctx;
let service;
beforeEach(() => {
ctx = app.mockContext();
service = ctx.service.externalSendSync;
});
it('有绑定关系时用绑定模板(与取号同口径)', async () => {
const bound = buildInterface({ id: 29, template_id: '10824270', express_company_code: 'STO', custom_code: 'STO' });
ctx.service.externalPrintExpressInterface.resolveByCode = async () => bound;
ctx.model.ExternalPrintExpressInterface.findOne = async () => { throw new Error('不应走到兜底查询'); };
const template = await service.resolveSendTemplate({
account: { id: 1 },
platformCode: 'SPH',
expressCode: 'STO',
principalId: 5,
});
console.log('绑定命中:', template.id, template.template_id, template.express_company_code);
assert.strictEqual(template.id, 29);
});
it('没绑定 custom_code 时按模板快递公司编码兜底匹配', async () => {
ctx.service.externalPrintExpressInterface.resolveByCode = async () => null;
const queries = [];
ctx.model.ExternalPrintExpressInterface.findOne = async options => {
queries.push(options);
return asModel(buildInterface({ id: 25, express_company_code: 'STO' }));
};
const template = await service.resolveSendTemplate({
account: { id: 1 },
platformCode: 'DYXD',
expressCode: 'STO',
principalId: 5,
});
console.log('兜底命中:', template.id, template.express_company_code, '| 查询条件:', JSON.stringify(queries[0].where));
assert.strictEqual(template.id, 25);
assert.strictEqual(queries[0].where.express_company_code, 'STO');
});
it('都对不上时退回该平台第一条模板(保持历史行为)', async () => {
ctx.service.externalPrintExpressInterface.resolveByCode = async () => null;
let call = 0;
ctx.model.ExternalPrintExpressInterface.findOne = async () => {
call += 1;
// 第一次按快递公司编码查(无命中),第二次退回第一条
return call === 1 ? null : asModel(buildInterface({ id: 4, express_company_code: 'ZTO', template_id: '13987231' }));
};
const warnings = [];
mm(ctx, 'logger', { warn: (...args) => warnings.push(args), info() {}, error() {} });
const template = await service.resolveSendTemplate({
account: { id: 1 },
platformCode: 'DYXD',
expressCode: 'STO',
principalId: 5,
});
console.log('退回第一条:', template.id, template.express_company_code, '| 告警条数:', warnings.length);
assert.strictEqual(template.id, 4);
assert.ok(warnings.length > 0, '未绑定时应记一条告警便于排查');
mm.restore();
});
it('没有快递编码(历史单)时直接退回第一条,不告警', async () => {
ctx.service.externalPrintExpressInterface.resolveByCode = async () => null;
ctx.model.ExternalPrintExpressInterface.findOne = async () => asModel(buildInterface({ id: 4, express_company_code: 'ZTO' }));
const warnings = [];
mm(ctx, 'logger', { warn: (...args) => warnings.push(args), info() {}, error() {} });
const template = await service.resolveSendTemplate({
account: { id: 1 },
platformCode: 'DYXD',
expressCode: '',
principalId: 5,
});
assert.strictEqual(template.id, 4);
assert.strictEqual(warnings.length, 0);
});
});