恢复 ERP 采购入库/退货后端，补齐采购统计接口

gaoluyang

6 天以前 006020bc9a87dc40c2e73bc50f244b348b831de1

 yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/service/purchase/ErpPurchaseInServiceImpl.java

@@ -2,14 +2,12 @@

import cn.hutool.core.collection.CollUtil;
import cn.hutool.core.util.ObjectUtil;
import cn.hutool.core.util.StrUtil;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.util.number.MoneyUtils;
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
import cn.iocoder.yudao.module.bpm.api.task.BpmProcessInstanceApi;
import cn.iocoder.yudao.module.bpm.api.task.dto.BpmProcessInstanceCreateReqDTO;
import cn.iocoder.yudao.module.erp.controller.admin.purchase.vo.in.ErpPurchaseInPageReqVO;
import cn.iocoder.yudao.module.erp.controller.admin.purchase.vo.in.ErpPurchaseInSaveReqVO;
import cn.iocoder.yudao.module.erp.dal.dataobject.product.ErpProductDO;
import cn.iocoder.yudao.module.erp.dal.dataobject.purchase.ErpPurchaseInDO;
import cn.iocoder.yudao.module.erp.dal.dataobject.purchase.ErpPurchaseInItemDO;
import cn.iocoder.yudao.module.erp.dal.dataobject.purchase.ErpPurchaseOrderDO;
@@ -17,11 +15,11 @@
import cn.iocoder.yudao.module.erp.dal.mysql.purchase.ErpPurchaseInMapper;
import cn.iocoder.yudao.module.erp.dal.redis.no.ErpNoRedisDAO;
import cn.iocoder.yudao.module.erp.enums.ErpAuditStatus;
import cn.iocoder.yudao.module.erp.enums.stock.ErpStockRecordBizTypeEnum;
import cn.iocoder.yudao.module.erp.service.finance.ErpAccountService;
import cn.iocoder.yudao.module.erp.service.product.ErpProductService;
import cn.iocoder.yudao.module.erp.service.stock.ErpStockRecordService;
import cn.iocoder.yudao.module.erp.service.stock.bo.ErpStockRecordCreateReqBO;
import cn.iocoder.yudao.module.mdm.api.item.MdmItemApi;
import cn.iocoder.yudao.module.mdm.api.item.dto.MdmItemRespDTO;
import cn.iocoder.yudao.module.mes.api.wms.dto.WmsPurchaseInboundReqDTO;
import cn.iocoder.yudao.module.mes.api.wms.stock.WmsStockApi;
import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
import jakarta.annotation.Resource;
import lombok.extern.slf4j.Slf4j;
@@ -31,14 +29,18 @@
import org.springframework.validation.annotation.Validated;

import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.util.Collection;
import java.util.Collections;
import java.util.List;
import java.util.Map;
import java.util.Set;

import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.*;
import static cn.iocoder.yudao.module.erp.enums.ErrorCodeConstants.*;

// TODO 芋艿：记录操作日志

/**
 * ERP 采购入库 Service 实现类
@@ -50,11 +52,6 @@
@Slf4j
public class ErpPurchaseInServiceImpl implements ErpPurchaseInService {

    /**
     * BPM 采购入库审批流程标识
     */
    public static final String BPM_PROCESS_DEFINITION_KEY = "erp-purchase-in-audit";

    @Resource
    private ErpPurchaseInMapper purchaseInMapper;
    @Resource
@@ -64,20 +61,18 @@
    private ErpNoRedisDAO noRedisDAO;

    @Resource
    private ErpProductService productService;
    private MdmItemApi mdmItemApi;
    @Resource
    @Lazy // 延迟加载，避免循环依赖
    private ErpPurchaseOrderService purchaseOrderService;
    @Resource
    private ErpAccountService accountService;

    @Resource
    private ErpStockRecordService stockRecordService;
    private WmsStockApi wmsStockApi;

    @Resource
    private AdminUserApi adminUserApi;

    @Resource
    private BpmProcessInstanceApi bpmProcessInstanceApi;

    @Override
    @Transactional(rollbackFor = Exception.class)
@@ -96,7 +91,7 @@

        // 2.1 插入入库
        ErpPurchaseInDO purchaseIn = BeanUtils.toBean(createReqVO, ErpPurchaseInDO.class, in -> in
                .setNo(no).setStatus(ErpAuditStatus.DRAFT.getStatus()))
                .setNo(no).setStatus(ErpAuditStatus.PROCESS.getStatus()))
                .setOrderNo(purchaseOrder.getNo()).setSupplierId(purchaseOrder.getSupplierId());
        calculateTotalPrice(purchaseIn, purchaseInItems);
        purchaseInMapper.insert(purchaseIn);
