金蝶云星空和聚水潭接口打通对接实战接通系统：金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。对接系统：聚水潭聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。数据接口配置异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星空的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到聚水潭中。轻易云集成平台的可视化配置轻松实现。轻易云数据集成中台提供快速与各种业务系统进行连接的能力，可以将软件接口上线到平台轻松实现数百款应用软件的数据互通。也可以将轻易云的集成能力嵌入到您的软件系统中，将数百款软件的集成能力变成您产品的功能与卖点，扩展额外收入，提升客户成交率，成交金额与满意度。金蝶云星空接口明细 API： executeBillQuery NAME：物料查询 METHOD： POST 请求参数接口字段名称预设值 FMATERIALID 实体主键 FMATERIALID FNumber 编码 FNumber FName 名称 FName FSpecification 规格型号 FSpecification FOldNumber 旧物料编码 FOldNumber FBARCODE 条码 FBARCODE FDescription 描述 FDescription FMaterialGroup_FNumber 物料分组 FMaterialGroup.FNumber FErpClsID 物料属性 FErpClsID FDocumentStatus 数据状态 FDocumentStatus FForbidStatus 禁用状态 FForbidStatus FBaseUnitId_FNumber 基本单位.编码 FBaseUnitId.FNumber FCreateOrgId_FNumber 创建组织 FCreateOrgId.FNumber FUseOrgId_FNumber 使用组织 FUseOrgId.FNumber FIsInventory 允许库存 FIsInventory FIsSale 允许销售 FIsSale FIsAsset 允许资产 FIsAsset FIsSubContract 允许委外 FIsSubContract FIsProduce 允许生产 FIsProduce FIsPurchase 允许采购 FIsPurchase FStockId_FNumber 仓库 FStockId.FNumber FPurchaseOrgId_FNumber 采购组织.编码 FPurchaseOrgId.FNumber FPurchaseOrgId_FName 采购组织 FPurchaseOrgId.FName FIsBatchManage 启用批号管理 FIsBatchManage FIsKFPeriod 启用保质期管理 FIsKFPeriod FIsSNManage 启用序列号管理 FIsSNManage FSafeStock 安全库存 FSafeStock FCategoryID 存货类别 FCategoryID FExpPeriod 保质期 FExpPeriod FOrderQty 起订量 FOrderQty FMinQty 最小批量 FMinQty FMaxQty 最大批量 FMaxQty FDefaultVendor_FNumber 默认供应商 FDefaultVendor.FNumber FMaxPOQty 最大订货量 FMaxPOQty FMinPOQty 最小订货量 FMinPOQty FIncreaseQty 最小包装量 FIncreaseQty FFixLeadTime 固定提前期 FFixLeadTime FVarLeadTime 变动提前期 FVarLeadTime FPlanBatchSplitQty 拆分批量 FPlanBatchSplitQty FProduceBillType_FNumber 生产类型 FProduceBillType.FNumber FPOBillTypeId_FNumber 采购类型 FPOBillTypeId.FNumber FSubBillType_FNumber 委外类型 FSubBillType.FNumber FGROSSWEIGHT 毛重 FGROSSWEIGHT FNETWEIGHT 净重 FNETWEIGHT FWEIGHTUNITID_FNumber 重量单位 FWEIGHTUNITID.FNumber FLENGTH 长 FLENGTH FWIDTH 宽 FWIDTH FHEIGHT 高 FHEIGHT FVOLUME 体积 FVOLUME FWARRANTY 保修期 FWARRANTY FSalePrice_CMK 零售价 FSalePrice_CMK FVIPPrice_CMK 会员价 FVIPPrice_CMK FPurPrice_CMK 采购单价 FPurPrice_CMK FComBrandId_CMK_FNumber 品牌 FComBrandId_CMK.FNumber Limit 最大行数 {{PAGINATION_PAGE_SIZE}} StartRow 开始行索引 {{PAGINATION_START_ROW}} TopRowCount 返回总行数 FilterString 过滤条件 FApproveDate>='{{LAST_SYNC_TIME dateTime}}' FieldKeys 需查询的字段key集合 FormId 业务对象表单Id BD_MATERIAL 响应参数接口字段名称预设值 FMATERIALID 实体主键 FNumber 编码 FName 名称 FSpecification 规格型号 FOldNumber 旧物料编码 FBARCODE 条码 FDescription 描述 FMaterialGroup_FNumber 物料分组 FErpClsID 物料属性 FDocumentStatus 数据状态 FForbidStatus 禁用状态 FBaseUnitId_FNumber 基本单位.编码 FCreateOrgId_FNumber 创建组织 FUseOrgId_FNumber 使用组织 FIsInventory 允许库存 FIsSale 允许销售 FIsAsset 允许资产 FIsSubContract 允许委外 FIsProduce 允许生产 FIsPurchase 允许采购 FStockId_FNumber 仓库 FPurchaseOrgId_FNumber 采购组织.编码 FPurchaseOrgId_FName 采购组织 FIsBatchManage 启用批号管理 FIsKFPeriod 启用保质期管理 FIsSNManage 启用序列号管理 FSafeStock 安全库存 FCategoryID 存货类别 FExpPeriod 保质期 FOrderQty 起订量 FMinQty 最小批量 FMaxQty 最大批量 FDefaultVendor_FNumber 默认供应商 FMaxPOQty 最大订货量 FMinPOQty 最小订货量 FIncreaseQty 最小包装量 FFixLeadTime 固定提前期 FVarLeadTime 变动提前期 FPlanBatchSplitQty 拆分批量 FProduceBillType_FNumber 生产类型 FPOBillTypeId_FNumber 采购类型 FSubBillType_FNumber 委外类型 FGROSSWEIGHT 毛重 FNETWEIGHT 净重 FWEIGHTUNITID_FNumber 重量单位 FLENGTH 长 FWIDTH 宽 FHEIGHT 高 FVOLUME 体积 FWARRANTY 保修期 FSalePrice_CMK 零售价 FVIPPrice_CMK 会员价 FPurPrice_CMK 采购单价 FComBrandId_CMK_FNumber 品牌聚水潭接口明细接口： /open/shops/query 接口名称：商品上传（新）接口方法： POST 请求参数字段名称类型 items.name 名称，可更新 string items.s_price 基本售价，可更新 string items.properties_value 颜色及规格，可更新 string items.pic_big 大图地址，可更新 string items.sku_id 商品编码 string items.other_price_1 其它价格1，可更新 string items.vc_name 虚拟分类，可更新 string items.short_name 简称，可更新 string items.remark 备注，可更新 string items.other_5 其它属性5，可更新 string items.supplier_i_id 供应商款式编码，可更新 string items.cost_price 成本价，可更新 string items.h 高，可更新 string items.c_name 商品分类，必须是[商品类目管理]中的叶子节点，可更新 string items.weight 重量，可更新 string items.other_price_5 其它价格5，可更新 string items.market_price 市场吊牌价，可更新 string items.pic 图片地址，可更新 string items.other_price_3 其它价格3，可更新 string items.i_id 款式编码 string items.supplier_sku_id 供应商商品编码，可更新 string items.sku_code 国际码，可更新 string items.other_2 其它属性2，可更新 string items.stock_disabled 禁止同步，true=禁止，false=允许，可更新 string items.other_3 其它属性3，可更新 string items.l 长，可更新 string items 商品列表 array items.item_type 商品属性，可选值["成品", "半成品", "原材料", "包材"]，可更新 string items.supplier_name 供应商名称，可更新 string items.enabled 是否启用，默认值1, 可选值: -1=禁用, 0=备用, 1=启用，可更新 array items.other_1 其它属性1，可更新 string items.other_4 其它属性4，可更新 array items.other_price_2 其它价格2，可更新 string items.w 宽，可更新 string items.other_price_4 其它价格4，可更新 string items.sku_pic 商品图片，可更新 string items.brand 品牌，可更新 string 响应参数字段名称类型描述 code 错误码，0代表成功 string 错误码，0代表成功 issuccess true代表成功 string true代表成功 msg 执行描述 string 执行描述数据对接效果全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。

