'use strict'; const assert = require('node:assert/strict'); const crypto = require('node:crypto'); const { getAuthToken, invokeSystemMethod, invokeQimenMethod, } = require('../../support/system_method_client'); const EXTRA_HEADERS = { platform: 'web', project: 'all', }; const FIXED_RELATION = { storeId: 1000000, warehouseId: 100000, }; const FALLBACK_ROLE_IDS = [ 4, 6, 30 ]; /** * 将字符串转义为 XML 安全文本。 * @param {string|number|null|undefined} value 待转义值。 * @return {string} 转义后的 XML 文本。 */ function escapeXml(value) { return String(value === null || value === undefined ? '' : value).replace(/[<>&'\"]/g, character => { switch (character) { case '<': return '<'; case '>': return '>'; case '&': return '&'; case '\'': return '''; case '"': return '"'; default: return character; } }); } /** * 从候选列表中挑选固定测试签约关系。 * @param {Array} relations 签约关系列表。 * @return {object|null} 固定测试关系。 */ function pickFixedTestRelation(relations) { if (!Array.isArray(relations)) { return null; } return relations.find(item => Number(item.store_id) === FIXED_RELATION.storeId && Number(item.warehouse_id) === FIXED_RELATION.warehouseId) || null; } /** * 从接口配置列表中挑选一个已启用的 QM_WMS 配置。 * @param {Array} configs 接口配置列表。 * @return {object|null} 可用奇门配置。 */ function pickEnabledQimenConfig(configs) { if (!Array.isArray(configs)) { return null; } return configs.find(item => Number(item.is_enabled) === 1 && (item.interface_category === 'QM_WMS' || item.interface_type?.interface_category === 'QM_WMS')) || null; } /** * 从库存搜索结果中挑选一个可用 SKU。 * @param {Array} stocks 库存搜索结果。 * @return {object|null} 可用 SKU。 */ function pickUsableStock(stocks) { if (!Array.isArray(stocks)) { return null; } const resolveAvailableQuantity = item => { const directAvailableFields = [ item?.available_quantity, item?.availableQuantity, item?.available, ]; for (const value of directAvailableFields) { const numeric = Number(value); if (Number.isFinite(numeric) && numeric > 0) { return numeric; } } const quantity = Number(item?.quantity); const lockedQuantity = Number(item?.locked_quantity ?? item?.lockedQuantity ?? item?.lockQuantity); if (Number.isFinite(quantity) && quantity > 0) { const resolvedLocked = Number.isFinite(lockedQuantity) ? lockedQuantity : 0; return Math.max(0, quantity - resolvedLocked); } const storageList = Array.isArray(item?.storage) ? item.storage : []; for (const storageItem of storageList) { const storageAvailable = Number(storageItem?.available_quantity ?? storageItem?.availableQuantity ?? storageItem?.available); if (Number.isFinite(storageAvailable) && storageAvailable > 0) { return storageAvailable; } const storageQuantity = Number(storageItem?.quantity); const storageLocked = Number(storageItem?.locked_quantity ?? storageItem?.lockedQuantity); if (Number.isFinite(storageQuantity) && storageQuantity > 0) { const resolvedStorageLocked = Number.isFinite(storageLocked) ? storageLocked : 0; const available = Math.max(0, storageQuantity - resolvedStorageLocked); if (available > 0) { return available; } } } return 0; }; return stocks.find(item => resolveAvailableQuantity(item) > 0) || null; } /** * 构建待审核订单的 XML 请求体。 * @param {Object} payload 请求参数。 * @return {string} XML 请求体。 */ function buildDeliveryOrderXml(payload) { const { deliveryOrderCode, warehouseCode, stock, planQty, orderType, receiverInfo } = payload; return ` ${escapeXml(deliveryOrderCode)} TAOBAO 淘宝 ${escapeXml(warehouseCode)} ${escapeXml(orderType)} ${escapeXml(receiverInfo.name)} ${escapeXml(receiverInfo.mobile)} ${escapeXml(receiverInfo.province)} ${escapeXml(receiverInfo.city)} ${escapeXml(receiverInfo.area)} ${escapeXml(receiverInfo.town)} ${escapeXml(receiverInfo.detailAddress)} ${escapeXml(receiverInfo.zipCode)} ${escapeXml(stock.id)} ${escapeXml(stock.item_code)} ${escapeXml(stock.item_name)} ${escapeXml(planQty)} 1 `; } /** * 切换到可访问仓库订单和库存接口的仓库角色。 * @param {string} token 当前登录 token。 * @return {Promise<{token: string, roleId: number}|null>} 切换结果。 */ async function switchToWarehouseRole(token) { const infoRes = await invokeSystemMethod('user.info', {}, token, EXTRA_HEADERS); assert.equal(infoRes.status, 200, `user.info HTTP 状态异常: ${JSON.stringify(infoRes.body)}`); assert.equal(infoRes.body.flag, 'success', `user.info 返回失败: ${JSON.stringify(infoRes.body)}`); assert.equal(infoRes.body.code, 200, `user.info code 异常: ${JSON.stringify(infoRes.body)}`); const employees = Array.isArray(infoRes.body?.data?.employees) ? infoRes.body.data.employees : []; const candidateRoleIds = [ ...new Set([ ...employees .filter(item => item && item.role_type === 'warehouse' && Number(item.id)) .map(item => Number(item.id)), ...FALLBACK_ROLE_IDS, ].filter(Boolean)), ]; for (const roleId of candidateRoleIds) { const changeRes = await invokeSystemMethod('user.changeRole', { roleId, }, token, EXTRA_HEADERS); if (changeRes.status !== 200 || changeRes.body?.flag !== 'success' || Number(changeRes.body?.code) !== 200) { continue; } const switchedToken = changeRes.body?.data?.token || token; const relationProbeRes = await invokeSystemMethod('storeWarehouse.store.list', { page: 1, page_size: 50, }, switchedToken, EXTRA_HEADERS); const stockProbeRes = await invokeSystemMethod('stock.warehouse.search', { keyword: '', store_id: FIXED_RELATION.storeId, with_stock: true, is_batch: false, }, switchedToken, EXTRA_HEADERS); if (relationProbeRes.status === 200 && relationProbeRes.body?.flag === 'success' && Number(relationProbeRes.body?.code) === 200 && pickFixedTestRelation(relationProbeRes.body?.data?.list) && stockProbeRes.status === 200 && stockProbeRes.body?.flag === 'success' && Number(stockProbeRes.body?.code) === 200) { return { token: switchedToken, roleId, }; } } return null; } describe('test/app/controller/qimen.deliveryorder.reviewFlow.test.js', () => { it('should create, review and move a delivery order through the real qimen flow', async function() { const auth = await getAuthToken({ forceLogin: true }); const switched = await switchToWarehouseRole(auth.token); if (!switched) { this.skip(); return; } let relation = null; let qimenConfig = null; let stock = null; let originalPolicyConfig = null; let contractId = null; const deliveryOrderCode = `QIMEN_REVIEW_${Date.now()}_${crypto.randomBytes(4).toString('hex').toUpperCase()}`; try { const relationListRes = await invokeSystemMethod('storeWarehouse.store.list', { page: 1, page_size: 50, }, switched.token, EXTRA_HEADERS); assert.equal(relationListRes.status, 200, `查询签约关系列表 HTTP 状态异常: ${JSON.stringify(relationListRes.body)}`); assert.equal(relationListRes.body.flag, 'success', `查询签约关系列表失败: ${JSON.stringify(relationListRes.body)}`); assert.equal(Number(relationListRes.body.code), 200, `查询签约关系列表 code 异常: ${JSON.stringify(relationListRes.body)}`); relation = pickFixedTestRelation(relationListRes.body?.data?.list); if (!relation) { this.skip(); return; } contractId = Number(relation.id || 0); originalPolicyConfig = relation.policy_config && typeof relation.policy_config === 'object' ? { ...relation.policy_config } : null; if (!originalPolicyConfig) { this.skip(); return; } const apiConfigRes = await invokeSystemMethod('storeWarehouse.store.listApiConfig', { id: contractId, }, switched.token, EXTRA_HEADERS); assert.equal(apiConfigRes.status, 200, `查询接口配置列表 HTTP 状态异常: ${JSON.stringify(apiConfigRes.body)}`); assert.equal(apiConfigRes.body.flag, 'success', `查询接口配置列表失败: ${JSON.stringify(apiConfigRes.body)}`); assert.equal(Number(apiConfigRes.body.code), 200, `查询接口配置列表 code 异常: ${JSON.stringify(apiConfigRes.body)}`); qimenConfig = pickEnabledQimenConfig(apiConfigRes.body?.data?.list); if (!qimenConfig || !String(qimenConfig.qimen_app_key || '').trim() || !String(qimenConfig.qimen_customer_id || '').trim() || !String(qimenConfig.qimen_warehouse_code || '').trim()) { this.skip(); return; } const stockSearchRes = await invokeSystemMethod('stock.warehouse.search', { keyword: '', store_id: FIXED_RELATION.storeId, with_stock: true, is_batch: false, }, switched.token, EXTRA_HEADERS); assert.equal(stockSearchRes.status, 200, `查询库存搜索 HTTP 状态异常: ${JSON.stringify(stockSearchRes.body)}`); assert.equal(stockSearchRes.body.flag, 'success', `查询库存搜索失败: ${JSON.stringify(stockSearchRes.body)}`); assert.equal(Number(stockSearchRes.body.code), 200, `查询库存搜索 code 异常: ${JSON.stringify(stockSearchRes.body)}`); stock = pickUsableStock(stockSearchRes.body?.data?.data || stockSearchRes.body?.data?.list || []); if (!stock) { this.skip(); return; } const nextPolicyConfig = { ...originalPolicyConfig, need_order_approval: 1, }; const savePolicyRes = await invokeSystemMethod('storeWarehouse.store.savePolicyConfig', { id: contractId, policy_config: nextPolicyConfig, }, switched.token, EXTRA_HEADERS); assert.equal(savePolicyRes.status, 200, `临时设置审核策略 HTTP 状态异常: ${JSON.stringify(savePolicyRes.body)}`); assert.equal(savePolicyRes.body.flag, 'success', `临时设置审核策略失败: ${JSON.stringify(savePolicyRes.body)}`); assert.equal(Number(savePolicyRes.body.code), 200, `临时设置审核策略 code 异常: ${JSON.stringify(savePolicyRes.body)}`); assert.equal(Number(savePolicyRes.body?.data?.policy_config?.need_order_approval || 0), 1, '临时策略必须把 need_order_approval 置为 1'); const receiverInfo = { name: '自动化测试收件人', mobile: '13800138000', province: '广东省', city: '广州市', area: '黄埔区', town: '知识城街道', detailAddress: `自动化测试地址 ${deliveryOrderCode}`, zipCode: '510000', }; const requestXml = buildDeliveryOrderXml({ deliveryOrderCode, warehouseCode: String(qimenConfig.qimen_warehouse_code || '').trim(), stock, planQty: 1, orderType: 'JYCK', receiverInfo, }); const createRes = await invokeQimenMethod('deliveryorder.create', requestXml, { appKey: String(qimenConfig.qimen_app_key || '').trim(), customerId: String(qimenConfig.qimen_customer_id || '').trim(), contentType: 'application/xml', format: 'xml', signMethod: 'md5', }); assert.equal(createRes.status, 200, `qimen 创建待审核订单 HTTP 状态异常: ${createRes.body}`); const createResponse = createRes.parsed?.response || createRes.parsed || {}; assert.equal(String(createResponse.flag || ''), 'success', `qimen 创建待审核订单失败。请求 XML:\n${requestXml}\n响应原文:\n${createRes.body}`); assert.match(String(createRes.body || ''), /deliveryOrderId|createTime|success/i, `qimen 创建响应缺少预期字段。请求 XML:\n${requestXml}\n响应原文:\n${createRes.body}`); const reviewListRes = await invokeSystemMethod('order.reviewOrder.list', { pagination: { page: 1, pageSize: 20, }, where: { delivery_order_code: deliveryOrderCode, }, }, switched.token, EXTRA_HEADERS); assert.equal(reviewListRes.status, 200, `待审核列表 HTTP 状态异常: ${JSON.stringify(reviewListRes.body)}`); assert.equal(reviewListRes.body.flag, 'success', `待审核列表查询失败: ${JSON.stringify(reviewListRes.body)}`); assert.equal(Number(reviewListRes.body.code), 200, `待审核列表 code 异常: ${JSON.stringify(reviewListRes.body)}`); const reviewItems = Array.isArray(reviewListRes.body?.data?.list) ? reviewListRes.body.data.list : []; const createdReviewOrder = reviewItems.find(item => String(item.delivery_order_code) === deliveryOrderCode); assert.ok(createdReviewOrder, `待审核列表未命中刚创建的订单。响应原文: ${JSON.stringify(reviewListRes.body)}`); assert.equal(Number(createdReviewOrder.step), 0, `新建订单应处于待审核 step=0。响应原文: ${JSON.stringify(reviewListRes.body)}`); const reviewActionRes = await invokeSystemMethod('order.reviewOrder.reviewOrder', { ids: [ Number(createdReviewOrder.id) ], }, switched.token, EXTRA_HEADERS); assert.equal(reviewActionRes.status, 200, `审核接口 HTTP 状态异常: ${JSON.stringify(reviewActionRes.body)}`); assert.equal(reviewActionRes.body.flag, 'success', `审核接口调用失败: ${JSON.stringify(reviewActionRes.body)}`); assert.equal(Number(reviewActionRes.body.code), 200, `审核接口 code 异常: ${JSON.stringify(reviewActionRes.body)}`); assert.equal(Number(reviewActionRes.body?.data?.step), 1, `审核后订单 step 应变为 1。响应原文: ${JSON.stringify(reviewActionRes.body)}`); const pendingListRes = await invokeSystemMethod('order.pendingOrder.list', { pagination: { page: 1, pageSize: 20, }, where: { delivery_order_code: deliveryOrderCode, }, }, switched.token, EXTRA_HEADERS); assert.equal(pendingListRes.status, 200, `待处理列表 HTTP 状态异常: ${JSON.stringify(pendingListRes.body)}`); assert.equal(pendingListRes.body.flag, 'success', `待处理列表查询失败: ${JSON.stringify(pendingListRes.body)}`); assert.equal(Number(pendingListRes.body.code), 200, `待处理列表 code 异常: ${JSON.stringify(pendingListRes.body)}`); const pendingItems = Array.isArray(pendingListRes.body?.data?.list) ? pendingListRes.body.data.list : []; const pendingOrder = pendingItems.find(item => String(item.delivery_order_code) === deliveryOrderCode); assert.ok(pendingOrder, `待处理列表未命中已审核订单。响应原文: ${JSON.stringify(pendingListRes.body)}`); assert.ok([ 1, 2 ].includes(Number(pendingOrder.step)), `审核后订单 step 应处于待处理范围。响应原文: ${JSON.stringify(pendingListRes.body)}`); const reviewAfterRes = await invokeSystemMethod('order.reviewOrder.list', { pagination: { page: 1, pageSize: 20, }, where: { delivery_order_code: deliveryOrderCode, }, }, switched.token, EXTRA_HEADERS); assert.equal(reviewAfterRes.status, 200, `复查待审核列表 HTTP 状态异常: ${JSON.stringify(reviewAfterRes.body)}`); assert.equal(reviewAfterRes.body.flag, 'success', `复查待审核列表失败: ${JSON.stringify(reviewAfterRes.body)}`); assert.equal(Number(reviewAfterRes.body.code), 200, `复查待审核列表 code 异常: ${JSON.stringify(reviewAfterRes.body)}`); const reviewAfterItems = Array.isArray(reviewAfterRes.body?.data?.list) ? reviewAfterRes.body.data.list : []; const reviewAfterOrder = reviewAfterItems.find(item => String(item.delivery_order_code) === deliveryOrderCode); assert.equal(reviewAfterOrder, undefined, `审核完成后不应再命中待审核列表。响应原文: ${JSON.stringify(reviewAfterRes.body)}`); } finally { if (contractId && originalPolicyConfig) { const restoreRes = await invokeSystemMethod('storeWarehouse.store.savePolicyConfig', { id: contractId, policy_config: originalPolicyConfig, }, switched.token, EXTRA_HEADERS); assert.equal(restoreRes.status, 200, `恢复原 policy_config 的 HTTP 状态异常: ${JSON.stringify(restoreRes.body)}`); assert.equal(restoreRes.body.flag, 'success', `恢复原 policy_config 失败: ${JSON.stringify(restoreRes.body)}`); assert.equal(Number(restoreRes.body.code), 200, `恢复原 policy_config code 异常: ${JSON.stringify(restoreRes.body)}`); } } }); });