gaoluyang
2026-11-04 ccff3913e0e6854a3811788d5d41614463110095
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/service/invoice/CrmInvoiceServiceImpl.java
@@ -6,6 +6,7 @@
import cn.hutool.core.util.ObjUtil;
import cn.hutool.core.util.ObjectUtil;
import cn.hutool.core.util.StrUtil;
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;
@@ -29,6 +30,8 @@
import cn.iocoder.yudao.module.crm.service.customer.CrmCustomerService;
import cn.iocoder.yudao.module.crm.service.permission.CrmPermissionService;
import cn.iocoder.yudao.module.crm.service.permission.bo.CrmPermissionCreateReqBO;
import cn.iocoder.yudao.module.erp.api.sale.ErpSaleOrderApi;
import cn.iocoder.yudao.module.erp.api.sale.dto.ErpSaleOrderRespDTO;
import cn.iocoder.yudao.module.system.api.storage.StorageAttachmentApi;
import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
import com.mzt.logapi.context.LogRecordContext;
@@ -77,6 +80,11 @@
     */
    private static final String INVOICE_RECORD_TYPE = "crm_invoice";
    /**
     * 销售订单「已审核」状态,对应 ErpAuditStatus.APPROVE
     */
    private static final Integer SALE_ORDER_APPROVE_STATUS = 20;
    @Resource
    private CrmInvoiceMapper invoiceMapper;
@@ -91,6 +99,8 @@
    private CrmPermissionService permissionService;
    @Resource
    private ErpSaleOrderApi erpSaleOrderApi;
    @Resource
    private AdminUserApi adminUserApi;
    @Resource
    private BpmProcessInstanceApi bpmProcessInstanceApi;
