拉单时已把平台整行存进 orders.external_data(实测 113 字段,含 PathFlowCode / ShippingType / OrderTags / SubOrders[].OrderItemId 这些状态表没有的内部字段), 发货报文其实就是这一行,所以没必要再回读平台。 - 新增 lib/dgjSendRow.js#buildSendRow:快照(静态内部字段) + 状态表(收件人/平台单号/运单号,可能晚于快照更新) + 最近一次成功取号记录(WaybillCodeId / Pid / ExpressCpCode / CreateDate) 拼成订单行;PrintState/ExpressPrintTime 用取号记录覆盖(快照里恒为 0/空) - externalSendSync.resolveSendRow:快照可用就不访问平台;缺快照(历史单)才回读兜底 - dgj 暴露 buildSendOrder 静态方法,供脚本/单测复用同一口径 实测(本地真实单 dgj-10000279877231):拼出的 Orders[0] 覆盖抓包全部 47 个关键字段 (163 个顶层键),面单块含 WaybillCodeId=10000298258339、Pid=ced304e7c1ffd618_0_1。 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
136 lines
5.3 KiB
JavaScript
136 lines
5.3 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('面单信息解析:优先 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);
|
||
});
|
||
});
|