金蝶云星空对接打通阿里宜搭客户查询接口与新增表单实例接口
源系统:金蝶云星空
金蝶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架构。
