金蝶云星空和四化智造MES（WEB）单据接口对接

庄颜_qeasy

金蝶云星空和四化智造MES（WEB）单据接口对接

接入系统：四化智造MES（WEB）

“MES助力智能制造过程控制:MES管理生产订单的整个生产流程,通过对生产过程的所有突发事件实时监控,自动纠正生产过程中的错误或提供决策支持,以实现生产调度要求;在出现异常或与生产计划偏离太大时,及时反馈相关人员使其采取相应的措施。任务派工:MES在生产计划完成后,自动生成任务派工单,根据生产设备实际加工能力的变化,制定并优化生产的具体过程及各设备的详细操作顺序

接入系统：金蝶云星空

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

配置集成方案

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：四化智造MES（WEB），然后选择对应的连接器。选择对应的原材料/标准件采购查询（待采购）作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器（关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的采购订单新增接口作为数据写入动作，既可以完成第一步的数据对接配置。

四化智造MES（WEB）接口明细

接口：mes/purchase/audit/selectMesReceiveDetailList
接口名称：原材料/标准件采购查询（待采购）
接口方法：GET

请求参数

字段名称类型描述 pageNum页码string页码 pageSize页数string页数 BeginTime开始时间string开始时间 EndTime结束时间string结束时间 updateTime更新时间string purStatus订单状态string2：已审核；5：已接收；9：已完成； filtrationBomStatus显示与影藏string

响应参数

