金蝶云星空和巨益OMS接口打通对接实战

接入系统：金蝶云星空

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

对接目标平台:巨益OMS

深圳市巨益科技开发有限公司(巨益科技)2013年成立于深圳，专注为中大型零售品牌企业提供全渠道电商中台服务，经过7年多时间的业务沉淀，已助力超过1000+年销售额过亿的行业TOP品牌实现数字化转型，服务口碑获得了客户的一致好评。截至目前，巨益科技服务客户类目涉及服装配饰、数码家电、化妆品、眼镜珠宝、食品保健、母婴用品等十三大行业，并凭借行业领先的中台服务案例先后荣获阿里、京东等平台颁发的“年度十佳服务商”、“京卓越金奖”、“订单压测TOP1”等荣誉奖项。

接口方案配置

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：物料查询，目标系统：巨益OMS，目标系统 API非组合商品单个同步。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

金蝶云星空接口明细

调用接口：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_FML_Assistant1品牌代码stringF_FML_Assistant1 F_FML_Assistant存货品类stringF_FML_Assistant F_FML_Text7物料条码1stringF_FML_Text7 F_FML_TEXT1F_FML_TEXT1stringF_FML_TEXT1 FModifyDate修改时间stringFModifyDate FStockPlaceIdFStockPlaceIdstringFStockPlaceId Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FISSALESBYNET=1 and FUseOrgId.fnumber = '100' 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_FML_Assistant1品牌代码string F_FML_Assistant存货品类string F_FML_Text7物料条码1string F_FML_TEXT1F_FML_TEXT1string FModifyDate修改时间string FStockPlaceIdFStockPlaceIdstring

巨益OMS接口明细

API：singleitem.synchronize
NAME：非组合商品单个同步
METHOD：POST

请求参数

