package cn.iocoder.yudao.module.crm.controller.admin.receivable.vo.receivable;
|
|
import cn.iocoder.yudao.framework.common.validation.InEnum;
|
import cn.iocoder.yudao.module.crm.enums.receivable.CrmReceivableReturnTypeEnum;
|
import cn.iocoder.yudao.module.crm.framework.operatelog.core.*;
|
import com.mzt.logapi.starter.annotation.DiffLogField;
|
import io.swagger.v3.oas.annotations.media.Schema;
|
import jakarta.validation.constraints.NotNull;
|
import lombok.Data;
|
|
import java.math.BigDecimal;
|
import java.time.LocalDateTime;
|
import java.util.List;
|
|
@Schema(description = "管理后台 - CRM 回款新增/修改 Request VO")
|
@Data
|
public class CrmReceivableSaveReqVO {
|
|
@Schema(description = "编号", example = "25787")
|
private Long id;
|
|
@Schema(description = "负责人编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
|
@DiffLogField(name = "负责人", function = SysAdminUserParseFunction.NAME)
|
@NotNull(message = "负责人编号不能为空")
|
private Long ownerUserId;
|
|
@Schema(description = "客户编号", example = "2")
|
@DiffLogField(name = "客户", function = CrmCustomerParseFunction.NAME)
|
private Long customerId; // 该字段不通过前端传递，而是 contractId 查询出来设置进去
|
|
@Schema(description = "合同编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
|
@DiffLogField(name = "合同", function = CrmContractParseFunction.NAME)
|
@NotNull(message = "合同编号不能为空")
|
private Long contractId;
|
|
@Schema(description = "关联的开票编号，可不填（未开票先回款）", example = "25787")
|
@DiffLogField(name = "关联开票", function = CrmInvoiceParseFunction.NAME)
|
private Long invoiceId;
|
|
@Schema(description = "回款计划编号，可不填", example = "1024")
|
@DiffLogField(name = "回款计划", function = CrmReceivablePlanParseFunction.NAME)
|
private Long planId;
|
|
@Schema(description = "回款方式", example = "2")
|
@DiffLogField(name = "回款方式", function = CrmReceivableReturnTypeParseFunction.NAME)
|
@InEnum(CrmReceivableReturnTypeEnum.class)
|
private Integer returnType;
|
|
@Schema(description = "回款金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "9000")
|
@DiffLogField(name = "回款金额")
|
@NotNull(message = "回款金额不能为空")
|
private BigDecimal price;
|
|
@Schema(description = "回款日期", requiredMode = Schema.RequiredMode.REQUIRED, example = "2024-02-02")
|
@NotNull(message = "回款日期不能为空")
|
@DiffLogField(name = "回款日期")
|
private LocalDateTime returnTime;
|
|
@Schema(description = "备注", example = "备注")
|
@DiffLogField(name = "备注")
|
private String remark;
|
|
@Schema(description = "核销明细（不传时按关联开票自动生成一条）")
|
private List<ReceivableItem> items;
|
|
@Schema(description = "核销明细")
|
@Data
|
public static class ReceivableItem {
|
|
@Schema(description = "业务类型：20销售订单 21销售出库 23开票", requiredMode = Schema.RequiredMode.REQUIRED)
|
private Integer bizType;
|
|
@Schema(description = "业务编号", requiredMode = Schema.RequiredMode.REQUIRED)
|
private Long bizId;
|
|
@Schema(description = "业务单号（不传时后端按 bizId 查询回填）")
|
private String bizNo;
|
|
@Schema(description = "应收金额")
|
private BigDecimal totalPrice;
|
|
@Schema(description = "本次核销金额", requiredMode = Schema.RequiredMode.REQUIRED)
|
private BigDecimal receiptPrice;
|
|
@Schema(description = "备注")
|
private String remark;
|
|
}
|
|
}
|
