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

数据源系统:金蝶云星空

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

对接目标系统:管易云

管易云是上海管易云计算软件有限公司旗下的专注提供电商企业管理软件服务的品牌，总部位于中国上海张江高科技产业园区。管易云旗下拥有管易云C-ERP、EC-OMS、EC-WMS、B2C/B2B/BBC/微商城开发、PDA无纸化仓储解决方案、新零售一体化解决方案等产品

数据接口配置

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

金蝶云星空接口明细

• 调用接口：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
FMaxPOQty	最大订货量	string	FMaxPOQty
FMinPOQty	最小订货量	string	FMinPOQty
FIncreaseQty	最小包装量	string	FIncreaseQty
FFixLeadTime	固定提前期	string	FFixLeadTime
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 FMODIFYDATE>='{{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
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

管易云接口明细

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

请求参数

字段	字段名称	类型	配置值
code	商品代码	string	{{FNumber}}
name	商品名称	string	{{FName}}
item_brand_id	商品品牌id	string
item_brand_code	商品品牌代码	string
simple_name	商品简称	string
category_code	商品分类code	string
supplier_code	供应商code	string
note	备注	string
minusStock	是否启用负库存	string
item_add_attribute	商品附加属性	string	function case '{{FIsBatchManage}}' when '1' then 2 when '0' then '0' else '0' end
pic_url	图片url	string
tax_code	税收分类编码	string
tax_no	商品税号	string
tax_rate	商品税率	string	_function case '{{FTAXRATEID_FNumber}}' when 'SL01_SYS' then 17 when 'SL02_SYS' then 13 when 'SL03_SYS' then 7 when 'SL04_SYS' then 0 when 'SL05_SYS' then 11 when 'SL06_SYS' then 6 when 'SL07_SYS' then 3 when 'SL08_SYS' then 16 when 'SL45_SYS' then 12 when 'SL09_SYS' then 10 else 0 end
unit_code	商品单位code	string
supplier_outer_id	供应商货号	string
weight	商品重量	string	{{FNETWEIGHT}}
length	长	string	{{FLENGTH}}
width	宽	string	{{FWIDTH}}
height	高	string	{{FHEIGHT}}
volume	商品体积	string	{{FVOLUME}}
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	{{skus.FNumber}}
skus.sku_name	规格名称	string	{{skus.FSpecification}}
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
skus.shelf_life	保质期	string

系统打通概况

可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。