b2894lxlx/tms-erp-api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
453 Commits 4 Branches 0 Tags
bce360350cfec9383bf64670eb8f13e28069fdac
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
刘泉佳 bce360350c fix: 审批通过自动同步金蝶文档 2026-10-11 15:51:03 +08:00
刘泉佳 5a630bb102 fix: 开票申请单保存时送上游单据号 2026-10-11 14:44:33 +08:00
刘泉佳 2c87231cc6 fix: 审批通过自动同步金蝶失败原因提示到前端 2026-10-11 14:35:45 +08:00
刘泉佳 276dd813d4 feat: 审批通过事件触发自动同步金蝶（AFTER_COMMIT+4域开关） 
- 新增 KingdeeBillApprovedEvent（bizType复用MK处理器取值）与 KingdeeApprovalSyncListener：事务提交后同线程复用手动按钮同一Service方法推送，fallbackExecution兜底无事务场景，全量try/catch吞异常，审批结果不受推送影响
- 4域 approve 置approved成功后发布事件（重复审批被状态校验拒绝天然不重复推送）；正式结算单 approve 补 @Transactional（原缺失会致AFTER_COMMIT事件被丢弃，顺带使更新与变更记录原子化）
- 域开关 thirdParty.bfi.autoSync.{settlement,payment,invoiceApply,receipt} 默认全关（Nacos显式打开），关闭即回到现状；手动同步按钮全部保留，三入口并存：自动+定时+手动
- 推送失败由上一独立事务落failed+定时重推兜底
 2026-10-10 13:51:55 +08:00
刘泉佳 cfbbc756eb feat: 新增金蝶failed单据定时重推任务（兜底） 
- 新增 KingdeeAutoSyncRetryTask：仅重推各域 failed，不扫 unsynced（存量审批通过但从未推送的历史单不自动补推，仍走手动按钮）
- 4域新增 retryKingdeeFailed：逐单独立成败不中断，返回执行摘要；前置未就绪再次failed下轮继续，节点硬顺序由既有 A102-4/A302-4/A303-4/A801-3 预检保证，不做级联
- 收票重推以落库状态 pushed/assigned 判成败（批量推送方法逐单吞异常返回摘要）
- 开关 thirdParty.bfi.autoSync.retryEnabled 默认关闭，cron 默认每10分钟；重推无次数上限（噪音可接受后再加 retry_count）
 2026-10-10 13:50:12 +08:00
刘泉佳 03b343102e feat: 推送失败统一落failed口径（修总纲11.2-#3） 
- 结算单/开票申请推送失败由整体回滚保持unsynced改为：事务回滚后独立事务落failed+原因（结算写变更记录、开票写操作流水，无新列），与付款/收票口径统一
- 收票新增pushKingdeeReceivedInvoice(ids,autoSync)重载：自动推送路径前置拦截（未绑定镜像/查验未通过/前置应付单未生成等）置failed+原因纳入重推循环，已指定应付的良性跳过不改状态；手动批量路径保持拦截不动状态逐单报因
- 汇率未维护照旧不传不阻断
 2026-10-10 13:48:26 +08:00
刘泉佳 9365fd7738 refactor: MK流程结算/付款审批回调统一改调service.approve 
- 结算/付款 OA handler 不再直置 approved，与开票/收票 handler 对齐走 service.approve 统一入口
- 顺修两处绕过：付款审批补上票据额度联动 useBillBalance，结算审批补上变更记录
- 仅审批中单据可通过，重复 OA 回调被状态校验拒绝，为后续审批事件触发推送保证不重复推送
 2026-10-10 13:45:45 +08:00
刘泉佳 22b0b07ae2 feat: A303-1 开票申请推送放开特殊票种E04并随单报送货物运输单据体 2026-10-09 10:33:53 +08:00
刘泉佳 311da67744 feat: A303-1 开票申请单保存入参新增货物运输/旅客运输/代收车船税单据体 2026-10-09 10:21:25 +08:00
刘泉佳 ef0f9e6e36 fix: A303-1 开票申请推送放开来源单据字段 2026-10-08 19:59:04 +08:00
刘泉佳 36c264bfab Revert "feat: 金蝶应付/应收单分录按费用大类×税率拆分，一车多货再按货物拆分" 
This reverts commit 5d1c01e15e.
 2026-10-08 18:39:57 +08:00
刘泉佳 638a38a467 Revert "perf: 分录拆分补齐上下文缓存消除N+1，联调详细日志" 
This reverts commit b7beb949fb.
 2026-10-08 18:39:57 +08:00
