b2894lxlx/tms-erp-api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
422 Commits 4 Branches 0 Tags
ab64d282515f90f5d0a60a3dae3e13ed0aa79b59
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
刘泉佳 ab64d28251 fix: A301-3 认领推送核心单据编号改传结算单金蝶单据id（星瀚内码），本地结算单id金蝶无法识别；缺id时推送前置拦截 2026-10-01 20:09:10 +08:00
刘泉佳 984fbd07fd fix: 金蝶推送组织编码改取部门金蝶组织编码(kingdeeDeptCode) 2026-10-01 14:41:57 +08:00
刘泉佳 4b3edf977c Merge remote-tracking branch 'refs/remotes/origin/master' into feature/payment-apply-bfi-sync 
# Conflicts:
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/CustomerArchiveServiceImpl.java
 2026-10-01 13:47:00 +08:00
刘泉佳 27756ba964 fix: A303-2 收票单新增，付款方式固定现购 2026-09-30 18:21:43 +08:00
刘泉佳 454209511b chore: 补充金蝶收票单结果回写定时任务日志与方法说明 2026-09-30 15:16:09 +08:00
刘泉佳 f8bd66aafb docs: BFI接口编号补充名称标注，新增定时任务逻辑全梳理文档 2026-09-30 15:01:57 +08:00
刘泉佳 86e26bf3c9 perf: 金蝶应收单勾稽明细查询与回写改分批执行并补充日志说明 2026-09-30 14:57:50 +08:00
刘泉佳 2f6619d443 feat: 开票结果回写落库发票文件地址并支持正式结算单详情查看下载 
- A303-5 VO 补数电 PDF/XML 直链字段，回写落库四个发票文件地址（板式文件/预览图/数电PDF/数电XML）
- 已落库但缺地址的历史记录由回写任务字段级补空，不覆盖已有值
- 正式结算单详情新增 issuedInvoices：经结算单-开票申请关联查出回写发票，只读不参与匹配金额
- 新增建表补丁 blade_invoice_application_invoice_urls_20260930.sql
- 同步更新金蝶附件上传下载链路梳理文档（新增 3.4 销项直链节）
 2026-09-30 14:15:58 +08:00
刘泉佳 2cd86b1fe8 fix: 预付款申请，入参调整 2026-09-29 17:41:48 +08:00
刘泉佳 73293a4ea5 docs: 补充推送金蝶付款申请必填字段注释 2026-09-29 16:50:25 +08:00
刘泉佳 952b735a53 fix: 付款管理列表结算单号查询兼容预结算单号 2026-09-29 16:02:11 +08:00
刘泉佳 a9eb1d82d4 feat: 收款认领推送金蝶定时任务增加single-flight分布式锁及Nacos配置 2026-09-29 12:12:59 +08:00
刘泉佳 78e7ee7239 fix: 金蝶客商数据定时同步 2026-09-29 12:05:42 +08:00
刘泉佳 82fab4b76a feat: 已推送金蝶的认领不允许作废——后端硬校验拦截，列表带出流水推送状态 2026-09-29 11:58:20 +08:00
刘泉佳 331ea0466f feat: 定时推送按认领人串行处理——查完该认领人公告并推完名下流水再轮到下一个 2026-09-29 11:52:42 +08:00
刘泉佳 fe7a940201 fix: A301-3 成功响应 number 为空，金蝶收款单号取回执 keys.awrp_src_code；A301-1 回写命中后以真实收款单号覆盖占位 2026-09-29 11:25:58 +08:00
刘泉佳 15599e894d chore: 保留 buildKingdeeBillNo 冲单号方法，作废调用点注释保留待后续迭代 2026-09-29 11:18:48 +08:00
刘泉佳 c8b2b701a3 fix: 作废认领不再生成本地KDCX冲单——金蝶单号/状态保留原值，接口改无返回 2026-09-29 11:15:57 +08:00
刘泉佳 175dd52d33 fix: A301-3 分录按契约改为单条——e_receivableamt=全部未推送金额，seq/e_corebillno=第一张结算单id 2026-09-29 11:10:41 +08:00
刘泉佳 ffc2f6eea2 fix: A301-3 报文取数按契约修正——awrp_src_code=分摊结算单号拼接，seq/e_corebillno=结算单id 2026-09-29 10:48:50 +08:00
刘泉佳 9cf42b4105 feat: 收款流水列表补充收款金额区间与认领人筛选（认领人经认领记录参数化两段查询过滤） 2026-09-29 10:28:27 +08:00
刘泉佳 4c32cb9046 docs: 新增预付款申请A103-3金蝶链路补齐方案 
覆盖三项改造：e_bebank_number 与 A103-1 统一取联行号、A103-2 消失解锁兜底（ADR-0005）、
回写任务开关默认策略；含状态机全景、时序图、配置汇总与联调验证要点
 2026-09-29 01:51:07 +08:00
