金蝶云星空对接打通聚水潭物料查询接口与商品上传(新)接口
对接源平台:金蝶云星空
金蝶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 | |
| 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 | |
| FRefCost | 参考成本 | string | |
| F_sms_Assistant | 品牌 | string | |
| F_sms_Text | 69码 | string | |
| F_sms_Decimal | 基本售价 | string | |
| Limit | 最大行数 | string | |
| StartRow | 开始行索引 | string | |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | |
响应参数
| 字段 | 名称 | 类型 | 描述 |
| 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 | 商品编码 |
| 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 | 图片地址,可更新 | string | 图片地址,可更新 |
| pic_big | 大图地址,可更新 | string | 大图地址,可更新 |
| sku_pic | 商品图片,可更新 | 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 | 市场 吊牌价,可更新 |
| dataKey | dataKey | string | |
响应参数
| 字段 | 名称 | 类型 | 描述 |
| code | 错误码,0代表成功 | string | 错误码,0代表成功 |
| issuccess | true代表成功 | string | true代表成功 |
| msg | 执行描述 | string | 执行描述 |
系统对接总览
随着企业数字化业务的深入发展,对于企业的 IT 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。
系统数据对接方案元数据代码