金蝶云星空对接打通阿里宜搭客户查询接口与新增表单实例接口

金蝶云星空对接打通阿里宜搭客户查询接口与新增表单实例接口

源系统:金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

接入系统：阿里宜搭

宜搭是阿里巴巴自研的低代码应用搭建平台，传统情况下需要2周才能搭建完成的应用，用宜搭2小时就可完成。宜搭于2019年3月上线，用户可以在可视化界面上以拖拉拽的方式编辑和配置页面，表单和流程，并一键发布到PC和手机端。

配置集成方案

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

金蝶云星空接口明细

• 调用接口：executeBillQuery
• 接口名称：客户查询
• 方法：POST

请求参数

字段字段名称类型配置值 FCUSTIDFCUSTIDstringFCUSTID FNumber编码stringFNumber FName名称stringFName FCreateOrgId_FNumber创建组织stringFCreateOrgId.FNumber FUseOrgId_FNumber使用组织stringFUseOrgId.FNumber FDescription描述stringFDescription FIsTrade是否交易客户stringFIsTrade FCustTypeId_FNumber客户类别stringFCustTypeId.FNumber FGroup_FNumber客户分组stringFGroup.FNumber FSALDEPTID_FNumber销售部门stringFSALDEPTID.FNumber FSELLER_FNumber销售员stringFSELLER.FNumber FSETTLETYPEID_FNumber结算方式stringFSETTLETYPEID.FNumber FRECCONDITIONID_FNumber收款条件stringFRECCONDITIONID.FNumber FDISCOUNTLISTID_FNumber折扣表stringFDISCOUNTLISTID.FNumber FPRICELISTID_FNumber价目表stringFPRICELISTID.FNumber FTRANSLEADTIME运输提前期stringFTRANSLEADTIME FInvoiceType发票类型stringFInvoiceType FTaxType_FNumber税分类stringFTaxType.FNumber FShortName简称stringFShortName FADDRESS地址stringFADDRESS FZIP邮编stringFZIP FWEBSITE首页stringFWEBSITE FTEL电话stringFTEL FFAX传真stringFFAX FCompanyClassify_FNumber公司类别stringFCompanyClassify.FNumber FCompanyNature_FNumber公司性质stringFCompanyNature.FNumber FCompanyScale_FNumber公司规模stringFCompanyScale.FNumber FINVOICETITLE发票抬头stringFINVOICETITLE FTAXREGISTERCODE纳税登记号stringFTAXREGISTERCODE FINVOICEBANKNAME开户银行stringFINVOICEBANKNAME FINVOICETEL开票联系电话stringFINVOICETEL FINVOICEBANKACCOUNT银行账号stringFINVOICEBANKACCOUNT FINVOICEADDRESS开票通讯地址stringFINVOICEADDRESS FSUPPLIERID_FNumber对应供应商stringFSUPPLIERID.FNumber FIsGroup集团客户stringFIsGroup FIsDefPayer默认付款方stringFIsDefPayer FGROUPCUSTID_FNumber对应集团客户stringFGROUPCUSTID.FNumber FCOUNTRY1_FNumber开户国家stringFCOUNTRY1.FNumber FBANKCODE银行账号stringFBANKCODE FACCOUNTNAME账户名称stringFACCOUNTNAME FBankTypeRec_FNumber收款银行stringFBankTypeRec.FNumber FTextBankDetail网点名称stringFTextBankDetail FBankDetail_FNumber银行网点stringFBankDetail.FNumber FOpenAddressRec开户行地址stringFOpenAddressRec FCNAPS联行号stringFCNAPS FCURRENCYID_FNumber币别stringFCURRENCYID.FNumber FISDEFAULT1默认stringFISDEFAULT1 FDefaultConsiLoc_FNumber默认收货地点stringFDefaultConsiLoc.FNumber FDefaultSettleLoc_FNumber默认开票地点stringFDefaultSettleLoc.FNumber FDefaultPayerLoc_FNumber默认付款地点stringFDefaultPayerLoc.FNumber FDefaultContact_FNumber默认联系人stringFDefaultContact.FNumber FMarginLevel保证金比例（%）stringFMarginLevel Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFCreateOrgId.FNumber in ('100') and FForbidStatus = 'A' and FUseOrgId.FNumber in ('100') FieldKeys需查询的字段key集合array FormId业务对象表单IdstringBD_Customer

响应参数

字段字段名称类型配置值 FCUSTIDFCUSTIDstring FNumber编码string FName名称string FCreateOrgId_FNumber创建组织string FUseOrgId_FNumber使用组织string FDescription描述string FIsTrade是否交易客户string FCustTypeId_FNumber客户类别string FGroup_FNumber客户分组string FSALDEPTID_FNumber销售部门string FSELLER_FNumber销售员string FSETTLETYPEID_FNumber结算方式string FRECCONDITIONID_FNumber收款条件string FDISCOUNTLISTID_FNumber折扣表string FPRICELISTID_FNumber价目表string FTRANSLEADTIME运输提前期string FInvoiceType发票类型string FTaxType_FNumber税分类string FShortName简称string FADDRESS地址string FZIP邮编string FWEBSITE首页string FTEL电话string FFAX传真string FCompanyClassify_FNumber公司类别string FCompanyNature_FNumber公司性质string FCompanyScale_FNumber公司规模string FINVOICETITLE发票抬头string FTAXREGISTERCODE纳税登记号string FINVOICEBANKNAME开户银行string FINVOICETEL开票联系电话string FINVOICEBANKACCOUNT银行账号string FINVOICEADDRESS开票通讯地址string FSUPPLIERID_FNumber对应供应商string FIsGroup集团客户string FIsDefPayer默认付款方string FGROUPCUSTID_FNumber对应集团客户string FCOUNTRY1_FNumber开户国家string FBANKCODE银行账号string FACCOUNTNAME账户名称string FBankTypeRec_FNumber收款银行string FTextBankDetail网点名称string FBankDetail_FNumber银行网点string FOpenAddressRec开户行地址string FCNAPS联行号string FCURRENCYID_FNumber币别string FISDEFAULT1默认string FDefaultConsiLoc_FNumber默认收货地点string FDefaultSettleLoc_FNumber默认开票地点string FDefaultPayerLoc_FNumber默认付款地点string FDefaultContact_FNumber默认联系人string FMarginLevel保证金比例（%）string

阿里宜搭接口明细

• 调用接口：/yida_vpc/form/saveFormData.json
• 接口名称：新增表单实例
• 方法：POST

请求参数

字段字段名称类型配置值 textField_ku6aw61g客户名称string{{FName}} textField_ku6aw61h客户编码string{{FNumber}} textField_ku6aw61f类型string客户 appType应用IDstringAPP_KFJOIBQ7VRMTDLQSLKQG systemToken应用秘钥stringJR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO language语言stringzh_CN formUuid表单IDstringFORM-PU866D91181UGOZDYPVC4EX18VPT1Y5YVA6UKZ9 userId钉钉的userIdstring16000443318138909

系统打通概况

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到阿里宜搭之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。