'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} 创建结果,成功时返回 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} 查询结果,成功返回出库单详情,失败返回错误信息。 */ 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;