From 75f33803221c63a93668661d19358eb902911f64 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, 4 Nov 2026 16:00:23 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E4=BB=98=E6=AC=BE=E8=AE=B0=E5=BD=95?=
 =?UTF-8?q?=E8=90=BD=E5=BA=93=E9=87=91=E8=9D=B6=E4=BB=98=E6=AC=BE=E5=A4=84?=
 =?UTF-8?q?=E7=90=86=E5=8D=95=E5=86=85=E7=A0=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../pojo/entity/PaymentApplicationRecord.java |  2 ++
 .../impl/PaymentApplicationServiceImpl.java   |  2 ++
 ...cation_record_kingdee_bill_id_20261104.sql | 21 +++++++++++++++++++
 3 files changed, 25 insertions(+)
 create mode 100644 doc/sql/transport/lqj/temp/23_blade_payment_application_record_kingdee_bill_id_20261104.sql

diff --git a/blade-service-api/blade-transport-api/src/main/java/org/springblade/transport/pojo/entity/PaymentApplicationRecord.java b/blade-service-api/blade-transport-api/src/main/java/org/springblade/transport/pojo/entity/PaymentApplicationRecord.java
index 1c5c1afe..9d97e3d9 100644
--- a/blade-service-api/blade-transport-api/src/main/java/org/springblade/transport/pojo/entity/PaymentApplicationRecord.java
+++ b/blade-service-api/blade-transport-api/src/main/java/org/springblade/transport/pojo/entity/PaymentApplicationRecord.java
@@ -40,4 +40,6 @@ public class PaymentApplicationRecord extends TenantEntity {
 	private String paymentNo;
 	private String voucherJson;
 	private String kingdeeBillNo;
+	/** 金蝶付款处理单id（cas_paybill.id，A103-4 回写，应付单 preentry 预付抵扣取数用） */
+	private String kingdeeBillId;
 }
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 e9d56acf..5fc32654 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
@@ -1146,6 +1146,8 @@ public class PaymentApplicationServiceImpl extends BaseServiceImpl<PaymentApplic
 		}
 		record.setPaidDate(this.parseKingdeeDate(payBill.getPaydate()));
 		record.setKingdeeBillNo(billNo);
+		// 金蝶付款处理单内码（cas_paybill.id）落库：财务应付单 preentry 预付抵扣（y_billid）取数用
+		record.setKingdeeBillId(payBill.getId() == null ? null : String.valueOf(payBill.getId()));
 		// 付款处理单查询结果整体留档（凭证号、银行流水、电子回单等信息），便于追溯
 		record.setVoucherJson(JsonUtil.toJson(payBill));
 		if (isNew) {
diff --git a/doc/sql/transport/lqj/temp/23_blade_payment_application_record_kingdee_bill_id_20261104.sql b/doc/sql/transport/lqj/temp/23_blade_payment_application_record_kingdee_bill_id_20261104.sql
new file mode 100644
index 00000000..cb1b0d51
--- /dev/null
+++ b/doc/sql/transport/lqj/temp/23_blade_payment_application_record_kingdee_bill_id_20261104.sql
@@ -0,0 +1,21 @@
+-- 付款记录表：金蝶付款处理单内码（cas_paybill.id）落库
+-- 用途：财务应付单（A102-2）preentry 预付信息分录 y_billid 取数；A103-4 回写付款记录时同步写入
+-- 幂等可重复执行：逐列查 information_schema，已存在则跳过；存量数据从 voucher_json 回填（仅填空值）
+
+-- ① 列 kingdee_bill_id
+SET @ddl = (SELECT IF(
+  (SELECT COUNT(*) FROM information_schema.COLUMNS
+   WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'blade_payment_application_record' AND COLUMN_NAME = 'kingdee_bill_id') = 0,
+  'ALTER TABLE `blade_payment_application_record` ADD COLUMN `kingdee_bill_id` varchar(64) DEFAULT NULL COMMENT ''金蝶付款处理单id（cas_paybill.id，A103-4回写，应付单preentry预付抵扣取数用）'' AFTER `kingdee_bill_no`',
+  'SELECT 1'));
+PREPARE stmt FROM @ddl;
+EXECUTE stmt;
+DEALLOCATE PREPARE stmt;
+
+-- ② 存量回填：从 A103-4 留档报文 voucher_json 提取付款处理单 id（仅填空值，天然可重复执行）
+UPDATE `blade_payment_application_record`
+SET `kingdee_bill_id` = JSON_UNQUOTE(JSON_EXTRACT(`voucher_json`, '$.id'))
+WHERE `kingdee_bill_id` IS NULL
+  AND `voucher_json` IS NOT NULL
+  AND JSON_VALID(`voucher_json`)
+  AND JSON_EXTRACT(`voucher_json`, '$.id') IS NOT NULL;