From a6af9a2ccde2a1ff8baad0c32e846f8764351148 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=88=98=E6=B3=89=E4=BD=B3?= <1107186916@qq.com>
Date: Thu, 8 Oct 2026 17:34:11 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=94=B6=E6=AC=BE=E8=AE=A4=E9=A2=86?=
 =?UTF-8?q?=E5=85=AC=E5=91=8A=E6=9F=A5=E8=AF=A2=E8=AE=A4=E9=A2=86=E4=BA=BA?=
 =?UTF-8?q?=E6=94=B9=E5=8F=96Nacos=E9=85=8D=E7=BD=AEthirdParty.bfi.claimAn?=
 =?UTF-8?q?nounce.claimusers=EF=BC=8C=E4=B8=8D=E5=86=8D=E6=8C=89=E5=BD=93?=
 =?UTF-8?q?=E5=89=8D=E7=99=BB=E5=BD=95=E7=94=A8=E6=88=B7=E5=A7=93=E5=90=8D?=
 =?UTF-8?q?=E6=9F=A5=E8=AF=A2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../org/springblade/transport/config/BfiProperties.java   | 5 +++++
 .../transport/service/impl/ReceiptFlowServiceImpl.java    | 8 +++++---
 doc/nacos/third-party-api.yaml                            | 6 ++++++
 3 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/blade-service/blade-transport/src/main/java/org/springblade/transport/config/BfiProperties.java b/blade-service/blade-transport/src/main/java/org/springblade/transport/config/BfiProperties.java
index e3ff364c..ad220084 100644
--- a/blade-service/blade-transport/src/main/java/org/springblade/transport/config/BfiProperties.java
+++ b/blade-service/blade-transport/src/main/java/org/springblade/transport/config/BfiProperties.java
@@ -129,6 +129,11 @@ public class BfiProperties {
 		 * 查询时间窗口（月数），默认 6（近半年）
 		 */
 		private int months = 6;
+
+		/**
+		 * 认领人（claimusers）：配置后公告查询固定使用该值，不再按当前登录用户姓名查询
+		 */
+		private String claimusers;
 	}
 
 }
diff --git a/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/ReceiptFlowServiceImpl.java b/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/ReceiptFlowServiceImpl.java
index eb62bb5a..0b4c9eeb 100644
--- a/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/ReceiptFlowServiceImpl.java
+++ b/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/ReceiptFlowServiceImpl.java
@@ -998,13 +998,15 @@ public class ReceiptFlowServiceImpl extends BaseServiceImpl<KingdeeReceiptFlowMa
 	 */
 	private List<BfiClaimAnnounceVO> queryClaimAnnounces(String claimusers) {
 		int months = bfiProperties.getClaimAnnounce().getMonths();
+		// 认领人直接取 Nacos 配置值
+		String effectiveClaimusers = bfiProperties.getClaimAnnounce().getClaimusers();
 		LocalDateTime endDate = LocalDateTime.now();
 		LocalDateTime startDate = endDate.minusMonths(months);
 		long start = System.currentTimeMillis();
 		log.info("调用BFI接口 收款认领公告查询开始 claimusers：{}，时间窗口：{} ~ {}（近{}个月）",
-			claimusers, startDate.format(BFI_DATE_TIME_FORMATTER), endDate.format(BFI_DATE_TIME_FORMATTER), months);
+			effectiveClaimusers, startDate.format(BFI_DATE_TIME_FORMATTER), endDate.format(BFI_DATE_TIME_FORMATTER), months);
 		BfiClaimAnnounceQueryDTO queryDTO = new BfiClaimAnnounceQueryDTO();
-		queryDTO.setClaimusers(claimusers);
+		queryDTO.setClaimusers(effectiveClaimusers);
 		queryDTO.setModifytimeS(startDate.format(BFI_DATE_TIME_FORMATTER));
 		queryDTO.setModifytimeE(endDate.format(BFI_DATE_TIME_FORMATTER));
 		queryDTO.setPageSize(SYNC_PAGE_SIZE);
@@ -1013,7 +1015,7 @@ public class ReceiptFlowServiceImpl extends BaseServiceImpl<KingdeeReceiptFlowMa
 			return bfiService.queryClaimAnnounce(queryDTO);
 		});
 		log.info("调用BFI接口 收款认领公告查询结束 claimusers：{}，耗时：{}ms，拉取 {} 条",
-			claimusers, System.currentTimeMillis() - start, announces.size());
+			effectiveClaimusers, System.currentTimeMillis() - start, announces.size());
 		return announces;
 	}
 
diff --git a/doc/nacos/third-party-api.yaml b/doc/nacos/third-party-api.yaml
index 96c4fa23..e4317c14 100644
--- a/doc/nacos/third-party-api.yaml
+++ b/doc/nacos/third-party-api.yaml
@@ -73,6 +73,12 @@ thirdParty:
       # single-flight 分布式锁租约秒数，须大于最坏一轮耗时（逐认领人远程查公告+逐条推送），
       # 进程异常退出时锁在租约到期后自动释放
       lockLeaseSeconds: ${BFI_RECEIPT_CLAIM_PUSH_LOCK_LEASE_SECONDS:1800}
+    # 收款认领公告查询配置（A301-2）
+    claimAnnounce:
+      # 查询时间窗口（月数）
+      months: ${BFI_CLAIM_ANNOUNCE_MONTHS:6}
+      # 认领人：配置后公告查询固定使用该值，不再按当前登录用户姓名查询
+      claimusers: ${BFI_CLAIM_ANNOUNCE_CLAIMUSERS:}
     # 金蝶全票池发票定时同步（A801-1 窗口拉取+镜像 upsert，选票统一查本地）
     invoiceReceipt:
       # 同步任务开关，默认关闭（上线先手动 POST /invoice-receipt/sync-invoice-pool 跑一次全窗口铺底）