系统数据集成方案

金蝶云星空和钉钉接口打通对接实战

数据源系统:金蝶云星空

集成系统:钉钉

数据集成方案配置

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

金蝶云星空接口明细

• 接口：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

钉钉接口明细

• 接口：v1.0/yida/forms/instances
• 接口名称：更新表单数据（宜搭）
• 接口方法：PUT

请求参数

字段	名称	类型	描述
textField_l0qg8grd	客户名称	string
textField_l0qg8grc	客户编码	string
appType	应用ID	string	APP_PBKT0MFBEBTDO8T7SLVP
systemToken	应用秘钥	string	在应用数据中获取。
language	语言	string
formUuid	表单ID	string	FORM-PU866D91181UGOZDYPVC4EX18VPT1Y5YVA6UKZ9
userId	钉钉的userId	string
formInstanceId	要更新的表单ID	string

系统对接概况

全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：钉钉与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。

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