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: # 回写任务开关