从金蝶云星空到微盟通过接口集成数据

数据源平台:金蝶云星空

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

对接目标系统:微盟

微盟为众多商家提供海量应用与产品服务，并面向电商零售、商超生鲜、餐饮、跨境、美业等行业提供数字化升级解决方案。基于近10年商业实践，微盟构建了微盟WOS新商业操作系统，为企业数字化转型打造出一整套去中心化的商业基础设施，通过多端一体化产品服务矩阵，助力商家智慧经营。同时，微盟也为开发者群体提供强大的PaaS平台，通过开放微盟核心产品技术能力，吸引第三方生态伙伴和开发者共同打造云端商业服务生态体系，实现企业服务价值共创共享，从而为商户提供更多应用选择和更好服务。

数据接口配置

通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的物料查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为微盟，并且选择对应连接器。选择对应的添加在售商品v2接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星空接口明细

调用接口：executeBillQuery
接口名称：物料查询
方法：POST

请求参数

字段字段名称类型配置值 FMATERIALID实体主键stringFMATERIALID FNumber编码stringFNumber FName名称stringFName FSpecification规格型号stringFSpecification FOldNumber旧物料编码stringFOldNumber FBARCODE条码stringFBARCODE FDescription描述stringFDescription FMaterialGroup_FNumber物料分组stringFMaterialGroup.FNumber FErpClsID物料属性stringFErpClsID FDocumentStatus数据状态stringFDocumentStatus FForbidStatus禁用状态stringFForbidStatus FBaseUnitId_FNumber基本单位.编码stringFBaseUnitId.FNumber FCreateOrgId_FNumber创建组织stringFCreateOrgId.FNumber FUseOrgId_FNumber使用组织stringFUseOrgId.FNumber FIsInventory允许库存stringFIsInventory FIsSale允许销售stringFIsSale FIsAsset允许资产stringFIsAsset FIsSubContract允许委外stringFIsSubContract FIsProduce允许生产stringFIsProduce FIsPurchase允许采购stringFIsPurchase FStockId_FNumber仓库stringFStockId.FNumber FPurchaseOrgId_FNumber采购组织.编码stringFPurchaseOrgId.FNumber FPurchaseOrgId_FName采购组织stringFPurchaseOrgId.FName FIsBatchManage启用批号管理stringFIsBatchManage FIsKFPeriod启用保质期管理stringFIsKFPeriod FIsSNManage启用序列号管理stringFIsSNManage FSafeStock安全库存stringFSafeStock FCategoryID存货类别stringFCategoryID FExpPeriod保质期stringFExpPeriod FOrderQty起订量stringFOrderQty FMinQty最小批量stringFMinQty FMaxQty最大批量stringFMaxQty FDefaultVendor_FNumber默认供应商stringFDefaultVendor.FNumber FMaxPOQty最大订货量stringFMaxPOQty FMinPOQty最小订货量stringFMinPOQty FIncreaseQty最小包装量stringFIncreaseQty FFixLeadTime固定提前期stringFFixLeadTime FVarLeadTime变动提前期stringFVarLeadTime FPlanBatchSplitQty拆分批量stringFPlanBatchSplitQty FProduceBillType_FNumber生产类型stringFProduceBillType.FNumber FPOBillTypeId_FNumber采购类型stringFPOBillTypeId.FNumber FSubBillType_FNumber委外类型stringFSubBillType.FNumber FGROSSWEIGHT毛重stringFGROSSWEIGHT FNETWEIGHT净重stringFNETWEIGHT FWEIGHTUNITID_FNumber重量单位stringFWEIGHTUNITID.FNumber FLENGTH长stringFLENGTH FWIDTH宽stringFWIDTH FHEIGHT高stringFHEIGHT FVOLUME体积stringFVOLUME FWARRANTY保修期stringFWARRANTY FSalePrice_CMK零售价stringFSalePrice_CMK FVIPPrice_CMK会员价stringFVIPPrice_CMK FPurPrice_CMK采购单价stringFPurPrice_CMK FComBrandId_CMK_FNumber品牌stringFComBrandId_CMK.FNumber F_BCYS_SalePrice销售单价stringF_BCYS_SalePrice Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME dateTime}}' FieldKeys需查询的字段key集合array FormId业务对象表单IdstringBD_MATERIAL

响应参数

字段字段名称类型配置值 FMATERIALID实体主键string FNumber编码string FName名称string FSpecification规格型号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_BCYS_SalePrice销售单价string

