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

从金蝶云星空到四化智造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	业务对象表单Id	string	必须填写金蝶的表单ID如 UR_PurchaseOrder

响应参数

字段	名称	类型	描述
DocumentStatus	单据状态	string
ForbidStatus	禁用状态	string
Name	客户名称	string
Number	客户编码	string
Description	备注	string
CreateOrgId_Id	创建组织Id	string
CreateOrgId_Name	创建组织_名称	string
CreateOrgId_Number	创建组织编码	string
UseOrgId_Id	使用组织_Id	string
UseOrgId_Name	使用组织名称	string
UseOrgId_Number	使用组织_编码	string
CreatorId_Id	创建人Id	string
CreatorId_Name	创建人_名称	string
CreatorId_Number	创建人编码	string
ModifierId_Id	修改人_Id	string
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	对应集团客户Id	string
FGROUPCUSTID_Name	对应集团客户_名称	string
FGROUPCUSTID_Number	对应集团客户编码	string
FSUPPLIERID_Id	对应供应商_Id	string
FSUPPLIERID_Name	对应供应商名称	string
FSUPPLIERID_Number	对应供应商_编码	string
TRADINGCURRID_Id	结算币别Id	string
TRADINGCURRID_Name	结算币别_名称	string
TRADINGCURRID_Number	结算币别编码	string
SALDEPTID_Id	销售部门_Id	string
SALDEPTID_Name	销售部门名称	string
SALDEPTID_Number	销售部门_编码	string
SALGROUPID_Id	销售组Id	string
SALGROUPID_Name	销售组_名称	string
SALGROUPID_Number	销售组编码	string
SELLER_Id	销售员_Id	string
SELLER_Name	销售员名称	string
SELLER_Number	销售员_编码	string
TRANSLEADTIME	运输提前期	string
PRICELISTID_Id	价目表Id	string
PRICELISTID_Name	价目表_名称	string
PRICELISTID_Number	价目表编码	string
DISCOUNTLISTID_Id	折扣表_Id	string
DISCOUNTLISTID_Name	折扣表名称	string
DISCOUNTLISTID_Number	折扣表_编码	string
SETTLETYPEID_Id	结算方式Id	string
SETTLETYPEID_Name	结算方式_名称	string
SETTLETYPEID_Number	结算方式编码	string
RECEIVECURRID_Id	收款币别_Id	string
RECEIVECURRID_Name	收款币别名称	string
RECEIVECURRID_Number	收款币别_编码	string
RECCONDITIONID_Id	收款条件Id	string
RECCONDITIONID_Name	收款条件_名称	string
RECCONDITIONID_Number	收款条件编码	string
FISCREDITCHECK	启用信用管理	string
APPROVERID_Id	审核人_Id	string
APPROVERID_Name	审核人名称	string
APPROVERID_Number	审核人_编码	string
APPROVEDATE	审核日期	string
FORBIDDERID_Id	禁用人Id	string
FORBIDDERID_Name	禁用人_名称	string
FORBIDDERID_Number	禁用人编码	string
FORBIDDATE	禁用日期	string
TaxType	税分类	string
CustTypeId	客户类别	string
ADDRESS	通讯地址	string
WEBSITE	公司网址	string
FGroup_Id	客户分组_Id	string
FGroup_Name	客户分组名称	string
FGroup_Number	客户分组_编码	string
CompanyScale	公司规模	string
CompanyType	公司类别	string
CompanyNature	公司性质	string
CorrespondOrgId_Id	对应组织Id	string
CorrespondOrgId_Name	对应组织_名称	string
CorrespondOrgId_Number	对应组织编码	string
Priority	客户优先级	string
InvoiceType	发票类型	string
TaxRate_Id	默认税率_Id	string
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	币别Id	string
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	收款银行_Id	string
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	银行网点Id	string
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	联系人_Id	string
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	订货组织Id	string
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	冻结人_Id	string
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	默认收货地点Id	string
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	默认开票地点_Id	string
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	默认付款地点Id	string
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	默认联系人_Id	string
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	结算方Id	string
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	付款方_Id	string
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	联系人UUID	string
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资产的可插拔、可复用、可组成。