接口字段字段名称预设值描述 actionType操作类型add操作类型(两种类型：add update),示例值(add) item商品信息商品信息 item.actualAmount实际支付金额实际支付金额,示例值(123) item.actualQty实际数量实际数量,示例值(234) item.adventLifecycle保质期临期预警天数保质期临期预警天数,示例值(1) item.amount金额金额,示例值(123) item.approvalNumber批准文号批准文号,示例值(PB123) item.barCode条形码{{F_FML_Text7}}条形码,示例值(T1) item.batchCode批次代码{{FIsBatchManage}}批次代码,示例值(P1234) item.batchRemark批次备注批次备注,示例值(备注信息) item.brandCode品牌代码{{F_FML_Assistant1}}品牌代码,示例值(LAL) item.brandName品牌名称品牌名称,示例值(HM) item.categoryId商品类别ID商品类别ID,示例值(LB123) item.categoryName商品类别名称{{FMaterialGroup_FNumber}}商品类别名称,示例值(手机) item.changeTime更改时间更改时间,示例值(temp) item.channelCodechannel编码channel编码,示例值(temp) item.color颜色,示例值(红色)颜色,示例值(红色) item.companyCode公司编码公司编码,示例值(JE) item.costPrice成本价成本价,示例值(12) item.createTime创建时间创建时间(YYYY-MM-DD HH:MM:SS),示例值(2017-09-09 12:00:00) item.defectiveQty残次数量残次数量,示例值(12) item.diffQuantity变化数量变化数量,示例值(12) item.discount折扣折扣,示例值(9.8) item.discountPrice折扣价折扣价,示例值(9.8) item.englishName英文名英文名,示例值(EN123) item.expireDate过期日期过期日期(YYYY-MM-DD),示例值(2016-09-09) item.goodsCode商品编码{{FNumber}}商品编码,示例值(H1234) item.grossWeight毛重(单位：千克){{FGROSSWEIGHT}}毛重(单位：千克),示例值(12) item.height高(单位：厘米){{FHEIGHT}}高(单位：厘米),示例值(12) item.isBatchMgmt是否需要批次管理Y是否需要批次管理,示例值(N) item.isFragile是否易碎品是否易碎品,可用值:Y,N,示例值(N) item.isGift是否赠品是否赠品,示例值(传 Y/N （是/否）) item.isHazardous是否危险品是否危险品,可用值:Y,N,示例值(N) item.isOmnichannel是否全渠道商品是否全渠道商品,示例值(传 Y/N （是/否）) item.isPcs是否启用箱规N是否启用箱规,可用值:Y,N,示例值(Y) item.isSNMgmt是否需要串号管理是否需要串号管理,可用值:Y,N,示例值(N) item.isShelfLifeMgmt是否需要保质期管理Y是否需要保质期管理,可用值:Y,N,示例值(N) item.isSku是否sku是否sku,可用值:Y,N,示例值(N) item.isValid是否有效是否有效,可用值:Y,N,示例值(N) item.itemCodesku对应编码{{FNumber}}sku对应编码,示例值(I1234) item.itemId仓储系统商品编码仓储系统商品编码(该字段是WMS分配的商品编号;WMS如果分配了商品编码;则后续的商品操作都需要传该字段;如果WMS不使用 ;WMS可以返回itemId=itemCode的值),示例值(WI1234) item.itemName商品名称{{FName}}商品名称,示例值(SN123) item.itemType商品类型ZC商品类型(ZC=正常商品;FX=分销商品;ZH=组合商品;ZP=赠品;BC=包材;HC=耗材;FL=辅料;XN=虚拟品;FS=附属品;CC=残次品;OTHER=其它;只传英文编码),示例值(ZC) item.latestUpdateTime最后更新时间{{FModifyDate_new}}最后更新时间,示例值(temp) item.length长{{FLENGTH}}长(单位：厘米),示例值(12) item.lockupLifecycle保质期禁售天数保质期禁售天数,示例值(1) item.lowestPrice最低价最低价,示例值(1.02) item.netWeight净重净重(单位：千克),示例值(12) item.originAddress商品的原产地商品的原产地,示例值(HK) item.originCode原产地编码原产地编码,示例值(temp) item.outBizCodeoutBizCodeoutBizCode,示例值(temp) item.outerCode外部编码外部编码,示例值(12345) item.ownerCode货主编码货主编码,示例值(temp) item.packCode包装代码包装代码,示例值(B12) item.packageMaterial商品包装材料类型商品包装材料类型,示例值(BX123) item.paperQtypaperQtypaperQty,示例值(temp) item.pcs箱规,示例值(1){{F_FML_TEXT1}}箱规,示例值(1) item.price价格价格,示例值(temp) item.pricingCategory计价货类计价货类,示例值(手机类) item.produceCode生产编码生产编码,示例值(temp) item.productCodeproductCode{{FNumber}}productCode,示例值(LA01081) item.productDate生产日期生产日期(YYYY-MM-DD),示例值(2016-09-09) item.productSign商品标记商品标记 item.purchasePrice采购价采购价,示例值(12) item.quantityquantityquantity,示例值(12) item.reasonreasonreason,示例值(temp) item.receiveQtyreceiveQtyreceiveQty,示例值(temp) item.referencePricereferencePricereferencePrice,示例值(temp) item.rejectLifecycle保质期禁收天数保质期禁收天数,示例值(1) item.remark备注备注,示例值(备注信息) item.retailPrice零售价零售价,当itemType=FX时,该价格为分销价,示例值(12) item.seasonCode季节编码季节编码,示例值(CHUN) item.seasonName季节名称季节名称,示例值(春季) item.shelfLife保质期{{FExpPeriod}}保质期(单位：小时),示例值(1) item.shortName商品简称商品简称,示例值(JC123) item.size尺寸尺寸,示例值(5英尺) item.skcSKCSKC,示例值(SKC) item.skuProperty商品属性XXL商品属性(如红色;XXL),示例值(红色) item.snsn,示例值(temp)sn,示例值(temp) item.snCodesnCodesnCode,示例值(temp) item.sourceOrderCodesourceOrderCodesourceOrderCode,示例值(temp) item.standardPricestandardPricestandardPrice,示例值(temp) item.stockStatusstockStatusstockStatus,示例值(temp) item.stockUnit商品计量单位{{FBaseUnitId_FNumber}}商品计量单位,示例值(个) item.subSourceOrderCodesubSourceOrderCodesubSourceOrderCode,示例值(temp) item.supplierCodesupplierCodesupplierCode,示例值(temp) item.supplierNamesupplierNamesupplierName,示例值(temp) item.tagPrice吊牌价吊牌价,示例值(12) item.tareWeighttareWeighttareWeight,示例值(temp) item.tempRequirementtempRequirementtempRequirement,示例值(temp) item.title渠道中的商品标题渠道中的商品标题,示例值(淘公仔) item.unit明细单位明细单位,示例值(个) item.updateTime更新时间(YYYY-MM-DD HH:MM:SS)更新时间(YYYY-MM-DD HH:MM:SS),示例值(2017-09-09 12:00:00) item.volume体积(单位：升){{FVOLUME}}体积(单位：升),示例值(12) item.warehouseCodewarehouseCodewarehouseCode,示例值(temp) item.width宽(单位：厘米){{FWIDTH}}宽(单位：厘米),示例值(12) item.yearyearyear,示例值(2021) item.ownerCode货主编码{{FUseOrgId_FNumber}}货主编码,示例值(HZ123) item.supplierCode供应商编码供应商编码,示例值(GY123) item.supplierName供应商名称供应商名称,示例值(淘宝) item.warehouseCode仓库编码OTHER仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER),示例值(CK1234)

系统数据集成价值

通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。

金蝶云星空和巨益OMS接口打通对接实战