从金蝶K3-WISE到黑湖MES通过接口配置打通数据

源系统:金蝶K3-WISE

金蝶K/3WISE是一款面向成长型企业，适应企业在快速成长过程中业务与管理的不断变化的信息化平台，实现云服务、ERP、物联网的融合，帮助企业从信息化建设到构建企业工业互联网与数字化管理平台。

对接系统：黑湖MES

黑湖智造旗下的制造协同SaaS软件于2018年正式上线以来，在短短两年时间内，服务了中国大陆、港澳台、东南亚近2000家制造企业及其供应链，覆盖了近20个细分行业的全链路生产场景。为不同流程、不同目标的客户提供最贴合的解决方案，赋能了包括农夫山泉、蜜雪冰城、华润医药、三九药业、沃森生物、中国石化、欧莱雅、中国兵器、中信戴卡、特斯拉、小米等众多头部企业及其供应链。

数据集成方案配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶K3-WISE，然后选择对应的连接器。选择对应的Material/GetList作为数据对接来源。然后再写入目标平台配置目标系统为黑湖MES，并且选择对应连接器（关于黑湖MES的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的openapi/v1/def/material/import接口作为数据写入动作完成第一步的接口配置。

金蝶K3-WISE接口明细

API：Material/GetList
NAME：物料查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 FHelpCode助记码FHelpCode FModel规格型号FModel FAuxClassID辅助属性类别FAuxClassID FErpClsID物料属性FErpClsID FTypeID物料分类FTypeID FUnitGroupID计量单位组FUnitGroupID FUnitID基本计量单位FUnitID FOrderUnitID采购计量单位FOrderUnitID FSaleUnitID销售计量单位FSaleUnitID FProductUnitID生产计量单位FProductUnitID FStoreUnitID库存计量单位FStoreUnitID FSecUnitID辅助计量单位FSecUnitID FSecCoefficient辅助计量单位换算率FSecCoefficient FDefaultLoc默认仓库FDefaultLoc FSPID默认仓位FSPID FSource来源FSource FQtyDecimal数量精度FQtyDecimal FLowLimit最低存量FLowLimit FHighLimit最高存量FHighLimit FSecInv安全库存数量FSecInv FUseState使用状态FUseState FIsEquipment是否为设备FIsEquipment FEquipmentNum设备编码FEquipmentNum FIsSparePart是否为备件FIsSparePart FFullName物料全名FFullName FApproveNo批准文号FApproveNo FAlias别名FAlias FOrderRector采购负责人FOrderRector FPOHighPrice采购最高价FPOHighPrice FPOHghPrcMnyType采购最高价币别FPOHghPrcMnyType FWWHghPrc委外加工最高价FWWHghPrc FWWHghPrcMnyType委外加工最高价币别FWWHghPrcMnyType FSOLowPrc销售最低价FSOLowPrc FSOLowPrcMnyType销售最低价币别FSOLowPrcMnyType FIsSale是否销售FIsSale FProfitRate毛利率(%)FProfitRate FOrderPrice采购单价FOrderPrice FSalePrice销售单价FSalePrice FIsSpecialTax是否农林计税FIsSpecialTax FISKFPeriod是否进行保质期管理FISKFPeriod FKFPeriod保质期(天)FKFPeriod FStockTime是否需要库龄管理FStockTime FBatchManager是否采用业务批次管理FBatchManager FBookPlan是否需要进行订补货计划的运算FBookPlan FBeforeExpire失效提前期(天)FBeforeExpire FCheckCycUnit盘点周期单位FCheckCycUnit FCheckCycle盘点周期FCheckCycle FDaysPer每周/月第()天FDaysPer FLastCheckDate上次盘点日期FLastCheckDate FOIHighLimit外购超收比例(%)FOIHighLimit FOILowLimit外购欠收比例(%)FOILowLimit FSOHighLimit销售超交比例(%)FSOHighLimit FSOLowLimit销售欠交比例(%)FSOLowLimit FInHighLimit完工超收比例(%)FInHighLimit FInLowLimit完工欠收比例(%)FInLowLimit FPickHighLimit领料超收比例(%)FPickHighLimit FPickLowLimit领料欠收比例(%)FPickLowLimit FTrack计价方法FTrack FPlanPrice计划单价FPlanPrice FPriceDecimal单价精度FPriceDecimal FAcctID存货科目代码FAcctID FSaleAcctID销售收入科目代码FSaleAcctID FCostAcctID销售成本科目代码FCostAcctID FAPAcctID成本差异科目代码FAPAcctID FAdminAcctID代管物资科目FAdminAcctID FGoodSpec税目代码FGoodSpec FTaxRate税率(%)FTaxRate FCostProject成本项目FCostProject FIsSNManage是否进行序列号管理FIsSNManage F_102工艺简述F_102 FCBRestore参与结转式成本还原FCBRestore FNote备注FNote FPlanTrategy计划策略FPlanTrategy FPlanMode计划模式FPlanMode FOrderTrategy订货策略FOrderTrategy FFixLeadTime固定提前期FFixLeadTime FLeadTime变动提前期FLeadTime FTotalTQQ累计提前期FTotalTQQ FOrderInterVal订货间隔期(天)FOrderInterVal FQtyMin最小订货量FQtyMin FQtyMax最大订货量FQtyMax FBatchAppendQty批量增量FBatchAppendQty FOrderPoint再订货点FOrderPoint FBatFixEconomy固定/经济批量FBatFixEconomy FBatChangeEconomy变动提前期批量FBatChangeEconomy FRequirePoint需求时界(天)FRequirePoint FPlanPoint计划时界(天)FPlanPoint FDefaultRoutingID默认工艺路线FDefaultRoutingID FDefaultWorkTypeID默认生产类型FDefaultWorkTypeID FProductPrincipal生产负责人FProductPrincipal FPlanner计划员FPlanner FIsBackFlush是否倒冲FIsBackFlush FBackFlushStockID倒冲仓库FBackFlushStockID FBackFlushSPID倒冲仓位FBackFlushSPID FPutInteger投料自动取整FPutInteger FDailyConsume日消耗量FDailyConsume FMRPConMRP计算是否合并需求FMRPCon FMRPOrderMRP计算是否产生采购申请FMRPOrder FChartNumber图号FChartNumber FIsKeyItem是否关键件FIsKeyItem FGrossWeight毛重FGrossWeight FNetWeight净重FNetWeight FMaund重量单位FMaund FLength长度FLength FWidth宽度FWidth FHeight高度FHeight FSize体积FSize FCubicMeasure长度单位FCubicMeasure FStandardCost单位标准成本FStandardCost FCBAppendRate附加费率(%)FCBAppendRate FCBAppendProject附加费所属成本项目FCBAppendProject FCostBomID成本BOMFCostBomID FCBRouting成本工艺路线FCBRouting FStdBatchQty标准加工批量FStdBatchQty FStandardManHour单位标准工时(小时)FStandardManHour FStdPayRate标准工资率FStdPayRate FChgFeeRate变动制造费用分配率FChgFeeRate FStdFixFeeRate单位标准固定制造费用金额FStdFixFeeRate FOutMachFee单位委外加工费FOutMachFee FOutMachFeeProject委外加工费所属成本项目FOutMachFeeProject FPieceRate单位计件工资FPieceRate FPOVAcctID采购订单差异科目代码FPOVAcctID FPIVAcctID采购发票差异科目代码FPIVAcctID FMCVAcctID材料成本差异科目代码FMCVAcctID FPCVAcctID加工费差异科目代码FPCVAcctID FSLAcctID废品损失科目代码FSLAcctID FCAVAcctID标准成本调整差异科目代码FCAVAcctID FInspectionLevel采购检验方式FInspectionLevel FProChkMde产品检验方式FProChkMde FWWChkMde委外加工检验方式FWWChkMde FSOChkMde发货检验方式FSOChkMde FWthDrwChkMde退货检验方式FWthDrwChkMde FStkChkMde库存检验方式FStkChkMde FOtherChkMde其他检验方式FOtherChkMde FSampStdCritical抽样标准(致命)FSampStdCritical FSampStdStrict抽样标准(严重)FSampStdStrict FSampStdSlight抽样标准(轻微)FSampStdSlight FStkChkPrd库存检验周期(天)FStkChkPrd FStkChkAlrm库存周期检验预警提前期(天)FStkChkAlrm FInspectionProject检验方案FInspectionProject FIdentifier检验员FIdentifier FVersion版本号FVersion FNameEn英文名称FNameEn FModelEn英文规格FModelEn FHSNumberHS编码FHSNumber FExportRate外销税率%FExportRate FFirstUnitHS第一法定单位FFirstUnit FSecondUnitHS第二法定单位FSecondUnit FImpostTaxRate进口关税率%FImpostTaxRate FConsumeTaxRate进口消费税率%FConsumeTaxRate FFirstUnitRateHS第一法定单位换算率FFirstUnitRate FSecondUnitRateHS第二法定单位换算率FSecondUnitRate FIsManage是否保税监管FIsManage FManageType物料监管类型FManageType FLenDecimal长度精度FLenDecimal FCubageDecimal体积精度FCubageDecimal FWeightDecimal重量精度FWeightDecimal FCharSourceItemID特性配置来源FCharSourceItemID FIsCharSourceItem物料对应特性FIsCharSourceItem FCtrlType控制类型FCtrlType FCtrlStraregy控制策略FCtrlStraregy FContainerName容器名称FContainerName FKanBanCapability看板容量FKanBanCapability FBatchSplitDays批量拆分间隔天数FBatchSplitDays FBatchSplit拆分批量FBatchSplit FDefaultReadyLoc默认待检仓库FDefaultReadyLoc FSPIDReady默认待检仓位FSPIDReady FStartService启用服务FStartService FMakeFile生成产品档案FMakeFile FIsFix维修件FIsFix FTtermOfService保修期限（月）FTtermOfService FTtermOfUsefulTime使用寿命（月）FTtermOfUsefulTime FIsFixedReOrder设置为固定再订货点FIsFixedReOrder FOnlineShopPNo商家编码FOnlineShopPNo FOnlineShopPName网店货品名FOnlineShopPName FForbbitBarcodeEdit严格进行二维码数量校验FForbbitBarcodeEdit FDSManagerID默认仓管员FDSManagerID FUnitPackageNumber单位包装数量FUnitPackageNumber FOrderDept采购部门FOrderDept FAuxInMrpCal辅助属性参与计划运算FAuxInMrpCal FProductDesigner产品设计员FProductDesigner FPinYin名称拼音FPinYin FPY拼音缩写FPY FBarcodeQtyEachTime条码单位数量FBarcodeQtyEachTime FIsSNBanDing必须进行SN绑定FIsSNBanDing FIsSNRptSN物料汇报时必须有序列号FIsSNRpt FName名称FName FNumber代码FNumber FItemIdFItemIdFItemId F_103F_103F_103 Top当前记录数100 PageSize每页条数{{PAGINATION_PAGE_SIZE}} PageIndex开始行索引_function {{PAGINATION_START_PAGE}}+1 Filter过滤条件FNumber like '%08.1.1%' and F_103 >='{{LAST_SYNC_TIME}}' Fields需查询的字段key集合

响应参数

黑湖MES接口明细

API：openapi/v1/def/material/import
NAME：物料导入
METHOD：POST

请求参数

接口字段字段名称预设值描述 code物料编码{{FNumber}} name物料名称{{FName}} unitName单位{{FUnitID_FName}} needRequestMaterial请料方式1 labelRegulation标签管理_function CASE LEFT('{{FNumber}}',2) WHEN '08' THEN 1 WHEN '05' THEN 1 ELSE 0 END safeStorageAmount安全库存1 materialProperty物料属性自制 unitPrecision主单位精度位数4 descdesc{{FModel}} materialCustomFieldsmaterialCustomFields{{FNumber}} unitConversionsunitConversions unitConversions.materialCodematerialCode{{FNumber}} unitConversions.masterUnitCountmasterUnitCount1 unitConversions.slaveUnitNameslaveUnitName{{FOrderUnitID_FName}} unitConversions.slaveUnitCountslaveUnitCount1 unitConversions.slaveUnitPrecisionslaveUnitPrecision4 unitConversions.inputFactoryUnitNameinputFactoryUnitName{{FOrderUnitID_FName}} unitConversions.array数组对象materials

系统对接概况

全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。

从金蝶K3-WISE到黑湖MES通过接口配置打通数据