字段名称类型描述 mchIdmchIdstringautoFillResponse createBycreateBystring_autoFillResponse createNamecreateNamestringautoFillResponse checkLabelcheckLabelstring_autoFillResponse createTimecreateTimestringautoFillResponse updateByupdateBystring_autoFillResponse updateNameupdateNamestringautoFillResponse updateTimeupdateTimestring_autoFillResponse remarkremarkstringautoFillResponse companyCodecompanyCodestring_autoFillResponse currentUserBycurrentUserBystringautoFillResponse currentUserNamecurrentUserNamestring_autoFillResponse currentTimecurrentTimestringautoFillResponse filtrationBomStatusfiltrationBomStatusstring_autoFillResponse ididstringautoFillResponse recordIdrecordIdstring_autoFillResponse detailIddetailIdstringautoFillResponse purIdpurIdstring_autoFillResponse coefficientcoefficientstringautoFillResponse haveDeliveryNumhaveDeliveryNumstring_autoFillResponse supplierUuidsupplierUuidstringautoFillResponse patterNopatterNostring_autoFillResponse customerDeliveryDatecustomerDeliveryDatestringautoFillResponse supplierNamesupplierNamestring_autoFillResponse supplierFullNamesupplierFullNamestringautoFillResponse purRecordUuidpurRecordUuidstring_autoFillResponse purRecordDetailUuidpurRecordDetailUuidstringautoFillResponse purTaskUuidpurTaskUuidstring_autoFillResponse takeApartDetailUuidtakeApartDetailUuidstringautoFillResponse orderUuidorderUuidstring_autoFillResponse bomUuidbomUuidstringautoFillResponse planBomUuidplanBomUuidstring_autoFillResponse partNopartNostringautoFillResponse processNameprocessNamestring_autoFillResponse gradeNamegradeNamestringautoFillResponse picNopicNostring_autoFillResponse qualityqualitystringautoFillResponse purTypepurTypestring_autoFillResponse outsourcedTypeoutsourcedTypestringautoFillResponse outProcessCodeoutProcessCodestring_autoFillResponse heatTreatmentheatTreatmentstringautoFillResponse bomNobomNostring_autoFillResponse keyNokeyNostringautoFillResponse locationCodelocationCodestring_autoFillResponse barcodebarcodestringautoFillResponse purchaseNumpurchaseNumstring_autoFillResponse purPricepurPricestringautoFillResponse purTotalPricepurTotalPricestring_autoFillResponse reqDatereqDatestringautoFillResponse productUuidproductUuidstring_autoFillResponse outsourcedWayoutsourcedWaystringautoFillResponse outsourcedWayListoutsourcedWayListstring_autoFillResponse locationUuidlocationUuidstringautoFillResponse stockNumstockNumstring_autoFillResponse deliveryDatedeliveryDatestringautoFillResponse reqNoreqNostring_autoFillResponse deptNamedeptNamestringautoFillResponse totalDemandNumtotalDemandNumstring_autoFillResponse productNoproductNostringautoFillResponse productNameproductNamestring_autoFillResponse orderNoorderNostringautoFillResponse orderTypeorderTypestring_autoFillResponse customerNamecustomerNamestringautoFillResponse projectCodeprojectCodestring_autoFillResponse purNopurNostringautoFillResponse purReasonpurReasonstring_autoFillResponse purStatuspurStatusstringautoFillResponse backStatusbackStatusstring_autoFillResponse customerOrderNocustomerOrderNostringautoFillResponse deptIddeptIdstring_autoFillResponse receiveByreceiveBystringautoFillResponse receiveTimereceiveTimestring_autoFillResponse receiveNamereceiveNamestringautoFillResponse takeApartTypetakeApartTypestring_autoFillResponse specspecstringautoFillResponse brandbrandstring_autoFillResponse materialInfoNomaterialInfoNostringautoFillResponse craftIdcraftIdstring_autoFillResponse rawPurchaseWeightrawPurchaseWeightstringautoFillResponse rawMaterialInfoNorawMaterialInfoNostring_autoFillResponse purTaskTypepurTaskTypestringautoFillResponse ifMoldifMoldstring_autoFillResponse taxPricetaxPricestringautoFillResponse taxTotalPricetaxTotalPricestring_autoFillResponse untaxedPriceuntaxedPricestringautoFillResponse untaxedTotalPriceuntaxedTotalPricestring_autoFillResponse taxRatetaxRatestringautoFillResponse customerPartNocustomerPartNostring_autoFillResponse stockTimestockTimestringautoFillResponse purchaseUnitNopurchaseUnitNostring_autoFillResponse purchaseUnitNamepurchaseUnitNamestringautoFillResponse returnsNumberreturnsNumberstring_autoFillResponse replaceModeNoreplaceModeNostringautoFillResponse secondPurTypesecondPurTypestring_autoFillResponse isSecondPurisSecondPurstringautoFillResponse checkedNumcheckedNumstring_autoFillResponse processingFeeprocessingFeestringautoFillResponse itemCategoryitemCategorystring_autoFillResponse stagestagestringautoFillResponse projectNameprojectNamestring_autoFillResponse rawMaterialInforawMaterialInfostringautoFillResponse rawPartNorawPartNostring_autoFillResponse rawGradeNamerawGradeNamestringautoFillResponse rawSpecrawSpecstring_autoFillResponse rawBrandrawBrandstringautoFillResponse rawQualityrawQualitystring_autoFillResponse rawQuantityrawQuantitystringautoFillResponse nuclearPriceTaskUuidnuclearPriceTaskUuidstring_autoFillResponse detailBackStatusdetailBackStatusstringautoFillResponse unitNameunitNamestring_autoFillResponse processingTypeprocessingTypestringautoFillResponse beginReqDatebeginReqDatestring_autoFillResponse endReqDateendReqDatestringautoFillResponse beginReceiveTimebeginReceiveTimestring_autoFillResponse endReceiveTimeendReceiveTimestringautoFillResponse beginReplyTimebeginReplyTimestring_autoFillResponse endReplyTimeendReplyTimestringautoFillResponse isAbnormalisAbnormalstring_autoFillResponse bomVersionbomVersionstringautoFillResponse orderNumorderNumstring_autoFillResponse workNoworkNostringautoFillResponse bomContractNobomContractNostring_autoFillResponse urgentNeedNourgentNeedNostringautoFillResponse bomRemarkbomRemarkstring_autoFillResponse distributeNumdistributeNumstringautoFillResponse distributeDatedistributeDatestring_autoFillResponse purRevokeUuidpurRevokeUuidstringautoFillResponse businessUuidbusinessUuidstring_autoFillResponse filePathfilePathstringautoFillResponse fileNamefileNamestring_autoFillResponse fileSuffixfileSuffixstringautoFillResponse fileName2dfileName2dstring_autoFillResponse filePath2dfilePath2dstringautoFillResponse fileName3dfileName3dstring_autoFillResponse filePath3dfilePath3dstringautoFillResponse changeRemarkchangeRemarkstring_autoFillResponse changeColorchangeColorstringautoFillResponse invTypeNameinvTypeNamestring_autoFillResponse rawUnitNamerawUnitNamestringautoFillResponse bomStatusbomStatusstring_autoFillResponse bomClosebomClosestringautoFillResponse shipmentPlaceshipmentPlacestring_autoFillResponse realNamerealNamestringautoFillResponse procuredNumprocuredNumstring_autoFillResponse taskPurTypetaskPurTypestringautoFillResponse moldNomoldNostring_autoFillResponse purCreateNamepurCreateNamestringautoFillResponse uploadFileTimeuploadFileTimestring_autoFillResponse replyTimereplyTimestringautoFillResponse beginPurchaseTimebeginPurchaseTimestring_autoFillResponse endPurchaseTimeendPurchaseTimestringautoFillResponse dispatchNodispatchNostring_autoFillResponse orderGradeNameorderGradeNamestringautoFillResponse orderPartNoorderPartNostring_autoFillResponse parentMaterialInfoNoparentMaterialInfoNostringautoFillResponse closeReasoncloseReasonstring_autoFillResponse closeUsercloseUserstringautoFillResponse closeTimecloseTimestring_autoFillResponse revokeReasonrevokeReasonstringautoFillResponse revokeNamerevokeNamestring_autoFillResponse revokeTimerevokeTimestringautoFillResponse detailStatusdetailStatusstring_autoFillResponse customerAndUrgentcustomerAndUrgentstringautoFillResponse orderNoBomorderNoBomstring_autoFillResponse singleSetNumsingleSetNumstringautoFillResponse receiveNumreceiveNumstring_autoFillResponse minPurchaseNumminPurchaseNumstring_autoFillResponse

