从金蝶云星空到聚水潭通过接口配置打通数据对接系统金蝶云星空金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。集成系统:聚水潭聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。配置集成方案通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为聚水潭，并且选择对应连接器（关于聚水潭的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的jushuitan.itemsku.upload接口作为数据写入动作完成第一步的接口配置。金蝶云星空接口明细接口： executeBillQuery 接口名称：物料查询接口方法： POST 请求参数字段名称类型描述 FMATERIALID 实体主键 string FNumber 编码 string FName 名称 string FSpecification 规格型号 string FOldNumber 旧物料编码 string FBARCODE 条码 string FDescription 描述 string FMaterialGroup_FNumber 物料分组 string FErpClsID 物料属性 string FDocumentStatus 数据状态 string FForbidStatus 禁用状态 string FBaseUnitId_FNumber 基本单位.编码 string FCreateOrgId_FNumber 创建组织 string FUseOrgId_FNumber 使用组织 string FIsInventory 允许库存 string FIsSale 允许销售 string FIsAsset 允许资产 string FIsSubContract 允许委外 string FIsProduce 允许生产 string FIsPurchase 允许采购 string FStockId_FNumber 仓库 string FPurchaseOrgId_FNumber 采购组织.编码 string FPurchaseOrgId_FName 采购组织 string FIsBatchManage 启用批号管理 string FIsKFPeriod 启用保质期管理 string FIsSNManage 启用序列号管理 string FSafeStock 安全库存 string FCategoryID 存货类别 string FExpPeriod 保质期 string FOrderQty 起订量 string FMinQty 最小批量 string FMaxQty 最大批量 string FDefaultVendor_FNumber 默认供应商 string FMaxPOQty 最大订货量 string FMinPOQty 最小订货量 string FIncreaseQty 最小包装量 string FFixLeadTime 固定提前期 string FVarLeadTime 变动提前期 string FPlanBatchSplitQty 拆分批量 string FProduceBillType_FNumber 生产类型 string FPOBillTypeId_FNumber 采购类型 string FSubBillType_FNumber 委外类型 string FGROSSWEIGHT 毛重 string FNETWEIGHT 净重 string FWEIGHTUNITID_FNumber 重量单位 string FLENGTH 长 string FWIDTH 宽 string FHEIGHT 高 string FVOLUME 体积 string FWARRANTY 保修期 string FSalePrice_CMK 零售价 string FVIPPrice_CMK 会员价 string FPurPrice_CMK 采购单价 string FComBrandId_CMK_FNumber 品牌 string Limit 最大行数 string 金蝶的查询分页参数 StartRow 开始行索引 string 金蝶的查询分页参数 TopRowCount 返回总行数 int 金蝶的查询分页参数 FilterString 过滤条件 string 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys 需查询的字段key集合 array 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId 业务对象表单Id string 必须填写金蝶的表单ID如😛UR_PurchaseOrder 响应参数字段名称类型描述 FMATERIALID 实体主键 string FNumber 编码 string FName 名称 string FSpecification 规格型号 string FOldNumber 旧物料编码 string FBARCODE 条码 string FDescription 描述 string FMaterialGroup_FNumber 物料分组 string FErpClsID 物料属性 string FDocumentStatus 数据状态 string FForbidStatus 禁用状态 string FBaseUnitId_FNumber 基本单位.编码 string FCreateOrgId_FNumber 创建组织 string FUseOrgId_FNumber 使用组织 string FIsInventory 允许库存 string FIsSale 允许销售 string FIsAsset 允许资产 string FIsSubContract 允许委外 string FIsProduce 允许生产 string FIsPurchase 允许采购 string FStockId_FNumber 仓库 string FPurchaseOrgId_FNumber 采购组织.编码 string FPurchaseOrgId_FName 采购组织 string FIsBatchManage 启用批号管理 string FIsKFPeriod 启用保质期管理 string FIsSNManage 启用序列号管理 string FSafeStock 安全库存 string FCategoryID 存货类别 string FExpPeriod 保质期 string FOrderQty 起订量 string FMinQty 最小批量 string FMaxQty 最大批量 string FDefaultVendor_FNumber 默认供应商 string FMaxPOQty 最大订货量 string FMinPOQty 最小订货量 string FIncreaseQty 最小包装量 string FFixLeadTime 固定提前期 string FVarLeadTime 变动提前期 string FPlanBatchSplitQty 拆分批量 string FProduceBillType_FNumber 生产类型 string FPOBillTypeId_FNumber 采购类型 string FSubBillType_FNumber 委外类型 string FGROSSWEIGHT 毛重 string FNETWEIGHT 净重 string FWEIGHTUNITID_FNumber 重量单位 string FLENGTH 长 string FWIDTH 宽 string FHEIGHT 高 string FVOLUME 体积 string FWARRANTY 保修期 string FSalePrice_CMK 零售价 string FVIPPrice_CMK 会员价 string FPurPrice_CMK 采购单价 string FComBrandId_CMK_FNumber 品牌 string 聚水潭接口明细 API： jushuitan.itemsku.upload NAME：商品上传（新） METHOD： POST 请求参数接口字段字段名称预设值描述 sku_id 商品编码 {{FNumber}} 商品编码 unit 单位 {{FBaseUnitId_FName}} 单位 shelf_life 保质期 function case when '{{FExpPeriod}}'>0 then '1095' else '' end 保质期 i_id 款式编码 {{FNumber}} 款式编码 brand 品牌，可更新 {{F_ABCD_ASSISTANT}} 品牌，可更新 vc_name 虚拟分类，可更新虚拟分类，可更新 c_name 商品分类，必须是[商品类目管理]中的叶子节点，可更新 {{FMaterialGroup_Fname}} 商品分类，必须是[商品类目管理]中的叶子节点，可更新 s_price 基本售价，可更新 1 基本售价，可更新 item_type 商品属性，可选值["成品", "半成品", "原材料", "包材"]，可更新成品商品属性，可选值["成品", "半成品", "原材料", "包材"]，可更新 l 长，可更新长，可更新 w 宽，可更新宽，可更新 h 高，可更新高，可更新 pic 图片地址，可更新图片地址，可更新 pic_big 大图地址，可更新大图地址，可更新 sku_pic 商品图片，可更新商品图片，可更新 name 名称，可更新 {{FName}} 名称，可更新 remark 备注，可更新备注，可更新 properties_value 颜色及规格，可更新 {{FSpecification}} 颜色及规格，可更新 short_name 简称，可更新简称，可更新 weight 重量，可更新重量，可更新 enabled 是否启用，默认值1, 可选值: -1=禁用, 0=备用, 1=启用，可更新 1 是否启用，默认值1, 可选值: -1=禁用, 0=备用, 1=启用，可更新 supplier_name 供应商名称，可更新供应商名称，可更新 supplier_sku_id 供应商商品编码，可更新供应商商品编码，可更新 supplier_i_id 供应商款式编码，可更新供应商款式编码，可更新 other_price_1 其它价格1，可更新其它价格1，可更新 other_price_2 其它价格2，可更新其它价格2，可更新 other_price_3 其它价格3，可更新其它价格3，可更新 other_price_4 其它价格4，可更新其它价格4，可更新 other_price_5 其它价格5，可更新其它价格5，可更新 other_1 其它属性1，可更新其它属性1，可更新 other_2 其它属性2，可更新其它属性2，可更新 other_3 其它属性3，可更新其它属性3，可更新 other_4 其它属性4，可更新其它属性4，可更新 other_5 其它属性5，可更新其它属性5，可更新 stock_disabled 禁止同步，true=禁止，false=允许，可更新 false 禁止同步，true=禁止，false=允许，可更新 cost_price 成本价，可更新成本价，可更新 market_price 市场吊牌价，可更新市场吊牌价，可更新 batch_enabled 是否启用生产批次 _function case when '{{FIsBatchManage}}'=' ' then false else false end 市场吊牌价，可更新 dataKey dataKey items 响应参数接口字段字段名称预设值描述 code 错误码，0代表成功错误码，0代表成功 issuccess true代表成功 true代表成功 msg 执行描述执行描述系统数据对接当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

