feat(erp): 销售订单审批接入协同办公(BPM)

liu

7 小时以前 06ac6cc6f4693a8abc585e69139131fe19274fd1

feat(erp): 销售订单审批接入协同办公(BPM)

- ErpAuditStatus 新增 DRAFT(0,未提交)，销售订单创建后为未提交状态
- 新增提交审批 submitSaleOrder、审批结果监听器 ErpSaleOrderStatusListener、审批流程定义列表接口
- 新增 processInstanceId 字段，移除直通审批/反审批
- RespVO.Item 补全 totalProductPrice/totalPrice 金额字段
- 新增 sql/sale_order_bpm_approval.sql 数据库变更脚本

Co-Authored-By: Claude <noreply@anthropic.com>

 sql/sale_order_bpm_approval.sql

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,82 @@
-- ============================================================
-- é”€å”®è®¢å•å®¡æ‰¹æŽ¥å…¥ååŒåŠžå…¬(BPM) - æ•°æ®åº“变更脚本
-- è¯´æ˜Ž:
--   1. å¯é‡å¤æ‰§è¡Œ(幂等),重复执行不会报错/重复插入
--   2. é¡¹ç›®ä¸ä½¿ç”¨å¤šç§Ÿæˆ·,脚本不包含 tenant_id
--   3. BPM æµç¨‹å®šä¹‰(sale_order_approve)
--      éœ€è¦åœ¨ã€ŒååŒåŠžå…¬ -> æµç¨‹ç®¡ç†ã€ä¸­åˆ›å»ºå¹¶å‘布,无法用 SQL å®Œæˆ,见文末说明
-- ============================================================

-- ------------------------------------------------------------
-- 1. erp_sale_order è¡¥ BPM å­—段(幂等:缺列才加)
-- ------------------------------------------------------------
SET @s1 = IF((SELECT COUNT(*) FROM information_schema.columns WHERE table_schema=DATABASE() AND table_name='erp_sale_order' AND column_name='process_instance_id')=0,
  'ALTER TABLE erp_sale_order ADD COLUMN process_instance_id VARCHAR(64) NULL COMMENT ''BPM æµç¨‹å®žä¾‹ç¼–号'' AFTER remark', 'SELECT 1');
PREPARE s1 FROM @s1; EXECUTE s1; DEALLOCATE PREPARE s1;

-- ------------------------------------------------------------
-- 2. æ–°å¢ž BPM æµç¨‹åˆ†ç±»:销售订单审批
-- ------------------------------------------------------------
INSERT INTO bpm_category (id, name, code, description, status, sort, creator, create_time, updater, update_time, deleted)
SELECT (SELECT COALESCE(MAX(id), 0) + 1 FROM bpm_category), '销售订单审批', 'sale_order_approve',
       '销售订单审批流程分类', 0, 30, '1', NOW(), '1', NOW(), 0
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM bpm_category WHERE code = 'sale_order_approve' AND deleted = 0);

-- ------------------------------------------------------------
-- 3. ä¿®æ­£/新增 erp_audit_status å­—å…¸(与 ErpAuditStatus æžšä¸¾ä¿æŒä¸€è‡´)
-- ------------------------------------------------------------
-- 3.1 å€¼ 0 = æœªæäº¤(销售订单创建后初始状态;不存在则新增,存在则修正标签)
INSERT INTO system_dict_data (id, sort, label, value, dict_type, status, color_type, css_class, remark, creator, create_time, updater, update_time, deleted)
SELECT (SELECT COALESCE(MAX(id), 0) + 1 FROM system_dict_data), 0, '未提交', '0', 'erp_audit_status', 0, 'info', '',
       '销售订单等未提交审批', '1', NOW(), '1', NOW(), 0
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM system_dict_data WHERE dict_type = 'erp_audit_status' AND value = '0' AND deleted = 0);

-- 3.2 è‹¥å·²å­˜åœ¨ä½†æ ‡ç­¾ä¸æ˜¯ã€Œæœªæäº¤ã€,强制修正为「未提交」
UPDATE system_dict_data
SET label = '未提交', remark = '销售订单等未提交审批', updater = '1', update_time = NOW()
WHERE dict_type = 'erp_audit_status' AND value = '0' AND deleted = 0;

