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

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

源系统:金蝶云星空

金蝶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

请求参数

字段	字段名称	类型	配置值
FCUSTID	FCUSTID	string	FCUSTID
FNumber	编码	string	FNumber
FName	名称	string	FName
FCreateOrgId_FNumber	创建组织	string	FCreateOrgId.FNumber
FUseOrgId_FNumber	使用组织	string	FUseOrgId.FNumber
FDescription	描述	string	FDescription
FIsTrade	是否交易客户	string	FIsTrade
FCustTypeId_FNumber	客户类别	string	FCustTypeId.FNumber
FGroup_FNumber	客户分组	string	FGroup.FNumber
FSALDEPTID_FNumber	销售部门	string	FSALDEPTID.FNumber
FSELLER_FNumber	销售员	string	FSELLER.FNumber
FSETTLETYPEID_FNumber	结算方式	string	FSETTLETYPEID.FNumber
FRECCONDITIONID_FNumber	收款条件	string	FRECCONDITIONID.FNumber
FDISCOUNTLISTID_FNumber	折扣表	string	FDISCOUNTLISTID.FNumber
FPRICELISTID_FNumber	价目表	string	FPRICELISTID.FNumber
FTRANSLEADTIME	运输提前期	string	FTRANSLEADTIME
FInvoiceType	发票类型	string	FInvoiceType
FTaxType_FNumber	税分类	string	FTaxType.FNumber
FShortName	简称	string	FShortName
FADDRESS	地址	string	FADDRESS
FZIP	邮编	string	FZIP
FWEBSITE	首页	string	FWEBSITE
FTEL	电话	string	FTEL
FFAX	传真	string	FFAX
FCompanyClassify_FNumber	公司类别	string	FCompanyClassify.FNumber
FCompanyNature_FNumber	公司性质	string	FCompanyNature.FNumber
FCompanyScale_FNumber	公司规模	string	FCompanyScale.FNumber
FINVOICETITLE	发票抬头	string	FINVOICETITLE
FTAXREGISTERCODE	纳税登记号	string	FTAXREGISTERCODE
FINVOICEBANKNAME	开户银行	string	FINVOICEBANKNAME
FINVOICETEL	开票联系电话	string	FINVOICETEL
FINVOICEBANKACCOUNT	银行账号	string	FINVOICEBANKACCOUNT
FINVOICEADDRESS	开票通讯地址	string	FINVOICEADDRESS
FSUPPLIERID_FNumber	对应供应商	string	FSUPPLIERID.FNumber
FIsGroup	集团客户	string	FIsGroup
FIsDefPayer	默认付款方	string	FIsDefPayer
FGROUPCUSTID_FNumber	对应集团客户	string	FGROUPCUSTID.FNumber
FCOUNTRY1_FNumber	开户国家	string	FCOUNTRY1.FNumber
FBANKCODE	银行账号	string	FBANKCODE
FACCOUNTNAME	账户名称	string	FACCOUNTNAME
FBankTypeRec_FNumber	收款银行	string	FBankTypeRec.FNumber
FTextBankDetail	网点名称	string	FTextBankDetail
FBankDetail_FNumber	银行网点	string	FBankDetail.FNumber
FOpenAddressRec	开户行地址	string	FOpenAddressRec
FCNAPS	联行号	string	FCNAPS
FCURRENCYID_FNumber	币别	string	FCURRENCYID.FNumber
FISDEFAULT1	默认	string	FISDEFAULT1
FDefaultConsiLoc_FNumber	默认收货地点	string	FDefaultConsiLoc.FNumber
FDefaultSettleLoc_FNumber	默认开票地点	string	FDefaultSettleLoc.FNumber
FDefaultPayerLoc_FNumber	默认付款地点	string	FDefaultPayerLoc.FNumber
FDefaultContact_FNumber	默认联系人	string	FDefaultContact.FNumber
FMarginLevel	保证金比例（%）	string	FMarginLevel
Limit	最大行数	string	{{PAGINATION_PAGE_SIZE}}
StartRow	开始行索引	string	{{PAGINATION_START_ROW}}
TopRowCount	返回总行数	int
FilterString	过滤条件	string	FCreateOrgId.FNumber in ('100') and FForbidStatus = 'A' and FUseOrgId.FNumber in ('100')
FieldKeys	需查询的字段key集合	array
FormId	业务对象表单Id	string	BD_Customer

响应参数

字段	字段名称	类型	配置值
FCUSTID	FCUSTID	string
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	应用ID	string	APP_KFJOIBQ7VRMTDLQSLKQG
systemToken	应用秘钥	string	JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO
language	语言	string	zh_CN
formUuid	表单ID	string	FORM-PU866D91181UGOZDYPVC4EX18VPT1Y5YVA6UKZ9
userId	钉钉的userId	string	16000443318138909

系统打通概况

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