feat: 金蝶锁单改1对1逐张调用并新增列表锁状态展示

2026-10-10 15:18:57 +08:00
parent 558c20efc2
commit 15d6f736e5
10 changed files with 178 additions and 69 deletions
@@ -493,7 +493,7 @@ public interface IBfiClient {

 	/**
 	 * 单据锁定（lockBusiData）：推送金蝶成功后 WLTMS 调用锁定目标单据；
-	 * 多张单据编号逗号拼接批量传参（sourceBillNo 与 targetBillNo 顺序一一对应），
+	 * 接口 1对1：单次仅一个源单号（sourceBillNo）对一个金蝶单号（targetBillNo），
 	 * 应答为 {updateCount, updateResultList} 裸结构（非 BfiResultVO 包装）；
 	 * 解锁结果由金蝶经 unLockNotifyBusiData 回调 WLTMS 通知（见 transport 侧公开端点）
 	 *
@@ -36,7 +36,7 @@ import java.io.Serial;
 * <p>lockBusiData：WLTMS 调金蝶，sourceSystem=WLTMS、targetSystem=XH、lockAction=LOCK；
 * unLockNotifyBusiData：金蝶调 WLTMS，sourceSystem=XH、targetSystem=WLTMS、lockAction=UNLOCK，
 * operationType=DELETE 时 WLTMS 侧需废除源单并还原关联数据。
- * 批量传参约定：多张单据编号以英文逗号拼接（sourceBillNo 与 targetBillNo 按顺序一一对应），
+ * 传参约定：接口 1对1，单次仅一个源单号（sourceBillNo）对一个金蝶单号（targetBillNo），
 * time/operator 按接口文档为选传字段（示例报文未携带），非空时才送</p>
 *
 * @author Chill
@@ -64,19 +64,19 @@ public class BfiBillLockDTO extends BfiBaseDTO {
 	 */
 	private String operationType;
 	/**
-	 * 【必填】源单据类型：调用方单据类型（WLTMS 自定义：SETTLEMENT/INVOICE_APPLY，金蝶固定：ApFin_other_BT_S 等），多张同类型
+	 * 【必填】源单据类型：调用方单据类型（WLTMS 自定义：SETTLEMENT/INVOICE_APPLY，金蝶固定：ApFin_other_BT_S 等）
 	 */
 	private String sourceBillType;
 	/**
-	 * 【必填】源单据编号，多张英文逗号拼接
+	 * 【必填】源单据编号，与 targetBillNo 一对一
 	 */
 	private String sourceBillNo;
 	/**
-	 * 【必填】目标单据类型：接收方单据类型（金蝶固定：ApFin_other_BT_S 等，WLTMS 自定义：SETTLEMENT 等），多张同类型
+	 * 【必填】目标单据类型：接收方单据类型（金蝶固定：ApFin_other_BT_S 等，WLTMS 自定义：SETTLEMENT 等）
 	 */
 	private String targetBillType;
 	/**
-	 * 【必填】目标单据编号，多张英文逗号拼接，与 sourceBillNo 顺序一一对应
+	 * 【必填】目标单据编号，与 sourceBillNo 一对一
 	 */
 	private String targetBillNo;
 	/**
@@ -317,7 +317,7 @@ public interface IBfiService {
 	BfiAttachmentUploadVO uploadAttachment(String entityNumber, String billPkId, String controlKey, String fileName, byte[] fileContent);

 	/**
-	 * 单据锁定（lockBusiData）：推送金蝶成功后锁定目标单据，多张单据编号逗号拼接批量传参，
+	 * 单据锁定（lockBusiData）：推送金蝶成功后锁定目标单据，接口 1对1（单次一个源单号对一个金蝶单号），
 	 * 解锁结果由金蝶回调 unLockNotifyBusiData 通知
 	 *
 	 * @param param 锁单参数，操作类型固定 LOCK，源系统 WLTMS、目标系统 XH