金蝶云星空和聚水潭接口打通对接实战

汪淼_轻易云

金蝶云星空和聚水潭接口打通对接实战

接通系统：金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

对接系统：聚水潭

聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。

数据接口配置

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星空的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到聚水潭中。轻易云集成平台的可视化配置轻松实现。轻易云数据集成中台提供快速与各种业务系统进行连接的能力，可以将软件接口上线到平台轻松实现数百款应用软件的数据互通。也可以将轻易云的集成能力嵌入到您的软件系统中，将数百款软件的集成能力变成您产品的功能与卖点，扩展额外收入，提升客户成交率，成交金额与满意度。

金蝶云星空接口明细

API：executeBillQuery
NAME：物料查询
METHOD：POST

请求参数

接口字段	名称	预设值
FMATERIALID	实体主键	FMATERIALID
FNumber	编码	FNumber
FName	名称	FName
FSpecification	规格型号	FSpecification
FOldNumber	旧物料编码	FOldNumber
FBARCODE	条码	FBARCODE
FDescription	描述	FDescription
FMaterialGroup_FNumber	物料分组	FMaterialGroup.FNumber
FErpClsID	物料属性	FErpClsID
FDocumentStatus	数据状态	FDocumentStatus
FForbidStatus	禁用状态	FForbidStatus
FBaseUnitId_FNumber	基本单位.编码	FBaseUnitId.FNumber
FCreateOrgId_FNumber	创建组织	FCreateOrgId.FNumber
FUseOrgId_FNumber	使用组织	FUseOrgId.FNumber
FIsInventory	允许库存	FIsInventory
FIsSale	允许销售	FIsSale
FIsAsset	允许资产	FIsAsset
FIsSubContract	允许委外	FIsSubContract
FIsProduce	允许生产	FIsProduce
FIsPurchase	允许采购	FIsPurchase
FStockId_FNumber	仓库	FStockId.FNumber
FPurchaseOrgId_FNumber	采购组织.编码	FPurchaseOrgId.FNumber
FPurchaseOrgId_FName	采购组织	FPurchaseOrgId.FName
FIsBatchManage	启用批号管理	FIsBatchManage
FIsKFPeriod	启用保质期管理	FIsKFPeriod
FIsSNManage	启用序列号管理	FIsSNManage
FSafeStock	安全库存	FSafeStock
FCategoryID	存货类别	FCategoryID
FExpPeriod	保质期	FExpPeriod
FOrderQty	起订量	FOrderQty
FMinQty	最小批量	FMinQty
FMaxQty	最大批量	FMaxQty
FDefaultVendor_FNumber	默认供应商	FDefaultVendor.FNumber
FMaxPOQty	最大订货量	FMaxPOQty
FMinPOQty	最小订货量	FMinPOQty
FIncreaseQty	最小包装量	FIncreaseQty
FFixLeadTime	固定提前期	FFixLeadTime
FVarLeadTime	变动提前期	FVarLeadTime
FPlanBatchSplitQty	拆分批量	FPlanBatchSplitQty
FProduceBillType_FNumber	生产类型	FProduceBillType.FNumber
FPOBillTypeId_FNumber	采购类型	FPOBillTypeId.FNumber
FSubBillType_FNumber	委外类型	FSubBillType.FNumber
FGROSSWEIGHT	毛重	FGROSSWEIGHT
FNETWEIGHT	净重	FNETWEIGHT
FWEIGHTUNITID_FNumber	重量单位	FWEIGHTUNITID.FNumber
FLENGTH	长	FLENGTH
FWIDTH	宽	FWIDTH
FHEIGHT	高	FHEIGHT
FVOLUME	体积	FVOLUME
FWARRANTY	保修期	FWARRANTY
FSalePrice_CMK	零售价	FSalePrice_CMK
FVIPPrice_CMK	会员价	FVIPPrice_CMK
FPurPrice_CMK	采购单价	FPurPrice_CMK
FComBrandId_CMK_FNumber	品牌	FComBrandId_CMK.FNumber
Limit	最大行数	{{PAGINATION_PAGE_SIZE}}
StartRow	开始行索引	{{PAGINATION_START_ROW}}
TopRowCount	返回总行数
FilterString	过滤条件	FApproveDate>='{{LAST_SYNC_TIME dateTime}}'
FieldKeys	需查询的字段key集合
FormId	业务对象表单Id	BD_MATERIAL