刘泉佳 8f60bd5597 feat: 金蝶黑名单查询支持number企业税号数组入参，客商提审按发票信息纳税人识别号过滤校验 2026-10-08 18:25:58 +08:00
刘泉佳 a6af9a2ccd feat: 收款认领公告查询认领人改取Nacos配置thirdParty.bfi.claimAnnounce.claimusers，不再按当前登录用户姓名查询 2026-10-08 17:34:11 +08:00
刘泉佳 f4a4f1780e fix: 金蝶A801-5黑名单查询补必填分页参数并循环翻页取全量，查询异常上抛阻断客商提审 
- BfiBlacklistQueryDTO 补 pageNo/pageSize 必填字段，pageSize 取值范围[1,2000]
- BfiConstant 新增 BLACKLIST_QUERY_PAGE_SIZE=2000，IBfiClient.blacklistQuery 返回契约改为 BfiPageVO 分页结构
- BfiServiceImpl.queryBlacklist 复用 BfiUtil.queryAllPages 循环翻页聚合全量黑名单
- CustomerArchiveServiceImpl.validateBlacklist 移除吞异常放行逻辑，金蝶查询失败直接上抛 BfiException 阻断提审
 2026-10-08 17:33:25 +08:00
刘泉佳 7b41128db7 fix: 金蝶票池字段 出行人列表，客运票 2026-10-08 14:42:15 +08:00
刘泉佳 7505d9bc55 feat: 全票池同步发票种类白名单下推远端——invoiceTypes单值参数按编码拆轮独立切片续扫，不再拉回后内存过滤消耗翻页额度；配置键 thirdParty.bfi.invoiceReceipt.invoiceTypes 2026-10-08 10:59:09 +08:00
刘泉佳 cefe001c19 fix: 全票池同步切片续扫+有变化才写——单查询窗口2.5万硬上限触顶自动二分时间片递归（根治窗口尾部永久漏同步），镜像upsert轻量比对（流水号/价税合计/税额/可用金额/使用状态）无变化跳过重写消整窗无效写 2026-10-08 10:54:54 +08:00
刘泉佳 a1348fd381 feat: 全票池同步补绑定回填步骤（39ffac1口径瘦身版）——同页票号批量定位未绑定存量登记补绑+页级事务批量落库+同步流水，绑定关系无变化的已绑定登记零写入（新架构登记无金蝶流水号/状态字段，不做状态跟随刷新） 2026-10-08 09:50:25 +08:00
刘泉佳 eb1edd3bbe docs: 金蝶票池选票回切镜像读终态口径文档，09-22实时版加退役声明 2026-10-05 17:54:03 +08:00
刘泉佳 d3f549bf42 feat: 金蝶票池选票回切镜像读（本地真分页+票号未命中回源+瘦身版全票池定时同步+结算认领确认重查闸门，下线实时游标透传） 
- 选票两门面端点改查 blade_kingdee_invoice_pool 本地镜像：Mapper.xml 真分页+total 跳页，
  名称模糊/票种(invoice_type_code)/双税号/claimed/registered 三态过滤 SQL 直出，
  仅出可用票（available_amount>0 且 amount_use_status='0'，本地化执行原 isUsablePoolRow 口径）
- 票号精确查本地未命中→窄查一次 A801-1 回源入库后重查，兜底增量窗口缝隙内当日新票
- 瘦身版同步任务回归：增量窗口分页拉取+镜像全列批量 upsert（无绑定/补偿/白名单/指纹），
  复用 KingdeeSyncLockSupport single-flight；手动端点 POST /invoice-receipt/sync-invoice-pool 供 bootstrap
- 镜像实体/表新增 available_amount/amount_use_status，fillInvoicePool 统一回填（存根/回源/同步同口径）
- 结算认领确认补齐服务端按票号重查闸门（与收票保存 persistMirrorFromRemote 同闸门），收票保存重查原样保留
- 删除 KingdeeInvoicePoolPageVO 游标分页契约与 PoolScanCursor/decorateUseFlags 等实时链路代码
 2026-10-05 17:52:32 +08:00
