金蝶云星空和四化智造MES（API）接口打通对接实战

来源系统:金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

接通系统：四化智造MES（API）

MES建立统一平台上通过物料防错防错、流程防错、生产统计、异常处理、信息采集和全流程追溯等精益生产和精细化管理，帮助企业合理安排生产排程、优化工艺流程、改善产品质量、降低能源损耗、降低制造成本，提高执行效率，全面提升和改善企业制造能力，为企业打造可视化、透明化、数字化、智能化工厂。通过手机移动APP实时的数据查询和分析报表，为企业高层提供快速决策支持，以便针对市场变化快速准确地作出反应，综合提升企业的市场竞争力。

多系统对接方案配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：金蝶云星空的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：四化智造MES（API），把获取的数据组装成目标系统需要的格式进行写入。

金蝶云星空接口明细

API：ExecuteBillQuery
NAME：逐个单据查询
METHOD：POST

请求参数

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

响应参数

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

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

API：/api/createCustomer
NAME：新增客户信息
METHOD：POST

请求参数

接口字段字段名称预设值描述 customerName客户名称{{ShortName.0.Value}} customerFullName客户全称{{Name}} contactName联系人名称{{BD_CUSTCONTACT.TContact_Name}} contactPhone联系人电话{{BD_CUSTCONTACT.MOBILE}} customerCode客户简码{{Number}} currency币种(1:人民币,2:美元,3:欧元)1 taxPoints税分类(1:3%,2:6%,3:12%,4:22%)0.13 customerNo客户流水号{{Number}} contactInfos联系人信息BD_CUSTCONTACT contactInfos.contactUuid联系人UUID{{BD_CUSTCONTACT.Id}} contactInfos.contactName联系人{{BD_CUSTCONTACT.TContact_Name}} contactInfos.contactAddress地址{{BD_CUSTCONTACT.ADDRESS}} contactInfos.contactPhone联系电话{{BD_CUSTCONTACT.MOBILE}} contactInfos.email邮箱{{BD_CUSTCONTACT.EMail}} contactInfos.position职位 contactInfos.contactCode联系人编码{{BD_CUSTCONTACT.TContact_Number}} contactInfos.locationCode地点编码{{BD_CUSTCONTACT.NUMBER}} contactInfos.locationName地点名称{{BD_CUSTCONTACT.NAME}}

系统对接总览

异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。

金蝶云星空和四化智造MES（API）接口打通对接实战