b2894lxlx/tms-erp-api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
360 Commits 4 Branches 0 Tags
03c874d4cde0b789e9ea36c0310becbc86c0f03d
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
刘泉佳 03c874d4cd fix: blade-hcs-api补充blade-core-tool依赖修复Func类不可解析 2026-10-09 09:39:14 +08:00
刘泉佳 c6a817fb3a docs: HCS技术设计文档入库并同步v4认证口径（静态双头） 
- 技术设计文档（2026-09-27）首次入库：D2/§3.2/§7 更新为固定双请求头方案
- 实施状态清单：认证组件条目改写，待确认项改为附件接口头生效性
- nacos样例配置：base-url指向网关前缀，authorization/key-auth走环境变量注入
 2026-10-01 02:06:57 +08:00
刘泉佳 6255d65e21 feat: HCS认证改为固定Authorization+Key-Auth静态双请求头（v4接口说明变更） 
- 所有接口由拦截器统一注入 Authorization（整值可配）+ Key-Auth，不再调用getToken取令牌
- 删除 oauth2/getToken 与 basic 双模式、HcsTokenService/HcsTokenVO 及 Redis 令牌缓存、blade-starter-redis 依赖
- 新配置项 third-party.hcs.authorization / key-auth，未配置时告警放行（对端401暴露配置缺失）
- 各接口路径维持 thirdParty.hcs.*Url 覆盖机制，网关前缀拼在 base-url（如 /gwzh/HTHG）
 2026-10-01 02:06:34 +08:00
刘泉佳 1906e8c80b docs: 新增桂物合同集成相关接口说明-v4.docx（合规方接口说明原件，本次认证方案变更依据） 2026-10-01 02:06:04 +08:00
刘泉佳 fc5bca2b10 docs: 新增HCS合同推送业务流程梳理（审批零埋点/定时扫描/五步推送链/履约规则行级同步/状态机与补偿） 2026-09-28 00:31:09 +08:00
刘泉佳 6dd1d67844 docs: 新增HCS接入实施状态与确认清单（已实现/未实现/待确认事项与上线检查清单） 2026-09-28 00:31:08 +08:00
刘泉佳 62917c6864 feat: HCS对账查询端点（项目立项/合同/合同详情/开票登记按编号回查合规侧数据） 2026-09-28 00:31:08 +08:00
刘泉佳 b46906559b fix: 补齐收票/开票单条重推与批量推送端点接线（此前提交遗漏switch分支与注入） 2026-09-28 00:31:07 +08:00
刘泉佳 815f3f68e5 feat: HCS推送失败日志补全合规traceId（监控埋点，便于向合规方排查链路） 2026-09-28 00:31:07 +08:00
刘泉佳 12e2825e55 feat: HCS收票单同步与任务端点接线（C109-1/2含合同回溯与人工补录/扫描编排扩展开票收票/重推端点） 2026-09-28 00:31:07 +08:00
刘泉佳 e3b65697e9 feat: HCS开票登记同步支撑（C111-1判重/C111-2新增/C111-3票据日期回填/应收结算链路合同回溯） 2026-09-28 00:31:06 +08:00
刘泉佳 165c22c2d7 feat: HCS开票收票数据层与零埋点接线（实体合规字段组/收票合同补录字段/审批与金蝶开票回写置待同步） 2026-09-28 00:31:06 +08:00
刘泉佳 d6561dda17 feat: HCS付款链推送（C106-3/4结算付款特批/C108-1/2履约记录/扫描编排与手动端点/特批结果人工确认） 2026-09-28 00:31:06 +08:00
刘泉佳 cb54b569cd feat: HCS付款提交同步校验（C101-1客商风险黑名单阻断/C106-1额度校验超额转特批/校验留痕check_log） 2026-09-28 00:31:05 +08:00
刘泉佳 594773d7c7 feat: HCS付款申请数据层与零埋点接线（特批字段组/履约记录ID字段/审批与付款推进置待同步） 2026-09-28 00:31:05 +08:00
刘泉佳 d147ef8209 feat: HCS履约规则C103-9行级同步（随合同链路执行/行级增删改聚合/履约计划ID与阶段fdId回填持久化） 2026-09-28 00:31:05 +08:00
刘泉佳 892035ee6f feat: HCS履约规则数据层与表单维护（blade_contract_exe_stage表/行级差异标记维护接口/合同审批置行待同步） 2026-09-28 00:31:04 +08:00
刘泉佳 eaab17b220 feat: HCS推送任务与手动端点（定时扫描首推/补偿+分布式锁、单条重推/批量推送/主数据刷新端点） 2026-09-28 00:31:04 +08:00
刘泉佳 75bbd829c7 feat: HCS合同同步支撑（C101-1风险校验留痕/C103-3判重/C103-2附件转传/C103-1发起与C103-11更新） 2026-09-28 00:31:03 +08:00
刘泉佳 c34a5b5bc5 feat: HCS项目立项同步支撑（C102-3判重/C102-1新建/C102-2更新/合规fdId回填与失败补偿回写） 2026-09-28 00:31:03 +08:00
刘泉佳 f01cd9ec71 feat: HCS主数据缓存与附件转传支撑（C103-6/7/12模板分类币种缓存、C103-2附件转传与合规附件ID映射缓存） 2026-09-28 00:31:03 +08:00
刘泉佳 2cf71afeb4 feat: HCS推送零埋点接线（立项/合同审批通过与MK回调统一置hcs_sync_status=unsynced） 2026-09-28 00:31:02 +08:00
刘泉佳 cc9e01cff4 feat: HCS立项与合同数据层（实体合规字段组/合同风险留痕字段/校验留痕表/transport接入hcs-api依赖） 2026-09-27 22:41:04 +08:00
刘泉佳 a739211d6f feat: 新增桂物合同合规系统（HCS）接入P0骨架（blade-hcs-api模块：Feign/认证拦截器/令牌服务/24接口DTO/分页工具，附Nacos配置段与业务表统一字段组SQL） 2026-09-27 22:22:36 +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
刘泉佳 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
刘泉佳 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
刘泉佳 b0cc93bf08 ✨ 开票申请推送金蝶补齐购销方地址电话与开户行票面展示字段 
销方 showsaleraddresstel/showsalerbank 随地址电话、开户行账号一同置 true；新增购方 buyeraddr/buyerbank（取申请单受票方快照注册地址+联系电话、开户行+银行账号）及展示开关 showbuyeraddresstel/showbuyerbank；同时注释掉分录税收分类编码的联调硬编码，恢复取商品行快照。
 2026-09-22 11:03:12 +08:00