响应参数

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

聚水潭接口明细

接口：/open/shops/query
接口名称：商品上传（新）
接口方法：POST

请求参数

字段	名称	类型
items.name	名称，可更新	string
items.s_price	基本售价，可更新	string
items.properties_value	颜色及规格，可更新	string
items.pic_big	大图地址，可更新	string
items.sku_id	商品编码	string
items.other_price_1	其它价格1，可更新	string
items.vc_name	虚拟分类，可更新	string
items.short_name	简称，可更新	string
items.remark	备注，可更新	string
items.other_5	其它属性5，可更新	string
items.supplier_i_id	供应商款式编码，可更新	string
items.cost_price	成本价，可更新	string
items.h	高，可更新	string
items.c_name	商品分类，必须是[商品类目管理]中的叶子节点，可更新	string
items.weight	重量，可更新	string
items.other_price_5	其它价格5，可更新	string
items.market_price	市场	吊牌价，可更新	string
items.pic	图片地址，可更新	string
items.other_price_3	其它价格3，可更新	string
items.i_id	款式编码	string
items.supplier_sku_id	供应商商品编码，可更新	string
items.sku_code	国际码，可更新	string
items.other_2	其它属性2，可更新	string
items.stock_disabled	禁止同步，true=禁止，false=允许，可更新	string
items.other_3	其它属性3，可更新	string
items.l	长，可更新	string
items	商品列表	array
items.item_type	商品属性，可选值["成品", "半成品", "原材料", "包材"]，可更新	string
items.supplier_name	供应商名称，可更新	string
items.enabled	是否启用，默认值1, 可选值: -1=禁用, 0=备用, 1=启用，可更新	array
items.other_1	其它属性1，可更新	string
items.other_4	其它属性4，可更新	array
items.other_price_2	其它价格2，可更新	string
items.w	宽，可更新	string
items.other_price_4	其它价格4，可更新	string
items.sku_pic	商品图片，可更新	string
items.brand	品牌，可更新	string

响应参数

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

数据对接效果

全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。