1.人力资源大模块开发 2.仓库大模块开发

云

2026-07-09 d41fe2e95f3f64c6e3a7229acd9e74e673513a0a

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

@@ -2,11 +2,10 @@

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;
@@ -20,8 +19,11 @@
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.product.mapping.ErpMdmMappingService;
import cn.iocoder.yudao.module.erp.service.stock.ErpStockRecordService;
import cn.iocoder.yudao.module.erp.service.stock.bo.ErpStockRecordCreateReqBO;
import cn.iocoder.yudao.module.wms.api.dto.WmsPurchaseInboundReqDTO;
import cn.iocoder.yudao.module.wms.api.stock.WmsStockApi;
import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
import jakarta.annotation.Resource;
import lombok.extern.slf4j.Slf4j;
@@ -31,6 +33,7 @@
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;
@@ -39,6 +42,8 @@
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 实现类
@@ -49,11 +54,6 @@
@Validated
@Slf4j
public class ErpPurchaseInServiceImpl implements ErpPurchaseInService {

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

    @Resource
    private ErpPurchaseInMapper purchaseInMapper;
@@ -74,10 +74,13 @@
    private ErpStockRecordService stockRecordService;

    @Resource
    private AdminUserApi adminUserApi;
    private WmsStockApi wmsStockApi;

    @Resource
    private BpmProcessInstanceApi bpmProcessInstanceApi;
    private ErpMdmMappingService mdmMappingService;

    @Resource
    private AdminUserApi adminUserApi;

    @Override
    @Transactional(rollbackFor = Exception.class)
@@ -96,7 +99,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);
@@ -191,16 +194,73 @@
                : 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);
            stockRecordService.createStockRecord(new ErpStockRecordCreateReqBO(
                    purchaseInItem.getProductId(), purchaseInItem.getWarehouseId(), count,
                    bizType, purchaseInItem.getInId(), purchaseInItem.getId(), purchaseIn.getNo()));
        });

        // 4. 同步 WMS 库存（MES 库存）
        if (approve) {
            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());

        // 转换明细项
        List<WmsPurchaseInboundReqDTO.Item> items = convertList(purchaseInItems, item -> {
            // ERP 产品 ID -> MDM 物料 ID
            Long mdmItemId = mdmMappingService.getMdmItemId(item.getProductId());
            // ERP 仓库 ID -> MES 仓库 ID
            Long mesWarehouseId = mdmMappingService.getMesWarehouseId(item.getWarehouseId());

            if (mdmItemId == null) {
                log.warn("[syncToWmsPurchaseInbound] 未找到MDM物料映射，erpProductId={}", item.getProductId());
                return null;
            }
            if (mesWarehouseId == null) {
                log.warn("[syncToWmsPurchaseInbound] 未找到MES仓库映射，erpWarehouseId={}", item.getWarehouseId());
                return null;
            }

            return new WmsPurchaseInboundReqDTO.Item()
                    .setItemId(mdmItemId)
                    .setWarehouseId(mesWarehouseId)
                    .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
@@ -319,85 +379,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();
        }
    }

}