从金蝶云星空到聚水潭通过接口配置打通数据
对接系统金蝶云星空
金蝶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电商学院”达成深度合作。
系统对接接口配置
集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：物料查询，目标系统：聚水潭，目标系统 API商品上传（新）。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
金蝶云星空接口明细
- 调用接口：executeBillQuery
- 接口名称：物料查询
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FMasterId | id | string | FMasterId |
| FNumber | 编码 | string | FNumber |
| FName | 名称 | string | FName |
| FSpecification | 规格型号 | string | FSpecification |
| FMnemonicCode | 助记码 | string | FMnemonicCode |
| FOldNumber | 旧物料编码 | string | FOldNumber |
| FBARCODE | 条码 | string | FBARCODE |
| FDescription | 描述 | string | FDescription |
| FMaterialGroup_FNumber | 物料分组 | string | FMaterialGroup.FNumber |
| FMaterialGroup_Fname | 物料分组名称 | string | FMaterialGroup.Fname |
| FErpClsID | 物料属性 | string | FErpClsID |
| FDocumentStatus | 数据状态 | string | FDocumentStatus |
| FForbidStatus | 禁用状态 | string | FForbidStatus |
| FBaseUnitId_FNumber | 基本单位.编码 | string | FBaseUnitId.FNumber |
| FBaseUnitId_FName | 基本单位.名称 | string | FBaseUnitId.FName |
| 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 |
| FRefCost | 参考成本 | string | FRefCost |
| F_sms_Assistant | 品牌 | string | F_sms_Assistant.Fdatavalue |
| F_sms_Text | 69码 | string | F_sms_Text |
| F_sms_Decimal | 基本售价 | string | F_sms_Decimal |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FDOCUMENTSTATUS='C' and F_sms_CheckBox1=1 and FMODIFYDATE>={{LAST_SYNC_TIME datetime}} |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | BD_MATERIAL |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FMasterId | id | string | FMasterId |
| FNumber | 编码 | string | FNumber |
| FName | 名称 | string | FName |
| FSpecification | 规格型号 | string | FSpecification |
| FMnemonicCode | 助记码 | string | FMnemonicCode |
| FOldNumber | 旧物料编码 | string | FOldNumber |
| FBARCODE | 条码 | string | FBARCODE |
| FDescription | 描述 | string | FDescription |
| FMaterialGroup_FNumber | 物料分组 | string | FMaterialGroup.FNumber |
| FMaterialGroup_Fname | 物料分组名称 | string | FMaterialGroup.Fname |
| FErpClsID | 物料属性 | string | FErpClsID |
| FDocumentStatus | 数据状态 | string | FDocumentStatus |
| FForbidStatus | 禁用状态 | string | FForbidStatus |
| FBaseUnitId_FNumber | 基本单位.编码 | string | FBaseUnitId.FNumber |
| FBaseUnitId_FName | 基本单位.名称 | string | FBaseUnitId.FName |
| 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 |
| FRefCost | 参考成本 | string | FRefCost |
| F_sms_Assistant | 品牌 | string | F_sms_Assistant.Fdatavalue |
| F_sms_Text | 69码 | string | F_sms_Text |
| F_sms_Decimal | 基本售价 | string | F_sms_Decimal |
聚水潭接口明细
- 接口：/open/jushuitan/itemsku/upload
- 接口名称：商品上传（新）
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| sku_id | 商品编码 | string | 商品编码 |
| unit | 单位 | 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 | 市场 吊牌价，可更新 |
| s_price | 基本售价 | string | |
| dataKey | dataKey | string | |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| code | 错误码，0代表成功 | string | 错误码，0代表成功 |
| issuccess | true代表成功 | string | true代表成功 |
| msg | 执行描述 | string | 执行描述 |
系统对接总览
随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。
