金蝶云星空与聚水潭对接集成物料查询连通商品上传（新）(物料对接聚水潭) 数据源平台:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。对接目标平台:聚水潭聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。数据集成方案配置系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星空的接口参数设置，以及设定好目标平台：聚水潭的映射，即可启动方案进行测试金蝶云星空接口明细调用接口： executeBillQuery 接口名称：物料查询方法： POST 请求参数字段字段名称类型配置值 FMATERIALID 实体主键 string FMATERIALID FNumber 编码 string FNumber FName 名称 string FName FSpecification 规格型号 string FSpecification 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 Limit 最大行数 string {{PAGINATION_PAGE_SIZE}} StartRow 开始行索引 string {{PAGINATION_START_ROW}} TopRowCount 返回总行数 int FilterString 过滤条件 string FApproveDate>='{{LAST_SYNC_TIME dateTime}}' FUseOrgId.FNumber='101' FieldKeys 需查询的字段key集合 array FormId 业务对象表单Id string BD_MATERIAL 响应参数字段字段名称类型配置值 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 聚水潭接口明细调用接口： jushuitan.itemsku.upload 接口名称：商品上传（新）方法： POST 请求参数字段字段名称类型配置值 sku_id 商品编码 string {{FNumber}} unit 单位 string {{FBaseUnitId_FName}} shelf_life 保质期 int function case when '{{FExpPeriod}}'>0 then '1095' else '' end i_id 款式编码 string {{FNumber}} brand 品牌，可更新 string {{F_ABCD_ASSISTANT}} vc_name 虚拟分类，可更新 string c_name 商品分类，必须是[商品类目管理]中的叶子节点，可更新 string {{FMaterialGroup_Fname}} s_price 基本售价，可更新 float 1 item_type 商品属性，可选值["成品", "半成品", "原材料", "包材"]，可更新 string 成品 l 长，可更新 float w 宽，可更新 float h 高，可更新 float pic 图片地址，可更新 string pic_big 大图地址，可更新 string sku_pic 商品图片，可更新 string name 名称，可更新 string {{FName}} remark 备注，可更新 string properties_value 颜色及规格，可更新 string {{FSpecification}} short_name 简称，可更新 string weight 重量，可更新 float enabled 是否启用，默认值1, 可选值: -1=禁用, 0=备用, 1=启用，可更新 int 1 supplier_name 供应商名称，可更新 string supplier_sku_id 供应商商品编码，可更新 string supplier_i_id 供应商款式编码，可更新 string other_price_1 其它价格1，可更新 float other_price_2 其它价格2，可更新 float other_price_3 其它价格3，可更新 float other_price_4 其它价格4，可更新 float other_price_5 其它价格5，可更新 float other_1 其它属性1，可更新 string other_2 其它属性2，可更新 string other_3 其它属性3，可更新 string other_4 其它属性4，可更新 string other_5 其它属性5，可更新 string stock_disabled 禁止同步，true=禁止，false=允许，可更新 bool false cost_price 成本价，可更新 float market_price 市场吊牌价，可更新 float batch_enabled 是否启用生产批次 bool _function case when '{{FIsBatchManage}}'=' ' then false else false end dataKey dataKey string items 响应参数字段字段名称类型配置值 code 错误码，0代表成功 string issuccess true代表成功 string msg 执行描述 string 系统对接概况从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

金蝶云星空与聚水潭对接集成物料查询连通商品上传（新）(物料对接聚水潭)

关一帆qeasy

金蝶云星空与聚水潭对接集成物料查询连通商品上传（新）(物料对接聚水潭)

数据源平台:金蝶云星空

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

对接目标平台:聚水潭

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

数据集成方案配置

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星空的接口参数设置，以及设定好目标平台：聚水潭的映射，即可启动方案进行测试

金蝶云星空接口明细

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

请求参数

字段	字段名称	类型	配置值
FMATERIALID	实体主键	string	FMATERIALID
FNumber	编码	string	FNumber
FName	名称	string	FName
FSpecification	规格型号	string	FSpecification
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
Limit	最大行数	string	{{PAGINATION_PAGE_SIZE}}
StartRow	开始行索引	string	{{PAGINATION_START_ROW}}
TopRowCount	返回总行数	int
FilterString	过滤条件	string	FApproveDate>='{{LAST_SYNC_TIME dateTime}}' FUseOrgId.FNumber='101'
FieldKeys	需查询的字段key集合	array
FormId	业务对象表单Id	string	BD_MATERIAL

响应参数

字段	字段名称	类型
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

聚水潭接口明细

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

请求参数

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

响应参数

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

系统对接概况

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。