2026-04-16 20:00:01 +08:00

92 lines
3.4 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');
/**
* 系统方法层:storage.inventory(库存操作接口包装层)。
* 职责:统一包装库存操作接口,调用底层 systems/storage/inventory service。
*/
class InventoryMethodService extends MainService {
constructor(ctx) {
super(ctx);
const _noNeedLogin = '';
const _noNeedRight = 'matchPutaway,list';
const _noNeedLog = 'list';
const _noNeedAuth = 'list';
this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth);
}
/**
* 收货单快捷入库上架。
* @param {Object} data 请求体
* @param {number} data.receiving_id 收货单ID
* @return {Promise<Object>} 统一 success 包装
*/
async quickPutaway(data = {}) {
const { service } = this;
const result = await service.systems.storage.inventory.quickPutaway(data);
return this.success('ok', result);
}
/**
* 匹配入库:收货单与入库单按商品匹配入库。
* @param {Object} data 请求体
* @param {number[]} data.receiving_ids 收货单ID列表
* @param {number[]} data.entry_order_ids 入库单ID列表
* @return {Promise<Object>} 统一 success 包装
*/
async matchPutaway(data = {}) {
const { service } = this;
const result = await service.systems.storage.inventory.matchPutaway(data);
return this.success('ok', result);
}
/**
* 移库(库位转移):将单条库存从一个库位移动到另一个库位。
* @param {Object} data 请求体
* @param {number} data.storage_id 库存记录ID(必填)
* @param {number} data.target_space_id 目标库位ID(必填)
* @param {number} [data.quantity] 移库数量(可选,默认全部移动)
* @return {Promise<Object>} 统一 success 包装
*/
async transferLocation(data = {}) {
const { service } = this;
const result = await service.systems.storage.inventory.transferLocation(data);
return this.success('ok', result);
}
/**
* 按库位+商品维度移库:自动查找该库位下该商品的所有库存记录,合并移动到目标库位。
* @param {Object} data 请求体
* @param {number} data.space_id 原库位ID(必填)
* @param {number} data.stock_id 商品SKU ID(必填)
* @param {number} data.target_space_id 目标库位ID(必填)
* @param {number} data.quantity 移库数量(必填)
* @return {Promise<Object>} 统一 success 包装
*/
async transferByProduct(data = {}) {
const { service } = this;
const result = await service.systems.storage.inventory.transferByProduct(data);
return this.success('ok', result);
}
/**
* 库存列表查询(查 wms_storage),支持 where 条件、分页、排序、批次分组。
* @param {Object} data 请求体
* @param {Object} [data.where] 查询条件
* @param {Object} [data.pagination] 分页参数 { page, pageSize }
* @param {Object} [data.sort] 排序参数 { sortField, sortOrder }
* @param {boolean} [data.group_by_batch=false] 是否按批次查询
* @return {Promise<Object>} 统一 success 包装
*/
async list(data = {}) {
const { service } = this;
const { pagination, sort, group_by_batch } = data;
this.prepareWhereContext(data);
const result = await service.systems.storage.inventory.getInventoryList(pagination, sort, group_by_batch);
return this.success('ok', result);
}
}
module.exports = InventoryMethodService;