-- ------------------------------------------------------------
-- 4. bpm_business_attach è¡¨:流程定义 -> ä¸šåŠ¡è¯¦æƒ…组件映射
--    ä½œç”¨:协同办公审批详情页加载对应业务组件展示业务内容
--    è‹¥é”€å”®è®¢å•è¯¦æƒ…组件路径不是 /erp/sale/order/detail/index.vue,请修改 component_path
-- ------------------------------------------------------------
CREATE TABLE IF NOT EXISTS `bpm_business_attach` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  `process_definition_key` varchar(64) NOT NULL DEFAULT '' COMMENT '流程定义的Key',
  `business_type` varchar(64) NOT NULL DEFAULT '' COMMENT '业务类型',
  `component_path` varchar(255) NOT NULL DEFAULT '' COMMENT '业务详情组件路径',
  `status` tinyint NOT NULL DEFAULT '0' COMMENT '状态',
  `remark` varchar(255) DEFAULT NULL COMMENT '备注',
  `creator` varchar(64) DEFAULT '' COMMENT '创建者',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `updater` varchar(64) DEFAULT '' COMMENT '更新者',
  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  `deleted` bit(1) NOT NULL DEFAULT b'0' COMMENT '是否删除',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='BPM业务附件配置';

-- 4.1 é”€å”®è®¢å•å®¡æ‰¹ -> é”€å”®è®¢å•è¯¦æƒ…组件(协同办公审批页显示订单内容)
INSERT INTO bpm_business_attach (id, process_definition_key, business_type, component_path, status, remark, creator, create_time, updater, update_time, deleted)
SELECT (SELECT COALESCE(MAX(id), 0) + 1 FROM bpm_business_attach), 'sale_order_approve', 'erp_sale_order',
       '/erp/sale/order/detail/index.vue', 0, '销售订单审批业务详情组件', '1', NOW(), '1', NOW(), 0
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM bpm_business_attach WHERE process_definition_key = 'sale_order_approve' AND deleted = 0);

-- ------------------------------------------------------------
-- 5. åŽ†å²æ•°æ®è¿ç§»:存量「未审核(10)」销售订单调整为「未提交(0)」
--    æ–°é€»è¾‘中创建后即为未提交,10 ä¸å†ç”¨äºŽé”€å”®è®¢å•
-- ------------------------------------------------------------
UPDATE erp_sale_order SET status = 0, updater = '1', update_time = NOW()
WHERE status = 10 AND deleted = 0;

-- ============================================================
-- æ³¨æ„:以下流程定义需要在「协同办公 -> æµç¨‹ç®¡ç†ã€ä¸­åˆ›å»ºå¹¶å‘布,无法用 SQL å®Œæˆ
--   1. æµç¨‹ key: sale_order_approve
--      åç§°: é”€å”®è®¢å•å®¡æ‰¹
--      åˆ†ç±»: sale_order_approve(对应本脚本第 2 æ­¥)
--      å®¡æ‰¹äºº: æŒ‰éœ€é…ç½®
--      è¡¨å•: æ™®é€šè¡¨å•(表单1);配合 bpm_business_attach å±•ç¤ºé”€å”®è®¢å•è¯¦æƒ…
-- ============================================================

 yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/controller/admin/sale/ErpSaleOrderController.java

@@ -45,6 +45,7 @@

import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMultiMap;
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;

