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

数据源系统:金蝶云星空

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

接通系统：聚水潭

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

接口方案配置

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

金蝶云星空接口明细

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

请求参数

接口字段	字段名称	预设值	描述
FMasterId	id	FMasterId
FExpPeriod	保质期	FExpPeriod
F_ABCD_ASSISTANT	品牌-自定义	F_ABCD_ASSISTANT.FDATAVALUE
FNumber	编码	FNumber
FName	名称	FName
FSpecification	规格型号	FSpecification
FMnemonicCode	助记码	FMnemonicCode
FOldNumber	旧物料编码	FOldNumber
FBARCODE	条码	FBARCODE
FDescription	描述	FDescription
FMaterialGroup_FNumber	物料分组	FMaterialGroup.FNumber
FMaterialGroup_Fname	物料分组名称	FMaterialGroup.Fname
FErpClsID	物料属性	FErpClsID
FDocumentStatus	数据状态	FDocumentStatus
FForbidStatus	禁用状态	FForbidStatus
FBaseUnitId_FNumber	基本单位.编码	FBaseUnitId.FNumber
FBaseUnitId_FName	基本单位.名称	FBaseUnitId.FName
FCreateOrgId_FNumber	创建组织	FCreateOrgId.FNumber
FUseOrgId_FNumber	使用组织	FUseOrgId.FNumber
FIsInventory	允许库存	FIsInventory
FIsSale	允许销售	FIsSale
FIsAsset	允许资产	FIsAsset
FIsSubContract	允许委外	FIsSubContract
FIsProduce	允许生产	FIsProduce
FIsPurchase	允许采购	FIsPurchase
FTAXRATEID_FNumber	默认税率	FTAXRATEID.FNumber
FStockId_FNumber	仓库	FStockId.FNumber
FPurchaseOrgId_FNumber	采购组织.编码	FPurchaseOrgId.FNumber
FPurchaseOrgId_FName	采购组织	FPurchaseOrgId.FName
FIsBatchManage	启用批号管理	FIsBatchManage
FIsKFPeriod	启用保质期管理	FIsKFPeriod
FIsSNManage	启用序列号管理	FIsSNManage
FSafeStock	安全库存	FSafeStock
FCategoryID	存货类别	FCategoryID
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	过滤条件	FDOCUMENTSTATUS='C' and FUseOrgId.fnumber='102' and FIsSalseByNet=1 and FMODIFYDATE>={{LAST_SYNC_TIME datetime}}
FieldKeys	需查询的字段key集合
FormId	业务对象表单Id	BD_MATERIAL

响应参数

接口字段	字段名称	预设值	描述
FMasterId	id
FExpPeriod	保质期
F_ABCD_ASSISTANT	品牌-自定义
FNumber	编码
FName	名称
FSpecification	规格型号
FMnemonicCode	助记码
FOldNumber	旧物料编码
FBARCODE	条码
FDescription	描述
FMaterialGroup_FNumber	物料分组
FMaterialGroup_Fname	物料分组名称
FErpClsID	物料属性
FDocumentStatus	数据状态
FForbidStatus	禁用状态
FBaseUnitId_FNumber	基本单位.编码
FBaseUnitId_FName	基本单位.名称
FCreateOrgId_FNumber	创建组织	101
FUseOrgId_FNumber	使用组织	101
FIsInventory	允许库存
FIsSale	允许销售
FIsAsset	允许资产
FIsSubContract	允许委外
FIsProduce	允许生产
FIsPurchase	允许采购
FTAXRATEID_FNumber	默认税率
FStockId_FNumber	仓库
FPurchaseOrgId_FNumber	采购组织.编码
FPurchaseOrgId_FName	采购组织
FIsBatchManage	启用批号管理
FIsKFPeriod	启用保质期管理
FIsSNManage	启用序列号管理
FSafeStock	安全库存
FCategoryID	存货类别
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	品牌

聚水潭接口明细

• 调用接口：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

系统对接总览

异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。 资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。