从金蝶云星空到四化智造MES（API）通过接口配置打通数据

接通系统：金蝶云星空

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

对接目标平台:四化智造MES（API）

MES系统是集成生产管理、品质管理、设备管理、BI数据中心、库存管理、工时管理、数据采集、看板管理等为一体的综合性生产管理系统。通过强调制造过程的透明化，帮助企业由粗放式向精益化管理模式升级。

系统对接接口配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的ExecuteBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为四化智造MES（API），并且选择对应连接器（关于四化智造MES（API）的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的/api/createContactInfo接口作为数据写入动作完成第一步的接口配置。

金蝶云星空接口明细

接口：ExecuteBillQuery
接口名称：逐个单据查询
接口方法：POST

请求参数

字段名称类型描述 Limit最大行数string金蝶的查询分页参数 StartRow开始行索引string金蝶的查询分页参数 TopRowCount返回总行数int金蝶的查询分页参数 FilterString过滤条件string示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合array金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单Idstring必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

字段名称类型描述 DocumentStatus单据状态string ForbidStatus禁用状态string Name客户名称string Number客户编码string Description备注string CreateOrgId_Id创建组织Idstring CreateOrgId_Name创建组织_名称string CreateOrgId_Number创建组织编码string UseOrgId_Id使用组织_Idstring UseOrgId_Name使用组织名称string UseOrgId_Number使用组织_编码string CreatorId_Id创建人Idstring CreatorId_Name创建人_名称string CreatorId_Number创建人编码string ModifierId_Id修改人_Idstring ModifierId_Name修改人名称string ModifierId_Number修改人_编码string CreateDate创建日期string FModifyDate修改日期string ShortName简称string COUNTRY国家string PROVINCIAL地区string FZIP邮政编码string TEL联系电话string FTAXREGISTERCODE纳税登记号string FAX传真string FGROUPCUSTID_Id对应集团客户Idstring FGROUPCUSTID_Name对应集团客户_名称string FGROUPCUSTID_Number对应集团客户编码string FSUPPLIERID_Id对应供应商_Idstring FSUPPLIERID_Name对应供应商名称string FSUPPLIERID_Number对应供应商_编码string TRADINGCURRID_Id结算币别Idstring TRADINGCURRID_Name结算币别_名称string TRADINGCURRID_Number结算币别编码string SALDEPTID_Id销售部门_Idstring SALDEPTID_Name销售部门名称string SALDEPTID_Number销售部门_编码string SALGROUPID_Id销售组Idstring SALGROUPID_Name销售组_名称string SALGROUPID_Number销售组编码string SELLER_Id销售员_Idstring SELLER_Name销售员名称string SELLER_Number销售员_编码string TRANSLEADTIME运输提前期string PRICELISTID_Id价目表Idstring PRICELISTID_Name价目表_名称string PRICELISTID_Number价目表编码string DISCOUNTLISTID_Id折扣表_Idstring DISCOUNTLISTID_Name折扣表名称string DISCOUNTLISTID_Number折扣表_编码string SETTLETYPEID_Id结算方式Idstring SETTLETYPEID_Name结算方式_名称string SETTLETYPEID_Number结算方式编码string RECEIVECURRID_Id收款币别_Idstring RECEIVECURRID_Name收款币别名称string RECEIVECURRID_Number收款币别_编码string RECCONDITIONID_Id收款条件Idstring RECCONDITIONID_Name收款条件_名称string RECCONDITIONID_Number收款条件编码string FISCREDITCHECK启用信用管理string APPROVERID_Id审核人_Idstring APPROVERID_Name审核人名称string APPROVERID_Number审核人_编码string APPROVEDATE审核日期string FORBIDDERID_Id禁用人Idstring FORBIDDERID_Name禁用人_名称string FORBIDDERID_Number禁用人编码string FORBIDDATE禁用日期string TaxType税分类string CustTypeId客户类别string ADDRESS通讯地址string WEBSITE公司网址string FGroup_Id客户分组_Idstring FGroup_Name客户分组名称string FGroup_Number客户分组_编码string CompanyScale公司规模string CompanyType公司类别string CompanyNature公司性质string CorrespondOrgId_Id对应组织Idstring CorrespondOrgId_Name对应组织_名称string CorrespondOrgId_Number对应组织编码string Priority客户优先级string InvoiceType发票类型string TaxRate_Id默认税率_Idstring TaxRate_Name默认税率名称string TaxRate_Number默认税率_编码string IsDefPayer默认付款方string CPAdminCode订货平台管理员string IsGroup集团客户string INVOICETITLE发票抬头string INVOICEBANKNAME开户银行string INVOICEBANKACCOUNT银行账号string INVOICETEL开票联系电话string INVOICEADDRESS开票通讯地址string IsTrade是否交易客户string UncheckExpectQty不校验可发量string F_lyzx_CheckBox以对账时价目交易string BD_CUSTLOCATION联系人信息array BD_CUSTLOCATION.ContactId联系人编码string BD_CUSTLOCATION.CONTACT联系人名称string BD_CUSTLOCATION.Job职务string BD_CUSTLOCATION.BIZLOCNUMBER地点编码string BD_CUSTLOCATION.BIZLOCATION地点名称string BD_CUSTLOCATION.MOBILEPHONE移动电话string BD_CUSTLOCATION.ContactEmail邮箱string BD_CUSTLOCATION.BizAddress详细地址string BD_CUSTLOCATION.IsDefaultConsigneeCT默认收货地址string BD_CUSTLOCATION.ForbidContactStatus禁用状态string BD_CUSTLOCATION.BD_CUSTBANK银行信息array BD_CUSTLOCATION.BD_CUSTBANK.BANKCODE银行账号string BD_CUSTLOCATION.BD_CUSTBANK.CURRENCYID_Id币别Idstring BD_CUSTLOCATION.BD_CUSTBANK.CURRENCYID_Name币别_名称string BD_CUSTLOCATION.BD_CUSTBANK.CURRENCYID_Number币别编码string BD_CUSTLOCATION.BD_CUSTBANK.ACCOUNTNAME账户名称string BD_CUSTLOCATION.BD_CUSTBANK.ISDEFAULT默认string BD_CUSTLOCATION.BD_CUSTBANK.COUNTRY开户国家string BD_CUSTLOCATION.BD_CUSTBANK.OPENBANKNAME开户银行string BD_CUSTLOCATION.BD_CUSTBANK.BankTypeRec_Id收款银行_Idstring BD_CUSTLOCATION.BD_CUSTBANK.BankTypeRec_Name收款银行名称string BD_CUSTLOCATION.BD_CUSTBANK.BankTypeRec_Number收款银行_编码string BD_CUSTLOCATION.BD_CUSTBANK.OpenAddressRec开户行地址string BD_CUSTLOCATION.BD_CUSTBANK.CNAPS联行号string BD_CUSTLOCATION.BD_CUSTBANK.FTextBankDetail网点名称string BD_CUSTLOCATION.BD_CUSTBANK.BankDetail_Id银行网点Idstring BD_CUSTLOCATION.BD_CUSTBANK.BankDetail_Name银行网点_名称string BD_CUSTLOCATION.BD_CUSTBANK.BankDetail_Number银行网点编码string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT地址信息array BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.NUMBER地点编码string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.NAME地点名称string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.ADDRESS详细地址string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.TRANSLEADTIME运输提前期string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.TAXRATE税率string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.IsDefaultConsignee默认收货地址string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.IsDefaultSettle默认开票地址string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.IsDefaultPayer默认付款地址string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.TTel固定电话string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.EMail电子邮箱string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.IsUsed启用string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.TContact_Id联系人_Idstring BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.TContact_Name联系人名称string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.TContact_Number联系人_编码string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.MOBILE移动电话string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.FLocationStatus地址禁用状态string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG订货组织array BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.OrderOrgId_Id订货组织Idstring BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.OrderOrgId_Name订货组织_名称string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.OrderOrgId_Number订货组织编码string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.ISDEFAULT默认string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT商务信息object BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.EnableSL启用商联在线string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeStatus冻结状态string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeLimit冻结范围string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeOperator_Id冻结人_Idstring BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeOperator_Name冻结人名称string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeOperator_Number冻结人_编码string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeDate冻结日期string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.PROVINCE省份string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.CITY城市string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultConsiLoc_Id默认收货地点Idstring BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultConsiLoc_Name默认收货地点_名称string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultConsiLoc_Number默认收货地点编码string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultSettleLoc_Id默认开票地点_Idstring BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultSettleLoc_Name默认开票地点名称string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultSettleLoc_Number默认开票地点_编码string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultPayerLoc_Id默认付款地点Idstring BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultPayerLoc_Name默认付款地点_名称string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultPayerLoc_Number默认付款地点编码string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultContact_Id默认联系人_Idstring BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultContact_Name默认联系人名称string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultContact_Number默认联系人_编码string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.MarginLevel保证金比例（%）string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FDebitCard结算卡string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.SettleId_Id结算方Idstring BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.SettleId_Name结算方_名称string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.SettleId_Number结算方编码string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ChargeId_Id付款方_Idstring BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ChargeId_Name付款方名称string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ChargeId_Number付款方_编码string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FALLOWJOINZHJ允许对接智慧订货string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.IsContractMustInPut联系人必录string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ContractCount联系人数量string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.BD_CUSTSUBACCOUNT对应子账户信息array BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.BD_CUSTSUBACCOUNT.FSUBACCOUNTTYPE子账户类型string BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.BD_CUSTSUBACCOUNT.FSUBACCOUNT子账户号string

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

接口：/api/createContactInfo
接口名称：新增客户联系人
接口方法：POST

请求参数

字段名称类型描述 customerNo客户编码string contactInfos联系人信息array contactInfos.contactUuid联系人UUIDstring contactInfos.contactName联系人string contactInfos.contactAddress地址string contactInfos.contactPhone联系电话string contactInfos.email邮箱string contactInfos.position职位string contactInfos.contactCode联系人编码string contactInfos.locationCode地点编码string

系统集成总览

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

从金蝶云星空到四化智造MES（API）通过接口配置打通数据