b2894lxlx/tms-erp-api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
641 Commits 4 Branches 0 Tags
5371d618f13108d498159399e25f6d565b4d5e08
Commit Graph

69 Commits

Author SHA1 Message Date
刘泉佳 6fc2cca9ef Merge branch 'feature/payment-apply-bfi-sync' into feature/hcs-api-p0 
# Conflicts:
#	blade-service/blade-transport/src/main/java/org/springblade/transport/mk/MkProcessBizHandlers.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/ContractManageServiceImpl.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/task/CustomerKingdeeSyncTask.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/task/PaymentKingdeeResultTask.java
#	doc/nacos/blade.yaml
#	doc/nacos/third-party-api.yaml
 2026-10-15 04:07:13 +08:00
刘泉佳 259407c3b9 docs: 新增金蝶BFI全链路梳理总纲与BFI对接纯操作手册（2026-10-14） 
总纲：按业务域汇总前端入口-后端链路-定时任务三层流程，含审批自动同步/单据锁单解锁/failed重推/票池镜像读等新机制、状态机、配置开关与风险清单，并补充金蝶侧效果图14张；操作手册：面向业务与运维的纯操作版，含客商/预结算/结算/付款/开票/收票/收款认领与汇率维护全流程截图，TMS页面截图10张
 2026-10-15 03:31:23 +08:00
刘泉佳 076145d7f6 :feat: 审批通过自动创建履约计划行，C103-9同步前置至特批挂起之前 2026-10-14 14:11:31 +08:00
刘泉佳 30028b9e27 :feat: 付款申请收款方高风险黑名单统一走特批（特批附件校验/特批审核挂起/结果联动审批状态/金蝶推送门禁） 2026-10-14 10:05:46 +08:00
刘泉佳 08e07841b5 :feat: 合同特批结果定时查询兜底并同步更新设计文档 
- HcsPushTask 合同任务每轮附带 syncProcessingSpecResults：扫描特批中（processing）合同调 C103-4 详情，fdApprovalStatus=approved/approvalinvalid 联动恢复/驳回，作为合规回调未达时的补偿
- 更新 2026-10-12 特批流程梳理文档：状态机、阶段 B/C/D、§五机制汇总、§六配置、§七常量对齐当前实现
- 2026-10-09 前端接入设计文档标注 spec-apply 失效说明
 2026-10-13 18:36:38 +08:00
刘泉佳 52da9aab24 docs: 补充金蝶物料映射Nacos配置样例与分录拆分逻辑梳理文档 
third-party-api.yaml 新增 thirdParty.bfi.material 物料映射段（中文key方括号写法）；新增业务流程文档：取值来源总表、三级拆分规则、大类判定与税率取值、物料计量单位映射、场景算例与已知口径
 2026-10-13 11:34:55 +08:00
刘泉佳 63c2f7ed1e :feat: 合同附件挂载按 eopCdraft 枚举分类（fdEntityKey） 
- HcsSyncConstant 新增 CONTRACT_ATTACH_KEY_SPECIAL/SEAL/OTHER（eopCdraftSpecial/eopCdraftSign/eopCdraftOther）
- 转传接口返回 HcsAttachmentRefDTO（fdId+fdEntityKey+fdFileName），替代纯 fdId 列表
- 合同链路：主文件 approved=true 挂 eopCdraftSign、其它附件挂 eopCdraftOther、特批说明挂 eopCdraftSpecial
- buildDraftParam 直接消费引用列表统一补 fdBindType=ADD；特批付款/履约记录/收票单/开票登记四个挂载点改为在返回引用上补各自字段，行为不变
 2026-10-12 16:52:39 +08:00
刘泉佳 b8d93bc921 :feat: 特批结果回传校验来源系统标识，不符抛出来源系统标识错误异常 2026-10-12 11:48:13 +08:00
刘泉佳 e44270e6f0 :fix: 特批结果回传接口改为secure白名单放行，移除PERMIT_ALL注解 2026-10-12 11:36:54 +08:00
刘泉佳 6f774d50c7 :docs: 更新HCS特批结果回传机制相关文档 2026-10-12 11:18:35 +08:00
刘泉佳 3b7559e9d6 Merge branch 'feature/payment-apply-bfi-autoSync' into feature/payment-apply-bfi-sync 
# Conflicts:
#	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
 2026-10-12 10:59:15 +08:00
刘泉佳 8e6e263921 :feat: 新增外部客商高风险黑名单管控与合同自动特批 
1. GET /hcs/risk 返回 CustomerRiskVO：内部组织客商默认无风险不调合规，外部客商高风险/黑名单返回固定风险提示文案（riskTip），供基本信息备注后展示
2. 合同三个提交入口（submit/toTemporary/submitFormal）校验：甲乙方任一方高风险/黑名单时必须上传特批说明附件（attachmentType=spec_explanation）
3. pushContract 流程重排：C101-1 风险校验仅留痕不再阻断，C103-1 起草成功后高风险/黑名单合同自动挂起特批审核（currentNode）并发起 C103-8，解开原 need 挂起无 hcs_fd_id 的特批死锁
4. 特批结果联动：B103 回传/人工确认 approved 恢复审批通过展示，rejected 联动合同审批驳回走重新审批闭环
5. 补充推送入口/自动特批触发/跳过原因日志，流程梳理文档同步更新（§二/§七/§八/新增§九）
 2026-10-11 17:47:53 +08:00