从金蝶云星空到聚水潭通过接口配置打通数据

刘培强qeasy

从金蝶云星空到聚水潭通过接口配置打通数据

对接系统金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

集成系统:聚水潭

聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。

配置集成方案

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为聚水潭，并且选择对应连接器（关于聚水潭的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的jushuitan.itemsku.upload接口作为数据写入动作完成第一步的接口配置。

金蝶云星空接口明细

接口：executeBillQuery
接口名称：物料查询
接口方法：POST

请求参数

字段	名称	类型	描述
FMATERIALID	实体主键	string
FNumber	编码	string
FName	名称	string
FSpecification	规格型号	string
FOldNumber	旧物料编码	string
FBARCODE	条码	string
FDescription	描述	string
FMaterialGroup_FNumber	物料分组	string
FErpClsID	物料属性	string
FDocumentStatus	数据状态	string
FForbidStatus	禁用状态	string
FBaseUnitId_FNumber	基本单位.编码	string
FCreateOrgId_FNumber	创建组织	string
FUseOrgId_FNumber	使用组织	string
FIsInventory	允许库存	string
FIsSale	允许销售	string
FIsAsset	允许资产	string
FIsSubContract	允许委外	string
FIsProduce	允许生产	string
FIsPurchase	允许采购	string
FStockId_FNumber	仓库	string
FPurchaseOrgId_FNumber	采购组织.编码	string
FPurchaseOrgId_FName	采购组织	string
FIsBatchManage	启用批号管理	string
FIsKFPeriod	启用保质期管理	string
FIsSNManage	启用序列号管理	string
FSafeStock	安全库存	string
FCategoryID	存货类别	string
FExpPeriod	保质期	string
FOrderQty	起订量	string
FMinQty	最小批量	string
FMaxQty	最大批量	string
FDefaultVendor_FNumber	默认供应商	string
FMaxPOQty	最大订货量	string
FMinPOQty	最小订货量	string
FIncreaseQty	最小包装量	string
FFixLeadTime	固定提前期	string
FVarLeadTime	变动提前期	string
FPlanBatchSplitQty	拆分批量	string
FProduceBillType_FNumber	生产类型	string
FPOBillTypeId_FNumber	采购类型	string
FSubBillType_FNumber	委外类型	string
FGROSSWEIGHT	毛重	string
FNETWEIGHT	净重	string
FWEIGHTUNITID_FNumber	重量单位	string
FLENGTH	长	string
FWIDTH	宽	string
FHEIGHT	高	string
FVOLUME	体积	string
FWARRANTY	保修期	string
FSalePrice_CMK	零售价	string
FVIPPrice_CMK	会员价	string
FPurPrice_CMK	采购单价	string
FComBrandId_CMK_FNumber	品牌	string
Limit	最大行数	string	金蝶的查询分页参数
StartRow	开始行索引	string	金蝶的查询分页参数
TopRowCount	返回总行数	int	金蝶的查询分页参数
FilterString	过滤条件	string	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys	需查询的字段key集合	array	金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId	业务对象表单Id	string	必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