@@ -185,22 +180,53 @@
            throw exception(approve ? PURCHASE_IN_APPROVE_FAIL : PURCHASE_IN_PROCESS_FAIL);
        }

        // 3. 变更库存
        List<ErpPurchaseInItemDO> purchaseInItems = purchaseInItemMapper.selectListByInId(id);
        Integer bizType = approve ? ErpStockRecordBizTypeEnum.PURCHASE_IN.getType()
                : ErpStockRecordBizTypeEnum.PURCHASE_IN_CANCEL.getType();
        purchaseInItems.forEach(purchaseInItem -> {
            BigDecimal count = approve ? purchaseInItem.getCount() : purchaseInItem.getCount().negate();
            ErpStockRecordCreateReqBO stockRecordBO = new ErpStockRecordCreateReqBO();
            stockRecordBO.setProductId(purchaseInItem.getProductId());
            stockRecordBO.setWarehouseId(purchaseInItem.getWarehouseId());
            stockRecordBO.setCount(count);
            stockRecordBO.setBizType(bizType);
            stockRecordBO.setBizId(purchaseInItem.getInId());
            stockRecordBO.setBizItemId(purchaseInItem.getId());
            stockRecordBO.setBizNo(purchaseIn.getNo());
            stockRecordService.createStockRecord(stockRecordBO);
        });
        // 3. 同步 WMS 库存（MES 库存）
        if (approve) {
            List<ErpPurchaseInItemDO> purchaseInItems = purchaseInItemMapper.selectListByInId(id);
            syncToWmsPurchaseInbound(purchaseIn, purchaseInItems);
        }
    }

    /**
     * 同步采购入库到 WMS 库存
     */
    private void syncToWmsPurchaseInbound(ErpPurchaseInDO purchaseIn, List<ErpPurchaseInItemDO> purchaseInItems) {
        if (CollUtil.isEmpty(purchaseInItems)) {
            return;
        }

        log.info("[syncToWmsPurchaseInbound] 开始同步采购入库到WMS，purchaseInId={}", purchaseIn.getId());

        // 构建入库请求
        WmsPurchaseInboundReqDTO reqDTO = new WmsPurchaseInboundReqDTO()
                .setBizId(purchaseIn.getId())
                .setBizCode(purchaseIn.getNo())
                .setReceiptTime(LocalDateTime.now());

        // 转换明细项：ERP 产品编号即 MDM 物料编号，仓库编号即 MES 仓库编号
        List<WmsPurchaseInboundReqDTO.Item> items = convertList(purchaseInItems, item -> new WmsPurchaseInboundReqDTO.Item()
                .setItemId(item.getProductId())
                .setWarehouseId(item.getWarehouseId())
                .setQuantity(item.getCount())
                .setBizLineId(item.getId()));

        // 过滤掉映射失败的项
        items = items.stream().filter(java.util.Objects::nonNull).toList();
        if (CollUtil.isEmpty(items)) {
            log.warn("[syncToWmsPurchaseInbound] 无有效的入库明细，跳过WMS同步");
            return;
        }

        reqDTO.setItems(items);

        try {
            Long transactionId = wmsStockApi.purchaseInbound(reqDTO);
            log.info("[syncToWmsPurchaseInbound] 同步成功，transactionId={}", transactionId);
        } catch (Exception e) {
            log.error("[syncToWmsPurchaseInbound] 同步失败", e);
            // 注意：这里可以选择抛出异常回滚，或仅记录日志
            // throw exception(PURCHASE_IN_SYNC_WMS_FAIL);
        }
    }

    @Override
