From 4f9ae4953844d73bd324417269511a305e6ef666 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=88=98=E6=B3=89=E4=BD=B3?= <1107186916@qq.com>
Date: Wed, 28 Oct 2026 17:00:25 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E4=BB=98=E6=AC=BE=E7=94=B3=E8=AF=B7?=
 =?UTF-8?q?=E9=87=91=E8=9D=B6=E6=8E=A8=E9=80=81=E5=A4=B1=E8=B4=A5=E5=8E=9F?=
 =?UTF-8?q?=E5=9B=A0=E8=90=BD=E5=BA=93=E5=B9=B6=E9=9A=8F=E5=88=97=E8=A1=A8?=
 =?UTF-8?q?=E8=BF=94=E5=9B=9E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../pojo/entity/PaymentApplication.java         |  2 ++
 .../service/IPaymentApplicationService.java     |  7 ++++---
 .../impl/PaymentApplicationServiceImpl.java     | 15 ++++++++++-----
 ...application_kingdee_fail_reason_20261028.sql | 17 +++++++++++++++++
 4 files changed, 33 insertions(+), 8 deletions(-)
 create mode 100644 doc/sql/transport/lqj/20261028/01_blade_payment_application_kingdee_fail_reason_20261028.sql

diff --git a/blade-service-api/blade-transport-api/src/main/java/org/springblade/transport/pojo/entity/PaymentApplication.java b/blade-service-api/blade-transport-api/src/main/java/org/springblade/transport/pojo/entity/PaymentApplication.java
index b5b00417..f8f3bb81 100644
--- a/blade-service-api/blade-transport-api/src/main/java/org/springblade/transport/pojo/entity/PaymentApplication.java
+++ b/blade-service-api/blade-transport-api/src/main/java/org/springblade/transport/pojo/entity/PaymentApplication.java
@@ -117,6 +117,8 @@ public class PaymentApplication extends TenantEntity {
 	private String kingdeeBillId;
 	/** 金蝶同步状态：unsynced 未生成 / synced 已生成 / paying 付款中 / paid 已付款 / closed 已关闭 / failed 生成失败 */
 	private String kingdeeStatus;
+	/** 金蝶推送失败原因（仅 failed 态展示；重推成功转 synced 后残留原因不再回显） */
+	private String kingdeeFailReason;
 	/** 附件信息JSON */
 	private String attachmentsJson;
 	/** 备注 */
diff --git a/blade-service/blade-transport/src/main/java/org/springblade/transport/service/IPaymentApplicationService.java b/blade-service/blade-transport/src/main/java/org/springblade/transport/service/IPaymentApplicationService.java
index e68ec0c0..c55c874f 100644
--- a/blade-service/blade-transport/src/main/java/org/springblade/transport/service/IPaymentApplicationService.java
+++ b/blade-service/blade-transport/src/main/java/org/springblade/transport/service/IPaymentApplicationService.java
@@ -72,12 +72,13 @@ public interface IPaymentApplicationService extends BaseService<PaymentApplicati
 	String doSyncKingdee(Long id, KingdeeSyncContext context);
 
 	/**
-	 * 独立事务落"生成失败"状态（在推送事务回滚、行锁释放后执行）；
+	 * 独立事务落"生成失败"状态与失败原因（在推送事务回滚、行锁释放后执行）；
 	 * 仅更新审批通过的单据，未审批/已删除单据自动跳过，保持原状态
 	 *
-	 * @param id 付款申请id
+	 * @param id     付款申请id
+	 * @param reason 失败原因（异常信息，展示在列表状态悬浮提示）
 	 */
-	void markKingdeeSyncFailed(Long id);
+	void markKingdeeSyncFailed(Long id, String reason);
 
 	/**
 	 * 重推金蝶生成失败（kingdeeStatus=failed 且审批通过）的付款申请：逐单独立成败，失败不中断。
diff --git a/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/PaymentApplicationServiceImpl.java b/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/PaymentApplicationServiceImpl.java
index 30fb7002..f6ce65c2 100644
--- a/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/PaymentApplicationServiceImpl.java
+++ b/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/PaymentApplicationServiceImpl.java
@@ -551,12 +551,12 @@ public class PaymentApplicationServiceImpl extends BaseServiceImpl<PaymentApplic
 			kingdeeBillId = self().doSyncKingdee(id, context);
 		} catch (ServiceException exception) {
 			log.error("付款申请[{}]推送金蝶付款申请单异常", id, exception);
-			// 推送事务已回滚、行锁已释放，此处独立事务落"生成失败"状态
-			self().markKingdeeSyncFailed(id);
+			// 推送事务已回滚、行锁已释放，此处独立事务落"生成失败"状态与失败原因
+			self().markKingdeeSyncFailed(id, exception.getMessage());
 			throw exception;
 		} catch (Exception exception) {
 			log.error("付款申请[{}]推送金蝶付款申请单异常", id, exception);
-			self().markKingdeeSyncFailed(id);
+			self().markKingdeeSyncFailed(id, exception.getMessage());
 			throw new ServiceException("推送金蝶付款申请失败：" + exception.getMessage());
 		}
 		// 主单事务提交后锁定金蝶付款申请单（lockBusiData）：一张付款申请对一张金蝶付款申请单，接口1对1；
@@ -735,13 +735,17 @@ public class PaymentApplicationServiceImpl extends BaseServiceImpl<PaymentApplic
 
 	@Override
 	@Transactional(rollbackFor = Exception.class)
-	public void markKingdeeSyncFailed(Long id) {
+	public void markKingdeeSyncFailed(Long id, String reason) {
 		if (id == null) return;
+		// 失败原因截断留档，与列长 varchar(500) 对齐，不抛错
+		String failReason = Func.toStrWithEmpty(reason, "未知异常");
 		// 条件更新：仅审批通过的单据落"生成失败"状态，未审批/已删除单据自动跳过保持原状态
 		baseMapper.update(null, Wrappers.<PaymentApplication>lambdaUpdate()
 			.eq(PaymentApplication::getId, id)
 			.eq(PaymentApplication::getApprovalStatus, TransportBusiConstant.APPROVED)
-			.set(PaymentApplication::getKingdeeStatus, KingdeeBfiConstant.KINGDEE_STATUS_FAILED));
+			.set(PaymentApplication::getKingdeeStatus, KingdeeBfiConstant.KINGDEE_STATUS_FAILED)
+			.set(PaymentApplication::getKingdeeFailReason,
+				failReason.length() > 500 ? failReason.substring(0, 500) : failReason));
 	}
 
 	@Override
@@ -793,6 +797,7 @@ public class PaymentApplicationServiceImpl extends BaseServiceImpl<PaymentApplic
 			.eq(PaymentApplication::getId, id)
 			.in(PaymentApplication::getKingdeeStatus, KingdeeBfiConstant.KINGDEE_STATUS_SYNCED, KingdeeBfiConstant.KINGDEE_STATUS_PAYING)
 			.set(PaymentApplication::getKingdeeStatus, KingdeeBfiConstant.KINGDEE_STATUS_FAILED)
+			.set(PaymentApplication::getKingdeeFailReason, "金蝶侧单据已删除解锁（" + source + "），等待重新推送")
 			.set(PaymentApplication::getKingdeeBillId, null)
 			.set(PaymentApplication::getKingdeeBillNo, null));
 		// 金蝶单据已删除/解锁重推：联动作废提前建档的预付记录，重推生成新单后重新建档
diff --git a/doc/sql/transport/lqj/20261028/01_blade_payment_application_kingdee_fail_reason_20261028.sql b/doc/sql/transport/lqj/20261028/01_blade_payment_application_kingdee_fail_reason_20261028.sql
new file mode 100644
index 00000000..50280ba2
--- /dev/null
+++ b/doc/sql/transport/lqj/20261028/01_blade_payment_application_kingdee_fail_reason_20261028.sql
@@ -0,0 +1,17 @@
+-- 付款管理：金蝶推送失败原因留档展示
+-- 新增 kingdee_fail_reason：markKingdeeSyncFailed 落"生成失败"时同步落失败原因，
+-- 列表"金蝶单据状态"列悬浮提示展示；重推成功转 synced 后残留原因不再回显
+
+-- 以下结构升级支持重复执行
+SET @ddl_sql = (
+  SELECT IF(COUNT(*) = 0,
+    'ALTER TABLE `blade_payment_application` ADD COLUMN `kingdee_fail_reason` varchar(500) COLLATE utf8mb4_general_ci DEFAULT NULL COMMENT ''金蝶推送失败原因'' AFTER `kingdee_status`',
+    'SELECT 1')
+  FROM information_schema.COLUMNS
+  WHERE TABLE_SCHEMA = DATABASE()
+    AND TABLE_NAME = 'blade_payment_application'
+    AND COLUMN_NAME = 'kingdee_fail_reason'
+);
+PREPARE ddl_stmt FROM @ddl_sql;
+EXECUTE ddl_stmt;
+DEALLOCATE PREPARE ddl_stmt;