聚水潭和金蝶云星空接口打通对接实战接入系统：聚水潭聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。随着客户需求的不断变化，如今聚水潭已经发展成为以SaaSERP为核心，集多种商家服务为一体的SaaS协同平台。经过8年多的发展，公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点，服务范围覆盖超过400个城镇，为客户提供及时、周到和专业的服务。接入系统：金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。数据接口配置方案在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用聚水潭接口明细 API： sku.query NAME：普通商品资料查询（按sku查询） METHOD： POST 请求参数接口字段字段名称预设值描述 page_index 开始页 1 page_size 页行数 {{PAGINATION_PAGE_SIZE}} modified_begin 修改开始时间 {{LAST_SYNC_TIME datetime}} modified_end 结束时间 {{CURRENT_TIME datetime}} sku_ids 商品编码响应参数接口字段字段名称预设值描述 page_size 返回个数返回个数 page_index 第几页第几页 data_count 条数统计条数统计 page_count 页数统计页数统计 has_next 是否还有下一页是否还有下一页 datas 商品列表商品列表 datas.sku_id 商品编码商品编码 datas.i_id 款式编码款式编码 datas.name 商品名称商品名称 datas.short_name 商品简称商品简称 datas.sale_price 销售价销售价 datas.cost_price 成本价成本价 datas.properties_value 颜色规格颜色规格 datas.c_id 类目id 类目id datas.category 分类分类 datas.pic_big 大图地址大图地址 datas.pic 图片地址图片地址 datas.enabled 是否启用，0：备用，1：启用，-1：禁用 1 是否启用，0：备用，1：启用，-1：禁用 datas.weight 重量重量 datas.market_price 市场价市场价 datas.brand 品牌品牌 datas.supplier_id 供应商编号供应商编号 datas.supplier_name 供应商名称供应商名称 datas.modified 修改时间修改时间 datas.sku_code 国际码国际码 datas.color 颜色颜色 datas.properties_name 属性名称属性名称 datas.supplier_sku_id 供应商商品编码供应商商品编码 datas.supplier_i_id 供应商商品款号供应商商品款号 datas.vc_name 虚拟分类虚拟分类 datas.sku_type 商品类型商品类型 datas.creator 创建者创建者 datas.created 创建时间创建时间 datas.remark 备注备注 datas.item_type 商品属性，成品，半成品，原材料，包材商品属性，成品，半成品，原材料，包材 datas.unit 单位单位 datas.shelf_life 保质期保质期 datas.labels 商品标签，多个标签时以逗号分隔商品标签，多个标签时以逗号分隔 datas.code 0,代表成功，其他代表失败 0,代表成功，其他代表失败 datas.issuccess 是否成功是否成功金蝶云星空接口明细调用接口： batchSave 接口名称：物料新增方法： POST 请求参数字段字段名称类型配置值 FName 名称 string {{datas.name}} FNumber 编码 string {{datas.sku_id}} FDescription 描述 string FCreateOrgId 创建组织 string 101 FUseOrgId 使用组织 string 101 FSpecification 规格型号 string {{datas.properties_value}} FMnemonicCode 助记码 string FMaterialGroup 物料分组 string SubHeadEntity 基本 object datas SubHeadEntity.FErpClsID 物料属性 string 1 SubHeadEntity.FBaseUnitId 基本单位 string pcs SubHeadEntity.FCategoryID 存货类别 string CHLB05_SYS SubHeadEntity.FBARCODE 条形码 string SubHeadEntity.SubHeadEntity1 库存 object SubHeadEntity.SubHeadEntity1.FStockId 仓库 string SubHeadEntity.SubHeadEntity1.FSafeStock 安全库存 string SubHeadEntity.SubHeadEntity1.SubHeadEntity2 销售 object SubHeadEntity.SubHeadEntity1.SubHeadEntity2.FMaxQty 最大批量 string SubHeadEntity.SubHeadEntity1.SubHeadEntity2.FMinQty 最小批量 string SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3 采购 object SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FDefaultVendor 默认供应商 string SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FPurchaseOrgId 采购组织 string SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FormId 业务对象表单Id string BD_MATERIAL SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.Operation 执行的操作 string Save SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.IsAutoSubmitAndAudit 提交并审核 bool true SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.IsVerifyBaseDataField 验证基础资料 bool false 系统对接总览随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。

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

彭萍

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

