feat: 收款单查询业务日期窗口天数默认改为60天并补充Nacos配置

This commit is contained in:
刘泉佳
2026-10-29 12:13:22 +08:00
parent b3b81a2674
commit 4068d24ee9
8 changed files with 20 additions and 8 deletions
@@ -198,9 +198,9 @@ public class BfiProperties {
public static class RecBillSync { public static class RecBillSync {
/** /**
* 同步业务日期窗口天数,默认 30(A301-1 契约约束业务日期范围不可超过 1 个月) * 同步业务日期窗口天数,默认 60
*/ */
private int days = 30; private int days = 60;
} }
/** /**
@@ -776,7 +776,7 @@ public class ReceiptFlowServiceImpl extends BaseServiceImpl<KingdeeReceiptFlowMa
} }
/** /**
* A301-1 收款单查询:业务日期窗口全量翻页,窗口天数取 Nacos 配置(默认近30天,契约约束 ≤1 个月)。 * A301-1 收款单查询:业务日期窗口全量翻页,窗口天数取 Nacos 配置 thirdParty.bfi.recBillSync.days(默认近 60 天)。
* 收款流水同步专用。 * 收款流水同步专用。
*/ */
private List<BfiRecBillVO> queryRecBills() { private List<BfiRecBillVO> queryRecBills() {
@@ -57,7 +57,7 @@ public class BfiRecBillQueryDTO implements Serializable {
*/ */
private Integer pageSize; private Integer pageSize;
/** /**
* 【必填】开始业务日期,格式:yyyy-MM-dd HH:mm:ss,限定时间范围不可超过1个月; * 【必填】开始业务日期,格式:yyyy-MM-dd HH:mm:ss,窗口天数由调用方控制;
* 传纯日期 yyyy-MM-dd 会被金蝶拒绝(bos.filterSqlBuilder 时间格式错误) * 传纯日期 yyyy-MM-dd 会被金蝶拒绝(bos.filterSqlBuilder 时间格式错误)
*/ */
@JsonProperty("begin_bizdate") @JsonProperty("begin_bizdate")
@@ -277,7 +277,7 @@ public interface IBfiService {
/** /**
* A301-1 收款单查询(收款处理查询) * A301-1 收款单查询(收款处理查询)
* *
* @param param 查询参数,业务日期格式 yyyy-MM-dd HH:mm:ss,范围不可超过1个月 * @param param 查询参数,业务日期格式 yyyy-MM-dd HH:mm:ss,窗口天数由调用方控制
* @return 收款处理分页数据 * @return 收款处理分页数据
*/ */
BfiPageVO<BfiRecBillVO> queryRecBill(BfiRecBillQueryDTO param); BfiPageVO<BfiRecBillVO> queryRecBill(BfiRecBillQueryDTO param);
@@ -39,7 +39,7 @@ A301-2 认领公告同步(按认领人姓名拉取)
→ A301-1 按 awrp_src_code 回写金蝶单据状态(refreshKingdeeResult) → A301-1 按 awrp_src_code 回写金蝶单据状态(refreshKingdeeResult)
【目标】 【目标】
A301-1 收款单查询(业务日期窗口 ≤1 个月,全量) A301-1 收款单查询(业务日期窗口取 `thirdParty.bfi.recBillSync.days`,默认 60 天,全量)
→ blade_kingdee_receipt_flow 落库(幂等键 detail_serial_no,金蝶单号/状态随同步刷新) → blade_kingdee_receipt_flow 落库(幂等键 detail_serial_no,金蝶单号/状态随同步刷新)
→ 页面认领(只登记本地) → 页面认领(只登记本地)
→ 认领事务提交后按认领主单推合规链(C103-9 → C107-1 → C108-1,C107-1 结果落库标记) → 认领事务提交后按认领主单推合规链(C103-9 → C107-1 → C108-1,C107-1 结果落库标记)
@@ -65,7 +65,7 @@ A301-1 收款单查询(业务日期窗口 ≤1 个月,全量)
### 3.2 收款流水同步:A301-2 → A301-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)**: **字段映射(A301-1 → blade_kingdee_receipt_flow)**:
@@ -164,7 +164,7 @@ A301-1 收款单查询(业务日期窗口 ≤1 个月,全量)
**Nacos(thirdParty.bfi.*)**: **Nacos(thirdParty.bfi.*)**:
- 新增(可选):`recBillSync.days`,默认 30,A301-1 契约约束业务日期窗口 ≤1 个月; - 新增(可选):`recBillSync.days`,默认 60(A301-1 业务日期窗口天数);
- 可清理:`claimAnnounce.*`、`receiptClaimPush.*`(代码已不再读取)。 - 可清理:`claimAnnounce.*`、`receiptClaimPush.*`(代码已不再读取)。
**存量数据**: **存量数据**:
+4
View File
@@ -184,6 +184,10 @@ thirdParty:
exratetable: ${BFI_PAY_APPLY_EXRATE_TABLE:01} exratetable: ${BFI_PAY_APPLY_EXRATE_TABLE:01}
# 外部单据类型 # 外部单据类型
srcType: ${BFI_PAY_APPLY_SRC_TYPE:0KzXs} srcType: ${BFI_PAY_APPLY_SRC_TYPE:0KzXs}
# 收款流水同步配置(A301-1 收款单查询)
recBillSync:
# 业务日期窗口天数
days: ${BFI_RECBILL_SYNC_DAYS:60}
# 金蝶付款结果定时回写(A103-2 付款申请单查询 / A103-4 付款处理查询) # 金蝶付款结果定时回写(A103-2 付款申请单查询 / A103-4 付款处理查询)
payResult: payResult:
# 回写任务开关 # 回写任务开关
+4
View File
@@ -133,6 +133,10 @@ thirdParty:
exratetable: ${BFI_PAY_APPLY_EXRATE_TABLE:01} exratetable: ${BFI_PAY_APPLY_EXRATE_TABLE:01}
# 外部单据类型 # 外部单据类型
srcType: ${BFI_PAY_APPLY_SRC_TYPE:0KzXs} srcType: ${BFI_PAY_APPLY_SRC_TYPE:0KzXs}
# 收款流水同步配置(A301-1 收款单查询)
recBillSync:
# 业务日期窗口天数
days: ${BFI_RECBILL_SYNC_DAYS:60}
# 金蝶付款结果定时回写(A103-2 付款申请单查询 / A103-4 付款处理查询) # 金蝶付款结果定时回写(A103-2 付款申请单查询 / A103-4 付款处理查询)
payResult: payResult:
# 回写任务开关 # 回写任务开关
+4
View File
@@ -86,6 +86,10 @@ thirdParty:
exratetable: ${BFI_PAY_APPLY_EXRATE_TABLE:01} exratetable: ${BFI_PAY_APPLY_EXRATE_TABLE:01}
# 外部单据类型 # 外部单据类型
srcType: ${BFI_PAY_APPLY_SRC_TYPE:0KzXs} srcType: ${BFI_PAY_APPLY_SRC_TYPE:0KzXs}
# 收款流水同步配置(A301-1 收款单查询)
recBillSync:
# 业务日期窗口天数
days: ${BFI_RECBILL_SYNC_DAYS:60}
# 金蝶付款结果定时回写(A103-2 付款申请单查询 / A103-4 付款处理查询) # 金蝶付款结果定时回写(A103-2 付款申请单查询 / A103-4 付款处理查询)
payResult: payResult:
# 回写任务开关 # 回写任务开关