'use strict'; const { applyStockChange } = require('./stockRecord'); /** * 完成入库:把「已推送(3)」的入库单置为「已完成(4)」,并按明细增加系统库存。 * - 幂等:已完成的单据直接返回成功(不重复加库存),供 WMS 回调重复推送时安全复用 * - 明细为空时拒绝,避免「空单据」走完流程却不产生任何库存 * - 行级库存类型:inventory_type=CC → product_stocks.item_type='CC',其余(ZP 等)归为正品 ZC * - 每次增加库存同步写一条 `stock_records` 出入库记录(biz_type=inbound_increase), * 记录本次入库数量与变动后总数量/锁定数量/可用数量 * 复用入口:① 控制器手工「完成」 ② WMS 回调 entryorder.confirm(外部回推驱动) * @param {Egg.Context} ctx * @param {Object} order 入库单 model 实例(需含 id / principal_id / status) * @return {Promise<{ok: boolean, already?: boolean, code?: number, message?: string}>} */ module.exports = async function completeInbound(ctx, order) { if (!order) return { ok: false, code: 404, message: '入库单不存在' }; // 幂等:已完成直接返回 if (order.status === 4) return { ok: true, already: true }; if (order.status !== 3) { return { ok: false, code: 400, message: '只有「已推送」状态的单据可以完成入库' }; } const items = await ctx.model.StockItem.findAll({ where: { bill_type: 1, bill_id: order.id, product_id: { [ctx.app.Sequelize.Op.ne]: null } }, attributes: [ 'product_id', 'code', 'name', 'quantity', 'inventory_type' ], order: [[ 'product_id', 'ASC' ]], }); if (!items.length) { return { ok: false, code: 400, message: '单据无明细,无法完成入库' }; } const transaction = await ctx.model.transaction(); try { for (const it of items) { const p = it.get ? it.get({ plain: true }) : it; // 行级库存类型:CC=残次 -> product_stocks 的 item_type='CC',其余(ZP等)归为正品 ZC const itemType = p.inventory_type === 'CC' ? 'CC' : 'ZC'; // 增加库存 + 写一条入库记录(recordStockChange 与库存变动同事务) await applyStockChange(ctx, { bizType: 'inbound_increase', principalId: order.principal_id, warehouseId: order.warehouse_id, productId: Number(p.product_id), itemCode: p.code, itemName: p.name, itemType, quantity: Number(p.quantity) || 0, billId: order.id, billNo: order.bill_no, remark: '入库确认增加库存', transaction, }); } await order.update({ status: 4 }, { transaction }); await transaction.commit(); return { ok: true }; } catch (err) { await transaction.rollback(); throw err; } };