系统数据集成方案

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

接通系统：金蝶云星空

写入目标:四化智造MES（API）

配置集成方案

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

金蝶云星空接口明细

• 接口：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
BD_CUSTBANK	银行信息	array
BD_CUSTBANK.BANKCODE	银行账号	string
BD_CUSTBANK.CURRENCYID_Id	币别_Id	string
BD_CUSTBANK.CURRENCYID_Name	币别_名称	string
BD_CUSTBANK.CURRENCYID_Number	币别_编码	string
BD_CUSTBANK.ACCOUNTNAME	账户名称	string
BD_CUSTBANK.ISDEFAULT	默认	string
BD_CUSTBANK.COUNTRY	开户国家	string
BD_CUSTBANK.OPENBANKNAME	开户银行	string
BD_CUSTBANK.BankTypeRec_Id	收款银行_Id	string
BD_CUSTBANK.BankTypeRec_Name	收款银行_名称	string
BD_CUSTBANK.BankTypeRec_Number	收款银行_编码	string
BD_CUSTBANK.OpenAddressRec	开户行地址	string
BD_CUSTBANK.CNAPS	联行号	string
BD_CUSTBANK.FTextBankDetail	网点名称	string
BD_CUSTBANK.BankDetail_Id	银行网点_Id	string
BD_CUSTBANK.BankDetail_Name	银行网点_名称	string
BD_CUSTBANK.BankDetail_Number	银行网点_编码	string
BD_CUSTBANK.BD_CUSTCONTACT	地址信息	array
BD_CUSTBANK.BD_CUSTCONTACT.NUMBER	地点编码	string
BD_CUSTBANK.BD_CUSTCONTACT.NAME	地点名称	string
BD_CUSTBANK.BD_CUSTCONTACT.ADDRESS	详细地址	string
BD_CUSTBANK.BD_CUSTCONTACT.TRANSLEADTIME	运输提前期	string
BD_CUSTBANK.BD_CUSTCONTACT.TAXRATE	税率	string
BD_CUSTBANK.BD_CUSTCONTACT.IsDefaultConsignee	默认收货地址	string
BD_CUSTBANK.BD_CUSTCONTACT.IsDefaultSettle	默认开票地址	string
BD_CUSTBANK.BD_CUSTCONTACT.IsDefaultPayer	默认付款地址	string
BD_CUSTBANK.BD_CUSTCONTACT.TTel	固定电话	string
BD_CUSTBANK.BD_CUSTCONTACT.EMail	电子邮箱	string
BD_CUSTBANK.BD_CUSTCONTACT.IsUsed	启用	string
BD_CUSTBANK.BD_CUSTCONTACT.TContact_Id	联系人_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.TContact_Name	联系人_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.TContact_Number	联系人_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.MOBILE	移动电话	string
BD_CUSTBANK.BD_CUSTCONTACT.FLocationStatus	地址禁用状态	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG	订货组织	array
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.OrderOrgId_Id	订货组织_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.OrderOrgId_Name	订货组织_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.OrderOrgId_Number	订货组织_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.ISDEFAULT	默认	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT	商务信息	object
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.EnableSL	启用商联在线	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeStatus	冻结状态	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeLimit	冻结范围	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeOperator_Id	冻结人_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeOperator_Name	冻结人_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeOperator_Number	冻结人_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeDate	冻结日期	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.PROVINCE	省份	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.CITY	城市	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultConsiLoc_Id	默认收货地点_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultConsiLoc_Name	默认收货地点_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultConsiLoc_Number	默认收货地点_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultSettleLoc_Id	默认开票地点_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultSettleLoc_Name	默认开票地点_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultSettleLoc_Number	默认开票地点_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultPayerLoc_Id	默认付款地点_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultPayerLoc_Name	默认付款地点_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultPayerLoc_Number	默认付款地点_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultContact_Id	默认联系人_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultContact_Name	默认联系人_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultContact_Number	默认联系人_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.MarginLevel	保证金比例（%）	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FDebitCard	结算卡	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.SettleId_Id	结算方_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.SettleId_Name	结算方_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.SettleId_Number	结算方_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ChargeId_Id	付款方_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ChargeId_Name	付款方_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ChargeId_Number	付款方_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FALLOWJOINZHJ	允许对接智慧订货	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.IsContractMustInPut	联系人必录	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ContractCount	联系人数量	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.BD_CUSTSUBACCOUNT	对应子账户信息	array
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.BD_CUSTSUBACCOUNT.FSUBACCOUNTTYPE	子账户类型	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.BD_CUSTSUBACCOUNT.FSUBACCOUNT	子账户号	string

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

• 接口：/api/createCustomer
• 接口名称：新增客户信息
• 接口方法：POST

请求参数

字段	名称	类型	描述
customerName	客户名称	string
customerFullName	客户全称	string
contactName	联系人名称	string
contactPhone	联系人电话	string
customerCode	客户简码	string
currency	币种(1:人民币,2:美元,3:欧元)	string
taxPoints	税分类(1:3%,2:6%,3:12%,4:22%)	string
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

数据对接效果

基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接金蝶云星空接口抽取数据后再自动分发到四化智造MES（API）， 解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。

系统数据对接方案元数据代码