线上报 `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>
117 lines
4.2 KiB
JavaScript
117 lines
4.2 KiB
JavaScript
'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);
|
||
});
|
||
});
|