蓝鲸金蝶ERP接口开发：多产品系列定制对接方案

文章出处:蓝鲸软件开发部来源:蓝鲸智造人气：0发表时间：2026-10-14 14:14

制造业客户的 ERP 往往是金蝶，而现场的生产执行需要 MES / WMS。金蝶旗下 K3Cloud（云星空）、K3 ERP、KIS 旗舰版等多个产品系列，部署形态、认证方式、单据模型与字段结构差异很大，通用接口无法直接套用。蓝鲸针对客户的金蝶版本、账套与实际业务单据逐一开发定制接口，打通工单、物料、工艺、订单、库存与出货数据，把客户的金蝶 ERP 顺利扩展为满足 MES / WMS 需求的一体化数字化工厂平台。

金蝶产品系列

KIS 旗舰版 API

K3Cloud 同步数据表

双向

Web Service 架构

一、覆盖的金蝶产品系列

不同系列采用不同接口形态与认证方式

蓝鲸已针对金蝶主流产品系列完成接口适配，并按客户实际部署版本做参数级定制：

金蝶 K3Cloud / 云星空

金蝶 K3Cloud（云星空）

标准开放平台接口，采用 Web Service + JSON 报文；认证需账套 ID + 应用 ID + 应用密钥 三要素授权。适合已上云 ERP、希望与 MES 双向实时同步的中大型企业。

金蝶 K3 ERP

经典 K3 版本，通过 Web Service 封装内部逻辑并发布查询接口；对接配置文件由金蝶方发放并写入 web.config。适合本地化部署、以 K3 为主核算体系的老客户升级。

金蝶 KIS 旗舰版

轻量级产品，通过 HTTP POST + application/json 调用 7 个 .ashx 接口，以 AppKey + Secret + Token 鉴权（令牌有效期 2 小时）。适合小微企业 / 单厂 MES 轻量集成场景。

二、整体架构：双向 Web Service 解耦

各封装内部逻辑，只对外提供接口

蓝鲸 MES 与金蝶 ERP 之间的对接采用 Web Service 方式：两个系统各自封装内部实现逻辑，互相只提供调用接口，不侵入对方业务代码，后续任一侧升级只需在接口层适配。

基础数据同步：ERP → MES

金蝶侧提供 Web Service 查询接口，以 JSON 格式把工单、物料、工艺、工作中心等基础数据发送给蓝鲸 MES；同步由后台服务定时调用，不占用人工。

基础数据同步：MES 主动拉取

金蝶提供 Web Service 查询接口，蓝鲸 MES 系统主动调用该接口获取数据。适用于首次全量初始化与批量补录场景。

业务流程对接：双向回写

MES 提供 Web Service 接口供 ERP 调用实现业务逻辑，ERP 亦提供接口供 MES 调用；报工、领料、入库、出货等业务单据在两个系统间双向流转。

三、金蝶 K3Cloud 基础数据同步

键值表 + 日志表 + Windows 定时服务

金蝶相关数据发生变化（工单新增行、更新行、删除行等）时需同步至 MES。做法是在金蝶侧建立同步主键数据表，以数字标记与时间戳记录是否同步及同步时间；同时建立同步日志表留存变化痕迹，便于追溯与重同步。

机制表	关键字段	作用
数据同步键值表	`TableName` 数据表名称 · `ViewName` 视图名称 · `KeyField` 键值 · `SyncFlag` 同步标记 · `SyncDate` 同步日期 · `Deleted` 删除标记 · `ChangeDate` 变化日期	三键（表名 + 视图 + 键值）构成唯一主键；同步标记用于限制已同步数据重复同步，删除与变化标记用于追踪删除与更新
数据同步日志表	`RecNo` 流水号 · `TableName` · `KeyField` · `ChangeFlag` 变化标记 · `ChangeDate` 变化日期	记录每一次数据变化，作为审计与人工介入的依据

同步的数据（10 张表对表单向同步）

仅将金蝶基础数据同步到 MES

提供表对表单向同步：只将金蝶系统基础数据同步到 MES 系统中，目前覆盖 10 张数据表：

序号	数据表描述	业务作用
1	工单基本信息档	生产工单单头，是排产与报工的主线数据
2	工单物料档	工单用料明细，支撑领料 / 退料与齐套分析
3	工单工序档	工单工艺路线，驱动车间工序流转与过账
4	工单订单关联档	工单与销售订单的关联关系，支持追溯
5	工单报工记录档	车间报工结果，是工时与成本核算依据
6	工艺资源关联档	工艺与资源的关联，支撑产能与负荷计算
7	工艺基本档	工艺路线主档，定义各品号的加工步骤
8	订单明细档	销售订单行项目，含数量、交期与价格
9	订单主档	销售订单表头，含客户与交付信息
10	品号基本信息档	物料主档，含品号、品名、规格、分类

服务部署与金蝶侧读取配置

Windows 定时服务 + 应用配置

同步程序以 Windows 服务方式定时运行，调用数据同步服务程序；安装时修改日志目录与同步服务地址，运行注册批处理后在控制面板启动服务即可。金蝶侧读取服务参数写入应用配置文件，红色标注项需按客户实际情况设置（下表已做脱敏处理）：

<add key "FirstRun" value="Y"/> 
<add key "DataSynchroDB" value="DataSynchro"/> 
<add key "X-KDApi-AcctID" value="************"/> 
<add key "X-KDApi-ServerUrl" value="https://{金蝶服务地址}/K3Cloud"/> 
<add key "X-KDApi-AppID" value="************"/> 
<add key "X-KDApi-AppSec" value="************"/> 
<add key "X-KDApi-UserName" value="系统接口"/> 
<add key "X-KDApi-LCID" value="2052"/>

