From 4068d24ee93d76de1437b41eadd5f9604a35bf17 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, 29 Oct 2026 12:13:22 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=94=B6=E6=AC=BE=E5=8D=95=E6=9F=A5?= =?UTF-8?q?=E8=AF=A2=E4=B8=9A=E5=8A=A1=E6=97=A5=E6=9C=9F=E7=AA=97=E5=8F=A3?= =?UTF-8?q?=E5=A4=A9=E6=95=B0=E9=BB=98=E8=AE=A4=E6=94=B9=E4=B8=BA60?= =?UTF-8?q?=E5=A4=A9=E5=B9=B6=E8=A1=A5=E5=85=85Nacos=E9=85=8D=E7=BD=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../org/springblade/transport/config/BfiProperties.java | 4 ++-- .../transport/service/impl/ReceiptFlowServiceImpl.java | 2 +- .../thirdparty/bfi/pojo/dto/BfiRecBillQueryDTO.java | 2 +- .../org/springblade/thirdparty/bfi/service/IBfiService.java | 2 +- ...据源A301-2改A301-1-认领只登记本地并推送合规C107-1与C107-3作废同步）.md | 6 +++--- doc/nacos/blade-dev.yaml | 4 ++++ doc/nacos/blade-prod.yaml | 4 ++++ doc/nacos/third-party-api.yaml | 4 ++++ 8 files changed, 20 insertions(+), 8 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 acec0027..f865fe8f 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 @@ -198,9 +198,9 @@ public class BfiProperties { public static class RecBillSync { /** - * 同步业务日期窗口天数，默认 30（A301-1 契约约束业务日期范围不可超过 1 个月） + * 同步业务日期窗口天数，默认 60 */ - private int days = 30; + private int days = 60; } /** 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 b47b4fe3..04f8803c 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 @@ -776,7 +776,7 @@ public class ReceiptFlowServiceImpl extends BaseServiceImpl queryRecBills() { diff --git a/blade-third-party-api/blade-bfi-api/src/main/java/org/springblade/thirdparty/bfi/pojo/dto/BfiRecBillQueryDTO.java b/blade-third-party-api/blade-bfi-api/src/main/java/org/springblade/thirdparty/bfi/pojo/dto/BfiRecBillQueryDTO.java index db3ea4ca..a648c977 100644 --- a/blade-third-party-api/blade-bfi-api/src/main/java/org/springblade/thirdparty/bfi/pojo/dto/BfiRecBillQueryDTO.java +++ b/blade-third-party-api/blade-bfi-api/src/main/java/org/springblade/thirdparty/bfi/pojo/dto/BfiRecBillQueryDTO.java @@ -57,7 +57,7 @@ public class BfiRecBillQueryDTO implements Serializable { */ private Integer pageSize; /** - * 【必填】开始业务日期，格式：yyyy-MM-dd HH:mm:ss，限定时间范围不可超过1个月； + * 【必填】开始业务日期，格式：yyyy-MM-dd HH:mm:ss，窗口天数由调用方控制； * 传纯日期 yyyy-MM-dd 会被金蝶拒绝（bos.filterSqlBuilder 时间格式错误） */ @JsonProperty("begin_bizdate") diff --git a/blade-third-party-api/blade-bfi-api/src/main/java/org/springblade/thirdparty/bfi/service/IBfiService.java b/blade-third-party-api/blade-bfi-api/src/main/java/org/springblade/thirdparty/bfi/service/IBfiService.java index 8837a6ee..703f3f81 100644 --- a/blade-third-party-api/blade-bfi-api/src/main/java/org/springblade/thirdparty/bfi/service/IBfiService.java +++ b/blade-third-party-api/blade-bfi-api/src/main/java/org/springblade/thirdparty/bfi/service/IBfiService.java @@ -277,7 +277,7 @@ public interface IBfiService { /** * A301-1 收款单查询（收款处理查询） * - * @param param 查询参数，业务日期格式 yyyy-MM-dd HH:mm:ss，范围不可超过1个月 + * @param param 查询参数，业务日期格式 yyyy-MM-dd HH:mm:ss，窗口天数由调用方控制 * @return 收款处理分页数据 */ BfiPageVO queryRecBill(BfiRecBillQueryDTO param); diff --git a/doc/docs/业务流程/2026-10-29-收款流水菜单改造（数据源A301-2改A301-1-认领只登记本地并推送合规C107-1与C107-3作废同步）.md b/doc/docs/业务流程/2026-10-29-收款流水菜单改造（数据源A301-2改A301-1-认领只登记本地并推送合规C107-1与C107-3作废同步）.md index bff1fd6e..2f5346ab 100644 --- a/doc/docs/业务流程/2026-10-29-收款流水菜单改造（数据源A301-2改A301-1-认领只登记本地并推送合规C107-1与C107-3作废同步）.md +++ b/doc/docs/业务流程/2026-10-29-收款流水菜单改造（数据源A301-2改A301-1-认领只登记本地并推送合规C107-1与C107-3作废同步）.md @@ -39,7 +39,7 @@ A301-2 认领公告同步（按认领人姓名拉取） → A301-1 按 awrp_src_code 回写金蝶单据状态（refreshKingdeeResult） 【目标】 -A301-1 收款单查询（业务日期窗口 ≤1 个月，全量） +A301-1 收款单查询（业务日期窗口取 `thirdParty.bfi.recBillSync.days`，默认 60 天，全量） → blade_kingdee_receipt_flow 落库（幂等键 detail_serial_no，金蝶单号/状态随同步刷新） → 页面认领（只登记本地） → 认领事务提交后按认领主单推合规链（C103-9 → C107-1 → C108-1，C107-1 结果落库标记） @@ -65,7 +65,7 @@ A301-1 收款单查询（业务日期窗口 ≤1 个月，全量） ### 3.2 收款流水同步：A301-2 → A301-1 -`ReceiptFlowServiceImpl#sync()` 重写，`BfiUtil.queryAllPages` + `bfiService.queryRecBill` 全量翻页（pageSize 200），请求参数 `begin_bizdate` / `end_bizdate`（窗口天数取 Nacos `thirdParty.bfi.recBillSync.days`，默认 30）。 +`ReceiptFlowServiceImpl#sync()` 重写，`BfiUtil.queryAllPages` + `bfiService.queryRecBill` 全量翻页（pageSize 200），请求参数 `begin_bizdate` / `end_bizdate`（窗口天数取 Nacos `thirdParty.bfi.recBillSync.days`，默认 60）。 **字段映射（A301-1 → blade_kingdee_receipt_flow）**： @@ -164,7 +164,7 @@ A301-1 收款单查询（业务日期窗口 ≤1 个月，全量） **Nacos（thirdParty.bfi.*）**： -- 新增（可选）：`recBillSync.days`，默认 30，A301-1 契约约束业务日期窗口 ≤1 个月； +- 新增（可选）：`recBillSync.days`，默认 60（A301-1 业务日期窗口天数）； - 可清理：`claimAnnounce.*`、`receiptClaimPush.*`（代码已不再读取）。 **存量数据**： diff --git a/doc/nacos/blade-dev.yaml b/doc/nacos/blade-dev.yaml index ebdea597..ad5d667b 100644 --- a/doc/nacos/blade-dev.yaml +++ b/doc/nacos/blade-dev.yaml @@ -184,6 +184,10 @@ thirdParty: exratetable: ${BFI_PAY_APPLY_EXRATE_TABLE:01} # 外部单据类型 srcType: ${BFI_PAY_APPLY_SRC_TYPE:0KzXs} + # 收款流水同步配置（A301-1 收款单查询） + recBillSync: + # 业务日期窗口天数 + days: ${BFI_RECBILL_SYNC_DAYS:60} # 金蝶付款结果定时回写（A103-2 付款申请单查询 / A103-4 付款处理查询） payResult: # 回写任务开关 diff --git a/doc/nacos/blade-prod.yaml b/doc/nacos/blade-prod.yaml index 0cb488f2..93d9729e 100644 --- a/doc/nacos/blade-prod.yaml +++ b/doc/nacos/blade-prod.yaml @@ -133,6 +133,10 @@ thirdParty: exratetable: ${BFI_PAY_APPLY_EXRATE_TABLE:01} # 外部单据类型 srcType: ${BFI_PAY_APPLY_SRC_TYPE:0KzXs} + # 收款流水同步配置（A301-1 收款单查询） + recBillSync: + # 业务日期窗口天数 + days: ${BFI_RECBILL_SYNC_DAYS:60} # 金蝶付款结果定时回写（A103-2 付款申请单查询 / A103-4 付款处理查询） payResult: # 回写任务开关 diff --git a/doc/nacos/third-party-api.yaml b/doc/nacos/third-party-api.yaml index 47b65871..ea5c0f26 100644 --- a/doc/nacos/third-party-api.yaml +++ b/doc/nacos/third-party-api.yaml @@ -86,6 +86,10 @@ thirdParty: exratetable: ${BFI_PAY_APPLY_EXRATE_TABLE:01} # 外部单据类型 srcType: ${BFI_PAY_APPLY_SRC_TYPE:0KzXs} + # 收款流水同步配置（A301-1 收款单查询） + recBillSync: + # 业务日期窗口天数 + days: ${BFI_RECBILL_SYNC_DAYS:60} # 金蝶付款结果定时回写（A103-2 付款申请单查询 / A103-4 付款处理查询） payResult: # 回写任务开关