金蝶云星空对接打通阿里宜搭客户查询接口与新增表单实例接口
对接系统金蝶云星空
金蝶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 | |
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 | |
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 |
响应参数
字段 | 名称 | 类型 | 描述 |
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 | |
textField_ku6aw61h | 客户编码 | string | |
textField_ku6aw61f | 类型 | string | |
appType | 应用ID | string | APP_PBKT0MFBEBTDO8T7SLVP |
systemToken | 应用秘钥 | string | 在应用数据中获取。 |
language | 语言 | string | |
formUuid | 表单ID | string | FORM-PU866D91181UGOZDYPVC4EX18VPT1Y5YVA6UKZ9 |
userId | 钉钉的userId | string | |
系统数据集成价值
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到阿里宜搭之间数据集成;通过API连接各业务系统,复用已有的业务系统能力,让集成架构、服务关系更清晰。使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升复用率和价值。全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+,快速对接各种API接口,实现云上云下的互联互通。将SaaS和本地业务系统联接起来,打破时间与空间界限,打通原有核心数据及SaaS应用,构建可平滑演进的企业IT架构。
系统数据对接方案元数据代码