金蝶云星空对接打通管易云物料查询接口与商品新增接口数据源系统:金蝶云星空金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。对接目标系统:管易云管易云是金蝶旗下专注提供电商企业管理软件服务的子品牌，先后开发了C-ERP、EC-OMS、EC-WMS、E店管家、BBC、B2B、B2C商城网站建设等产品和服务，涵盖电商业务全流程。数据接口配置方案系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星空的接口参数设置，以及设定好目标平台：管易云的映射，即可启动方案进行测试金蝶云星空接口明细 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 FIsSalseByNet 是否网销 FIsSalseByNet 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 默认供应商 FDefaultVendor.FNumber FMaxPOQty 最大订货量 FMaxPOQty FMinPOQty 最小订货量 FMinPOQty FIncreaseQty 最小包装量 FIncreaseQty FFixLeadTime 固定提前期 FFixLeadTime 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 品牌 FComBrandId_CMK.FNUMBER Limit 最大行数 {{PAGINATION_PAGE_SIZE}} StartRow 开始行索引 {{PAGINATION_START_ROW}} TopRowCount 返回总行数 FilterString 过滤条件 FUseOrgId.FNumber='100' and FApproveDate >='{{LAST_SYNC_TIME datetime}}' FieldKeys 需查询的字段key集合 FormId 业务对象表单Id BD_MATERIAL 响应参数接口字段字段名称预设值描述 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 FIsSalseByNet 是否网销 FIsSalseByNet 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 默认供应商 FDefaultVendor FMaxPOQty 最大订货量 FMaxPOQty FMinPOQty 最小订货量 FMinPOQty FIncreaseQty 最小包装量 FIncreaseQty FFixLeadTime 固定提前期 FFixLeadTime 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 品牌 FComBrandId_CMK 管易云接口明细调用接口： gy.erp.item.add 接口名称：商品新增方法： POST 请求参数字段字段名称类型配置值 code 商品代码 string {{FNumber}} name 商品名称 string {{FName}} item_brand_id 商品品牌id string item_brand_code 商品品牌代码 string {{FComBrandId_CMK }} simple_name 商品简称 string {{FName}} category_code 商品分类code string supplier_code 供应商code string {{FDefaultVendor}} note 备注 string minusStock 是否启用负库存 string item_add_attribute 商品附加属性 string pic_url 图片url string tax_code 税收分类编码 string tax_no 商品税号 string tax_rate 商品税率 string unit_code 商品单位code string {{FBaseUnitId_FNumber}} supplier_outer_id 供应商货号 string weight 商品重量 string {{FNETWEIGHT}} length 长 string {{FLENGTH}} width 宽 string {{FWIDTH}} height 高 string {{FHEIGHT}} volume 商品体积 string package_point 打包积分 string sales_point 销售积分 string sales_price 标准售价 string purchase_price 标准进价 string cost_price 成本价 string agent_price 代理售价 string stock_status_code 库存状态code string skus skus array skus.sku_code 规格代码 string {{FNumber}} skus.sku_name 规格名称 string {{FName}} skus.sku_weight 规格重量 string skus.sku_purchase_price 规格标准进价 string skus.sku_sales_price 规格标准售价 string skus.sku_agent_price 规格代理售价 string skus.sku_cost_price 规格成本价 string skus.sku_package_point 规格打包积分 string skus.sku_sales_point 规格销售积分 string skus.sku_note 规格备注 string 系统数据对接当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

金蝶云星空对接打通管易云物料查询接口与商品新增接口

关一帆qeasy

金蝶云星空对接打通管易云物料查询接口与商品新增接口

数据源系统:金蝶云星空

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

对接目标系统:管易云

管易云是金蝶旗下专注提供电商企业管理软件服务的子品牌，先后开发了C-ERP、EC-OMS、EC-WMS、E店管家、BBC、B2B、B2C商城网站建设等产品和服务，涵盖电商业务全流程。

数据接口配置方案

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星空的接口参数设置，以及设定好目标平台：管易云的映射，即可启动方案进行测试

金蝶云星空接口明细

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
FIsSalseByNet	是否网销	FIsSalseByNet
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	默认供应商	FDefaultVendor.FNumber
FMaxPOQty	最大订货量	FMaxPOQty
FMinPOQty	最小订货量	FMinPOQty
FIncreaseQty	最小包装量	FIncreaseQty
FFixLeadTime	固定提前期	FFixLeadTime
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	品牌	FComBrandId_CMK.FNUMBER
Limit	最大行数	{{PAGINATION_PAGE_SIZE}}
StartRow	开始行索引	{{PAGINATION_START_ROW}}
TopRowCount	返回总行数
FilterString	过滤条件	FUseOrgId.FNumber='100' and FApproveDate >='{{LAST_SYNC_TIME datetime}}'
FieldKeys	需查询的字段key集合
FormId	业务对象表单Id	BD_MATERIAL

响应参数

接口字段	字段名称	预设值
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
FIsSalseByNet	是否网销	FIsSalseByNet
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	默认供应商	FDefaultVendor
FMaxPOQty	最大订货量	FMaxPOQty
FMinPOQty	最小订货量	FMinPOQty
FIncreaseQty	最小包装量	FIncreaseQty
FFixLeadTime	固定提前期	FFixLeadTime
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	品牌	FComBrandId_CMK

管易云接口明细

调用接口：gy.erp.item.add
接口名称：商品新增
方法：POST

请求参数

字段	字段名称	类型	配置值
code	商品代码	string	{{FNumber}}
name	商品名称	string	{{FName}}
item_brand_id	商品品牌id	string
item_brand_code	商品品牌代码	string	{{FComBrandId_CMK }}
simple_name	商品简称	string	{{FName}}
category_code	商品分类code	string
supplier_code	供应商code	string	{{FDefaultVendor}}
note	备注	string
minusStock	是否启用负库存	string
item_add_attribute	商品附加属性	string
pic_url	图片url	string
tax_code	税收分类编码	string
tax_no	商品税号	string
tax_rate	商品税率	string
unit_code	商品单位code	string	{{FBaseUnitId_FNumber}}
supplier_outer_id	供应商货号	string
weight	商品重量	string	{{FNETWEIGHT}}
length	长	string	{{FLENGTH}}
width	宽	string	{{FWIDTH}}
height	高	string	{{FHEIGHT}}
volume	商品体积	string
package_point	打包积分	string
sales_point	销售积分	string
sales_price	标准售价	string
purchase_price	标准进价	string
cost_price	成本价	string
agent_price	代理售价	string
stock_status_code	库存状态code	string
skus	skus	array
skus.sku_code	规格代码	string	{{FNumber}}
skus.sku_name	规格名称	string	{{FName}}
skus.sku_weight	规格重量	string
skus.sku_purchase_price	规格标准进价	string
skus.sku_sales_price	规格标准售价	string
skus.sku_agent_price	规格代理售价	string
skus.sku_cost_price	规格成本价	string
skus.sku_package_point	规格打包积分	string
skus.sku_sales_point	规格销售积分	string
skus.sku_note	规格备注	string

系统数据对接

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。