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

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

数据源平台:金蝶云星空

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

集成系统:聚水潭

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

配置集成方案

使用系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的物料查询作为数据对接来源。然后再通过写入目标平台配置目标系统为聚水潭,并且选择对应连接器（关于聚水潭的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的商品上传（新）接口作为数据写入动作，既可以完成第一步的数据对接配置。

金蝶云星空接口明细

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

请求参数

接口字段字段名称预设值描述 FMasterIdidFMasterId F_XC_DECIMAL批发价F_XC_DECIMAL F_XC_ASSISTANT品牌-自定义F_XC_ASSISTANT.FDATAVALUE FNumber编码FNumber FName名称FName FSpecification规格型号FSpecification FMnemonicCode助记码FMnemonicCode F_XC_TEXT批准文号F_XC_TEXT FBARCODE条码FBARCODE FDescription描述FDescription FMaterialGroup_FNumber物料分组FMaterialGroup.FNumber FMaterialGroup_Fname物料分组名称FMaterialGroup.Fname F_XC_WLSCCJ生产厂家F_XC_WLSCCJ 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 FEXPUNIT保质期单位FEXPUNIT FExpPeriod保质期FExpPeriod F_XC_Integer保质期（天数）F_XC_Integer Limit最大行数{{PAGINATION_PAGE_SIZE}} StartRow开始行索引{{PAGINATION_START_ROW}} TopRowCount返回总行数 FilterString过滤条件FUseOrgId.fnumber='100' and F_XC_CHECKBOX =1 and FAPPROVEDATE>='{{LAST_SYNC_TIME datetime}}' FieldKeys需查询的字段key集合 FormId业务对象表单IdBD_MATERIAL

响应参数

接口字段字段名称预设值描述 FMasterIdid F_XC_DECIMAL批发价 F_XC_ASSISTANT品牌-自定义 FNumber编码 FName名称 FSpecification规格型号 FMnemonicCode助记码 F_XC_TEXT批准文号 FBARCODE条码 FDescription描述 FMaterialGroup_FNumber物料分组 FMaterialGroup_Fname物料分组名称 F_XC_WLSCCJ生产厂家 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会员价 FEXPUNIT保质期单位 FExpPeriod保质期 F_XC_Integer保质期（天数）

聚水潭接口明细

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

请求参数

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

响应参数

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

系统对接总览

全面支持数据集成操作可视化、拖拽流式开发，无代码完成多套异构系统集成，降低使用门槛，提升交付速度。特别是在面向金蝶云星空、聚水潭间API接口集成时，通过对API的设计、创建、测试、部署、集成、管理、运维、下线等全生命周期管理，帮助企业洞察运营状况，进一步优化流程，提高企业商业价值。基于Web图形界面，通过拖拽、连接、配置完成流程设计，数据整合和集成，高效打通业务系统，通过面向运营的统计报表，直观查看API各项指标，实现对全局和项目层级双维度的监控管理。再通过轻易云数据集成中台通过统一门户注册管理，将业务以API的方式对外开放，实现业务创新、能力输出。