金蝶云星空对接打通聚水潭物料查询接口与商品上传（新）接口对接系统：金蝶云星空金蝶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电商学院”达成深度合作。数据集成方案配置异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星空的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到聚水潭中。轻易云集成平台的可视化配置轻松实现。金蝶云星空接口明细调用接口： executeBillQuery 接口名称：物料查询方法： POST 请求参数字段字段名称类型配置值 FMasterId id string FMasterId FNumber 编码 string FNumber FName 名称 string FName FSpecification 规格型号 string FSpecification FMnemonicCode 助记码 string FMnemonicCode FOldNumber 旧物料编码 string FOldNumber FBARCODE 条码 string FBARCODE FDescription 描述 string FDescription FMaterialGroup_FNumber 物料分组 string FMaterialGroup.FNumber FErpClsID 物料属性 string FErpClsID FDocumentStatus 数据状态 string FDocumentStatus FForbidStatus 禁用状态 string FForbidStatus FBaseUnitId_FNumber 基本单位.编码 string FBaseUnitId.FNumber FCreateOrgId_FNumber 创建组织 string FCreateOrgId.FNumber FUseOrgId_FNumber 使用组织 string FUseOrgId.FNumber FIsInventory 允许库存 string FIsInventory FIsSale 允许销售 string FIsSale FIsAsset 允许资产 string FIsAsset FIsSubContract 允许委外 string FIsSubContract FIsProduce 允许生产 string FIsProduce FIsPurchase 允许采购 string FIsPurchase FStockId_FNumber 仓库 string FStockId.FNumber FPurchaseOrgId_FNumber 采购组织.编码 string FPurchaseOrgId.FNumber FPurchaseOrgId_FName 采购组织 string FPurchaseOrgId.FName FIsBatchManage 启用批号管理 string FIsBatchManage FIsKFPeriod 启用保质期管理 string FIsKFPeriod FIsSNManage 启用序列号管理 string FIsSNManage FSafeStock 安全库存 string FSafeStock FCategoryID 存货类别 string FCategoryID FExpPeriod 保质期 string FExpPeriod FOrderQty 起订量 string FOrderQty FMinQty 最小批量 string FMinQty FMaxQty 最大批量 string FMaxQty FDefaultVendor_FNumber 默认供应商 string FDefaultVendor.FNumber FMaxPOQty 最大订货量 string FMaxPOQty FMinPOQty 最小订货量 string FMinPOQty FIncreaseQty 最小包装量 string FIncreaseQty FFixLeadTime 固定提前期 string FFixLeadTime FVarLeadTime 变动提前期 string FVarLeadTime FPlanBatchSplitQty 拆分批量 string FPlanBatchSplitQty FProduceBillType_FNumber 生产类型 string FProduceBillType.FNumber FPOBillTypeId_FNumber 采购类型 string FPOBillTypeId.FNumber FSubBillType_FNumber 委外类型 string FSubBillType.FNumber FGROSSWEIGHT 毛重 string FGROSSWEIGHT FNETWEIGHT 净重 string FNETWEIGHT FWEIGHTUNITID_FNumber 重量单位 string FWEIGHTUNITID.FNumber FLENGTH 长 string FLENGTH FWIDTH 宽 string FWIDTH FHEIGHT 高 string FHEIGHT FVOLUME 体积 string FVOLUME FWARRANTY 保修期 string FWARRANTY FSalePrice_CMK 零售价 string FSalePrice_CMK FVIPPrice_CMK 会员价 string FVIPPrice_CMK FPurPrice_CMK 采购单价 string FPurPrice_CMK FComBrandId_CMK_FNumber 品牌-标准 string FComBrandId_CMK.FNumber FRefCost 参考成本 string FRefCost F_sms_Assistant 品牌 string F_sms_Assistant F_sms_Text 69码 string F_sms_Text F_sms_Decimal 基本售价 string F_sms_Decimal Limit 最大行数 string {{PAGINATION_PAGE_SIZE}} StartRow 开始行索引 string {{PAGINATION_START_ROW}} TopRowCount 返回总行数 int FilterString 过滤条件 string FDOCUMENTSTATUS='C' and F_sms_CheckBox1=1 and FMODIFYDATE>={{LAST_SYNC_TIME datetime}} FieldKeys 需查询的字段key集合 array FormId 业务对象表单Id string BD_MATERIAL 响应参数字段字段名称类型配置值 FMasterId id string FNumber 编码 string FName 名称 string FSpecification 规格型号 string FMnemonicCode 助记码 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 F_PBLH_Assistant 品牌 string F_PBLH_Assistant1 商品类别 string FRefCost 参考成本 string F_sms_Assistant 品牌 string F_sms_Text 69码 string F_sms_Decimal 基本售价 string 聚水潭接口明细调用接口： jushuitan.itemsku.upload 接口名称：商品上传（新）方法： POST 请求参数字段字段名称类型配置值 sku_id 商品编码 string {{FNumber}} unit 单位 string {{FBaseUnitId_FName}} shelf_life 保质期 string {{FExpPeriod}} i_id 款式编码 string {{FName}} brand 品牌，可更新 string {{F_ABCD_ASSISTANT}} vc_name 虚拟分类，可更新 string c_name 商品分类，必须是[商品类目管理]中的叶子节点，可更新 string {{FMaterialGroup_Fname}} s_price 基本售价，可更新 string 1 item_type 商品属性，可选值["成品", "半成品", "原材料", "包材"]，可更新 string 成品 l 长，可更新 string w 宽，可更新 string h 高，可更新 string pic 图片地址，可更新 string pic_big 大图地址，可更新 string sku_pic 商品图片，可更新 string name 名称，可更新 string {{FName}} remark 备注，可更新 string properties_value 颜色及规格，可更新 string {{FSpecification}} short_name 简称，可更新 string weight 重量，可更新 string enabled 是否启用，默认值1, 可选值: -1=禁用, 0=备用, 1=启用，可更新 string 1 supplier_name 供应商名称，可更新 string sku_code 国际码，可更新 string {{FBARCODE}} supplier_sku_id 供应商商品编码，可更新 string supplier_i_id 供应商款式编码，可更新 string other_price_1 其它价格1，可更新 string other_price_2 其它价格2，可更新 string other_price_3 其它价格3，可更新 string other_price_4 其它价格4，可更新 string other_price_5 其它价格5，可更新 string other_1 其它属性1，可更新 string other_2 其它属性2，可更新 string other_3 其它属性3，可更新 string other_4 其它属性4，可更新 string other_5 其它属性5，可更新 string stock_disabled 禁止同步，true=禁止，false=允许，可更新 string false cost_price 成本价，可更新 string market_price 市场吊牌价，可更新 string dataKey dataKey string items 响应参数字段字段名称类型配置值 code 错误码，0代表成功 string issuccess true代表成功 string msg 执行描述 string 系统对接概况随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。

金蝶云星空对接打通聚水潭物料查询接口与商品上传（新）接口

小群青V

金蝶云星空对接打通聚水潭物料查询接口与商品上传（新）接口

对接系统：金蝶云星空

金蝶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电商学院”达成深度合作。

数据集成方案配置

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星空的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到聚水潭中。轻易云集成平台的可视化配置轻松实现。

金蝶云星空接口明细

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

请求参数

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

响应参数

字段	字段名称	类型
FMasterId	id	string
FNumber	编码	string
FName	名称	string
FSpecification	规格型号	string
FMnemonicCode	助记码	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
F_PBLH_Assistant	品牌	string
F_PBLH_Assistant1	商品类别	string
FRefCost	参考成本	string
F_sms_Assistant	品牌	string
F_sms_Text	69码	string
F_sms_Decimal	基本售价	string

聚水潭接口明细

调用接口：jushuitan.itemsku.upload
接口名称：商品上传（新）
方法：POST

请求参数

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

响应参数

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

系统对接概况

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