Commit Graph

100 Commits

Author SHA1 Message Date
刘泉佳 52d2f05524 docs: 客商黑名单与风险等级业务说明与运维手册 2026-10-30 11:42:22 +08:00
刘泉佳 4d16030999 docs: 同步付款特批通过后不推履约数据的口径与验证步骤 2026-10-29 11:04:10 +08:00
刘泉佳 adbc87e2e4 feat: 履约记录类型fd_paln_type按四场景传中文值(付款/收款/开票/收票) 2026-10-28 19:43:37 +08:00
刘泉佳 30ba7c6b3a docs: 新增C108履约记录四场景推送改造与验证指引文档 2026-10-28 19:31:04 +08:00
刘泉佳 68061aea58 fix: 合同文档提交 2026-10-23 19:03:45 +08:00
刘泉佳 dc262f2377 docs: 更新合同特批与结算付款特批流程梳理
同步 2026-10-23 付款特批改造:审批通过即发起 C106-3(/approve 同步、MK 回调异步、
不受 immediate-enabled 控制),特批审核期间不推 C103-9/C108 与金蝶,特批通过后补推并联动金蝶。
2026-10-23 17:48:08 +08:00
刘泉佳 34f9085daa docs: 新增HCS合同管理操作手册及纯操作版(含操作截图与定时任务说明) 2026-10-23 16:36:46 +08:00
刘泉佳 0c9f9dcb8b refactor: 收款认领合规链复用履约计划与履约记录既有开关
- 移除独立 claim.sync-enabled 开关(HcsProperties.Claim 配置节与 Nacos 配置样例)
- 认领链门禁改为复用既有开关:exe-stage.sync-enabled 门禁 C103-9 更新履约计划与 C107-1 认领记录(与合同链履约计划同步同开关);perf-record.sync-enabled 门禁 C108-1 履约流水(与付款链履约记录同步同开关)
- 同步更新业务流程梳理文档的开关说明与启用条件
2026-10-22 19:35:12 +08:00
刘泉佳 3e01a32cc6 docs: 新增收款认领同步合同合规业务流程梳理文档
- 收款认领推送金蝶完成后同步合同合规(C103-9履约计划/C107-1认领记录/C108-1履约流水)
  含业务逻辑总览、全链路流程、接口与字段映射、代码改动清单、启用操作过程与边界说明
2026-10-22 19:11:13 +08:00
刘泉佳 ced382f3f7 docs: 新增付款审批履约计划款项金额累加与金蝶付款申请业务流程梳理、付款作废影响分析与补齐方案文档 2026-10-22 19:06:47 +08:00
刘泉佳 2afc18b8de docs: 新增HcsPushTask定时任务逻辑与流程梳理文档 2026-10-22 16:25:10 +08:00
刘泉佳 86b8babcfc Merge remote-tracking branch 'origin/feature/20261019-bfi-all' into feature/hcs-api-p0
# Conflicts:
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/PaymentApplicationServiceImpl.java
2026-10-22 09:39:06 +08:00
刘泉佳 ed5eda6ed2 :docs: 更新HCS审批同步推送说明 2026-10-20 21:45:37 +08:00
刘泉佳 44e3ecfaa2 feat: 开票申请支持结算单重复选择并自动分摊控制累计额度
- 结算单候选接口放开未收票过滤,仅保留剩余可开票金额>0,响应新增已申请开票金额
- 保存申请时本次开票金额按选择顺序自动分摊到各结算单登记占用,摊不完报错,删除新建时未收票硬校验
- 详情实时重算已选结算单剩余可开票金额(排除本申请)
- 附改造说明与操作文档
2026-10-19 23:30:04 +08:00
刘泉佳 7858ba30ac docs: 付款申请同步金蝶技术文档按目录规范补充日期前缀(2026-09-16) 2026-10-19 11:19:03 +08:00
刘泉佳 aa75153955 docs: 更新BFI推送映射表组织/部门编码口径及付款申请技术文档
映射表:组织类字段统一为公司级平台公司编码口径,A103-3 拆分 awrp_department_number(部门级 kingdeeDeptNumber)与结算/申请/付款组织(kingdeeOrgNumber),补充组织编码层级说明;付款申请技术文档:组织字段来源改为 kingdeeOrgNumber/kingdeeDeptNumber,未传字段清单同步
2026-10-19 11:11:19 +08:00
刘泉佳 6d3c0bfef4 docs: 补充金蝶BFI操作手册定时任务运转逻辑与状态中文释义 2026-10-19 02:08:02 +08:00
刘泉佳 ed6346e7a1 docs: 新增预付转正式结算单与项目预付操作手册(纯操作·带状态) 2026-10-18 15:50:07 +08:00
刘泉佳 6e685d3440 docs: 新增预付转正式结算单与项目预付操作流程说明(分场景·前端后端) 2026-10-18 15:23:12 +08:00
刘泉佳 d937915043 docs: 新增预付完整流程梳理-正式结算单预付整合设计与落地后全链路文档 2026-10-18 14:32:01 +08:00
刘泉佳 755d420aa2 docs: 新增结算调整单分场景操作流程说明 2026-10-17 18:17:26 +08:00
刘泉佳 d69a56b4ac fix: 付款申请批量同步失败提示改用付款申请单号
批量同步失败提示原为付款申请雪花id,用户无法对应单据;改为从同步上下文取付款申请单号(doSyncKingdee 已加载实体,无额外查库),取不到时退回id。
2026-10-17 01:21:29 +08:00
刘泉佳 2a0c2cd9c9 refactor: 结算调整单推送金蝶与重新推送合并为单一按钮 2026-10-16 19:59:01 +08:00
刘泉佳 3055aced24 docs: 新增结算调整单接入金蝶设计文档 2026-10-16 19:46:52 +08:00
刘泉佳 576847396e docs: 新增收款流水多次认领与作废口径梳理文档 2026-10-16 15:27:10 +08:00
刘泉佳 709c633dbb :docs: 新增BFI推送入参取值映射表(含收票单往来类型固定客户) 2026-10-16 13:11:33 +08:00
刘泉佳 591b93f157 docs: 新增付款申请生成即回显预付信息改造文档 2026-10-16 00:15:49 +08:00
刘泉佳 cb19618101 fix: 解锁标识术语统一为金蝶锁单/金蝶删单
- 回调操作类型展示口径统一:SAVE=金蝶锁单(保存触发解锁,单据仍在)、DELETE=金蝶删单
- 同步更新解锁标识标签、VO 注释与业务流程文档
2026-10-15 11:44:37 +08:00
刘泉佳 f23e24e808 fix: 修正金蝶解锁回调单号定位并新增解锁终态页面标识
- 回调方向与锁定相反:按金蝶单号+我方单号双条件反查最新locked锁记录(targetBillType回调为空不参与匹配)
- 回调处理批量化:一次IN查询+updateBatchById批量落库,消除逐张查询/更新N+1
- 新增KingdeeUnlockMark展示契约与fillUnlockMarks通用填充,付款申请/结算单/开票申请VO回填解锁时间、操作人、动作名称
- 更新金蝶单据锁定与解锁业务流程文档(回调方向、解锁后数据变化、事务语义、联调实测结论)
2026-10-15 11:29:11 +08:00
刘泉佳 f5a7b76205 fix: 金蝶操作文档 2026-10-15 09:29:04 +08:00
刘泉佳 4b52eb28d8 fix: 金蝶文档新增发票菜单 2026-10-15 09:13:26 +08:00
刘泉佳 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