package cn.iocoder.yudao.module.mes.service.wm.itemreceipt; import cn.hutool.core.collection.CollUtil; import cn.hutool.core.util.ObjUtil; import cn.hutool.core.util.StrUtil; import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper; import cn.iocoder.yudao.framework.common.exception.ServiceException; import cn.iocoder.yudao.framework.common.pojo.PageResult; import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils; import cn.iocoder.yudao.framework.common.util.object.BeanUtils; import cn.iocoder.yudao.framework.common.util.object.ObjectUtils; import cn.iocoder.yudao.module.mes.controller.admin.wm.batch.vo.MesWmBatchGenerateReqVO; import cn.iocoder.yudao.module.mes.controller.admin.wm.itemreceipt.vo.MesWmItemReceiptPageReqVO; import cn.iocoder.yudao.module.mes.controller.admin.wm.itemreceipt.vo.MesWmItemReceiptSaveReqVO; import cn.iocoder.yudao.module.mes.controller.admin.wm.itemreceipt.vo.detail.MesWmItemReceiptDetailSaveReqVO; import cn.iocoder.yudao.module.mes.dal.dataobject.wm.arrivalnotice.MesWmArrivalNoticeDO; import cn.iocoder.yudao.module.mes.dal.dataobject.wm.batch.MesWmBatchDO; import cn.iocoder.yudao.module.mes.dal.dataobject.wm.itemreceipt.MesWmItemReceiptDO; import cn.iocoder.yudao.module.mes.dal.dataobject.wm.itemreceipt.MesWmItemReceiptDetailDO; import cn.iocoder.yudao.module.mes.dal.dataobject.wm.itemreceipt.MesWmItemReceiptLineDO; import cn.iocoder.yudao.module.mes.dal.dataobject.wm.warehouse.MesWmWarehouseAreaDO; import cn.iocoder.yudao.module.mes.dal.dataobject.wm.warehouse.MesWmWarehouseDO; import cn.iocoder.yudao.module.mes.dal.dataobject.wm.warehouse.MesWmWarehouseLocationDO; import cn.iocoder.yudao.module.mes.dal.mysql.wm.itemreceipt.MesWmItemReceiptMapper; import cn.iocoder.yudao.module.mes.service.wm.batch.MesWmBatchService; import cn.iocoder.yudao.module.mes.service.wm.warehouse.MesWmWarehouseAreaService; import cn.iocoder.yudao.module.mes.service.wm.warehouse.MesWmWarehouseLocationService; import cn.iocoder.yudao.module.mes.service.wm.warehouse.MesWmWarehouseService; import cn.iocoder.yudao.module.mes.enums.MesBizTypeConstants; import cn.iocoder.yudao.module.mes.enums.wm.MesWmItemReceiptStatusEnum; import cn.iocoder.yudao.module.mes.enums.wm.MesWmTransactionTypeEnum; import cn.iocoder.yudao.module.bpm.enums.task.BpmTaskStatusEnum; import cn.iocoder.yudao.module.mes.service.qc.iqc.MesQcIqcService; import cn.iocoder.yudao.module.mes.service.wm.arrivalnotice.MesWmArrivalNoticeService; import cn.iocoder.yudao.module.mes.service.wm.arrivalnotice.MesWmArrivalNoticeLineService; import cn.iocoder.yudao.module.mes.dal.dataobject.wm.arrivalnotice.MesWmArrivalNoticeLineDO; import cn.iocoder.yudao.module.mes.service.wm.transaction.MesWmTransactionService; import cn.iocoder.yudao.module.mes.service.wm.transaction.dto.MesWmTransactionSaveReqDTO; import cn.iocoder.yudao.module.bpm.api.task.BpmProcessInstanceApi; import cn.iocoder.yudao.module.bpm.api.task.dto.BpmProcessInstanceCreateReqDTO; import cn.iocoder.yudao.module.bpm.service.definition.BpmProcessDefinitionService; import cn.iocoder.yudao.module.erp.api.purchase.ErpPurchaseOrderApi; import cn.iocoder.yudao.module.srm.api.supplier.SrmSupplierApi; import cn.iocoder.yudao.module.mdm.api.item.MdmItemApi; import cn.iocoder.yudao.module.mdm.api.item.dto.MdmItemRespDTO; import jakarta.annotation.Resource; import org.springframework.context.annotation.Lazy; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import org.springframework.validation.annotation.Validated; import org.flowable.engine.repository.ProcessDefinition; import lombok.extern.slf4j.Slf4j; import java.math.BigDecimal; import java.time.LocalDateTime; import java.util.Arrays; import java.util.Collection; import java.util.List; import java.util.Map; import java.util.Objects; import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception; import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList; import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId; import static cn.iocoder.yudao.module.mes.enums.ErrorCodeConstants.*; /** * MES 采购入库单 Service 实现类 */ @Service @Validated @Slf4j public class MesWmItemReceiptServiceImpl implements MesWmItemReceiptService { private static final String ITEM_RECEIPT_APPROVE_CATEGORY_CODE = "item_receipt_approve"; @Resource private MesWmItemReceiptMapper itemReceiptMapper; @Resource private MesWmItemReceiptLineService itemReceiptLineService; @Resource private MesWmItemReceiptDetailService itemReceiptDetailService; @Resource @Lazy private MesWmArrivalNoticeService arrivalNoticeService; @Resource @Lazy private SrmSupplierApi srmSupplierApi; @Resource @Lazy private MesQcIqcService iqcService; @Resource private MesWmTransactionService wmTransactionService; @Resource private MesWmArrivalNoticeLineService arrivalNoticeLineService; @Resource private BpmProcessInstanceApi processInstanceApi; @Resource private BpmProcessDefinitionService bpmProcessDefinitionService; @Resource private ErpPurchaseOrderApi purchaseOrderApi; @Resource private MdmItemApi mdmItemApi; @Resource private MesWmWarehouseService warehouseService; @Resource private MesWmWarehouseLocationService warehouseLocationService; @Resource private MesWmWarehouseAreaService warehouseAreaService; @Resource private MesWmBatchService batchService; @Override public Long createItemReceipt(MesWmItemReceiptSaveReqVO createReqVO) { // 校验数据 validateItemReceiptSaveData(createReqVO); // 插入 MesWmItemReceiptDO receipt = BeanUtils.toBean(createReqVO, MesWmItemReceiptDO.class); receipt.setStatus(MesWmItemReceiptStatusEnum.PREPARE.getStatus()); itemReceiptMapper.insert(receipt); return receipt.getId(); } @Override public void updateItemReceipt(MesWmItemReceiptSaveReqVO updateReqVO) { // 校验存在 + 草稿状态 validateItemReceiptExistsAndDraft(updateReqVO.getId()); // 校验数据 validateItemReceiptSaveData(updateReqVO); // 更新 MesWmItemReceiptDO updateObj = BeanUtils.toBean(updateReqVO, MesWmItemReceiptDO.class); itemReceiptMapper.updateById(updateObj); } private void validateItemReceiptSaveData(MesWmItemReceiptSaveReqVO reqVO) { // 校验编码唯一 validateCodeUnique(reqVO.getId(), reqVO.getCode()); // 校验供应商存在(采购入库使用 ERP 供应商) srmSupplierApi.getSupplier(reqVO.getVendorId()); // 校验到货通知单存在 if (reqVO.getNoticeId() != null) { MesWmArrivalNoticeDO notice = arrivalNoticeService.validateArrivalNoticeReadyForReceipt(reqVO.getNoticeId()); if (ObjUtil.notEqual(notice.getVendorId(), reqVO.getVendorId())) { throw exception(WM_ARRIVAL_NOTICE_VENDOR_MISMATCH); } } // 校验来料检验单存在 if (reqVO.getIqcId() != null) { iqcService.validateIqcExists(reqVO.getIqcId()); } } @Override @Transactional(rollbackFor = Exception.class) public void deleteItemReceipt(Long id) { // 校验存在 + 草稿状态 validateItemReceiptExistsAndDraft(id); // 级联删除明细和行 itemReceiptDetailService.deleteItemReceiptDetailByReceiptId(id); itemReceiptLineService.deleteItemReceiptLineByReceiptId(id); // 删除 itemReceiptMapper.deleteById(id); } @Override public MesWmItemReceiptDO getItemReceipt(Long id) { return itemReceiptMapper.selectById(id); } @Override public PageResult getItemReceiptPage(MesWmItemReceiptPageReqVO pageReqVO) { return itemReceiptMapper.selectPage(pageReqVO); } @Override @Transactional(rollbackFor = Exception.class) public void submitItemReceipt(Long id) { // 校验存在 + 草稿状态 validateItemReceiptExistsAndDraft(id); // 校验至少有一条行 List lines = itemReceiptLineService.getItemReceiptLineListByReceiptId(id); if (CollUtil.isEmpty(lines)) { throw exception(WM_ITEM_RECEIPT_NO_LINE); } // 校验物料批次管理:如果物料开启批次管理,则明细的批次号不能为空 validateBatchManagement(lines); // 提交(草稿 → 待上架) itemReceiptMapper.updateById(new MesWmItemReceiptDO() .setId(id).setStatus(MesWmItemReceiptStatusEnum.APPROVING.getStatus())); } /** * 校验物料批次管理:如果物料开启批次管理,则行的批次号不能为空 */ private void validateBatchManagement(List lines) { // 获取所有物料ID List itemIds = CollectionUtils.convertList(lines, MesWmItemReceiptLineDO::getItemId); Map itemMap = mdmItemApi.getItemMap(itemIds); // 遍历每一行,检查物料是否开启批次管理 for (MesWmItemReceiptLineDO line : lines) { MdmItemRespDTO item = itemMap.get(line.getItemId()); if (item == null) { continue; } // 如果物料开启批次管理,检查行上的批次号是否为空 if (Boolean.TRUE.equals(item.getIsBatchManaged()) && line.getBatchId() == null) { throw exception(WM_ITEM_RECEIPT_BATCH_REQUIRED, item.getCode(), item.getName()); } } } @Override @Transactional(rollbackFor = Exception.class) public void stockItemReceipt(Long id) { // 校验存在 MesWmItemReceiptDO receipt = validateItemReceiptExists(id); if (ObjUtil.notEqual(MesWmItemReceiptStatusEnum.APPROVING.getStatus(), receipt.getStatus())) { throw exception(WM_ITEM_RECEIPT_STATUS_ERROR); } // 校验每行明细数量之和是否等于行入库数量 List lines = itemReceiptLineService.getItemReceiptLineListByReceiptId(id); if (CollUtil.isEmpty(lines)) { throw exception(WM_ITEM_RECEIPT_NO_LINE); } for (MesWmItemReceiptLineDO line : lines) { List details = itemReceiptDetailService.getItemReceiptDetailListByLineId(line.getId()); BigDecimal totalDetailQty = CollectionUtils.getSumValue(details, MesWmItemReceiptDetailDO::getQuantity, BigDecimal::add, BigDecimal.ZERO); if (line.getReceivedQuantity() == null || totalDetailQty.compareTo(line.getReceivedQuantity()) != 0) { throw exception(WM_ITEM_RECEIPT_DETAIL_QUANTITY_MISMATCH); } } // 执行上架(待上架 → 待入库) itemReceiptMapper.updateById(new MesWmItemReceiptDO() .setId(id).setStatus(MesWmItemReceiptStatusEnum.APPROVED.getStatus())); } @Override @Transactional(rollbackFor = Exception.class) @Deprecated public void finishItemReceipt(Long id) { // 1. 校验存在 MesWmItemReceiptDO receipt = validateItemReceiptExists(id); if (ObjUtil.notEqual(MesWmItemReceiptStatusEnum.APPROVED.getStatus(), receipt.getStatus())) { throw exception(WM_ITEM_RECEIPT_STATUS_ERROR); } // 2. 完成入库(库存事务 + 状态 + 到货通知 + 采购订单回写) completeItemReceipt(receipt); } @Override @Transactional(rollbackFor = Exception.class) public void confirmItemReceipt(Long id, Long warehouseId, Long locationId, Long areaId) { // 1. 校验单据存在 MesWmItemReceiptDO receipt = validateItemReceiptExists(id); // 2. 校验状态:草稿、旧流程的待上架(且不在 BPM 审批中)、待执行入库 均允许确认 validateItemReceiptConfirmable(receipt); // 3. 校验行 List lines = itemReceiptLineService.getItemReceiptLineListByReceiptId(id); if (CollUtil.isEmpty(lines)) { throw exception(WM_ITEM_RECEIPT_NO_LINE); } // 4. 校验入库位置(仓库 / 库区 / 库位)的层级关系 validateConfirmLocation(receipt.getCode(), warehouseId, locationId, areaId); // 5. 逐行校验入库数量,并为启用批次管理但还没批次的物料补齐批次 Map itemMap = mdmItemApi.getItemMap( convertList(lines, MesWmItemReceiptLineDO::getItemId)); for (MesWmItemReceiptLineDO line : lines) { validateConfirmLineQuantity(receipt.getCode(), line, itemMap); fillLineBatch(receipt, line, itemMap); } // 6. 补齐上架明细:没有明细的行按“行入库数量 + 所选位置”生成一条;已有明细的保持原样 createDetailsForConfirm(receipt, lines, warehouseId, locationId, areaId); // 7. 完成入库(库存事务 + 状态 + 到货通知 + 采购订单回写) completeItemReceipt(receipt); } /** * 完成入库:创建库存事务、更新单据与关联单据状态 */ private void completeItemReceipt(MesWmItemReceiptDO receipt) { // 1. 遍历所有明细,创建库存事务(增加库存 + 记录流水) createTransactionList(receipt); // 2. 更新入库单状态 itemReceiptMapper.updateById(new MesWmItemReceiptDO() .setId(receipt.getId()).setStatus(MesWmItemReceiptStatusEnum.FINISHED.getStatus())); // 3. 更新关联的到货通知单状态 if (receipt.getNoticeId() != null) { arrivalNoticeService.finishArrivalNotice(receipt.getNoticeId()); } // 4. 回写 ERP 采购订单的入库数量 updateErpPurchaseOrderInCount(receipt); } /** * 校验采购入库单是否允许确认入库 * * 草稿(新流程)、旧流程的待上架(无 BPM 审批)、待执行入库(旧流程已上架)都允许; * 审批中的单据必须等审批结束,已完成/已取消的不允许。 */ private void validateItemReceiptConfirmable(MesWmItemReceiptDO receipt) { MesWmItemReceiptStatusEnum status = Arrays.stream(MesWmItemReceiptStatusEnum.values()) .filter(item -> ObjUtil.equal(item.getStatus(), receipt.getStatus())) .findFirst().orElse(null); String statusName = status != null ? status.getName() : String.valueOf(receipt.getStatus()); // 1. BPM 审批中的单据不允许直接入库,否则会绕过审批 if (ObjUtil.equal(MesWmItemReceiptStatusEnum.APPROVING.getStatus(), receipt.getStatus()) && StrUtil.isNotBlank(receipt.getProcessInstanceId())) { throw new ServiceException(WM_ITEM_RECEIPT_CONFIRM_STATUS_ERROR.getCode(), "采购入库单[" + receipt.getCode() + "]正在审批中(当前状态:" + statusName + "),不能确认入库。" + "请等待审批通过后再确认入库;若审批已驳回,请按审批意见修改后重新提交。"); } // 2. 已完成 / 已取消不允许重复确认 if (ObjUtil.equal(MesWmItemReceiptStatusEnum.FINISHED.getStatus(), receipt.getStatus()) || ObjUtil.equal(MesWmItemReceiptStatusEnum.CANCELED.getStatus(), receipt.getStatus())) { throw new ServiceException(WM_ITEM_RECEIPT_CONFIRM_STATUS_ERROR.getCode(), "采购入库单[" + receipt.getCode() + "]当前状态为[" + statusName + "],不能确认入库。" + "只有草稿、待上架或待执行入库的单据可以确认入库,请刷新列表确认单据状态。"); } } /** * 校验确认入库时选择的仓库 / 库区 / 库位 */ private void validateConfirmLocation(String receiptCode, Long warehouseId, Long locationId, Long areaId) { if (warehouseId == null || locationId == null || areaId == null) { throw new ServiceException(WM_ITEM_RECEIPT_CONFIRM_LOCATION_REQUIRED.getCode(), "采购入库单[" + receiptCode + "]确认入库前必须选择入库仓库、库区和库位(当前" + "仓库=" + (warehouseId != null ? warehouseId : "未选择") + ",库区=" + (locationId != null ? locationId : "未选择") + ",库位=" + (areaId != null ? areaId : "未选择") + ")。请点击「确认入库」,在弹窗中依次选择仓库、库区、库位后重新提交。"); } MesWmWarehouseDO warehouse = warehouseService.getWarehouse(warehouseId); if (warehouse == null) { throw new ServiceException(WM_ITEM_RECEIPT_CONFIRM_LOCATION_REQUIRED.getCode(), "所选入库仓库(ID=" + warehouseId + ")不存在或已被删除,无法确认入库。" + "请刷新页面后重新选择仓库、库区、库位。"); } MesWmWarehouseLocationDO location = warehouseLocationService.getWarehouseLocation(locationId); if (location == null) { throw new ServiceException(WM_ITEM_RECEIPT_CONFIRM_LOCATION_REQUIRED.getCode(), "所选入库库区(ID=" + locationId + ")不存在或已被删除,无法确认入库。" + "请刷新页面后重新选择仓库、库区、库位。"); } MesWmWarehouseAreaDO area = warehouseAreaService.getWarehouseArea(areaId); if (area == null) { throw new ServiceException(WM_ITEM_RECEIPT_CONFIRM_LOCATION_REQUIRED.getCode(), "所选入库库位(ID=" + areaId + ")不存在或已被删除,无法确认入库。" + "请刷新页面后重新选择仓库、库区、库位。"); } // 仓库 → 库区 → 库位 的层级必须一致 if (ObjUtil.notEqual(location.getWarehouseId(), warehouse.getId())) { MesWmWarehouseDO locationWarehouse = warehouseService.getWarehouse(location.getWarehouseId()); throw new ServiceException(WM_ITEM_RECEIPT_CONFIRM_LOCATION_MISMATCH.getCode(), "入库仓库与库区不匹配:所选仓库[" + warehouse.getName() + "],库区[" + location.getName() + "]属于仓库[" + (locationWarehouse != null ? locationWarehouse.getName() : "ID=" + location.getWarehouseId()) + "]。请重新选择同一仓库下的库区。"); } if (ObjUtil.notEqual(area.getLocationId(), location.getId())) { MesWmWarehouseLocationDO areaLocation = warehouseLocationService.getWarehouseLocation(area.getLocationId()); throw new ServiceException(WM_ITEM_RECEIPT_CONFIRM_LOCATION_MISMATCH.getCode(), "入库库区与库位不匹配:所选库区[" + location.getName() + "],库位[" + area.getName() + "]属于库区[" + (areaLocation != null ? areaLocation.getName() : "ID=" + area.getLocationId()) + "]。请重新选择同一库区下的库位。"); } } /** * 校验单行入库数量 */ private void validateConfirmLineQuantity(String receiptCode, MesWmItemReceiptLineDO line, Map itemMap) { if (line.getReceivedQuantity() != null && line.getReceivedQuantity().compareTo(BigDecimal.ZERO) > 0) { return; } MdmItemRespDTO item = itemMap.get(line.getItemId()); String itemText = item != null ? item.getCode() + " " + item.getName() : "ID=" + line.getItemId(); throw new ServiceException(WM_ITEM_RECEIPT_CONFIRM_QUANTITY_INVALID.getCode(), "采购入库单[" + receiptCode + "]的物料行[" + itemText + "]入库数量为[" + (line.getReceivedQuantity() != null ? line.getReceivedQuantity().toPlainString() : "空") + "],必须大于 0 才能入库。请编辑该物料行,核对并填写实际收货数量后重试。"); } /** * 为启用批次管理但还没有批次的物料行补齐批次 * * 由到货通知单生成的入库行不会预先生成批次,这里在确认入库时统一生成, * 避免库管逐行打开物料行保存一次。 */ private void fillLineBatch(MesWmItemReceiptDO receipt, MesWmItemReceiptLineDO line, Map itemMap) { MdmItemRespDTO item = itemMap.get(line.getItemId()); if (item == null || !Boolean.TRUE.equals(item.getIsBatchManaged()) || line.getBatchId() != null) { return; } MesWmBatchGenerateReqVO batchReqVO = new MesWmBatchGenerateReqVO(); batchReqVO.setItemId(line.getItemId()).setProduceDate(line.getProductionDate()) .setExpireDate(line.getExpireDate()).setLotNumber(line.getLotNumber()) .setVendorId(receipt.getVendorId()).setReceiptDate(receipt.getReceiptDate()) .setPurchaseOrderCode(receipt.getPurchaseOrderCode()); MesWmBatchDO batch; try { batch = batchService.getOrGenerateBatchCode(batchReqVO); } catch (ServiceException ex) { // 批次配置要求的字段(生产日期、有效期、生产批号等)没有填:把行上下文补进提示 throw new ServiceException(WM_ITEM_RECEIPT_CONFIRM_BATCH_GENERATE_FAILED.getCode(), "物料[" + item.getCode() + " " + item.getName() + "]生成批次失败:" + ex.getMessage() + "。请编辑采购入库单里该物料的物料行,补充批次要求的字段(生产日期、有效期、生产批号)后重试。"); } if (batch == null) { return; } line.setBatchId(batch.getId()).setBatchCode(batch.getCode()); itemReceiptLineService.updateItemReceiptLineBatch(line.getId(), batch.getId(), batch.getCode()); } /** * 确认入库时补齐上架明细:没有明细的行按行入库数量生成一条明细,已有明细的校验数量合计 */ private void createDetailsForConfirm(MesWmItemReceiptDO receipt, List lines, Long warehouseId, Long locationId, Long areaId) { for (MesWmItemReceiptLineDO line : lines) { List details = itemReceiptDetailService .getItemReceiptDetailListByLineId(line.getId()); if (CollUtil.isEmpty(details)) { // 旧流程“待执行入库”的单据应当已经有上架明细,缺了说明数据不完整 if (ObjUtil.equal(MesWmItemReceiptStatusEnum.APPROVED.getStatus(), receipt.getStatus())) { throw new ServiceException(WM_ITEM_RECEIPT_CONFIRM_DETAIL_MISSING.getCode(), "采购入库单[" + receipt.getCode() + "]处于旧流程的「待执行入库」状态,但物料行(ID=" + line.getId() + ")没有上架明细,无法确认入库。" + "请将该单据取消后重新生成,或联系管理员补齐上架明细。"); } MesWmItemReceiptDetailSaveReqVO detailReqVO = new MesWmItemReceiptDetailSaveReqVO(); detailReqVO.setReceiptId(receipt.getId()).setLineId(line.getId()) .setItemId(line.getItemId()).setQuantity(line.getReceivedQuantity()) .setBatchId(line.getBatchId()) .setWarehouseId(warehouseId).setLocationId(locationId).setAreaId(areaId); itemReceiptDetailService.createItemReceiptDetail(detailReqVO); continue; } // 已有上架明细(旧流程):数量合计必须与行入库数量一致 BigDecimal totalDetailQty = CollectionUtils.getSumValue(details, MesWmItemReceiptDetailDO::getQuantity, BigDecimal::add, BigDecimal.ZERO); if (line.getReceivedQuantity() == null || totalDetailQty.compareTo(line.getReceivedQuantity()) != 0) { MdmItemRespDTO item = mdmItemApi.getItem(line.getItemId()).getCheckedData(); String itemText = item != null ? item.getCode() + " " + item.getName() : "ID=" + line.getItemId(); throw new ServiceException(WM_ITEM_RECEIPT_DETAIL_QUANTITY_MISMATCH.getCode(), "采购入库单[" + receipt.getCode() + "]的物料行[" + itemText + "]上架明细数量合计为[" + totalDetailQty.toPlainString() + "],与行入库数量[" + (line.getReceivedQuantity() != null ? line.getReceivedQuantity().toPlainString() : "空") + "]不一致,无法确认入库。请在物料行上核对入库数量,或取消该单据后按简化流程重新生成。"); } } } /** * 回写 ERP 采购订单的入库数量 */ private void updateErpPurchaseOrderInCount(MesWmItemReceiptDO receipt) { // 1. 确定采购订单 ID:优先从入库单头取(从到货通知单带入),其次从行反查 Long purchaseOrderId = receipt.getPurchaseOrderId(); if (purchaseOrderId == null && receipt.getNoticeId() != null) { // 从关联的到货通知单获取采购订单 ID MesWmArrivalNoticeDO notice = arrivalNoticeService.getArrivalNotice(receipt.getNoticeId()); if (notice != null) { purchaseOrderId = notice.getPurchaseOrderId(); } } // 2. 获取入库单行,按 purchaseOrderItemId 更新入库数量 List lines = itemReceiptLineService.getItemReceiptLineListByReceiptId(receipt.getId()); if (CollUtil.isNotEmpty(lines)) { for (MesWmItemReceiptLineDO line : lines) { if (line.getPurchaseOrderItemId() != null && line.getReceivedQuantity() != null) { purchaseOrderApi.updateOrderItemInCount(line.getPurchaseOrderItemId(), line.getReceivedQuantity()); // 如果还没拿到 purchaseOrderId,从明细项反查 if (purchaseOrderId == null) { cn.iocoder.yudao.module.erp.api.purchase.dto.ErpPurchaseOrderItemRespDTO itemDTO = purchaseOrderApi.getPurchaseOrderItem(line.getPurchaseOrderItemId()).getCheckedData(); if (itemDTO != null && itemDTO.getOrderId() != null) { purchaseOrderId = itemDTO.getOrderId(); } } } } } else if (receipt.getNoticeId() != null) { // 兜底:入库行为空时,从到货通知单行回写入库数量 List noticeLines = arrivalNoticeLineService .getArrivalNoticeLineListByNoticeId(receipt.getNoticeId()); for (MesWmArrivalNoticeLineDO noticeLine : noticeLines) { if (noticeLine.getPurchaseOrderItemId() != null) { // 使用合格数量(有 IQC 时为合格数量,否则为到货数量) BigDecimal qty = noticeLine.getQualifiedQuantity() != null ? noticeLine.getQualifiedQuantity() : noticeLine.getArrivalQuantity(); if (qty != null && qty.compareTo(BigDecimal.ZERO) > 0) { purchaseOrderApi.updateOrderItemInCount(noticeLine.getPurchaseOrderItemId(), qty); } } } } // 3. 更新采购订单的入库状态 if (purchaseOrderId != null) { purchaseOrderApi.updateOrderInStatus(purchaseOrderId); } } private void createTransactionList(MesWmItemReceiptDO receipt) { List details = itemReceiptDetailService.getItemReceiptDetailListByReceiptId(receipt.getId()); // 获取所有行信息,用于获取批次号 List lines = itemReceiptLineService.getItemReceiptLineListByReceiptId(receipt.getId()); Map lineMap = CollectionUtils.convertMap(lines, MesWmItemReceiptLineDO::getId); wmTransactionService.createTransactionList(convertList(details, detail -> { // 从行上获取批次信息(如果明细没有批次号) MesWmItemReceiptLineDO line = lineMap.get(detail.getLineId()); Long batchId = detail.getBatchId() != null ? detail.getBatchId() : (line != null ? line.getBatchId() : null); String batchCode = line != null ? line.getBatchCode() : null; return new MesWmTransactionSaveReqDTO() .setType(MesWmTransactionTypeEnum.IN.getType()).setItemId(detail.getItemId()) .setQuantity(detail.getQuantity()) .setBatchId(batchId).setBatchCode(batchCode) .setWarehouseId(detail.getWarehouseId()).setLocationId(detail.getLocationId()).setAreaId(detail.getAreaId()) .setVendorId(receipt.getVendorId()).setReceiptTime(receipt.getReceiptDate()) .setBizType(MesBizTypeConstants.WM_ITEM_RECEIPT_IN).setBizId(receipt.getId()) .setBizCode(receipt.getCode()).setBizLineId(detail.getLineId()); })); } @Override @Transactional(rollbackFor = Exception.class) public void cancelItemReceipt(Long id) { // 校验存在 MesWmItemReceiptDO receipt = validateItemReceiptExists(id); // 已完成和已取消不允许取消 if (ObjectUtils.equalsAny(receipt.getStatus(), MesWmItemReceiptStatusEnum.FINISHED.getStatus(), MesWmItemReceiptStatusEnum.CANCELED.getStatus())) { throw exception(WM_ITEM_RECEIPT_CANCEL_NOT_ALLOWED); } // 取消 itemReceiptMapper.updateById(new MesWmItemReceiptDO() .setId(id).setStatus(MesWmItemReceiptStatusEnum.CANCELED.getStatus())); } @Override public MesWmItemReceiptDO validateItemReceiptEditable(Long id) { MesWmItemReceiptDO receipt = validateItemReceiptExists(id); if (ObjUtil.notEqual(receipt.getStatus(), MesWmItemReceiptStatusEnum.PREPARE.getStatus()) && ObjUtil.notEqual(receipt.getStatus(), MesWmItemReceiptStatusEnum.APPROVING.getStatus())) { throw exception(WM_ITEM_RECEIPT_STATUS_NOT_PREPARE); } return receipt; } private MesWmItemReceiptDO validateItemReceiptExists(Long id) { MesWmItemReceiptDO receipt = itemReceiptMapper.selectById(id); if (receipt == null) { throw exception(WM_ITEM_RECEIPT_NOT_EXISTS); } return receipt; } /** * 校验采购入库单存在且为草稿状态 */ private MesWmItemReceiptDO validateItemReceiptExistsAndDraft(Long id) { MesWmItemReceiptDO receipt = validateItemReceiptExists(id); if (ObjUtil.notEqual(MesWmItemReceiptStatusEnum.PREPARE.getStatus(), receipt.getStatus())) { throw exception(WM_ITEM_RECEIPT_STATUS_NOT_PREPARE); } return receipt; } private void validateCodeUnique(Long id, String code) { MesWmItemReceiptDO receipt = itemReceiptMapper.selectByCode(code); if (receipt == null) { return; } if (ObjUtil.notEqual(id, receipt.getId())) { throw exception(WM_ITEM_RECEIPT_CODE_DUPLICATE); } } @Override public Long getItemReceiptCountByVendorId(Long vendorId) { return itemReceiptMapper.selectCountByVendorId(vendorId); } @Override public List getItemReceiptListByVendorId(Long vendorId) { return itemReceiptMapper.selectListByVendorId(vendorId); } @Override public List getItemReceiptList(Collection ids) { return itemReceiptMapper.selectByIds(ids); } @Override @Transactional(rollbackFor = Exception.class) public Long generateItemReceiptFromArrivalNotice(Long arrivalNoticeId) { // 1. 校验到货通知单存在且状态为待入库 MesWmArrivalNoticeDO notice = arrivalNoticeService.validateArrivalNoticeReadyForReceipt(arrivalNoticeId); // 2. 校验是否已生成过入库单(防止重复生成) MesWmItemReceiptDO existReceipt = itemReceiptMapper.selectByNoticeId(arrivalNoticeId); if (existReceipt != null) { throw exception(WM_ITEM_RECEIPT_ALREADY_EXISTS); } // 3. 获取到货通知单行 List lines = arrivalNoticeLineService.getArrivalNoticeLineListByNoticeId(arrivalNoticeId); if (CollUtil.isEmpty(lines)) { throw exception(WM_ARRIVAL_NOTICE_NO_LINE); } // 4. 生成入库单编码 String code = generateItemReceiptCode(); // 5. 创建入库单主表 MesWmItemReceiptDO receipt = new MesWmItemReceiptDO(); receipt.setCode(code); receipt.setName(notice.getName() + "入库单"); receipt.setNoticeId(arrivalNoticeId); receipt.setPurchaseOrderId(notice.getPurchaseOrderId()); receipt.setPurchaseOrderCode(notice.getPurchaseOrderCode()); receipt.setVendorId(notice.getVendorId()); receipt.setReceiptDate(java.time.LocalDateTime.now()); // 入库时间为当前时间 receipt.setStatus(MesWmItemReceiptStatusEnum.PREPARE.getStatus()); itemReceiptMapper.insert(receipt); // 6. 遍历行创建入库单行 for (MesWmArrivalNoticeLineDO noticeLine : lines) { BigDecimal receivable = noticeLine.getQualifiedQuantity() != null ? noticeLine.getQualifiedQuantity() : noticeLine.getArrivalQuantity(); // 整行已退供应商时不生成零数量入库行;其余行仍正常收货。 if (receivable == null || receivable.signum() <= 0) { continue; } MesWmItemReceiptLineDO receiptLine = new MesWmItemReceiptLineDO(); receiptLine.setReceiptId(receipt.getId()); receiptLine.setArrivalNoticeLineId(noticeLine.getId()); receiptLine.setPurchaseOrderItemId(noticeLine.getPurchaseOrderItemId()); receiptLine.setItemId(noticeLine.getItemId()); // 使用合格数量(如果有 IQC 则是合格数量,否则是到货数量) receiptLine.setReceivedQuantity(receivable); // 按采购订单行单价快照金额,供来票/对账使用 fillReceiptLinePrice(receiptLine); itemReceiptLineService.createItemReceiptLineFromArrivalNoticeLine(receiptLine); } return receipt.getId(); } /** * 按采购订单行单价回填入库行金额,避免对账时再联表取价 */ private void fillReceiptLinePrice(MesWmItemReceiptLineDO receiptLine) { if (receiptLine.getPurchaseOrderItemId() == null) { return; } try { var item = purchaseOrderApi.getPurchaseOrderItem(receiptLine.getPurchaseOrderItemId()).getData(); if (item == null || item.getProductPrice() == null) { return; } receiptLine.setPrice(item.getProductPrice()); if (receiptLine.getReceivedQuantity() != null) { receiptLine.setTotalPrice(item.getProductPrice().multiply(receiptLine.getReceivedQuantity())); } } catch (Exception ex) { // 价格只是快照,采购订单行取不到时不阻断入库 log.warn("[fillReceiptLinePrice][采购订单行({}) 价格快照失败]", receiptLine.getPurchaseOrderItemId(), ex); } } @Override @Transactional(rollbackFor = Exception.class) public void submitItemReceiptApproval(Long id, String processDefinitionKey) { // 1. 校验存在 + 草稿状态 MesWmItemReceiptDO receipt = validateItemReceiptExistsAndDraft(id); // 审批入口与普通提交入口保持一致,空行单据不能进入审批。 List lines = itemReceiptLineService.getItemReceiptLineListByReceiptId(id); if (CollUtil.isEmpty(lines)) { throw exception(WM_ITEM_RECEIPT_NO_LINE); } // 2. 创建 BPM 流程实例 Long userId = getCurrentUserId(); // 全局免审批:业务校验通过后直接执行审批通过逻辑,无需流程模型。 if (processInstanceApi.isGlobalAutoApprove()) { itemReceiptMapper.updateById(new MesWmItemReceiptDO() .setId(id) .setStatus(MesWmItemReceiptStatusEnum.APPROVING.getStatus()) .setProcessInstanceId("")); updateItemReceiptAuditStatus(id, cn.iocoder.yudao.module.bpm.enums.task.BpmProcessInstanceStatusEnum.APPROVE.getStatus()); return; } if (StrUtil.isBlank(processDefinitionKey)) { throw exception(WM_ITEM_RECEIPT_BPM_PROCESS_DEFINITION_NOT_EXISTS); } ProcessDefinition processDefinition = bpmProcessDefinitionService.getActiveProcessDefinition(processDefinitionKey); if (processDefinition == null || bpmProcessDefinitionService .getProcessDefinitionInfoListByCategory(ITEM_RECEIPT_APPROVE_CATEGORY_CODE).stream() .noneMatch(info -> Objects.equals(info.getProcessDefinitionId(), processDefinition.getId()))) { throw exception(WM_ITEM_RECEIPT_BPM_PROCESS_DEFINITION_NOT_EXISTS); } String processInstanceId = processInstanceApi.createProcessInstance(userId, new BpmProcessInstanceCreateReqDTO() .setProcessDefinitionKey(processDefinitionKey) .setBusinessKey(String.valueOf(id)) .setVariables(Map.of("businessNo", receipt.getCode()))); // 3. 更新入库单状态为审批中 itemReceiptMapper.updateById(new MesWmItemReceiptDO() .setId(id) .setStatus(MesWmItemReceiptStatusEnum.APPROVING.getStatus()) .setProcessInstanceId(processInstanceId)); } @Override @Transactional(rollbackFor = Exception.class) public void updateItemReceiptAuditStatus(Long id, Integer bpmResult) { // 1. 校验存在 MesWmItemReceiptDO receipt = validateItemReceiptExists(id); if (!MesWmItemReceiptStatusEnum.APPROVING.getStatus().equals(receipt.getStatus())) { log.warn("[updateItemReceiptAuditStatus] 入库单({}) 不处于审批中状态", id); return; } // 2. 根据审批结果更新状态 Integer newStatus = convertBpmResultToReceiptStatus(bpmResult); if (newStatus != null) { itemReceiptMapper.update(null, new LambdaUpdateWrapper() .eq(MesWmItemReceiptDO::getId, id) .set(MesWmItemReceiptDO::getStatus, newStatus) .set(MesWmItemReceiptDO::getApproveTime, BpmTaskStatusEnum.APPROVE.getStatus().equals(bpmResult) ? LocalDateTime.now() : null)); } } /** * 转换 BPM 审批结果为入库单状态 */ private Integer convertBpmResultToReceiptStatus(Integer bpmResult) { if (BpmTaskStatusEnum.APPROVE.getStatus().equals(bpmResult)) { return MesWmItemReceiptStatusEnum.APPROVED.getStatus(); } else if (BpmTaskStatusEnum.REJECT.getStatus().equals(bpmResult)) { return MesWmItemReceiptStatusEnum.PREPARE.getStatus(); } else if (BpmTaskStatusEnum.CANCEL.getStatus().equals(bpmResult)) { return MesWmItemReceiptStatusEnum.CANCELED.getStatus(); } return null; } /** * 获取当前用户 ID */ private Long getCurrentUserId() { return Objects.requireNonNull(getLoginUserId(), "采购入库审批需要登录用户"); } /** * 生成入库单编码 */ private String generateItemReceiptCode() { // TODO: 使用编码规则服务生成编码 return "IR" + System.currentTimeMillis(); } }