oms/backend/test/app/lib/dgjSendRow.test.js
liufumingren bcca0075be feat(external-send): 发货回传改用本地快照拼报文,不再回读平台订单行
拉单时已把平台整行存进 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>
2026-11-07 08:12:54 +08:00

136 lines
5.3 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('面单信息解析:优先 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);
});
});