package cn.iocoder.yudao.module.crm.service.invoice;
|
|
import cn.hutool.core.collection.CollUtil;
|
import cn.hutool.core.collection.ListUtil;
|
import cn.hutool.core.lang.Assert;
|
import cn.hutool.core.util.ObjUtil;
|
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.collection.CollectionUtils;
|
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
|
import cn.iocoder.yudao.framework.common.util.object.ObjectUtils;
|
import cn.iocoder.yudao.module.crm.controller.admin.invoice.vo.invoice.CrmInvoicePageReqVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.invoice.vo.invoice.CrmInvoiceSaveReqVO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.contract.CrmContractDO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.invoice.CrmInvoiceDO;
|
import cn.iocoder.yudao.module.crm.dal.mysql.invoice.CrmInvoiceMapper;
|
import cn.iocoder.yudao.module.crm.dal.redis.no.CrmNoRedisDAO;
|
import cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum;
|
import cn.iocoder.yudao.module.crm.enums.common.CrmBizTypeEnum;
|
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.permission.CrmPermissionService;
|
import cn.iocoder.yudao.module.crm.service.permission.bo.CrmPermissionCreateReqBO;
|
import cn.iocoder.yudao.module.system.api.approval.ApprovalConfigApi;
|
import cn.iocoder.yudao.module.system.api.storage.StorageAttachmentApi;
|
import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
|
import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
|
import com.mzt.logapi.context.LogRecordContext;
|
import com.mzt.logapi.service.impl.DiffParseFunction;
|
import com.mzt.logapi.starter.annotation.LogRecord;
|
import jakarta.annotation.Resource;
|
import lombok.extern.slf4j.Slf4j;
|
import org.springframework.stereotype.Service;
|
import org.springframework.transaction.annotation.Transactional;
|
import org.springframework.validation.annotation.Validated;
|
|
import java.math.BigDecimal;
|
import java.util.Collection;
|
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.security.core.util.SecurityFrameworkUtils.getLoginUserId;
|
import static cn.iocoder.yudao.module.crm.enums.ErrorCodeConstants.*;
|
import static cn.iocoder.yudao.module.crm.enums.LogRecordConstants.*;
|
|
/**
|
* CRM 开票 Service 实现类
|
*
|
* @author 超级管理员
|
*/
|
@Service
|
@Validated
|
@Slf4j
|
public class CrmInvoiceServiceImpl implements CrmInvoiceService {
|
|
/**
|
* CRM 开票审批的业务类型编码
|
*
|
* 与 system_approval_config.biz_type 对应，审批人在「系统管理 - 审批配置」中维护。
|
*/
|
private static final String INVOICE_APPROVE_BIZ_TYPE = "crm_invoice_approve";
|
|
/**
|
* 发票附件的业务记录类型，对应 {@link cn.iocoder.yudao.module.system.enums.storage.StorageRecordTypeEnum#CRM_INVOICE}
|
*/
|
private static final String INVOICE_RECORD_TYPE = "crm_invoice";
|
|
@Resource
|
private CrmInvoiceMapper invoiceMapper;
|
|
@Resource
|
private CrmNoRedisDAO noRedisDAO;
|
|
@Resource
|
private CrmContractService contractService;
|
@Resource
|
private CrmPermissionService permissionService;
|
|
@Resource
|
private AdminUserApi adminUserApi;
|
@Resource
|
private ApprovalConfigApi approvalConfigApi;
|
@Resource
|
private StorageAttachmentApi storageAttachmentApi;
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@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.3 生成开票编号
|
String no = noRedisDAO.generate(CrmNoRedisDAO.INVOICE_PREFIX);
|
if (invoiceMapper.selectByNo(no) != null) {
|
throw exception(INVOICE_NO_EXISTS);
|
}
|
|
// 2.1 插入开票
|
CrmInvoiceDO invoice = BeanUtils.toBean(createReqVO, CrmInvoiceDO.class)
|
.setNo(no).setAuditStatus(CrmAuditStatusEnum.DRAFT.getStatus());
|
invoiceMapper.insert(invoice);
|
|
// 2.2 绑定发票附件
|
if (CollUtil.isNotEmpty(createReqVO.getBlobIds())) {
|
storageAttachmentApi.bindAttachments("file", INVOICE_RECORD_TYPE, invoice.getId(), createReqVO.getBlobIds());
|
}
|
|
// 3. 创建数据权限
|
permissionService.createPermission(new CrmPermissionCreateReqBO().setBizType(CrmBizTypeEnum.CRM_INVOICE.getType())
|
.setBizId(invoice.getId()).setUserId(createReqVO.getOwnerUserId())
|
.setLevel(CrmPermissionLevelEnum.OWNER.getLevel())); // 设置当前操作的人为负责人
|
|
// 4. 记录操作日志上下文
|
LogRecordContext.putVariable("invoice", invoice);
|
return invoice.getId();
|
}
|
|
private void validateInvoicePriceExceedsLimit(CrmInvoiceSaveReqVO reqVO) {
|
// 1. 计算剩余可开票金额，不包括 reqVO 自身（审批中也占用额度，防止累计开票超过合同金额）
|
CrmContractDO contract = contractService.validateContract(reqVO.getContractId());
|
List<CrmInvoiceDO> invoices = invoiceMapper.selectListByContractIdAndStatus(reqVO.getContractId(),
|
List.of(CrmAuditStatusEnum.APPROVE.getStatus(), CrmAuditStatusEnum.PROCESS.getStatus()));
|
if (reqVO.getId() != null) {
|
invoices.removeIf(invoice -> ObjectUtil.equal(invoice.getId(), reqVO.getId()));
|
}
|
BigDecimal notInvoicePrice = contract.getTotalPrice().subtract(
|
CollectionUtils.getSumValue(invoices, CrmInvoiceDO::getPrice, BigDecimal::add, BigDecimal.ZERO));
|
// 2. 校验金额是否超过
|
if (reqVO.getPrice().compareTo(notInvoicePrice) > 0) {
|
throw exception(INVOICE_CREATE_FAIL_PRICE_EXCEEDS_LIMIT, notInvoicePrice);
|
}
|
}
|
|
private void validateRelationDataExists(CrmInvoiceSaveReqVO reqVO) {
|
if (reqVO.getOwnerUserId() != null) {
|
adminUserApi.validateUser(reqVO.getOwnerUserId()); // 校验负责人存在
|
}
|
if (reqVO.getContractId() != null) {
|
CrmContractDO contract = contractService.validateContract(reqVO.getContractId());
|
if (ObjectUtil.notEqual(contract.getAuditStatus(), CrmAuditStatusEnum.APPROVE.getStatus())) {
|
throw exception(INVOICE_CREATE_FAIL_CONTRACT_NOT_APPROVE);
|
}
|
reqVO.setCustomerId(contract.getCustomerId()); // 设置客户编号
|
}
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@LogRecord(type = CRM_INVOICE_TYPE, subType = CRM_INVOICE_UPDATE_SUB_TYPE, bizNo = "{{#updateReqVO.id}}",
|
success = CRM_INVOICE_UPDATE_SUCCESS)
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_INVOICE, bizId = "#updateReqVO.id", level = CrmPermissionLevelEnum.WRITE)
|
public void updateInvoice(CrmInvoiceSaveReqVO updateReqVO) {
|
Assert.notNull(updateReqVO.getId(), "开票编号不能为空");
|
updateReqVO.setOwnerUserId(null).setCustomerId(null).setContractId(null); // 不允许修改的字段
|
// 1.1 校验存在
|
CrmInvoiceDO oldInvoice = validateInvoiceExists(updateReqVO.getId());
|
updateReqVO.setOwnerUserId(oldInvoice.getOwnerUserId()).setCustomerId(oldInvoice.getCustomerId())
|
.setContractId(oldInvoice.getContractId()); // 设置已存在的值
|
// 1.2 校验可开票金额超过上限
|
validateInvoicePriceExceedsLimit(updateReqVO);
|
|
// 1.3 只有草稿、审批中，可以编辑；
|
if (!ObjectUtils.equalsAny(oldInvoice.getAuditStatus(), CrmAuditStatusEnum.DRAFT.getStatus(),
|
CrmAuditStatusEnum.PROCESS.getStatus())) {
|
throw exception(INVOICE_UPDATE_FAIL_EDITING_PROHIBITED);
|
}
|
|
// 2. 更新开票
|
CrmInvoiceDO updateObj = BeanUtils.toBean(updateReqVO, CrmInvoiceDO.class);
|
invoiceMapper.updateById(updateObj);
|
|
// 3. 增量更新发票附件
|
storageAttachmentApi.updateAttachments("file", INVOICE_RECORD_TYPE, updateReqVO.getId(), updateReqVO.getBlobIds());
|
|
// 4. 记录操作日志上下文
|
updateReqVO.setOwnerUserId(oldInvoice.getOwnerUserId()); // 避免操作日志出现“删除负责人”的情况
|
LogRecordContext.putVariable("invoice", oldInvoice);
|
LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT, BeanUtils.toBean(oldInvoice, CrmInvoiceSaveReqVO.class));
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@LogRecord(type = CRM_INVOICE_TYPE, subType = CRM_INVOICE_DELETE_SUB_TYPE, bizNo = "{{#id}}",
|
success = CRM_INVOICE_DELETE_SUCCESS)
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_INVOICE, bizId = "#id", level = CrmPermissionLevelEnum.OWNER)
|
public void deleteInvoice(Long id) {
|
// 1.1 校验存在
|
CrmInvoiceDO invoice = validateInvoiceExists(id);
|
// 1.2 审批通过时，不允许删除
|
if (ObjUtil.equal(invoice.getAuditStatus(), CrmAuditStatusEnum.APPROVE.getStatus())) {
|
throw exception(INVOICE_DELETE_FAIL_IS_APPROVE);
|
}
|
|
// 2.1 删除发票附件
|
storageAttachmentApi.deleteAttachmentsByRecord(INVOICE_RECORD_TYPE, id);
|
// 2.2 删除开票
|
invoiceMapper.deleteById(id);
|
// 2.3 删除数据权限
|
permissionService.deletePermission(CrmBizTypeEnum.CRM_INVOICE.getType(), id);
|
|
// 3. 记录操作日志上下文
|
LogRecordContext.putVariable("invoice", invoice);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@LogRecord(type = CRM_INVOICE_TYPE, subType = CRM_INVOICE_SUBMIT_SUB_TYPE, bizNo = "{{#id}}",
|
success = CRM_INVOICE_SUBMIT_SUCCESS)
|
public void submitInvoice(Long id) {
|
// 1. 校验存在 + 可提交状态（未提交 / 审核不通过）
|
CrmInvoiceDO invoice = validateInvoiceExists(id);
|
if (ObjUtil.notEqual(invoice.getAuditStatus(), CrmAuditStatusEnum.DRAFT.getStatus())
|
&& ObjUtil.notEqual(invoice.getAuditStatus(), CrmAuditStatusEnum.REJECT.getStatus())) {
|
throw exception(INVOICE_SUBMIT_FAIL_NOT_EDITABLE);
|
}
|
|
// 2. 重新校验可开票金额，防止累计开票超过合同金额（草稿期后可能有其他单进入审批中）
|
validateInvoicePriceExceedsLimit(new CrmInvoiceSaveReqVO()
|
.setId(invoice.getId()).setContractId(invoice.getContractId()).setPrice(invoice.getPrice()));
|
|
// 3. 校验审批配置已启用且配置了有效审批人（未配置时抛出带明确提示的业务异常）
|
approvalConfigApi.validateApprovalEnabledAndGetApprovers(INVOICE_APPROVE_BIZ_TYPE);
|
|
// 4. 状态置为审批中，并清空上一轮审核结果，避免残留「审核不通过」的原因
|
invoiceMapper.submitAndResetAuditInfo(id, CrmAuditStatusEnum.PROCESS.getStatus());
|
|
// 5. 记录日志
|
LogRecordContext.putVariable("invoiceNo", invoice.getNo());
|
}
|
|
@Override
|
public Set<Long> getInvoiceApproverUserIds() {
|
return approvalConfigApi.getApproverUserIds(INVOICE_APPROVE_BIZ_TYPE);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void auditInvoice(Long id, Boolean pass, String reviewRemark) {
|
// 1. 校验存在
|
CrmInvoiceDO invoice = validateInvoiceExists(id);
|
// 2. 校验处于审批中状态
|
if (ObjUtil.notEqual(invoice.getAuditStatus(), CrmAuditStatusEnum.PROCESS.getStatus())) {
|
throw exception(INVOICE_AUDIT_FAIL_NOT_PROCESS);
|
}
|
// 3. 校验当前登录用户是该业务类型的审批人（或签：任一人均可审核）
|
Long userId = getLoginUserId();
|
approvalConfigApi.validateApprover(INVOICE_APPROVE_BIZ_TYPE, userId);
|
// 4. 审核不通过：必须填写原因，状态置为审核不通过，退回提交人修改后可重新提交
|
if (!Boolean.TRUE.equals(pass)) {
|
if (StrUtil.isBlank(reviewRemark)) {
|
throw exception(INVOICE_AUDIT_REJECT_REASON_REQUIRED);
|
}
|
invoiceMapper.auditInvoice(id, CrmAuditStatusEnum.REJECT.getStatus(),
|
userId, getUserNickname(userId), reviewRemark);
|
return;
|
}
|
// 5. 审核通过：记录审核人与审核意见，状态置为审核通过
|
// （开票无额外后置业务逻辑，审批通过后即可用于创建回款 / 关联开票选择）
|
invoiceMapper.auditInvoice(id, CrmAuditStatusEnum.APPROVE.getStatus(),
|
userId, getUserNickname(userId), reviewRemark);
|
}
|
|
/**
|
* 获取用户昵称
|
*
|
* @param userId 用户编号
|
* @return 昵称，用户不存在时返回 null
|
*/
|
private String getUserNickname(Long userId) {
|
if (userId == null) {
|
return null;
|
}
|
AdminUserRespDTO user = adminUserApi.getUser(userId);
|
return user == null ? null : user.getNickname();
|
}
|
|
private CrmInvoiceDO validateInvoiceExists(Long id) {
|
CrmInvoiceDO invoice = invoiceMapper.selectById(id);
|
if (invoice == null) {
|
throw exception(INVOICE_NOT_EXISTS);
|
}
|
return invoice;
|
}
|
|
@Override
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_INVOICE, bizId = "#id", level = CrmPermissionLevelEnum.READ)
|
public CrmInvoiceDO getInvoice(Long id) {
|
return invoiceMapper.selectById(id);
|
}
|
|
@Override
|
public List<CrmInvoiceDO> getInvoiceList(Collection<Long> ids) {
|
if (CollUtil.isEmpty(ids)) {
|
return ListUtil.empty();
|
}
|
return invoiceMapper.selectByIds(ids);
|
}
|
|
@Override
|
public PageResult<CrmInvoiceDO> getInvoicePage(CrmInvoicePageReqVO pageReqVO, Long userId) {
|
return invoiceMapper.selectPage(pageReqVO, userId);
|
}
|
|
@Override
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CUSTOMER, bizId = "#pageReqVO.customerId", level = CrmPermissionLevelEnum.READ)
|
public PageResult<CrmInvoiceDO> getInvoicePageByCustomerId(CrmInvoicePageReqVO pageReqVO) {
|
return invoiceMapper.selectPageByCustomerId(pageReqVO);
|
}
|
|
@Override
|
public Long getAuditInvoiceCount(Long userId) {
|
return invoiceMapper.selectCountByAudit(userId);
|
}
|
|
@Override
|
public List<CrmInvoiceDO> getInvoiceListByContractIdAndStatus(Long contractId, Collection<Integer> auditStatuses) {
|
return invoiceMapper.selectListByContractIdAndStatus(contractId, auditStatuses);
|
}
|
|
@Override
|
public Map<Long, BigDecimal> getInvoicePriceMapByContractId(Collection<Long> contractIds) {
|
return invoiceMapper.selectInvoicePriceMapByContractId(contractIds);
|
}
|
|
@Override
|
public Long getInvoiceCountByContractId(Long contractId) {
|
return invoiceMapper.selectCountByContractId(contractId);
|
}
|
|
}
|