微盟接口明细

API：/apigw/weimob_shop/v2.0/goods/create
NAME：添加在售商品v2
METHOD：POST

请求参数

接口字段字段名称预设值描述 basicInfo基础信息1基础信息 basicInfo.vid组织结构节点 ID6001341397926组织结构节点 ID。组织的唯一标识，是创建组织时自动生成的 ID，也可以通过 bos/organization/getList 接口获取该 ID。 basicInfo.categoryId商品类目 ID28商品类目 ID。可以通过 weimob_shop/goods/category/getList接口获取该 ID。 basicInfo.deductStockType商品库存减扣方式1商品库存减扣方式。方式包括：1-下单减扣；2-支付减扣。 basicInfo.defaultImageUrl默认图片https://image-c-dev.weimobwmc.com/qa-saas-wxbiz/fddd8d46142346d38742d95d7ac96159.jpeg|默认图片 basicInfo.goodsImageUrl图片https://image-c-dev.weimobwmc.com/qa-saas-wxbiz/fddd8d46142346d38742d95d7ac96159.jpeg basicInfo.goodsTemplateId商品模板 ID1192643231302商品模板 ID。可以通过 weimob_shop/goods/goodtemplate/getList 接口获取该 ID。 basicInfo.goodsType商品类型1商品类型。类型包括：1-普通商品；2-虚拟商品。 basicInfo.initSales初始销量初始销量 basicInfo.isCanSell商品是否可售false商品是否可售。false-禁售；true-可售。 basicInfo.isMultiSku商品是否多规格false商品是否多规格。 false-单规格；true-多规格。 basicInfo.isOnline商品是否上架false商品是否上架。false-下架；true 上架。 basicInfo.limitSwitch限购开关false限购开关。false-关闭； true-开启。 basicInfo.outerGoodsCode商品编码{{FNumber}}商品编码 basicInfo.performanceWay履约方式1履约方式 basicInfo.performanceWay.deliveryList配送方式配送方式。配送方式与商品类型关联，普通实物商品：只能设置商家配送、同城限时达、到底自提。虚拟商品：只能设置无需物流配送方式。 basicInfo.performanceWay.deliveryList.deliveryId配送方式 ID2992582配送方式 ID。可以通过 weimob_shop/fulfill/goods/fulfilltype/getList 接口获取该 ID。 basicInfo.performanceWay.deliveryList.deliveryNodeShipId配送方式关系节点 ID2903807配送方式关系节点 ID。可以通过 weimob_shop/fulfill/goods/fulfilltype/getList 接口获取该 ID。 basicInfo.performanceWay.deliveryList.deliveryType配送类型1配送类型。类型包括：1-商家配送；2-同城限时达；3-到店自提；4-门店交易；5-无需物流；6-门店自助。 basicInfo.performanceWay.deliveryList.templateId配送模板 ID10000939907配送模板 ID basicInfo.performanceWay.skuList商品规格 SKU 列表商品规格 SKU 列表 basicInfo.performanceWay.skuList.skuStockNumSKU 库存数量{{FOrderQty}}SKU 库存数量 basicInfo.performanceWay.skuList.outerSkuCode商家编码{{FNumber}}商家编码 basicInfo.performanceWay.skuList.salePrice销售价{{F_BCYS_SalePrice}}销售价 basicInfo.performanceWay.skuList.subGoodsType商品子类型101商品子类型。类型包括：101-普通商品；102-海淘商品；103-无需物流实物商品；201-普通虚拟商品；202-付费卷虚拟商品。 basicInfo.performanceWay.skuList.title商品名称{{FName}}商品名称 basicInfo.performanceWay.skuList.wid商户 ID4001049478926商户 ID basicInfo.performanceWay.skuList.unifiedCyclePurchaseInfoList周期购信息 basicInfo.performanceWay.skuList.unifiedCyclePurchaseInfoList.cycleStockNum可售库存{{FOrderQty}}

响应参数

接口字段字段名称预设值描述 primaryWriteback主键回写 primaryWriteback.skuIdskuId{{data.skuList.0.skuId}} primaryWriteback.goodsId商品id{{data.goodsId}} primaryWriteback.outerSkuCodeouterSkuCode{{data.skuList.0.outerSkuCode}}

系统数据集成价值

全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。

从金蝶云星空到微盟通过接口集成数据