oms/backend/scripts/dgj-waybill-probe.js
liufumingren e0c718af8e fix(waybill): 快手取号补齐 key 与加密面单字段
- dgj: 抽取 contents[0].key;快手单 printinfo 取 encryptedData、encryptprintinfo 取逐单密钥(对齐菠萝派口径)
- waybillGet: deliveryorder.getwaybill 响应新增 key 字段并透传给 WMS
- 探测脚本输出 encryptprintinfo/key 长度;补充单测
- 更新 WMS-OMS 取号对接文档的快手字段说明

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 19:05:36 +08:00

323 lines
13 KiB
JavaScript
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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';
/**
* 店管家取号手工验证脚本(不参与线上流程)
*
* 默认只做「只读」步骤:查订单 → 查绑定 → 调店管家订单列表接口回读订单行 → 打印将要发送的取号报文。
* 只有显式加「--execute」才会真正调用 ExpressPrint(会消耗面单并产生费用);
* 真实取号默认开启,如需禁止(DGJ_WAYBILL_ENABLE=0)则脚本会拒绝执行。
*
* 用法:
* node scripts/dgj-waybill-probe.js --order dgj-10000266092590 --express STO
* node scripts/dgj-waybill-probe.js --order dgj-10000266092590 --express STO --execute
* node scripts/dgj-waybill-probe.js --order dgj-10000266092590 --express STO --execute --package-count 2
*/
const fs = require('fs');
const path = require('path');
const mm = require('egg-mock');
const { ORDER_TABLE_BY_STATUS } = require('../app/lib/orderStatus');
function readArg(name) {
const index = process.argv.indexOf(`--${name}`);
if (index > -1) return process.argv[index + 1];
const inline = process.argv.find(item => item.startsWith(`--${name}=`));
return inline ? inline.slice(name.length + 3) : '';
}
(async () => {
const orderNo = readArg('order');
const expressCode = readArg('express');
const execute = process.argv.includes('--execute');
const pkgIndexArg = readArg('pkg-index');
const packageCount = Number(readArg('package-count') || 0) || 0;
if (!orderNo || !expressCode) {
console.error('用法:node scripts/dgj-waybill-probe.js --order <OMS订单号> --express <快递编码> [--execute] [--pkg-index N] [--package-count N]');
process.exit(1);
}
// 包裹序号(0 基):默认取单号尾部 `_N`(N-1),显式传 --pkg-index 时以传参为准
const packageIndex = pkgIndexArg === '' ? null : Number(pkgIndexArg);
const app = mm.app();
await app.ready();
const ctx = app.mockContext();
const index = await ctx.model.OrderIndex.findOne({ where: { order_no: orderNo } });
if (!index) throw new Error(`未找到订单:${orderNo}`);
const order = await ctx.model[orderTableModel(app, index.current_status)].findByPk(index.id);
if (!order) throw new Error(`订单状态行不存在:${orderNo}(${index.current_status})`);
const shop = order.shop_id ? await ctx.model.Shop.findByPk(order.shop_id) : null;
if (!shop || Number(shop.type) !== 2 || !shop.external_print_account_id) {
throw new Error('订单店铺不是外部打单平台商家,无法取号');
}
const account = await ctx.model.ExternalPrintAccount.findByPk(shop.external_print_account_id, {
include: [{ model: ctx.model.ExternalPrintPlatform, as: 'platform' }],
});
if (!account || !account.platform) throw new Error('打单账号或平台配置不存在');
const platformCode = String(order.source_platform_code || '').trim();
const template = await ctx.service.externalPrintExpressInterface.resolveByCode(
account.id,
{ platformCode, expressCode },
order.principal_id
);
console.log('==== 订单 / 账号 / 绑定 ====');
console.log({
order_no: order.order_no,
parent_order_no: order.parent_order_no,
status: index.current_status,
platform_code: platformCode,
shop: { id: shop.id, name: shop.name, type: shop.type },
account: { id: account.id, account: account.account, platform: account.platform.code, fetch_waybill_no: account.platform.fetch_waybill_no },
express_code: expressCode,
template: template
? {
id: template.id,
template_id: template.template_id,
template_name: template.template_name,
platform_type: template.platform_type,
dbname: template.dbname,
express_company: `${template.express_company_code}(${template.express_company_name})`,
}
: null,
});
if (!template) {
console.log('\n❌ 该编码没有绑定快递接口,无法取号(先到「外部打单平台 → 快递接口」绑定)');
process.exit(0);
}
const service = ctx.service.externalPrintOrder.createPlatformService(account);
const detail = template.get ? template.get({ plain: true }) : template;
// 只读步骤:回读店管家订单行(不消耗面单)
let traceId = '';
try {
const info = await service.getUserInfo();
traceId = (info.data && info.data.TraceId) || '';
} catch (err) {
console.log(`⚠️ 获取 traceId 失败(不阻断):${err.message}`);
}
const logicalOrderId = String(order.parent_order_no || orderNo.replace(/^[^-]+-/, ''));
const platformOrderId = String((order.extend_props && order.extend_props.platform_order_no) || order.oaid_order_source_code || '');
console.log('\n==== 回读店管家订单行(只读) ====');
console.log({ logicalOrderId, platformOrderId, traceId: traceId ? '已获取' : '空' });
let row = null;
try {
row = await service.findPlatformOrderRow(service.constructor.resolveOrderHost(detail.platform_type), {
traceId,
dbname: detail.dbname,
logicalOrderId,
platformOrderId,
placeOrderTime: order.place_order_time || order.pay_time || order.created_at,
});
} catch (err) {
console.log(`❌ 回读订单行失败:${err.message}`);
}
if (!row) {
console.log('❌ 店管家未返回该订单行,取号会失败(检查系统编号/分区 dbname/登录态)');
process.exit(0);
}
console.log({
Id: row.Id,
LogicOrderId: row.LogicOrderId,
PlatformOrderId: row.PlatformOrderId,
ShopId: row.ShopId,
FxUserId: row.FxUserId,
ErpState: row.ErpState,
PrintState: row.PrintState,
ExpressPrintTimes: row.ExpressPrintTimes,
ExpressPrintTime: row.ExpressPrintTime,
LastWaybillCode: row.LastWaybillCode,
WaybillCodes: Array.isArray(row.WaybillCodes) ? `[] (${row.WaybillCodes.length} 个)` : row.WaybillCodes,
IsMultiPack: row.IsMultiPack,
SumPackageCount: row.SumPackageCount,
SubOrders: Array.isArray(row.SubOrders) ? row.SubOrders.length : 0,
});
// 组装「将要发送」的报文,方便手工核对(不发送)
const host = service.constructor.resolveOrderHost(detail.platform_type);
console.log('\n==== 平台已有运单号 ====');
console.log(row.LastWaybillCode
? `平台订单行已有运单号 ${row.LastWaybillCode}(仅用于对比:OMS 不再复用,真实取号会调 ExpressPrint 换新号)`
: '(平台无运单号,真实取号会调用 ExpressPrint,消耗面单)');
console.log(`打印状态 PrintState=${row.PrintState}、已打印 ${row.ExpressPrintTimes || 0} 次、` +
`WaybillCodes=${Array.isArray(row.WaybillCodes) ? row.WaybillCodes.length : 0} 个、IsMultiPack=${row.IsMultiPack}`);
if (Array.isArray(row.WaybillCodes) && row.WaybillCodes.length) {
console.log('WaybillCodes 明细:', JSON.stringify(row.WaybillCodes.map(code => ({
WaybillCode: code.WaybillCode,
WaybillCodeId: code.WaybillCodeId,
TemplateId: code.TemplateId,
CreateTime: code.CreateTime || code.WaybillCodeCreateDate,
}))));
}
console.log('(取号统一走「新单号打印」:PrintMethod=NewPrint + IsIgnoreWaybillRepeat=false,每次分配新号)');
const buildForm = service.constructor.buildForm;
const effectivePkgIndex = packageIndex === null
? (String(orderNo).match(/_(\d+)$/) ? Math.max(Number(String(orderNo).match(/_(\d+)$/)[1]) - 1, 0) : 0)
: packageIndex;
console.log(`\n包裹序号 = ${effectivePkgIndex}(仅留痕,不下发给平台:每次取号都会分配新号);PackageCount = ${packageCount || 1}`);
const checkForm = buildCheckForm(buildForm, detail.template_id, [ row ]);
const printForm = buildPrintForm(buildForm, detail.template_id, [ row ], { DateNow: '', DayPrintBatchNumber: '' }, packageCount || 1);
console.log('\n==== 将发送的 CheckTemplateAvaliable(只读接口) ====');
console.log(`POST https://${host}/TemplateSet/CheckTemplateAvaliable`);
console.log(checkForm);
console.log('\n==== 将发送的 ExpressPrint(会消耗面单) ====');
console.log(`POST https://${host}/NewOrder/ExpressPrint`);
console.log(printForm);
if (!execute) {
console.log('\n✅ 已完成只读校验,未调用取号接口。需要真实取号时执行:');
console.log(`node scripts/dgj-waybill-probe.js --order ${orderNo} --express ${expressCode} --execute [--package-count N]`);
process.exit(0);
}
if (!service.constructor.isWaybillEnabled()) {
console.log('\n❌ 当前已用 DGJ_WAYBILL_ENABLE=0 关闭真实取号,脚本拒绝执行;去掉该环境变量后再试');
process.exit(1);
}
console.log('\n⚠️ 即将真实取号(消耗面单)...');
const result = await service.fetchWaybillNo(order.get({ plain: true }), {
template: detail,
expressCode,
platformCode,
packageIndex: effectivePkgIndex,
packageCount: packageCount || 1,
});
const dir = path.join(__dirname, '..', 'tmp');
fs.mkdirSync(dir, { recursive: true });
const file = path.join(dir, `dgj-expressprint-${orderNo}-${Date.now()}.json`);
fs.writeFileSync(file, JSON.stringify(result.raw, null, 2), 'utf8');
console.log('==== 取号结果 ====');
console.log({
waybill_code: result.waybill_code,
waybill_codes: result.waybill_codes,
previous_code: result.previous_code || '',
printinfo_len: (result.printinfo || '').length,
printinfo_head: (result.printinfo || '').slice(0, 120),
signature: result.signature ? '已返回' : '无',
encryptprintinfo_len: (result.encryptprintinfo || '').length,
key_len: (result.key || '').length,
raw: file,
});
if (result.previous_code && result.previous_code === result.waybill_code) {
console.log(`⚠️ 本次调用 ExpressPrint,但平台仍返回原运单号 ${result.previous_code}(平台未换号)`);
}
})();
/**
* 状态 → 模型名
* @param {Object} app egg application
* @param {string} status 订单状态
* @return {string} 模型名
*/
function orderTableModel(app, status) {
const map = {
pending: 'OrderStatusPending',
queued: 'OrderStatusQueued',
exception: 'OrderStatusException',
outsourcing: 'OrderStatusOutsourcing',
delivery: 'OrderStatusDelivery',
void: 'OrderStatusVoid',
};
if (!map[status]) throw new Error(`未知订单状态:${status}(表 ${ORDER_TABLE_BY_STATUS[status] || '-'})`);
return map[status];
}
/**
* 组装 CheckTemplateAvaliable 表单(与 dgj.checkTemplateAvailable 同口径)
* @param {Object} buildForm 平台服务的表单构造器(PHP http_build_query 口径)
* @param {string} templateId 模板ID
* @param {Array} rows 平台订单行
* @return {string} 表单字符串
*/
function buildCheckForm(buildForm, templateId, rows) {
return buildForm({
templateId: String(templateId),
printCount: String(rows.length),
needCheck: 'true',
orders: rows.map(row => ({
SourceShopId: row.ShopId,
UpFxUserId: row.FxUserId,
SourceFxUserId: row.FxUserId,
LogicOrderId: row.LogicOrderId,
PlatformOrderId: row.LogicOrderId,
IsAllowNegativeStock: 'false',
SendType: row.SendState,
DataFlag: row.IsCold,
Items: (row.SubOrders || []).map(sub => ({
OrderItemCode: sub.OrderItemCode,
LogicOrderItemId: sub.OrderItemId,
Quantity: '1',
})),
})),
isResend: '',
pirntMethod: 'Normal',
IsContinueForStock: 'false',
IsCustomerOrder: 'false',
FxPageType: '2',
}).toString();
}
/**
* 组装 ExpressPrint 表单(仅用于打印核对)
* @param {Object} buildForm 平台服务的表单构造器(PHP http_build_query 口径)
* @param {string} templateId 模板ID
* @param {Array} rows 平台订单行
* @param {Object} checkData CheckTemplateAvaliable 的 Data
* @param {number} [packageCount] 包裹张数(>1 时把订单行重复 N 份,用于多包裹试验)
* @return {string} 表单字符串
*/
function buildPrintForm(buildForm, templateId, rows, checkData, packageCount = 1) {
const repeat = Number(packageCount) > 1 ? Math.floor(Number(packageCount)) : 1;
const sourceRows = [];
for (let i = 0; i < repeat; i += 1) sourceRows.push(...(rows || []));
return buildForm({
TemplateId: String(templateId),
PackageCount: String(repeat),
PackageDesc: '',
GoodsDesc: '',
PrintMethod: 'Normal',
IsIgnoreWaybillRepeat: 'true',
PrinterName: '默认打印机',
IsPreview: 'false',
IsContinueForStock: 'false',
PackageLength: '',
PackageWidth: '',
PackageHeight: '',
ExpressSustenance: { name: '', desc: '' },
Branches: '',
Orders: sourceRows.map((row, index) => ({
WaybillCodeId: '',
Index: index + 1,
Id: row.Id,
LogicOrderId: row.LogicOrderId,
PlatformOrderId: row.LogicOrderId,
CustomerOrderId: row.PlatformOrderId,
ShopId: row.ShopId,
PathFlowCode: row.PathFlowCode,
FxUserId: row.FxUserId,
WaybillCode: '',
Items: (row.SubOrders || []).map(sub => ({
OrderItemId: sub.OrderItemId,
OrderItemCode: sub.OrderItemCode,
Quantity: '1',
})),
})),
RequestBatchNumber: `1/1/${checkData.DateNow || ''}${checkData.DayPrintBatchNumber || ''}`,
IsCustomerOrder: 'false',
FxPageType: '2',
}).toString();
}