金蝶云星空和奇门WMS-A集成接口设计接入系统：金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。集成系统:奇门WMS-A 奇门WMS是针对菜鸟WMS、天猫国际保税仓、其它WMS系统（如：百世云仓、巨沃WMS、递四方、中仓仓储等第三方仓储WMS系统），进行对接与管理的模块。奇门WMS包含：基本信息配置、商品同步、商品对照、商品区域销售设置、渠道库存管理、库存同步设置、手动同步库存、仓库对照、供应商对照、采购订单、采购退货出库单、发货单列表、退货单列表、调拨单列表、仓内加工单、其他出库单、其他入库单、B2B出库单、接口日志查询、前后端商品映射关系同步数据接口配置数据集成平台对应的配置金蝶云星空与奇门WMS-A的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与奇门WMS-A之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。金蝶云星空接口明细调用接口： executeBillQuery 接口名称：物料查询方法： POST 请求参数字段字段名称类型配置值 FMasterId id string FMasterId FNumber 编码 string FNumber FName 名称 string FName FSpecification 规格型号 string FSpecification FMnemonicCode 助记码 string FMnemonicCode FOldNumber 旧物料编码 string FOldNumber FBARCODE 条码 string FBARCODE FDescription 描述 string FDescription FMaterialGroup_FNumber 物料分组 string FMaterialGroup.FNumber FErpClsID 物料属性 string FErpClsID FDocumentStatus 数据状态 string FDocumentStatus FForbidStatus 禁用状态 string FForbidStatus FBaseUnitId_FNumber 基本单位.编码 string FBaseUnitId.FNumber FCreateOrgId_FNumber 创建组织 string FCreateOrgId.FNumber FUseOrgId_FNumber 使用组织 string FUseOrgId.FNumber FIsInventory 允许库存 string FIsInventory FIsSale 允许销售 string FIsSale FIsAsset 允许资产 string FIsAsset FIsSubContract 允许委外 string FIsSubContract FIsProduce 允许生产 string FIsProduce FIsPurchase 允许采购 string FIsPurchase FStockId_FNumber 仓库 string FStockId.FNumber FPurchaseOrgId_FNumber 采购组织.编码 string FPurchaseOrgId.FNumber FPurchaseOrgId_FName 采购组织 string FPurchaseOrgId.FName FIsBatchManage 启用批号管理 string FIsBatchManage FIsKFPeriod 启用保质期管理 string FIsKFPeriod FIsSNManage 启用序列号管理 string FIsSNManage FSafeStock 安全库存 string FSafeStock FCategoryID 存货类别 string FCategoryID FExpPeriod 保质期 string FExpPeriod FOrderQty 起订量 string FOrderQty FMinQty 最小批量 string FMinQty FMaxQty 最大批量 string FMaxQty FDefaultVendor_FNumber 默认供应商 string FDefaultVendor.FNumber F_ora_Text 香型 string F_ora_Text F_ora_Text1 执行标准 string F_ora_Text1 F_ora_Text2 生产企业 string F_ora_Text2 F_ora_Text3 箱规 string F_ora_Text3 FVarLeadTime 变动提前期 string FVarLeadTime FPlanBatchSplitQty 拆分批量 string FPlanBatchSplitQty FProduceBillType_FNumber 生产类型 string FProduceBillType.FNumber FPOBillTypeId_FNumber 采购类型 string FPOBillTypeId.FNumber FSubBillType_FNumber 委外类型 string FSubBillType.FNumber FGROSSWEIGHT 毛重 string FGROSSWEIGHT FNETWEIGHT 净重 string FNETWEIGHT FWEIGHTUNITID_FNumber 重量单位 string FWEIGHTUNITID.FNumber FLENGTH 长 string FLENGTH FWIDTH 宽 string FWIDTH FHEIGHT 高 string FHEIGHT FVOLUME 体积 string FVOLUME FWARRANTY 保修期 string FWARRANTY FSalePrice_CMK 零售价 string FSalePrice_CMK FVIPPrice_CMK 会员价 string FVIPPrice_CMK FPurPrice_CMK 采购单价 string FPurPrice_CMK FComBrandId_CMK_FNumber 品牌 string FComBrandId_CMK.FNumber Limit 最大行数 string {{PAGINATION_PAGE_SIZE}} StartRow 开始行索引 string {{PAGINATION_START_ROW}} TopRowCount 返回总行数 int FilterString 过滤条件 string FDOCUMENTSTATUS='C' and FUseOrgId.fnumber='100' and FApproveDate>='{{LAST_SYNC_TIME datetime}}' FieldKeys 需查询的字段key集合 array FormId 业务对象表单Id string BD_MATERIAL 响应参数字段字段名称类型配置值 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 warehouseCode 仓库编码 string HYKB01 ownerCode 货主编码 string GZ202206111 supplierCode 供应商编码 string supplierName 供应商名称 string {{F_ora_Text2}} item 商品信息 array item.itemCode 商品编码 string {{FNumber}} item.itemId 仓储系统商品编码 string item.goodsCode 货号 string 1 item.itemName 商品名称 string {{FName}} item.shortName 商品简称 string item.englishName 英文名 string item.barCode 条形码 string {{FBARCODE}} item.skuProperty 商品属性 string {{FSpecification}} item.stockUnit 商品计量单位 string {{FBaseUnitId_FNumber}} item.length 长 string 1 item.width 宽 string 1 item.height 高 string 1 item.volume 体积 string 1 item.grossWeight 毛重 string 1 item.netWeight 净重 string 1 item.color 颜色 string item.size 尺寸 string item.title 渠道中的商品标题 string item.categoryId 商品类别ID string item.categoryName 商品类别名称 string {{F_ora_Text}} item.pricingCategory 计价货类 string item.safetyStock 安全库存 string item.itemType 商品类型 string ZC item.tagPrice 吊牌价 string item.retailPrice 零售价 string item.costPrice 成本价 string item.purchasePrice 采购价 string item.seasonCode 季节编码 string item.seasonName 季节名称 string item.brandCode 品牌代码 string LAL item.brandName 品牌名称 string 无 item.isSNMgmt 是否需要串号管理 string N item.productDate 生产日期 string item.expireDate 过期日期 string item.isShelfLifeMgmt 是否需要保质期管理 string item.shelfLife 保质期 string {{FExpPeriod}} item.rejectLifecycle 保质期禁收天数 string item.lockupLifecycle 保质期禁售天数 string item.adventLifecycle 保质期临期预警天数 string item.isBatchMgmt 是否需要批次管理 string {{FIsKFPeriod}} item.batchCode 批次代码 string item.batchRemark 批次备注 string item.packCode 包装代码 string item.pcs 箱规 string {{F_ora_Text3 intval}} item.originAddress 商品的原产地 string item.approvalNumber 批准文号 string {{F_ora_Text1}} item.isFragile 是否易碎品 string item.isHazardous 是否危险品 string item.remark 备注 string item.createTime 创建时间 string item.updateTime 更新时间 string item.isValid 是否有效 string item.isSku 是否sku string item.packageMaterial 商品包装材料类型 string item.supplierCode temp string item.logisticsType 销售配送方式 string item.isLiquid 是否液体 string item.extendProps 扩展属性 string 系统数据集成价值通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与奇门WMS-A之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。

