金蝶云星空和巨益OMS接口打通对接实战|轻易云数据集成平台

金蝶云星空和巨益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	实体主键	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	物料条码1	string
F_FML_TEXT1	F_FML_TEXT1	string
FModifyDate	修改时间	string
FStockPlaceId	FStockPlaceId	string
Limit	最大行数	string	金蝶的查询分页参数
StartRow	开始行索引	string	金蝶的查询分页参数
TopRowCount	返回总行数	int	金蝶的查询分页参数
FilterString	过滤条件	string	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys	需查询的字段key集合	array	金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder

响应参数

字段	名称	类型	描述
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	物料条码1	string
F_FML_TEXT1	F_FML_TEXT1	string
FModifyDate	修改时间	string
FStockPlaceId	FStockPlaceId	string

巨益OMS接口明细

接口：singleitem.synchronize
接口名称：非组合商品单个同步
接口方法：POST

请求参数

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

系统对接总览

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