liufumingren 77435aeb79 1
2026-06-23 18:48:33 +08:00

204 lines
6.8 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 MainService = require('../main');
/**
* OpenAPI 入库单服务。
* 对外提供入库单的创建与查询能力,通过 openapi 通道对接外部系统。
*/
class OpenapiEntryorderService extends MainService {
/**
* 通过 app_key 解析仓库与货主信息。
* 查询 ApiApp 并关联 StoreWarehouse 以获取 storeId、warehouseId。
* warehouseCode 优先使用 qimen_warehouse_code,为空时回退使用 warehouseId。
* @param {string} appKey 开放接口 app_key。
* @return {Promise<Object>} 包含 storeId、warehouseId、appKey、customerId、warehouseCode 的信息对象。
*/
async resolveAppInfo(appKey) {
const { ctx, app } = this;
const normalizedAppKey = String(appKey || '').trim();
if (!normalizedAppKey) {
throw new Error('app_key 缺失');
}
const appConfig = await ctx.model.ApiApp.findOne({
attributes: [
'id',
'warehouse_id',
'qimen_warehouse_code',
[ app.Sequelize.col('contract.store_id'), 'store_id' ],
],
where: {
self_app_key: normalizedAppKey,
is_enabled: 1,
},
include: [
{
model: ctx.model.StoreWarehouse,
as: 'contract',
attributes: [],
required: false,
},
],
raw: true,
});
if (!appConfig || !appConfig.warehouse_id) {
throw new Error(`无法解析仓库信息,请检查 app_key: ${normalizedAppKey}`);
}
const warehouseId = appConfig.warehouse_id;
return {
storeId: appConfig.store_id || null,
warehouseId,
appKey: normalizedAppKey,
customerId: null,
warehouseCode: appConfig.qimen_warehouse_code || String(warehouseId),
};
}
/**
* 创建入库单。
* 接收外部系统的入库单数据,校验后通过底层 entryOrder 服务完成入库单创建。
* @param {Object} payload 调用参数。
* @param {Object} payload.body 请求体数据,包含 entryOrder(入库单信息)和 orderLines(明细行)。
* @param {Object} payload.query 请求 query 数据,需包含 app_key。
* @return {Promise<Object>} 创建结果,成功时返回 entryOrderId、entryOrderCode、status 和 createTime。
*/
async create(payload = {}) {
const { body = {}, query = {} } = payload;
const { entryOrder, orderLines } = body;
if (!entryOrder || !entryOrder.entryOrderCode) {
return this.fail('entryOrder.entryOrderCode 参数缺失');
}
if (!orderLines || !orderLines.orderLine) {
return this.fail('orderLines.orderLine 参数缺失');
}
// 字段映射:OpenAPI 风格字段名 → 底层 tryCreateEntryOrder 期望的字段名
const mappedEntryOrder = {
entryOrderCode: entryOrder.entryOrderCode,
orderType: entryOrder.entryOrderType || entryOrder.orderType || 'SCRK',
expectStartTime: entryOrder.expectedArriveTime || entryOrder.expectStartTime || '',
expectEndTime: entryOrder.expectEndTime || '',
supplierCode: entryOrder.supplierCode || '',
supplierName: entryOrder.supplierName || '',
warehouseCode: entryOrder.warehouseCode || '',
ownerCode: entryOrder.ownerCode || '',
remark: entryOrder.remark || '',
totalOrderLines: entryOrder.totalOrderLines || 0,
operateTime: entryOrder.operateTime || '',
operatorName: entryOrder.operatorName || '',
orderCreateTime: entryOrder.orderCreateTime || entryOrder.createTime || '',
logisticsCode: entryOrder.logisticsCode || '',
logisticsName: entryOrder.logisticsName || '',
expressCode: entryOrder.expressCode || '',
relatedOrders: entryOrder.relatedOrders || undefined,
};
try {
const info = await this.resolveAppInfo(query.app_key);
this.setInfo(
info.storeId,
info.warehouseId,
info.appKey,
info.customerId,
info.warehouseCode
);
const data = {
request: {
entryOrder: mappedEntryOrder,
orderLines,
},
};
const res = await this.ctx.service.systems.entryOrder.addOrder(
data,
this.getInfo(),
'API'
);
if (res.success) {
return this.success(res.message, {
createTime: this.app.formatDate(new Date()),
entryOrderId: res.data.entryOrderId,
entryOrderCode: res.data.entryOrderCode,
status: res.data.status,
});
}
return this.fail(res.message, { createTime: this.app.formatDate(new Date()) });
} catch (error) {
return this.fail(`创建入库单失败: ${error.message}`);
}
}
/**
* 查询入库单。
* 根据入库单号查询入库单详情,包括基本信息与商品明细。
* @param {Object} payload 调用参数。
* @param {Object} payload.body 请求体数据,需包含 entryOrderCode(入库单号)。
* @param {Object} payload.query 请求 query 数据,需包含 app_key。
* @return {Promise<Object>} 查询结果,成功时返回入库单详情。
*/
async query(payload = {}) {
const { body = {}, query = {} } = payload;
const { entryOrderCode } = body;
if (!entryOrderCode) {
return this.fail('entryOrderCode 参数缺失');
}
try {
const info = await this.resolveAppInfo(query.app_key);
const order = await this.ctx.service.systems.entryOrder.findByOrderCode(
entryOrderCode,
info.warehouseId,
info.storeId
);
if (!order) {
return this.fail('未找到入库单');
}
const orderLines = (order.items || []).map(item => ({
itemId: item.stock_id,
itemCode: (item.stock && item.stock.item_code) || '',
itemName: (item.stock && item.stock.item_name) || '',
planQty: item.count,
actualQty: item.actual_qty || 0,
inventoryType: item.inventory_type || 'ZP',
orderLineNo: item.order_line_no || '',
remark: item.remark || '',
}));
return this.success('查询成功', {
entryOrderCode: order.entry_order_code,
entryOrderId: order.id,
status: order.order_status,
entryOrderType: order.order_type || 'SCRK',
expectedArriveTime: order.expected_arrive_time || '',
supplierCode: order.supplier_code || '',
supplierName: order.supplier_name || '',
remark: order.remark || '',
createTime: order.created_at || '',
operateTime: order.updated_at || '',
operatorName: order.operator_name || '',
warehouseCode: order.warehouse_code || info.warehouseCode,
ownerCode: order.store_code || '',
totalOrderLines: order.total_order_lines || 0,
orderLines,
});
} catch (error) {
return this.fail(`查询入库单失败: ${error.message}`);
}
}
}
module.exports = OpenapiEntryorderService;