线上报 `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>
176 lines
7.7 KiB
JavaScript
176 lines
7.7 KiB
JavaScript
'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,
|
||
};
|