字段	名称	类型
FMATERIALID	实体主键	string
FNumber	编码	string
FName	名称	string
FSpecification	规格型号	string
FOldNumber	旧物料编码	string
FBARCODE	条码	string
FDescription	描述	string
FMaterialGroup_FNumber	物料分组	string
FErpClsID	物料属性	string
FDocumentStatus	数据状态	string
FForbidStatus	禁用状态	string
FBaseUnitId_FNumber	基本单位.编码	string
FCreateOrgId_FNumber	创建组织	string
FUseOrgId_FNumber	使用组织	string
FIsInventory	允许库存	string
FIsSale	允许销售	string
FIsAsset	允许资产	string
FIsSubContract	允许委外	string
FIsProduce	允许生产	string
FIsPurchase	允许采购	string
FStockId_FNumber	仓库	string
FPurchaseOrgId_FNumber	采购组织.编码	string
FPurchaseOrgId_FName	采购组织	string
FIsBatchManage	启用批号管理	string
FIsKFPeriod	启用保质期管理	string
FIsSNManage	启用序列号管理	string
FSafeStock	安全库存	string
FCategoryID	存货类别	string
FExpPeriod	保质期	string
FOrderQty	起订量	string
FMinQty	最小批量	string
FMaxQty	最大批量	string
FDefaultVendor_FNumber	默认供应商	string
FMaxPOQty	最大订货量	string
FMinPOQty	最小订货量	string
FIncreaseQty	最小包装量	string
FFixLeadTime	固定提前期	string
FVarLeadTime	变动提前期	string
FPlanBatchSplitQty	拆分批量	string
FProduceBillType_FNumber	生产类型	string
FPOBillTypeId_FNumber	采购类型	string
FSubBillType_FNumber	委外类型	string
FGROSSWEIGHT	毛重	string
FNETWEIGHT	净重	string
FWEIGHTUNITID_FNumber	重量单位	string
FLENGTH	长	string
FWIDTH	宽	string
FHEIGHT	高	string
FVOLUME	体积	string
FWARRANTY	保修期	string
FSalePrice_CMK	零售价	string
FVIPPrice_CMK	会员价	string
FPurPrice_CMK	采购单价	string
FComBrandId_CMK_FNumber	品牌	string

