feat(kingdee): 新增收款部门字段映射与转换支持

- 新增 F_PZCW_Base_qtr1 类用于收款部门编号验证 - 在 ReceivableBill 中添加 receiveDept 字段并配置转换器 - 扩展 ReceivableMapping 以支持 F_PZCW_Base_qtr1 映射 - 实现 ReceivableReceiveDeptConverter 进行字段值转换 - 更新生产字段配置文档中的动态值映射规则 - 添加收款部门字段的完整配置 JSON 示例说明

feat(kingdee): 新增收款部门字段映射与转换支持
- 新增 F_PZCW_Base_qtr1 类用于收款部门编号验证 - 在 ReceivableBill 中添加 receiveDept 字段并配置转换器 - 扩展 ReceivableMapping 以支持 F_PZCW_Base_qtr1 映射 - 实现 ReceivableReceiveDeptConverter 进行字段值转换 - 更新生产字段配置文档中的动态值映射规则 - 添加收款部门字段的完整配置 JSON 示例说明
zhangmeiyang
1 parent 50996f81
Showing 5 changed files with 284 additions and 84 deletions
doc/生产字段配置.md
tax-central/src/main/java/com/diligrp/tax/central/converter/impl/ReceivableReceiveDeptConverter.java
tax-central/src/main/java/com/diligrp/tax/central/domain/document/kingdee/bill/ReceivableBill.java
tax-central/src/main/java/com/diligrp/tax/central/domain/mapping/kingdee/ReceivableMapping.java
tax-central/src/main/java/com/diligrp/tax/central/domain/mapping/kingdee/base/F_PZCW_Base_qtr1.java
@@ -695,115 +695,115 @@ PLAT_WITHDRAW(7, &quot;平台提现&quot;)
   "settingFieldType": 1,
   "dynamicValues": [
     {
-      "configValue": "0-1",
+      "configValue": "0-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "1-1",
+      "configValue": "1-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "2-1",
+      "configValue": "2-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "3-1",
+      "configValue": "3-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "4-1",
+      "configValue": "4-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "5-1",
+      "configValue": "5-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "6-1",
+      "configValue": "6-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "7-1",
+      "configValue": "7-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "8-1",
+      "configValue": "8-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "9-1",
+      "configValue": "9-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "10-1",
+      "configValue": "10-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "11-1",
+      "configValue": "11-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "12-1",
+      "configValue": "12-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "20-1",
+      "configValue": "20-B",
       "configMapValue": "101"
     },
     {
-      "configValue": "0-2",
+      "configValue": "0-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "1-2",
+      "configValue": "1-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "2-2",
+      "configValue": "2-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "3-2",
+      "configValue": "3-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "4-2",
+      "configValue": "4-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "5-2",
+      "configValue": "5-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "6-2",
+      "configValue": "6-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "7-2",
+      "configValue": "7-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "8-2",
+      "configValue": "8-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "9-2",
+      "configValue": "9-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "10-2",
+      "configValue": "10-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "11-2",
+      "configValue": "11-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "12-2",
+      "configValue": "12-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "20-2",
+      "configValue": "20-S",
       "configMapValue": "101.02"
     }
   ]
@@ -832,115 +832,115 @@ PLAT_WITHDRAW(7, &quot;平台提现&quot;)
   "settingFieldType": 1,
   "dynamicValues": [
     {
-      "configValue": "0-1",
+      "configValue": "0-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "1-1",
+      "configValue": "1-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "2-1",
+      "configValue": "2-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "3-1",
+      "configValue": "3-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "4-1",
+      "configValue": "4-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "5-1",
+      "configValue": "5-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "6-1",
+      "configValue": "6-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "7-1",
+      "configValue": "7-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "8-1",
+      "configValue": "8-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "9-1",
+      "configValue": "9-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "10-1",
+      "configValue": "10-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "11-1",
+      "configValue": "11-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "12-1",
+      "configValue": "12-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "20-1",
+      "configValue": "20-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "0-2",
+      "configValue": "0-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "1-2",
+      "configValue": "1-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "2-2",
+      "configValue": "2-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "3-2",
+      "configValue": "3-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "4-2",
+      "configValue": "4-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "5-2",
+      "configValue": "5-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "6-2",
+      "configValue": "6-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "7-2",
+      "configValue": "7-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "8-2",
+      "configValue": "8-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "9-2",
+      "configValue": "9-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "10-2",
+      "configValue": "10-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "11-2",
+      "configValue": "11-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "12-2",
+      "configValue": "12-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "20-2",
+      "configValue": "20-S",
       "configMapValue": "101.02"
     }
   ]
@@ -981,115 +981,115 @@ PLAT_WITHDRAW(7, &quot;平台提现&quot;)
   "settingFieldType": 1,
   "dynamicValues": [
     {
-      "configValue": "0-1",
+      "configValue": "0-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "1-1",
+      "configValue": "1-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "2-1",
+      "configValue": "2-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "3-1",
+      "configValue": "3-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "4-1",
+      "configValue": "4-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "5-1",
+      "configValue": "5-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "6-1",
+      "configValue": "6-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "7-1",
+      "configValue": "7-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "8-1",
+      "configValue": "8-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "9-1",
+      "configValue": "9-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "10-1",
+      "configValue": "10-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "11-1",
+      "configValue": "11-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "12-1",
+      "configValue": "12-B",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "20-1",
+      "configValue": "20-B",
       "configMapValue": "101"
     },
     {
-      "configValue": "0-2",
+      "configValue": "0-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "1-2",
+      "configValue": "1-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "2-2",
+      "configValue": "2-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "3-2",
+      "configValue": "3-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "4-2",
+      "configValue": "4-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "5-2",
+      "configValue": "5-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "6-2",
+      "configValue": "6-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "7-2",
+      "configValue": "7-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "8-2",
+      "configValue": "8-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "9-2",
+      "configValue": "9-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "10-2",
+      "configValue": "10-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "11-2",
+      "configValue": "11-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "12-2",
+      "configValue": "12-S",
       "configMapValue": "101.02"
     },
     {
-      "configValue": "20-2",
+      "configValue": "20-S",
       "configMapValue": "101.02"
     }
   ]