刘泉佳 6fa7761760 📝 更新开票申请同步金蝶分录取数口径文档 
A303-1 分录字段映射表补全 goodscode/remark/单价税额来源，明确不回查开票项目主数据、不按开票明细费用行展开分摊，税收分类编码与税率为空即报错。
 2026-09-22 10:52:09 +08:00
刘泉佳 3edefa9b4b ♻️ 开票申请同步金蝶分录组装改为纯页面商品行透传 
resolveInvoiceApplyEntries 去掉开票项目主数据全量拉取（ISysClient.getInvoiceItems）与合同计费规则链路（开票明细→正式结算明细→应收费用行 billing_rules_json）两处回查，分录的分类/简称/税收分类编码/税率/金额/税额/单价/备注全部取商品行落库值，行缺编码或缺税率直接报错；取数收敛为张次+商品行两条查询，避免逐张 N+1。
 2026-09-22 10:51:49 +08:00
刘泉佳 75d5b8cf81 ⚡ 开票申请相关实体补充字段描述注释 2026-09-21 21:19:34 +08:00
刘泉佳 447b087f67 ✨ 开票申请同步金蝶分录改按开票明细费用行展开逐行勾稽，税率透传开票项目小数，补销方地址电话与开户行账号，主表仅传必填字段 2026-09-21 21:19:26 +08:00
刘泉佳 72a1cfa9ec ✨ 开票项目主数据新增跨服务Feign查询（ISysClient.getInvoiceItems，启用档案按分类简称排序） 2026-09-21 21:19:18 +08:00
刘泉佳 7964690e5d 📝 新增应收结算与开票申请同步金蝶设计文档及全链路业务流程文档 2026-09-21 19:14:44 +08:00
刘泉佳 b454bdc6e3 ✨ 金蝶结果定时任务编排应收勾稽纠偏与开票结果回写子流程 2026-09-21 19:14:38 +08:00
刘泉佳 39ffac15e2 ✨ 开票申请同步金蝶A303-1并回写A303-5开票结果（销方与税收分类编码随单据取数，新增发票结果表） 2026-09-21 19:14:20 +08:00
刘泉佳 82b347cb18 ✨ 应收正式结算单同步金蝶财务应收单（A302-2保存+A302-4幂等预检与定时勾稽纠偏） 2026-09-21 19:14:05 +08:00
刘泉佳 b3eee6347b ⚡ 金蝶全票池定时同步按变更比对落库并加 single-flight 锁 
- 镜像批量 upsert 增加票面字段指纹比对，票面无变化不重写（含 attachments_json 大字段），口径对齐 MyBatis-Plus 非空字段更新策略
- 收票登记绑定前比对 kingdeeInvoicePoolId/kingdeeBillNo/kingdeeStatus，三项均无变化不更新；同步流水只在绑定关系变化或金蝶状态迁移时写入，原因文案按语义拆分为「定时绑定」与「定时刷新」
- 同步入口按租户加 RedisLockClient 分布式锁做 single-flight（零等待、租约可配 lockLeaseSeconds），未开启 blade.lock.enabled 时降级执行并告警
- 客商税号白名单明确为购、销双方税号均须命中客商档案（我方主体税号亦在档案中），抽出 taxNoArchived 做空值防护
- 日志补强：每页过滤漏斗明细、镜像无变化数、镜像未匹配登记提示、翻页触顶告警、补偿绑定耗时与远程补查次数、解析失败带发票号码
- Nacos 模板：MySQL 连接串补 rewriteBatchedStatements=true 使 JDBC 批量真正合批；dev/test 开启 blade.lock.enabled，prod 补开启前置条件说明
- SyncKingdeeTest：方法名更正为 syncKingdeeInvoicePool，测试属性关闭 syncEnabled，避免 cron 与手动触发在同一 JVM 并发跑
 2026-09-21 17:31:22 +08:00
