线上报 `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>
166 lines
6.5 KiB
JavaScript
166 lines
6.5 KiB
JavaScript
'use strict';
|
||
|
||
const { assert } = require('egg-mock/bootstrap');
|
||
const { buildSendRow, pickWaybillFromFetchRecord, toWaybillEntry } = require('../../../app/lib/dgjSendRow');
|
||
|
||
/**
|
||
* 最小可用的拉单快照(字段名与店管家订单行一致)
|
||
* @param {Object} overrides 覆盖字段
|
||
* @return {Object} 快照
|
||
*/
|
||
function buildSnapshot(overrides = {}) {
|
||
return {
|
||
Id: '10000279877231',
|
||
LogicOrderId: '10000279877231',
|
||
PlatformOrderId: '5127000000000000001',
|
||
PathFlowCode: '10000001527089',
|
||
ShippingType: 'ENCRYPTED_BLOB',
|
||
ShopId: 9560713,
|
||
ShopName: '13668975305(意洁)',
|
||
PlatformType: 'Taobao',
|
||
PlatformTypeName: '淘宝',
|
||
FxUserId: 1227061,
|
||
UpFxUserId: 953516,
|
||
OrderTags: [{ Tag: 'OutChannel', TagValue: 'douyin' }],
|
||
MergeredType: 0,
|
||
ExtField1: '',
|
||
ExtField2: '',
|
||
SellerRemarkFlagTag: '',
|
||
ReceiverIsChange: false,
|
||
IsPddCrossBorderOrder: false,
|
||
IsPddCourierDoorToDoorCollect: false,
|
||
IsOfflineOrder: false,
|
||
DataFlag: 1,
|
||
PayTime: '2026-11-06 19:16:01',
|
||
PrintState: 0,
|
||
WaybillCodes: [],
|
||
SubOrders: [{ OrderItemId: 10000305495583, OrderItemCode: '10000305495583', ProductID: 881526926136, SkuCode: '007' }],
|
||
ToName: '吴*',
|
||
ToPhone: '1**********',
|
||
ToProvince: '湖北省',
|
||
ToCity: '黄冈市',
|
||
ToCounty: '武穴市',
|
||
ToTown: '武穴街道',
|
||
ToAddress: '武穴街道********',
|
||
ToFullAddress: '湖北省黄冈市武穴市武穴街道********',
|
||
...overrides,
|
||
};
|
||
}
|
||
|
||
/** 取号记录(raw_response 是 ExpressPrint 响应) */
|
||
function buildFetchRecord() {
|
||
return {
|
||
express_code: 'STO',
|
||
waybill_code: '770357410089880',
|
||
created_at: new Date('2026-11-07T07:39:45Z'),
|
||
raw_response: JSON.stringify({
|
||
Success: true,
|
||
Data: {
|
||
WaybillCode: [{
|
||
WaybillCode: '770357410089880',
|
||
WaybillCodeId: 10000304201567,
|
||
WaybillCodePid: '8c51d72ab1f_2_1',
|
||
CpCode: 'STO',
|
||
RealCpCode: 'STO',
|
||
WaybillCodeCreateDate: '2026-11-07 07:39:45',
|
||
OrderId: '10000279877231',
|
||
}],
|
||
},
|
||
}),
|
||
};
|
||
}
|
||
|
||
const template = { template_id: '10776786', express_company_code: 'STO', express_company_name: '申通' };
|
||
|
||
describe('lib/dgjSendRow 本地快照拼发货报文', () => {
|
||
it('从快照 + 取号记录拼出订单行(不回读平台)', () => {
|
||
const order = {
|
||
order_no: 'dgj-10000279877231',
|
||
parent_order_no: '10000279877231',
|
||
oaid_order_source_code: '5127000000000000001',
|
||
express_code: 'STO',
|
||
express_codes: JSON.stringify([ '770357410089880' ]),
|
||
receiver: '吴*',
|
||
mobile: '1**********',
|
||
province: '湖北省',
|
||
city: '黄冈市',
|
||
area: '武穴市',
|
||
town: '武穴街道',
|
||
detail_address: '武穴街道********',
|
||
address: '湖北省黄冈市武穴市武穴街道********',
|
||
extend_props: { platform_order_no: '5127000000000000001' },
|
||
};
|
||
const row = buildSendRow({ order, snapshot: buildSnapshot(), fetchRecord: buildFetchRecord(), template });
|
||
console.log('拼装结果:', row.LogicOrderId, row.WaybillCode || row.LastWaybillCode, '| PrintState:', row.PrintState,
|
||
'| 面单:', row.WaybillCodes[0].WaybillCodeId, row.WaybillCodes[0].Pid);
|
||
assert.strictEqual(row.PathFlowCode, '10000001527089');
|
||
assert.strictEqual(row.ShippingType, 'ENCRYPTED_BLOB');
|
||
assert.strictEqual(row.LastWaybillCode, '770357410089880');
|
||
assert.strictEqual(row.PrintState, 1, '取号后应按已打印处理');
|
||
assert.strictEqual(row.UpFxUserId, 953516);
|
||
assert.strictEqual(row.WaybillCodes[0].WaybillCodeId, 10000304201567);
|
||
assert.strictEqual(row.WaybillCodes[0].Pid, '8c51d72ab1f_2_1');
|
||
assert.strictEqual(row.WaybillCodes[0].ExpressCpCode, 'STO');
|
||
});
|
||
|
||
it('收件人以状态表为准(快照可能早于改地址)', () => {
|
||
const order = {
|
||
order_no: 'dgj-1', parent_order_no: '1', express_codes: JSON.stringify([ 'W1' ]),
|
||
receiver: '新收件人', mobile: '13900000000', province: '广东省', city: '广州市', area: '白云区',
|
||
town: '钟落潭镇', detail_address: '新地址', address: '广东省广州市白云区新地址',
|
||
extend_props: {},
|
||
};
|
||
const row = buildSendRow({ order, snapshot: buildSnapshot(), fetchRecord: buildFetchRecord(), template });
|
||
assert.strictEqual(row.ToName, '新收件人');
|
||
assert.strictEqual(row.ToAddress, '新地址');
|
||
});
|
||
|
||
it('没有快照 / 没有运单号时返回 null(上层回退回读平台)', () => {
|
||
assert.strictEqual(buildSendRow({ order: { order_no: 'dgj-1', parent_order_no: '1' }, snapshot: null }), null);
|
||
const noWaybill = buildSendRow({
|
||
order: { order_no: 'dgj-1', parent_order_no: '1', extend_props: {} },
|
||
snapshot: buildSnapshot(),
|
||
fetchRecord: null,
|
||
});
|
||
assert.strictEqual(noWaybill, null);
|
||
});
|
||
|
||
it('面单快递编码优先取号记录,不被模板编码覆盖(抖音会按模板渠道校验运单号)', () => {
|
||
// 平台响应里没有 CpCode/RealCpCode 时,旧实现会用模板快递(可能是别的快递)兜底
|
||
const fetchRecord = {
|
||
express_code: 'STO',
|
||
waybill_code: '770357410089880',
|
||
created_at: new Date('2026-11-07T07:39:45Z'),
|
||
raw_response: JSON.stringify({
|
||
Success: true,
|
||
Data: {
|
||
WaybillCode: [{
|
||
WaybillCode: '770357410089880',
|
||
WaybillCodeId: 10000304201567,
|
||
WaybillCodePid: '8c51d72ab1f_2_1',
|
||
OrderId: '10000279877231',
|
||
}],
|
||
},
|
||
}),
|
||
};
|
||
const order = {
|
||
order_no: 'dgj-10000279877231',
|
||
parent_order_no: '10000279877231',
|
||
express_codes: JSON.stringify([ '770357410089880' ]),
|
||
extend_props: {},
|
||
};
|
||
const ztoTemplate = { template_id: '13987231', express_company_code: 'ZTO' };
|
||
const row = buildSendRow({ order, snapshot: buildSnapshot(), fetchRecord, template: ztoTemplate });
|
||
console.log('快递编码兜底:', row.WaybillCodes[0].ExpressCpCode, '| 模板:', ztoTemplate.express_company_code);
|
||
assert.strictEqual(row.WaybillCodes[0].ExpressCpCode, 'STO');
|
||
});
|
||
|
||
it('面单信息解析:优先 RealCpCode,缺字段不炸', () => {
|
||
const waybill = pickWaybillFromFetchRecord(buildFetchRecord().raw_response);
|
||
const entry = toWaybillEntry(waybill, { templateId: '10776786', expressCode: 'STO', subOrders: [{ OrderItemId: 1, OrderItemCode: 'A' }] });
|
||
assert.strictEqual(entry.ExpressCpCode, 'STO');
|
||
assert.strictEqual(entry.WaybillCodeOrderProducts[0].OrderItemId, 1);
|
||
assert.strictEqual(pickWaybillFromFetchRecord('not-json'), null);
|
||
});
|
||
});
|