接入系统：聚水潭

聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。随着客户需求的不断变化，如今聚水潭已经发展成为以SaaSERP为核心，集多种商家服务为一体的SaaS协同平台。经过8年多的发展，公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点，服务范围覆盖超过400个城镇，为客户提供及时、周到和专业的服务。

接入系统：金蝶云星空

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

数据接口配置方案

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用

聚水潭接口明细

API：sku.query
NAME：普通商品资料查询（按sku查询）
METHOD：POST

请求参数

接口字段	字段名称	预设值
page_index	开始页	1
page_size	页行数	{{PAGINATION_PAGE_SIZE}}
modified_begin	修改开始时间	{{LAST_SYNC_TIME datetime}}
modified_end	结束时间	{{CURRENT_TIME datetime}}
sku_ids	商品编码

响应参数

接口字段	字段名称	预设值	描述
page_size	返回个数		返回个数
page_index	第几页		第几页
data_count	条数统计		条数统计
page_count	页数统计		页数统计
has_next	是否还有下一页		是否还有下一页
datas	商品列表		商品列表
datas.sku_id	商品编码		商品编码
datas.i_id	款式编码		款式编码
datas.name	商品名称		商品名称
datas.short_name	商品简称		商品简称
datas.sale_price	销售价		销售价
datas.cost_price	成本价		成本价
datas.properties_value	颜色规格		颜色规格
datas.c_id	类目id		类目id
datas.category	分类		分类
datas.pic_big	大图地址		大图地址
datas.pic	图片地址		图片地址
datas.enabled	是否启用，0：备用，1：启用，-1：禁用	1	是否启用，0：备用，1：启用，-1：禁用
datas.weight	重量		重量
datas.market_price	市场价		市场价
datas.brand	品牌		品牌
datas.supplier_id	供应商编号		供应商编号
datas.supplier_name	供应商名称		供应商名称
datas.modified	修改时间		修改时间
datas.sku_code	国际码		国际码
datas.color	颜色		颜色
datas.properties_name	属性名称		属性名称
datas.supplier_sku_id	供应商商品编码		供应商商品编码
datas.supplier_i_id	供应商商品款号		供应商商品款号
datas.vc_name	虚拟分类		虚拟分类
datas.sku_type	商品类型		商品类型
datas.creator	创建者		创建者
datas.created	创建时间		创建时间
datas.remark	备注		备注
datas.item_type	商品属性，成品，半成品，原材料，包材		商品属性，成品，半成品，原材料，包材
datas.unit	单位		单位
datas.shelf_life	保质期		保质期
datas.labels	商品标签，多个标签时以逗号分隔		商品标签，多个标签时以逗号分隔
datas.code	0,代表成功，其他代表失败		0,代表成功，其他代表失败
datas.issuccess	是否成功		是否成功

金蝶云星空接口明细

调用接口：batchSave
接口名称：物料新增
方法：POST

请求参数

字段	字段名称	类型	配置值
FName	名称	string	{{datas.name}}
FNumber	编码	string	{{datas.sku_id}}
FDescription	描述	string
FCreateOrgId	创建组织	string	101
FUseOrgId	使用组织	string	101
FSpecification	规格型号	string	{{datas.properties_value}}
FMnemonicCode	助记码	string
FMaterialGroup	物料分组	string
SubHeadEntity	基本	object	datas
SubHeadEntity.FErpClsID	物料属性	string	1
SubHeadEntity.FBaseUnitId	基本单位	string	pcs
SubHeadEntity.FCategoryID	存货类别	string	CHLB05_SYS
SubHeadEntity.FBARCODE	条形码	string
SubHeadEntity.SubHeadEntity1	库存	object
SubHeadEntity.SubHeadEntity1.FStockId	仓库	string
SubHeadEntity.SubHeadEntity1.FSafeStock	安全库存	string
SubHeadEntity.SubHeadEntity1.SubHeadEntity2	销售	object
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.FMaxQty	最大批量	string
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.FMinQty	最小批量	string
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3	采购	object
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FDefaultVendor	默认供应商	string
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FPurchaseOrgId	采购组织	string
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FormId	业务对象表单Id	string	BD_MATERIAL
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.Operation	执行的操作	string	Save
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.IsAutoSubmitAndAudit	提交并审核	bool	true
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.IsVerifyBaseDataField	验证基础资料	bool	false

系统对接总览

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。