@@ -1462,6 +1462,131 @@ PLAT_WITHDRAW(7, &quot;平台提现&quot;)
 }
 ```
+### 2.11 receiveDept 收款部门
+
+```json
+{
+  "pipelineId": 2,
+  "documentType": "AR_receivable",
+  "configKey": "receiveDept",
+  "settingFieldType": 1,
+  "dynamicValues": [
+    {
+      "configValue": "0-B",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "1-B",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "2-B",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "3-B",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "4-B",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "5-B",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "6-B",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "7-B",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "8-B",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "9-B",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "10-B",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "11-B",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "12-B",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "20-B",
+      "configMapValue": "BM000042"
+    },
+    {
+      "configValue": "0-S",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "1-S",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "2-S",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "3-S",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "4-S",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "5-S",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "6-S",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "7-S",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "8-S",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "9-S",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "10-S",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "11-S",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "12-S",
+      "configMapValue": "BM000098"
+    },
+    {
+      "configValue": "20-S",
+      "configMapValue": "BM000098"
+    }
+  ]
+}
+```
+
 ## 3.收款单配置JSON
 ### 3.1 currency 币别
+package com.diligrp.tax.central.converter.impl;
+
+import com.diligrp.tax.central.converter.IConverter;
+import com.diligrp.tax.central.domain.mapping.kingdee.base.FSettleTypeID;
+import com.diligrp.tax.central.domain.mapping.kingdee.base.F_PZCW_Base_qtr1;
+import org.springframework.stereotype.Component;
+
+import java.util.Objects;
+
+/**
+ * @Author: zhangmeiyang
+ * @CreateTime: 2025-11-03 11:02
+ * @Version: todo
+ */
+@Component
+public class ReceivableReceiveDeptConverter implements IConverter<F_PZCW_Base_qtr1> {
+    @Override
+    public F_PZCW_Base_qtr1 convert(Object source) {
+        if (Objects.isNull(source)) {
+            return new F_PZCW_Base_qtr1();
+        }
+        F_PZCW_Base_qtr1 f_PZCW_Base_qtr1 = new F_PZCW_Base_qtr1();
+        f_PZCW_Base_qtr1.setFNUMBER((String) source);
+        return f_PZCW_Base_qtr1;
+    }
+}
@@ -18,6 +18,12 @@ import java.util.List;
 @Getter
 @Setter
 public class ReceivableBill extends BaseBill {
+
+    /**
+     * 收款部门
+     */
+    @Converter(value = ReceivableReceiveDeptConverter.class, targetField = "F_PZCW_Base_qtr1")
+    private String receiveDept;
     /**
      * 结算方法(FSettleTypeID)
      */
@@ -29,6 +29,7 @@ import java.util.List;
         "F_ZDB_Text667",
         "F_PZCW_Text",
         "F_PZCW_Base_qtr",
+        "F_PZCW_Base_qtr1",
         "F_PZCW_Text1",
         "FEntityDetail",
 })
@@ -45,6 +46,7 @@ public class ReceivableMapping extends BaseMapping implements Serializable {
     private FTRANSFERID FTRANSFERID;
     private FORDERID FORDERID;
     private F_PZCW_Base_qtr F_PZCW_Base_qtr;
+    private F_PZCW_Base_qtr1 F_PZCW_Base_qtr1;
     private FChargeId FChargeId;
     private FMAINBOOKSTDCURRID FMAINBOOKSTDCURRID;
     private FCURRENCYID FCURRENCYID;
@@ -209,6 +211,15 @@ public class ReceivableMapping extends BaseMapping implements Serializable {
         F_PZCW_Base_qtr = f_PZCW_Base_qtr;
     }
+    @JsonProperty("F_PZCW_Base_qtr1")
+    public F_PZCW_Base_qtr1 getF_PZCW_Base_qtr1() {
+        return F_PZCW_Base_qtr1;
+    }
+
+    public void setF_PZCW_Base_qtr1(F_PZCW_Base_qtr1 f_PZCW_Base_qtr1) {
+        F_PZCW_Base_qtr1 = f_PZCW_Base_qtr1;
+    }
+
     @JsonProperty("FMAINBOOKSTDCURRID")
     public FMAINBOOKSTDCURRID getFMAINBOOKSTDCURRID() {
         return FMAINBOOKSTDCURRID;
+package com.diligrp.tax.central.domain.mapping.kingdee.base;
+
+import com.diligrp.tax.central.domain.mapping.kingdee.VerifyMarkInterface;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * @Author: zhangmeiyang
+ * @CreateTime: 2025-09-19 14:53
+ * @Version: todo
+ */
+public class F_PZCW_Base_qtr1 implements VerifyMarkInterface {
+    private String FNUMBER;
+
+    @JsonProperty("FNUMBER")
+    public String getFNUMBER() {
+        return FNUMBER;
+    }
+
+    public void setFNUMBER(String FNUMBER) {
+        this.FNUMBER = FNUMBER;
+    }
+
+    @Override
+    public String verify() {
+        return "F_PZCW_Base_qtr1.FNUMBER";
+    }
+
+    @Override
+    public String value() {
+        return FNUMBER;
+    }
+}