From d1833a7ac1d9d8821c340b94804c6312b98b3497 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=88=98=E6=B3=89=E4=BD=B3?= <1107186916@qq.com>
Date: Thu, 17 Sep 2026 10:38:34 +0800
Subject: [PATCH] =?UTF-8?q?:sparkles:=20=E6=96=B0=E5=A2=9E=E9=87=91?=
=?UTF-8?q?=E8=9D=B6=E5=90=8C=E6=AD=A5=E5=B8=B8=E9=87=8F=E7=B1=BB=E5=B9=B6?=
=?UTF-8?q?=E7=BB=B4=E6=8A=A4=E5=8D=95=E6=8D=AE=E7=B1=BB=E5=9E=8B=E6=98=A0?=
=?UTF-8?q?=E5=B0=84=E5=AD=97=E5=85=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../constant/KingdeeBfiConstant.java | 121 ++++++++++++++++++
1 file changed, 121 insertions(+)
create mode 100644 blade-service/blade-transport/src/main/java/org/springblade/transport/constant/KingdeeBfiConstant.java
diff --git a/blade-service/blade-transport/src/main/java/org/springblade/transport/constant/KingdeeBfiConstant.java b/blade-service/blade-transport/src/main/java/org/springblade/transport/constant/KingdeeBfiConstant.java
new file mode 100644
index 00000000..a626e7dd
--- /dev/null
+++ b/blade-service/blade-transport/src/main/java/org/springblade/transport/constant/KingdeeBfiConstant.java
@@ -0,0 +1,121 @@
+/**
+ * BladeX Commercial License Agreement
+ * Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
+ *
+ * Use of this software is governed by the Commercial License Agreement
+ * obtained after purchasing a license from BladeX.
+ *
+ * 1. This software is for development use only under a valid license
+ * from BladeX.
+ *
+ * 2. Redistribution of this software's source code to any third party
+ * without a commercial license is strictly prohibited.
+ *
+ * 3. Licensees may copyright their own code but cannot use segments
+ * from this software for such purposes. Copyright of this software
+ * remains with BladeX.
+ *
+ * Using this software signifies agreement to this License, and the software
+ * must not be used for illegal purposes.
+ *
+ * THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
+ * not liable for any claims arising from secondary or illegal development.
+ *
+ * Author: Chill Zhuang (bladejava@qq.com)
+ */
+package org.springblade.transport.constant;
+
+import java.util.Map;
+
+/**
+ * 付款同步金蝶（星瀚）固定值。
+ * 金蝶侧档案编码暂以常量维护，待金蝶侧确认取值后直接修改常量重新发包。
+ *
+ * @author Chill
+ */
+public final class KingdeeBfiConstant {
+
+ /** 往来类型：供应商（付款申请与财务应付单共用）。 */
+ public static final String BFI_SUPPLIER_ASSTACT_TYPE = "bd_supplier";
+
+ /** 来源单据类型：上游合同（有合同时传 awrp_src_bt）。 */
+ public static final String BFI_CONTRACT_SRC_BT = "awrp_contract_info";
+
+ /** 无项目时传的项目编码占位值。 */
+ public static final String BFI_PROJECT_NUMBER_NONE = "999";
+
+ /** 付款类型编码：正式付款（结算付款）。 */
+ public static final String BFI_PAYMENT_TYPE_FORMAL = "201";
+
+ /** 付款类型编码：预付款。 */
+ public static final String BFI_PAYMENT_TYPE_PREPAY = "202";
+
+ /** A102-2 默认单据类型名称：服务采购应付（经 AP_BILL_BILLTYPE_MAP 转换为编码）。待确认：具体类型需金蝶侧最终确认，确认后修改此名称即可。 */
+ public static final String BFI_AP_BILL_BILLTYPE_NAME = "服务采购应付";
+
+ /** A102-2 款项性质编码（暂按 2001 材料采购）。待确认：编码需金蝶侧最终确认，确认后如有调整直接改此常量。 */
+ public static final String BFI_AP_BILL_PAY_PROPERTY = "2001";
+
+ /**
+ * A102-2 付款方式（赊购 CREDIT，允许金蝶侧后续调整付款金额；
+ * 现购 CASH 会由金蝶自动 100% 推付款）。待确认：如业务要求现购再调整。
+ */
+ public static final String BFI_AP_BILL_PUR_MODE = "CREDIT";
+
+ /**
+ * A102-2 明细必填：物料编码。TMS 无物料档案，当前为占位空值，
+ * 推送前会校验拦截。待确认：需金蝶侧提供运输服务类物料编码后补充。
+ */
+ public static final String BFI_AP_BILL_MATERIAL = "";
+
+ /**
+ * A102-2 明细必填：计量单位编码。TMS 无对应档案，当前为占位空值，
+ * 推送前会校验拦截。待确认：需金蝶侧确认编码（如"吨"）后补充。
+ */
+ public static final String BFI_AP_BILL_MEASURE_UNIT = "";
+
+ /** A102-2 必填：外部单据类型（应付单来源标识）。待确认：取值需金蝶侧确认，确认后如有调整直接改此常量。 */
+ public static final String BFI_AP_BILL_SRC_TYPE = "TMS财务应付单";
+
+ /** 财务应付单（ap_finapbill）单据类型映射：中文名称 -> 星瀚编码。 */
+ public static final Map AP_BILL_BILLTYPE_MAP = Map.ofEntries(
+ Map.entry("借贷项调整", "ApFin_borr_BT_S"),
+ Map.entry("费用采购应付", "ApFin_fee_BT_S"),
+ Map.entry("其他应付", "ApFin_other_BT_S"),
+ Map.entry("产品委外应付", "ApFin_product_BT_S"),
+ Map.entry("标准采购应付", "ApFin_pur_BT_S"),
+ Map.entry("采购费用应付", "ApFin_purfee_BT_S"),
+ Map.entry("销售费用应付", "ApFin_salefee_BT_S"),
+ Map.entry("服务采购应付", "ApFin_service_BT_S"),
+ Map.entry("资产采购应付", "ap_finapbill_asset_BT_S")
+ );
+
+ /** 财务应收单（ar_finarbill）单据类型映射：中文名称 -> 星瀚编码（当前付款链路未启用，应收结算单推送规则待业务确认）。 */
+ public static final Map AR_BILL_BILLTYPE_MAP = Map.ofEntries(
+ Map.entry("借贷项调整", "arfin_borrowar_BT_S"),
+ Map.entry("其他应收", "arfin_other_BT_S"),
+ Map.entry("销售费用应收", "arfin_salefee_BT_S"),
+ Map.entry("服务销售应收", "arfin_sersal_BT_S"),
+ Map.entry("标准销售应收", "arfin_standard_BT_S")
+ );
+
+ /** 付款申请单（ap_payapply）单据类型映射：中文名称 -> 星瀚编码（使用规则待业务确认）。 */
+ public static final Map PAY_APPLY_BILLTYPE_MAP = Map.of(
+ "采购付款申请", "ap_payapply_BT_S",
+ "其他付款申请", "ap_payapply_oth_BT_S"
+ );
+
+ /**
+ * 按中文名称从映射字典转换单据类型编码。
+ *
+ * @param billtypeMap 单据类型映射字典
+ * @param name 单据类型中文名称
+ * @return 星瀚单据类型编码，未维护时返回 null
+ */
+ public static String billtypeBy(Map billtypeMap, String name) {
+ return billtypeMap.get(name);
+ }
+
+ private KingdeeBfiConstant() {
+ }
+}