| | |
| | | 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; |
| | |
| | | import cn.iocoder.yudao.module.crm.enums.permission.CrmPermissionLevelEnum; |
| | | import cn.iocoder.yudao.module.crm.framework.permission.core.annotations.CrmPermission; |
| | | import cn.iocoder.yudao.module.crm.service.contract.CrmContractService; |
| | | 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; |
| | |
| | | */ |
| | | private static final String INVOICE_RECORD_TYPE = "crm_invoice"; |
| | | |
| | | /** |
| | | * 销售订单「已审核」状态,对应 ErpAuditStatus.APPROVE |
| | | */ |
| | | private static final Integer SALE_ORDER_APPROVE_STATUS = 20; |
| | | |
| | | @Resource |
| | | private CrmInvoiceMapper invoiceMapper; |
| | | |
| | |
| | | @Resource |
| | | private CrmContractService contractService; |
| | | @Resource |
| | | private CrmCustomerService customerService; |
| | | @Resource |
| | | private CrmPermissionService permissionService; |
| | | |
| | | @Resource |
| | | private ErpSaleOrderApi erpSaleOrderApi; |
| | | @Resource |
| | | private AdminUserApi adminUserApi; |
| | | @Resource |
| | |
| | | @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 |
| | |
| | | |
| | | // 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 绑定发票附件 |
| | |
| | | + "」完全相同(可能是本次导入前面的行,也可能是系统中已有单据)。请勿重复导入;如确需重新导入,请先在「营销管理-开票管理」中删除该开票单后重试"); |
| | | } |
| | | |
| | | 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; |
| | | } |
| | | // 1. 计算剩余可开票金额,不包括 reqVO 自身(审批中也占用额度,防止累计开票超过合同金额) |
| | | CrmContractDO contract = contractService.validateContract(reqVO.getContractId()); |
| | | BigDecimal notInvoicePrice = getRemainingInvoicePrice(contract, reqVO.getId()); |
| | |
| | | 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()); // 校验客户存在 |
| | | } |
| | | if (reqVO.getContractId() != null) { |
| | | CrmContractDO contract = contractService.validateContract(reqVO.getContractId()); |
| | |
| | | } |
| | | reqVO.setCustomerId(contract.getCustomerId()); // 设置客户编号 |
| | | } |
| | | return saleOrder; |
| | | } |
| | | |
| | | @Override |
| | |
| | | // 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(), |
| | |
| | | } |
| | | |
| | | // 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. 增量更新发票附件 |
| | |
| | | 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() |
| | |
| | | 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); |
| | | } |
| | | |
| | | } |