oms/backend/test/app/lib/orderSnCodes.test.js
liufumingren 61309c430f feat(order): 留存 WMS 回传的 SN 列表并支持按 SN 反查订单
- 新增 order_sn_codes 关联表(order_id = order_index.id,一行一个 SN,唯一键兜底去重)
- deliveryorder.confirm 解析 orderLines[].snList / 包裹内商品 snList,幂等写入(仅委外中/已配送的订单)
- 订单列表新增 sn_codes 多值筛选(逗号/换行分隔,最多 200 个,精确匹配反查)
- 订单详情返回 sn_codes;订单导出支持「序列号」筛选
- 前端订单页新增「序列号」批量筛选与详情序列号明细
- 补充 WMS 回传报文说明与 lib 单测

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-13 22:42:57 +08:00

90 lines
3.2 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 { extractSnEntries } = require('../../../app/lib/orderSnCodes');
describe('test/app/lib/orderSnCodes.test.js', () => {
it('解析明细行 snList(字符串数组)并带行号/商品信息', () => {
const entries = extractSnEntries({
lines: [
{
orderLineNo: '1',
itemCode: 'SKU-SN-001',
itemId: '162678',
itemName: '序列号商品A',
snList: [
'HTTPS://SUYUAN.HULIANZAOWU.COM/PRODUCT?Q=YGP9213002516455',
'6977752010196',
],
},
{ orderLineNo: '2', itemCode: 'SKU-NORMAL-002', snList: [] },
],
});
assert(entries.length === 2);
assert(entries[0].sn_code === 'HTTPS://SUYUAN.HULIANZAOWU.COM/PRODUCT?Q=YGP9213002516455');
assert(entries[0].order_line_no === '1');
assert(entries[0].item_code === 'SKU-SN-001');
assert(entries[0].item_id === 162678);
assert(entries[1].sn_code === '6977752010196');
// 包裹维度字段在行级 SN 上为空
assert(entries[0].package_code === null);
assert(entries[0].express_code === null);
});
it('解析包裹内商品的 snList,并带包裹号/运单号', () => {
const entries = extractSnEntries({
packages: [
{
packageCode: 'PK-20261113-0001',
expressCode: 'YT1234567890123',
items: [{ itemCode: 'SKU-SN-002', itemId: 162672, snList: [ 'SN-A', 'SN-B' ] }],
},
],
});
assert(entries.length === 2);
assert(entries[0].package_code === 'PK-20261113-0001');
assert(entries[0].express_code === 'YT1234567890123');
assert(entries[0].item_code === 'SKU-SN-002');
assert(entries.map(entry => entry.sn_code).join(',') === 'SN-A,SN-B');
});
it('兼容 snCodes 逗号分隔 / 对象数组 / snCode 单值', () => {
const entries = extractSnEntries({
lines: [
{ orderLineNo: '1', snCodes: 'SN1,SN2;SN3' },
{ orderLineNo: '2', snList: [{ snCode: 'SN4' }, { sn: 'SN5' }] },
{ orderLineNo: '3', snCode: 'SN6' },
],
});
assert(entries.map(entry => entry.sn_code).join(',') === 'SN1,SN2,SN3,SN4,SN5,SN6');
});
it('同一 SN 在行级与包裹级重复出现时只留一条(不区分大小写)', () => {
const entries = extractSnEntries({
lines: [{ orderLineNo: '1', itemCode: 'SKU-A', snList: [ 'sn-x' ] }],
packages: [{ packageCode: 'PK-1', items: [{ itemCode: 'SKU-A', snList: [ 'SN-X' ] }] }],
});
assert(entries.length === 1);
assert(entries[0].sn_code === 'sn-x');
assert(entries[0].package_code === null);
});
it('无 SN / 空报文返回空数组', () => {
const blankLine = { snList: [ ' ' ] };
assert(extractSnEntries({}).length === 0);
assert(extractSnEntries({ lines: [{ orderLineNo: '1', snList: [] }] }).length === 0);
assert(extractSnEntries({ lines: [ null, 'x', blankLine ] }).length === 0);
});
it('单次回传条数上限 2000', () => {
const snList = Array.from({ length: 2100 }, (_, index) => `SN-${index}`);
const entries = extractSnEntries({ lines: [{ orderLineNo: '1', snList }] });
assert(entries.length === 2000);
assert(entries[1999].sn_code === 'SN-1999');
});
});