金蝶云星空和奇门WMS-A集成接口设计

关一帆qeasy

金蝶云星空和奇门WMS-A集成接口设计

接入系统：金蝶云星空

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

集成系统:奇门WMS-A

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

数据接口配置

数据集成平台对应的配置金蝶云星空与奇门WMS-A的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与奇门WMS-A之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

金蝶云星空接口明细

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

请求参数

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

响应参数

字段	字段名称	类型
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
warehouseCode	仓库编码	string	HYKB01
ownerCode	货主编码	string	GZ202206111
supplierCode	供应商编码	string
supplierName	供应商名称	string	{{F_ora_Text2}}
item	商品信息	array
item.itemCode	商品编码	string	{{FNumber}}
item.itemId	仓储系统商品编码	string
item.goodsCode	货号	string	1
item.itemName	商品名称	string	{{FName}}
item.shortName	商品简称	string
item.englishName	英文名	string
item.barCode	条形码	string	{{FBARCODE}}
item.skuProperty	商品属性	string	{{FSpecification}}
item.stockUnit	商品计量单位	string	{{FBaseUnitId_FNumber}}
item.length	长	string	1
item.width	宽	string	1
item.height	高	string	1
item.volume	体积	string	1
item.grossWeight	毛重	string	1
item.netWeight	净重	string	1
item.color	颜色	string
item.size	尺寸	string
item.title	渠道中的商品标题	string
item.categoryId	商品类别ID	string
item.categoryName	商品类别名称	string	{{F_ora_Text}}
item.pricingCategory	计价货类	string
item.safetyStock	安全库存	string
item.itemType	商品类型	string	ZC
item.tagPrice	吊牌价	string
item.retailPrice	零售价	string
item.costPrice	成本价	string
item.purchasePrice	采购价	string
item.seasonCode	季节编码	string
item.seasonName	季节名称	string
item.brandCode	品牌代码	string	LAL
item.brandName	品牌名称	string	无
item.isSNMgmt	是否需要串号管理	string	N
item.productDate	生产日期	string
item.expireDate	过期日期	string
item.isShelfLifeMgmt	是否需要保质期管理	string
item.shelfLife	保质期	string	{{FExpPeriod}}
item.rejectLifecycle	保质期禁收天数	string
item.lockupLifecycle	保质期禁售天数	string
item.adventLifecycle	保质期临期预警天数	string
item.isBatchMgmt	是否需要批次管理	string	{{FIsKFPeriod}}
item.batchCode	批次代码	string
item.batchRemark	批次备注	string
item.packCode	包装代码	string
item.pcs	箱规	string	{{F_ora_Text3 intval}}
item.originAddress	商品的原产地	string
item.approvalNumber	批准文号	string	{{F_ora_Text1}}
item.isFragile	是否易碎品	string
item.isHazardous	是否危险品	string
item.remark	备注	string
item.createTime	创建时间	string
item.updateTime	更新时间	string
item.isValid	是否有效	string
item.isSku	是否sku	string
item.packageMaterial	商品包装材料类型	string
item.supplierCode	temp	string
item.logisticsType	销售配送方式	string
item.isLiquid	是否液体	string
item.extendProps	扩展属性	string

系统数据集成价值

通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与奇门WMS-A之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。