金蝶云星空对接打通奇门WMS-A物料查询接口与商品同步接口接口

对接源平台:金蝶云星空

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

目标系统:奇门WMS-A

淘系的相关仓储数据必须要通过奇门和外部数据进行对接例如：基本信息配置、商品同步、商品对照、商品区域销售设置、渠道库存管理、库存同步设置、手动同步库存、仓库对照、供应商对照、采购订单、采购退货出库单、发货单列表、退货单列表、调拨单列表、仓内加工单、其他出库单、其他入库单、B2B出库单、接口日志查询、前后端商品映射关系同步

接口方案配置

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

金蝶云星空接口明细

• API：executeBillQuery

• NAME：物料查询

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FMasterId	id	FMasterId
FNumber	编码	FNumber
FName	名称	FName
FSpecification	规格型号	FSpecification
FMnemonicCode	助记码	FMnemonicCode
FOldNumber	旧物料编码	FOldNumber
FBARCODE	条码	FBARCODE
FDescription	描述	FDescription
FMaterialGroup_FNumber	物料分组	FMaterialGroup.FNumber
FErpClsID	物料属性	FErpClsID
FDocumentStatus	数据状态	FDocumentStatus
FForbidStatus	禁用状态	FForbidStatus
FBaseUnitId_FNumber	基本单位.编码	FBaseUnitId.FNumber
FCreateOrgId_FNumber	创建组织	FCreateOrgId.FNumber
FUseOrgId_FNumber	使用组织	FUseOrgId.FNumber
FIsInventory	允许库存	FIsInventory
FIsSale	允许销售	FIsSale
FIsAsset	允许资产	FIsAsset
FIsSubContract	允许委外	FIsSubContract
FIsProduce	允许生产	FIsProduce
FIsPurchase	允许采购	FIsPurchase
FStockId_FNumber	仓库	FStockId.FNumber
FPurchaseOrgId_FNumber	采购组织.编码	FPurchaseOrgId.FNumber
FPurchaseOrgId_FName	采购组织	FPurchaseOrgId.FName
FIsBatchManage	启用批号管理	FIsBatchManage
FIsKFPeriod	启用保质期管理	FIsKFPeriod
FIsSNManage	启用序列号管理	FIsSNManage
FSafeStock	安全库存	FSafeStock
FCategoryID	存货类别	FCategoryID
FExpPeriod	保质期	FExpPeriod
FOrderQty	起订量	FOrderQty
FMinQty	最小批量	FMinQty
FMaxQty	最大批量	FMaxQty
FDefaultVendor_FNumber	默认供应商	FDefaultVendor.FNumber
F_ora_Text	香型	F_ora_Text
F_ora_Text1	执行标准	F_ora_Text1
F_ora_Text2	生产企业	F_ora_Text2
F_ora_Text3	箱规	F_ora_Text3
FVarLeadTime	变动提前期	FVarLeadTime
FPlanBatchSplitQty	拆分批量	FPlanBatchSplitQty
FProduceBillType_FNumber	生产类型	FProduceBillType.FNumber
FPOBillTypeId_FNumber	采购类型	FPOBillTypeId.FNumber
FSubBillType_FNumber	委外类型	FSubBillType.FNumber
FGROSSWEIGHT	毛重	FGROSSWEIGHT
FNETWEIGHT	净重	FNETWEIGHT
FWEIGHTUNITID_FNumber	重量单位	FWEIGHTUNITID.FNumber
FLENGTH	长	FLENGTH
FWIDTH	宽	FWIDTH
FHEIGHT	高	FHEIGHT
FVOLUME	体积	FVOLUME
FWARRANTY	保修期	FWARRANTY
FSalePrice_CMK	零售价	FSalePrice_CMK
FVIPPrice_CMK	会员价	FVIPPrice_CMK
FPurPrice_CMK	采购单价	FPurPrice_CMK
FComBrandId_CMK_FNumber	品牌	FComBrandId_CMK.FNumber
Limit	最大行数	{{PAGINATION_PAGE_SIZE}}	金蝶的查询分页参数
StartRow	开始行索引	{{PAGINATION_START_ROW}}	金蝶的查询分页参数
TopRowCount	返回总行数		金蝶的查询分页参数
FilterString	过滤条件	FDOCUMENTSTATUS='C' and FUseOrgId.fnumber='100' and FApproveDate>='{{LAST_SYNC_TIME datetime}}'	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys	需查询的字段key集合		金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId	业务对象表单Id	BD_MATERIAL	必须填写金蝶的表单ID如 UR_PurchaseOrder

响应参数

接口字段	字段名称	预设值	描述
FMasterId	id
FNumber	编码
FName	名称
FSpecification	规格型号
FMnemonicCode	助记码
FOldNumber	旧物料编码
FBARCODE	条码
FDescription	描述
FMaterialGroup_FNumber	物料分组
FErpClsID	物料属性
FDocumentStatus	数据状态
FForbidStatus	禁用状态
FBaseUnitId_FNumber	基本单位.编码
FCreateOrgId_FNumber	创建组织
FUseOrgId_FNumber	使用组织
FIsInventory	允许库存
FIsSale	允许销售
FIsAsset	允许资产
FIsSubContract	允许委外
FIsProduce	允许生产
FIsPurchase	允许采购
FStockId_FNumber	仓库
FPurchaseOrgId_FNumber	采购组织.编码
FPurchaseOrgId_FName	采购组织
FIsBatchManage	启用批号管理
FIsKFPeriod	启用保质期管理
FIsSNManage	启用序列号管理
FSafeStock	安全库存
FCategoryID	存货类别
FExpPeriod	保质期
FOrderQty	起订量
FMinQty	最小批量
FMaxQty	最大批量
FDefaultVendor_FNumber	默认供应商
F_ora_Text	香型
F_ora_Text1	执行标准
F_ora_Text2	生产企业
F_ora_Text3	箱规
FVarLeadTime	变动提前期
FPlanBatchSplitQty	拆分批量
FProduceBillType_FNumber	生产类型
FPOBillTypeId_FNumber	采购类型
FSubBillType_FNumber	委外类型
FGROSSWEIGHT	毛重
FNETWEIGHT	净重
FWEIGHTUNITID_FNumber	重量单位
FLENGTH	长
FWIDTH	宽
FHEIGHT	高
FVOLUME	体积
FWARRANTY	保修期
FSalePrice_CMK	零售价
FVIPPrice_CMK	会员价
FPurPrice_CMK	采购单价
FComBrandId_CMK_FNumber	品牌

奇门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数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：奇门WMS-A与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。