package cn.iocoder.yudao.module.aftersales.service.cancellation; import cn.iocoder.yudao.framework.common.pojo.PageParam; import cn.iocoder.yudao.framework.common.pojo.PageResult; import cn.iocoder.yudao.framework.common.util.object.BeanUtils; import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper; import cn.iocoder.yudao.module.aftersales.controller.admin.cancellation.vo.AfterSaleCancellationApproveReqVO; import cn.iocoder.yudao.module.aftersales.controller.admin.cancellation.vo.AfterSaleCancellationSaveReqVO; import cn.iocoder.yudao.module.aftersales.controller.admin.returnobj.vo.AfterSaleReturnSaveReqVO; import cn.iocoder.yudao.module.aftersales.dal.dataobject.cancellation.AfterSaleCancellationDO; import cn.iocoder.yudao.module.aftersales.dal.mysql.cancellation.AfterSaleCancellationMapper; import cn.iocoder.yudao.module.aftersales.dal.redis.no.AfterSaleNoRedisDAO; import cn.iocoder.yudao.module.aftersales.service.returnobj.AfterSaleReturnService; import cn.iocoder.yudao.module.crm.api.contract.CrmContractApi; import cn.iocoder.yudao.module.erp.api.sale.ErpSaleOrderApi; import jakarta.annotation.Resource; import lombok.extern.slf4j.Slf4j; import org.springframework.dao.DuplicateKeyException; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import java.time.LocalDateTime; import java.util.Objects; import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception; import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.invalidParamException; import static cn.iocoder.yudao.module.aftersales.enums.ErrorCodeConstants.*; /** * 售后统一退单/变更受理。 * *
把「客户退货、合同变更、合同终止」收敛为同一受理流程,不依赖 ERP 销售订单: *
下游失败(如销售订单仍有关联生产计划)会整体回滚,受理单保持「待审批」,
* 由调用方看到具体原因,避免出现「审批通过了但业务没执行」的不一致状态。
*
* @return 通过时生成的退货单编号(非退货类型为 null)
*/
@Transactional(rollbackFor = Exception.class)
public Long approve(AfterSaleCancellationApproveReqVO req, Long userId) {
if (!Boolean.TRUE.equals(req.getApproved())
&& (req.getRemark() == null || req.getRemark().isBlank())) {
throw exception(CANCELLATION_APPROVE_REMARK_REQUIRED);
}
AfterSaleCancellationDO task = get(req.getId());
if (!Objects.equals(task.getStatus(), ST_PENDING)) throw exception(CANCELLATION_APPROVE_FAIL_STATUS);
// 驳回:只改状态,不执行下游
if (!Boolean.TRUE.equals(req.getApproved())) {
if (mapper.update(null, new LambdaUpdateWrapper 不吞异常:任一步失败直接抛出,由 {@link #approve} 的事务整体回滚,
* 保证「审批通过」与「下游已执行」永远一致。
*/
private Long executeDownstream(AfterSaleCancellationDO task, Long userId) {
Long returnId = null;
String remark;
{
switch (task.getType()) {
case "RETURN" -> {
var vo = new AfterSaleReturnSaveReqVO();
vo.setTicketId(task.getTicketId());
vo.setCustomerId(task.getCustomerId());
vo.setReturnType(task.getReturnType() == null ? 1 : task.getReturnType());
vo.setReturnReason(task.getReason());
returnId = returnService.createReturn(vo, userId);
if (task.getSaleOrderId() != null) {
erpSaleOrderApi.cancelSaleOrder(task.getSaleOrderId()).getCheckedData();
remark = "已生成退货单 " + returnId
+ ",并作废销售订单 " + task.getSaleOrderId();
} else {
remark = "已生成退货单 " + returnId;
}
}
case "CONTRACT_TERMINATE" -> {
crmContractApi.updateContractStatus(task.getContractId(), CRM_CONTRACT_INVALID).getCheckedData();
// 若关联 ERP 销售订单,一并作废(会被未取消的 MPS 计划拦截)
if (task.getSaleOrderId() != null) {
erpSaleOrderApi.cancelSaleOrder(task.getSaleOrderId()).getCheckedData();
remark = "已作废 CRM 合同 " + task.getContractId()
+ ",并作废销售订单 " + task.getSaleOrderId();
} else {
remark = "已作废 CRM 合同 " + task.getContractId();
}
}
case "CONTRACT_CHANGE" -> remark = "变更受理已通过;CRM 合同内容请按附件同步维护";
default -> throw invalidParamException("未知受理类型:" + task.getType());
}
}
var update = new AfterSaleCancellationDO();
update.setId(task.getId());
update.setExecuteRemark(remark);
if (returnId != null) update.setReturnId(returnId);
mapper.updateById(update);
return returnId;
}
/** 按类型校验必填:退货需工单;合同变更/终止需合同。 */
private void validateByType(AfterSaleCancellationSaveReqVO req) {
switch (req.getType()) {
case "RETURN" -> {
if (req.getTicketId() == null) throw exception(CANCELLATION_RETURN_TICKET_REQUIRED);
}
case "CONTRACT_CHANGE", "CONTRACT_TERMINATE" -> {
if (req.getContractId() == null) throw exception(CANCELLATION_CONTRACT_REQUIRED);
}
default -> { }
}
}
}