金蝶云星空与四化智造MES（API）对接集成逐个单据查询打通新增客户联系人|轻易云数据集成平台

金蝶云星空与四化智造MES（API）对接集成逐个单据查询打通新增客户联系人

源系统:金蝶云星空

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

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

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

配置集成方案

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的逐个单据查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为四化智造MES（API），并且选择对应连接器。选择对应的新增客户联系人接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星空接口明细

接口：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如:PUR_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
contactInfos.locationName	地点名称	string

系统打通概况

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。