liufumingren 4b1e3aae7f refactor(stockout): 出库单 create/query 收敛到共享领域服务
- app/service/qimenMethods/stockout.js 瘦身为奇门适配层:
  create 委托 systems.stockoutOrder.create(sourceType=QM),query 直接 delegate
- 新增 app/service/openapiMethods/stockout.js:
  入参为 openapi 扁平结构 body.deliveryOrder / body.orderLines / body.deliveryOrderCode
  (query 兼容 deliveryOrder.deliveryOrderCode),create 传 sourceType=API,
  由共享层决定回传走 qimen confirm 还是 openapi 回调 stockout_completed
2026-09-13 15:31:05 +08:00

90 lines
2.7 KiB
JavaScript
Raw Permalink 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');
/**
* 开放 API 出库单适配层。
*
* 处理 openapi stockout.create / stockout.query,业务逻辑统一委托到
* `app/service/systems/stockout_order.js`(ctx.service.systems.stockoutOrder),
* 与 qimenMethods/stockout.js 共用同一份实现。
*
* 与奇门的差异:
* - 入参为开放 API 扁平结构(body.deliveryOrder / body.orderLines / body.deliveryOrderCode),
* 不像奇门那样包一层 request 节点;
* - 落库 source_type=API,出库单回传走 OpenAPI 回调(event=stockout.confirm);
* - 上下文(storeId/warehouseId/warehouseCode)由 openapiEntry 合约解析后注入。
*/
class OpenapiStockoutService extends MainService {
/**
* 创建出库单。
*
* @param {Object} payload 调用参数。
* @param {Object} payload.body 请求体数据,需包含 deliveryOrder 与 orderLines。
* @param {Object} payload.query 请求 query 数据。
* @return {Promise<Object>} 创建结果,成功时返回 stockoutOrderId/stockoutOrderCode,失败返回错误信息。
*/
async create(payload = {}) {
const { body = {} } = payload;
const { deliveryOrder, orderLines } = body;
if (!deliveryOrder || !deliveryOrder.deliveryOrderCode) {
return this.fail('deliveryOrder 参数缺失或不完整');
}
if (!orderLines) {
return this.fail('orderLines 参数缺失');
}
const info = this.getInfo();
return this.ctx.service.systems.stockoutOrder.create(
{
request: {
deliveryOrder,
orderLines,
},
},
{
storeId: info.storeId,
warehouseId: info.warehouseId,
warehouseCode: info.warehouseCode,
appKey: info.appKey,
sourceType: 'API',
}
);
}
/**
* 查询出库单。
*
* @param {Object} payload 调用参数。
* @param {Object} payload.body 请求体数据,需包含 deliveryOrderCode(兼容 deliveryOrder.deliveryOrderCode)。
* @param {Object} payload.query 请求 query 数据。
* @return {Promise<Object>} 查询结果,成功返回出库单详情,失败返回错误信息。
*/
async query(payload = {}) {
const { body = {} } = payload;
const deliveryOrderCode = String(
body.deliveryOrderCode
|| (body.deliveryOrder && body.deliveryOrder.deliveryOrderCode)
|| ''
).trim();
if (!deliveryOrderCode) {
return this.fail('deliveryOrderCode 参数缺失');
}
return this.ctx.service.systems.stockoutOrder.query({
request: {
deliveryOrder: {
deliveryOrderCode,
},
},
});
}
}
module.exports = OpenapiStockoutService;