- 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
90 lines
2.7 KiB
JavaScript
90 lines
2.7 KiB
JavaScript
'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;
|