✨ 金蝶附件同步（A902）：五类单据推送后联带上传附件、独立同步状态与列表聚合

2026-09-24 13:26:54 +08:00
parent a17dd826ec
commit c2f3a48c0e
28 changed files with 1589 additions and 38 deletions
@@ -144,6 +144,10 @@ public class FormalSettlement extends TenantEntity {
 	 * 金蝶单据编号
 	 */
 	private String kingdeeBillNo;
+	/**
+	 * 金蝶单据id（星瀚内部主键，A902 附件上传定位用）
+	 */
+	private String kingdeeBillId;
 	/**
 	 * 金蝶同步状态：unsynced-未同步 synced-已同步 failed-同步失败
 	 */
@@ -159,6 +159,10 @@ public class InvoiceApplication extends TenantEntity {
 	 * 金蝶开票申请单编号（A303-1 返回，A303-5 查询 serialNo）
 	 */
 	private String kingdeeBillNo;
+	/**
+	 * 金蝶开票申请单id（星瀚内部主键，A902 附件上传定位用）
+	 */
+	private String kingdeeBillId;
 	/**
 	 * 金蝶同步状态：unsynced-未同步 synced-已同步 failed-同步失败 invoiced-开票完成（终态）
 	 */
@@ -152,6 +152,10 @@ public class InvoiceReceipt extends TenantEntity {
 	 * 金蝶收票单单据编号（A303-2 批量保存生成/幂等预检命中回填）
 	 */
 	private String kingdeeReceivedInvoiceNo;
+	/**
+	 * 金蝶收票单id（星瀚内部主键，A902 附件上传定位用）
+	 */
+	private String kingdeeReceivedInvoiceId;
 	/**
 	 * 收票单推送状态（unsynced 未推送 / pushed 已保存收票单 / assigned 已指定应付 / failed 推送失败）
 	 */
@@ -0,0 +1,84 @@
+/**
+ * BladeX Commercial License Agreement
+ * Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
+ * <p>
+ * Use of this software is governed by the Commercial License Agreement
+ * obtained after purchasing a license from BladeX.
+ * <p>
+ * 1. This software is for development use only under a valid license
+ * from BladeX.
+ * <p>
+ * 2. Redistribution of this software's source code to any third party
+ * without a commercial license is strictly prohibited.
+ * <p>
+ * 3. Licensees may copyright their own code but cannot use segments
+ * from this software for such purposes. Copyright of this software
+ * remains with BladeX.
+ * <p>
+ * Using this software signifies agreement to this License, and the software
+ * must not be used for illegal purposes.
+ * <p>
+ * THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
+ * not liable for any claims arising from secondary or illegal development.
+ * <p>
+ * Author: Chill Zhuang (bladejava@qq.com)
+ */
+package org.springblade.transport.pojo.entity;
+
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.fasterxml.jackson.databind.annotation.JsonSerialize;
+import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.springblade.core.tenant.mp.TenantEntity;
+
+import java.io.Serial;
+import java.time.LocalDateTime;
+
+/**
+ * 金蝶附件同步实体类（A902 附件上传到指定单据，单附件行级状态）
+ *
+ * @author Chill
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@TableName("blade_kingdee_attachment_sync")
+@Schema(description = "金蝶附件同步")
+public class KingdeeAttachmentSync extends TenantEntity {
+	@Serial
+	private static final long serialVersionUID = 1L;
+	/**
+	 * 业务单据类型（pay_application/formal_settlement_ap/formal_settlement_ar/invoice_receipt/invoice_application）
+	 */
+	private String bizType;
+	/**
+	 * 业务单据id
+	 */
+	@JsonSerialize(using = ToStringSerializer.class)
+	private Long bizId;
+	/**
+	 * 附件幂等键（用户附件=附件url；发票文件=A801-2 的 path）
+	 */
+	private String attachmentKey;
+	/**
+	 * 附件名称（展示/排查用）
+	 */
+	private String attachmentName;
+	/**
+	 * 金蝶侧文件路径（A902 返回 data.path）
+	 */
+	private String kingdeePath;
+	/**
+	 * 同步状态：1 成功 / 0 失败
+	 */
+	private Integer syncStatus;
+	/**
+	 * 失败原因（超限/下载失败/金蝶报错）
+	 */
+	private String failReason;
+	/**
+	 * 最近上传时间
+	 */
+	private LocalDateTime syncTime;
+}
@@ -39,6 +39,9 @@ public class FormalSettlementVO extends FormalSettlement {
 	@TableField(exist = false) private String ids;
 	@TableField(exist = false) private String approvalStatusName;
 	@TableField(exist = false) private String settlementTypeName;
+	@TableField(exist = false) private Integer attachmentCount;
+	@TableField(exist = false) private String attachmentSyncStatus;
+	@TableField(exist = false) private String attachmentSyncStatusName;
 	@TableField(exist = false) private String preSettlementNos;
 	@TableField(exist = false) private String preSettlementNo;
 	@TableField(exist = false) private List<FormalSettlementSource> sources;
@@ -49,6 +49,9 @@ public class InvoiceApplicationVO extends InvoiceApplication {
 	@TableField(exist = false) private String settlementNos;
 	@TableField(exist = false) private String approvalStatusName;
 	@TableField(exist = false) private String kingdeeStatusName;
+	@TableField(exist = false) private Integer attachmentCount;
+	@TableField(exist = false) private String attachmentSyncStatus;
+	@TableField(exist = false) private String attachmentSyncStatusName;
 	@TableField(exist = false) private String createUserName;
 	@TableField(exist = false) private List<InvoiceApplicationSettlement> settlements;
 	@TableField(exist = false) private List<InvoiceApplicationSheetVO> sheets;
@@ -49,6 +49,9 @@ public class InvoiceReceiptVO extends InvoiceReceipt {
 	@TableField(exist = false) private String settlementNos;
 	@TableField(exist = false) private String approvalStatusName;
 	@TableField(exist = false) private String kingdeePushStatusName;
+	@TableField(exist = false) private Integer attachmentCount;
+	@TableField(exist = false) private String attachmentSyncStatus;
+	@TableField(exist = false) private String attachmentSyncStatusName;
 	@TableField(exist = false) private String createUserName;
 	@TableField(exist = false) private String updateUserName;
 	@TableField(exist = false) private List<InvoiceReceiptSettlement> settlements;
@@ -43,6 +43,9 @@ public class PaymentApplicationVO extends PaymentApplication {
 	@TableField(exist = false) private String paymentTypeName;
 	@TableField(exist = false) private String approvalStatusName;
 	@TableField(exist = false) private String kingdeeStatusName;
+	@TableField(exist = false) private Integer attachmentCount;
+	@TableField(exist = false) private String attachmentSyncStatus;
+	@TableField(exist = false) private String attachmentSyncStatusName;
 	@TableField(exist = false) private List<PaymentApplicationInvoice> invoices;
 	@TableField(exist = false) private List<PaymentApplicationRecord> paymentRecords;
 	@TableField(exist = false) private List<PaymentApplicationSettlement> settlements;