聚水潭接口明细

API：jushuitan.itemsku.upload
NAME：商品上传（新）
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
sku_id	商品编码	{{FNumber}}	商品编码
unit	单位	{{FBaseUnitId_FName}}	单位
shelf_life	保质期	function case when '{{FExpPeriod}}'>0 then '1095' else '' end	保质期
i_id	款式编码	{{FNumber}}	款式编码
brand	品牌，可更新	{{F_ABCD_ASSISTANT}}	品牌，可更新
vc_name	虚拟分类，可更新		虚拟分类，可更新
c_name	商品分类，必须是[商品类目管理]中的叶子节点，可更新	{{FMaterialGroup_Fname}}	商品分类，必须是[商品类目管理]中的叶子节点，可更新
s_price	基本售价，可更新	1	基本售价，可更新
item_type	商品属性，可选值["成品", "半成品", "原材料", "包材"]，可更新	成品	商品属性，可选值["成品", "半成品", "原材料", "包材"]，可更新
l	长，可更新		长，可更新
w	宽，可更新		宽，可更新
h	高，可更新		高，可更新
pic	图片地址，可更新		图片地址，可更新
pic_big	大图地址，可更新		大图地址，可更新
sku_pic	商品图片，可更新		商品图片，可更新
name	名称，可更新	{{FName}}	名称，可更新
remark	备注，可更新		备注，可更新
properties_value	颜色及规格，可更新	{{FSpecification}}	颜色及规格，可更新
short_name	简称，可更新		简称，可更新
weight	重量，可更新		重量，可更新
enabled	是否启用，默认值1, 可选值: -1=禁用, 0=备用, 1=启用，可更新	1	是否启用，默认值1, 可选值: -1=禁用, 0=备用, 1=启用，可更新
supplier_name	供应商名称，可更新		供应商名称，可更新
supplier_sku_id	供应商商品编码，可更新		供应商商品编码，可更新
supplier_i_id	供应商款式编码，可更新		供应商款式编码，可更新
other_price_1	其它价格1，可更新		其它价格1，可更新
other_price_2	其它价格2，可更新		其它价格2，可更新
other_price_3	其它价格3，可更新		其它价格3，可更新
other_price_4	其它价格4，可更新		其它价格4，可更新
other_price_5	其它价格5，可更新		其它价格5，可更新
other_1	其它属性1，可更新		其它属性1，可更新
other_2	其它属性2，可更新		其它属性2，可更新
other_3	其它属性3，可更新		其它属性3，可更新
other_4	其它属性4，可更新		其它属性4，可更新
other_5	其它属性5，可更新		其它属性5，可更新
stock_disabled	禁止同步，true=禁止，false=允许，可更新	false	禁止同步，true=禁止，false=允许，可更新
cost_price	成本价，可更新		成本价，可更新
market_price	市场	吊牌价，可更新		市场吊牌价，可更新
batch_enabled	是否启用生产批次	_function case when '{{FIsBatchManage}}'=' ' then false else false end	市场吊牌价，可更新
dataKey	dataKey	items

响应参数

接口字段	字段名称	描述
code	错误码，0代表成功	错误码，0代表成功
issuccess	true代表成功	true代表成功
msg	执行描述	执行描述

系统数据对接

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。