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

176 lines
7.7 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';
/**
* 用本地快照组装店管家「发货回传」需要的订单行
*
* 背景:`POST /NewOrder/OnlineSend` 的 `Orders[i]` 基本就是平台订单行本身。
* 拉单时我们已把平台整行存进老表 `orders.external_data`(实测 113 个字段,含
* `PathFlowCode` / `ShippingType` / `OrderTags` / `SubOrders[].OrderItemId` 等内部字段),
* 因此发货时不必再回读平台,只需把「快照 + 状态表(最新业务字段)+ 取号记录(最新面单信息)」拼起来。
*
* 时效性处理:
* - 快照里的 `PrintState` / `ExpressPrintTime` / `WaybillCodes` 是拉单那一刻的,
* 取号之后才有正确值 → 用取号记录(`waybill_fetch_records`)覆盖;
* - 收件人、平台单号等以状态表为准(快照可能早于改地址/改备注)。
*/
/**
* 安全解析 JSON(快照/原始响应可能是字符串)
* @param {*} value 原始值
* @return {Object|null} 解析结果
*/
function parseJson(value) {
if (!value) return null;
if (typeof value === 'object') return value;
try {
return JSON.parse(String(value));
} catch {
return null;
}
}
/**
* 从取号记录的平台原始返回里取面单信息(WaybillCode[] 第一张)
* @param {string|Object} rawResponse 取号记录的 raw_response
* @return {Object|null} 平台面单对象
*/
function pickWaybillFromFetchRecord(rawResponse) {
const json = parseJson(rawResponse);
const list = json && json.Data && Array.isArray(json.Data.WaybillCode) ? json.Data.WaybillCode : [];
return list.find(item => item && item.WaybillCode) || null;
}
/**
* 把平台面单对象转成订单行里的 `WaybillCodes[]` 元素
* @param {Object} waybill 平台面单对象(ExpressPrint 返回)
* @param {Object} params 补充参数
* @param {string} [params.templateId] 面单模板ID
* @param {string} [params.expressCode] 快递编码
* @param {string} [params.expressName] 快递名称
* @param {Array} [params.subOrders] 平台子单(生成面单-商品关联)
* @return {Object|null} WaybillCodes 元素
*/
function toWaybillEntry(waybill, { templateId = '', expressCode = '', expressName = '', subOrders = [] } = {}) {
if (!waybill || !waybill.WaybillCode) return null;
const cpCode = waybill.RealCpCode || waybill.CpCode || expressCode || '';
const orderId = String(waybill.WaybillCode);
const masterIdBase = `${waybill.OrderId || ''}_${orderId}_EI`;
return {
TemplateId: templateId || null,
ExpressCpCode: cpCode,
ExpressName: expressName || cpCode,
WaybillCode: orderId,
ChildWaybillCode: null,
ChildWaybillCodes: null,
CompanyCode: cpCode,
WaybillCodeId: waybill.WaybillCodeId || null,
CreateDate: waybill.WaybillCodeCreateDate || '',
IsSended: false,
IsPreviewed: null,
TotalWeight: 0,
SendType: 0,
Status: 1,
UniqueKey: waybill.WaybillUniqueKey || null,
Pid: waybill.WaybillCodePid || null,
LogisticType: null,
WaybillCodeOrderProducts: (subOrders || []).map(sub => ({
Id: null,
MasterId: `${masterIdBase}_${sub.OrderItemId || ''}`,
OrderItemId: sub.OrderItemId,
OrderItemIdStr: String(sub.OrderItemId == null ? '' : sub.OrderItemId),
Quantity: 1,
OrderItemCode: sub.OrderItemCode,
SendType: null,
ParentUniqueKey: null,
WaybillCodeId: waybill.WaybillCodeId || null,
StockCode: null,
})),
IsManual: false,
};
}
/**
* 组装发货回传用的订单行(本地快照优先,不访问平台)
* @param {Object} params 参数
* @param {Object} params.order 配送状态行(含 parent_order_no / 收件人 / extend_props / express_codes)
* @param {Object} [params.snapshot] 拉单快照(orders.external_data)
* @param {Object} [params.fetchRecord] 最近一次成功取号记录(waybill_fetch_records)
* @param {Object} [params.template] 快递接口记录(template_id / express_company_code / express_company_name)
* @return {Object|null} 订单行;快照缺失且状态表信息不足以拼装时返回 null(调用方回退到回读平台)
*/
function buildSendRow({ order, snapshot, fetchRecord, template }) {
const snap = snapshot && typeof snapshot === 'object' ? snapshot : null;
if (!snap) return null;
const extendProps = order && typeof order.extend_props === 'object' && order.extend_props ? order.extend_props : {};
const logicalOrderId = String((order && (order.parent_order_no || order.order_no)) || snap.LogicOrderId || '').trim();
if (!logicalOrderId) return null;
const templateId = String((template && template.template_id) || '');
// 快递编码优先取号记录(运单实际所属快递),模板编码只做兜底:
// 模板与运单快递不一致时,平台会按模板渠道校验运单号(抖音会报 NOT_MATCH_SEGMENT_CHANNEL)
const expressCode = String((fetchRecord && fetchRecord.express_code) || (template && template.express_company_code) || '').trim();
const expressName = String((template && template.express_company_name) || '').trim();
const subOrders = Array.isArray(snap.SubOrders) ? snap.SubOrders : [];
// 面单信息:取号记录最新;没有取号记录时退回快照里的(可能为空)
const waybill = pickWaybillFromFetchRecord(fetchRecord && fetchRecord.raw_response);
const waybillEntry = toWaybillEntry(waybill, { templateId, expressCode, expressName, subOrders });
let waybillCodes = Array.isArray(snap.WaybillCodes) ? snap.WaybillCodes.filter(item => item && item.WaybillCode) : [];
if (waybillEntry) waybillCodes = [ waybillEntry ];
const statusCodes = String((order && order.express_codes) || '').trim();
const statusList = (() => {
if (!statusCodes) return [];
const parsed = parseJson(statusCodes);
if (Array.isArray(parsed)) return parsed.map(String);
return statusCodes.split(',').map(item => item.trim()).filter(Boolean);
})();
const waybillCode = String((waybillEntry && waybillEntry.WaybillCode) || statusList[0] || order && order.express_code || '').trim();
if (!waybillCode) return null;
const pick = (stateValue, snapKey) => {
const value = stateValue == null ? '' : String(stateValue).trim();
return value || (snap[snapKey] == null ? '' : String(snap[snapKey]));
};
return {
...snap,
Id: snap.Id || logicalOrderId,
LogicOrderId: logicalOrderId,
PlatformOrderId: logicalOrderId,
CustomerOrderId: pick(extendProps.platform_order_no || (order && order.oaid_order_source_code), 'PlatformOrderId'),
PathFlowCode: snap.PathFlowCode || '',
ShopId: snap.ShopId,
ShopName: snap.ShopName || extendProps.platform_shop_name || '',
PlatformType: snap.PlatformType || '',
PlatformTypeName: snap.PlatformTypeName || '',
FxUserId: snap.FxUserId,
UpFxUserId: snap.UpFxUserId,
OrderTags: Array.isArray(snap.OrderTags) ? snap.OrderTags : [],
SubOrders: subOrders,
WaybillCodes: waybillCodes,
LastWaybillCode: waybillCode,
// 取号/打印之后才有:快照里恒为 0 / 空
PrintState: 1,
ExpressPrintTime: (fetchRecord && fetchRecord.created_at) || snap.ExpressPrintTime || '',
// 收件人以状态表为准(快照可能早于改地址)
ToName: pick(order && order.receiver, 'ToName'),
ToPhone: pick(order && (order.mobile || order.tel), 'ToPhone'),
ToProvince: pick(order && order.province, 'ToProvince'),
ToCity: pick(order && order.city, 'ToCity'),
ToCounty: pick(order && order.area, 'ToCounty'),
ToTown: pick(order && order.town, 'ToTown'),
ToAddress: pick(order && order.detail_address, 'ToAddress'),
ToFullAddress: pick(order && order.address, 'ToFullAddress'),
};
}
module.exports = {
buildSendRow,
// 供单测复用
parseJson,
pickWaybillFromFetchRecord,
toWaybillEntry,
};