263 lines
10 KiB
JavaScript
263 lines
10 KiB
JavaScript
'use strict';
|
||
const MainService = require('../../main');
|
||
/**
|
||
* 系统方法层:storage.entry(入库单相关接口包装层)。
|
||
* 主要职责:统一包装系统方法接口,处理权限、日志等公共逻辑,调用底层 service 实现业务功能。
|
||
* 注意:当前实现仅为包装层,实际业务逻辑完全依赖底层 service 的方法实现。
|
||
*/
|
||
class entryService extends MainService {
|
||
constructor(ctx) {
|
||
super(ctx);
|
||
const _noNeedLogin = '';
|
||
const _noNeedRight = 'list,get,cancel,completeEntry,getPrintData,getDirectInboundItems,addDirectInboundItem,commitDirectInbound,removeDirectInboundItem,quickInbound,receivingCompare';
|
||
const _noNeedLog = 'list,get,getPrintData';
|
||
const _noNeedAuth = 'list,get,cancel,completeEntry,getPrintData,getDirectInboundItems,addDirectInboundItem,commitDirectInbound,removeDirectInboundItem,bindReceivingDetails,quickInbound,receivingCompare';
|
||
this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth);
|
||
}
|
||
|
||
/**
|
||
* 入库单列表查询。
|
||
* @param {Object} data 请求体
|
||
* @param {Object} [data.pagination] 分页参数
|
||
* @param {Object} [data.where] 动态筛选条件
|
||
* @param {Object} [data.sort] 排序参数
|
||
* @return {Promise<Object>} 统一 success 包装
|
||
*/
|
||
async list(data = {}) {
|
||
const { service } = this;
|
||
const { pagination, sort } = data;
|
||
const { where } = this.prepareWhereContext(data, {
|
||
specialFieldMap: {
|
||
quickWhere: {
|
||
bucket: 'quick',
|
||
},
|
||
},
|
||
});
|
||
const result = await service.systems.storage.entry.list(where, pagination, sort);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 查询入库单详情。
|
||
* @param {Object} data 请求体
|
||
* @param {number} [data.id] 入库单ID
|
||
* @param {string} [data.entry_order_code] 入库单号
|
||
* @return {Promise<Object>} 统一 success 包装
|
||
*/
|
||
async get(data = {}) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.entry.get(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 作废入库单。
|
||
* 支持传入单个 id 或批量 ids,保持透传给业务层处理。
|
||
* @param {Object} data 请求体
|
||
* @param {number} [data.id] 单个入库单ID
|
||
* @param {number[]} [data.ids] 批量入库单ID数组
|
||
* @return {Promise<Object>} 统一 success 包装
|
||
*/
|
||
async cancel(data = {}) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.entry.cancel(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 完成入库单(纯状态变更,不写库存)。
|
||
* 仅校验状态=PENDING、有明细,然后将 order_status 更新为 COMPLETED。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.id 入库单ID
|
||
* @return {Promise<Object>} 统一 success 包装
|
||
*/
|
||
async completeEntry(data = {}) {
|
||
const { service } = this;
|
||
const { id } = data;
|
||
const result = await service.systems.storage.entry.completeEntry({ id });
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 获取入库单的导入/PDA 直接入库信息(从 storage.entry 模块暴露)。
|
||
* @param {Object} data 请求体
|
||
* @param {string} data.entry_order_code 入库单号
|
||
* @return {Promise<Object>} 统一 success 包装
|
||
*/
|
||
async getDirectInboundItems(data = {}) {
|
||
const { service } = this;
|
||
const { entry_order_code } = data || {};
|
||
const result = await service.systems.inboundDirectLog.getItems(entry_order_code);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 按商品增量添加导入/PDA 直接入库记录(从 storage.entry 模块暴露)。
|
||
* @param {Object} data 请求体
|
||
* @param {string} data.entry_order_code 入库单号
|
||
* @param {number} [data.stock_id] 商品SKU ID(单条模式)
|
||
* @param {number} [data.quantity] 本次入库数量(单条模式)
|
||
* @param {string} [data.inbound_type] 入库方式(单条模式)
|
||
* @param {Array} [data.items] 商品列表(批量模式)
|
||
* @return {Promise<Object>} 统一 success 包装
|
||
*/
|
||
async addDirectInboundItem(data = {}) {
|
||
const { service } = this;
|
||
const result = await service.systems.inboundDirectLog.addItem(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 提交确认完成导入/PDA 直接入库(从 storage.entry 模块暴露)。
|
||
* @param {Object} data 请求体
|
||
* @param {string} data.entry_order_code 入库单号
|
||
* @return {Promise<Object>} 统一 success 包装
|
||
*/
|
||
async commitDirectInbound(data = {}) {
|
||
const { service } = this;
|
||
const { entry_order_code } = data || {};
|
||
const result = await service.systems.inboundDirectLog.commit(entry_order_code);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 移除一条导入/PDA 直接入库记录(从 storage.entry 模块暴露)。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.id 入库记录ID
|
||
* @return {Promise<Object>} 统一 success 包装
|
||
*/
|
||
async removeDirectInboundItem(data = {}) {
|
||
const { service } = this;
|
||
const result = await service.systems.inboundDirectLog.removeItem(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 批量绑定入库单明细与收货单明细(system method 包装层)。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.entry_order_id 入库单ID
|
||
* @param {Array} data.bindings 绑定列表 [{ entry_item_id, receiving_detail_id, allocated_quantity }]
|
||
* @return {Promise<Object>} 统一 success 包装
|
||
*/
|
||
async bindReceivingDetails(data = {}) {
|
||
const { service } = this;
|
||
const { entry_order_id, bindings } = data || {};
|
||
const result = await service.systems.receiving_entry_match.bindReceivingDetails({ entry_order_id, bindings });
|
||
return this.success('绑定完成', result);
|
||
}
|
||
|
||
/**
|
||
* 快捷直入/虚拟入库(system method 包装层)。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.id 入库单ID
|
||
* @return {Promise<Object>} 统一 success 包装
|
||
*/
|
||
async quickInbound(data = {}) {
|
||
const { service } = this;
|
||
const { id } = data;
|
||
const result = await service.systems.storage.entry.quickInbound({ id });
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 获取入库单打印数据,按 RECEIPT 模板 field_code 映射返回。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.id 入库单ID
|
||
* @param {number} [data.warehouse_id] 仓库ID,不传则取当前用户仓库
|
||
* @return {Promise<Object>} 打印数据(扁平键值 + items 明细数组)
|
||
*/
|
||
async getPrintData(data = {}) {
|
||
const { ctx, service } = this;
|
||
const id = Number(data && data.id || 0);
|
||
if (!id) {
|
||
return this.fail('id 参数不能为空', { code: 400 });
|
||
}
|
||
|
||
try {
|
||
const entryResult = await service.systems.storage.entry.get({ id });
|
||
if (!entryResult || entryResult.code !== 200 || !entryResult.data || !entryResult.data.entryOrder) {
|
||
return this.fail('入库单不存在', { code: 404 });
|
||
}
|
||
|
||
const entryOrder = entryResult.data.entryOrder;
|
||
const items = Array.isArray(entryOrder.items) ? entryOrder.items : [];
|
||
|
||
// 查询商品条码和图片(复用 getStockDetails 缓存)
|
||
const barcodeMap = new Map();
|
||
const imageMap = new Map();
|
||
try {
|
||
const stockIds = items
|
||
.map(item => Number(item.stock_id || 0))
|
||
.filter(sid => sid > 0);
|
||
if (stockIds.length > 0) {
|
||
const stockDetails = await ctx.service.systems.stockWarehouse.getStockDetails(
|
||
stockIds,
|
||
{}
|
||
);
|
||
for (const detail of stockDetails) {
|
||
const sid = Number(detail.id);
|
||
// 提取条码
|
||
if (Array.isArray(detail.barcodes) && detail.barcodes.length > 0) {
|
||
barcodeMap.set(
|
||
sid,
|
||
detail.barcodes.map(bc => String(bc.barcode || '').trim()).filter(Boolean)
|
||
);
|
||
}
|
||
// 提取图片(有图片标记但实际 URL 需要额外查询)
|
||
if (detail.is_images === 'Y') {
|
||
imageMap.set(sid, '');
|
||
}
|
||
}
|
||
}
|
||
} catch (err) {
|
||
ctx.logger.warn('[entry.getPrintData] 查询商品详情失败: %s', err.message);
|
||
}
|
||
|
||
const printData = {
|
||
entry_order_code: entryOrder.entry_order_code || '',
|
||
order_type: entryOrder.order_type || '',
|
||
order_status: entryOrder.order_status || '',
|
||
purchase_order_code: entryOrder.purchase_order_code || '',
|
||
supplier_name: entryOrder.supplier_name || '',
|
||
warehouse_name: entryOrder.warehouse_name || '',
|
||
store_name: entryOrder.store_name || '',
|
||
logistics_name: entryOrder.logistics_name || '',
|
||
express_code: entryOrder.express_code || '',
|
||
order_create_time: entryOrder.order_create_time || '',
|
||
expect_start_time: entryOrder.expect_start_time || '',
|
||
remark: entryOrder.remark || '',
|
||
total_order_lines: entryOrder.total_order_lines || 0,
|
||
items: items.map(item => ({
|
||
items_col1: item.warehouse_item_code || item.external_item_code || '',
|
||
items_col2: item.warehouse_item_name || '',
|
||
items_col3: (barcodeMap.get(Number(item.stock_id)) || []).join(';') || '',
|
||
items_col4: item.count || 0,
|
||
items_col5: item.received_quantity || 0,
|
||
items_col6: item.inventory_type || '',
|
||
items_col7: imageMap.get(Number(item.stock_id)) || '',
|
||
})),
|
||
};
|
||
|
||
return this.success('ok', { data: printData, code: 200 });
|
||
} catch (error) {
|
||
ctx.logger.error('[entry.getPrintData] 获取入库单打印数据失败:', error);
|
||
return this.fail(error.message || '获取打印数据失败', { code: 500 });
|
||
}
|
||
}
|
||
/**
|
||
* 入库单商品与收货单商品逐行对照视图(system method 包装层)。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.entry_order_id 入库单ID
|
||
* @param {number} data.receiving_id 收货单ID
|
||
* @return {Promise<Object>} 统一 success 包装
|
||
*/
|
||
async receivingCompare(data = {}) {
|
||
const { service } = this;
|
||
const { entry_order_id, receiving_id } = data || {};
|
||
const result = await service.systems.storage.entry.receivingCompare({ entry_order_id, receiving_id });
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
}
|
||
module.exports = entryService;
|