刘泉佳 846f080343 fix: 金蝶付款结果回写开关注释纠正且环境配置默认开启 
PaymentKingdeeResultTask 注释写「默认开启」与 @Value 兜底默认 false 矛盾，注释纠正为代码兜底关闭；
Nacos 三套配置（blade-dev/blade-prod/third-party-api）syncEnabled 默认改 true，按环境显式开启回写任务
 2026-09-29 01:50:53 +08:00
刘泉佳 2079da6195 feat: 付款申请新增金蝶单据消失解锁兜底（A103-2连续两轮查询消失） 
金蝶侧反审核删除付款申请单后，本地停留已生成/付款中且状态门禁禁止重推，单据卡死。
按 ADR-0005 新增 unlockBill()：置生成失败、清空金蝶单据内码/编号（日志留档）、不自动重推；
A103-2 定时回写对已推送单据连续两轮未查得（Redis 计数，TTL 覆盖三个回写周期）触发解锁；
failed 单据不参与计数，Redis 异常放弃判定，重推链 A103-2 勾稽预检兜底防重复单据；
B901 UNLOCK 回调后续接入复用同一 unlockBill()
 2026-09-29 01:50:36 +08:00
刘泉佳 f4f4360e5a feat: 预付款推送金蝶往来银行编码改取客商收款账户联行号 
A103-3 分录 e_bebank_number 原取银行名称字段，与 A103-1 口径不一致；
统一改取付款申请所选客商收款账户（blade_customer_receipt_account）联行号，未维护即拦截推送
 2026-09-29 01:48:04 +08:00
刘泉佳 e7d16eeb74 feat: 认领记录列表支持按流水推送状态筛选 2026-09-29 01:32:09 +08:00
刘泉佳 79abfa966b feat: 收款流水分页查询补充常用筛选条件（推送状态/金蝶回写状态/明细流水号） 2026-09-29 01:25:31 +08:00
刘泉佳 2e91e112ff feat: 收款认领本地化，认领完成才推金蝶——A301-3定时+手动双入口按流水归集推送 
- 认领只落本地：claim() 删除事务内同步推送，认领上限/认领完成口径改为公告未认领金额
- 推送闸门：认领完成且未推送过才可推；推送前重查A301-2最新公告对账，不一致拦截并提示差额
- 按流水归集：一条流水一张金蝶收款单，分录取全部有效分摊行；awrp_src_code 上移至流水、重试复用防重试双单
- 已推送终态闸门禁止二次推送；推送失败落 push_status/push_fail_reason 可重试，本地认领不回滚
- 定时任务 ReceiptClaimPushTask（thirdParty.bfi.receiptClaimPush.*，按认领人分组重查公告）+ 手动按钮 POST /receipt-flow/push-kingdee
- A301-1 回写轮询对象改流水并级联刷新认领主单冗余字段；作废仍不触发推送
- 认领链路批量化：结算单锁行/认领额聚合/汇总刷新改 IN 批量，候选单列表消除每页200次N+1，同步留痕 Db.saveBatch
 2026-09-29 01:02:54 +08:00
