oms/backend/test/app/lib/dgjSendRow.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

166 lines
6.5 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 { 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);
});
});