刘泉佳 bce360350c fix: 审批通过自动同步金蝶文档 2026-10-11 15:51:03 +08:00
刘泉佳 78dd523e2f 📝 新增C102-1与C103-1接口页面字段取值说明文档（含必填项标记与自检清单） 2026-10-10 20:19:17 +08:00
刘泉佳 7e6970277c :feat: HCS接口500错误信息还原（Feign降级工厂还原远程msg/traceId，落库hcs_sync_msg） 2026-10-10 20:16:39 +08:00
刘泉佳 24a594185c :fix: 修正HCS来源标识约定值为WLTMS 2026-10-10 18:39:54 +08:00
刘泉佳 2ea5901238 :feat: 项目立项、合同审批通过后即时推送HCS合规系统（复用单条重推链路，扫描任务降级为兜底补偿，附前端接入设计§6增补） 2026-10-10 18:24:05 +08:00
刘泉佳 5d1f977abd feat: 付款申请纳入金蝶单据锁定与解锁流程（推送后锁单-删单回调还原-作废守卫-锁状态展示） 2026-10-10 16:00:32 +08:00
刘泉佳 15d6f736e5 feat: 金蝶锁单改1对1逐张调用并新增列表锁状态展示 2026-10-10 15:18:57 +08:00
刘泉佳 7cae2034a4 chore: 模板补齐kingdee-bfi回调secure.auth放行规则并与Nacos实际配置对齐 2026-10-10 10:34:48 +08:00
刘泉佳 b4119d9dfa feat: 金蝶解锁回调端点加入secure免登放行白名单（blade.secure.skip-url） 2026-10-10 09:38:46 +08:00
刘泉佳 1063d5875c docs: 金蝶单据锁定与解锁业务流程文档 2026-10-09 19:52:53 +08:00
刘泉佳 7855254a4f feat: 立项与合同HCS前端接入配套端点——C103-8合同特批发起/B103结果回传、C103-2/5附件代理、C101-1风险与C103-6/12主数据查询，合同推送高风险客商挂起待特批 2026-10-09 19:45:40 +08:00
刘泉佳 4cd7fb24df docs: HCS设计文档与实施清单同步一期范围调整（20接口口径，C103-9/C106-1/C108记录暂不对接及特批触发影响） 2026-10-09 12:00:39 +08:00
刘泉佳 ef0f9e6e36 fix: A303-1 开票申请推送放开来源单据字段 2026-10-08 19:59:04 +08:00
刘泉佳 7505d9bc55 feat: 全票池同步发票种类白名单下推远端——invoiceTypes单值参数按编码拆轮独立切片续扫，不再拉回后内存过滤消耗翻页额度；配置键 thirdParty.bfi.invoiceReceipt.invoiceTypes 2026-10-08 10:59:09 +08:00
刘泉佳 eb1edd3bbe docs: 金蝶票池选票回切镜像读终态口径文档，09-22实时版加退役声明 2026-10-05 17:54:03 +08:00
刘泉佳 d78757b64c fix: A303-1 开票申请推送放开上游来源单据字段，awrp_src_con_no 传首张结算单金蝶应收单编号（金蝶确认单据编号口径，取 A302-4 查询结果） 2026-10-01 22:23:41 +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
刘泉佳 1906e8c80b docs: 新增桂物合同集成相关接口说明-v4.docx（合规方接口说明原件，本次认证方案变更依据） 2026-10-01 02:06:04 +08:00
刘泉佳 f8bd66aafb docs: BFI接口编号补充名称标注，新增定时任务逻辑全梳理文档 2026-09-30 15:01:57 +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
刘泉佳 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
刘泉佳 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
刘泉佳 4c32cb9046 docs: 新增预付款申请A103-3金蝶链路补齐方案 
覆盖三项改造：e_bebank_number 与 A103-1 统一取联行号、A103-2 消失解锁兜底（ADR-0005）、
回写任务开关默认策略；含状态机全景、时序图、配置汇总与联调验证要点
 2026-09-29 01:51:07 +08:00
刘泉佳 f97237afe5 docs: 收款认领推送金蝶重构设计与业务流程文档、幂等变更SQL、集成语境术语 2026-09-29 01:02:14 +08:00
刘泉佳 4d62bb6df7 feat: A301-2 认领公告查询接口适配新参数（billstatus/modifytimeS/modifytimeE），时间窗口配置化（Nacos thirdParty.bfi.claimAnnounce.months，默认6个月） 2026-09-28 15:49:53 +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
刘泉佳 fc5bca2b10 docs: 新增HCS合同推送业务流程梳理（审批零埋点/定时扫描/五步推送链/履约规则行级同步/状态机与补偿） 2026-09-28 00:31:09 +08:00
刘泉佳 6dd1d67844 docs: 新增HCS接入实施状态与确认清单（已实现/未实现/待确认事项与上线检查清单） 2026-09-28 00:31:08 +08:00
刘泉佳 2f5bb4a5a8 📝 新增金蝶附件上传下载链路梳理文档（A902上传+A801-2下载+对应关系核对） 2026-09-27 22:40:21 +08:00
刘泉佳 a3f1e07b2f feat: 金蝶票池发票文件下载（A801-2）：按发票号镜像优先/实时回源定位，后端流式代理供前端查看下载 2026-09-27 21:17:52 +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
刘泉佳 a17dd826ec docs: 金蝶附件同步（A902）设计文档与接口文档 2026-09-24 12:44:34 +08:00
刘泉佳 78fabd15a5 docs: 更新金蝶票池选票业务流程（可用过滤、游标补页与固定查未用） 
同步2026-09-23选票方案演进：可用过滤口径、有界循环补页与nextCursor游标分页机制、
单据使用状态收敛为后端固定查未用、保存链路新增可用性复核步骤、前端弹窗条件与分页交互调整。
 2026-09-23 15:06:20 +08:00