刘泉佳 98614a25cc perf: 结算单收款汇总批量化——refreshPaymentSummaries 固定数次批量查询替代逐单N+1，calculatePaymentSummary 拆纯计算重载保持口径一致 2026-09-29 01:02:33 +08:00
刘泉佳 f97237afe5 docs: 收款认领推送金蝶重构设计与业务流程文档、幂等变更SQL、集成语境术语 2026-09-29 01:02:14 +08:00
刘泉佳 cf6db499de fix: A301-3 收款认领结果推送接口金蝶字段 2026-09-28 18:57:42 +08:00
刘泉佳 bdae054b0b fix: 修复收款流水同步与认领推送问题 2026-09-28 18:40:05 +08:00
刘泉佳 145cb57e00 fix: 修复收款流水同步与认领推送问题 2026-09-28 17:54:43 +08:00
刘泉佳 0b88d05e93 docs: 收款流水同步方法增加详细日志和注释说明 2026-09-28 16:04:43 +08:00
刘泉佳 978caa640a perf: 收款流水同步改为批量查询与批量保存（N+1→批量） 2026-09-28 15:59:39 +08:00
刘泉佳 4d62bb6df7 feat: A301-2 认领公告查询接口适配新参数（billstatus/modifytimeS/modifytimeE），时间窗口配置化（Nacos thirdParty.bfi.claimAnnounce.months，默认6个月） 2026-09-28 15:49:53 +08:00
刘泉佳 85b703b7d5 docs: 补充KingdeeReceiptFlow实体字段说明注释 2026-09-28 15:17:18 +08:00
刘泉佳 f292bb28a0 fix: 开户银行.编码（行号） 2026-09-28 14:40:10 +08:00
刘泉佳 f901ad3ff5 fix: 合并附件上传分支的编译报错 2026-09-28 10:54:45 +08:00
刘泉佳 a2abb3f921 Merge remote-tracking branch 'origin/feature/kingdee-attachment-sync' into feature/payment-apply-bfi-sync 
# Conflicts:
#	blade-common/src/main/java/org/springblade/common/feign/CustomFeignLogger.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/FormalSettlementServiceImpl.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/InvoiceApplicationServiceImpl.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/InvoiceReceiptServiceImpl.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/PaymentApplicationServiceImpl.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/support/KingdeeApBillSyncSupport.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/support/KingdeeArBillSyncSupport.java
 2026-09-28 10:50:09 +08:00
刘泉佳 15532feb81 Merge branch 'fix/a801-3-writeback-dedup-key' into feature/payment-apply-bfi-sync 2026-09-28 09:27:58 +08:00
刘泉佳 7e76964a76 feat: 金蝶定时同步加single-flight分布式锁，多副本与手动触发共用一道闸（付款结果回写/应收勾稽/开票结果/收票结果/客商同步） 
- 新增 KingdeeSyncLockSupport：零等待tryLock+租约可配+租户隔离，未启用blade.lock.enabled时降级并告警
- 各同步方法拆为锁壳+executeXxxSync主体，锁在service层保证手动触发端点与定时任务行为一致
- 租约配置：thirdParty.bfi.{payResult|arResult|invoiceResult|receivedInvoice|customer}.lockLeaseSeconds，默认1800秒
 2026-09-28 00:52:12 +08:00
刘泉佳 8b98e33daa fix: 修复A801-3收票单定时回写按发票号匹配防重键导致回写失效 
回写查询集与命中查找改用收票登记id（String.valueOf(receipt.getId())），
与A303-2落库的awrp_src_code及243d5be已修复的推送预检/A302-6路径同源；
原按发票号匹配永远查不到TMS自推单据，异常回收/指定补偿/单号补登全部静默失效。
同步修正queryReceivedInvoiceBySrcCodes过时javadoc（发票号码→收票登记id）。
 2026-09-28 00:44:10 +08:00
