From 464e83fcf1fed72c96b5094ac5c09b35dab064cd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=88=98=E6=B3=89=E4=BD=B3?= <1107186916@qq.com> Date: Fri, 23 Oct 2026 19:16:06 +0800 Subject: [PATCH] =?UTF-8?q?fix:=20=E9=87=91=E8=9D=B6=E7=B3=BB=E7=BB=9FBFI?= =?UTF-8?q?=E7=9A=84nacos=E9=85=8D=E7=BD=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc/nacos/third-party-api.yaml | 32 ++++++++++++++++++++------------ 1 file changed, 20 insertions(+), 12 deletions(-) diff --git a/doc/nacos/third-party-api.yaml b/doc/nacos/third-party-api.yaml index 6ead9824..cda8991b 100644 --- a/doc/nacos/third-party-api.yaml +++ b/doc/nacos/third-party-api.yaml @@ -32,6 +32,7 @@ thirdParty: # 微信小程序 AppId / AppSecret（Nacos 配置，勿提交真实 secret） appId: ${WECHAT_MINI_APP_ID:} appSecret: ${WECHAT_MINI_APP_SECRET:} + # 业财融合（BFI）应用及接口配置，敏感值通过环境变量注入 bfi: # 业财融合（BFI）开放接口地址 baseUrl: ${BFI_BASE_URL:http://172.16.203.134:8000/gwzh/BFI} @@ -47,11 +48,13 @@ thirdParty: accountId: ${BFI_ACCOUNT_ID:} # 语言字串，默认 zh_CN language: ${BFI_LANGUAGE:zh_CN} + # BFI 客户端本地 Mock 开关（联调自测用，生产必须 false）： # true 时 IBfiClient 有桩用桩（{mockDir}/{接口方法名}.json）、无桩透传真实 Feign 接口，调用侧零改动 mock-enabled: ${BFI_MOCK_ENABLED:false} # Mock 桩文件目录：文件名为接口方法名，如 getToken.json、payApplyQuery.json；文件每次调用现读，改文件即生效 mockDir: ${BFI_MOCK_DIR:./mock/bfi} + # 数据来源系统编码（推送金蝶公共参数：客商、付款申请等统一使用），默认 WLTMS（运输TMS） srcSys: ${BFI_SRC_SYS:WLTMS} # 应付/应收/收票单分录物料映射（A102-2/A302-2/A303-2 共用，未配置使用代码默认值）： @@ -82,9 +85,10 @@ thirdParty: # 金蝶付款结果定时回写（A103-2 付款申请单查询 / A103-4 付款处理查询） payResult: # 回写任务开关 - syncEnabled: ${BFI_PAY_RESULT_SYNC_ENABLED:true} - # 调度 cron，默认每10分钟（:01 起步，错峰避让其他金蝶任务） + syncEnabled: ${BFI_PAY_RESULT_SYNC_ENABLED:false} + # 调度 cron，默认每10分钟 cron: ${BFI_PAY_RESULT_CRON:0 1/10 * * * ?} + # 金蝶收票单结果定时回写（A801-3 异常回收/指定补偿/单号补登） receivedInvoiceResult: # 回写任务开关，默认关闭（联调稳定后开启） @@ -95,15 +99,16 @@ thirdParty: receiptClaimPush: # 推送任务开关，默认关闭（联调稳定后开启） syncEnabled: ${BFI_RECEIPT_CLAIM_PUSH_SYNC_ENABLED:false} - # 调度 cron，默认每10分钟（:04 起步，错峰避让其他金蝶任务） + # 调度 cron，默认每10分钟 cron: ${BFI_RECEIPT_CLAIM_PUSH_CRON:0 4/10 * * * ?} # single-flight 分布式锁租约秒数，须大于最坏一轮耗时（逐认领人远程查公告+逐条推送）， # 进程异常退出时锁在租约到期后自动释放 lockLeaseSeconds: ${BFI_RECEIPT_CLAIM_PUSH_LOCK_LEASE_SECONDS:1800} + # 金蝶单据锁定定时补偿 billLock: # 锁定/解锁总开关（推送后锁定+解锁回调+补偿重锁共用），默认开启保持既有行为 - enabled: ${BFI_BILL_LOCK_ENABLED:true} + enabled: ${BFI_BILL_LOCK_ENABLED:false} # 锁定补偿开关，默认关闭（安全兜底） retryEnabled: ${BFI_BILL_LOCK_RETRY_ENABLED:false} # 补偿调度 cron，默认每5分钟（:02 起步，错峰避让其他金蝶任务） @@ -113,10 +118,10 @@ thirdParty: # 查询时间窗口（月数） months: ${BFI_CLAIM_ANNOUNCE_MONTHS:6} # 认领人：配置后公告查询固定使用该值，不再按当前登录用户姓名查询 - claimusers: ${BFI_CLAIM_ANNOUNCE_CLAIMUSERS:} - # 金蝶全票池发票定时同步（A801-1 窗口拉取+镜像 upsert，选票统一查本地） + claimusers: ${BFI_CLAIM_ANNOUNCE_CLAIMUSERS:徐媛} + # 收票管理金蝶全票池发票定时绑定（A801-1 查询全票池发票数据） invoiceReceipt: - # 同步任务开关，默认关闭（上线先手动 POST /invoice-receipt/sync-invoice-pool 跑一次全窗口铺底） + # 绑定任务开关，默认关闭（联调稳定后开启） syncEnabled: ${BFI_INVOICE_RECEIPT_SYNC_ENABLED:false} # 调度 cron，默认每30分钟（:16 起步，错峰避让其他金蝶任务） cron: ${BFI_INVOICE_RECEIPT_CRON:0 16/30 * * * ?} @@ -130,20 +135,22 @@ thirdParty: compensateLimit: ${BFI_INVOICE_RECEIPT_COMPENSATE_LIMIT:200} # single-flight 分布式锁租约秒数，须大于最坏一轮耗时；进程异常退出时锁在租约到期后自动释放 lockLeaseSeconds: ${BFI_INVOICE_RECEIPT_LOCK_LEASE_SECONDS:1800} + # 审批通过自动同步金蝶（事件触发：结算单A102-2/A302-2、付款申请A103-1/A103-3、开票申请A303-1、收票A303-2+A302-6） autoSync: # 结算单审批后自动推送开关 - settlement: ${BFI_AUTO_SYNC_SETTLEMENT:false} + settlement: ${BFI_AUTO_SYNC_SETTLEMENT:true} # 付款申请审批后自动推送开关 - payment: ${BFI_AUTO_SYNC_PAYMENT:false} + payment: ${BFI_AUTO_SYNC_PAYMENT:true} # 开票申请审批后自动推送开关 - invoiceApply: ${BFI_AUTO_SYNC_INVOICE_APPLY:false} + invoiceApply: ${BFI_AUTO_SYNC_INVOICE_APPLY:true} # 收票登记审批后自动推送开关 - receipt: ${BFI_AUTO_SYNC_RECEIPT:false} + receipt: ${BFI_AUTO_SYNC_RECEIPT:true} # failed 单据定时重推开关（仅重推生成失败，不扫 unsynced 存量） retryEnabled: ${BFI_AUTO_SYNC_RETRY_ENABLED:false} - # 重推调度 cron，默认每10分钟（:05 起步，错峰避让其他金蝶任务） + # 重推调度 cron，默认每10分钟 retryCron: ${BFI_AUTO_SYNC_RETRY_CRON:0 5/10 * * * ?} + # 客商金蝶数据定时同步（A902-1 复查 / A902-2 推送） customer: # 同步任务开关，默认关闭 @@ -152,6 +159,7 @@ thirdParty: cron: ${BFI_CUSTOMER_SYNC_CRON:0 0 2 * * ?} # 同步 single-flight 锁租约秒数，须大于最坏一轮耗时（复查 + 批量推送 + 停用联动） lockLeaseSeconds: ${BFI_CUSTOMER_SYNC_LOCK_LEASE_SECONDS:1800} + # 合同合规系统 hcs: # Mock 开关（true 时 IHcsClient 走本地 JSON 桩 F:/home/tms/mock/hcs/{方法名}.json，联调前自测用，生产必须 false；改配置需重启，改桩文件即时生效）