金蝶云星空和管易云接口打通对接实战

对接源平台:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
对接目标系统:管易云
管易云是金蝶旗下专注提供电商企业管理软件服务的子品牌,先后开发了C-ERP、EC-OMS、EC-WMS、E店管家、BBC、B2B、B2C商城网站建设等产品和服务,涵盖电商业务全流程。
数据对接方案
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区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 |
| FErpClsID | 物料属性 | string | FErpClsID |
| FDocumentStatus | 数据状态 | string | FDocumentStatus |
| FIsSalseByNet | 是否网销 | string | FIsSalseByNet |
| FForbidStatus | 禁用状态 | string | FForbidStatus |
| FBaseUnitId_FNumber | 基本单位.编码 | string | FBaseUnitId.FNumber |
| 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 | 默认供应商 | 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 | 品牌 | string | FComBrandId_CMK.FNUMBER |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FUseOrgId.FNumber='100' and FApproveDate >='{{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 |
| FErpClsID | 物料属性 | string | FErpClsID |
| FDocumentStatus | 数据状态 | string | FDocumentStatus |
| FIsSalseByNet | 是否网销 | string | FIsSalseByNet |
| FForbidStatus | 禁用状态 | string | FForbidStatus |
| FBaseUnitId_FNumber | 基本单位.编码 | string | FBaseUnitId.FNumber |
| 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 | 默认供应商 | string | FDefaultVendor |
| 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 | 品牌 | string | FComBrandId_CMK |
管易云接口明细
- 调用接口:gy.erp.item.add
- 接口名称:商品新增
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| code | 商品代码 | string | {{FNumber}} |
| name | 商品名称 | string | {{FName}} |
| item_brand_id | 商品品牌id | string | |
| item_brand_code | 商品品牌代码 | string | {{FComBrandId_CMK }} |
| simple_name | 商品简称 | string | {{FName}} |
| category_code | 商品分类code | string | |
| supplier_code | 供应商code | string | {{FDefaultVendor}} |
| note | 备注 | string | |
| minusStock | 是否启用负库存 | string | |
| item_add_attribute | 商品附加属性 | string | |
| pic_url | 图片url | string | |
| tax_code | 税收分类编码 | string | |
| tax_no | 商品税号 | string | |
| tax_rate | 商品税率 | string | |
| unit_code | 商品单位code | string | {{FBaseUnitId_FNumber}} |
| supplier_outer_id | 供应商货号 | string | |
| weight | 商品重量 | string | {{FNETWEIGHT}} |
| length | 长 | string | {{FLENGTH}} |
| width | 宽 | string | {{FWIDTH}} |
| height | 高 | string | {{FHEIGHT}} |
| volume | 商品体积 | string | |
| package_point | 打包积分 | string | |
| sales_point | 销售积分 | string | |
| sales_price | 标准售价 | string | |
| purchase_price | 标准进价 | string | |
| cost_price | 成本价 | string | |
| agent_price | 代理售价 | string | |
| stock_status_code | 库存状态code | string | |
| skus | skus | array | |
| skus.sku_code | 规格代码 | string | {{FNumber}} |
| skus.sku_name | 规格名称 | string | {{FName}} |
| skus.sku_weight | 规格重量 | string | |
| skus.sku_purchase_price | 规格标准进价 | string | |
| skus.sku_sales_price | 规格标准售价 | string | |
| skus.sku_agent_price | 规格代理售价 | string | |
| skus.sku_cost_price | 规格成本价 | string | |
| skus.sku_package_point | 规格打包积分 | string | |
| skus.sku_sales_point | 规格销售积分 | string | |
| skus.sku_note | 规格备注 | string | |
系统对接概况
全面支持数据集成操作可视化、拖拽流式开发,无代码完成多套异构系统集成,降低使用门槛,提升交付速度。特别是在面向金蝶云星空、管易云间API接口集成时,通过对API的设计、创建、测试、部署、集成、管理、运维、下线等全生命周期管理,帮助企业洞察运营状况,进一步优化流程,提高企业商业价值。基于Web图形界面,通过拖拽、连接、配置完成流程设计,数据整合和集成,高效打通业务系统,通过面向运营的统计报表,直观查看API各项指标,实现对全局和项目层级双维度的监控管理。再通过轻易云数据集成中台通过统一门户注册管理,将业务以API的方式对外开放,实现业务创新、能力输出。