刘泉佳 2f5bb4a5a8 📝 新增金蝶附件上传下载链路梳理文档（A902上传+A801-2下载+对应关系核对） 2026-09-27 22:40:21 +08:00
刘泉佳 4e2f565d2f fix: 金蝶附件同步失败转成功时显式置空失败原因，修复updateById忽略null字段导致历史失败原因残留 2026-09-27 22:38:14 +08:00
刘泉佳 a3f1e07b2f feat: 金蝶票池发票文件下载（A801-2）：按发票号镜像优先/实时回源定位，后端流式代理供前端查看下载 2026-09-27 21:17:52 +08:00
刘泉佳 d94b956f26 fix: 文件上传到金蝶后，加个金蝶附件同步表报存文件信息 2026-09-24 22:51:35 +08:00
刘泉佳 4185372746 🐛 Feign日志multipart请求解析非文件字段打印，文件部分用占位符替代 2026-09-24 22:51:30 +08:00
刘泉佳 c10a6fc96f 🐛 修复Feign日志打印multipart文件上传内容 2026-09-24 22:47:41 +08:00
刘泉佳 bfcab41066 🐛 修复BFI附件上传Feign multipart编码失败（Error converting request body） 2026-09-24 22:43:45 +08:00
刘泉佳 50573e7263 feat: 收款认领金蝶对接业务侧接线（A301-2公告同步/A301-3认领推送/A301-1收款单回写） 2026-09-24 22:21:00 +08:00
刘泉佳 e50f4cbba6 feat: 收款认领金蝶对接新增数据字段与迁移SQL（流水表公告字段、认领来源编码） 2026-09-24 22:20:21 +08:00
刘泉佳 fb39d670c0 docs: 新增收款认领金蝶对接全链路业务流程文档（A301-2公告同步/A301-3认领推送/A301-1收款单回写） 2026-09-24 22:18:46 +08:00
刘泉佳 1b4ed22df3 📝 金蝶附件同步设计文档梳理对齐实施（as-built）：勘误前提、回填路径、事务边界与实施记录 2026-09-24 22:15:43 +08:00
刘泉佳 976abdf73a fix: 收票指定应付调试数据 2026-09-24 20:47:44 +08:00
刘泉佳 a2fd96da9d fix: 开票申请同步金蝶按发票张次拆分开票，提交sql 2026-09-24 19:47:54 +08:00
刘泉佳 aa06379737 feat: 付款申请金蝶推送完善往来账户（客商收款账户联行号）与结算方式映射 2026-09-24 19:42:58 +08:00
刘泉佳 851deb2959 feat: 开票申请金蝶推送支持发票张次拆分与幂等重推，回写金蝶单号 2026-09-24 19:42:48 +08:00
刘泉佳 e4095c6e60 feat: 正式结算与收票登记适配金蝶推送新分录口径（结算单维度传参、汇率/汇率日期） 2026-09-24 19:42:36 +08:00
刘泉佳 e923e07947 feat: 金蝶应付/应收/收票单推送支撑组件重构——结算明细行与结算合计费用项同口径，物料/计量单位映射完善 2026-09-24 19:42:19 +08:00
刘泉佳 5225444c3e feat: 金蝶物料编码映射常量与同步上下文缓存扩展（计量单位/客商收款账户） 2026-09-24 19:42:04 +08:00
刘泉佳 7e44d2d3d0 feat: 金蝶推送 DTO 与实体新增字段（运输货物/车号/开票单金蝶单号） 2026-09-24 19:41:52 +08:00
刘泉佳 6d0dc9a24a feat: 系统服务新增计量单位档案查询 Feign 接口 2026-09-24 19:41:21 +08:00
刘泉佳 044b593239 docs: 补充FormalSettlementSummaryFee实体类字段描述 2026-09-24 14:46:07 +08:00
刘泉佳 298c26f132 docs: 补充FormalSettlementDetailFee实体类字段描述 2026-09-24 14:43:24 +08:00
刘泉佳 088e5436b3 docs: 补充FormalSettlementDetail实体类字段描述 2026-09-24 14:29:30 +08:00
刘泉佳 1932ffe2d7 📝 补充金蝶附件同步关键链路日志（A902/A801-2 调用、单附件成功、内码反查回填与推送完成） 2026-09-24 13:47:30 +08:00
刘泉佳 c2f3a48c0e ✨ 金蝶附件同步（A902）：五类单据推送后联带上传附件、独立同步状态与列表聚合 2026-09-24 13:26:54 +08:00
刘泉佳 a17dd826ec docs: 金蝶附件同步（A902）设计文档与接口文档 2026-09-24 12:44:34 +08:00
刘泉佳 ff96cc8544 feat: A103-1下推结算方式按付款方式映射并本地组装勾稽键，应付分录含税金额兜底修复 2026-09-24 04:51:50 +08:00
刘泉佳 3516282510 fix: 合并master，解决编译报错 2026-09-24 03:30:05 +08:00
刘泉佳 cae284483e Merge remote-tracking branch 'origin/master' into feature/payment-apply-bfi-sync 
# Conflicts:
#	blade-common/src/main/java/org/springblade/common/config/BladeCommonConfiguration.java
#	blade-service-api/blade-system-api/src/main/java/org/springblade/system/feign/ISysClient.java
#	blade-service-api/blade-system-api/src/main/java/org/springblade/system/feign/ISysClientFallback.java
#	blade-service/blade-system/src/main/java/org/springblade/system/feign/SysClient.java
#	blade-service/blade-transport/pom.xml
#	blade-service/blade-transport/src/main/java/org/springblade/transport/mapper/CustomerArchiveMapper.xml
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/PaymentApplicationServiceImpl.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/wrapper/PaymentApplicationWrapper.java
#	blade-service/blade-transport/src/main/resources/application-dev.yml
#	blade-third-party-api/pom.xml
#	doc/nacos/blade-dev.yaml
#	doc/nacos/blade-prod.yaml
#	doc/nacos/third-party-api.yaml
#	pom.xml
 2026-09-24 03:15:30 +08:00