刘泉佳 0dc6c9457a chore: 金蝶票池镜像读回切SQL（可用过滤两列+认领索引幂等脚本）与全票池同步Nacos配置键 2026-10-05 17:51:54 +08:00
刘泉佳 aa8526fbd4 fix: 附件下载对齐金蝶契约——A801-1 pdfurl 优先取 PDF 版式走 A801-2 2026-10-05 16:24:00 +08:00
刘泉佳 927e5a8139 fix: 金蝶PDF版式文件响应强制application/pdf，修复查看时blob不渲染退化为静默下载 2026-10-05 16:17:00 +08:00
刘泉佳 1d37596c2d fix: 票池附件优先取PDF版式(taxPdfUrl)并按实际格式命名，修复OFD文件被当.pdf预览/下载失败 2026-10-05 16:00:17 +08:00
刘泉佳 08d9a87e29 feat: A303-1 开票申请推送特殊票种映射（运费票送E04、其余送00非特殊票种），hsbz统一按不含税口径送0（金蝶联调反馈） 2026-10-02 00:17:32 +08:00
刘泉佳 048bcaf8ad feat: 客商提审接入国资委黑名单校验（A801-5） 
- submitApproval 前置实时查询金蝶黑名单（enable=1），按统一社会信用代码大写精确匹配
- 禁止交易类（A）硬拦截报错并提示失信类别与列入事由；风险警示类（B）默认放行告警，thirdparty.bfi.blacklist.blockRiskWarning=true 时一并拦截
- 黑名单查询异常不阻断准入，记 error 日志放行（金蝶可用性口径待联调确认）
 2026-10-01 23:47:49 +08:00
刘泉佳 cc54b4ca91 feat: BFI 新增 A801-5 黑名单查询接口对接 
- GET /ierp/kapi/v2/awrp/bdm/bdm_blacklist_config/blacklistquery，enable 使用状态参数，URL 经 thirdParty.bfi.blacklistQueryUrl 可配
- 返回字段保留金蝶原名（number 企业税号、awrp_combofield 失信类别 A 禁止交易类/B 风险警示类等）
- 规格来源为接口文档 xlsx（apifox 无此接口，xlsx 示例为 A801-1 错拷不可信），契约形态按 GET+query param 实现，联调若为 rim 形态仅需调整 BfiServiceImpl 单方法
 2026-10-01 23:47:33 +08:00
刘泉佳 b7beb949fb perf: 分录拆分补齐上下文缓存消除N+1，联调详细日志 
N+1 治理（复用 KingdeeSyncContext 全批档案缓存，批量同步不因拆分逻辑增加重复查询）：
- 合同计费方案解析按合同id缓存（BillingPlanInfo：计费单位+费用归类一次解析全批复用），
  消除批量同步逐单重复解析同一合同计费方案JSON（此前计费单位/归类各解析一次）
- 货物费用行按结算明细id上下文缓存（含空行占位，仅补查缺失明细），多结算单单据
  （收票登记分摊多结算单）跨结算单一次预查，逐结算单解析命中缓存
- 结算合计费用项按结算单id上下文缓存，多笔收票登记分摊同一结算单不再重复查询
- KingdeeSyncContext 新增 billingPlanCache/detailFeeCache/summaryFeeCache 组件

联调详细日志：
- 逐费用项归类明细（同单去重）：费用项->费用大类/税率+归类来源（计费方案规则/费用项档案/
  名称特征兜底/交叉补齐）；来源为名称兜底或税率未识别时升级 warn 提示补配置
- 分录生成日志增加费用项构成（运输费:100.00 + 装卸费:50.00）、货物、车号
- 货物费用行批量查询打印缓存命中/补查行数
 2026-10-01 23:15:40 +08:00
刘泉佳 5d1c01e15e feat: 金蝶应付/应收单分录按费用大类×税率拆分，一车多货再按货物拆分 
结算明细（一个运单）不再整行一条分录，改为按货物费用行费用项拆分归集：
- 费用大类拆分：运输费大类费用一行、装卸大类费用一行（费用类型/费用项名称归类）
- 税率拆分：同大类税率不同（合同计费方案规则税率，费用项档案兜底）再按税率拆多行
- 一车多货：明细下多行货物费用行时再按货物拆分
- 结算合计手工费用项保持每行一条；无有效货物费用项的明细兜底整行一条（历史数据）
- 含税金额按费用项归集，不含税按行内含税占比分摊（末项兜差额）；运费（freightAmount）
  在费用项JSON无运费项时并入运输费大类（与页面合计口径一致）
- 分录标识：未拆分保持单据号，拆分行取 单据号-费用大类-税率（-货物）保证候选键唯一
- 计量单位：费用项/费用大类匹配计费方案计费单位；非运输费大类缺配置兜底运费单位并告警
- A102-2/A302-2/A303-2 同源共用本解析；费用项档案经 ISysClient.getFeeItems 加载并入同步上下文缓存
 2026-10-01 22:52:07 +08:00
刘泉佳 d78757b64c fix: A303-1 开票申请推送放开上游来源单据字段，awrp_src_con_no 传首张结算单金蝶应收单编号（金蝶确认单据编号口径，取 A302-4 查询结果） 2026-10-01 22:23:41 +08:00
刘泉佳 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