※ 账套 ID、应用 ID、应用密钥等敏感凭证由金蝶方发放，仅存放于服务端配置文件，不进入前端页面、不随文档外发。本页面所有取值均以 ************ 脱敏示意。客户租户域名与账套编号因涉密已移除。

四、金蝶 KIS 旗舰版 API（7 个接口）

HTTP POST + application/json

基于金蝶 KIS 旗舰版，采用 C# + VB 方式完成查询与数据保存。服务器需安装 IIS 6.0 以上与 .Net 4.0；提交方式为 HTTP POST，Content-Type: application/json。所有接口必须传递 AppKey、Secret，除令牌获取接口外还需传递 Token。

序号	接口文件	说明	关键参数 / 返回
1	UserToken.ashx	登录令牌获取接口	入参 AppKey、Secret；返回 `status`、`userToken`（有效期 2 小时）
2	selTemplate.ashx	模板类型接口	返回模板类型 ID 与类型名称，可用于查询单据 / 基础资料类型
3	getBillTemp.ashx	模板对应字段接口	返回字段显示名、数据库字段名、数据类型、字段长度、是否必录、表头表体标识等，是字段映射的依据
4	selItem.ashx	基础资料查询接口	按基础资料类型 ID 查询，字段结构参照模板接口返回
5	selBill.ashx	单据查询接口	单据类型 ID 必填；单据编号、开始日期、截止日期为可选，支持按时间区间与单号精确检索
6	delBill.ashx	单据删除接口	单据类型 ID 与单据编号均必填，返回状态与错误说明
7	addData.ashx	基础资料及单据的增加、修改接口	查找类字段应传 ID；单据传表头与表体数据包，基础资料传资料数据包；基础资料不允许删除；服务端每 0.1 秒处理一次队列，返回可能存在短暂延迟

请求报文示例

凭证与 ID 均为示意值

// addData.ashx 请求体（AppKey / Secret / Token 及业务 ID 均为示意值）
{
  "AppKey": "************",
  "Secret": "************",
  "Token": "************",
  "FTypeID": "A01",  // 单据类型 ID
  "BillNo": "A0001",  // 单据编号
  "BillHead": { "FStatus": 0, "Fdate": "2018-08-08", "FBillerID": *******, "FSupplyID": **** },
  "BillEntry": [ { "FItemID": ***, "FUnitID": **, "Fauxqty": 200, "Fauxprice": 1.5, "Famount": 300, "FBatchNo": "" } ]
}

※ 单据的表头 / 表体字段名以 模板对应字段接口返回的 FFieldName 为准，基础资料字段以 FSQLColumnName 为准。

五、MES 侧服务与字段映射

品号 / 工单 / 工作中心三类主数据

金蝶接口返回 JSON 后，由蓝鲸侧遍历数据集、与 MES 的 WCF 服务字段一一对应赋值后再传入，实现金蝶 → MES 的单向落库。共发布 3 个标准同步服务：

品号同步服务

品号、品名、规格、品号分类、商品描述 5 个核心字段，路径 PM/SyncPartService.svc。

工单同步服务

工单单别、单号、材料品号、需领用量、已领用量、工艺、单位、仓库、取替代料、材料类型、上阶主件品号、预计/实际领料日、审核码、包装量、已生成工序卡标志等 22 个字段，路径 MOC/SyncJobOrderService.svc。

工作中心同步服务

机器编号、工作中心编号、机器名称、机器产能、负荷率、备注，并预留 6 个字符串、6 个数值与 12 个用户自定义字段，路径 CMS/SyncCenterWorkService.svc。

同步实施要点

映射、同步标志与主键唯一性

字段映射

调用金蝶接口取得 JSON 数据集，按 API 文档取所需字段，通过 for 循环遍历并与 MES WCF 服务接口字段一一赋值，再传入 MES 完成落库。

同步标志

同步标志作用很大，它能限制已经同步过的数据再次同步，避免重复推送与数据翻倍。

三主键唯一性

同步实施时必须确保三主键的唯一性（表名 + 视图名 + 键值），否则同步标志与键值表无法准确定位记录，会造成漏同步或错更新。

六、凭证与数据安全

授权即隔离

AppKey / Secret、应用 ID / 密钥、账套 ID 均由金蝶方发放，只写入服务端配置文件，前端页面与文档中一律脱敏。

最小权限

接口授权用户建议单独开设（如“系统接口”账号）并限定可访问对象，避免使用金蝶管理员账号做系统对接。

定期轮换

应用密钥与令牌建议定期轮换；令牌有效期 2 小时，过期后需重新调用令牌接口获取，服务端应做自动续期。

链路与访问控制

K3Cloud 走 HTTPS 服务地址；建议配合 IP 白名单与反向代理访问控制，数据库连接串与密码不落前端。

让客户的金蝶 ERP，真正为 MES / WMS 服务

按客户版本与账套定制开发，覆盖 K3Cloud、K3 ERP、KIS 旗舰版多系列；基础数据表对表单向同步，业务单据双向回写；同步标记 + 三主键机制保证不重不漏、变更可追溯；凭证集中在服务端配置并定期轮换，安全与运维均可控。接口方案已沉淀为标准化交付模板，新客户只需替换参数与字段映射即可快速上线。

接口开发咨询：18046986669（龚先生） | 广东蓝鲸智造网络技术有限公司 | 官网：www.ljepic.com

其他ERP接口