刘泉佳 0d1c6cee64 fix: 结算方式 2026-09-24 02:54:56 +08:00
刘泉佳 243d5be580 fix: 修复收票单推送金蝶防重键不匹配导致指定应付和幂等预检失败 
A303-2保存收票单时awrp_src_code使用receipt.getId()，但A302-6指定应付
和A801-3幂等预检误用receipt.getInvoiceNo()，导致：
1. A302-6指定应付传入发票号而非收票登记ID，金蝶报收票单不存在
2. A801-3预检用发票号匹配金蝶awrp_src_code(收票登记ID)，永远匹配不到
   已存在的收票单，重推时重复调A303-2被金蝶拒绝(已审核不允许修改)

修复：统一使用receipt.getId()作为收票单防重键
- assignApBill入参改为receipt.getId()（含补偿方法）
- queryKingdeeReceivedInvoiceRows传入receipt.getId()
- kingdeeRows.get()的key改为receipt.getId()
- 更正assignApBill方法注释
 2026-09-23 19:00:02 +08:00
刘泉佳 0c064f06c9 feat: 收票单分录改为与应付单同源结算费用行，防重键改用收票登记id 2026-09-23 16:01:17 +08:00
刘泉佳 cb0d9a0602 feat: 批量转结算候选明细接口新增单据号和合同编码查询参数 2026-09-23 15:39:35 +08:00
刘泉佳 78fabd15a5 docs: 更新金蝶票池选票业务流程（可用过滤、游标补页与固定查未用） 
同步2026-09-23选票方案演进：可用过滤口径、有界循环补页与nextCursor游标分页机制、
单据使用状态收敛为后端固定查未用、保存链路新增可用性复核步骤、前端弹窗条件与分页交互调整。
 2026-09-23 15:06:20 +08:00
刘泉佳 c91ab359ba feat: 金蝶票池选票仅出可用票并改造有界循环补页游标分页 
- 选票过滤：剩余可用金额availableAmount>0且金额使用状态amountUseStatus=0（未使用），保存落镜像前按同口径复核，防选票到保存之间票被他人使用造成超用
- 单据使用状态不再作为前端条件，后端固定下推未用（expenseStatus=1）
- 分页改造：单请求最多3次远程调用循环补页凑满一页，返回nextCursor（远程页码:已消费过滤行数）供下一页续扫，防过滤后翻页漏行重行，游标解析失败降级页码锚定
- 新增剩余可用金额availableTaxAmount展示字段（金蝶可用税额口径，不改可认领金额的价税合计口径）
 2026-09-23 15:06:07 +08:00