刘泉佳 9a82ed2eaf 📝 新增收票管理同步金蝶全票池发票（A801-1 查询+批量同步+定时绑定关联）业务流程文档 2026-09-21 13:19:10 +08:00
刘泉佳 738c5c2539 🔧 收票管理金蝶全票池同步新增 Nacos 配置（开关/cron/增量窗口/种类白名单/补偿限量） 2026-09-21 13:19:01 +08:00
刘泉佳 f13f983467 ✨ 收票管理对接金蝶全票池（A801-1）：批量同步/定时绑定/补偿兜底 
批量同步按钮改调 A801-1 按发票号码精确查询并回填绑定；新增定时绑定任务（滚动增量窗口分页、镜像批量 upsert、绑定页级事务批量落库、发票种类与客商税号白名单过滤、未绑定登记按号补偿兜底）；新增手动触发端点 /invoice-receipt/sync-invoice-pool
 2026-09-21 13:18:52 +08:00
刘泉佳 69fee13242 ✨ 收票管理金蝶全票池同步：镜像表新增票池字段（幂等脚本）与实体字段备注 2026-09-21 13:18:41 +08:00
刘泉佳 933f9ffdb9 📝 toInvoicePoolVO 字段映射补充备注 2026-09-20 21:27:31 +08:00
刘泉佳 7ec3b2adbc ⚡ A801-1 全票池发票查询改为 pageNo/pageSize 透传分页 
- IBfiService.queryInvoicePool 改为单页查询返回 BfiPageVO，BfiServiceImpl 移除 queryAllPages 全量翻页
- 正式结算单认领查询透传 current/size，多取 1 条探测 hasMore 并合成 total，前端 R<IPage> 契约不变
- 移除内存作废过滤（rim 无对应查询条件，透传分页下会产生页内空洞）
- 同步更新 BfiUtil 技术文档 A801-1 说明与使用方清单
 2026-09-20 21:08:42 +08:00
刘泉佳 f9433cbc78 🐛 A801-1 查询入参字段 data 更正为 queryParam 2026-09-20 19:51:43 +08:00
刘泉佳 74512e6b66 fix: 修改BfiCustomerGroupEntryDTO备注 2026-09-20 19:47:18 +08:00
刘泉佳 c5d65f5678 ⚡ 优化金蝶客商定时同步消除N+1查询与逐条写入，快照纳入金蝶字段修复变更不落变更记录 2026-09-20 19:44:57 +08:00
刘泉佳 9a35d408dc ✨ 正式结算单新增全票池发票认领查询端点（多条件+内存精确分页） 2026-09-20 19:41:19 +08:00
刘泉佳 31a039245c ✨ blade-bfi-api 新增发票云全票池发票查询能力（A801-1 rim契约，queryAllPages全量翻页） 2026-09-20 19:41:07 +08:00
刘泉佳 44a34f57f0 🔥 移除业财融合资料文档的版本跟踪（TMS业财融合方案/接口文档/编码规范/集成流程梳理） 2026-09-20 16:46:15 +08:00
刘泉佳 a78aa770c7 ✅ 金蝶客商定时同步补充执行日志并新增手动触发测试类 2026-09-20 16:45:56 +08:00
刘泉佳 719ec4e8f6 ✨ 客商档案同步金蝶完善：伙伴类型按客商性质字典解析、推送银行/联系人分录、BFI配置抽取BfiProperties 2026-09-20 16:05:54 +08:00
刘泉佳 3950a3a0b0 Merge remote-tracking branch 'origin/feature/payment-apply-bfi-sync' into feature/payment-apply-bfi-sync 2026-09-19 14:13:56 +08:00
刘泉佳 ba93a9b0ca ⚡ 付款申请同步金蝶推送成功即时回填付款申请单编号，无需等待定时回写 2026-09-18 21:35:35 +08:00
刘泉佳 0531177ed7 ✨ 新增金蝶客商数据定时同步任务（自动推送+使用状态停用联动） 2026-09-18 21:34:37 +08:00
刘泉佳 0e1334be23 ⚡ 金蝶应付单分录不再按多货物类型拆行：整行一条分录，物料编码取第一种货物类型 2026-09-18 21:07:12 +08:00
刘泉佳 e79c4ce888 ⚡ 金蝶同步流程拆分：正式结算单同步推送财务应付单A102-2，付款申请同步仅推送付款申请单A103-1/A103-3 2026-09-18 20:42:44 +08:00