奇门WMS-A和金蝶云星空单据接口对接|轻易云数据集成平台

奇门WMS-A和金蝶云星空单据接口对接

对接系统：金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

对接目标平台:奇门WMS-A

奇门WMS是针对菜鸟WMS、天猫国际保税仓、其它WMS系统（如：百世云仓、巨沃WMS、递四方、中仓仓储等第三方仓储WMS系统），进行对接与管理的模块。奇门WMS包含：基本信息配置、商品同步、商品对照、商品区域销售设置、渠道库存管理、库存同步设置、手动同步库存、仓库对照、供应商对照、采购订单、采购退货出库单、发货单列表、退货单列表、调拨单列表、仓内加工单、其他出库单、其他入库单、B2B出库单、接口日志查询、前后端商品映射关系同步

系统对接接口配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为奇门WMS-A，并且选择对应连接器（关于奇门WMS-A的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的taobao.qimen.singleitem.synchronize接口作为数据写入动作完成第一步的接口配置。

金蝶云星空接口明细

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

请求参数

字段	名称	类型	描述
FMasterId	id	string
FNumber	编码	string
FName	名称	string
FSpecification	规格型号	string
FMnemonicCode	助记码	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
F_ora_Text	香型	string
F_ora_Text1	执行标准	string
F_ora_Text2	生产企业	string
F_ora_Text3	箱规	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
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

响应参数

字段	名称	类型	描述
FMasterId	id	string
FNumber	编码	string
FName	名称	string
FSpecification	规格型号	string
FMnemonicCode	助记码	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
F_ora_Text	香型	string
F_ora_Text1	执行标准	string
F_ora_Text2	生产企业	string
F_ora_Text3	箱规	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

奇门WMS-A接口明细

接口：singleitem.synchronize
接口名称：商品同步接口
接口方法：POST

请求参数

字段	名称	类型	描述
actionType	操作类型	string	两种类型：add update
warehouseCode	仓库编码	string	统仓统配等无需ERP指定仓储编码的情况填OTHER
ownerCode	货主编码	string
supplierCode	供应商编码	string	该字段是WMS分配的商品编号;WMS如果分配了商品编码;则后续的商品操作都需要传该字段;如果WMS不使用;WMS可以返回itemId=itemCode的值
supplierName	供应商名称	string
item	商品信息	array
item.itemCode	商品编码	string
item.itemId	仓储系统商品编码	string
item.goodsCode	货号	string
item.itemName	商品名称	string
item.shortName	商品简称	string
item.englishName	英文名	string
item.barCode	条形码	string	可多个;用分号;隔开
item.skuProperty	商品属性	string	如红色;XXL
item.stockUnit	商品计量单位	string
item.length	长	string	单位：厘米
item.width	宽	string	单位：厘米
item.height	高	string	单位：厘米
item.volume	体积	string	单位：升
item.grossWeight	毛重	string	单位：千克
item.netWeight	净重	string	单位：千克
item.color	颜色	string
item.size	尺寸	string
item.title	渠道中的商品标题	string
item.categoryId	商品类别ID	string
item.categoryName	商品类别名称	string
item.pricingCategory	计价货类	string
item.safetyStock	安全库存	string
item.itemType	商品类型	string	ZC=正常商品;FX=分销商品;ZH=组合商品;ZP=赠品;BC=包材;HC=耗材;FL=辅料;XN=虚拟品;FS=附属品;CC=残次品; OTHER=其它;只传英文编码
item.tagPrice	吊牌价	string
item.retailPrice	零售价	string
item.costPrice	成本价	string
item.purchasePrice	采购价	string
item.seasonCode	季节编码	string
item.seasonName	季节名称	string
item.brandCode	品牌代码	string
item.brandName	品牌名称	string
item.isSNMgmt	是否需要串号管理	string	Y/N ;默认为N
item.productDate	生产日期	string	YYYY-MM-DD
item.expireDate	过期日期	string	YYYY-MM-DD
item.isShelfLifeMgmt	是否需要保质期管理	string	Y/N ;默认为N
item.shelfLife	保质期	string	单位：小时
item.rejectLifecycle	保质期禁收天数	string
item.lockupLifecycle	保质期禁售天数	string
item.adventLifecycle	保质期临期预警天数	string
item.isBatchMgmt	是否需要批次管理	string	Y/N ;默认为N
item.batchCode	批次代码	string
item.batchRemark	批次备注	string
item.packCode	包装代码	string
item.pcs	箱规	string
item.originAddress	商品的原产地	string
item.approvalNumber	批准文号	string
item.isFragile	是否易碎品	string	Y/N ;默认为N
item.isHazardous	是否危险品	string	Y/N ;默认为N
item.remark	备注	string
item.createTime	创建时间	string	YYYY-MM-DD HH:MM:SS
item.updateTime	更新时间	string	YYYY-MM-DD HH:MM:SS
item.isValid	是否有效	string	Y/N ;默认为N
item.isSku	是否sku	string	Y/N ;默认为N
item.packageMaterial	商品包装材料类型	string
item.supplierCode	temp	string
item.logisticsType	销售配送方式	string	0=自配 1=菜鸟
item.isLiquid	是否液体	string	Y/N, 默认为N
item.extendProps	扩展属性	string

数据对接效果

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到奇门WMS-A之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。