刘泉佳 8c52d47258 feat: 补全金蝶全票池A801-1返回字段映射并新增金额使用状态 
补全A801-1票面扩展字段（xbrl、通行费出入口、地区、购销方银行电话等），
新增金额使用状态amountUseStatus承接金蝶返回，供选票可用过滤与展示使用。
 2026-09-23 15:05:52 +08:00
刘泉佳 a2b5eeb837 revert: 恢复收票建表与推送迁移脚本原始内容，删列变更统一由新脚本承载 2026-09-23 12:03:57 +08:00
刘泉佳 4b79c209b1 docs: 修正收票删列脚本的金蝶状态展示口径注释 2026-09-23 11:22:19 +08:00
刘泉佳 7b7a40b94d chore: 补充收票单推送金蝶方法注释与批量推送关键环节日志 2026-09-23 11:08:50 +08:00
刘泉佳 c60954ad86 refactor: 清理收票金蝶同步下线后的死代码 2026-09-23 10:54:29 +08:00
刘泉佳 70d5d34461 refactor: 收票管理下线金蝶同步功能，金蝶状态改按推送结果二值展示 2026-09-23 10:47:40 +08:00
刘泉佳 b322d423d0 fix: 文档重命名 2026-09-23 10:34:20 +08:00
刘泉佳 125054359a refactor: 收票登记删除冗余金蝶同步字段并修正迁移脚本锚点 2026-09-23 10:30:17 +08:00
刘泉佳 171bc9ea2c fix: 金蝶付款结果定时回写默认false 2026-09-23 10:27:44 +08:00
刘泉佳 a09ec53b59 fix: 注释sql 2026-09-23 10:19:06 +08:00
刘泉佳 a2aeeb920d 📝 更新收票推送金蝶与票池选票业务流程文档，新增收票单推送全链路文档 2026-09-23 10:16:17 +08:00
刘泉佳 562127232b ✨ 收票单推送金蝶全链路（A303-2保存+A302-6指定应付+A801-3回写）与金蝶票池实时游标分页重构，下线镜像分页与定时绑定任务 2026-09-23 10:15:36 +08:00
刘泉佳 4de9534eba 🐛 BFI收票单查询修改时间字段修正为modifytimeS，开票申请发票查询新增mock调试开关 2026-09-23 10:14:56 +08:00
刘泉佳 6c81e7771d fix: 金蝶推送组织编码缺失报错改显示组织名称替代部门ID 2026-09-23 03:34:39 +08:00
刘泉佳 38c25d862e docs: 新增金蝶票池选票统一查镜像业务流程文档 2026-09-22 21:26:37 +08:00
刘泉佳 56e3e9deb0 feat: 金蝶票池选票统一查镜像（收票登记与结算单认领统一分页查询+按票号补查+A801-1限定正常票，下线实时透传假分页） 2026-09-22 21:24:00 +08:00
刘泉佳 b17f07b6c1 ♻️ 修复FormalSettlementServiceImpl审批状态常量引用 2026-09-22 14:49:54 +08:00
刘泉佳 06e6c9543f ♻️ syncKingdeeInvoiceResult优化N+1问题，使用批量查询和批量插入/更新 2026-09-22 14:29:37 +08:00
刘泉佳 1268561fd9 ✨ A303-5开票结果回写支持Base64解码响应并补充关键日志 2026-09-22 14:07:25 +08:00
刘泉佳 430fc6b5a7 ✨ 开票申请推送金蝶数电普票增加是否含税标记（hsbz=1） 2026-09-22 12:10:11 +08:00
刘泉佳 dd37c01500 ♻️ 审批状态常量抽取至TransportBusiConstant公共类 2026-09-22 11:26:20 +08:00
刘泉佳 d64b45d55d 📝 开票申请金蝶主表字段表补购销方地址电话与开户行展示开关 2026-09-22 11:03:41 +08:00