@@ -91,13 +92,21 @@
        return success(true);
    }

    @PutMapping("/update-status")
    @Operation(summary = "更新销售订单的状态")
    @PostMapping("/submit")
    @Operation(summary = "提交销售订单审批（协同办公）")
    @PreAuthorize("@ss.hasPermission('erp:sale-order:update-status')")
    public CommonResult<Boolean> updateSaleOrderStatus(@RequestParam("id") Long id,
                                                      @RequestParam("status") Integer status) {
        saleOrderService.updateSaleOrderStatus(id, status);
    public CommonResult<Boolean> submitSaleOrder(@RequestParam("id") Long id,
                                                 @RequestParam("processDefinitionKey") String processDefinitionKey) {
        Long userId = getLoginUserId();
        saleOrderService.submitSaleOrder(id, processDefinitionKey, userId);
        return success(true);
    }

    @GetMapping("/approve-process-list")
    @Operation(summary = "获取销售订单审批流程列表")
    @PreAuthorize("@ss.hasPermission('erp:sale-order:query')")
    public CommonResult<List<Map<String, Object>>> getApproveProcessList() {
        return success(saleOrderService.getSaleOrderApproveProcessDefinitionList());
    }

    @PutMapping("/cancel")
@@ -161,6 +170,7 @@
                convertSet(saleOrderItemList, ErpSaleOrderItemDO::getProductUnitId));
        // 3. è½¬æ¢è®¢å•é¡¹
        List<ErpSaleOrderRespVO.Item> itemVOList = BeanUtils.toBean(saleOrderItemList, ErpSaleOrderRespVO.Item.class, item -> {
            fillItemPrice(item);
            item.setStockCount(mesWmStockApi.getStockQuantity(item.getProductId()));
            item.setBatchCode(batchCodeMap.get(item.getId()));
            MapUtils.findAndThen(itemMap, item.getProductId(), mdmItem ->
@@ -260,6 +270,7 @@
        return BeanUtils.toBean(pageResult, ErpSaleOrderRespVO.class, saleOrder -> {
            saleOrder.setItems(BeanUtils.toBean(saleOrderItemMap.get(saleOrder.getId()), ErpSaleOrderRespVO.Item.class,
                    item -> {
                        fillItemPrice(item);
                        item.setBatchCode(batchCodeMap.get(item.getId()));
                        MapUtils.findAndThen(itemMap, item.getProductId(), mdmItem ->
                                item.setProductName(mdmItem.getName()).setProductBarCode(mdmItem.getBarCode())
@@ -281,4 +292,18 @@
        });
    }

    /**
     * å¡«å……订单项的金额字段
     *
     * DO ä¸­ totalPrice ä¸ºäº§å“é‡‘额（不含税），RespVO éœ€è¦è¡¥å…¨ï¼š
     * - totalProductPrice：产品金额
     * - totalPrice：含税金额（产品金额 + ç¨Žé¢ï¼‰
     */
    private void fillItemPrice(ErpSaleOrderRespVO.Item item) {
        BigDecimal productAmount = item.getTotalPrice() != null ? item.getTotalPrice() : BigDecimal.ZERO;
        BigDecimal tax = item.getTaxPrice() != null ? item.getTaxPrice() : BigDecimal.ZERO;
        item.setTotalProductPrice(productAmount);
        item.setTotalPrice(productAmount.add(tax));
    }

}

 yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/controller/admin/sale/vo/order/ErpSaleOrderRespVO.java

@@ -77,6 +77,9 @@
    @ExcelProperty("备注")
    private String remark;

    @Schema(description = "BPM æµç¨‹å®žä¾‹ç¼–号", example = "b00eb97d-2d1c-4cf1-9b4b-2a5bcdc9a3a7")
    private String processInstanceId;

    @Schema(description = "附件列表")
    private List<StorageBlobRespDTO> attachmentList;

@@ -148,6 +151,12 @@
        @Schema(description = "税额，单位：元", example = "100.00")
        private BigDecimal taxPrice;

        @Schema(description = "产品金额，单位：元", example = "100.00")
        private BigDecimal totalProductPrice;

        @Schema(description = "含税金额，单位：元", example = "113.00")
        private BigDecimal totalPrice;

        @Schema(description = "备注", example = "随便")
        private String remark;


 yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/dal/dataobject/sale/ErpSaleOrderDO.java

@@ -110,6 +110,15 @@
     */
    private String remark;

    // ========== ååŒåŠžå…¬(BPM)审批 ==========

    /**
     * BPM æµç¨‹å®žä¾‹ç¼–号
     *
     * æäº¤å®¡æ‰¹åˆ°ååŒåŠžå…¬åŽç”Ÿæˆçš„流程实例编号，用于关联审批记录
     */
    private String processInstanceId;

    // ========== é”€å”®å‡ºåº“ ==========

    /**

 yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/enums/ErpAuditStatus.java

@@ -17,7 +17,8 @@
@Getter
public enum ErpAuditStatus implements ArrayValuable<Integer> {

    PROCESS(10, "未审核"), // æœªå®¡æ ¸/草稿
    DRAFT(0, "未提交"), // æœªæäº¤/草稿，创建后初始状态，提交后进入审批
    PROCESS(10, "未审核"), // æœªå®¡æ ¸/草稿（历史状态，新数据不再使用）
    APPROVING(15, "审批中"), // å®¡æ‰¹ä¸­
    APPROVE(20, "已审核"), // å®¡æ ¸é€šè¿‡
    CANCEL(30, "已作废"), // å·²ä½œåºŸ/已撤销

 yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/enums/ErrorCodeConstants.java

@@ -95,6 +95,10 @@
    ErrorCode SALE_ORDER_CANCEL_FAIL = new ErrorCode(1_020_201_014, "作废失败，请刷新页面后重试");
    ErrorCode SALE_ORDER_ENABLE_FAIL_NOT_CANCEL = new ErrorCode(1_020_201_015, "启用失败，销售订单({})未作废，只有已作废的订单才能重新启用");
    ErrorCode SALE_ORDER_ENABLE_FAIL = new ErrorCode(1_020_201_016, "启用失败，请刷新页面后重试");
    ErrorCode SALE_ORDER_SUBMIT_FAIL_STATUS = new ErrorCode(1_020_201_017, "提交审批失败，销售订单({})只有未提交或已驳回状态才能提交");
    ErrorCode SALE_ORDER_SUBMIT_FAIL_ITEM_EMPTY = new ErrorCode(1_020_201_018, "提交审批失败，销售订单({})没有订单明细，无法提交");
    ErrorCode SALE_ORDER_BPM_CATEGORY_NOT_EXISTS = new ErrorCode(1_020_201_019, "销售订单审核分类不存在，请先在BPM模块创建销售订单审核流程分类");
    ErrorCode SALE_ORDER_BPM_PROCESS_DEFINITION_NOT_EXISTS = new ErrorCode(1_020_201_020, "销售订单审核分类下没有可用的流程模型，请先创建并发布流程");

    // ========== ERP é”€å”®å‡ºåº“（1-030-202-000） ==========
    ErrorCode SALE_OUT_NOT_EXISTS = new ErrorCode(1_020_202_000, "销售出库单不存在");

 yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/service/sale/ErpSaleOrderService.java

@@ -35,12 +35,30 @@
    void updateSaleOrder(@Valid ErpSaleOrderSaveReqVO updateReqVO);

    /**
     * æ›´æ–°é”€å”®è®¢å•çš„状态
     * æäº¤é”€å”®è®¢å•å®¡æ‰¹ï¼ˆååŒåŠžå…¬ BPM）
     *
     * æœªæäº¤æˆ–已驳回的销售订单可提交，提交后进入协同办公审批流程
     *
     * @param id ç¼–号
     * @param status çŠ¶æ€
     * @param processDefinitionKey æµç¨‹å®šä¹‰çš„标识
     * @param userId æäº¤äººç¼–号
     */
    void updateSaleOrderStatus(Long id, Integer status);
    void submitSaleOrder(Long id, String processDefinitionKey, Long userId);

    /**
     * æ›´æ–°é”€å”®è®¢å•çš„审批状态（协同办公审批结果回调）
     *
     * @param id ç¼–号
     * @param bpmResult BPM å®¡æ‰¹ç»“果（通过/驳回/取消）
     */
    void updateSaleOrderAuditStatus(Long id, Integer bpmResult);

    /**
     * èŽ·å¾—销售订单审批流程定义列表
     *
     * @return æµç¨‹å®šä¹‰åˆ—表（id/key/name）
     */
    List<Map<String, Object>> getSaleOrderApproveProcessDefinitionList();

    /**
     * ä½œåºŸé”€å”®è®¢å•

 yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/service/sale/ErpSaleOrderServiceImpl.java

@@ -5,6 +5,13 @@
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.bpm.dal.dataobject.definition.BpmCategoryDO;
import cn.iocoder.yudao.module.bpm.dal.dataobject.definition.BpmProcessDefinitionInfoDO;
import cn.iocoder.yudao.module.bpm.enums.task.BpmTaskStatusEnum;
import cn.iocoder.yudao.module.bpm.service.definition.BpmCategoryService;
import cn.iocoder.yudao.module.bpm.service.definition.BpmProcessDefinitionService;
import cn.iocoder.yudao.module.crm.api.customer.CrmCustomerApi;
import cn.iocoder.yudao.module.crm.api.contract.CrmContractApi;
import cn.iocoder.yudao.module.erp.controller.admin.sale.vo.order.ErpSaleOrderPageReqVO;
@@ -25,6 +32,7 @@
import cn.iocoder.yudao.module.system.api.storage.StorageAttachmentApi;
import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
import jakarta.annotation.Resource;
import org.flowable.engine.repository.ProcessDefinition;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
@@ -33,8 +41,10 @@
import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

@@ -56,6 +66,15 @@
     * MPS çŠ¶æ€ï¼šå·²å–消（对应 MES æ¨¡å— MesProMpsStatusEnum.CANCELED çš„值 3）
     */
    private static final Integer MPS_STATUS_CANCELED = 3;

    /**
     * BPM é”€å”®è®¢å•å®¡æ‰¹åˆ†ç±»ç¼–码
     */
    private static final String SALE_ORDER_APPROVE_CATEGORY_CODE = "sale_order_approve";
    /**
     * BPM é”€å”®è®¢å•å®¡æ‰¹æµç¨‹å®šä¹‰ Key（提交后进入协同办公审批）
     */
    private static final String SALE_ORDER_APPROVE_PROCESS_DEFINITION_KEY = "sale_order_approve";

    @Resource
    private ErpSaleOrderMapper saleOrderMapper;
@@ -83,6 +102,13 @@
    @Resource
    private StorageAttachmentApi storageAttachmentApi;

    @Resource
    private BpmProcessInstanceApi processInstanceApi;
    @Resource
    private BpmCategoryService bpmCategoryService;
    @Resource
    private BpmProcessDefinitionService bpmProcessDefinitionService;

    @Override
    @Transactional(rollbackFor = Exception.class)
    public Long createSaleOrder(ErpSaleOrderSaveReqVO createReqVO) {
@@ -104,9 +130,9 @@
            throw exception(SALE_ORDER_NO_EXISTS);
        }

        // 2.1 æ’入订单
        // 2.1 æ’入订单（创建后为未提交状态，需手动提交审批到协同办公）
        ErpSaleOrderDO saleOrder = BeanUtils.toBean(createReqVO, ErpSaleOrderDO.class, in -> in
                .setNo(no).setStatus(ErpAuditStatus.PROCESS.getStatus())
                .setNo(no).setStatus(ErpAuditStatus.DRAFT.getStatus())
                .setDepositPrice(ObjectUtil.defaultIfNull(createReqVO.getDepositPrice(), BigDecimal.ZERO))
                .setOutCount(BigDecimal.ZERO).setOutStatus(ErpSaleOrderOutStatusEnum.NOT_OUT.getStatus()));
        calculateTotalPrice(saleOrder, saleOrderItems);
@@ -125,10 +151,12 @@
    public void updateSaleOrder(ErpSaleOrderSaveReqVO updateReqVO) {
        // 1.1 æ ¡éªŒå­˜åœ¨
        ErpSaleOrderDO saleOrder = validateSaleOrderExists(updateReqVO.getId());
        if (ErpAuditStatus.APPROVE.getStatus().equals(saleOrder.getStatus())) {
        // 1.2 æ ¡éªŒçŠ¶æ€ï¼šåªæœ‰æœªæäº¤æˆ–已驳回的销售订单才能修改
        if (!ErpAuditStatus.DRAFT.getStatus().equals(saleOrder.getStatus())
                && !ErpAuditStatus.REJECT.getStatus().equals(saleOrder.getStatus())) {
            throw exception(SALE_ORDER_UPDATE_FAIL_APPROVE, saleOrder.getNo());
        }
        // 1.2 æ ¡éªŒå®¢æˆ·ï¼ˆä½¿ç”¨ CRM å®¢æˆ· API）
        // 1.3 æ ¡éªŒå®¢æˆ·ï¼ˆä½¿ç”¨ CRM å®¢æˆ· API）
        customerApi.validateCustomer(updateReqVO.getCustomerId());
        // 1.3 æ ¡éªŒç»“算账户
        if (updateReqVO.getAccountId() != null) {
@@ -167,31 +195,117 @@

    @Override
    @Transactional(rollbackFor = Exception.class)
    public void updateSaleOrderStatus(Long id, Integer status) {
        boolean approve = ErpAuditStatus.APPROVE.getStatus().equals(status);
        // 1.1 æ ¡éªŒå­˜åœ¨
    public void submitSaleOrder(Long id, String processDefinitionKey, Long userId) {
        // 1. æ ¡éªŒå­˜åœ¨
        ErpSaleOrderDO saleOrder = validateSaleOrderExists(id);
        // 1.2 æ ¡éªŒçŠ¶æ€
        if (saleOrder.getStatus().equals(status)) {
            throw exception(approve ? SALE_ORDER_APPROVE_FAIL : SALE_ORDER_PROCESS_FAIL);
        // 2. æ ¡éªŒçŠ¶æ€ï¼šåªæœ‰æœªæäº¤æˆ–已驳回的销售订单才能提交
        if (!ErpAuditStatus.DRAFT.getStatus().equals(saleOrder.getStatus())
                && !ErpAuditStatus.REJECT.getStatus().equals(saleOrder.getStatus())) {
            throw exception(SALE_ORDER_SUBMIT_FAIL_STATUS, saleOrder.getNo());
        }
        // 1.3 å­˜åœ¨é”€å”®å‡ºåº“单，无法反审核
        BigDecimal outCount = saleOrder.getOutCount() != null ? saleOrder.getOutCount() : BigDecimal.ZERO;
        if (!approve && outCount.compareTo(BigDecimal.ZERO) > 0) {
            throw exception(SALE_ORDER_PROCESS_FAIL_EXISTS_OUT);
        // 3. æ ¡éªŒè®¢å•é¡¹ä¸èƒ½ä¸ºç©º
        List<ErpSaleOrderItemDO> items = saleOrderItemMapper.selectListByOrderId(id);
        if (CollUtil.isEmpty(items)) {
            throw exception(SALE_ORDER_SUBMIT_FAIL_ITEM_EMPTY, saleOrder.getNo());
        }

        // 2. æ›´æ–°çŠ¶æ€
        int updateCount = saleOrderMapper.updateByIdAndStatus(id, saleOrder.getStatus(),
                new ErpSaleOrderDO().setStatus(status));
        if (updateCount == 0) {
            throw exception(approve ? SALE_ORDER_APPROVE_FAIL : SALE_ORDER_PROCESS_FAIL);
        // 4. åˆ›å»º BPM æµç¨‹å®žä¾‹ï¼ˆå®¡æ‰¹åœ¨ååŒåŠžå…¬å®Œæˆï¼‰
        String processInstanceId = processInstanceApi.createProcessInstance(userId,
                new BpmProcessInstanceCreateReqDTO()
                        .setProcessDefinitionKey(processDefinitionKey)
                        .setBusinessKey(String.valueOf(id)));

        // 5. æ›´æ–°é”€å”®è®¢å•çŠ¶æ€ä¸ºå®¡æ‰¹ä¸­ï¼Œè®°å½•æµç¨‹å®žä¾‹ç¼–号
        saleOrderMapper.updateById(new ErpSaleOrderDO()
                .setId(id)
                .setStatus(ErpAuditStatus.APPROVING.getStatus())
                .setProcessInstanceId(processInstanceId));
    }

    @Override
    @Transactional(rollbackFor = Exception.class)
    public void updateSaleOrderAuditStatus(Long id, Integer bpmResult) {
        // 1. æ ¡éªŒå­˜åœ¨
        ErpSaleOrderDO saleOrder = validateSaleOrderExists(id);
        if (!ErpAuditStatus.APPROVING.getStatus().equals(saleOrder.getStatus())) {
            log.warn("[updateSaleOrderAuditStatus] é”€å”®è®¢å•({}) ä¸å¤„于审批中状态，跳过", id);
            return;
        }

        // 2. æ ¹æ®å®¡æ‰¹ç»“果更新状态
        Integer newStatus = convertBpmResultToAuditStatus(bpmResult);
        if (newStatus != null) {
            saleOrderMapper.updateById(new ErpSaleOrderDO()
                    .setId(id).setStatus(newStatus));
        }

        // 3. å®¡æ ¸é€šè¿‡æ—¶ï¼Œä¸ºéœ€è¦ç”Ÿäº§çš„明细创建 MPS
        if (approve) {
        if (ErpAuditStatus.APPROVE.getStatus().equals(newStatus)) {
            createMpsForSaleOrder(id, saleOrder);
        }
    }

    @Override
    public List<Map<String, Object>> getSaleOrderApproveProcessDefinitionList() {
        // 1. æ ¡éªŒåˆ†ç±»å’Œæµç¨‹å®šä¹‰æ˜¯å¦å­˜åœ¨
        validateSaleOrderApproveCategoryAndProcessDefinition();

        // 2. èŽ·å–分类下的流程定义信息
        List<BpmProcessDefinitionInfoDO> definitionInfoList = bpmProcessDefinitionService
                .getProcessDefinitionInfoListByCategory(SALE_ORDER_APPROVE_CATEGORY_CODE);
        if (CollUtil.isEmpty(definitionInfoList)) {
            return Collections.emptyList();
        }

        // 3. éåŽ†èŽ·å–流程定义详情，过滤激活状态，保留最新版本
        Map<String, ProcessDefinition> latestVersionMap = new HashMap<>();
        for (BpmProcessDefinitionInfoDO info : definitionInfoList) {
            ProcessDefinition pd = bpmProcessDefinitionService.getProcessDefinition(info.getProcessDefinitionId());
            if (pd == null || pd.isSuspended()) {
                continue;
            }
            ProcessDefinition existing = latestVersionMap.get(pd.getKey());
            if (existing == null || pd.getVersion() > existing.getVersion()) {
                latestVersionMap.put(pd.getKey(), pd);
            }
        }

        // 4. è¿”回流程定义列表
        List<Map<String, Object>> result = new ArrayList<>();
        for (ProcessDefinition pd : latestVersionMap.values()) {
            Map<String, Object> item = new HashMap<>();
            item.put("id", pd.getId());
            item.put("key", pd.getKey());
            item.put("name", pd.getName());
            result.add(item);
        }
        return result;
    }

    /**
     * æ ¡éªŒé”€å”®è®¢å•å®¡æ‰¹åˆ†ç±»æ˜¯å¦å­˜åœ¨
     */
    private void validateSaleOrderApproveCategoryAndProcessDefinition() {
        // 1. æ ¡éªŒåˆ†ç±»æ˜¯å¦å­˜åœ¨
        List<BpmCategoryDO> categories = bpmCategoryService.getCategoryListByCode(
                Collections.singletonList(SALE_ORDER_APPROVE_CATEGORY_CODE));
        if (CollUtil.isEmpty(categories)) {
            throw exception(SALE_ORDER_BPM_CATEGORY_NOT_EXISTS);
        }
    }

    /**
     * è½¬æ¢ BPM å®¡æ‰¹ç»“果为审核状态
     */
    private Integer convertBpmResultToAuditStatus(Integer bpmResult) {
        if (BpmTaskStatusEnum.APPROVE.getStatus().equals(bpmResult)) {
            return ErpAuditStatus.APPROVE.getStatus();
        } else if (BpmTaskStatusEnum.REJECT.getStatus().equals(bpmResult)) {
            return ErpAuditStatus.REJECT.getStatus();
        } else if (BpmTaskStatusEnum.CANCEL.getStatus().equals(bpmResult)) {
            return ErpAuditStatus.CANCEL.getStatus();
        }
        return null;
    }

    /**
@@ -381,13 +495,14 @@
    @Override
    @Transactional(rollbackFor = Exception.class)
    public void deleteSaleOrder(List<Long> ids) {
        // 1. æ ¡éªŒä¸å¤„于已审批
        // 1. æ ¡éªŒçŠ¶æ€ï¼šåªæœ‰æœªæäº¤æˆ–已驳回的销售订单才能删除
        List<ErpSaleOrderDO> saleOrders = saleOrderMapper.selectByIds(ids);
        if (CollUtil.isEmpty(saleOrders)) {
            return;
        }
        saleOrders.forEach(saleOrder -> {
            if (ErpAuditStatus.APPROVE.getStatus().equals(saleOrder.getStatus())) {
            if (!ErpAuditStatus.DRAFT.getStatus().equals(saleOrder.getStatus())
                    && !ErpAuditStatus.REJECT.getStatus().equals(saleOrder.getStatus())) {
                throw exception(SALE_ORDER_DELETE_FAIL_APPROVE, saleOrder.getNo());
            }
        });

 yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/service/sale/listener/ErpSaleOrderStatusListener.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,54 @@
package cn.iocoder.yudao.module.erp.service.sale.listener;

import cn.iocoder.yudao.module.bpm.api.event.BpmProcessInstanceStatusEvent;
import cn.iocoder.yudao.module.bpm.api.event.BpmProcessInstanceStatusEventListener;
import cn.iocoder.yudao.module.erp.service.sale.ErpSaleOrderService;
import jakarta.annotation.Resource;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;

/**
 * é”€å”®è®¢å•å®¡æ‰¹çŠ¶æ€ç›‘听器
 *
 * ç›‘听 BPM æµç¨‹å®žä¾‹çŠ¶æ€å˜æ›´äº‹ä»¶ï¼Œæ›´æ–°é”€å”®è®¢å•çš„审批状态（协同办公审批后回写）
 *
 * @author è¶…级管理员
 */
@Component
@Slf4j
public class ErpSaleOrderStatusListener extends BpmProcessInstanceStatusEventListener {

    /**
     * é”€å”®è®¢å•å®¡æ‰¹æµç¨‹å®šä¹‰ Key
     */
    private static final String PROCESS_DEFINITION_KEY = "sale_order_approve";

    @Resource
    private ErpSaleOrderService saleOrderService;

    @Override
    protected String getProcessDefinitionKey() {
        return PROCESS_DEFINITION_KEY;
    }

    @Override
    protected void onEvent(BpmProcessInstanceStatusEvent event) {
        Long orderId;
        try {
            orderId = Long.parseLong(event.getBusinessKey());
        } catch (NumberFormatException e) {
            log.warn("[onEvent] businessKey({}) ä¸æ˜¯æœ‰æ•ˆçš„销售订单编号", event.getBusinessKey());
            return;
        }

        log.info("[onEvent] æ”¶åˆ°BPM审批事件，orderId={}, status={}", orderId, event.getStatus());

        try {
            saleOrderService.updateSaleOrderAuditStatus(orderId, event.getStatus());
            log.info("[onEvent] é”€å”®è®¢å•({}) å®¡æ‰¹çŠ¶æ€æ›´æ–°å®Œæˆ", orderId);
        } catch (Exception e) {
            log.error("[onEvent] æ›´æ–°é”€å”®è®¢å•å®¡æ‰¹çŠ¶æ€å¤±è´¥ï¼ŒorderId={}", orderId, e);
        }
    }

}