@@ -216,13 +242,15 @@
    }

    private List<ErpPurchaseInItemDO> validatePurchaseInItems(List<ErpPurchaseInSaveReqVO.Item> list) {
        // 1. 校验产品存在
        List<ErpProductDO> productList = productService.validProductList(
                convertSet(list, ErpPurchaseInSaveReqVO.Item::getProductId));
        Map<Long, ErpProductDO> productMap = convertMap(productList, ErpProductDO::getId);
        // 1. 校验物料存在（物料主数据已迁移到 MDM）
        Set<Long> productIds = convertSet(list, ErpPurchaseInSaveReqVO.Item::getProductId);
        Map<Long, MdmItemRespDTO> itemMap = productIds.isEmpty() ? Collections.emptyMap() : mdmItemApi.getItemMap(productIds);
        if (itemMap.size() != productIds.size()) {
            throw exception(PRODUCT_NOT_EXISTS);
        }
        // 2. 转化为 ErpPurchaseInItemDO 列表
        return convertList(list, o -> BeanUtils.toBean(o, ErpPurchaseInItemDO.class, item -> {
            item.setProductUnitId(productMap.get(item.getProductId()).getUnitId());
            item.setProductUnitId(itemMap.get(item.getProductId()).getUnitMeasureId());
            item.setTotalPrice(MoneyUtils.priceMultiply(item.getProductPrice(), item.getCount()));
            if (item.getTotalPrice() == null) {
                return;
@@ -319,85 +347,6 @@
            return Collections.emptyList();
        }
        return purchaseInItemMapper.selectListByInIds(inIds);
    }

    // ==================== BPM 流程审批 ====================

    @Override
    @Transactional(rollbackFor = Exception.class)
    public void submitPurchaseIn(Long id, Long userId) {
        // 1. 校验采购入库处于草稿状态
        ErpPurchaseInDO purchaseIn = validatePurchaseInExists(id);
        if (ObjectUtil.notEqual(purchaseIn.getStatus(), ErpAuditStatus.DRAFT.getStatus())) {
            throw exception(PURCHASE_IN_SUBMIT_FAIL_NOT_DRAFT);
        }

        // 2. 创建采购入库审批流程实例
        String processInstanceId = bpmProcessInstanceApi.createProcessInstance(userId, new BpmProcessInstanceCreateReqDTO()
                .setProcessDefinitionKey(BPM_PROCESS_DEFINITION_KEY)
                .setBusinessKey(String.valueOf(id)));

        // 3. 更新采购入库工作流编号、状态
        purchaseInMapper.updateById(new ErpPurchaseInDO()
                .setId(id)
                .setProcessInstanceId(processInstanceId)
                .setStatus(ErpAuditStatus.PROCESS.getStatus()));
    }

    @Override
    @Transactional(rollbackFor = Exception.class)
    public void updatePurchaseInAuditStatus(Long id, Integer bpmResult) {
        // 1. 校验采购入库存在
        ErpPurchaseInDO purchaseIn = validatePurchaseInExists(id);

        // 2. 校验采购入库处于审批中
        if (ObjectUtil.notEqual(purchaseIn.getStatus(), ErpAuditStatus.PROCESS.getStatus())) {
            log.error("[updatePurchaseInAuditStatus][purchaseIn({}) 不处于审批中，无法更新审批结果({})]",
                    purchaseIn.getId(), bpmResult);
            throw exception(PURCHASE_IN_UPDATE_AUDIT_STATUS_FAIL_NOT_PROCESS);
        }

        // 3. 更新采购入库审批结果
        Integer auditStatus = convertBpmResultToAuditStatus(bpmResult);
        purchaseInMapper.updateById(new ErpPurchaseInDO()
                .setId(id)
                .setStatus(auditStatus));

        // 4. 审批通过时变更库存
        if (ErpAuditStatus.APPROVE.getStatus().equals(auditStatus)) {
            List<ErpPurchaseInItemDO> purchaseInItems = purchaseInItemMapper.selectListByInId(id);
            purchaseInItems.forEach(purchaseInItem -> {
                ErpStockRecordCreateReqBO stockRecordBO = new ErpStockRecordCreateReqBO();
                stockRecordBO.setProductId(purchaseInItem.getProductId());
                stockRecordBO.setWarehouseId(purchaseInItem.getWarehouseId());
                stockRecordBO.setCount(purchaseInItem.getCount());
                stockRecordBO.setBizType(ErpStockRecordBizTypeEnum.PURCHASE_IN.getType());
                stockRecordBO.setBizId(purchaseInItem.getInId());
                stockRecordBO.setBizItemId(purchaseInItem.getId());
                stockRecordBO.setBizNo(purchaseIn.getNo());
                stockRecordService.createStockRecord(stockRecordBO);
            });
        }
    }

    /**
     * 将 BPM 审批结果转换为 ERP 审批状态
     *
     * @param bpmResult BPM 审批结果
     * @return ERP 审批状态
     */
    private Integer convertBpmResultToAuditStatus(Integer bpmResult) {
        // BPM 审批结果：2=通过，3=不通过，4=已取消
        if (bpmResult == 2) {
            return ErpAuditStatus.APPROVE.getStatus();
        } else if (bpmResult == 3) {
            return ErpAuditStatus.REJECT.getStatus();
        } else if (bpmResult == 4) {
            return ErpAuditStatus.DRAFT.getStatus();
        } else {
            log.warn("[convertBpmResultToAuditStatus][未知的 BPM 审批结果({})]", bpmResult);
            return ErpAuditStatus.PROCESS.getStatus();
        }
    }

}