从金蝶云星空到聚水潭通过接口配置打通数据

对接系统:金蝶云星空
金蝶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个城镇,为客户提供及时、周到和专业的服务。
多系统对接方案配置
通过轻易云系统数据集成平台新增创建集成方案,然后在数据源平台中选择对应的源平台为:金蝶云星空,并且选择对应的连接器(关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息)。选择对应的物料查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为聚水潭,并且选择对应连接器。选择对应的商品上传(新)接口作为数据写入动作,既可以完成第一步的数据对接配置;打破跨系统连接,让数据轻易互通成为现实。

金蝶云星空接口明细
- API:executeBillQuery
- NAME:物料查询
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FMasterId | id | FMasterId | |
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 | |
FStockId_FNumber | 仓库 | FStockId.FNumber | |
FPurchaseOrgId_FNumber | 采购组织.编码 | FPurchaseOrgId.FNumber | |
FPurchaseOrgId_FName | 采购组织 | FPurchaseOrgId.FName | |
FIsBatchManage | 启用批号管理 | FIsBatchManage | |
FIsKFPeriod | 启用保质期管理 | FIsKFPeriod | |
FIsSNManage | 启用序列号管理 | FIsSNManage | |
FSafeStock | 安全库存 | FSafeStock | |
FCategoryID | 存货类别 | FCategoryID | |
FExpPeriod | 保质期 | FExpPeriod | |
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 | |
FRefCost | 参考成本 | FRefCost | |
Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | |
StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | |
TopRowCount | 返回总行数 | | |
FilterString | 过滤条件 | FMODIFYDATE>={{LAST_SYNC_TIME datetime}} | |
FieldKeys | 需查询的字段key集合 | | |
FormId | 业务对象表单Id | BD_MATERIAL | |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
FMasterId | id | FMasterId | |
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 | |
FStockId_FNumber | 仓库 | FStockId.FNumber | |
FPurchaseOrgId_FNumber | 采购组织.编码 | FPurchaseOrgId.FNumber | |
FPurchaseOrgId_FName | 采购组织 | FPurchaseOrgId.FName | |
FIsBatchManage | 启用批号管理 | FIsBatchManage | |
FIsKFPeriod | 启用保质期管理 | FIsKFPeriod | |
FIsSNManage | 启用序列号管理 | FIsSNManage | |
FSafeStock | 安全库存 | FSafeStock | |
FCategoryID | 存货类别 | FCategoryID | |
FExpPeriod | 保质期 | FExpPeriod | |
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 | |
FRefCost | 参考成本 | FRefCost | |
聚水潭接口明细
- 调用接口:/open/jushuitan/itemsku/upload
- 接口名称:商品上传(新)
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
sku_id | 商品编码 | string | {{FNumber}} |
unit | 单位 | string | {{FBaseUnitId_FName}} |
i_id | 款式编码 | string | {{FNumber}} |
brand | 品牌,可更新 | string | {{F_sms_Assistant}} |
vc_name | 虚拟分类,可更新 | string | |
c_name | 商品分类,必须是[商品类目管理]中的叶子节点,可更新 | string | |
s_price | 基本售价,可更新 | string | {{F_sms_Decimal}} |
item_type | 商品属性,可选值["成品", "半成品", "原材料", "包材"],可更新 | string | 成品 |
l | 长,可更新 | string | {{FLENGTH}} |
w | 宽,可更新 | string | {{FWIDTH}} |
h | 高,可更新 | string | {{FHEIGHT}} |
pic | 图片地址,可更新 | string | |
pic_big | 大图地址,可更新 | string | |
sku_pic | 商品图片,可更新 | string | |
name | 名称,可更新 | string | {{FName}} |
remark | 备注,可更新 | string | |
properties_value | 颜色及规格,可更新 | string | {{FSpecification}} |
short_name | 简称,可更新 | string | {{FDescription}} |
weight | 重量,可更新 | string | {{FGROSSWEIGHT}} |
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 | |
s_price | 基本售价 | string | {{F_sms_Decimal}} |
dataKey | dataKey | string | items |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
code | 错误码,0代表成功 | string | |
issuccess | true代表成功 | string | |
msg | 执行描述 | string | |
数据对接效果
全面支持数据集成操作可视化、拖拽流式开发,无代码完成多套异构系统集成,降低使用门槛,提升交付速度。特别是在面向金蝶云星空、聚水潭间API接口集成时,通过对API的设计、创建、测试、部署、集成、管理、运维、下线等全生命周期管理,帮助企业洞察运营状况,进一步优化流程,提高企业商业价值。基于Web图形界面,通过拖拽、连接、配置完成流程设计,数据整合和集成,高效打通业务系统,通过面向运营的统计报表,直观查看API各项指标,实现对全局和项目层级双维度的监控管理。再通过轻易云数据集成中台通过统一门户注册管理,将业务以API的方式对外开放,实现业务创新、能力输出。
