✨ 应收正式结算单同步金蝶财务应收单（A302-2保存+A302-4幂等预检与定时勾稽纠偏）

2026-09-21 19:14:05 +08:00
parent b3eee6347b
commit 82b347cb18
8 changed files with 573 additions and 37 deletions
@@ -21,6 +21,8 @@ import java.time.LocalDateTime;

 /**
 * 正式结算单实体类
+ * <p>
+ * 结算单主表，明细快照见 {@link FormalSettlementDetail}，合计费用见 {@link FormalSettlementSummaryFee}
 *
 * @author Chill
 */
@@ -30,38 +32,140 @@ import java.time.LocalDateTime;
@Schema(description = "正式结算单")
 public class FormalSettlement extends TenantEntity {
 	@Serial private static final long serialVersionUID = 1L;
+	/**
+	 * 正式结算单号（同租户唯一）
+	 */
 	private String formalSettlementNo;
+	/**
+	 * 来源类型：预结算合并/应收应付/混合来源
+	 */
 	private String sourceType;
+	/**
+	 * 结算类型：receivable-应收 payable-应付
+	 */
 	private String settlementType;
+	/**
+	 * 所属项目ID
+	 */
 	private Long projectId;
+	/**
+	 * 所属项目名称
+	 */
 	private String projectName;
+	/**
+	 * 所属组织ID
+	 */
 	private Long deptId;
+	/**
+	 * 所属组织名称
+	 */
 	private String deptName;
+	/**
+	 * 结算合同ID
+	 */
 	private Long contractId;
+	/**
+	 * 结算合同编号
+	 */
 	private String contractNo;
+	/**
+	 * 结算合同名称
+	 */
 	private String contractName;
+	/**
+	 * 付款方名称
+	 */
 	private String payerName;
+	/**
+	 * 收款方名称
+	 */
 	private String payeeName;
+	/**
+	 * 结算币种，默认 RMB
+	 */
 	private String currency;
+	/**
+	 * 结算金额（结算币种，含全部合计费用）
+	 */
 	private BigDecimal settlementAmount;
+	/**
+	 * 本位币，默认 RMB
+	 */
 	private String localCurrency;
+	/**
+	 * 本位币结算金额 = 结算金额 × 结算汇率
+	 */
 	private BigDecimal localSettlementAmount;
+	/**
+	 * 已申请付款金额，含来源预结算的预付
+	 */
 	private BigDecimal appliedPaymentAmount;
+	/**
+	 * 已收/已付金额合计，含来源预结算的预付
+	 */
 	private BigDecimal paidAmount;
+	/**
+	 * 剩余可付金额 = 结算金额 - 已收已付合计，最小为 0
+	 */
 	private BigDecimal remainingPayableAmount;
+	/**
+	 * 已开票/已收票金额，取开票申请与收票登记的分摊合计
+	 */
 	private BigDecimal invoiceAmount;
+	/**
+	 * 汇率日期
+	 */
 	private LocalDate exchangeRateDate;
+	/**
+	 * 结算汇率
+	 */
 	private BigDecimal exchangeRate;
+	/**
+	 * 开票状态（应收为开票、应付为收票）：unreceived-未开票 partial-部分开票 completed-已开票
+	 */
 	private String invoiceStatus;
+	/**
+	 * 收付款状态：unpaid-未收付款 partial-部分收付款 paid-已收付款
+	 */
 	private String paymentStatus;
+	/**
+	 * 审核状态：draft-草稿 reviewing-审批中 approved-审批通过 returned-已驳回 voided-已作废
+	 */
 	private String approvalStatus;
+	/**
+	 * 当前审批节点，如「草稿」「财务审核」「审批通过」
+	 */
 	private String currentNode;
+	/**
+	 * 当前处理人姓名
+	 */
 	private String currentProcessor;
+	/**
+	 * 金蝶单据编号
+	 */
 	private String kingdeeBillNo;
+	/**
+	 * 金蝶同步状态：unsynced-未同步 synced-已同步 failed-同步失败
+	 */
 	private String kingdeeSyncStatus;
+	/**
+	 * 附件JSON
+	 */
 	private String attachmentsJson;
+	/**
+	 * 备注
+	 */
 	private String remark;
+	/**
+	 * 审核通过时间
+	 */
 	private LocalDateTime approvedTime;
+	/**
+	 * 同步金蝶时间
+	 */
 	private LocalDateTime syncedTime;
+	/**
+	 * 作废原因，驳回时记录驳回原因
+	 */
 	private String voidReason;
 }