金蝶云星空接口明细

API：batchSave
NAME：采购订单新增
METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillNo单据编号{{purNo}} FDate采购日期{{createTime}} FPurchaseOrgId采购组织1 FSupplierId供应商{{supplierUuid}} FPurchaserGroupId采购组 FPurchaserId采购员 FBillTypeID单据类型ZZJPO FBusinessType业务类型CG FPOOrderEntry明细信息details FPOOrderEntry.FMaterialId物料编码{{details.partNo}} FPOOrderEntry.FQty采购数量{{details.purMaterialNum}} FPOOrderEntry.FEntryDiscountRate折扣率% FPOOrderEntry.FEntryTaxRate税率%function {{details.taxRate}}*100 FPOOrderEntry.FTaxNetPrice净价 FPOOrderEntry.FEntryAmount金额 FPOOrderEntry.FAllAmount价税合计 FPOOrderEntry.FEntryNote备注 FPOOrderEntry.FTaxPrice含税单价{{details.subtotal}} FPOOrderEntry.FEntryTaxAmount税额 FPOOrderEntry.FDeliveryDate交货日期{{details.reqDeliveryDate}} FPOOrderEntry.FMtoNo计划跟踪号{{details.bomNo}} FPOOrderEntry.FGiveAway是否赠品_function case '{{details.ifFreebie}}' when '0' then 'true' when '1' then 'false' endtrue false FPOOrderEntry.F_lyzx_Text4模件号{{details.patterNo}} FPOOrderEntry.F_lyzx_Text5阶段{{details.stage}} FPOOrderEntry.F_lyzx_Text6客户订单号{{details.customerOrderNo}} FPOOrderEntry.F_lyzx_Text7紧急需求单号{{details.urgentNeedNo}} FPOOrderEntry.F_lyzx_Text8发包单号{{details.bomContractNo}} FPOOrderEntry.F_lyzx_Text9工令单号{{details.workNo}} FPOOrderEntry.F_lyzx_Text10收货城市{{details.shipmentPlace}} FPOOrderEntry.F_lyzx_Text3订单类型function case '{{details.orderType}}' when '11' then '无PO订单' when '1' then '客户订单' when '2' then '备货订单' when '10' then '返修订单' when '12' then '免费打样' when '3' then '异常订单' when '13' then '备货转销售订单' when '14' then '售后维修' when '18' then '直接出库订单' when '22' then '转换订单A' when '23' then '转换订单B' when '24' then '紧急订单' end FPOOrderEntry.F_UZMJ_Text四化明细行id{{details.purRecordDetailUuid}} FPOOrderEntry.F_lyzx_Text13下料尺寸{{details.cuttingSize}} FPOOrderEntry.F_UZMJ_Text34工序名称{{details.processName}} FPOOrderEntry.F_UZMJ_Qty10耗损数{{details.dissipativeNum}} FPOOrderEntry.F_UZMJ_Text2派工案号{{details.bomNo}} FPOOrderEntry.F_UZMJ_Text35计价方式_function case '{{details.computeMode}}' when '3' then '单件重量' when '1' then '件数' when '2' then '单件面积' when '4' then '工时' end FPOOrderEntry.F_UZMJ_Text45接收人{{details.receiveName}} FPOOrderEntry.F_UZMJ_Date7接单日期{{details.receiveTime}} FPOOrderEntry.F_UZMJ_Text31拒签原因{{details.receiveReason}} FPOOrderEntry.F_UZMJ_Qty11单件重量{{details.weight}} FPOOrderEntry.F_UZMJ_Text42采购申请人{{details.purCreateName}} FPOOrderEntry.F_UZMJ_Text15业务备注{{details.bomRemark}} FPOOrderEntry.F_UZMJ_Text44客户{{details.customerName}} FPOOrderEntry.F_UZMJ_Text39YSD模件号{{details.patterNo}}/{{details.keyNo}} FPOOrderEntry.F_UZMJ_Text38工费{{details.hourPrice}} FPOOrderEntry.F_UZMJ_Text36工时{{details.manHour}} FPOOrderEntry.F_UZMJ_Text37单件表面积{{details.proportion}} FPOOrderEntry.F_UZMJ_Text46计划人{{details.mbsOrderPlanBomcreateBy}} FPOOrderEntry.F_sh_id四化采购订单id{{purRecordUuid}} FPOOrderEntry.F_UZMJ_Text18是否核对否 FPOOrderEntry.F_UZMJ_Text50MES订单类型单工序采购 FPOOrderEntry.FormId业务对象表单IdPUR_PurchaseOrder必须填写金蝶的表单ID如😛UR_PurchaseOrder FPOOrderEntry.Operation执行的操作BatchSave FPOOrderEntry.IsAutoSubmitAndAudit提交并审核true FPOOrderEntry.IsVerifyBaseDataField验证基础资料true是否验证所有的基础资料有效性，布尔类，默认false（非必录）

数据对接效果

全新的API数据集成模式，赋能企业业务创新传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：金蝶云星空与四化智造MES（WEB）之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。