@@ -102,10 +112,10 @@
    @LogRecord(type = CRM_INVOICE_TYPE, subType = CRM_INVOICE_CREATE_SUB_TYPE, bizNo = "{{#invoice.id}}",
            success = CRM_INVOICE_CREATE_SUCCESS)
    public Long createInvoice(CrmInvoiceSaveReqVO createReqVO) {
        // 1.1 校验可开票金额超过上限
        validateInvoicePriceExceedsLimit(createReqVO);
        // 1.2 校验关联数据存在
        validateRelationDataExists(createReqVO);
        // 1.1 校验关联数据存在(关联销售订单时返回订单,用于回填订单号、校验开票额度)
        ErpSaleOrderRespDTO saleOrder = validateRelationDataExists(createReqVO);
        // 1.2 校验可开票金额超过上限
        validateInvoicePriceExceedsLimit(createReqVO, saleOrder);
        // 1.3 确定开票编号(前端填写则用自定义单号,留空则自动生成),并校验唯一性
        String customNo = StrUtil.trim(createReqVO.getNo());
        String no = StrUtil.isNotBlank(customNo) ? customNo
@@ -116,7 +126,8 @@
        // 2.1 插入开票
        CrmInvoiceDO invoice = BeanUtils.toBean(createReqVO, CrmInvoiceDO.class)
                .setNo(no).setAuditStatus(CrmAuditStatusEnum.DRAFT.getStatus());
                .setNo(no).setAuditStatus(CrmAuditStatusEnum.DRAFT.getStatus())
                .setSaleOrderNo(saleOrder != null ? saleOrder.getNo() : null);
        invoiceMapper.insert(invoice);
        // 2.2 绑定发票附件
@@ -349,7 +360,21 @@
                + "」完全相同(可能是本次导入前面的行,也可能是系统中已有单据)。请勿重复导入;如确需重新导入,请先在「营销管理-开票管理」中删除该开票单后重试");
    }
    private void validateInvoicePriceExceedsLimit(CrmInvoiceSaveReqVO reqVO) {
    private void validateInvoicePriceExceedsLimit(CrmInvoiceSaveReqVO reqVO, ErpSaleOrderRespDTO saleOrder) {
        // 关联了销售订单的,开票金额按销售订单金额校验(优先级高于合同)
        if (saleOrder != null) {
            BigDecimal remainPrice = getRemainingInvoicePriceBySaleOrder(saleOrder, reqVO.getId());
            if (reqVO.getPrice().compareTo(remainPrice) > 0) {
                throw new ServiceException(INVOICE_CREATE_FAIL_PRICE_EXCEEDS_LIMIT.getCode(),
                        StrUtil.format("开票金额超过销售订单[{}]剩余可开票金额:该订单金额 {} 元,已开票(含审批中){} 元,"
                                        + "剩余可开票 {} 元,本次填写 {} 元。请调整开票金额,或先在「营销管理-开票管理」核对订单已开票金额后重试。",
                                saleOrder.getNo(), saleOrder.getTotalPrice().stripTrailingZeros().toPlainString(),
                                saleOrder.getTotalPrice().subtract(remainPrice).stripTrailingZeros().toPlainString(),
                                remainPrice.stripTrailingZeros().toPlainString(),
                                reqVO.getPrice().stripTrailingZeros().toPlainString()));
            }
            return;
        }
        // 未关联合同的(合同非必填),不占用任何合同的开票额度,无需校验上限
        if (reqVO.getContractId() == null) {
            return;
@@ -379,9 +404,47 @@
                CollectionUtils.getSumValue(invoices, CrmInvoiceDO::getPrice, BigDecimal::add, BigDecimal.ZERO));
    }
    private void validateRelationDataExists(CrmInvoiceSaveReqVO reqVO) {
    /**
     * 计算销售订单剩余可开票金额(审批中、审核通过的开票占用额度)
     *
     * @param saleOrder       销售订单
     * @param excludeInvoiceId 需排除的开票编号,可为空
     */
    private BigDecimal getRemainingInvoicePriceBySaleOrder(ErpSaleOrderRespDTO saleOrder, Long excludeInvoiceId) {
        List<CrmInvoiceDO> invoices = invoiceMapper.selectListBySaleOrderIdAndStatus(saleOrder.getId(),
                List.of(CrmAuditStatusEnum.APPROVE.getStatus(), CrmAuditStatusEnum.PROCESS.getStatus()));
        if (excludeInvoiceId != null) {
            invoices.removeIf(invoice -> ObjectUtil.equal(invoice.getId(), excludeInvoiceId));
        }
        return ObjectUtil.defaultIfNull(saleOrder.getTotalPrice(), BigDecimal.ZERO).subtract(
                CollectionUtils.getSumValue(invoices, CrmInvoiceDO::getPrice, BigDecimal::add, BigDecimal.ZERO));
    }
    private ErpSaleOrderRespDTO validateRelationDataExists(CrmInvoiceSaveReqVO reqVO) {
        if (reqVO.getOwnerUserId() != null) {
            adminUserApi.validateUser(reqVO.getOwnerUserId()); // 校验负责人存在
        }
        // 关联销售订单:订单必须已审核通过,客户以订单为准
        ErpSaleOrderRespDTO saleOrder = null;
        if (reqVO.getSaleOrderId() != null) {
            saleOrder = erpSaleOrderApi.getSaleOrder(reqVO.getSaleOrderId()).getCheckedData();
            if (saleOrder == null) {
                throw new ServiceException(INVOICE_CREATE_FAIL_SALE_ORDER_NOT_EXISTS.getCode(),
                        StrUtil.format("所选销售订单不存在(编号 ID={}),可能已被删除,请刷新后重新选择", reqVO.getSaleOrderId()));
            }
            if (!SALE_ORDER_APPROVE_STATUS.equals(saleOrder.getStatus())) {
                throw new ServiceException(INVOICE_CREATE_FAIL_SALE_ORDER_NOT_APPROVE.getCode(),
                        StrUtil.format("所选销售订单[{}]当前不是「已审核」状态,只有审核通过的销售订单才能开票。"
                                + "请先在【ERP-销售订单】完成该订单审批,或改选其他已审核通过的销售订单", saleOrder.getNo()));
            }
            reqVO.setCustomerId(saleOrder.getCustomerId());
            // 合同带出:仅当订单关联的合同存在且已审核通过时回填,避免因合同未审批挡住按订单开票
            if (reqVO.getContractId() == null && saleOrder.getContractId() != null) {
                CrmContractDO contract = contractService.getContract(saleOrder.getContractId());
                if (contract != null && ObjectUtil.equal(contract.getAuditStatus(), CrmAuditStatusEnum.APPROVE.getStatus())) {
                    reqVO.setContractId(contract.getId());
                }
            }
        }
        if (reqVO.getCustomerId() != null) {
            customerService.validateCustomer(reqVO.getCustomerId()); // 校验客户存在
@@ -393,6 +456,7 @@
            }
            reqVO.setCustomerId(contract.getCustomerId()); // 设置客户编号
        }
        return saleOrder;
    }
    @Override
@@ -406,9 +470,11 @@
        // 1.1 校验存在
        CrmInvoiceDO oldInvoice = validateInvoiceExists(updateReqVO.getId());
        updateReqVO.setOwnerUserId(oldInvoice.getOwnerUserId()).setCustomerId(oldInvoice.getCustomerId())
                .setContractId(oldInvoice.getContractId()); // 设置已存在的值
        // 1.2 校验可开票金额超过上限
        validateInvoicePriceExceedsLimit(updateReqVO);
                .setContractId(oldInvoice.getContractId()).setSaleOrderId(oldInvoice.getSaleOrderId()); // 设置已存在的值
        // 1.2 校验可开票金额超过上限(销售订单不可修改,按原订单校验额度)
        ErpSaleOrderRespDTO saleOrder = updateReqVO.getSaleOrderId() != null
                ? erpSaleOrderApi.getSaleOrder(updateReqVO.getSaleOrderId()).getCheckedData() : null;
        validateInvoicePriceExceedsLimit(updateReqVO, saleOrder);
        // 1.3 只有草稿、审批中,可以编辑;
        if (!ObjectUtils.equalsAny(oldInvoice.getAuditStatus(), CrmAuditStatusEnum.DRAFT.getStatus(),
@@ -417,7 +483,9 @@
        }
        // 2. 更新开票
        CrmInvoiceDO updateObj = BeanUtils.toBean(updateReqVO, CrmInvoiceDO.class);
        CrmInvoiceDO updateObj = BeanUtils.toBean(updateReqVO, CrmInvoiceDO.class)
                // 销售订单不可修改,沿用原值
                .setSaleOrderId(oldInvoice.getSaleOrderId()).setSaleOrderNo(oldInvoice.getSaleOrderNo());
        invoiceMapper.updateById(updateObj);
        // 3. 增量更新发票附件
@@ -480,9 +548,12 @@
            throw exception(INVOICE_SUBMIT_FAIL_NOT_DRAFT);
        }
        // 1.1 重新校验可开票金额,防止累计开票超过合同金额(草稿期后可能有其他单进入审批中)
        // 1.1 重新校验可开票金额,防止累计开票超过合同/销售订单金额(草稿期后可能有其他单进入审批中)
        ErpSaleOrderRespDTO saleOrder = invoice.getSaleOrderId() != null
                ? erpSaleOrderApi.getSaleOrder(invoice.getSaleOrderId()).getCheckedData() : null;
        validateInvoicePriceExceedsLimit(new CrmInvoiceSaveReqVO()
                .setId(invoice.getId()).setContractId(invoice.getContractId()).setPrice(invoice.getPrice()));
                .setId(invoice.getId()).setContractId(invoice.getContractId())
                .setSaleOrderId(invoice.getSaleOrderId()).setPrice(invoice.getPrice()), saleOrder);
        // 2. 创建开票审批流程实例
        String processInstanceId = bpmProcessInstanceApi.createProcessInstance(userId, new BpmProcessInstanceCreateReqDTO()
@@ -549,4 +620,13 @@
        return invoiceMapper.selectCountByContractId(contractId);
    }
    @Override
    public BigDecimal getSaleOrderRemainInvoicePrice(Long saleOrderId) {
        ErpSaleOrderRespDTO saleOrder = erpSaleOrderApi.getSaleOrder(saleOrderId).getCheckedData();
        if (saleOrder == null) {
            throw exception(INVOICE_CREATE_FAIL_SALE_ORDER_NOT_EXISTS);
        }
        return getRemainingInvoicePriceBySaleOrder(saleOrder, null);
    }
}