package cn.iocoder.yudao.module.mes.service.wm.returnsales; import cn.hutool.core.collection.CollUtil; import cn.hutool.core.util.ObjUtil; import cn.iocoder.yudao.framework.common.pojo.PageResult; import cn.iocoder.yudao.framework.common.util.object.BeanUtils; import cn.iocoder.yudao.module.mes.controller.admin.wm.batch.vo.MesWmBatchGenerateReqVO; import cn.iocoder.yudao.module.mes.controller.admin.wm.returnsales.vo.line.MesWmReturnSalesLinePageReqVO; import cn.iocoder.yudao.module.mes.controller.admin.wm.returnsales.vo.line.MesWmReturnSalesLineSaveReqVO; import cn.iocoder.yudao.module.mes.api.event.MesReturnSalesProgressEvent; import cn.iocoder.yudao.module.mes.dal.dataobject.mdm.MesMdmItemDO; import cn.iocoder.yudao.module.mes.dal.dataobject.wm.batch.MesWmBatchDO; import cn.iocoder.yudao.module.mes.dal.dataobject.wm.returnsales.MesWmReturnSalesLineDO; import cn.iocoder.yudao.module.mes.dal.dataobject.wm.returnsales.MesWmReturnSalesDO; import cn.iocoder.yudao.module.mes.dal.mysql.wm.returnsales.MesWmReturnSalesLineMapper; import cn.iocoder.yudao.module.mes.enums.wm.MesWmQualityStatusEnum; import cn.iocoder.yudao.module.mes.enums.wm.MesWmReturnSalesStatusEnum; import cn.iocoder.yudao.module.mes.service.mdm.MesMdmItemService; import cn.iocoder.yudao.module.mes.service.wm.batch.MesWmBatchService; import jakarta.annotation.Resource; import org.springframework.context.annotation.Lazy; import org.springframework.context.ApplicationEventPublisher; import org.springframework.stereotype.Service; import org.springframework.validation.annotation.Validated; import java.math.BigDecimal; import java.util.List; import java.util.Objects; import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception; import static cn.iocoder.yudao.module.mes.enums.ErrorCodeConstants.MD_ITEM_BATCH_REQUIRED; import static cn.iocoder.yudao.module.mes.enums.ErrorCodeConstants.WM_BATCH_CLIENT_MISMATCH; import static cn.iocoder.yudao.module.mes.enums.ErrorCodeConstants.WM_RETURN_SALES_LINE_NOT_EXISTS; import static cn.iocoder.yudao.module.mes.enums.ErrorCodeConstants.WM_RETURN_SALES_RQC_SOURCE_INVALID; /** * MES 销售退货单行 Service 实现类 * * @author 超级管理员 */ @Service @Validated public class MesWmReturnSalesLineServiceImpl implements MesWmReturnSalesLineService { @Resource private MesWmReturnSalesLineMapper returnSalesLineMapper; @Resource @Lazy private MesWmReturnSalesService returnSalesService; @Resource private MesMdmItemService mdmItemService; @Resource private MesWmBatchService batchService; @Resource @Lazy private MesWmReturnSalesDetailService returnSalesDetailService; @Resource private ApplicationEventPublisher eventPublisher; @Override public Long createReturnSalesLine(MesWmReturnSalesLineSaveReqVO createReqVO) { validateLineSaveData(createReqVO); // 插入 MesWmReturnSalesLineDO line = BeanUtils.toBean(createReqVO, MesWmReturnSalesLineDO.class); // 质量状态自动赋值 line.setQualityStatus(calculateQualityStatus(line.getRqcCheckFlag())); returnSalesLineMapper.insert(line); return line.getId(); } @Override public void updateReturnSalesLine(MesWmReturnSalesLineSaveReqVO updateReqVO) { // 校验存在 MesWmReturnSalesLineDO oldLine = validateReturnSalesLineExists(updateReqVO.getId()); // 固定父单 ID,防止通过接口篡改 updateReqVO.setReturnId(oldLine.getReturnId()); validateLineSaveData(updateReqVO); // 更新 MesWmReturnSalesLineDO updateObj = BeanUtils.toBean(updateReqVO, MesWmReturnSalesLineDO.class); // 质量状态自动赋值 updateObj.setQualityStatus(calculateQualityStatus(updateObj.getRqcCheckFlag())); returnSalesLineMapper.updateById(updateObj); } /** * 校验保存时的关联数据 */ private void validateLineSaveData(MesWmReturnSalesLineSaveReqVO reqVO) { // 校验退货单存在 + 草稿状态 MesWmReturnSalesDO returnSales = returnSalesService.validateReturnSalesExistsAndPrepare(reqVO.getReturnId()); // 校验物料存在 + 解析批次 resolveAndValidateBatch(returnSales, reqVO); } @Override public void deleteReturnSalesLine(Long id) { // 校验存在 MesWmReturnSalesLineDO line = validateReturnSalesLineExists(id); // 校验主单为草稿状态才允许删除行 returnSalesService.validateReturnSalesExistsAndPrepare(line.getReturnId()); // 级联删除该行的明细 returnSalesDetailService.deleteReturnSalesDetailByLineId(id); // 删除行 returnSalesLineMapper.deleteById(id); } @Override public MesWmReturnSalesLineDO getReturnSalesLine(Long id) { return returnSalesLineMapper.selectById(id); } @Override public PageResult getReturnSalesLinePage(MesWmReturnSalesLinePageReqVO pageReqVO) { return returnSalesLineMapper.selectPage(pageReqVO); } @Override public List getReturnSalesLineListByReturnId(Long returnId) { return returnSalesLineMapper.selectListByReturnId(returnId); } @Override public void deleteReturnSalesLineByReturnId(Long returnId) { returnSalesLineMapper.deleteByReturnId(returnId); } @Override public MesWmReturnSalesLineDO validateReturnSalesLineExists(Long id) { MesWmReturnSalesLineDO line = returnSalesLineMapper.selectById(id); if (line == null) { throw exception(WM_RETURN_SALES_LINE_NOT_EXISTS); } return line; } @Override public void updateQualityStatusByReturnId(Long returnId, Integer qualityStatus) { List lines = returnSalesLineMapper.selectListByReturnId(returnId); for (MesWmReturnSalesLineDO line : lines) { Integer newStatus = calculateQualityStatus(line.getRqcCheckFlag()); if (ObjUtil.notEqual(newStatus, line.getQualityStatus())) { returnSalesLineMapper.updateById(new MesWmReturnSalesLineDO() .setId(line.getId()).setQualityStatus(newStatus)); } } } private Integer calculateQualityStatus(Boolean rqcCheckFlag) { if (Boolean.TRUE.equals(rqcCheckFlag)) { return MesWmQualityStatusEnum.PENDING.getStatus(); // 待检 } return MesWmQualityStatusEnum.PASS.getStatus(); // 不需检验,默认合格 } /** * 解析并校验物料批次 * *

退货商品在销售出库时可能未记录批次,此时按物料 + 客户 + 销售订单自动生成退货批次, * 保证退货单仍可追溯到具体批次;已有批次则校验物料归属,批次未指定客户时视为通用批次。 */ private void resolveAndValidateBatch(MesWmReturnSalesDO returnSales, MesWmReturnSalesLineSaveReqVO reqVO) { MesMdmItemDO item = mdmItemService.validateItemExistsAndEnable(reqVO.getItemId()); if (reqVO.getBatchId() != null) { MesWmBatchDO batch = batchService.validateBatchExists(reqVO.getBatchId(), reqVO.getItemId()); if (batch.getClientId() != null && ObjUtil.notEqual(batch.getClientId(), returnSales.getClientId())) { throw exception(WM_BATCH_CLIENT_MISMATCH); } reqVO.setBatchCode(batch.getCode()); return; } if (!Boolean.TRUE.equals(item.getIsBatchManaged())) { return; } MesWmBatchGenerateReqVO batchReqVO = new MesWmBatchGenerateReqVO() .setItemId(reqVO.getItemId()) .setClientId(returnSales.getClientId()) .setSalesOrderCode(returnSales.getSalesOrderCode()); MesWmBatchDO batch = batchService.getOrGenerateBatchCode(batchReqVO); if (batch == null) { throw exception(MD_ITEM_BATCH_REQUIRED); } reqVO.setBatchId(batch.getId()).setBatchCode(batch.getCode()); } @Override public void updateReturnSalesLineWhenRqcFinish(Long sourceLineId, Long sourceDocId, Integer checkResult, BigDecimal qualifiedQuantity, BigDecimal unqualifiedQuantity) { MesWmReturnSalesLineDO sourceLine = validateReturnSalesLineExists(sourceLineId); if (sourceDocId != null) { MesWmReturnSalesDO sourceDoc = returnSalesService.validateReturnSalesExists(sourceDocId); if (!sourceDocId.equals(sourceLine.getReturnId()) || !MesWmReturnSalesStatusEnum.CONFIRMED.getStatus().equals(sourceDoc.getStatus()) || !MesWmQualityStatusEnum.PENDING.getStatus().equals(sourceLine.getQualityStatus())) { throw exception(WM_RETURN_SALES_RQC_SOURCE_INVALID); } } boolean hasUnqualified = unqualifiedQuantity != null && unqualifiedQuantity.compareTo(BigDecimal.ZERO) > 0; boolean hasQualified = qualifiedQuantity != null && qualifiedQuantity.compareTo(BigDecimal.ZERO) > 0; // 1. 根据合格/不合格品数量,更新退货单行的质量状态 if (!hasUnqualified) { // 1.A 情况一:全部合格 returnSalesLineMapper.updateById(new MesWmReturnSalesLineDO() .setId(sourceLineId).setQualityStatus(MesWmQualityStatusEnum.PASS.getStatus())); } else if (!hasQualified) { // 1.B 情况二:全部不合格 returnSalesLineMapper.updateById(new MesWmReturnSalesLineDO() .setId(sourceLineId).setQualityStatus(MesWmQualityStatusEnum.FAIL.getStatus())); } else { // 1.C 情况三:部分合格部分不合格 → 拆分行 // 1.C.1 新增一行不合格品 MesWmReturnSalesLineDO unqualifiedLine = new MesWmReturnSalesLineDO() .setReturnId(sourceLine.getReturnId()) .setItemId(sourceLine.getItemId()) .setQuantity(unqualifiedQuantity) .setBatchId(sourceLine.getBatchId()) .setRqcId(sourceLine.getRqcId()) .setRqcCheckFlag(sourceLine.getRqcCheckFlag()) .setQualityStatus(MesWmQualityStatusEnum.FAIL.getStatus()) .setRemark(sourceLine.getRemark()); returnSalesLineMapper.insert(unqualifiedLine); // 1.C.2 更新原行为合格品 returnSalesLineMapper.updateById(new MesWmReturnSalesLineDO() .setId(sourceLineId) .setQuantity(qualifiedQuantity) .setQualityStatus(MesWmQualityStatusEnum.PASS.getStatus())); } // 2. 检查退货单下是否还有待检验的行,若全检完则将退货单状态设为"待上架" if (sourceDocId != null) { List allLines = returnSalesLineMapper.selectListByReturnId(sourceDocId); boolean allInspected = !CollUtil.contains(allLines, line -> Objects.equals(line.getQualityStatus(), MesWmQualityStatusEnum.PENDING.getStatus())); if (allInspected) { MesWmReturnSalesDO returnSales = returnSalesService.validateReturnSalesExists(sourceDocId); if (MesWmReturnSalesStatusEnum.CONFIRMED.getStatus().equals(returnSales.getStatus())) { returnSalesService.updateReturnSalesStatus(sourceDocId, MesWmReturnSalesStatusEnum.APPROVING.getStatus()); if (returnSales.getAfterSaleReturnId() != null) { boolean failed = CollUtil.contains(allLines, line -> MesWmQualityStatusEnum.FAIL.getStatus().equals(line.getQualityStatus())); eventPublisher.publishEvent(new MesReturnSalesProgressEvent(sourceDocId, MesReturnSalesProgressEvent.Stage.QUALITY_FINISHED, failed ? "含不合格品" : "合格")); } } } } } }