fix: 付款申请批量同步失败提示改用付款申请单号

批量同步失败提示原为付款申请雪花id，用户无法对应单据；改为从同步上下文取付款申请单号（doSyncKingdee 已加载实体，无额外查库），取不到时退回id。
2026-10-17 01:21:29 +08:00
parent 2a0c2cd9c9
commit d69a56b4ac
4 changed files with 10 additions and 5 deletions
@@ -46,11 +46,11 @@ public record KingdeeSyncContext(Map<Long, ContractManage> contractCache,
 								 Map<Long, List<FormalSettlementDetail>> settlementDetailCache,
 								 Map<Long, FormalSettlement> settlementCache,
 								 Map<Long, CustomerReceiptAccount> receiptAccountCache,
-								 Map<String, String> feeCategoryByName) {
+								 Map<String, String> feeCategoryByName, Map<Long, String> paymentNoCache) {

 	/** 空上下文：缓存可写但初始为空，首条记录命中后全批复用 */
 	public static KingdeeSyncContext empty() {
 		return new KingdeeSyncContext(new HashMap<>(), new HashMap<>(), new HashMap<>(),
-			new HashMap<>(), new HashMap<>(), new HashMap<>(), new HashMap<>(), new HashMap<>());
+			new HashMap<>(), new HashMap<>(), new HashMap<>(), new HashMap<>(), new HashMap<>(), new HashMap<>());
 	}
 }
@@ -548,6 +548,8 @@ public class PaymentApplicationServiceImpl extends BaseServiceImpl<PaymentApplic
 	@Transactional(rollbackFor = Exception.class)
 	public String doSyncKingdee(Long id, KingdeeSyncContext context) {
 		PaymentApplication entity = lockedPayment(id);
+		// 单据号入上下文：批量同步失败提示用单号定位单据（雪花id用户无法对应），不再额外查库
+		context.paymentNoCache().put(id, entity.getPaymentNo());
 		if (!TransportBusiConstant.APPROVED.equals(entity.getApprovalStatus())) throw new ServiceException("仅审批通过的付款申请允许生成金蝶单据");
 		if (KingdeeBfiConstant.KINGDEE_STATUS_SYNCED.equals(entity.getKingdeeStatus())
 			|| KingdeeBfiConstant.KINGDEE_STATUS_PAYING.equals(entity.getKingdeeStatus())
@@ -750,7 +752,10 @@ public class PaymentApplicationServiceImpl extends BaseServiceImpl<PaymentApplic
 				// 经自代理逐条调用：单据级事务，单条失败仅回滚自身且不中断整批
 				result.add(self.syncKingdee(id, context));
 			} catch (Exception exception) {
-				result.add("付款申请[" + id + "]同步失败：" + exception.getMessage());
+				// 失败提示用付款申请单号定位单据：单号已在推送时随上下文缓存，无需回查
+				String paymentNo = context.paymentNoCache().get(id);
+				String billNo = Func.isBlank(paymentNo) ? String.valueOf(id) : paymentNo;
+				result.add("付款申请[" + billNo + "]同步失败：" + exception.getMessage());
 			}
 		}
 		return result;
@@ -216,7 +216,7 @@ A102-2 所需的金蝶侧固定档案编码**不进 Nacos 配置**，统一定
 | --- | --- |
 | 单笔同步 `syncKingdee` | 校验失败/推送失败置 `failed` 并抛 `ServiceException`，前端提示原因（含金蝶 errors 明细） |
 | ①成功②失败 | `kingdeeStatus = failed`；重推时①按防重键走更新语义，继续② |
-| 批量同步 `syncKingdeeBatch` | 逐单循环，**单条失败不中断批次**；返回结果列表附 `付款申请[id]同步失败：原因` |
+| 批量同步 `syncKingdeeBatch` | 逐单循环，**单条失败不中断批次**；返回结果列表附 `付款申请[付款申请单号]同步失败：原因` |
 | 货物类型未维护档案编码 / 计量单位为空 | 分录解析（`collectEntryGroups`）时拦截，报错提示补充档案 |
 | 合同乙方为空 / 客商档案未维护客商编码 | 往来户取值（`bfiAsstactNumber`）时拦截，报错提示合同号与乙方名称 |
 | 金蝶接口级失败 | `BfiServiceImpl.commonCall` 抛 `BfiException`，同上处理 |
@@ -222,7 +222,7 @@ TMS 付款申请审核通过
 | 场景 | 行为 |
 | --- | --- |
 | 单笔同步 `syncKingdee` | 校验失败/推送失败置 `failed` 并抛 `ServiceException`，前端提示原因（含金蝶 errors 明细） |
-| 批量同步 `syncKingdeeBatch` | 逐单循环，**单条失败不中断批次**；失败单标记 `failed` 后继续下一单；返回结果列表中附 `付款申请[id]同步失败：原因` |
+| 批量同步 `syncKingdeeBatch` | 逐单循环，**单条失败不中断批次**；失败单标记 `failed` 后继续下一单；返回结果列表中附 `付款申请[付款申请单号]同步失败：原因` |
 | 金蝶接口级失败（status=false / errorCode≠0） | `BfiServiceImpl.commonCall` 抛 `BfiException`，同上处理 |
 | 金蝶单据级失败（billStatus=false） | 以 `errors` 拼接抛出 |
 | 重复点击同步 | 已 `synced` 单据跳过；`failed`/`unsynced` 允许重推（防重键保证金蝶侧幂等） |