金蝶云星空和管易云接口打通对接实战

数据源系统:金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

目标系统:管易云

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

数据集成方案配置

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：金蝶云星空接口：物料查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：管易云接口：商品新增，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：管易云写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况
 

金蝶云星空接口明细

• 调用接口：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	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
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
name	商品名称	string
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
pic_url	图片url	string
tax_code	税收分类编码	string
tax_no	商品税号	string
tax_rate	商品税率	string
unit_code	商品单位code	string
supplier_outer_id	供应商货号	string
weight	商品重量	string
length	长	string
width	宽	string
height	高	string
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
skus.sku_name	规格名称	string
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

响应参数

字段	名称	类型	描述
primaryWriteback	回写参数	object
primaryWriteback.id	id	string
primaryWriteback.code	code	string
primaryWriteback.callBackStrategy	回写方案	object
primaryWriteback.callBackStrategy.strategyId	方案ID	string
primaryWriteback.callBackStrategy.FMasterId	FMasterId	string
primaryWriteback.callBackStrategy.FName	FName	string
primaryWriteback.callBackStrategy.code	返回的单据编码	string
primaryWriteback.callBackStrategy.id	返回的单据ID	string

系统对接概况

将传统的统计分析转变为预测分析，从被动分析到主动分析，从非实时分析转变为实时分析，从结构化的数据变成多元化的数据。精准查询数据流同步状况，实时监管队列任务以及数据资产的有序管理。为业务赋能，降本增效，让企业能够更加合理的布局团队；结合业务需求实现与OA，CRM，WMS等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。